@bitmagic/cli 0.1.36 → 0.1.38

package/dist/verify/settle.js

@@ -0,0 +1,90 @@
+/**
+ * The decision "has the game settled enough to observe", extracted pure so it is testable
+ * without a browser.
+ *
+ * Verify used to wait a fixed 15 seconds regardless of what the game was doing. The samples the
+ * browser loop feeds this function come from the live engine (`window.gameTemplate`), so a
+ * healthy game that reaches gameplay and holds steady is observed after ~4-5 seconds, while the
+ * fixed `--timeout` stays as the hard cap for games that never stabilise. An engine too old to
+ * answer the probes never settles early — it gets exactly the old fixed-wait behaviour.
+ */
+export const DEFAULT_SETTLE_CONFIG = {
+    minSettleMs: 4_000,
+    minFrames: 90,
+    quietMs: 1_500,
+};
+export const SETTLE_POLL_MS = 500;
+/**
+ * Per-sample drop (world units per poll) below which the player counts as falling. A walking
+ * player descends a slope far slower; a player falling out of the world drops tens of units
+ * between 500ms polls.
+ */
+const FREEFALL_DROP_PER_SAMPLE = 2;
+/** How many consecutive falling samples make a freefall. One can be a jump; three in a row
+ *  (a full second and a half of accelerating descent) is not gameplay. */
+const FREEFALL_SAMPLES = 3;
+/**
+ * The player is in sustained freefall at the end of `samples`.
+ *
+ * Judged over the trailing samples that HAVE a player position; unobservable positions mean
+ * "cannot tell", never "falling". Exported because the final state snapshot reports the same
+ * judgement as `player.isFalling`.
+ */
+export function isFreefalling(samples) {
+    const positioned = samples.filter((sample) => sample.playerY !== null);
+    if (positioned.length < FREEFALL_SAMPLES + 1)
+        return false;
+    const tail = positioned.slice(-(FREEFALL_SAMPLES + 1));
+    for (let i = 1; i < tail.length; i++) {
+        const drop = tail[i - 1].playerY - tail[i].playerY;
+        if (drop < FREEFALL_DROP_PER_SAMPLE)
+            return false;
+    }
+    return true;
+}
+/**
+ * True when the run has seen enough to stop settling early.
+ *
+ * Every condition must hold on the latest sample:
+ * - the minimum settle floor has passed;
+ * - gameplay is actually running — state 'playing' or 'end' (a run-to-completion minigame), or
+ *   `hasStarted` when the state manager is not observable. Both unobservable → never settle
+ *   early; the fixed timeout is the correct behaviour for an engine that cannot be asked;
+ * - the page has rendered enough frames to prove a live render loop;
+ * - the error counters have been flat for the quiet window;
+ * - the player is not falling out of the world.
+ */
+export function settleVerdict(samples, config) {
+    if (samples.length === 0)
+        return 'keep-waiting';
+    const latest = samples[samples.length - 1];
+    if (latest.atMs < config.minSettleMs)
+        return 'keep-waiting';
+    const playing = latest.gameState === null
+        ? latest.hasStarted === true
+        : latest.gameState === 'playing' || latest.gameState === 'end';
+    if (!playing)
+        return 'keep-waiting';
+    if (latest.frameCount === null || latest.frameCount < config.minFrames)
+        return 'keep-waiting';
+    const quietWindowStart = latest.atMs - config.quietMs;
+    const windowSamples = samples.filter((sample) => sample.atMs >= quietWindowStart);
+    // The window must span actual time: right after the floor passes there may be only the latest
+    // sample in it, and "no errors between one sample and itself" proves nothing.
+    const earliest = windowSamples[0];
+    if (earliest === latest && samples.length > 1)
+        return 'keep-waiting';
+    if (windowSamples.some((sample) => sample.errorEventCount !== latest.errorEventCount)) {
+        return 'keep-waiting';
+    }
+    // Cumulative frames are not enough: a loop that rendered its 90 frames on the menu and froze
+    // at game start (measured under software WebGPU) would settle as "stable" on the count alone.
+    // Stable means frames are still being produced NOW — strictly more than at the window's start.
+    if (earliest !== latest && earliest.frameCount !== null && latest.frameCount <= earliest.frameCount) {
+        return 'keep-waiting';
+    }
+    if (isFreefalling(samples))
+        return 'keep-waiting';
+    return 'settled';
+}
+//# sourceMappingURL=settle.js.map

package/dist/verify/settle.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bitmagic/cli",
-  "version": "0.1.36",
+  "version": "0.1.38",
   "description": "Build Bitmagic games from your own agent tool",
   "type": "module",
   "bin": {
@@ -19,8 +19,8 @@
     "citty": "^0.2.2",
     "playwright-core": "^1.59.1",
     "tar": "^7.4.3",
-    "@bitmagic/world-forger": "0.1.3",
-    "@bitmagic/asset-core": "0.1.2"
+    "@bitmagic/asset-core": "0.1.2",
+    "@bitmagic/world-forger": "0.1.4"
   },
   "devDependencies": {
     "@eslint/js": "^9.38.0",

package/dist/forge/bake-progress.d.ts

@@ -1,44 +0,0 @@
-/**
- * Terminal progress for the level bake.
- *
- * The bake is the one step that can legitimately run for many minutes, and its transport wait is
- * an IDLE timeout of 20 minutes (`VOXELIZE_TIMEOUT_MS`) — per-chunk progress re-arms the timer but
- * is otherwise consumed silently inside the transport. Without a printed line a creator watching a
- * still terminal concludes the command has hung and kills it mid-bake, losing the whole step. So
- * the command subscribes to the page's own `VOXELIZE_GLB_AS_LEVEL_PROGRESS` messages
- * (`game/src/engine/template/VoxelMessageHandlers.ts`) and prints them.
- *
- * Throttled, because the engine emits one message per chunk and a large level has thousands: an
- * unthrottled relay would bury every other line of output. The formatter and the throttle are pure
- * and separate from the subscription so both are testable without a browser.
- */
-/** The engine's per-chunk progress payload. `chunkIndex: -1` marks the post-bake upload phase. */
-export interface BakeProgress {
-    chunkIndex: number;
-    totalChunks: number;
-    nonEmptyChunks?: number;
-    label?: string;
-}
-export declare const BAKE_PROGRESS_TYPE = "VOXELIZE_GLB_AS_LEVEL_PROGRESS";
-/** Minimum gap between printed bake lines. Long enough not to flood, short enough that the
- *  terminal never looks frozen. */
-export declare const BAKE_PROGRESS_MIN_INTERVAL_MS = 3000;
-/** Read a bake-progress payload off a page message, or null if it is not one. */
-export declare function asBakeProgress(message: unknown): BakeProgress | null;
-/**
- * The line to print for one progress message.
- *
- * `chunkIndex: -1` / `totalChunks: -1` is the engine's sentinel for the upload phase that follows
- * the chunk loop; it carries a label instead of a count, so it is rendered as that label rather
- * than as a nonsensical "chunk -1 of -1".
- */
-export declare function formatBakeProgress(progress: BakeProgress): string;
-/**
- * A printer that emits at most one line per `minIntervalMs` — except for the final chunk and the
- * label-only phases, which always print. The last chunk is what tells a creator the loop finished
- * rather than stalled, so dropping it to a throttle would remove the single most informative line.
- */
-export declare function createBakeProgressPrinter(log: (message: string) => void, options?: {
-    minIntervalMs?: number;
-    now?: () => number;
-}): (message: unknown) => void;

package/dist/forge/bake-progress.js

@@ -1,77 +0,0 @@
-/**
- * Terminal progress for the level bake.
- *
- * The bake is the one step that can legitimately run for many minutes, and its transport wait is
- * an IDLE timeout of 20 minutes (`VOXELIZE_TIMEOUT_MS`) — per-chunk progress re-arms the timer but
- * is otherwise consumed silently inside the transport. Without a printed line a creator watching a
- * still terminal concludes the command has hung and kills it mid-bake, losing the whole step. So
- * the command subscribes to the page's own `VOXELIZE_GLB_AS_LEVEL_PROGRESS` messages
- * (`game/src/engine/template/VoxelMessageHandlers.ts`) and prints them.
- *
- * Throttled, because the engine emits one message per chunk and a large level has thousands: an
- * unthrottled relay would bury every other line of output. The formatter and the throttle are pure
- * and separate from the subscription so both are testable without a browser.
- */
-export const BAKE_PROGRESS_TYPE = 'VOXELIZE_GLB_AS_LEVEL_PROGRESS';
-/** Minimum gap between printed bake lines. Long enough not to flood, short enough that the
- *  terminal never looks frozen. */
-export const BAKE_PROGRESS_MIN_INTERVAL_MS = 3000;
-function isRecord(value) {
-    return typeof value === 'object' && value !== null;
-}
-/** Read a bake-progress payload off a page message, or null if it is not one. */
-export function asBakeProgress(message) {
-    if (!isRecord(message) || message.type !== BAKE_PROGRESS_TYPE)
-        return null;
-    const { chunkIndex, totalChunks } = message;
-    if (typeof chunkIndex !== 'number' || typeof totalChunks !== 'number')
-        return null;
-    return {
-        chunkIndex,
-        totalChunks,
-        ...(typeof message.nonEmptyChunks === 'number' ? { nonEmptyChunks: message.nonEmptyChunks } : {}),
-        ...(typeof message.label === 'string' ? { label: message.label } : {}),
-    };
-}
-/**
- * The line to print for one progress message.
- *
- * `chunkIndex: -1` / `totalChunks: -1` is the engine's sentinel for the upload phase that follows
- * the chunk loop; it carries a label instead of a count, so it is rendered as that label rather
- * than as a nonsensical "chunk -1 of -1".
- */
-export function formatBakeProgress(progress) {
-    if (progress.totalChunks <= 0) {
-        return `  bake: ${progress.label ?? 'working…'}`;
-    }
-    const percent = Math.floor(((progress.chunkIndex + 1) / progress.totalChunks) * 100);
-    const filled = progress.nonEmptyChunks !== undefined ? `, ${progress.nonEmptyChunks} non-empty` : '';
-    const label = progress.label ? ` — ${progress.label}` : '';
-    return `  bake: chunk ${progress.chunkIndex + 1}/${progress.totalChunks} (${percent}%${filled})${label}`;
-}
-/**
- * A printer that emits at most one line per `minIntervalMs` — except for the final chunk and the
- * label-only phases, which always print. The last chunk is what tells a creator the loop finished
- * rather than stalled, so dropping it to a throttle would remove the single most informative line.
- */
-export function createBakeProgressPrinter(log, options = {}) {
-    const minIntervalMs = options.minIntervalMs ?? BAKE_PROGRESS_MIN_INTERVAL_MS;
-    const now = options.now ?? (() => Date.now());
-    // -Infinity, not 0: the FIRST message must always print. A zero start throttles it whenever
-    // `now()` begins near zero — which a monotonic clock does, and which is exactly the moment the
-    // creator most needs to see that the bake has begun.
-    let lastAt = -Infinity;
-    return (message) => {
-        const progress = asBakeProgress(message);
-        if (progress === null)
-            return;
-        const isFinalChunk = progress.totalChunks > 0 && progress.chunkIndex + 1 >= progress.totalChunks;
-        const isPhaseLabel = progress.totalChunks <= 0;
-        const at = now();
-        if (!isFinalChunk && !isPhaseLabel && at - lastAt < minIntervalMs)
-            return;
-        lastAt = at;
-        log(formatBakeProgress(progress));
-    };
-}
-//# sourceMappingURL=bake-progress.js.map

package/dist/forge/bake-progress.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"bake-progress.js","sourceRoot":"","sources":["../../src/forge/bake-progress.ts"],"names":[],"mappings":"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"}