@bitmagic/cli 0.1.64-dev.1 → 0.1.64-dev.10

package/dist/tools/bundles.js

@@ -0,0 +1,67 @@
+/**
+ * Tool bundles the CLI ships for skills that drive external programs (Blender, Python): the
+ * scripts live in the package's `assets/` rather than being rendered into every project, and a
+ * skill's first step copies the bundle it needs into the project's `tools/`.
+ *
+ * `bitmagic tools install <bundle>` is that copy. It exists because the shell one-liner the skills
+ * used before — `readlink -f "$(which bitmagic)"` to find the package — resolves to a shell shim
+ * under pnpm and to a symlink chain under npm and Homebrew, and the first creator to try the
+ * Blender skill spent two tool calls hunting through the pnpm store for `assets/`. The CLI knows
+ * where it is; nobody else has to.
+ *
+ * Pure planning here (which files land where), so it is testable against a temp directory; the
+ * command does the copying.
+ */
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+export const TOOL_BUNDLES = [
+    {
+        name: 'blender-level',
+        target: 'tools/blender-level',
+        extensions: null,
+        skill: 'building-levels-in-blender',
+    },
+    {
+        name: 'unity-import',
+        target: 'tools',
+        extensions: ['.py', '.json'],
+        skill: 'converting-unity-levels',
+    },
+];
+/** `assets/` of this package, from both `dist/tools/` and `src/tools/`. */
+export function packageAssetsDir() {
+    return path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..', '..', 'assets');
+}
+export function findBundle(name) {
+    const bundle = TOOL_BUNDLES.find((b) => b.name === name);
+    if (!bundle) {
+        throw new Error(`no tool bundle named "${name}" — the CLI ships ${TOOL_BUNDLES.map((b) => `"${b.name}"`).join(', ')}.`);
+    }
+    return bundle;
+}
+/** Every file the install would write, relative paths resolved against `assetsDir` and `projectRoot`. */
+export async function planBundleCopy(bundle, assetsDir, projectRoot) {
+    const source = path.join(assetsDir, bundle.name);
+    const entries = await fs.readdir(source, { withFileTypes: true, recursive: true });
+    const copies = [];
+    for (const entry of entries) {
+        if (!entry.isFile())
+            continue;
+        const parent = entry.parentPath;
+        const rel = path.relative(source, path.join(parent, entry.name));
+        if (rel.split(path.sep).includes('__pycache__'))
+            continue;
+        if (bundle.extensions && !bundle.extensions.includes(path.extname(entry.name)))
+            continue;
+        copies.push({ from: path.join(source, rel), to: path.join(projectRoot, bundle.target, rel) });
+    }
+    return copies.sort((a, b) => (a.to < b.to ? -1 : a.to > b.to ? 1 : 0));
+}
+export async function copyBundle(copies) {
+    for (const { from, to } of copies) {
+        await fs.mkdir(path.dirname(to), { recursive: true });
+        await fs.copyFile(from, to);
+    }
+}
+//# sourceMappingURL=bundles.js.map

package/dist/tools/bundles.js.map

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

package/dist/trailer/ffmpeg.d.ts

@@ -5,4 +5,14 @@ export declare function missingFfmpegMessage(tool?: FfmpegTool): string;
  * with `-version` is the cheapest probe that also proves the binary actually runs.
  */
 export declare function ensureFfmpeg(tools?: readonly FfmpegTool[]): void;
+/**
+ * The first of `tools` that is not on PATH, or null when they all are — the non-throwing half of
+ * {@link ensureFfmpeg}, for callers that skip a step rather than fail when ffmpeg is absent.
+ */
+export declare function missingFfmpegTool(tools?: readonly FfmpegTool[]): FfmpegTool | null;
 export declare function runFfmpeg(args: string[]): Promise<void>;
+/**
+ * Run a tool and keep stdout. {@link runFfmpeg} discards it — everything in the trailer pipeline
+ * writes files — so the PCM decode and every ffprobe query come through here instead.
+ */
+export declare function captureFfmpegTool(tool: FfmpegTool, args: string[]): Promise<Buffer>;

package/dist/trailer/ffmpeg.js

@@ -1,9 +1,13 @@
 /**
  * Thin ffmpeg process wrapper. Always argument arrays, never shell strings.
  *
- * ffmpeg is the one external tool the trailer lane needs and the one a creator's machine is least
- * likely to have, so its absence is reported as a sentence with the install command rather than as
- * an ENOENT stack trace from deep inside a filtergraph.
+ * ffmpeg is the one external tool this CLI needs and the one a creator's machine is least likely to
+ * have, so its absence is reported as a sentence with the install command rather than as an ENOENT
+ * stack trace from deep inside a filtergraph.
+ *
+ * Two callers with opposite stakes, hence both `ensureFfmpeg` and `missingFfmpegTool`: the trailer
+ * lane cannot do its job at all without ffmpeg and refuses up front, while `generate video`'s clip
+ * review is a nicety on top of an already-paid generation and must degrade to a note.
  */
 import { spawn, spawnSync } from 'child_process';
 import { CliError, errnoCode } from '../errors.js';
@@ -19,12 +23,21 @@ export function missingFfmpegMessage(tool = 'ffmpeg') {
  * with `-version` is the cheapest probe that also proves the binary actually runs.
  */
 export function ensureFfmpeg(tools = ['ffmpeg']) {
+    const missing = missingFfmpegTool(tools);
+    if (missing !== null)
+        throw new CliError(missingFfmpegMessage(missing), 1, 'ffmpeg_missing');
+}
+/**
+ * The first of `tools` that is not on PATH, or null when they all are — the non-throwing half of
+ * {@link ensureFfmpeg}, for callers that skip a step rather than fail when ffmpeg is absent.
+ */
+export function missingFfmpegTool(tools = ['ffmpeg']) {
     for (const tool of tools) {
         const probe = spawnSync(tool, ['-version'], { stdio: 'ignore' });
-        if (probe.error !== undefined && errnoCode(probe.error) === 'ENOENT') {
-            throw new CliError(missingFfmpegMessage(tool), 1, 'ffmpeg_missing');
-        }
+        if (probe.error !== undefined && errnoCode(probe.error) === 'ENOENT')
+            return tool;
     }
+    return null;
 }
 export async function runFfmpeg(args) {
     return new Promise((resolve, reject) => {
@@ -52,4 +65,36 @@ export async function runFfmpeg(args) {
         });
     });
 }
+/**
+ * Run a tool and keep stdout. {@link runFfmpeg} discards it — everything in the trailer pipeline
+ * writes files — so the PCM decode and every ffprobe query come through here instead.
+ */
+export async function captureFfmpegTool(tool, args) {
+    return new Promise((resolve, reject) => {
+        const child = spawn(tool, args, { stdio: ['ignore', 'pipe', 'pipe'] });
+        const chunks = [];
+        let stderr = '';
+        child.stdout.on('data', (chunk) => chunks.push(chunk));
+        child.stderr.on('data', (chunk) => {
+            stderr += chunk.toString('utf-8');
+            if (stderr.length > STDERR_KEEP_BYTES)
+                stderr = stderr.slice(-STDERR_KEEP_BYTES / 2);
+        });
+        child.on('error', (err) => {
+            if (errnoCode(err) === 'ENOENT')
+                reject(new CliError(missingFfmpegMessage(tool), 1, 'ffmpeg_missing'));
+            else
+                reject(new Error(`failed to start ${tool}: ${err.message}`));
+        });
+        child.on('close', (code) => {
+            if (code === 0) {
+                resolve(Buffer.concat(chunks));
+            }
+            else {
+                const tail = stderr.trim().split('\n').slice(-STDERR_REPORT_LINES).join('\n');
+                reject(new Error(`${tool} exited with code ${code}:\n${tail}`));
+            }
+        });
+    });
+}
 //# sourceMappingURL=ffmpeg.js.map

package/dist/trailer/ffmpeg.js.map

@@ -1 +1 @@
-{"version":3,"file":"ffmpeg.js","sourceRoot":"","sources":["../../src/trailer/ffmpeg.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEnD,MAAM,iBAAiB,GAAG,KAAK,CAAC;AAChC,MAAM,mBAAmB,GAAG,EAAE,CAAC;AAI/B,MAAM,UAAU,oBAAoB,CAAC,OAAmB,QAAQ;IAC9D,OAAO,CACL,GAAG,IAAI,4FAA4F;QACnG,oFAAoF;QACpF,iEAAiE,CAClE,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,QAA+B,CAAC,QAAQ,CAAC;IACpE,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;QACjE,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS,IAAI,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,QAAQ,EAAE,CAAC;YACrE,MAAM,IAAI,QAAQ,CAAC,oBAAoB,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,gBAAgB,CAAC,CAAC;QACtE,CAAC;IACH,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,IAAc;IAC5C,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,KAAK,GAAG,KAAK,CAAC,QAAQ,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;QAC7E,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE;YACxC,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;YAClC,IAAI,MAAM,CAAC,MAAM,GAAG,iBAAiB;gBAAE,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,iBAAiB,GAAG,CAAC,CAAC,CAAC;QACvF,CAAC,CAAC,CAAC;QACH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;YACxB,IAAI,SAAS,CAAC,GAAG,CAAC,KAAK,QAAQ;gBAAE,MAAM,CAAC,IAAI,QAAQ,CAAC,oBAAoB,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,gBAAgB,CAAC,CAAC,CAAC;;gBACtG,MAAM,CAAC,IAAI,KAAK,CAAC,2BAA2B,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;QACnE,CAAC,CAAC,CAAC;QACH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;YACzB,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;gBACf,OAAO,EAAE,CAAC;YACZ,CAAC;iBAAM,CAAC;gBACN,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,mBAAmB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBAC9E,MAAM,CAAC,IAAI,QAAQ,CAAC,2BAA2B,IAAI,MAAM,IAAI,EAAE,CAAC,CAAC,CAAC;YACpE,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"ffmpeg.js","sourceRoot":"","sources":["../../src/trailer/ffmpeg.ts"],"names":[],"mappings":"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"}

package/dist/trailer/hud-raster.d.ts

@@ -7,22 +7,22 @@ export interface RasterizeOptions {
     harnessUrl: string;
     /** Overlay PNGs are written here as ui_NNNN.png, one per keyframe. */
     outDir: string;
-    /** Recording resolution — both the browser viewport and the HUD root size. */
+    /**
+     * CSS-pixel viewport the HUD lays out against — the recorded window's
+     * aspect-corrected size when the manifest carries one, else the recording
+     * resolution (see computeRasterGeometry in hud-state.ts).
+     */
     width: number;
     height: number;
+    /** PNG pixels per CSS pixel; >1 keeps overlays at/above the recording size. */
+    deviceScaleFactor: number;
 }
 export declare function uiPngPath(outDir: string, index: number): string;
 /**
  * Render one transparent PNG per keyframe, reusing a single browser + page.
- * Returns paths in keyframe order, or null when UI overlays must be skipped
- * (no Chrome, harness unreachable, or the harness rejected a state).
+ * Returns paths in keyframe order — a slot is null when that one keyframe
+ * failed (the caller holds the previous overlay across its window) — or null
+ * overall when UI must be skipped entirely (no Chrome, harness unreachable, the
+ * page died mid-run, or every keyframe failed).
  */
-export declare function rasterizeUiKeyframes(keyframes: readonly UiKeyframe[], options: RasterizeOptions): Promise<string[] | null>;
-/**
- * Width/height straight out of a PNG's IHDR chunk, so the filtergraph only
- * pays for a scale filter when the overlay really is the wrong size.
- */
-export declare function readPngSize(filePath: string): {
-    width: number;
-    height: number;
-} | null;
+export declare function rasterizeUiKeyframes(keyframes: readonly UiKeyframe[], options: RasterizeOptions): Promise<Array<string | null> | null>;

package/dist/trailer/hud-raster.js

@@ -4,12 +4,20 @@
  * The harness page (`/hud-replay.html` on the running `bitmagic dev` sidecar) owns a real GameHUD,
  * so the overlay is the game's own UI rather than a reimplementation. Contract:
  *   window.__hudReplayReady === true      when the page can accept states
- *   window.__hudReplay.render(state)      synchronous; applies a replay state
+ *   window.__hudReplay.render(state, ms)  synchronous; applies a replay state,
+ *                                         `ms` seeding animation phase on the
+ *                                         source clock (older harness: ignored)
  *   window.__hudReplay.setViewport(w, h)  sizes the HUD root
+ *   window.__hudReplay.settle()           optional; resolves when fonts/images
+ *                                         the state started loading are in (or
+ *                                         a short deadline passed)
  * plus a transparent page background, so `omitBackground` yields real alpha.
  *
- * Every failure path here degrades to "no overlays" (returns null) instead of failing the trailer:
- * a UI-less video still beats no video. Chrome is the creator's installed browser
+ * Failure here degrades instead of failing the trailer: a keyframe that will
+ * not rasterize becomes a null slot (the caller holds the previous overlay over
+ * its window), and only an unusable page — navigation failed, the page died, or
+ * every single keyframe threw — degrades to "no overlays" (null). A UI-less
+ * video still beats no video. Chrome is the creator's installed browser
  * (`channel: 'chrome'`), the same one `bitmagic verify` drives — nothing is downloaded.
  */
 import * as fs from 'fs';
@@ -18,20 +26,29 @@ import { chromium } from 'playwright-core';
 import { out, warn } from './io.js';
 const NAV_TIMEOUT_MS = 20000;
 const READY_TIMEOUT_MS = 20000;
+/** Consecutive keyframe failures after which the run gives up on UI entirely. */
+const MAX_CONSECUTIVE_FAILURES = 3;
 export const CHROME_MISSING_HINT = 'Google Chrome could not be launched — install it from https://www.google.com/chrome/';
 /**
  * The state is embedded in the expression rather than passed as an argument:
  * Playwright treats a string pageFunction as a plain expression and drops the
  * arg, so an IIFE is the reliable form.
  */
-function applyStateExpression(state, width, height) {
+function applyStateExpression(state, width, height, frameTimeMs, clipIndex) {
     return ('(() => {' +
         ' const replay = window.__hudReplay;' +
         ' if (!replay || typeof replay.render !== "function") throw new Error("window.__hudReplay.render is missing");' +
         ' if (typeof replay.setViewport === "function") replay.setViewport(' +
         `${JSON.stringify(width)}, ${JSON.stringify(height)});` +
-        ` replay.render(${JSON.stringify(state)});` +
-        ' return true;' +
+        // The second and third arguments seed animation phase (source time, and
+        // the clip so the harness can tell a new clip's first keyframe from a
+        // mid-clip one); an older harness ignores them.
+        ` replay.render(${JSON.stringify(state)}, ${JSON.stringify(frameTimeMs)}, ${JSON.stringify(clipIndex)});` +
+        // settle() is awaited here rather than in a second round trip: Playwright
+        // awaits a thenable returned from a string expression, so this is one
+        // protocol call per keyframe instead of two, with identical ordering. An
+        // older harness has no settle() and simply returns true.
+        ' return typeof replay.settle === "function" ? replay.settle() : true;' +
         '})()');
 }
 /** Headless system Chrome for offscreen rasterization; null (with a warning) when it cannot start. */
@@ -47,36 +64,90 @@ export async function launchRasterBrowser(purpose) {
 export function uiPngPath(outDir, index) {
     return path.join(outDir, `ui_${String(index).padStart(4, '0')}.png`);
 }
+/**
+ * Cheap liveness probe. A crashed target or closed browser rejects every
+ * protocol call immediately, so this distinguishes "that one state was bad"
+ * from "there is no page any more".
+ */
+async function pageIsAlive(page) {
+    try {
+        await page.evaluate('1');
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
 /**
  * Render one transparent PNG per keyframe, reusing a single browser + page.
- * Returns paths in keyframe order, or null when UI overlays must be skipped
- * (no Chrome, harness unreachable, or the harness rejected a state).
+ * Returns paths in keyframe order — a slot is null when that one keyframe
+ * failed (the caller holds the previous overlay across its window) — or null
+ * overall when UI must be skipped entirely (no Chrome, harness unreachable, the
+ * page died mid-run, or every keyframe failed).
  */
 export async function rasterizeUiKeyframes(keyframes, options) {
     if (keyframes.length === 0)
         return [];
+    // Before the browser exists: a throwing mkdir must not leak a Chrome.
+    fs.mkdirSync(options.outDir, { recursive: true });
     const browser = await launchRasterBrowser('ui');
     if (browser === null) {
         warn('ui: rendering without HUD overlays');
         return null;
     }
-    fs.mkdirSync(options.outDir, { recursive: true });
     try {
         const context = await browser.newContext({
             viewport: { width: options.width, height: options.height },
-            deviceScaleFactor: 1
+            deviceScaleFactor: options.deviceScaleFactor
         });
         const page = await context.newPage();
         await page.goto(options.harnessUrl, { waitUntil: 'domcontentloaded', timeout: NAV_TIMEOUT_MS });
         await page.waitForFunction('window.__hudReplayReady === true', undefined, { timeout: READY_TIMEOUT_MS });
         const paths = [];
+        let failed = 0;
+        let consecutiveFailures = 0;
         for (let i = 0; i < keyframes.length; i++) {
             const pngPath = uiPngPath(options.outDir, i);
-            await page.evaluate(applyStateExpression(keyframes[i].state, options.width, options.height));
-            await page.screenshot({ path: pngPath, omitBackground: true, type: 'png' });
-            paths.push(pngPath);
+            try {
+                await page.evaluate(applyStateExpression(keyframes[i].state, options.width, options.height, Math.round(keyframes[i].frameTimeMs), keyframes[i].clipIndex));
+                await page.screenshot({ path: pngPath, omitBackground: true, type: 'png' });
+                paths.push(pngPath);
+                consecutiveFailures = 0;
+            }
+            catch (err) {
+                // One bad state must not throw away the overlays already on disk.
+                failed++;
+                consecutiveFailures++;
+                warn(`ui: keyframe ${i} failed to rasterize ` +
+                    `(${err instanceof Error ? err.message : String(err)}) — holding the previous overlay`);
+                paths.push(null);
+                // A dead page fails every REMAINING keyframe too, and each null slot
+                // extends the last good overlay — which would freeze one stale HUD
+                // over the whole rest of the trailer. That is worse than no UI, so
+                // probe liveness and bail out whole rather than degrade per keyframe.
+                if (!(await pageIsAlive(page))) {
+                    warn(`ui: the replay page died after ${paths.length - failed} overlay(s) — rendering without UI ` +
+                        'rather than freezing the last one over the remaining clips');
+                    return null;
+                }
+                // A page that answers evaluate('1') but fails every screenshot (a
+                // stalled compositor, an unwritable .ui) would otherwise pay the full
+                // screenshot timeout once per remaining keyframe and then freeze the
+                // last good overlay across them — hours of waiting for a worse video.
+                if (consecutiveFailures >= MAX_CONSECUTIVE_FAILURES) {
+                    warn(`ui: ${consecutiveFailures} keyframes in a row failed to rasterize — rendering without UI ` +
+                        'rather than holding one overlay over everything that follows');
+                    return null;
+                }
+            }
+        }
+        if (failed === keyframes.length) {
+            warn(`ui: every keyframe failed to rasterize against ${options.harnessUrl} — rendering without UI`);
+            return null;
         }
-        out(`ui: rasterized ${paths.length} overlay(s) at ${options.width}x${options.height} from ${options.harnessUrl}`);
+        out(`ui: rasterized ${paths.length - failed} overlay(s) at ${options.width}x${options.height}` +
+            `${options.deviceScaleFactor !== 1 ? `@${options.deviceScaleFactor.toFixed(2)}x` : ''} ` +
+            `from ${options.harnessUrl}${failed > 0 ? ` (${failed} failed, held over)` : ''}`);
         return paths;
     }
     catch (err) {
@@ -93,22 +164,4 @@ export async function rasterizeUiKeyframes(keyframes, options) {
         }
     }
 }
-/**
- * Width/height straight out of a PNG's IHDR chunk, so the filtergraph only
- * pays for a scale filter when the overlay really is the wrong size.
- */
-export function readPngSize(filePath) {
-    const header = Buffer.alloc(24);
-    const fd = fs.openSync(filePath, 'r');
-    try {
-        if (fs.readSync(fd, header, 0, 24, 0) < 24)
-            return null;
-    }
-    finally {
-        fs.closeSync(fd);
-    }
-    if (header.readUInt32BE(0) !== 0x89504e47 || header.toString('ascii', 12, 16) !== 'IHDR')
-        return null;
-    return { width: header.readUInt32BE(16), height: header.readUInt32BE(20) };
-}
 //# sourceMappingURL=hud-raster.js.map

package/dist/trailer/hud-raster.js.map

@@ -1 +1 @@
-{"version":3,"file":"hud-raster.js","sourceRoot":"","sources":["../../src/trailer/hud-raster.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,EAAE,QAAQ,EAAgB,MAAM,iBAAiB,CAAC;AAEzD,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAEpC,MAAM,cAAc,GAAG,KAAK,CAAC;AAC7B,MAAM,gBAAgB,GAAG,KAAK,CAAC;AAE/B,MAAM,CAAC,MAAM,mBAAmB,GAC9B,sFAAsF,CAAC;AAEzF;;;;GAIG;AACH,SAAS,oBAAoB,CAAC,KAAc,EAAE,KAAa,EAAE,MAAc;IACzE,OAAO,CACL,UAAU;QACV,qCAAqC;QACrC,+GAA+G;QAC/G,oEAAoE;QACpE,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI;QACvD,kBAAkB,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI;QAC3C,eAAe;QACf,MAAM,CACP,CAAC;AACJ,CAAC;AAED,sGAAsG;AACtG,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,OAAe;IACvD,IAAI,CAAC;QACH,OAAO,MAAM,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC;IAC9F,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,GAAG,OAAO,KAAK,mBAAmB,KAAK,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAChH,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAWD,MAAM,UAAU,SAAS,CAAC,MAAc,EAAE,KAAa;IACrD,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,MAAM,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;AACvE,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,SAAgC,EAChC,OAAyB;IAEzB,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACtC,MAAM,OAAO,GAAG,MAAM,mBAAmB,CAAC,IAAI,CAAC,CAAC;IAChD,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;QACrB,IAAI,CAAC,oCAAoC,CAAC,CAAC;QAC3C,OAAO,IAAI,CAAC;IACd,CAAC;IAED,EAAE,CAAC,SAAS,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAElD,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC;YACvC,QAAQ,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE;YAC1D,iBAAiB,EAAE,CAAC;SACrB,CAAC,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC;QACrC,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,kBAAkB,EAAE,OAAO,EAAE,cAAc,EAAE,CAAC,CAAC;QAChG,MAAM,IAAI,CAAC,eAAe,CAAC,kCAAkC,EAAE,SAAS,EAAE,EAAE,OAAO,EAAE,gBAAgB,EAAE,CAAC,CAAC;QAEzG,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,SAAS,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAC1C,MAAM,OAAO,GAAG,SAAS,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;YAC7C,MAAM,IAAI,CAAC,QAAQ,CAAC,oBAAoB,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;YAC7F,MAAM,IAAI,CAAC,UAAU,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,cAAc,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;YAC5E,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACtB,CAAC;QACD,GAAG,CAAC,kBAAkB,KAAK,CAAC,MAAM,kBAAkB,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,MAAM,SAAS,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;QAClH,OAAO,KAAK,CAAC;IACf,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,CACF,4CAA4C,OAAO,CAAC,UAAU,GAAG;YAC/D,IAAI,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,0BAA0B,CACjF,CAAC;QACF,OAAO,IAAI,CAAC;IACd,CAAC;YAAS,CAAC;QACT,IAAI,CAAC;YACH,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;QACxB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,CAAC,6BAA6B,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACxF,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,QAAgB;IAC1C,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAChC,MAAM,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;IACtC,IAAI,CAAC;QACH,IAAI,EAAE,CAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE;YAAE,OAAO,IAAI,CAAC;IAC1D,CAAC;YAAS,CAAC;QACT,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;IACnB,CAAC;IACD,IAAI,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,KAAK,UAAU,IAAI,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,EAAE,EAAE,EAAE,CAAC,KAAK,MAAM;QAAE,OAAO,IAAI,CAAC;IACtG,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,YAAY,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,YAAY,CAAC,EAAE,CAAC,EAAE,CAAC;AAC7E,CAAC"}
+{"version":3,"file":"hud-raster.js","sourceRoot":"","sources":["../../src/trailer/hud-raster.ts"],"names":[],"mappings":"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"}

package/dist/trailer/hud-state.d.ts

@@ -24,6 +24,8 @@ export interface HudHealthState {
     current: number;
     max: number;
     visible: boolean;
+    /** Pixel width from showHealth({width}); absent = the engine default. */
+    width?: number;
 }
 /**
  * One HUD element. Keys beyond id/type/anchor/visible are per-kind and are
@@ -52,6 +54,8 @@ export interface HudElementState {
 export interface HudToastState {
     message: string;
     variant?: string;
+    /** IGameHUD anchor; absent on recordings that predate anchor capture. */
+    anchor?: string;
 }
 export interface HudReplayState {
     version: 1;
@@ -63,7 +67,48 @@ export interface HudReplayState {
     /** Creation order (= stacking order within an anchor); removed ones dropped. */
     elements: HudElementState[];
     toasts: HudToastState[];
+    /**
+     * Game-authored head stylesheets, first-logged order, last write per id.
+     * The harness injects these before drawing — they are what turn
+     * custom-element class names into pixels.
+     *
+     * Shared between snapshots while unchanged, so treat it as frozen: never
+     * mutate the array or its entries in place.
+     */
+    stylesheets: ReadonlyArray<HudStylesheetState>;
+}
+export interface HudStylesheetState {
+    id: string;
+    css: string;
+}
+export interface RasterGeometry {
+    /** CSS-pixel viewport for the harness browser context. */
+    viewportWidth: number;
+    viewportHeight: number;
+    deviceScaleFactor: number;
 }
+/**
+ * Where to lay the HUD out for rasterization.
+ *
+ * During capture only the CANVAS is resized to the recording resolution — the
+ * DOM HUD keeps laying out against the player's window. Rastering at the
+ * recording size therefore renders every fixed-pixel HUD metric too small
+ * relative to the footage (and flips vw-clamps and media queries). With the
+ * recorded window known, raster at an ASPECT-CORRECTED viewport: the window's
+ * height (so element size relative to screen height matches what the player
+ * saw) at the recording's aspect (raw window dimensions would stretch glyphs
+ * non-uniformly under the final scale whenever the aspects differ). The
+ * deviceScaleFactor keeps the PNG at or above the recording resolution so
+ * ffmpeg only ever downscales.
+ *
+ * No recorded window → the recording resolution at 1x, bit-for-bit the old
+ * behavior.
+ */
+export declare function computeRasterGeometry(recordingWidth: number, recordingHeight: number, window?: {
+    innerWidth: number;
+    innerHeight: number;
+    devicePixelRatio: number;
+}): RasterGeometry;
 /** The engine records `frame` on a 60fps source clock. */
 export declare const DEFAULT_HUD_FPS = 60;
 /** IGameHUD.showToast's default duration. */
@@ -78,6 +123,12 @@ export declare function isBlankHudState(state: HudReplayState): boolean;
 export interface UiKeyframe {
     /** Source frame whose state this is. */
     sourceFrame: number;
+    /**
+     * `sourceFrame` as milliseconds on the SOURCE clock. The harness seeds
+     * animation phase from it, so motion stays locked to the footage through a
+     * speed ramp — output time would run it fast or slow against the frames.
+     */
+    frameTimeMs: number;
     clipIndex: number;
     /** Output-timeline seconds this overlay becomes visible. */
     outputStartSec: number;
@@ -88,17 +139,37 @@ export interface UiKeyframe {
 export interface CollectUiKeyframesOptions {
     /** Source-clock fps. Default 60. */
     fps?: number;
-    /** Ceiling on keyframes per second of OUTPUT time. Default 10. */
+    /** Ceiling on keyframes per second of OUTPUT time. Default 30. 0 disables. */
     maxPerSecond?: number;
-    /** Hard ceiling per clip. Default 240. */
+    /** Hard ceiling per clip. Defaults to what the clip's duration allows at `maxPerSecond`. */
     maxPerClip?: number;
     /** Per-clip opt-out; defaults to every clip. */
     clipEnabled?: (clipIndex: number) => boolean;
     /** Where truncation notices go. Defaults to stderr. */
     log?: (line: string) => void;
 }
-export declare const DEFAULT_MAX_KEYFRAMES_PER_SECOND = 10;
-export declare const DEFAULT_MAX_KEYFRAMES_PER_CLIP = 240;
+/**
+ * 30, not 15: measured on a real cut, the selected footage held 227 distinct
+ * HUD states across 15.3 s of output (14.8/s average, four of seven clips over
+ * 15/s), so a 15/s ceiling was discarding roughly 45% of the HUD motion the
+ * game actually rendered.
+ *
+ * ffmpeg used to be the reason for a low ceiling — one PNG input plus one
+ * serial overlay node per keyframe cost ~23 MB of RSS each and corrupted the
+ * render above ~400. The overlays now ride one densified image2 sequence whose
+ * cost is flat in keyframe count (measured 2.83 s / 0.94 GB at both 126 and
+ * 902 distinct rasters), so the remaining cost is ~25 ms of Playwright per
+ * keyframe plus its PNG on disk. 0 disables the limit entirely.
+ */
+export declare const DEFAULT_MAX_KEYFRAMES_PER_SECOND = 30;
+/**
+ * Sole per-clip ceiling, a backstop for `--ui-keyframe-rate 0`: at any real
+ * rate the limiter below admits at most rate·duration+1 keyframes per clip on
+ * its own, so nothing else can bind. A fixed 240 used to freeze the overlay
+ * after 16 s of any clip busy enough to sustain the default rate — exactly the
+ * clip a trailer is cut from. 60 s of output at 60/s.
+ */
+export declare const MAX_KEYFRAMES_PER_CLIP_CEILING = 3600;
 /**
  * Walk every enabled clip's source range and emit a keyframe wherever the
  * reduced HUD state changes.