SPB Git

Repository Public License

DominoCityTests.swift 21.2 KB 397 lines swift

1// =============================================================================2//                  SP BOUCHER | SOFTWARE & RESEARCH3//             ARTIFICIAL INTELLIGENCE • FINANCE • ENGINEERING4// =============================================================================5//6// PROJECT METADATA7// -----------------------------------------------------------------------------8// Project          : ORIX Arcade9// File             : Tests/DominoCityTests.swift10// Description      : Domino City tests — level catalogue validity, scoring and11//                    stars, objectives registering once, progression12//                    persistence, retry reset, and a hosted physics run proving13//                    every level's reference solution clears it.14// Module           : Tests15// Repository       : https://git.spboucher.ai/orix-arcade16// Created          : 2026-11-2117// Last Modified    : 2026-11-2118//19// =============================================================================20// AUTHOR & PROFESSIONAL AFFILIATION21// =============================================================================22//23// Author           : Simon-Pierre Boucher24// Position         : Professor of Finance25// Institution      : Université du Québec en Outaouais (UQO)26// Department       : Département des sciences administratives27// Organization     : SP Boucher28//29// Website          : https://spboucher.ai30// Git              : https://git.spboucher.ai31//32// =============================================================================33// OFFICIAL CONTACT DIRECTORY34// =============================================================================35//36// General          : info@spboucher.ai37// Professional     : contact@spboucher.ai38// Direct           : simon@spboucher.ai39// Research         : research@spboucher.ai40// Development      : dev@spboucher.ai41// Support          : support@spboucher.ai42// Security/Admin   : admin@spboucher.ai43// Notifications    : notifications@spboucher.ai44//45// Preferred Contact: support@spboucher.ai46//47// =============================================================================48// COPYRIGHT & INTELLECTUAL PROPERTY49// =============================================================================50//51// Copyright (c) 202652// Simon-Pierre Boucher53//54// All rights reserved where applicable.55//56// This file is governed by the applicable project license,57// copyright notices, institutional agreements and relevant law.58//59// Unless expressly authorized by the applicable license or60// rights holder, copying, redistribution, sublicensing,61// publication and commercial exploitation are not permitted.62//63// Existing third-party rights and notices remain unaffected.64//65// =============================================================================66// CONFIDENTIALITY & SECURITY67// =============================================================================68//69// Classification   : Public70// Distribution     : Public repository; use is governed by the project license71// Security Contact : admin@spboucher.ai72//73// Access to this source does not independently grant permission74// to redistribute or disclose confidential materials.75//76// Do not embed credentials, private keys, access tokens,77// certificates or confidential personal information.78//79// =============================================================================80// LICENSE & MAINTENANCE81// =============================================================================82//83// License          : Proprietary, all rights reserved (see license file)84// License File     : LICENSE85// Maintainer       : Simon-Pierre Boucher86// Technical Contact: dev@spboucher.ai87//88// =============================================================================89// END OF SP BOUCHER SOURCE HEADER90// =============================================================================9192import SpriteKit93import XCTest94@testable import ORIXArcade9596@MainActor97final class DominoCityTests: XCTestCase {98    private func tempDir() -> URL {99        let url = FileManager.default.temporaryDirectory.appendingPathComponent("orix-domino-\(UUID().uuidString)")100        try? FileManager.default.createDirectory(at: url, withIntermediateDirectories: true)101        return url102    }103104    private func stats(_ level: DominoLevel, targets: Int? = nil, chain: Int = 0, gems: Int = 0, used: Int? = nil) -> DominoRunStats {105        DominoRunStats(targetsHit: targets ?? level.targets.count, targetsTotal: level.targets.count, chain: chain, gems: gems,106                       impulsesUsed: used ?? level.par, impulseBudget: level.impulses)107    }108109    // MARK: Catalogue110111    func testCatalogueHasFifteenValidLevels() {112        XCTAssertEqual(DominoLevels.all.count, DominoSave.levelCount)113        XCTAssertEqual(DominoLevels.all.map(\.id), Array(1...15))114        XCTAssertEqual(Set(DominoLevels.all.map(\.name)).count, 15, "level names are unique")115        for level in DominoLevels.all {116            XCTAssertEqual(level.validationProblems(), [], "level \(level.id) \(level.name)")117            XCTAssertFalse(level.hint.isEmpty)118        }119    }120121    func testLevelsAreDistinctAndMechanicsEscalate() {122        let layouts = DominoLevels.all.map { level in level.pieces.map { "\($0.kind.rawValue):\(Int($0.x)):\(Int($0.y))" }.joined(separator: "|") }123        XCTAssertEqual(Set(layouts).count, 15, "no two levels share a layout")124        func firstLevel(with kind: DominoPieceKind) -> Int? { DominoLevels.all.first { $0.pieces.contains { $0.kind == kind } }?.id }125        XCTAssertEqual(firstLevel(with: .goldDomino), 1)126        for kind in [DominoPieceKind.ball, .goldBlock, .switchPad, .plank, .tar, .bouncer, .wreckingBall, .gate, .bell] {127            XCTAssertNotNil(firstLevel(with: kind), "\(kind.rawValue) is used somewhere")128        }129        XCTAssertGreaterThan(firstLevel(with: .switchPad)!, firstLevel(with: .ball)!, "switches come after rolling balls")130        XCTAssertGreaterThan(firstLevel(with: .wreckingBall)!, firstLevel(with: .switchPad)!)131        XCTAssertFalse(DominoLevels.firstPush.pieces.contains { [.tar, .switchPad, .bouncer, .wreckingBall].contains($0.kind) }, "the tutorial is a plain row")132    }133134    func testBuilderPlacesPiecesOnTheirSurfaces() {135        var b = DominoLevelBuilder()136        b.ledge(10, 110, top: 200)137        b.dominoes(from: 30, top: 200, count: 3, gold: [2])138        b.tower(x: 80, top: 200, floors: 2)139        b.ramp(from: (400, 300), to: (300, 250))140        let ledge = b.pieces[0]141        XCTAssertEqual(ledge.y + ledge.h / 2, 200, accuracy: 0.001)142        XCTAssertEqual(b.pieces[1].y - DominoTuning.dominoHeight / 2, 200, accuracy: 0.001)143        XCTAssertEqual(b.pieces[3].kind, .goldDomino)144        XCTAssertEqual(b.pieces[5].kind, .goldBlock)145        XCTAssertEqual(b.pieces[5].y - b.pieces[4].y, DominoTuning.blockHeight, accuracy: 0.001)146        XCTAssertLessThan(b.pieces[6].y, 275, "a ramp body sits below its surface line")147        XCTAssertEqual(Set(b.pieces.map(\.id)).count, b.pieces.count)148    }149150    func testTrajectoryPreviewMatchesBallistics() {151        let p = DominoTuning.trajectoryPoint(from: (50, 100), angleDegrees: 45, power: 1, time: 0.5)152        let v = DominoTuning.maxLaunchSpeed * 0.5.squareRoot()153        XCTAssertEqual(p.x, 50 + v * 0.5, accuracy: 0.001)154        XCTAssertEqual(p.y, 100 + v * 0.5 - 0.5 * DominoTuning.gravity * 0.25, accuracy: 0.001)155        XCTAssertEqual(DominoTuning.launchSpeed(power: 0), DominoTuning.minLaunchSpeed)156        XCTAssertEqual(DominoTuning.launchSpeed(power: 7), DominoTuning.maxLaunchSpeed, "power is clamped")157    }158159    // MARK: Scoring160161    func testScoreComponents() {162        let level = DominoLevels.towerBlock163        XCTAssertEqual(DominoRules.score(stats(level, targets: 0, chain: 0, used: 3)), 0)164        XCTAssertEqual(DominoRules.score(stats(level, targets: 1, chain: 3, used: 3)), 500 + 120, "no clear bonus while a target stands")165        let cleared = stats(level, chain: 5, gems: 1, used: 2)166        XCTAssertEqual(DominoRules.score(cleared), 2 * 500 + 5 * 40 + 300 + 1000 + 1 * 600)167        XCTAssertGreaterThan(DominoRules.score(stats(level, chain: 5, used: 1)), DominoRules.score(stats(level, chain: 5, used: 2)), "spare impulses are worth points")168    }169170    func testStarsRequireAClearAndFollowThresholds() {171        for level in DominoLevels.all {172            XCTAssertEqual(DominoRules.stars(level: level, stats: stats(level, targets: level.targets.count - 1, chain: 99, gems: 9, used: 1)), 0, "level \(level.id)")173            XCTAssertEqual(DominoRules.stars(level: level, stats: stats(level, chain: 0, used: level.impulses)), 1, "bare clear, level \(level.id)")174            XCTAssertEqual(DominoRules.stars(level: level, stats: stats(level, chain: level.referenceChain, used: level.par)), 3, "reference run, level \(level.id)")175            XCTAssertLessThan(level.twoStarScore, level.threeStarScore)176            XCTAssertGreaterThan(level.twoStarScore, DominoRules.score(stats(level, chain: 0, used: level.impulses)), "two stars need more than a bare clear")177        }178    }179180    // MARK: Tracker181182    func testObjectivesRegisterExactlyOnce() {183        let level = DominoLevels.craneDay184        var tracker = DominoRunTracker(level: level)185        let target = level.targets[0].id186        XCTAssertTrue(tracker.registerTarget(target))187        XCTAssertFalse(tracker.registerTarget(target), "a target cannot count twice")188        XCTAssertFalse(tracker.registerTarget(9_999), "unknown ids are ignored")189        let ledge = level.pieces.first { $0.kind == .ledge }!.id190        XCTAssertFalse(tracker.registerTarget(ledge), "non-targets are ignored")191        XCTAssertFalse(tracker.registerChain(ledge), "static pieces never join the chain")192        let crate = level.pieces.first { $0.kind == .block }!.id193        XCTAssertTrue(tracker.registerChain(crate))194        XCTAssertFalse(tracker.registerChain(crate))195        let padID = level.pieces.first { $0.kind == .switchPad }!.id196        XCTAssertTrue(tracker.registerSwitch(padID))197        XCTAssertFalse(tracker.registerSwitch(padID), "a switch fires once")198        XCTAssertEqual(tracker.stats.targetsHit, 1)199        XCTAssertEqual(tracker.stats.chain, 1)200        XCTAssertFalse(tracker.cleared)201        for other in level.targets.dropFirst() { XCTAssertTrue(tracker.registerTarget(other.id)) }202        XCTAssertTrue(tracker.cleared)203    }204205    func testGemsAndImpulseBudget() {206        let level = DominoLevels.rooftopRun207        var tracker = DominoRunTracker(level: level)208        let gem = level.gems[0].id209        XCTAssertTrue(tracker.registerGem(gem))210        XCTAssertFalse(tracker.registerGem(gem))211        XCTAssertEqual(tracker.stats.gems, 1)212        for _ in 0..<level.impulses { XCTAssertTrue(tracker.useImpulse()) }213        XCTAssertFalse(tracker.useImpulse(), "the budget cannot be exceeded")214        XCTAssertEqual(tracker.impulsesLeft, 0)215    }216217    // MARK: Progression218219    func testProgressUnlocksAndKeepsBests() {220        var save = DominoSave()221        XCTAssertTrue(save.isUnlocked(1))222        XCTAssertFalse(save.isUnlocked(2))223        XCTAssertFalse(save.isUnlocked(0))224        XCTAssertFalse(save.isUnlocked(16))225        let level = DominoLevels.firstPush226        let failed = DominoResult(level: level, stats: stats(level, targets: 0, chain: 2, used: 3), duration: 4)227        XCTAssertNil(save.record(failed).unlockedLevel)228        XCTAssertFalse(save.isUnlocked(2), "a failed run unlocks nothing")229        XCTAssertEqual(save.bestScore(1), 0, "failed runs do not set a best score")230        let good = DominoResult(level: level, stats: stats(level, chain: 8, used: 1), duration: 5)231        let first = save.record(good)232        XCTAssertEqual(first.unlockedLevel, 2)233        XCTAssertTrue(first.isNewBestScore)234        XCTAssertTrue(save.isUnlocked(2))235        XCTAssertEqual(save.bestStars(1), 3)236        let worse = DominoResult(level: level, stats: stats(level, chain: 0, used: 3), duration: 5)237        let second = save.record(worse)238        XCTAssertFalse(second.isNewBestScore)239        XCTAssertNil(second.unlockedLevel, "a level unlocks only once")240        XCTAssertEqual(save.bestStars(1), 3, "bests never go down")241        XCTAssertEqual(save.bestScore(1), good.score)242        XCTAssertEqual(save.attempts, 3)243        XCTAssertEqual(save.bestChain, 8)244        XCTAssertEqual(save.clearedCount, 1)245        XCTAssertEqual(save.highestUnlocked, 2)246    }247248    func testSaveRoundTripAndTolerantDecoding() throws {249        var save = DominoSave()250        save.record(DominoResult(level: DominoLevels.firstPush, stats: stats(DominoLevels.firstPush, chain: 8, used: 1), duration: 3))251        save.tutorialDone = true252        let decoded = try JSONDecoder().decode(DominoSave.self, from: JSONEncoder().encode(save))253        XCTAssertEqual(decoded, save)254        let partial = try JSONDecoder().decode(DominoSave.self, from: Data(#"{"stars":[3,9,-2],"lastLevel":99}"#.utf8))255        XCTAssertEqual(partial.stars.count, 15)256        XCTAssertEqual(Array(partial.stars.prefix(3)), [3, 3, 0], "values are clamped and padded")257        XCTAssertEqual(partial.lastLevel, 15)258        XCTAssertFalse(partial.tutorialDone)259        XCTAssertEqual(try JSONDecoder().decode(DominoSave.self, from: Data("{}".utf8)), DominoSave())260    }261262    func testProgressPersistsThroughTheStoreAndAchievementsUnlock() {263        let dir = tempDir()264        let services = ArcadeServices(store: SaveStore(name: "d", directory: dir), audio: AudioDirector(enabled: false), haptics: HapticsDirector(enabled: false))265        let level = DominoLevels.firstPush266        let result = DominoResult(level: level, stats: stats(level, chain: 8, used: 1), duration: 3)267        services.store.update { $0.domino.record(result) }268        DominoCityGame.awardAchievements(for: result, save: services.save.domino, services: services)269        services.store.flush()270        XCTAssertTrue(services.isUnlocked("domino.first"))271        XCTAssertTrue(services.isUnlocked("domino.perfect"))272        XCTAssertFalse(services.isUnlocked("domino.mayor"))273        let reloaded = SaveStore(name: "d", directory: dir)274        XCTAssertEqual(reloaded.data.domino.bestStars(1), 3)275        XCTAssertTrue(reloaded.data.domino.isUnlocked(2))276        XCTAssertEqual(DominoCityGame.descriptor.bestLabel(reloaded.data), "★ 3/45")277        XCTAssertEqual(DominoCityGame.descriptor.progress(reloaded.data)?.label, "1 / 15 levels")278        XCTAssertNil(DominoCityGame.descriptor.bestLabel(SaveData()))279        XCTAssertEqual(Set(DominoCityGame.achievements.map(\.id)).count, DominoCityGame.achievements.count)280        XCTAssertTrue(DominoCityGame.achievements.allSatisfy { $0.id.hasPrefix("domino.") && $0.game == .dominoCity })281    }282283    // MARK: Hosted physics284285    private var hostWindow: UIWindow? {286        UIApplication.shared.connectedScenes.compactMap { ($0 as? UIWindowScene)?.keyWindow }.first287    }288289    /// Runs each (level, shots) pair in a real SKView attached to the app window and returns the results in order.290    private func simulate(_ runs: [(DominoLevel, [DominoShot])], batch: Int = 8, timeout: TimeInterval = 40) async throws -> [DominoResult?] {291        let window = try XCTUnwrap(hostWindow, "the hosted test needs the app window")292        let services = ArcadeServices.preview(directory: tempDir())293        var results: [DominoResult?] = []294        var index = 0295        while index < runs.count {296            let slice = Array(runs[index..<min(index + batch, runs.count)])297            var views: [SKView] = []298            var sessions: [DominoSession] = []299            for (offset, run) in slice.enumerated() {300                let view = SKView(frame: CGRect(x: CGFloat(offset % 4) * 100, y: CGFloat(offset / 4) * 220, width: 100, height: 216))301                view.preferredFramesPerSecond = 60302                window.addSubview(view)303                let session = DominoSession(level: run.0)304                let scene = DominoScene(services: services, level: run.0, session: session)305                scene.botShots = run.1306                view.presentScene(scene)307                views.append(view)308                sessions.append(session)309            }310            let deadline = Date().addingTimeInterval(timeout)311            while sessions.contains(where: { $0.result == nil }), Date() < deadline {312                try await Task.sleep(for: .milliseconds(100))313            }314            results += sessions.map(\.result)315            for view in views {316                view.presentScene(nil)317                view.removeFromSuperview()318            }319            index += batch320        }321        return results322    }323324    func testEveryReferenceSolutionClearsItsLevel() async throws {325        let results = try await simulate(DominoLevels.all.map { ($0, $0.solution) })326        for (level, result) in zip(DominoLevels.all, results) {327            let result = try XCTUnwrap(result, "level \(level.id) never finished")328            print("DOMINO-REF level=\(level.id) cleared=\(result.cleared) targets=\(result.stats.targetsHit)/\(result.stats.targetsTotal) chain=\(result.stats.chain) gems=\(result.stats.gems) used=\(result.stats.impulsesUsed) score=\(result.score) stars=\(result.stars) t=\(String(format: "%.1f", result.duration))")329            XCTAssertTrue(result.cleared, "level \(level.id) \(level.name): reference solution hit \(result.stats.targetsHit)/\(result.stats.targetsTotal)")330            XCTAssertEqual(result.stats.impulsesUsed, level.par, "level \(level.id)")331            XCTAssertGreaterThanOrEqual(result.stars, 2, "level \(level.id): the reference run should score well (chain \(result.stats.chain))")332        }333    }334335    func testObjectivesCountOnceInARealRunAndRetryResetsEverything() async throws {336        let window = try XCTUnwrap(hostWindow)337        let services = ArcadeServices.preview(directory: tempDir())338        let level = DominoLevels.firstPush339        let session = DominoSession(level: level)340        let scene = DominoScene(services: services, level: level, session: session)341        let view = SKView(frame: CGRect(x: 0, y: 0, width: 200, height: 430))342        window.addSubview(view)343        defer { view.presentScene(nil); view.removeFromSuperview() }344        view.presentScene(scene)345        XCTAssertTrue(session.canAim)346        XCTAssertTrue(scene.fire(level.solution[0]), "input launches an impulse")347        XCTAssertFalse(scene.fire(level.solution[0]), "no second launch while the first is flying")348        XCTAssertEqual(session.impulsesLeft, level.impulses - 1)349        let deadline = Date().addingTimeInterval(30)350        while session.result == nil, Date() < deadline { try await Task.sleep(for: .milliseconds(100)) }351        let result = try XCTUnwrap(session.result, "the run ends")352        XCTAssertTrue(result.cleared)353        XCTAssertEqual(result.stats.targetsHit, level.targets.count, "each target counted once")354        XCTAssertLessThanOrEqual(result.stats.chain, level.dynamicCount, "no piece joins the chain twice")355        XCTAssertFalse(scene.fire(level.solution[0]), "a finished run accepts no input")356357        scene.restart()358        XCTAssertNil(session.result)359        XCTAssertEqual(session.targetsHit, 0)360        XCTAssertEqual(session.chain, 0)361        XCTAssertEqual(session.impulsesLeft, level.impulses)362        XCTAssertTrue(session.canAim)363        XCTAssertFalse(session.hasLaunched)364        XCTAssertEqual(scene.tracker, DominoRunTracker(level: level), "retry starts from a clean tracker")365        // After a retry the level must be exactly as solvable as before.366        scene.botShots = level.solution367        let second = Date().addingTimeInterval(30)368        while session.result == nil, Date() < second { try await Task.sleep(for: .milliseconds(100)) }369        XCTAssertEqual(session.result?.cleared, true, "the rebuilt level clears again")370    }371372    /// Tuning aid, skipped unless `TEST_RUNNER_DOMINO_SWEEP=<level>` is set.373    /// `DOMINO_ANGLES=a:b:step`, `DOMINO_POWERS=a:b:step`, `DOMINO_FIXED="angle,power;angle,power"` (shots fired before the swept one).374    func testSweep() async throws {375        let env = ProcessInfo.processInfo.environment376        guard let raw = env["DOMINO_SWEEP"], let id = Int(raw), let level = DominoLevels.level(id) else { throw XCTSkip("sweep not requested") }377        func range(_ key: String, _ fallback: [Double]) -> [Double] {378            guard let parts = env[key]?.split(separator: ":").compactMap({ Double($0) }), parts.count == 3 else { return fallback }379            return Array(stride(from: parts[0], through: parts[1], by: parts[2]))380        }381        let angles = range("DOMINO_ANGLES", Array(stride(from: -20.0, through: 80, by: 10)))382        let powers = range("DOMINO_POWERS", [0, 0.25, 0.5, 0.75, 1])383        let fixed: [DominoShot] = (env["DOMINO_FIXED"] ?? "").split(separator: ";").compactMap { part in384            let values = part.split(separator: ",").compactMap { Double($0) }385            return values.count == 2 ? DominoShot(angle: values[0], power: values[1]) : nil386        }387        var runs: [(DominoLevel, [DominoShot])] = []388        for angle in angles { for power in powers { runs.append((level, fixed + [DominoShot(angle: angle, power: power)])) } }389        let results = try await simulate(runs, timeout: 30)390        for (run, result) in zip(runs, results) {391            let shot = run.1.last!392            let text = result.map { "cleared=\($0.cleared) targets=\($0.stats.targetsHit)/\($0.stats.targetsTotal) chain=\($0.stats.chain) gems=\($0.stats.gems) score=\($0.score)" } ?? "timeout"393            print("DOMINO-SWEEP level=\(id) angle=\(shot.angle) power=\(shot.power) \(text)")394        }395    }396}397
Files main
Menu

Theme