@vgai/engine 0.5.12 → 0.5.14

package/dist/render/voxel-surface.d.ts

@@ -0,0 +1,117 @@
+/**
+ * A face-culled surface mesh for a dense grid of cubic cells, as one real `THREE.BufferGeometry`.
+ *
+ * A game that stores its world as a grid of cubes — terrain a player digs, a builder's block
+ * palette, a level authored as a 3D tilemap — cannot draw a `BoxGeometry` per cell: a modest
+ * 80×7×80 volume is 44 800 boxes, and the ones buried inside the solid are invisible forever. The
+ * fix is a single surface built from only the faces that touch an empty neighbour. That is what
+ * this file is, and it is the whole of it.
+ *
+ * ## It is a HELPER, not a wrapper
+ *
+ * `buildVoxelSurface` takes plain arrays and hands back three's own `BufferGeometry`. Every call
+ * after it is three's API — pick your own material, wrap it in a `Mesh` or an `InstancedMesh`,
+ * `.translate()` it, hand it to Rapier's trimesh collider. Nothing here holds a scene, a camera, a
+ * frame loop or a cache, and nothing here is a class you inherit from.
+ *
+ * ## The rung audit that put ~200 lines here instead of a dependency (2026-08-14)
+ *
+ * Checked against the npm registry on the day this landed, not from memory:
+ *
+ *  - **`voxel-mesh` 0.3.0** (voxel.js) — last publish **2013-06-13**. Its `index.js` builds a
+ *    `THREE.Geometry` out of `THREE.Face3`, both REMOVED from three in r125. It cannot run against
+ *    this repo's three at all.
+ *  - **`voxel-mesher` 0.14.4** (2016-03-26) and **`greedy-mesher` 1.0.3** (2016-02-12) — the
+ *    voxel.js meshing pair. Both are `ndarray`-shaped, untyped, and stop at a list of quads: the
+ *    `BufferGeometry` is still yours to write. `voxel-mesher` additionally pulls a WebGL1 buffer
+ *    stack (`gl-buffer`, `gl-vao`) that has nothing to do with three.
+ *  - **`voxel-engine` 0.20.2** (2015-04-11) — a whole game framework (20 dependencies, its own
+ *    camera, controls and physics). The thing this rule bans.
+ *  - **`@voxelize/core` 3.0.0** (2026-08-03) — the one MAINTAINED option, and the one to say no to
+ *    deliberately. It is a client for a multiplayer voxel platform: `socket.io-client`, its own
+ *    wire protocol, its own physics engine and a WASM mesher fed by its own chunk/world objects.
+ *    You do not call its mesher; you build your game inside it. Adopting it to draw a static grid
+ *    would put a platform between the game and three.
+ *
+ * So: every maintained option is an ENGINE you build inside, and every option that is a helper died
+ * with voxel.js a decade ago against a three that no longer exists. The general shape *is* ready —
+ * "cull the hidden faces of a dense grid" has been settled since 2012 — it is the packaging that is
+ * not. Hence a helper here, in host vocabulary, that hands back three's own object.
+ *
+ * ## What is deliberately NOT here
+ *
+ * **Greedy meshing.** Merging coplanar same-type faces into larger quads is the standard next step
+ * and it does not fall out of this one: it needs a per-slice sweep with its own visited mask and
+ * its own bugs, and it changes the vertex↔cell relationship that per-face culling keeps exact.
+ * Per-face culling already removes the interior, which is the order-of-magnitude win. Add greedy
+ * meshing the day a measured frame budget asks for it, as its own function beside this one.
+ *
+ * **Lighting, ambient occlusion, textures, atlases, transparency sorting and chunking.** Each is a
+ * real decision a game makes for itself; this returns geometry and gets out of the way.
+ */
+import { BufferGeometry } from 'three';
+/**
+ * A dense grid of cubic cells.
+ *
+ * `cells` is indexed **Y-major, then Z, then X** — `((y * sizeZ) + z) * sizeX + x`. Y outermost is
+ * the ordering that makes each horizontal LAYER contiguous, which is what lets a mostly-flat world
+ * ship as a handful of runs (see {@link expandVoxelRuns}) instead of a megabyte of literals.
+ */
+export interface VoxelVolume {
+    /** Cell counts along X, Y and Z. */
+    readonly size: readonly [number, number, number];
+    /** `sizeX * sizeY * sizeZ` type ids. `0` is empty unless {@link VoxelSurfaceOptions.emptyType}. */
+    readonly cells: ArrayLike<number>;
+    /** World position of the volume's minimum corner. Defaults to the origin. */
+    readonly origin?: readonly [number, number, number];
+    /** World edge length of one cell. Defaults to 1. */
+    readonly cellSize?: number;
+}
+export interface VoxelSurfaceOptions {
+    /**
+     * Type id → `0xRRGGBB`, written into the geometry's `color` attribute. Supply it and the mesh
+     * draws with `vertexColors: true` in one draw call; omit it and the geometry carries no colour
+     * attribute at all. A solid type absent from the map is an ERROR, not a silent default: a
+     * missing colour is the shape of a forgotten row, and a mesh that quietly paints it white looks
+     * like a lighting bug three files away.
+     */
+    readonly colors?: ReadonlyMap<number, number>;
+    /** The type id that means "no cell here". Defaults to `0`. */
+    readonly emptyType?: number;
+    /**
+     * Whether cells just outside the volume count as solid. `false` (the default) walls the volume
+     * in — the right answer for a standalone model. `true` leaves the boundary open, which is what a
+     * chunk meshed beside its neighbours wants.
+     */
+    readonly closedBoundary?: boolean;
+}
+export interface VoxelSurface {
+    /** Indexed, with `position`, `normal` and (when colours were supplied) `color`. */
+    readonly geometry: BufferGeometry;
+    /** Faces that survived culling. `vertices` is `4 ×` this, `triangles` `2 ×`. */
+    readonly quads: number;
+    readonly vertices: number;
+    readonly triangles: number;
+    /** Cells whose type is not the empty type — the input's own size, for a sanity check. */
+    readonly solidCells: number;
+    /** Faces contributed per type id, in ascending id order. */
+    readonly quadsByType: ReadonlyMap<number, number>;
+}
+export declare class VoxelSurfaceError extends Error {
+    constructor(message: string);
+}
+/**
+ * Expand `[count, type, count, type, …]` run pairs into a dense cell array.
+ *
+ * A voxel volume is enormous and almost entirely repetitive, so the compact form is what a game
+ * SHIPS — in a source file, in a save, over the wire — and the dense form is what it meshes. The
+ * total of the counts must be exactly `cellCount`: a short or long run list is a corrupt volume,
+ * and silently padding it with empties would mesh a plausible wrong world.
+ */
+export declare function expandVoxelRuns(runs: ArrayLike<number>, cellCount: number): Uint16Array | Uint32Array;
+/**
+ * Build the visible surface of a voxel volume: one indexed `BufferGeometry` carrying every face
+ * that touches an empty neighbour, and nothing else.
+ */
+export declare function buildVoxelSurface(volume: VoxelVolume, options?: VoxelSurfaceOptions): VoxelSurface;
+//# sourceMappingURL=voxel-surface.d.ts.map

package/dist/render/voxel-surface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"voxel-surface.d.ts","sourceRoot":"","sources":["../../src/render/voxel-surface.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkDG;AACH,OAAO,EAAmB,cAAc,EAAS,MAAM,OAAO,CAAC;AAE/D;;;;;;GAMG;AACH,MAAM,WAAW,WAAW;IAC1B,oCAAoC;IACpC,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACjD,mGAAmG;IACnG,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;IAClC,6EAA6E;IAC7E,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACpD,oDAAoD;IACpD,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,mBAAmB;IAClC;;;;;;OAMG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9C,8DAA8D;IAC9D,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B;;;;OAIG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC;CACnC;AAED,MAAM,WAAW,YAAY;IAC3B,mFAAmF;IACnF,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;IAClC,gFAAgF;IAChF,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,yFAAyF;IACzF,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,4DAA4D;IAC5D,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnD;AAED,qBAAa,iBAAkB,SAAQ,KAAK;gBAC9B,OAAO,EAAE,MAAM;CAI5B;AAkED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,SAAS,CAAC,MAAM,CAAC,EACvB,SAAS,EAAE,MAAM,GAChB,WAAW,GAAG,WAAW,CA2B3B;AA2ED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,WAAW,EACnB,OAAO,GAAE,mBAAwB,GAChC,YAAY,CA+Dd"}

package/dist/render/voxel-surface.js

@@ -0,0 +1,263 @@
+/**
+ * A face-culled surface mesh for a dense grid of cubic cells, as one real `THREE.BufferGeometry`.
+ *
+ * A game that stores its world as a grid of cubes — terrain a player digs, a builder's block
+ * palette, a level authored as a 3D tilemap — cannot draw a `BoxGeometry` per cell: a modest
+ * 80×7×80 volume is 44 800 boxes, and the ones buried inside the solid are invisible forever. The
+ * fix is a single surface built from only the faces that touch an empty neighbour. That is what
+ * this file is, and it is the whole of it.
+ *
+ * ## It is a HELPER, not a wrapper
+ *
+ * `buildVoxelSurface` takes plain arrays and hands back three's own `BufferGeometry`. Every call
+ * after it is three's API — pick your own material, wrap it in a `Mesh` or an `InstancedMesh`,
+ * `.translate()` it, hand it to Rapier's trimesh collider. Nothing here holds a scene, a camera, a
+ * frame loop or a cache, and nothing here is a class you inherit from.
+ *
+ * ## The rung audit that put ~200 lines here instead of a dependency (2026-08-14)
+ *
+ * Checked against the npm registry on the day this landed, not from memory:
+ *
+ *  - **`voxel-mesh` 0.3.0** (voxel.js) — last publish **2013-06-13**. Its `index.js` builds a
+ *    `THREE.Geometry` out of `THREE.Face3`, both REMOVED from three in r125. It cannot run against
+ *    this repo's three at all.
+ *  - **`voxel-mesher` 0.14.4** (2016-03-26) and **`greedy-mesher` 1.0.3** (2016-02-12) — the
+ *    voxel.js meshing pair. Both are `ndarray`-shaped, untyped, and stop at a list of quads: the
+ *    `BufferGeometry` is still yours to write. `voxel-mesher` additionally pulls a WebGL1 buffer
+ *    stack (`gl-buffer`, `gl-vao`) that has nothing to do with three.
+ *  - **`voxel-engine` 0.20.2** (2015-04-11) — a whole game framework (20 dependencies, its own
+ *    camera, controls and physics). The thing this rule bans.
+ *  - **`@voxelize/core` 3.0.0** (2026-08-03) — the one MAINTAINED option, and the one to say no to
+ *    deliberately. It is a client for a multiplayer voxel platform: `socket.io-client`, its own
+ *    wire protocol, its own physics engine and a WASM mesher fed by its own chunk/world objects.
+ *    You do not call its mesher; you build your game inside it. Adopting it to draw a static grid
+ *    would put a platform between the game and three.
+ *
+ * So: every maintained option is an ENGINE you build inside, and every option that is a helper died
+ * with voxel.js a decade ago against a three that no longer exists. The general shape *is* ready —
+ * "cull the hidden faces of a dense grid" has been settled since 2012 — it is the packaging that is
+ * not. Hence a helper here, in host vocabulary, that hands back three's own object.
+ *
+ * ## What is deliberately NOT here
+ *
+ * **Greedy meshing.** Merging coplanar same-type faces into larger quads is the standard next step
+ * and it does not fall out of this one: it needs a per-slice sweep with its own visited mask and
+ * its own bugs, and it changes the vertex↔cell relationship that per-face culling keeps exact.
+ * Per-face culling already removes the interior, which is the order-of-magnitude win. Add greedy
+ * meshing the day a measured frame budget asks for it, as its own function beside this one.
+ *
+ * **Lighting, ambient occlusion, textures, atlases, transparency sorting and chunking.** Each is a
+ * real decision a game makes for itself; this returns geometry and gets out of the way.
+ */
+import { BufferAttribute, BufferGeometry, Color } from 'three';
+export class VoxelSurfaceError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'VoxelSurfaceError';
+    }
+}
+/**
+ * The six faces of the unit cell, each as four corners in counter-clockwise order seen from
+ * OUTSIDE — which is the winding three's default `FrontSide` draws.
+ */
+const FACES = [
+    {
+        normal: [1, 0, 0],
+        corners: [
+            [1, 0, 1],
+            [1, 0, 0],
+            [1, 1, 0],
+            [1, 1, 1],
+        ],
+    },
+    {
+        normal: [-1, 0, 0],
+        corners: [
+            [0, 0, 0],
+            [0, 0, 1],
+            [0, 1, 1],
+            [0, 1, 0],
+        ],
+    },
+    {
+        normal: [0, 1, 0],
+        corners: [
+            [0, 1, 1],
+            [1, 1, 1],
+            [1, 1, 0],
+            [0, 1, 0],
+        ],
+    },
+    {
+        normal: [0, -1, 0],
+        corners: [
+            [0, 0, 0],
+            [1, 0, 0],
+            [1, 0, 1],
+            [0, 0, 1],
+        ],
+    },
+    {
+        normal: [0, 0, 1],
+        corners: [
+            [0, 0, 1],
+            [1, 0, 1],
+            [1, 1, 1],
+            [0, 1, 1],
+        ],
+    },
+    {
+        normal: [0, 0, -1],
+        corners: [
+            [1, 0, 0],
+            [0, 0, 0],
+            [0, 1, 0],
+            [1, 1, 0],
+        ],
+    },
+];
+/**
+ * Expand `[count, type, count, type, …]` run pairs into a dense cell array.
+ *
+ * A voxel volume is enormous and almost entirely repetitive, so the compact form is what a game
+ * SHIPS — in a source file, in a save, over the wire — and the dense form is what it meshes. The
+ * total of the counts must be exactly `cellCount`: a short or long run list is a corrupt volume,
+ * and silently padding it with empties would mesh a plausible wrong world.
+ */
+export function expandVoxelRuns(runs, cellCount) {
+    if (runs.length % 2 !== 0) {
+        throw new VoxelSurfaceError(`a run list is [count, type] pairs, so its length must be even; got ${runs.length}`);
+    }
+    let widest = 0;
+    let total = 0;
+    for (let pair = 0; pair < runs.length; pair += 2) {
+        const count = runs[pair];
+        if (!Number.isInteger(count) || count <= 0) {
+            throw new VoxelSurfaceError(`run ${pair / 2} has a count of ${count}; counts are positive`);
+        }
+        total += count;
+        widest = Math.max(widest, runs[pair + 1]);
+    }
+    if (total !== cellCount) {
+        throw new VoxelSurfaceError(`the runs cover ${total} cells; the volume holds ${cellCount}`);
+    }
+    const cells = widest > 0xffff ? new Uint32Array(cellCount) : new Uint16Array(cellCount);
+    let at = 0;
+    for (let pair = 0; pair < runs.length; pair += 2) {
+        const count = runs[pair];
+        cells.fill(runs[pair + 1], at, at + count);
+        at += count;
+    }
+    return cells;
+}
+/** The volume's size, after checking that the cell array is exactly the size it claims. */
+function assertVolumeShape(volume) {
+    const [sizeX, sizeY, sizeZ] = volume.size;
+    if (sizeX <= 0 || sizeY <= 0 || sizeZ <= 0) {
+        throw new VoxelSurfaceError(`a volume needs a positive size on every axis; got ${volume.size}`);
+    }
+    const cellCount = sizeX * sizeY * sizeZ;
+    if (volume.cells.length !== cellCount) {
+        throw new VoxelSurfaceError(`a ${sizeX}×${sizeY}×${sizeZ} volume holds ${cellCount} cells; got ${volume.cells.length}`);
+    }
+    return [sizeX, sizeY, sizeZ];
+}
+/** The linear-space vertex colour for one type, or `undefined` when colours were not asked for. */
+function vertexColor(colors, type, where, into) {
+    if (colors === undefined)
+        return undefined;
+    const hex = colors.get(type);
+    if (hex === undefined) {
+        throw new VoxelSurfaceError(`no colour for type ${type}, which cell ${where} holds — every solid type in the volume ` +
+            'needs a row, so a forgotten one fails here rather than drawing white');
+    }
+    // `setHex` defaults to `SRGBColorSpace` and converts INTO the working space itself, which is
+    // exactly what a material does with a colour uniform. Do not convert again on top of it: an
+    // extra `convertSRGBToLinear()` here squared the conversion and drew a mid-green world in near
+    // black, with every channel still plausible enough to read as a lighting problem.
+    return into.setHex(hex);
+}
+/** Append the faces of one solid cell that face an empty neighbour. Returns how many. */
+function emitCellFaces(buffers, cell, type, color, solidAt, place) {
+    const [x, y, z] = cell;
+    let emitted = 0;
+    for (const face of FACES) {
+        const [nx, ny, nz] = face.normal;
+        if (solidAt(x + nx, y + ny, z + nz))
+            continue;
+        const base = buffers.positions.length / 3;
+        for (const [cx, cy, cz] of face.corners) {
+            buffers.positions.push(...place(x + cx, y + cy, z + cz));
+            buffers.normals.push(nx, ny, nz);
+            if (color !== undefined)
+                buffers.colors.push(color.r, color.g, color.b);
+        }
+        buffers.indices.push(base, base + 1, base + 2, base, base + 2, base + 3);
+        buffers.quadsByType.set(type, (buffers.quadsByType.get(type) ?? 0) + 1);
+        emitted += 1;
+    }
+    return emitted;
+}
+/**
+ * Build the visible surface of a voxel volume: one indexed `BufferGeometry` carrying every face
+ * that touches an empty neighbour, and nothing else.
+ */
+export function buildVoxelSurface(volume, options = {}) {
+    const [sizeX, sizeY, sizeZ] = assertVolumeShape(volume);
+    const empty = options.emptyType ?? 0;
+    const openBoundary = options.closedBoundary !== true;
+    const scale = volume.cellSize ?? 1;
+    const [originX, originY, originZ] = volume.origin ?? [0, 0, 0];
+    const cells = volume.cells;
+    const at = (x, y, z) => cells[(y * sizeZ + z) * sizeX + x];
+    const solidAt = (x, y, z) => {
+        const outsideVolume = x < 0 || y < 0 || z < 0 || x >= sizeX || y >= sizeY || z >= sizeZ;
+        return outsideVolume ? !openBoundary : at(x, y, z) !== empty;
+    };
+    const place = (x, y, z) => [
+        originX + x * scale,
+        originY + y * scale,
+        originZ + z * scale,
+    ];
+    const buffers = {
+        positions: [],
+        normals: [],
+        colors: [],
+        indices: [],
+        quadsByType: new Map(),
+    };
+    const scratch = new Color();
+    let solidCells = 0;
+    let quads = 0;
+    for (let y = 0; y < sizeY; y += 1) {
+        for (let z = 0; z < sizeZ; z += 1) {
+            for (let x = 0; x < sizeX; x += 1) {
+                const type = at(x, y, z);
+                if (type === empty)
+                    continue;
+                solidCells += 1;
+                const color = vertexColor(options.colors, type, `(${x}, ${y}, ${z})`, scratch);
+                quads += emitCellFaces(buffers, [x, y, z], type, color, solidAt, place);
+            }
+        }
+    }
+    const geometry = new BufferGeometry();
+    geometry.setAttribute('position', new BufferAttribute(new Float32Array(buffers.positions), 3));
+    geometry.setAttribute('normal', new BufferAttribute(new Float32Array(buffers.normals), 3));
+    if (options.colors !== undefined) {
+        geometry.setAttribute('color', new BufferAttribute(new Float32Array(buffers.colors), 3));
+    }
+    const vertices = buffers.positions.length / 3;
+    const indices = vertices > 0xffff ? new Uint32Array(buffers.indices) : new Uint16Array(buffers.indices);
+    geometry.setIndex(new BufferAttribute(indices, 1));
+    geometry.computeBoundingSphere();
+    geometry.computeBoundingBox();
+    return {
+        geometry,
+        quads,
+        vertices,
+        triangles: quads * 2,
+        solidCells,
+        quadsByType: new Map([...buffers.quadsByType].sort(([a], [b]) => a - b)),
+    };
+}

package/dist/runtime/create-runtime.js

@@ -478,6 +478,13 @@ async function createRootsGameRuntime(config) {
         const isReact = kindById.get(entry.id) === 'dom';
         const surface = document.createElement(isReact ? 'div' : 'canvas');
         surface.dataset['vgaiRootSurface'] = 'true';
+        // WHICH ROOT THIS SURFACE PRESENTS — the host mounted it, so the host
+        // knows, and stamping it here is the difference between a declaration and
+        // the guess every late reader had to make instead ("the first <canvas> in
+        // DOM order is the game's"). Read by `packages/editor/src/presentation-
+        // surface.ts`, which is the one door the capture/staleness/screenshot
+        // sites now ask (ARCHITECTURE-CORE §The editor protocol, zero inference).
+        surface.dataset['vgaiRootId'] = entry.id;
         // The capture's marker (`composite-screenshot.ts` reads exactly this
         // attribute): a dev layer is excluded from a play capture unless the
         // capture asks for it, because a contaminated "does the game look right"

package/dist/runtime/debug-bridge.d.ts

@@ -110,10 +110,10 @@ export interface VgaiDebugInputHandle {
  *  `state` from another). */
 export interface VgaiDebugSnapshot {
     /** `loopLiveness` (issue #175): the REAL `GameLoop.liveness` behind this
-     *  session — `'hidden-paused'` while the T2.1 idle throttle has stopped
-     *  the loop (tab hidden), `null` only when no loop is wired at all (a
-     *  bare debug-registry test stand-in with no real `Game`). Never a
-     *  fabricated `'running'`. */
+     *  session — `'loop-starved'` when no recent host rAF progress was observed,
+     *  `null` only when no loop is wired at all (a bare debug-registry test
+     *  stand-in with no real `Game`). Never a fabricated `'running'` and never
+     *  a conclusion about tab visibility. */
     time: {
         simSeconds: number;
         tick: number;
@@ -227,13 +227,13 @@ export interface MaybeInstallDebugBridgeOptions {
      *  touching (or requiring) the global object. */
     readonly window?: DebugBridgeWindowTarget | undefined;
 }
-/** The message a hold gets when the loop is hidden-paused and NOTHING can
+/** The message a hold gets when the loop is loop-starved and NOTHING can
  *  drive it — the one case where the platform genuinely prevents the verb
  *  from working. Names the cause and the fix rather than expiring into a
  *  generic stall (which reported the wrong cause: "play stopped during
  *  hold"). One exported constant so both doors and their tests read the same
  *  string. */
-export declare const HOLD_HIDDEN_NO_DRIVER_REASON: string;
+export declare const HOLD_STARVED_NO_DRIVER_REASON: string;
 /**
  * Resolves once `simSeconds` of sim time has elapsed since the call, or once
  * the wait provably cannot make progress. Never rejects. Exported (not just
@@ -249,8 +249,8 @@ export declare const HOLD_HIDDEN_NO_DRIVER_REASON: string;
  *   `HOLD_FOR_POLL_MS` and gives up after `HOLD_FOR_STALL_POLL_LIMIT`
  *   consecutive unchanged-tick polls (`stalled: true` — play stopped/paused).
  *
- * - **Hidden-paused**: the host loop has stopped outright (T2.1's idle
- *   throttle), so sim time only moves if this drives it. It therefore drives
+ * - **Loop-starved**: no recent host rAF progress is observable, so sim time
+ *   only moves reliably if this drives it. It therefore drives
  *   the WHOLE remaining budget in synchronous batches, yielding a MICROTASK
  *   between them — never a timer. That distinction is load-bearing, not
  *   stylistic: a hidden tab clamps `setTimeout` to ~1s (and to ~1/minute under
@@ -263,18 +263,18 @@ export declare const HOLD_HIDDEN_NO_DRIVER_REASON: string;
  *   are not throttled, so the hidden path now costs sim-work time and nothing
  *   else.
  *
- * The regime is re-read every iteration, so a tab foregrounded (or hidden)
- * mid-hold crosses over without restarting the budget.
+ * The regime is re-read every iteration, so an rAF chain that resumes or
+ * becomes starved mid-hold crosses over without restarting the budget.
  *
- * `hiddenWithoutDriver: true` is the one honest refusal: hidden-paused with
- * no `driveHiddenTicks` hook means nothing in this process can advance the
+ * `starvedWithoutDriver: true` is the one honest refusal: loop-starved with
+ * no `driveStarvedTicks` hook means nothing in this process can advance the
  * clock, so it reports that IMMEDIATELY (see
- * {@link HOLD_HIDDEN_NO_DRIVER_REASON}) instead of burning the stall guard
+ * {@link HOLD_STARVED_NO_DRIVER_REASON}) instead of burning the stall guard
  * and then blaming a stopped game.
  */
-export declare function waitForHoldBudget(adapter: DebugAdapter, simSeconds: number, driveHiddenTicks?: (n: number) => void): Promise<{
+export declare function waitForHoldBudget(adapter: DebugAdapter, simSeconds: number, driveStarvedTicks?: (n: number) => void): Promise<{
     stalled: boolean;
-    hiddenWithoutDriver?: boolean;
+    starvedWithoutDriver?: boolean;
 }>;
 /**
  * Install `window.__vgai` iff the page opted in (`?vgai-debug=1`) AND D18's

package/dist/runtime/debug-bridge.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"debug-bridge.d.ts","sourceRoot":"","sources":["../../src/runtime/debug-bridge.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"debug-bridge.d.ts","sourceRoot":"","sources":["../../src/runtime/debug-bridge.ts"],"names":[],"mappings":"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"}

package/dist/runtime/debug-bridge.js

@@ -31,25 +31,26 @@ const HOLD_FOR_POLL_MS = 50;
  *  faster in-process interval so the wall-clock grace period (~5s) lands in
  *  the same neighborhood. */
 const HOLD_FOR_STALL_POLL_LIMIT = 100;
-/** Ticks driven per synchronous hidden-tab batch. Sized like
+/** Ticks driven per synchronous starved-loop batch. Sized like
  *  `fast-forward.ts`'s own batching rationale: big enough that per-batch
  *  bookkeeping is negligible, small enough that one batch of a complex game's
  *  phases stays a short synchronous burst. */
-const HIDDEN_DRIVE_BATCH_TICKS = 60;
-/** Hard ceiling on hidden-drive batches for ONE hold — `HIDDEN_DRIVE_BATCH_TICKS
+const STARVED_DRIVE_BATCH_TICKS = 60;
+/** Hard ceiling on starved-drive batches for ONE hold — `STARVED_DRIVE_BATCH_TICKS
  *  * this` ≈ 33 sim-minutes. A bound, not a timeout: it exists so a
  *  `runTicks` target that advances the tick counter without advancing the sim
  *  clock can never spin forever, and it is far past any honest hold. */
-const HIDDEN_DRIVE_MAX_BATCHES = 2000;
-/** The message a hold gets when the loop is hidden-paused and NOTHING can
+const STARVED_DRIVE_MAX_BATCHES = 2000;
+/** The message a hold gets when the loop is loop-starved and NOTHING can
  *  drive it — the one case where the platform genuinely prevents the verb
  *  from working. Names the cause and the fix rather than expiring into a
  *  generic stall (which reported the wrong cause: "play stopped during
  *  hold"). One exported constant so both doors and their tests read the same
  *  string. */
-export const HOLD_HIDDEN_NO_DRIVER_REASON = 'the editor tab is hidden and this session has no way to drive ticks — the engine ' +
-    'hidden-pauses its loop while document.hidden, so zero ticks are happening. Bring the ' +
-    'editor tab to the foreground (or start play, which wires the run-ticks target) and retry.';
+export const HOLD_STARVED_NO_DRIVER_REASON = "the host loop reported liveness 'loop-starved' and this session has no way to drive " +
+    'ticks — no recent rAF progress was observed. Check `vgai status` for the separate ' +
+    'visibility readings; foreground/reload the editor, or start play to wire the run-ticks ' +
+    'target, then retry.';
 /**
  * Resolves once `simSeconds` of sim time has elapsed since the call, or once
  * the wait provably cannot make progress. Never rejects. Exported (not just
@@ -65,8 +66,8 @@ export const HOLD_HIDDEN_NO_DRIVER_REASON = 'the editor tab is hidden and this s
  *   `HOLD_FOR_POLL_MS` and gives up after `HOLD_FOR_STALL_POLL_LIMIT`
  *   consecutive unchanged-tick polls (`stalled: true` — play stopped/paused).
  *
- * - **Hidden-paused**: the host loop has stopped outright (T2.1's idle
- *   throttle), so sim time only moves if this drives it. It therefore drives
+ * - **Loop-starved**: no recent host rAF progress is observable, so sim time
+ *   only moves reliably if this drives it. It therefore drives
  *   the WHOLE remaining budget in synchronous batches, yielding a MICROTASK
  *   between them — never a timer. That distinction is load-bearing, not
  *   stylistic: a hidden tab clamps `setTimeout` to ~1s (and to ~1/minute under
@@ -79,32 +80,32 @@ export const HOLD_HIDDEN_NO_DRIVER_REASON = 'the editor tab is hidden and this s
  *   are not throttled, so the hidden path now costs sim-work time and nothing
  *   else.
  *
- * The regime is re-read every iteration, so a tab foregrounded (or hidden)
- * mid-hold crosses over without restarting the budget.
+ * The regime is re-read every iteration, so an rAF chain that resumes or
+ * becomes starved mid-hold crosses over without restarting the budget.
  *
- * `hiddenWithoutDriver: true` is the one honest refusal: hidden-paused with
- * no `driveHiddenTicks` hook means nothing in this process can advance the
+ * `starvedWithoutDriver: true` is the one honest refusal: loop-starved with
+ * no `driveStarvedTicks` hook means nothing in this process can advance the
  * clock, so it reports that IMMEDIATELY (see
- * {@link HOLD_HIDDEN_NO_DRIVER_REASON}) instead of burning the stall guard
+ * {@link HOLD_STARVED_NO_DRIVER_REASON}) instead of burning the stall guard
  * and then blaming a stopped game.
  */
-export async function waitForHoldBudget(adapter, simSeconds, driveHiddenTicks) {
+export async function waitForHoldBudget(adapter, simSeconds, driveStarvedTicks) {
     const readTime = () => adapter.state('time');
     const start = readTime();
     let lastTick = start.tick;
     let stalledPolls = 0;
-    let hiddenBatches = 0;
+    let starvedBatches = 0;
     for (;;) {
         const current = readTime();
         if (current.simSeconds - start.simSeconds >= simSeconds)
             return { stalled: false };
-        if (current.loopLiveness === 'hidden-paused') {
-            if (!driveHiddenTicks)
-                return { stalled: true, hiddenWithoutDriver: true };
-            if (hiddenBatches >= HIDDEN_DRIVE_MAX_BATCHES)
+        if (current.loopLiveness === 'loop-starved') {
+            if (!driveStarvedTicks)
+                return { stalled: true, starvedWithoutDriver: true };
+            if (starvedBatches >= STARVED_DRIVE_MAX_BATCHES)
                 return { stalled: true };
-            hiddenBatches += 1;
-            driveHiddenTicks(HIDDEN_DRIVE_BATCH_TICKS);
+            starvedBatches += 1;
+            driveStarvedTicks(STARVED_DRIVE_BATCH_TICKS);
             const after = readTime();
             // A batch that moved neither the tick counter nor the sim clock means
             // the drive is a no-op (paused game, torn-down runtime) — the same
@@ -116,7 +117,7 @@ export async function waitForHoldBudget(adapter, simSeconds, driveHiddenTicks) {
             lastTick = after.tick;
             stalledPolls = 0;
             // Yield so the page can service other work between batches, WITHOUT
-            // handing control to a clock a hidden tab is allowed to starve.
+            // handing control to the same timer lane the browser may be starving.
             await Promise.resolve();
             continue;
         }
@@ -229,13 +230,13 @@ function buildDebugHandle(opts) {
                     : { delivered: false };
             }
             const runTicksTarget = registry.getRunTicksTarget();
-            const { stalled, hiddenWithoutDriver } = await waitForHoldBudget(adapter, simSeconds, runTicksTarget ? (n) => runTicksTarget.runTicks(n, { render: 'last' }) : undefined);
+            const { stalled, starvedWithoutDriver } = await waitForHoldBudget(adapter, simSeconds, runTicksTarget ? (n) => runTicksTarget.runTicks(n, { render: 'last' }) : undefined);
             target.clearVirtualActions();
             if (!stalled)
                 return { delivered: true };
             return {
                 delivered: false,
-                reason: hiddenWithoutDriver ? HOLD_HIDDEN_NO_DRIVER_REASON : 'play stopped during hold',
+                reason: starvedWithoutDriver ? HOLD_STARVED_NO_DRIVER_REASON : 'play stopped during hold',
             };
         },
         uninstall() {

package/dist/runtime/game.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"game.d.ts","sourceRoot":"","sources":["../../src/runtime/game.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"game.d.ts","sourceRoot":"","sources":["../../src/runtime/game.ts"],"names":[],"mappings":"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"}

package/dist/runtime/game.js

@@ -416,8 +416,7 @@ export function createGame(opts) {
         // Other native `console.warn`/`console.error` call sites in this file are
         // unsuppressed and already counted in the lint baseline (see `runFrame`'s
         // impl below); this one is a NEW site, so it's suppressed to keep this
-        // task's diff at zero NEW warnings (same reasoning as `achieved-tier.ts`'s
-        // identical suppression).
+        // task's diff at zero NEW warnings.
         // biome-ignore lint/suspicious/noConsole: see comment above
         console.warn(message);
     }