@bitmagic/cli 0.1.83-dev.3 → 0.1.83-dev.4

package/dist/publish/game-exchange.js

@@ -21,14 +21,20 @@
 import * as fs from 'node:fs';
 import * as path from 'node:path';
 import { parseGameExchangeDeclaration, } from '@bitmagic/asset-core/game-exchange';
-/** The file the engine's exchange module is installed from; absent in an engine that predates it. */
-const ENGINE_EXCHANGE_MODULE = ['engine', 'engine', 'exchange', 'installGameExchange.ts'];
+/**
+ * The files the engine's exchange module is installed from, current home first; none exists in an
+ * engine that predates it. The old path stays: an engine vendored before the module moved has only it.
+ */
+const ENGINE_EXCHANGE_MODULES = [
+    ['engine', 'engine', 'platform', 'exchange', 'installGameExchange.ts'],
+    ['engine', 'engine', 'exchange', 'installGameExchange.ts'],
+];
 /**
  * Whether the engine vendored into this project can show exchange tiles at all. A project's engine
  * only moves on `bitmagic upgrade`, so a current CLI regularly meets an engine without the module.
  */
 export function vendoredEngineSupportsExchange(root) {
-    return fs.existsSync(path.join(root, ...ENGINE_EXCHANGE_MODULE));
+    return ENGINE_EXCHANGE_MODULES.some((parts) => fs.existsSync(path.join(root, ...parts)));
 }
 function readWorkFile(filePath) {
     let parsed;

package/dist/publish/game-exchange.js.map

@@ -1 +1 @@
-{"version":3,"file":"game-exchange.js","sourceRoot":"","sources":["../../src/publish/game-exchange.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"game-exchange.js","sourceRoot":"","sources":["../../src/publish/game-exchange.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EACL,4BAA4B,GAI7B,MAAM,oCAAoC,CAAC;AAE5C;;;GAGG;AACH,MAAM,uBAAuB,GAAG;IAC9B,CAAC,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,UAAU,EAAE,wBAAwB,CAAC;IACtE,CAAC,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,wBAAwB,CAAC;CAC3D,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,8BAA8B,CAAC,IAAY;IACzD,OAAO,uBAAuB,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;AAC3F,CAAC;AAUD,SAAS,YAAY,CAAC,QAAgB;IACpC,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC;YAAE,OAAO,SAAS,CAAC;QAC/C,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC;IAC1D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,OAAO,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;QAC5E,CAAC,CAAE,MAAkC;QACrC,CAAC,CAAC,QAAQ,CAAC;AACf,CAAC;AAED,SAAS,UAAU,CAAC,IAAc;IAChC,IAAI,OAAO,IAAI,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IAC/C,MAAM,OAAO,GAAG,IAAI,CAAC,gBAAgB,CAAC;IACtC,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;QAAE,OAAO,SAAS,CAAC;IAChG,OAAQ,OAAmC,CAAC,YAAY,CAAC;AAC3D,CAAC;AAED,kGAAkG;AAClG,MAAM,UAAU,2BAA2B,CAAC,IAAY;IACtD,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;IAC/C,MAAM,KAAK,GAAG,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC;IAC7D,MAAM,IAAI,GAAG,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC;IAE3D,KAAK,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC,YAAY,EAAE,KAAK,CAAC,EAAE,CAAC,WAAW,EAAE,IAAI,CAAC,CAAU,EAAE,CAAC;QACrF,MAAM,GAAG,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;QACjC,IAAI,GAAG,KAAK,SAAS;YAAE,SAAS;QAChC,MAAM,MAAM,GAAG,4BAA4B,CAAC,GAAG,CAAC,CAAC;QACjD,OAAO,MAAM,CAAC,EAAE;YACd,CAAC,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE;YACjD,CAAC,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC;IACrD,CAAC;IAED,6FAA6F;IAC7F,8DAA8D;IAC9D,MAAM,QAAQ,GAAG,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,IAAI,KAAK,QAAQ,CAAC;IACvE,IAAI,CAAC,QAAQ,IAAI,KAAK,KAAK,QAAQ,IAAI,IAAI,KAAK,QAAQ;QAAE,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC;IACxF,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC;AAChC,CAAC;AASD;;;;;;GAMG;AACH,MAAM,UAAU,wBAAwB,CAAC,IAAY;IACnD,MAAM,IAAI,GAAG,2BAA2B,CAAC,IAAI,CAAC,CAAC;IAC/C,IAAI,IAAI,CAAC,IAAI,KAAK,YAAY;QAAE,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;IACjE,IAAI,IAAI,CAAC,IAAI,KAAK,YAAY;QAAE,OAAO,EAAE,MAAM,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;IACrF,IAAI,IAAI,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;QAC7B,OAAO;YACL,MAAM,EAAE,EAAE;YACV,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,qDAAqD,CAAC;SACzF,CAAC;IACJ,CAAC;IACD,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,IAAI,CAAC,8BAA8B,CAAC,IAAI,CAAC,EAAE,CAAC;QAChE,OAAO;YACL,MAAM,EAAE,EAAE;YACV,KAAK,EAAE;gBACL,uFAAuF;sBACnF,wFAAwF;sBACxF,qDAAqD;aAC1D;SACF,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,EAAE,YAAY,EAAE,IAAI,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;AAC7D,CAAC;AAED,6FAA6F;AAC7F,MAAM,UAAU,8BAA8B,CAAC,GAAY;IACzD,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAC/E,MAAM,KAAK,GAAG,GAA8B,CAAC;IAC7C,IAAI,OAAO,KAAK,CAAC,QAAQ,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IACrD,OAAO;QACL,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,KAAK,EAAE,KAAK,CAAC,KAAK,KAAK,IAAI;QAC3B,MAAM,EAAE,KAAK,CAAC,MAAM,KAAK,IAAI;QAC7B,YAAY,EAAE,OAAO,KAAK,CAAC,YAAY,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;KACrH,CAAC;AACJ,CAAC;AAED,4FAA4F;AAC5F,MAAM,UAAU,eAAe,CAAC,KAAa;IAC3C,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;IACjD,OAAO,GAAG,MAAM,aAAa,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC;AACrE,CAAC;AAED,wFAAwF;AACxF,MAAM,UAAU,uBAAuB,CAAC,MAAwC;IAC9E,IAAI,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM,CAAC,QAAQ;QAAE,OAAO,IAAI,CAAC;IACrD,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,MAAM;QACzC,CAAC,CAAC,8DAA8D;QAChE,CAAC,CAAC,MAAM,CAAC,KAAK;YACZ,CAAC,CAAC,iCAAiC;YACnC,CAAC,CAAC,MAAM,CAAC,MAAM;gBACb,CAAC,CAAC,oCAAoC;gBACtC,CAAC,CAAC,wCAAwC,CAAC;IACjD,OAAO,kBAAkB,KAAK,cAAc,eAAe,CAAC,MAAM,CAAC,YAAY,CAAC,gDAAgD,CAAC;AACnI,CAAC"}

package/dist/scaffold/blender-level-skill-files.js

@@ -250,7 +250,7 @@ under the level. Then, in \`src/work/Game.ts\`, after the player controller exis
 
 \`\`\`ts
 import { MeshLevel, DEFAULT_MESH_LEVEL_OPTIONS } from 'engine/meshlevel/MeshLevel.js';
-import { DEFAULT_FALL_RESCUE_OPTIONS } from 'engine/FallRescue.js';
+import { DEFAULT_FALL_RESCUE_OPTIONS } from 'engine/player/life/FallRescue.js';
 import levelJson from './<name>.mesh-level.json';
 
 const level = new MeshLevel(this.engine, { glb: { assetId: 'level-<name>' }, level: { data: levelJson } }, DEFAULT_MESH_LEVEL_OPTIONS);
@@ -643,7 +643,7 @@ Run it after EVERY rebuild; a door moved in the script and not synced is a leaf
 
 \`\`\`ts
 import { MeshLevel, DEFAULT_MESH_LEVEL_OPTIONS } from 'engine/meshlevel/MeshLevel.js';
-import { DEFAULT_FALL_RESCUE_OPTIONS } from 'engine/FallRescue.js';
+import { DEFAULT_FALL_RESCUE_OPTIONS } from 'engine/player/life/FallRescue.js';
 import levelJson from './<name>.mesh-level.json';
 
 // After setupPlayerController(), before any NPC spawns.

package/dist/scaffold/game-migration.d.ts

@@ -0,0 +1,88 @@
+import type * as TS from 'typescript';
+import { type LegacyBody } from './legacy-game-baselines.js';
+/**
+ * `bitmagic upgrade --migrate-game`: turn a Game.ts written on the old baseline — a whole
+ * `class VoxelGame implements GameModule` that built its own Spawner, VehicleManager,
+ * VehicleSpawner and PlayerLoader and handed them to the engine with `setX()` — into the small
+ * `class VoxelGame extends VoxelGameBase` every game is now, keeping only what the creator changed.
+ *
+ * It only rewrites what it can prove:
+ *
+ * - a member identical (token for token, comments and layout ignored) to the same member in any
+ *   released baseline is the default, and is dropped;
+ * - `constructor`, `load`, `update` and `dispose` may additionally carry the creator's own
+ *   statements, but only inserted at a point a VoxelGameBase hook runs at — after the world
+ *   (`onWorldLoaded`), after the camera (`onCameraReady`), after the player controller
+ *   (`onPlayerReady`), at the end of a frame (`updateCamera`), beside the vehicles' disposal
+ *   (`disposeGameplay`), or at the very start or end of the method — and each default statement
+ *   must still be there, in order;
+ * - a modified `setupCamera` or `setupVoxelLighting` stays as an override (both are hooks now);
+ * - anything the creator added (fields, methods, top-level code) is kept as it is, with
+ *   `this.spawner` / `this.vehicleSpawner` read through `getSpawner()` / `getVehicleSpawner()`.
+ *
+ * Anything else — a default statement removed or edited, a statement added where no hook runs,
+ * a changed member VoxelGameBase also declares — leaves the file unchanged and says why. The
+ * result is then type-checked with the project's own compiler and put back if it does not
+ * compile, so a migration that runs is one that compiles.
+ */
+export declare const GAME_FILE = "src/work/Game.ts";
+export declare const BASE_FILE = "src/work/VoxelGameBase.ts";
+/** The new baseline, as the engine just vendored it. */
+export declare const VENDORED_BASELINE_DIR = "engine/baseline";
+/** The methods whose bodies may carry insertions, and the gaps they may sit in. */
+export type SegmentedMethod = 'constructor' | 'load' | 'update' | 'dispose';
+export declare const SEGMENTED_METHODS: readonly SegmentedMethod[];
+/** A statement or member compared by its tokens alone, so comments and layout never matter. */
+export declare function fingerprint(ts: typeof TS, node: TS.Node, sf: TS.SourceFile): string;
+/** What one Game.ts version contributes to the known defaults (the generator's half). */
+export interface LegacyGameShape {
+    members: Record<string, string>;
+    bodies: Partial<Record<SegmentedMethod, LegacyBody>>;
+}
+/**
+ * The fingerprints of a pre-VoxelGameBase Game.ts — every member, plus the statement list and
+ * hook gaps of each segmented method. Null when the file has no such class. Run over every
+ * released baseline by `scripts/gen-legacy-game-baselines.mjs` to produce the known defaults.
+ */
+export declare function describeLegacyGame(ts: typeof TS, text: string): LegacyGameShape | null;
+export type GameMigrationOutcome = {
+    status: 'migrated';
+    kept: string[];
+    hooks: string[];
+    wroteBase: boolean;
+} | {
+    status: 'already-migrated';
+} | {
+    status: 'skipped';
+    reason: string;
+};
+export interface PlanResult {
+    outcome: GameMigrationOutcome;
+    /** The new Game.ts, when the outcome is `migrated`. */
+    gameText?: string;
+}
+/**
+ * Plan the rewrite of one Game.ts against the new baseline: pure, reads nothing but its inputs.
+ *
+ * `newBaselineGame` is the vendored `engine/baseline/Game.ts` (the file a game with nothing of
+ * its own becomes, verbatim), `newBaseText` the vendored `VoxelGameBase.ts`.
+ */
+export declare function planGameMigration(ts: typeof TS, oldText: string, newBaselineGame: string, newBaseText: string): PlanResult;
+export interface TypeCheckResult {
+    ok: boolean;
+    /** The compiler's output, for the report when it failed. */
+    output: string;
+}
+export interface MigrateGameOptions {
+    root: string;
+    ts: typeof TS;
+    /** Runs the project's type-check; the migration is kept only when it passes before and after. */
+    typeCheck: () => TypeCheckResult;
+}
+/**
+ * Migrate `src/work/Game.ts` onto VoxelGameBase in place: plan it, write the new Game.ts and the
+ * vendored `VoxelGameBase.ts` beside it, type-check, and put both files back as they were when the
+ * project no longer compiles. A project that did not compile before is not touched at all, since
+ * a failure afterwards could not be told apart from one it already had.
+ */
+export declare function migrateGameFile(options: MigrateGameOptions): GameMigrationOutcome;

package/dist/scaffold/game-migration.js

@@ -0,0 +1,492 @@
+import * as fs from 'fs';
+import * as path from 'path';
+import { createHash } from 'crypto';
+import { LEGACY_GAME_BODIES, LEGACY_GAME_MEMBERS } from './legacy-game-baselines.js';
+/**
+ * `bitmagic upgrade --migrate-game`: turn a Game.ts written on the old baseline — a whole
+ * `class VoxelGame implements GameModule` that built its own Spawner, VehicleManager,
+ * VehicleSpawner and PlayerLoader and handed them to the engine with `setX()` — into the small
+ * `class VoxelGame extends VoxelGameBase` every game is now, keeping only what the creator changed.
+ *
+ * It only rewrites what it can prove:
+ *
+ * - a member identical (token for token, comments and layout ignored) to the same member in any
+ *   released baseline is the default, and is dropped;
+ * - `constructor`, `load`, `update` and `dispose` may additionally carry the creator's own
+ *   statements, but only inserted at a point a VoxelGameBase hook runs at — after the world
+ *   (`onWorldLoaded`), after the camera (`onCameraReady`), after the player controller
+ *   (`onPlayerReady`), at the end of a frame (`updateCamera`), beside the vehicles' disposal
+ *   (`disposeGameplay`), or at the very start or end of the method — and each default statement
+ *   must still be there, in order;
+ * - a modified `setupCamera` or `setupVoxelLighting` stays as an override (both are hooks now);
+ * - anything the creator added (fields, methods, top-level code) is kept as it is, with
+ *   `this.spawner` / `this.vehicleSpawner` read through `getSpawner()` / `getVehicleSpawner()`.
+ *
+ * Anything else — a default statement removed or edited, a statement added where no hook runs,
+ * a changed member VoxelGameBase also declares — leaves the file unchanged and says why. The
+ * result is then type-checked with the project's own compiler and put back if it does not
+ * compile, so a migration that runs is one that compiles.
+ */
+export const GAME_FILE = 'src/work/Game.ts';
+export const BASE_FILE = 'src/work/VoxelGameBase.ts';
+/** The new baseline, as the engine just vendored it. */
+export const VENDORED_BASELINE_DIR = 'engine/baseline';
+export const SEGMENTED_METHODS = ['constructor', 'load', 'update', 'dispose'];
+/** Changed methods that are hooks now, kept as `protected` overrides. */
+const HOOK_METHODS = new Set(['setupCamera', 'setupVoxelLighting']);
+/** The text a node's tokens make, single-spaced: comments and layout never count. */
+function tokenText(ts, node, sf) {
+    const tokens = [];
+    const walk = (n) => {
+        const children = n.getChildren(sf);
+        if (children.length === 0) {
+            // An empty syntax list (no arguments, no modifiers) is a leaf with no text.
+            const text = n.kind === ts.SyntaxKind.EndOfFileToken ? '' : n.getText(sf);
+            if (text.length > 0)
+                tokens.push(text);
+            return;
+        }
+        for (const child of children)
+            walk(child);
+    };
+    walk(node);
+    return tokens.join(' ');
+}
+/** A statement or member compared by its tokens alone, so comments and layout never matter. */
+export function fingerprint(ts, node, sf) {
+    return createHash('sha1').update(tokenText(ts, node, sf)).digest('hex').slice(0, 16);
+}
+function memberName(ts, member, sf) {
+    if (ts.isConstructorDeclaration(member))
+        return 'constructor';
+    if (!member.name)
+        return null;
+    const name = member.name.getText(sf);
+    if (ts.isGetAccessorDeclaration(member))
+        return `get ${name}`;
+    if (ts.isSetAccessorDeclaration(member))
+        return `set ${name}`;
+    return name;
+}
+function findGameClass(ts, sf) {
+    for (const statement of sf.statements) {
+        if (ts.isClassDeclaration(statement) && statement.name?.text === 'VoxelGame')
+            return statement;
+    }
+    return null;
+}
+/** The statements a segmented body is compared on: a `load` wrapped in try/catch is its try block. */
+function bodyStatements(ts, method) {
+    const body = (ts.isConstructorDeclaration(method) || ts.isMethodDeclaration(method)) ? method.body : undefined;
+    if (!body)
+        return null;
+    const only = body.statements.length === 1 ? body.statements[0] : undefined;
+    if (only && ts.isTryStatement(only) && only.catchClause && !only.finallyBlock) {
+        return { statements: only.tryBlock.statements, catchClause: only.catchClause };
+    }
+    return { statements: body.statements, catchClause: null };
+}
+/** The named gaps of a default body: where a hook (or the method's own start/end) runs. */
+function anchorsFor(method, texts) {
+    const at = (pred) => texts.findIndex(pred);
+    const anchors = { start: 0, end: texts.length };
+    if (method === 'constructor')
+        delete anchors.start;
+    if (method === 'load') {
+        delete anchors.start;
+        const player = at((t) => t.startsWith('this . playerLoader . prefetchPlayerAnimations') || t.startsWith('this . player = await this . playerLoader . loadPlayer'));
+        if (player >= 0)
+            anchors.onWorldLoaded = player;
+        const camera = at((t) => t === 'this . setupCamera ( ) ;');
+        if (camera >= 0)
+            anchors.onCameraReady = camera + 1;
+        const controller = at((t) => t === 'await this . setupPlayerController ( ) ;');
+        if (controller >= 0)
+            anchors.onPlayerReady = controller + 1;
+    }
+    if (method === 'dispose') {
+        const vehicles = at((t) => t === 'this . vehicleManager . dispose ( ) ;');
+        if (vehicles >= 0)
+            anchors.disposeGameplay = vehicles + 1;
+    }
+    return anchors;
+}
+/**
+ * The fingerprints of a pre-VoxelGameBase Game.ts — every member, plus the statement list and
+ * hook gaps of each segmented method. Null when the file has no such class. Run over every
+ * released baseline by `scripts/gen-legacy-game-baselines.mjs` to produce the known defaults.
+ */
+export function describeLegacyGame(ts, text) {
+    const sf = ts.createSourceFile('Game.ts', text, ts.ScriptTarget.Latest, true, ts.ScriptKind.TS);
+    const cls = findGameClass(ts, sf);
+    if (!cls || extendsClause(ts, cls))
+        return null;
+    const shape = { members: {}, bodies: {} };
+    for (const member of cls.members) {
+        const name = memberName(ts, member, sf);
+        if (name === null)
+            continue;
+        shape.members[name] = fingerprint(ts, member, sf);
+        if (SEGMENTED_METHODS.includes(name)) {
+            const body = bodyStatements(ts, member);
+            if (!body)
+                continue;
+            const texts = body.statements.map((s) => tokenText(ts, s, sf));
+            shape.bodies[name] = {
+                statements: body.statements.map((s) => fingerprint(ts, s, sf)),
+                ...(body.catchClause ? { catchClause: fingerprint(ts, body.catchClause, sf) } : {}),
+                anchors: anchorsFor(name, texts),
+            };
+        }
+    }
+    return shape;
+}
+function extendsClause(ts, cls) {
+    for (const clause of cls.heritageClauses ?? []) {
+        if (clause.token === ts.SyntaxKind.ExtendsKeyword)
+            return clause.types[0] ?? null;
+    }
+    return null;
+}
+function matchBody(ts, sf, method, statements, catchClause, version) {
+    const catchFp = catchClause ? fingerprint(ts, catchClause, sf) : undefined;
+    if (catchFp !== version.catchClause) {
+        return { ok: false, matched: 0, reason: `${method}() handles its errors differently from the baseline` };
+    }
+    const gaps = new Map();
+    let j = 0;
+    for (const statement of statements) {
+        if (j < version.statements.length && fingerprint(ts, statement, sf) === version.statements[j]) {
+            j++;
+            continue;
+        }
+        const list = gaps.get(j) ?? [];
+        list.push(statement);
+        gaps.set(j, list);
+    }
+    if (j < version.statements.length) {
+        return { ok: false, matched: j, reason: `${method}() no longer runs every statement the baseline's does (one was edited or removed)` };
+    }
+    const anchorAt = new Map(Object.entries(version.anchors).map(([name, gap]) => [gap, name]));
+    const byAnchor = new Map();
+    for (const [gap, added] of gaps) {
+        const anchor = anchorAt.get(gap);
+        if (anchor === undefined) {
+            const first = added[0];
+            const preview = first ? tokenText(ts, first, sf).slice(0, 60) : '';
+            return { ok: false, matched: j, reason: `${method}() has code added where no VoxelGameBase hook runs (\`${preview}\`)` };
+        }
+        byAnchor.set(anchor, added);
+    }
+    return { ok: true, insertions: { byAnchor } };
+}
+// ── Output ─────────────────────────────────────────────────────────────────────────────
+const MEMBER_INDENT = '    ';
+const BODY_INDENT = '        ';
+/** A text block with its blank edges trimmed and its common indentation replaced by `indent`. */
+function reindentText(text, indent) {
+    const lines = text.replace(/^\s*\n/, '').replace(/\s+$/, '').split('\n');
+    const widths = lines.filter((l) => l.trim().length > 0).map((l) => /^[ \t]*/.exec(l)?.[0].length ?? 0);
+    const strip = widths.length > 0 ? Math.min(...widths) : 0;
+    return lines.map((l) => (l.trim().length === 0 ? '' : indent + l.slice(strip))).join('\n');
+}
+/**
+ * A node's text with its leading comments, re-indented, with `this.spawner` /
+ * `this.vehicleSpawner` read through the getters VoxelGameBase keeps (the fields are gone: the
+ * engine owns both now) and a `private` modifier made `protected` when asked. Null when the node
+ * assigns one of those fields, which no rewrite can keep working.
+ */
+function nodeText(ts, sf, node, indent, makeProtected = false) {
+    const offset = node.getFullStart();
+    const edits = [];
+    let assigned = false;
+    const visit = (n) => {
+        if (ts.isPropertyAccessExpression(n) && n.expression.kind === ts.SyntaxKind.ThisKeyword
+            && (n.name.text === 'spawner' || n.name.text === 'vehicleSpawner')) {
+            const parent = n.parent;
+            if (ts.isBinaryExpression(parent) && parent.left === n && parent.operatorToken.kind === ts.SyntaxKind.EqualsToken)
+                assigned = true;
+            const getter = n.name.text === 'spawner' ? 'getSpawner' : 'getVehicleSpawner';
+            edits.push({ start: n.getStart(sf) - offset, end: n.end - offset, text: `this.${getter}()` });
+        }
+        ts.forEachChild(n, visit);
+    };
+    visit(node);
+    if (assigned)
+        return null;
+    if (makeProtected && ts.canHaveModifiers(node)) {
+        const modifier = ts.getModifiers(node)?.find((m) => m.kind === ts.SyntaxKind.PrivateKeyword);
+        if (modifier)
+            edits.push({ start: modifier.getStart(sf) - offset, end: modifier.end - offset, text: 'protected' });
+    }
+    let text = sf.text.slice(offset, node.end);
+    for (const e of edits.sort((x, y) => y.start - x.start))
+        text = text.slice(0, e.start) + e.text + text.slice(e.end);
+    return reindentText(text, indent);
+}
+function statementsText(ts, sf, statements, indent) {
+    const parts = [];
+    for (const statement of statements) {
+        const text = nodeText(ts, sf, statement, indent);
+        if (text === null)
+            return null;
+        parts.push(text);
+    }
+    return parts.join('\n');
+}
+/** The hook override a set of insertions becomes: its name and its signature, and whether the creator's code runs before `super`. */
+function hookFor(method, anchor, param) {
+    switch (`${method}:${anchor}`) {
+        case 'load:onWorldLoaded':
+            return { name: 'onWorldLoaded', signature: 'protected onWorldLoaded(): void', superCall: 'super.onWorldLoaded();', before: false };
+        case 'load:onCameraReady':
+            return { name: 'onCameraReady', signature: 'protected onCameraReady(): void', superCall: 'super.onCameraReady();', before: false };
+        case 'load:onPlayerReady':
+            return { name: 'onPlayerReady', signature: 'protected onPlayerReady(): void', superCall: 'super.onPlayerReady();', before: false };
+        case 'load:end':
+            return { name: 'load', signature: `async load(${param}: string): Promise<void>`, superCall: `await super.load(${param});`, before: false };
+        case 'update:start':
+            return { name: 'update', signature: `update(${param}: number): void`, superCall: `super.update(${param});`, before: true };
+        case 'update:end':
+            return { name: 'updateCamera', signature: `protected updateCamera(${param}: number): void`, superCall: `super.updateCamera(${param});`, before: false };
+        case 'dispose:start':
+            return { name: 'dispose', signature: 'dispose(): void', superCall: 'super.dispose();', before: true };
+        case 'dispose:disposeGameplay':
+            return { name: 'disposeGameplay', signature: 'protected disposeGameplay(): void', superCall: 'super.disposeGameplay();', before: false };
+        case 'dispose:end':
+            return { name: 'dispose', signature: 'dispose(): void', superCall: 'super.dispose();', before: false };
+        default:
+            throw new Error(`no hook for ${method}:${anchor}`);
+    }
+}
+/** The names a class declares, read from the vendored VoxelGameBase. */
+function baseMemberNames(ts, baseText) {
+    const sf = ts.createSourceFile('VoxelGameBase.ts', baseText, ts.ScriptTarget.Latest, true, ts.ScriptKind.TS);
+    const names = new Set();
+    for (const statement of sf.statements) {
+        if (!ts.isClassDeclaration(statement) || statement.name?.text !== 'VoxelGameBase')
+            continue;
+        for (const member of statement.members) {
+            const name = memberName(ts, member, sf);
+            if (name !== null)
+                names.add(name.replace(/^(get|set) /, ''));
+        }
+    }
+    return names;
+}
+/** Every identifier in a text, for pruning imports the new file no longer uses. */
+function identifiersIn(ts, text) {
+    const sf = ts.createSourceFile('x.ts', text, ts.ScriptTarget.Latest, true, ts.ScriptKind.TS);
+    const out = new Set();
+    const visit = (n) => {
+        if (ts.isIdentifier(n))
+            out.add(n.text);
+        ts.forEachChild(n, visit);
+    };
+    visit(sf);
+    return out;
+}
+/** An import declaration with only the bindings `used` names, or null when none are left. */
+function prunedImport(ts, sf, decl, used) {
+    const clause = decl.importClause;
+    if (!clause)
+        return decl.getText(sf); // a side-effect import is always kept
+    const keepDefault = clause.name !== undefined && used.has(clause.name.text);
+    const bindings = clause.namedBindings;
+    let named = null;
+    if (bindings && ts.isNamespaceImport(bindings)) {
+        named = used.has(bindings.name.text) ? bindings.getText(sf) : null;
+    }
+    else if (bindings && ts.isNamedImports(bindings)) {
+        const kept = bindings.elements.filter((e) => used.has(e.name.text)).map((e) => e.getText(sf));
+        named = kept.length > 0 ? `{ ${kept.join(', ')} }` : null;
+    }
+    if (!keepDefault && named === null)
+        return null;
+    if (keepDefault && named === null && bindings === undefined)
+        return decl.getText(sf);
+    const parts = [keepDefault && clause.name ? clause.name.text : null, named].filter((p) => p !== null);
+    const typeOnly = clause.isTypeOnly ? 'type ' : '';
+    return `import ${typeOnly}${parts.join(', ')} from ${decl.moduleSpecifier.getText(sf)};`;
+}
+const ASSIGNS_ENGINE_FIELD = 'assigns this.spawner or this.vehicleSpawner, which the engine owns now';
+/**
+ * Plan the rewrite of one Game.ts against the new baseline: pure, reads nothing but its inputs.
+ *
+ * `newBaselineGame` is the vendored `engine/baseline/Game.ts` (the file a game with nothing of
+ * its own becomes, verbatim), `newBaseText` the vendored `VoxelGameBase.ts`.
+ */
+export function planGameMigration(ts, oldText, newBaselineGame, newBaseText) {
+    const skip = (reason) => ({ outcome: { status: 'skipped', reason } });
+    const sf = ts.createSourceFile('Game.ts', oldText, ts.ScriptTarget.Latest, true, ts.ScriptKind.TS);
+    const cls = findGameClass(ts, sf);
+    if (!cls)
+        return skip('Game.ts has no `VoxelGame` class');
+    const heritage = extendsClause(ts, cls);
+    if (heritage) {
+        return heritage.expression.getText(sf) === 'VoxelGameBase'
+            ? { outcome: { status: 'already-migrated' } }
+            : skip(`VoxelGame extends ${heritage.expression.getText(sf)}, not the old baseline's class`);
+    }
+    const baseNames = baseMemberNames(ts, newBaseText);
+    if (baseNames.size === 0)
+        return skip('the vendored engine/baseline/VoxelGameBase.ts declares no VoxelGameBase class');
+    const fields = [];
+    const methods = [];
+    const kept = [];
+    const overrides = new Map();
+    let constructorTail = null;
+    for (const member of cls.members) {
+        const name = memberName(ts, member, sf);
+        if (name === null)
+            return skip('Game.ts has a class member this migration cannot name');
+        if (LEGACY_GAME_MEMBERS[name]?.includes(fingerprint(ts, member, sf)))
+            continue; // the default: VoxelGameBase has it
+        if (SEGMENTED_METHODS.includes(name)) {
+            const method = name;
+            const body = bodyStatements(ts, member);
+            if (!body)
+                return skip(`${method}() has no body to compare`);
+            let best = null;
+            for (const version of LEGACY_GAME_BODIES[method]) {
+                const match = matchBody(ts, sf, method, body.statements, body.catchClause, version);
+                if (match.ok) {
+                    best = match;
+                    break;
+                }
+                if (!best || (!best.ok && match.matched > best.matched))
+                    best = match;
+            }
+            if (!best)
+                return skip(`${method}() matches no released baseline`);
+            if (!best.ok)
+                return skip(best.reason);
+            const declared = ts.isMethodDeclaration(member) ? member.parameters[0]?.name.getText(sf) : undefined;
+            const param = declared ?? (method === 'load' ? 'gameId' : 'deltaTime');
+            for (const [anchor, added] of best.insertions.byAnchor) {
+                const text = statementsText(ts, sf, added, BODY_INDENT);
+                if (text === null)
+                    return skip(`${method}() ${ASSIGNS_ENGINE_FIELD}`);
+                if (method === 'constructor') {
+                    constructorTail = text;
+                    continue;
+                }
+                const hook = hookFor(method, anchor, param);
+                if (anchor !== 'end' && method === 'load' && added.some((s) => /\bawait\b/.test(s.getText(sf)))) {
+                    return skip(`load() awaits inside code that would move into the synchronous ${hook.name}() hook`);
+                }
+                if (overrides.has(hook.name))
+                    return skip(`two parts of the old Game.ts would both become ${hook.name}()`);
+                const superLine = `${BODY_INDENT}${hook.superCall}`;
+                const inner = hook.before ? `${text}\n${superLine}` : `${superLine}\n${text}`;
+                overrides.set(hook.name, `${MEMBER_INDENT}${hook.signature} {\n${inner}\n${MEMBER_INDENT}}`);
+            }
+            continue;
+        }
+        const isHook = HOOK_METHODS.has(name) && ts.isMethodDeclaration(member);
+        if (!isHook && baseNames.has(name)) {
+            return skip(`${name} is changed from the baseline and VoxelGameBase declares it too — move the change into a hook by hand`);
+        }
+        if (name === 'spawner' || name === 'vehicleSpawner') {
+            return skip(`the ${name} field is changed from the baseline; the engine owns it now`);
+        }
+        // A changed setupCamera/setupVoxelLighting is the same call in VoxelGameBase, now protected.
+        const text = nodeText(ts, sf, member, MEMBER_INDENT, isHook);
+        if (text === null)
+            return skip(`${name} ${ASSIGNS_ENGINE_FIELD}`);
+        if (ts.isPropertyDeclaration(member)) {
+            fields.push(text);
+            kept.push(`field ${name}`);
+        }
+        else {
+            methods.push(text);
+            kept.push(isHook ? `${name}() (kept as an override)` : `${name}()`);
+        }
+    }
+    // Everything outside the class (helpers, constants) stays, and so do the imports it and the kept members use.
+    const outside = [];
+    const imports = [];
+    for (const statement of sf.statements) {
+        if (statement === cls)
+            continue;
+        if (ts.isImportDeclaration(statement)) {
+            imports.push(statement);
+            continue;
+        }
+        const text = nodeText(ts, sf, statement, '');
+        if (text === null)
+            return skip(`code outside the class ${ASSIGNS_ENGINE_FIELD}`);
+        outside.push(text);
+    }
+    const hooks = [...overrides.keys()];
+    if (fields.length === 0 && methods.length === 0 && overrides.size === 0 && constructorTail === null && outside.length === 0) {
+        return { outcome: { status: 'migrated', kept: [], hooks: [], wroteBase: false }, gameText: newBaselineGame };
+    }
+    const ctorTail = constructorTail === null ? '' : `\n${constructorTail}`;
+    const constructorText = `${MEMBER_INDENT}constructor(engine: EngineLike, worldProfileData: WorldProfileData, gameData?: GameData) {\n`
+        + `${BODY_INDENT}super(engine, worldProfileData, gameData);${ctorTail}\n${MEMBER_INDENT}}`;
+    const classBody = [fields.join('\n'), constructorText, ...overrides.values(), ...methods].filter((p) => p.length > 0).join('\n\n');
+    // The new baseline's file comment and class comment, so a migrated file reads like a new one.
+    const newSf = ts.createSourceFile('Game.ts', newBaselineGame, ts.ScriptTarget.Latest, true, ts.ScriptKind.TS);
+    const newClass = findGameClass(ts, newSf);
+    const firstStatement = newSf.statements[0];
+    const header = firstStatement ? newBaselineGame.slice(0, firstStatement.getStart(newSf)) : '';
+    const classDoc = newClass ? newBaselineGame.slice(newClass.pos, newClass.getStart(newSf)).trim() : '';
+    const classText = `${classDoc ? `${classDoc}\n` : ''}export class VoxelGame extends VoxelGameBase {\n${classBody}\n}`;
+    const body = [...outside, classText].join('\n\n');
+    const used = identifiersIn(ts, body);
+    const importLines = imports.map((d) => prunedImport(ts, sf, d, used)).filter((l) => l !== null);
+    const joined = importLines.join('\n');
+    if (!['WorldProfileData', 'EngineLike', 'GameData'].every((n) => new RegExp(`\\b${n}\\b`).test(joined))) {
+        importLines.unshift("import type { WorldProfileData, EngineLike, GameData } from 'types/game.js';");
+    }
+    importLines.push("import { VoxelGameBase } from './VoxelGameBase.js';");
+    const gameText = `${header}${[...new Set(importLines)].join('\n')}\n\n${body}\n`;
+    return { outcome: { status: 'migrated', kept, hooks, wroteBase: false }, gameText };
+}
+/**
+ * Migrate `src/work/Game.ts` onto VoxelGameBase in place: plan it, write the new Game.ts and the
+ * vendored `VoxelGameBase.ts` beside it, type-check, and put both files back as they were when the
+ * project no longer compiles. A project that did not compile before is not touched at all, since
+ * a failure afterwards could not be told apart from one it already had.
+ */
+export function migrateGameFile(options) {
+    const { root, ts } = options;
+    const gamePath = path.join(root, GAME_FILE);
+    const basePath = path.join(root, BASE_FILE);
+    const vendoredGame = path.join(root, VENDORED_BASELINE_DIR, 'Game.ts');
+    const vendoredBase = path.join(root, VENDORED_BASELINE_DIR, 'VoxelGameBase.ts');
+    if (!fs.existsSync(gamePath))
+        return { status: 'skipped', reason: `${GAME_FILE} does not exist` };
+    if (!fs.existsSync(vendoredBase) || !fs.existsSync(vendoredGame)) {
+        return { status: 'skipped', reason: 'the vendored engine has no baseline/VoxelGameBase.ts — upgrade to an engine that has one first' };
+    }
+    const oldText = fs.readFileSync(gamePath, 'utf-8');
+    const baseText = fs.readFileSync(vendoredBase, 'utf-8');
+    const plan = planGameMigration(ts, oldText, fs.readFileSync(vendoredGame, 'utf-8'), baseText);
+    if (plan.outcome.status !== 'migrated' || plan.gameText === undefined)
+        return plan.outcome;
+    const existingBase = fs.existsSync(basePath) ? fs.readFileSync(basePath, 'utf-8') : null;
+    if (existingBase !== null && existingBase !== baseText) {
+        return { status: 'skipped', reason: `${BASE_FILE} already exists and differs from the engine's — merge it by hand first` };
+    }
+    const before = options.typeCheck();
+    if (!before.ok) {
+        return { status: 'skipped', reason: `the project does not type-check before the migration; fix that first (run \`bitmagic check\`):\n${firstLines(before.output)}` };
+    }
+    fs.writeFileSync(gamePath, plan.gameText);
+    if (existingBase === null)
+        fs.writeFileSync(basePath, baseText);
+    const after = options.typeCheck();
+    if (!after.ok) {
+        fs.writeFileSync(gamePath, oldText);
+        if (existingBase === null)
+            fs.rmSync(basePath);
+        return { status: 'skipped', reason: `the migrated Game.ts does not type-check, so it was put back:\n${firstLines(after.output)}` };
+    }
+    return { ...plan.outcome, wroteBase: existingBase === null };
+}
+function firstLines(text, count = 8) {
+    return text.split('\n').filter((l) => l.trim().length > 0).slice(0, count).map((l) => `  ${l}`).join('\n');
+}
+//# sourceMappingURL=game-migration.js.map