@bitmagic/cli 0.1.60 → 0.1.61-dev.1

package/dist/trailer/hud-state.js

@@ -0,0 +1,410 @@
+import { exclusiveOutputEnd, sourceFrameToOutputSec } from './edl-time.js';
+import { warn } from './io.js';
+/**
+ * Engine-owned chrome that lives in the HUD element registry but must never
+ * reach a trailer: interactive controls the viewer can't click in a video.
+ * `mute-button` is `MuteControl`'s custom element (engine/ui/MuteControl.ts).
+ */
+export const CHROME_ELEMENT_IDS = new Set(['mute-button']);
+// ---------------------------------------------------------------------------
+// Defaults
+// ---------------------------------------------------------------------------
+/** The engine records `frame` on a 60fps source clock. */
+export const DEFAULT_HUD_FPS = 60;
+/** IGameHUD.showToast's default duration. */
+export const DEFAULT_TOAST_MS = 2500;
+/** IGameHUD's per-kind default anchor, used when a create op omits one. */
+const DEFAULT_ANCHOR = {
+    progress: 'top-left',
+    counter: 'top-right',
+    'icon-text': 'bottom-left',
+    timer: 'top-center',
+    custom: 'top-left'
+};
+/** Derived timer seconds are rounded to this many decimals for a stable key. */
+const SECONDS_DECIMALS = 3;
+// ---------------------------------------------------------------------------
+// Reduction
+// ---------------------------------------------------------------------------
+function readString(params, key) {
+    const value = params[key];
+    return typeof value === 'string' ? value : undefined;
+}
+function readNumber(params, key) {
+    const value = params[key];
+    return typeof value === 'number' && Number.isFinite(value) ? value : undefined;
+}
+function readBoolean(params, key) {
+    const value = params[key];
+    return typeof value === 'boolean' ? value : undefined;
+}
+function round(value) {
+    const factor = 10 ** SECONDS_DECIMALS;
+    return Math.round(value * factor) / factor;
+}
+/**
+ * Incremental reducer over a frame-sorted op stream. Public callers go through
+ * `reduceHudState`; `collectUiKeyframes` drives one instance forward across a
+ * clip so a frame-by-frame walk stays linear in the op count.
+ */
+class HudReducer {
+    ops;
+    fps;
+    cursor = 0;
+    hudVisible = true;
+    health = null;
+    theme = null;
+    elements = [];
+    toasts = [];
+    constructor(ops, fps) {
+        // Stable sort: entries recorded on the same frame keep emission order,
+        // which IS the stacking order within an anchor.
+        this.ops = [...ops].sort((a, b) => a.frame - b.frame);
+        this.fps = fps;
+    }
+    /** Apply every op at or before `frame`. Frames must not go backwards. */
+    advanceTo(frame) {
+        while (this.cursor < this.ops.length && this.ops[this.cursor].frame <= frame) {
+            this.apply(this.ops[this.cursor]);
+            this.cursor++;
+        }
+    }
+    find(id) {
+        return this.elements.find((el) => el.id === id);
+    }
+    apply(op) {
+        // Engine chrome is part of the HUD but never part of a trailer.
+        if ('id' in op && CHROME_ELEMENT_IDS.has(op.id))
+            return;
+        switch (op.op) {
+            case 'create':
+                this.applyCreate(op.frame, op.id, op.elType, op.params);
+                break;
+            case 'update':
+                this.applyUpdate(op.id, op.text, op.icon, op.percent);
+                break;
+            case 'custom-html': {
+                const el = this.find(op.id);
+                if (el !== undefined)
+                    el.html = op.html;
+                break;
+            }
+            case 'timer':
+                this.applyTimer(op.frame, op.id, op.action, op.seconds);
+                break;
+            case 'show':
+            case 'hide': {
+                const el = this.find(op.id);
+                if (el !== undefined)
+                    el.visible = op.op === 'show';
+                break;
+            }
+            case 'remove': {
+                const index = this.elements.findIndex((el) => el.id === op.id);
+                if (index >= 0)
+                    this.elements.splice(index, 1);
+                break;
+            }
+            case 'health':
+                this.health = { current: op.current, max: op.max, visible: this.health?.visible ?? false };
+                break;
+            case 'health-visible':
+                this.health = {
+                    current: this.health?.current ?? 0,
+                    max: this.health?.max ?? 100,
+                    visible: op.visible
+                };
+                break;
+            case 'toast': {
+                const durationMs = op.durationMs ?? DEFAULT_TOAST_MS;
+                const toast = {
+                    message: op.message,
+                    startFrame: op.frame,
+                    endFrame: op.frame + (durationMs / 1000) * this.fps
+                };
+                if (op.variant !== undefined)
+                    toast.variant = op.variant;
+                this.toasts.push(toast);
+                break;
+            }
+            case 'hud-visible':
+                this.hudVisible = op.visible;
+                break;
+            case 'theme':
+                this.theme = op.theme;
+                break;
+            default:
+                // Forward compatibility: a newer engine may log ops we predate.
+                break;
+        }
+    }
+    applyCreate(frame, id, elType, params) {
+        // Re-creating an id replaces the old element and re-appends it, matching
+        // the DOM's append-on-create stacking.
+        const existing = this.elements.findIndex((el) => el.id === id);
+        if (existing >= 0)
+            this.elements.splice(existing, 1);
+        const el = {
+            id,
+            type: elType,
+            anchor: readString(params, 'anchor') ?? DEFAULT_ANCHOR[elType] ?? 'top-left',
+            visible: true
+        };
+        const label = readString(params, 'label');
+        const color = readString(params, 'color');
+        const width = readNumber(params, 'width');
+        const showText = readBoolean(params, 'showText');
+        const percent = readNumber(params, 'percent');
+        const icon = readString(params, 'icon');
+        const text = readString(params, 'text');
+        const iconSize = readNumber(params, 'iconSize');
+        const countDown = readBoolean(params, 'countDown');
+        const format = readString(params, 'format');
+        const html = readString(params, 'html');
+        const css = readString(params, 'css');
+        if (label !== undefined)
+            el.label = label;
+        if (color !== undefined)
+            el.color = color;
+        if (width !== undefined)
+            el.width = width;
+        if (showText !== undefined)
+            el.showText = showText;
+        if (percent !== undefined)
+            el.percent = percent;
+        if (icon !== undefined)
+            el.icon = icon;
+        if (text !== undefined)
+            el.text = text;
+        if (iconSize !== undefined)
+            el.iconSize = iconSize;
+        if (countDown !== undefined)
+            el.countDown = countDown;
+        if (format !== undefined)
+            el.format = format;
+        if (html !== undefined)
+            el.html = html;
+        if (css !== undefined)
+            el.css = css;
+        if (elType === 'timer') {
+            const seconds = readNumber(params, 'seconds') ?? 0;
+            el.timer = { anchorSeconds: seconds, anchorFrame: frame, running: false, createSeconds: seconds };
+        }
+        this.elements.push(el);
+    }
+    applyUpdate(id, text, icon, percent) {
+        const el = this.find(id);
+        if (el === undefined)
+            return; // updates can trail a remove
+        if (text !== undefined)
+            el.text = text;
+        if (icon !== undefined)
+            el.icon = icon;
+        if (percent !== undefined)
+            el.percent = percent;
+    }
+    applyTimer(frame, id, action, seconds) {
+        const el = this.find(id);
+        const timer = el?.timer;
+        if (el === undefined || timer === undefined)
+            return;
+        switch (action) {
+            case 'start':
+                timer.anchorSeconds = seconds ?? derivedSeconds(timer, frame, el.countDown ?? false, this.fps);
+                timer.anchorFrame = frame;
+                timer.running = true;
+                break;
+            case 'pause':
+                timer.anchorSeconds = derivedSeconds(timer, frame, el.countDown ?? false, this.fps);
+                timer.anchorFrame = frame;
+                timer.running = false;
+                break;
+            case 'reset':
+                timer.anchorSeconds = seconds ?? timer.createSeconds;
+                timer.anchorFrame = frame;
+                timer.running = false;
+                break;
+        }
+    }
+    /** The replay state as of `frame`. Requires `advanceTo(frame)` first. */
+    snapshot(frame) {
+        this.toasts = this.toasts.filter((t) => t.endFrame > frame);
+        return {
+            version: 1,
+            hudVisible: this.hudVisible,
+            health: this.health === null ? null : { ...this.health },
+            theme: this.theme,
+            elements: this.elements.map((el) => emitElement(el, frame, this.fps)),
+            toasts: this.toasts
+                .filter((t) => t.startFrame <= frame)
+                .map((t) => (t.variant === undefined ? { message: t.message } : { message: t.message, variant: t.variant }))
+        };
+    }
+}
+function derivedSeconds(timer, frame, countDown, fps) {
+    if (!timer.running)
+        return timer.anchorSeconds;
+    const elapsed = Math.max(0, frame - timer.anchorFrame) / fps;
+    return countDown ? Math.max(0, timer.anchorSeconds - elapsed) : timer.anchorSeconds + elapsed;
+}
+/** Build the emitted element, in a fixed key order, omitting unset optionals. */
+function emitElement(el, frame, fps) {
+    const state = { id: el.id, type: el.type, anchor: el.anchor, visible: el.visible };
+    if (el.label !== undefined)
+        state.label = el.label;
+    if (el.color !== undefined)
+        state.color = el.color;
+    if (el.width !== undefined)
+        state.width = el.width;
+    if (el.showText !== undefined)
+        state.showText = el.showText;
+    if (el.percent !== undefined)
+        state.percent = el.percent;
+    if (el.icon !== undefined)
+        state.icon = el.icon;
+    if (el.text !== undefined)
+        state.text = el.text;
+    if (el.iconSize !== undefined)
+        state.iconSize = el.iconSize;
+    if (el.timer !== undefined)
+        state.seconds = round(derivedSeconds(el.timer, frame, el.countDown ?? false, fps));
+    if (el.countDown !== undefined)
+        state.countDown = el.countDown;
+    if (el.format !== undefined)
+        state.format = el.format;
+    if (el.html !== undefined)
+        state.html = el.html;
+    if (el.css !== undefined)
+        state.css = el.css;
+    return state;
+}
+/**
+ * The complete HUD state at `frame`. Ops after `frame` are ignored; unknown
+ * op names are skipped rather than throwing.
+ */
+export function reduceHudState(ops, frame, fps = DEFAULT_HUD_FPS) {
+    const reducer = new HudReducer(ops, fps);
+    reducer.advanceTo(frame);
+    return reducer.snapshot(frame);
+}
+/** True when a state would rasterize to a fully transparent frame. */
+export function isBlankHudState(state) {
+    if (!state.hudVisible)
+        return true;
+    if (state.toasts.length > 0)
+        return false;
+    if (state.health !== null && state.health.visible)
+        return false;
+    return !state.elements.some((el) => el.visible);
+}
+export const DEFAULT_MAX_KEYFRAMES_PER_SECOND = 10;
+export const DEFAULT_MAX_KEYFRAMES_PER_CLIP = 240;
+/**
+ * Frame times are exact ratios that land just under a spacing boundary in
+ * binary (frame 18 at 60fps is 0.09999999999999998s after frame 12), which
+ * would otherwise push every subsequent keyframe a frame later.
+ */
+const SPACING_EPSILON = 1e-9;
+/**
+ * Structural identity of a state. Timer seconds collapse to whole displayed
+ * seconds (floor — where both floor- and ceil-based formatters change), so a
+ * ticking clock yields ~1 keyframe per second instead of one per frame.
+ */
+function stateKey(state) {
+    return JSON.stringify({
+        ...state,
+        elements: state.elements.map((el) => el.seconds === undefined ? el : { ...el, seconds: Math.floor(el.seconds) })
+    });
+}
+/**
+ * Walk every enabled clip's source range and emit a keyframe wherever the
+ * reduced HUD state changes.
+ *
+ * A clip's overlays stop at `exclusiveOutputEnd`, so during a crossfade the
+ * incoming clip's UI takes over at the fade start and exactly one overlay is
+ * ever active — two stacked HUDs would double-draw every element.
+ */
+export function collectUiKeyframes(ops, clips, opts = {}) {
+    const fps = opts.fps ?? DEFAULT_HUD_FPS;
+    const maxPerSecond = opts.maxPerSecond ?? DEFAULT_MAX_KEYFRAMES_PER_SECOND;
+    const maxPerClip = opts.maxPerClip ?? DEFAULT_MAX_KEYFRAMES_PER_CLIP;
+    const clipEnabled = opts.clipEnabled ?? (() => true);
+    const log = opts.log ?? warn;
+    const minSpacingSec = maxPerSecond > 0 ? 1 / maxPerSecond : 0;
+    const keyframes = [];
+    for (let index = 0; index < clips.length; index++) {
+        if (!clipEnabled(index))
+            continue;
+        const timing = clips[index];
+        const windowEnd = exclusiveOutputEnd(clips, index);
+        const reducer = new HudReducer(ops, fps);
+        const clipFrames = [];
+        let lastEmittedKey = null;
+        let lastEmittedSec = Number.NEGATIVE_INFINITY;
+        // The newest state still waiting for a slot; superseding it loses it.
+        let pendingKey = null;
+        let coalesced = 0;
+        let droppedByCap = 0;
+        let capped = false;
+        let firstDroppedFrame = -1;
+        for (let frame = timing.in; frame < timing.out; frame++) {
+            const outputSec = sourceFrameToOutputSec(timing, frame, fps);
+            if (outputSec >= windowEnd)
+                break;
+            reducer.advanceTo(frame);
+            const state = reducer.snapshot(frame);
+            const key = stateKey(state);
+            if (key === lastEmittedKey)
+                continue;
+            if (clipFrames.length >= maxPerClip) {
+                if (pendingKey !== null && pendingKey !== key)
+                    droppedByCap++;
+                if (!capped)
+                    firstDroppedFrame = frame;
+                capped = true;
+                pendingKey = key;
+                continue;
+            }
+            if (outputSec - lastEmittedSec < minSpacingSec - SPACING_EPSILON) {
+                // Rate limited: hold, and emit the newest state once spacing allows.
+                if (pendingKey !== null && pendingKey !== key)
+                    coalesced++;
+                pendingKey = key;
+                continue;
+            }
+            if (pendingKey !== null && pendingKey !== key)
+                coalesced++;
+            clipFrames.push({
+                sourceFrame: frame,
+                clipIndex: index,
+                outputStartSec: outputSec,
+                outputEndSec: windowEnd,
+                state
+            });
+            lastEmittedKey = key;
+            lastEmittedSec = outputSec;
+            pendingKey = null;
+        }
+        // Whatever is still pending when the clip ends is never rendered either.
+        if (pendingKey !== null) {
+            if (capped)
+                droppedByCap++;
+            else
+                coalesced++;
+        }
+        for (let i = 0; i < clipFrames.length - 1; i++) {
+            clipFrames[i].outputEndSec = clipFrames[i + 1].outputStartSec;
+        }
+        keyframes.push(...clipFrames);
+        if (coalesced > 0) {
+            log(`ui: clip ${index} rate-limited to ${maxPerSecond} keyframe(s)/s of output time — ` +
+                `${coalesced} intermediate HUD state(s) never rendered`);
+        }
+        if (droppedByCap > 0) {
+            log(`ui: clip ${index} hit the ${maxPerClip}-keyframe cap at source frame ${firstDroppedFrame} — ` +
+                `${droppedByCap} later HUD state(s) dropped; the overlay holds its last state`);
+        }
+    }
+    return keyframes;
+}
+//# sourceMappingURL=hud-state.js.map

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

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

package/dist/trailer/io.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Where the compositor's words go.
+ *
+ * The trailer modules narrate as they work — windows scored, overlays rasterized, the render
+ * summary — and under `--json` every one of those lines must land on stderr, because stdout is
+ * reserved for the single result document (`output.ts`). The modules cannot know which mode the
+ * command runs in, so the command binds the Output seam here first and everything below it
+ * writes through `out`/`warn` without caring.
+ *
+ * Unbound (a test, or a module used as a library) both go to stderr: never stdout, so nothing here
+ * can corrupt a result by accident.
+ */
+export interface TrailerLog {
+    info(line: string): void;
+    warn(line: string): void;
+}
+/** The command layer calls this once with `createOutput(json)` before running any pipeline step. */
+export declare function bindTrailerLog(log: TrailerLog): void;
+export declare function out(line: string): void;
+export declare function warn(line: string): void;

package/dist/trailer/io.js

@@ -0,0 +1,15 @@
+let bound = {
+    info: (line) => process.stderr.write(`${line}\n`),
+    warn: (line) => process.stderr.write(`${line}\n`),
+};
+/** The command layer calls this once with `createOutput(json)` before running any pipeline step. */
+export function bindTrailerLog(log) {
+    bound = log;
+}
+export function out(line) {
+    bound.info(line);
+}
+export function warn(line) {
+    bound.warn(line);
+}
+//# sourceMappingURL=io.js.map

package/dist/trailer/io.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"io.js","sourceRoot":"","sources":["../../src/trailer/io.ts"],"names":[],"mappings":"AAiBA,IAAI,KAAK,GAAe;IACtB,IAAI,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,IAAI,CAAC;IACjD,IAAI,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,IAAI,CAAC;CAClD,CAAC;AAEF,oGAAoG;AACpG,MAAM,UAAU,cAAc,CAAC,GAAe;IAC5C,KAAK,GAAG,GAAG,CAAC;AACd,CAAC;AAED,MAAM,UAAU,GAAG,CAAC,IAAY;IAC9B,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,IAAI,CAAC,IAAY;IAC/B,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACnB,CAAC"}

package/dist/trailer/make.d.ts

@@ -0,0 +1,54 @@
+export declare const DEFAULT_TRAILER_SECONDS = 30;
+/** Music runs a little past the cut so the fade-out has material. */
+export declare const MUSIC_TAIL_SEC = 4;
+/** The render's music/SFX balance the make-trailer skill settled on. */
+export declare const MAKE_MUSIC_GAIN_DB = -4;
+export declare const MAKE_SFX_GAIN_DB = -3;
+export interface TrailerPublished {
+    publicUrl: string;
+    pageUrl?: string;
+    attached: boolean;
+}
+export interface MakeOptions {
+    root: string;
+    /** A finished recording dir (see paths.resolveRecording). */
+    recordingDir: string;
+    /** A music file to bed under the cut. */
+    music?: string;
+    /** Generate the bed from this prompt through `generateMusic`. */
+    musicPrompt?: string;
+    /** Target length including the end card. */
+    seconds?: number;
+    /** End-card text; defaults to the game's name. */
+    title?: string;
+    sub?: string;
+    /** Draw the HUD replay (needs `harnessUrl`). */
+    ui?: boolean;
+    /** `/hud-replay.html` on the running dev sidecar. */
+    harnessUrl?: string;
+    /** Throw away trailer/shots.json and write a fresh auto cut. */
+    resetShots?: boolean;
+    /** The music lane: write an mp3 of `seconds` for `prompt` at `outPath`. */
+    generateMusic?: (prompt: string, seconds: number, outPath: string) => Promise<void>;
+    /** The publish lane: upload the render and return where it went. */
+    publish?: (mp4: string) => Promise<TrailerPublished>;
+}
+export interface MakeResult {
+    recordingDir: string;
+    recordingName: string;
+    workDir: string;
+    analysisPath: string;
+    shotsPath: string;
+    /** Whether this run wrote the shots file (first cut) or cut an existing one. */
+    shotsWritten: boolean;
+    edlPath: string;
+    musicPath?: string;
+    beatsPath?: string;
+    mp4: string;
+    durationSec: number;
+    clipCount: number;
+    published?: TrailerPublished;
+}
+/** The game's name as the work copy knows it, for the end card and the file name. */
+export declare function gameNameFor(root: string): string;
+export declare function makeTrailer(options: MakeOptions): Promise<MakeResult>;