Repository Public License
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