@bitmagic/asset-core 0.2.24 → 0.2.25-dev.1

package/dist/trailer/analyze.d.ts

@@ -0,0 +1,24 @@
+import type { Analysis, Timeline } from './timeline-types.js';
+export declare const EVENT_WEIGHTS: Readonly<Record<string, number>>;
+export declare const DEFAULT_EVENT_WEIGHT = 0.5;
+export declare const FORCED_EVENT_TYPES: readonly string[];
+export declare function eventWeight(type: string): number;
+export interface SelectedWindow {
+    startFrame: number;
+    endFrame: number;
+    score: number;
+    forced: boolean;
+    events: string[];
+}
+/**
+ * Deterministic window selection over a timeline. Pure — no filesystem or
+ * ffmpeg — so it is unit-testable on synthetic timelines.
+ */
+export declare function selectWindows(timeline: Timeline, windowSec: number, top: number): SelectedWindow[];
+/**
+ * Score the timeline and write `analysis.json` + `sheets/` into `outDir` (default: the recording
+ * dir itself, the web-lane layout; the CLI lane points it at the trailer work dir so recordings
+ * stay pristine). Sheet paths inside analysis.json are relative to `outDir`.
+ */
+export declare function runAnalyze(recordingDir: string, windowSec: number, top: number, outDir?: string): Promise<Analysis>;
+//# sourceMappingURL=analyze.d.ts.map

package/dist/trailer/analyze.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyze.d.ts","sourceRoot":"","sources":["../../src/trailer/analyze.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,QAAQ,EAAkB,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAiB9E,eAAO,MAAM,aAAa,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAe1D,CAAC;AAEF,eAAO,MAAM,oBAAoB,MAAM,CAAC;AAExC,eAAO,MAAM,kBAAkB,EAAE,SAAS,MAAM,EAA0C,CAAC;AAE3F,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEhD;AAyBD,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,cAAc,EAAE,CAoElG;AA2CD;;;;GAIG;AACH,wBAAsB,UAAU,CAC9B,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,MAAM,EACX,MAAM,GAAE,MAAqB,GAC5B,OAAO,CAAC,QAAQ,CAAC,CA2BnB"}

package/dist/trailer/analyze.js

@@ -0,0 +1,186 @@
+/**
+ * Timeline analysis: score events into 0.5s bins, Gaussian-smooth, pick
+ * top-N non-overlapping highlight windows (plus force-included windows around
+ * score/lap/goal/match-end events), and render a 3x2 contact sheet per window.
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import { frameFilePath, loadTimeline } from './timeline-types.js';
+import { runFfmpeg } from './ffmpeg.js';
+import { out } from './io.js';
+const BIN_SEC = 0.5;
+const SMOOTH_SIGMA_BINS = 2; // sigma ~= 1s at 0.5s bins
+const DEFAULT_INTENSITY = 0.7;
+const SHEET_FRAME_COUNT = 6;
+const SHEET_TILE_WIDTH = 320;
+/**
+ * Top-N candidate peaks below this are ignored: they are smoothing tails
+ * (a single event bleeds a tiny score across the whole kernel radius), not
+ * real highlights. Force-included windows bypass the floor by design.
+ */
+const MIN_WINDOW_PEAK_SCORE = 0.05;
+export const EVENT_WEIGHTS = {
+    explosion: 1.0,
+    'match-end': 1.0,
+    'player-death': 0.9,
+    'vehicle-collision': 0.9,
+    score: 0.9,
+    lap: 0.9,
+    goal: 0.9,
+    death: 0.8,
+    'vehicle-hits-character': 0.8,
+    'projectile-hit': 0.5,
+    damage: 0.4,
+    pickup: 0.3,
+    shot: 0.15,
+    state: 0
+};
+export const DEFAULT_EVENT_WEIGHT = 0.5;
+export const FORCED_EVENT_TYPES = ['score', 'lap', 'goal', 'match-end'];
+export function eventWeight(type) {
+    return EVENT_WEIGHTS[type] ?? DEFAULT_EVENT_WEIGHT;
+}
+/**
+ * Gaussian smoothing with an UNNORMALIZED kernel (peak weight 1): a bin's
+ * smoothed value reads as the gaussian-weighted event mass around it, so
+ * window scores stay on the same scale as the summed per-event weights.
+ */
+function gaussianSmooth(values, sigma) {
+    const radius = Math.max(1, Math.ceil(sigma * 3));
+    const kernel = [];
+    for (let d = -radius; d <= radius; d++) {
+        kernel.push(Math.exp(-(d * d) / (2 * sigma * sigma)));
+    }
+    const smoothed = new Float64Array(values.length);
+    for (let i = 0; i < values.length; i++) {
+        let acc = 0;
+        for (let d = -radius; d <= radius; d++) {
+            const j = i + d;
+            if (j >= 0 && j < values.length)
+                acc += values[j] * kernel[d + radius];
+        }
+        smoothed[i] = acc;
+    }
+    return smoothed;
+}
+/**
+ * Deterministic window selection over a timeline. Pure — no filesystem or
+ * ffmpeg — so it is unit-testable on synthetic timelines.
+ */
+export function selectWindows(timeline, windowSec, top) {
+    const { fps, frameCount } = timeline.recording;
+    const binFrames = fps * BIN_SEC;
+    const totalBins = Math.max(1, Math.ceil(frameCount / binFrames));
+    const binOf = (frame) => Math.min(totalBins - 1, Math.max(0, Math.floor(frame / binFrames)));
+    const raw = new Float64Array(totalBins);
+    for (const event of timeline.events) {
+        const contribution = eventWeight(event.type) * (event.intensity ?? DEFAULT_INTENSITY);
+        if (contribution > 0)
+            raw[binOf(event.frame)] += contribution;
+    }
+    for (const sound of timeline.sounds) {
+        raw[binOf(sound.frame)] += sound.kind === 'asset' ? 0.1 : 0.05;
+    }
+    const smoothed = gaussianSmooth(raw, SMOOTH_SIGMA_BINS);
+    const windowBins = Math.max(1, Math.round(windowSec / BIN_SEC));
+    const windowFrames = Math.round(windowSec * fps);
+    const maxStartBin = Math.max(0, totalBins - windowBins);
+    const chosen = [];
+    const overlapsChosen = (startBin) => chosen.some((c) => startBin < c.startBin + windowBins && c.startBin < startBin + windowBins);
+    // Top-N peaks, greedily, highest smoothed bin first (ties -> earlier bin).
+    const order = Array.from({ length: totalBins }, (_, i) => i).sort((a, b) => smoothed[b] - smoothed[a] || a - b);
+    for (const bin of order) {
+        if (chosen.length >= top)
+            break;
+        if (smoothed[bin] < MIN_WINDOW_PEAK_SCORE)
+            break; // sorted descending: only noise remains
+        const startBin = Math.min(maxStartBin, Math.max(0, bin - Math.floor(windowBins / 2)));
+        if (!overlapsChosen(startBin))
+            chosen.push({ startBin, forced: false });
+    }
+    // Force-include a window centered on every score/lap/goal/match-end event,
+    // even if low-scoring; drop ones overlapping already-selected windows.
+    for (const event of timeline.events) {
+        if (!FORCED_EVENT_TYPES.includes(event.type))
+            continue;
+        const idealStartBin = (event.frame - windowFrames / 2) / binFrames;
+        const startBin = Math.min(maxStartBin, Math.max(0, Math.round(idealStartBin)));
+        if (!overlapsChosen(startBin))
+            chosen.push({ startBin, forced: true });
+    }
+    chosen.sort((a, b) => a.startBin - b.startBin);
+    return chosen.map((candidate) => {
+        const startFrame = Math.round(candidate.startBin * binFrames);
+        const endFrame = Math.min(frameCount, startFrame + windowFrames);
+        let peak = 0;
+        const lastBin = Math.min(totalBins, candidate.startBin + windowBins);
+        for (let b = candidate.startBin; b < lastBin; b++)
+            peak = Math.max(peak, smoothed[b]);
+        const digest = timeline.events
+            .filter((e) => e.frame >= startFrame && e.frame < endFrame && eventWeight(e.type) > 0)
+            .map((e) => `f${e.frame} ${e.type} i${e.intensity ?? DEFAULT_INTENSITY}`);
+        return {
+            startFrame,
+            endFrame,
+            score: Math.round(peak * 1000) / 1000,
+            forced: candidate.forced,
+            events: digest
+        };
+    });
+}
+/** Find the frame index nearest to `ideal` whose PNG actually exists on disk. */
+function nearestExistingFrame(recordingDir, name, ideal, frameCount) {
+    for (let distance = 0; distance < frameCount; distance++) {
+        const candidates = distance === 0 ? [ideal] : [ideal - distance, ideal + distance];
+        for (const frame of candidates) {
+            if (frame >= 0 && frame < frameCount && fs.existsSync(frameFilePath(recordingDir, name, frame))) {
+                return frame;
+            }
+        }
+    }
+    throw new Error(`no frame files found near frame ${ideal} in ${recordingDir}`);
+}
+async function renderContactSheet(recordingDir, timeline, window, sheetPath) {
+    const { name, frameCount } = timeline.recording;
+    const span = Math.max(1, window.endFrame - window.startFrame);
+    const args = ['-y'];
+    const labels = [];
+    for (let k = 0; k < SHEET_FRAME_COUNT; k++) {
+        const ideal = window.startFrame + Math.round((k * (span - 1)) / (SHEET_FRAME_COUNT - 1));
+        const frame = nearestExistingFrame(recordingDir, name, ideal, frameCount);
+        args.push('-i', frameFilePath(recordingDir, name, frame));
+        labels.push(`[${k}:v]`);
+    }
+    args.push('-filter_complex', `${labels.join('')}concat=n=${SHEET_FRAME_COUNT}:v=1:a=0,scale=${SHEET_TILE_WIDTH}:-1,tile=3x2[sheet]`, '-map', '[sheet]', '-frames:v', '1', sheetPath);
+    await runFfmpeg(args);
+}
+/**
+ * Score the timeline and write `analysis.json` + `sheets/` into `outDir` (default: the recording
+ * dir itself, the web-lane layout; the CLI lane points it at the trailer work dir so recordings
+ * stay pristine). Sheet paths inside analysis.json are relative to `outDir`.
+ */
+export async function runAnalyze(recordingDir, windowSec, top, outDir = recordingDir) {
+    const timeline = loadTimeline(recordingDir);
+    const selected = selectWindows(timeline, windowSec, top);
+    const sheetsDir = path.join(outDir, 'sheets');
+    fs.mkdirSync(sheetsDir, { recursive: true });
+    const windows = [];
+    for (let i = 0; i < selected.length; i++) {
+        const sheetRel = path.join('sheets', `window_${String(i).padStart(2, '0')}.png`);
+        await renderContactSheet(recordingDir, timeline, selected[i], path.join(outDir, sheetRel));
+        const { startFrame, endFrame, score, events } = selected[i];
+        windows.push({ startFrame, endFrame, score, events, sheet: sheetRel });
+    }
+    const analysis = {
+        version: 1,
+        fps: timeline.recording.fps,
+        frameCount: timeline.recording.frameCount,
+        windows
+    };
+    const analysisPath = path.join(outDir, 'analysis.json');
+    fs.writeFileSync(analysisPath, `${JSON.stringify(analysis, null, 2)}\n`);
+    const forcedCount = selected.filter((w) => w.forced).length;
+    out(`Wrote ${analysisPath} — ${windows.length} windows (${forcedCount} forced), sheets in ${sheetsDir}`);
+    return analysis;
+}
+//# sourceMappingURL=analyze.js.map

package/dist/trailer/analyze.js.map

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

package/dist/trailer/auto-edl.d.ts

@@ -0,0 +1,51 @@
+/**
+ * The first cut nobody had to author.
+ *
+ * `bitmagic trailer make` on a fresh recording has an analysis (scored highlight windows with
+ * contact sheets) and a target length, and must produce a watchable trailer with no shots file —
+ * so the agent has something to react to and tune, rather than a blank page. This module turns
+ * the analysis into a `ShotsFile` that follows the craft rules the make-trailer skill paid for:
+ *
+ *  - shots run 1.5–3 s and VARY in length (a fixed pattern, so no two neighbours match);
+ *  - the body is chronological — a first cut should tell the session's story, not shuffle it;
+ *  - a forced window (`score`, `lap`, `goal`, `match-end`) is always in, and a match-end is
+ *    pinned last so the end card dims over the finish;
+ *  - every shot starts a little BEFORE its peak event, so the action lands inside the shot
+ *    instead of on its first frame;
+ *  - speed is 1.0 everywhere — slow motion reads as a low framerate on gameplay footage;
+ *  - text is an end card only.
+ *
+ * When the analysis is thin (few events logged) the remaining slots are filled with evenly spaced
+ * shots across the recording, so every recording yields a trailer — a boring cut beats no cut, and
+ * the sheets let the agent replace shots in the next turn.
+ */
+import type { Analysis } from './timeline-types.js';
+import type { BeatAnalysis } from './music-beats.js';
+import type { ShotsFile } from './beat-cut.js';
+/** Seconds per body shot, cycled. All inside the craft doc's 1.5–3 s band, never two alike in a row. */
+export declare const SHOT_LENGTH_PATTERN_SEC: readonly number[];
+export declare const END_CARD_SEC = 2.5;
+/** How far before the peak event a shot begins, as a fraction of its length. */
+export declare const LEAD_IN_FRACTION = 0.6;
+/** Nothing in the first second: the game is still fading in from its menu. */
+export declare const SKIP_LEADING_SEC = 1;
+export declare const MIN_BEATS_PER_SHOT = 2;
+export declare const MAX_BEATS_PER_SHOT = 8;
+export interface AutoShotsInput {
+    analysis: Analysis;
+    recordingName: string;
+    /** Whole trailer including the end card, in seconds. */
+    targetSeconds: number;
+    /** When present, shot lengths become whole beats and the end card too. */
+    beats: BeatAnalysis | null;
+    title: string;
+    sub?: string;
+    /** Draw the HUD replay over every shot (the render's --ui). */
+    ui?: boolean;
+    /** Frames the recorder failed to save (timeline.recording.missingFrames). Shots avoid them. */
+    missingFrames?: readonly number[];
+}
+/** A shot may carry at most this share of missing frames before it reads as a freeze. */
+export declare const MAX_MISSING_FRACTION = 0.1;
+export declare function buildAutoShots(input: AutoShotsInput): ShotsFile;
+//# sourceMappingURL=auto-edl.d.ts.map

package/dist/trailer/auto-edl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto-edl.d.ts","sourceRoot":"","sources":["../../src/trailer/auto-edl.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAkB,MAAM,qBAAqB,CAAC;AACpE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAErD,OAAO,KAAK,EAAmB,SAAS,EAAE,MAAM,eAAe,CAAC;AAEhE,wGAAwG;AACxG,eAAO,MAAM,uBAAuB,EAAE,SAAS,MAAM,EAAgC,CAAC;AACtF,eAAO,MAAM,YAAY,MAAM,CAAC;AAChC,gFAAgF;AAChF,eAAO,MAAM,gBAAgB,MAAM,CAAC;AACpC,8EAA8E;AAC9E,eAAO,MAAM,gBAAgB,IAAI,CAAC;AAClC,eAAO,MAAM,kBAAkB,IAAI,CAAC;AACpC,eAAO,MAAM,kBAAkB,IAAI,CAAC;AAEpC,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,QAAQ,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,wDAAwD;IACxD,aAAa,EAAE,MAAM,CAAC;IACtB,0EAA0E;IAC1E,KAAK,EAAE,YAAY,GAAG,IAAI,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,+DAA+D;IAC/D,EAAE,CAAC,EAAE,OAAO,CAAC;IACb,+FAA+F;IAC/F,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACnC;AAED,yFAAyF;AACzF,eAAO,MAAM,oBAAoB,MAAM,CAAC;AA8FxC,wBAAgB,cAAc,CAAC,KAAK,EAAE,cAAc,GAAG,SAAS,CA2J/D"}

package/dist/trailer/auto-edl.js

@@ -0,0 +1,266 @@
+import { FORCED_EVENT_TYPES, eventWeight } from './analyze.js';
+/** Seconds per body shot, cycled. All inside the craft doc's 1.5–3 s band, never two alike in a row. */
+export const SHOT_LENGTH_PATTERN_SEC = [2, 1.5, 3, 2, 2.5, 1.5, 3];
+export const END_CARD_SEC = 2.5;
+/** How far before the peak event a shot begins, as a fraction of its length. */
+export const LEAD_IN_FRACTION = 0.6;
+/** Nothing in the first second: the game is still fading in from its menu. */
+export const SKIP_LEADING_SEC = 1;
+export const MIN_BEATS_PER_SHOT = 2;
+export const MAX_BEATS_PER_SHOT = 8;
+/** A shot may carry at most this share of missing frames before it reads as a freeze. */
+export const MAX_MISSING_FRACTION = 0.1;
+/** Prefix sums over the missing set, so any range's missing count is two lookups. */
+class MissingIndex {
+    constructor(missing, frameCount) {
+        const flags = new Uint8Array(frameCount);
+        for (const f of missing)
+            if (f >= 0 && f < frameCount)
+                flags[f] = 1;
+        this.prefix = new Uint32Array(frameCount + 1);
+        for (let i = 0; i < frameCount; i++)
+            this.prefix[i + 1] = this.prefix[i] + flags[i];
+    }
+    count(start, end) {
+        const a = Math.max(0, Math.min(start, this.prefix.length - 1));
+        const b = Math.max(a, Math.min(end, this.prefix.length - 1));
+        return this.prefix[b] - this.prefix[a];
+    }
+    fraction(start, end) {
+        return end > start ? this.count(start, end) / (end - start) : 0;
+    }
+    /**
+     * The last frame worth cutting up to: walk back from the end while the trailing second is
+     * mostly missing. A recorder that stalls at the stop leaves exactly that shape — a good body
+     * and a dead tail — and the auto cut should treat the tail as if it were never recorded.
+     */
+    usableEnd(frameCount, fps) {
+        let end = frameCount;
+        const window = Math.round(fps);
+        while (end > window && this.fraction(end - window, end) > MAX_MISSING_FRACTION)
+            end -= window;
+        return end;
+    }
+}
+/** `"f3121 explosion i0.9"` -> the event's frame, type and weighted intensity. */
+function parseDigest(line) {
+    const match = /^f(\d+)\s+(\S+)\s+i([\d.]+)$/.exec(line.trim());
+    if (match === null)
+        return null;
+    const intensity = Number(match[3]);
+    return {
+        frame: Number(match[1]),
+        type: match[2],
+        weighted: eventWeight(match[2]) * (Number.isFinite(intensity) ? intensity : 1),
+    };
+}
+function toCandidate(window) {
+    let best = null;
+    let forced = false;
+    for (const line of window.events) {
+        const event = parseDigest(line);
+        if (event === null)
+            continue;
+        if (FORCED_EVENT_TYPES.includes(event.type))
+            forced = true;
+        if (best === null || event.weighted > best.weighted)
+            best = event;
+    }
+    const mid = Math.round((window.startFrame + window.endFrame) / 2);
+    return {
+        window,
+        peakFrame: best?.frame ?? mid,
+        peakType: best?.type ?? 'none',
+        forced,
+    };
+}
+/** A shot's length in whole beats when there is a grid — rounding the seconds, clamped to the band. */
+function beatsFor(seconds, beats) {
+    const beatSec = 60 / beats.bpm;
+    return Math.min(MAX_BEATS_PER_SHOT, Math.max(MIN_BEATS_PER_SHOT, Math.round(seconds / beatSec)));
+}
+/** Frame count a shot of `seconds` will occupy, including the slack a beat-snapped cut can add. */
+function framesFor(seconds, fps, beats) {
+    const slack = beats !== null ? 60 / beats.bpm : 0;
+    return Math.ceil((seconds + slack) * fps);
+}
+function describe(candidate, fps) {
+    const sec = candidate.peakFrame / fps;
+    const mm = Math.floor(sec / 60);
+    const ss = Math.floor(sec % 60).toString().padStart(2, '0');
+    const types = new Set();
+    for (const line of candidate.window.events) {
+        const event = parseDigest(line);
+        if (event !== null && event.weighted > 0)
+            types.add(event.type);
+    }
+    const what = types.size > 0 ? [...types].slice(0, 3).join(' + ') : 'gameplay';
+    return `${what} @${mm}:${ss}`;
+}
+export function buildAutoShots(input) {
+    const { analysis, beats } = input;
+    const fps = analysis.fps;
+    const lost = new MissingIndex(input.missingFrames ?? [], analysis.frameCount);
+    // Everything below cuts inside [0, frameCount): a dead tail is simply not part of the recording.
+    const frameCount = lost.usableEnd(analysis.frameCount, fps);
+    const skipFrames = Math.round(SKIP_LEADING_SEC * fps);
+    /**
+     * A start frame for a shot of `lenFrames` whose range is mostly present. An analysed moment is
+     * nudged EARLIER (the peak stays inside the shot); a filler is nudged LATER, so it never backs
+     * into the shot before it and repeats footage.
+     */
+    const placeShot = (ideal, lenFrames, direction) => {
+        const latest = Math.max(0, frameCount - lenFrames);
+        if (ideal > latest && direction === 'later')
+            return null;
+        for (let attempt = 0; attempt < 4; attempt++) {
+            const nudge = attempt * Math.round(lenFrames / 2);
+            const start = Math.max(0, Math.min(direction === 'earlier' ? ideal - nudge : ideal + nudge, latest));
+            if (lost.fraction(start, start + lenFrames) <= MAX_MISSING_FRACTION)
+                return start;
+        }
+        return null;
+    };
+    const bodyBudget = Math.max(SHOT_LENGTH_PATTERN_SEC[0], input.targetSeconds - END_CARD_SEC);
+    const meanLen = SHOT_LENGTH_PATTERN_SEC.reduce((a, b) => a + b, 0) / SHOT_LENGTH_PATTERN_SEC.length;
+    // Never ask for more footage than the recording holds: shots that overlap repeat the same
+    // seconds twice, which reads worse than a shorter trailer. A short recording gets a short cut.
+    const usableSec = Math.max(0, frameCount - skipFrames) / fps;
+    const slots = Math.max(1, Math.min(Math.floor(bodyBudget / meanLen), Math.floor(usableSec / meanLen)));
+    // Candidates: every analysed window with its peak inside the usable range; forced ones first,
+    // then by score, so the k best are taken but a forced window is never dropped for a louder one.
+    const candidates = analysis.windows
+        .map(toCandidate)
+        .filter((c) => c.peakFrame >= skipFrames && c.peakFrame < frameCount)
+        .filter((c) => c.peakType !== 'state');
+    const ranked = [...candidates].sort((a, b) => {
+        if (a.forced !== b.forced)
+            return a.forced ? -1 : 1;
+        return b.window.score - a.window.score;
+    });
+    const chosen = ranked.slice(0, Math.min(slots, ranked.length));
+    // Fill: evenly spaced across the recording, skipping spots an ANALYSED window already covers.
+    // Only the analysed picks count as cover — a filler must never shadow the next filler, or a
+    // short recording (fillers closer together than the radius) loses every second slot.
+    const missing = slots - chosen.length;
+    if (missing > 0) {
+        const analysed = [...chosen];
+        const usable = frameCount - skipFrames;
+        const spacing = usable / missing;
+        const radius = Math.min(3 * fps, spacing / 2);
+        for (let i = 0; i < missing; i++) {
+            const frame = skipFrames + Math.round((i + 0.5) * spacing);
+            const covered = analysed.some((c) => Math.abs(c.peakFrame - frame) < radius);
+            const filler = {
+                window: { startFrame: frame, endFrame: frame, score: 0, events: [], sheet: '' },
+                peakFrame: frame,
+                peakType: 'none',
+                forced: false,
+            };
+            if (!covered)
+                chosen.push(filler);
+        }
+    }
+    // Chronological, with a match-end pinned last.
+    chosen.sort((a, b) => a.peakFrame - b.peakFrame);
+    const endIndex = chosen.findIndex((c) => c.window.events.some((e) => parseDigest(e)?.type === 'match-end'));
+    if (endIndex >= 0 && endIndex !== chosen.length - 1) {
+        const [end] = chosen.splice(endIndex, 1);
+        chosen.push(end);
+    }
+    const shots = [];
+    let prevEnd = 0;
+    chosen.forEach((candidate, i) => {
+        const seconds = SHOT_LENGTH_PATTERN_SEC[i % SHOT_LENGTH_PATTERN_SEC.length];
+        const lenFrames = framesFor(seconds, fps, beats);
+        const isFiller = candidate.window.score === 0 && candidate.window.events.length === 0;
+        const lead = Math.round(LEAD_IN_FRACTION * seconds * fps);
+        // A filler starts no earlier than the previous shot ended: the same seconds twice is the one
+        // thing worse than a shorter trailer. A real moment keeps its peak in frame instead.
+        const ideal = isFiller ? Math.max(candidate.peakFrame - lead, prevEnd) : candidate.peakFrame - lead;
+        const start = placeShot(ideal, lenFrames, isFiller ? 'later' : 'earlier');
+        if (start === null)
+            return; // no clean footage near this moment — better one shot fewer than a freeze
+        const shot = { in: start, label: describe(candidate, fps) };
+        if (beats !== null)
+            shot.beats = beatsFor(seconds, beats);
+        else
+            shot.seconds = seconds;
+        if (input.ui === true)
+            shot.ui = true;
+        shots.push(shot);
+        prevEnd = start + lenFrames;
+    });
+    // Fillers dropped above (covered by an analysed moment, or with no clean footage where they
+    // fell) leave the cut short. Put them back where the footage is idle: the largest gap between
+    // shots, again and again, until the slots are full or no gap holds a shot.
+    const lenOf = (shot) => framesFor(shot.seconds ?? (shot.beats ?? 0) * (beats !== null ? 60 / beats.bpm : 0), fps, beats);
+    const pinnedEnd = endIndex >= 0 && shots.length > 0 ? shots[shots.length - 1] : null;
+    for (let guard = 0; shots.length < slots && guard < slots; guard++) {
+        const ordered = shots.filter((sh) => sh !== pinnedEnd).sort((a, b) => a.in - b.in);
+        const limit = pinnedEnd !== null ? pinnedEnd.in : frameCount;
+        let best = null;
+        let cursor = skipFrames;
+        for (const sh of [...ordered, null]) {
+            const gapEnd = sh === null ? limit : sh.in;
+            if (gapEnd - cursor > (best?.size ?? 0))
+                best = { start: cursor, size: gapEnd - cursor };
+            if (sh !== null)
+                cursor = Math.max(cursor, sh.in + lenOf(sh));
+        }
+        if (best === null)
+            break;
+        // The pattern's next length when it fits, else the longest pattern length that does — a 2 s
+        // gap still deserves a 1.5 s shot rather than nothing.
+        const preferred = SHOT_LENGTH_PATTERN_SEC[shots.length % SHOT_LENGTH_PATTERN_SEC.length];
+        const fitting = [preferred, ...[...SHOT_LENGTH_PATTERN_SEC].sort((a, b) => b - a)]
+            .find((sec) => framesFor(sec, fps, beats) <= best.size);
+        if (fitting === undefined)
+            break;
+        const seconds = fitting;
+        const lenFrames = framesFor(seconds, fps, beats);
+        const start = placeShot(best.start + Math.round((best.size - lenFrames) / 2), lenFrames, 'later');
+        if (start === null || start + lenFrames > best.start + best.size)
+            break;
+        const label = describe({ window: { startFrame: start, endFrame: start, score: 0, events: [], sheet: '' }, peakFrame: start + Math.round(lenFrames / 2), peakType: 'none', forced: false }, fps);
+        const shot = { in: start, label };
+        if (beats !== null)
+            shot.beats = beatsFor(seconds, beats);
+        else
+            shot.seconds = seconds;
+        if (input.ui === true)
+            shot.ui = true;
+        shots.push(shot);
+    }
+    // Chronological again after the gap fills, keeping a pinned match-end last.
+    shots.sort((a, b) => (a === pinnedEnd ? 1 : b === pinnedEnd ? -1 : a.in - b.in));
+    if (shots.length === 0) {
+        // Nothing clean anywhere: hold the opening, which at least exists.
+        const shot = { in: Math.min(skipFrames, Math.max(0, frameCount - 1)), label: 'gameplay @0:01' };
+        if (beats !== null)
+            shot.beats = beatsFor(END_CARD_SEC, beats);
+        else
+            shot.seconds = END_CARD_SEC;
+        shots.push(shot);
+    }
+    // The end card sits over the last shot, so that shot must be long enough to carry it.
+    const last = shots[shots.length - 1];
+    if (beats !== null)
+        last.beats = Math.max(last.beats ?? 0, beatsFor(END_CARD_SEC, beats));
+    else
+        last.seconds = Math.max(last.seconds ?? 0, END_CARD_SEC);
+    const lastLen = framesFor(last.seconds ?? END_CARD_SEC, fps, beats);
+    last.in = placeShot(Math.min(last.in, frameCount - lastLen), lastLen, 'earlier') ?? Math.max(0, Math.min(last.in, frameCount - lastLen));
+    const title = { at: 'last-clip', text: input.title.toUpperCase(), style: 'card' };
+    if (input.sub !== undefined)
+        title.sub = input.sub;
+    return {
+        version: 1,
+        recording: input.recordingName,
+        notes: 'First cut written by `bitmagic trailer make`. Edit freely: reorder, swap "in" frames for ' +
+            'better moments from analysis.json, change beats/seconds, add titles. Re-run make to render.',
+        shots,
+        titles: [title],
+    };
+}
+//# sourceMappingURL=auto-edl.js.map

package/dist/trailer/auto-edl.js.map

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

package/dist/trailer/beat-cut.d.ts

@@ -0,0 +1,58 @@
+import type { BeatAnalysis } from './music-beats.js';
+import type { TitleCue } from './titles.js';
+import type { Edl } from './timeline-types.js';
+export interface Shot {
+    /** Source frame the shot starts on. */
+    in: number;
+    /** Hold for this many beats (needs a beat grid). */
+    beats?: number;
+    /** Hold for this many seconds (used when there is no beat grid, or the shot has no `beats`). */
+    seconds?: number;
+    label: string;
+    /** Playback speed; the craft rule is 1.0 — slow-mo reads as a low framerate. */
+    speed?: number;
+    /** Draw (or suppress) the HUD replay over this shot; menus want `false`. */
+    ui?: boolean;
+    transition?: 'cut' | 'crossfade';
+    transitionDuration?: number;
+}
+/** A title whose `at` may be the literal `"last-clip"`; `dur` is then the last clip's length. */
+export type ShotTitle = Omit<TitleCue, 'at' | 'dur'> & {
+    at: number | 'last-clip';
+    dur?: number;
+};
+export interface ShotsFile {
+    version: 1;
+    /** Name of the recording these frame indices were chosen from. */
+    recording?: string;
+    /** Free-form notes the author keeps with the cut (never read by the tool). */
+    notes?: string;
+    shots: Shot[];
+    titles?: ShotTitle[];
+}
+export interface CutOptions {
+    /** Frames in the recording; a shot that would run past the end is shifted earlier and reported. */
+    frameCount?: number;
+}
+export interface CutResult {
+    edl: Edl;
+    /** Beats consumed from the downbeat (0 without a grid). */
+    beatsUsed: number;
+    totalSec: number;
+    /** Largest distance between a cut and its beat target, in ms (0 without a grid). */
+    worstCutErrorMs: number;
+    /** The first shot that did not fit in the track, when the grid ran out. */
+    truncatedAt?: string;
+}
+/** Parse a shots document: either a bare array of shots or `{ version, shots, titles? }`. */
+export declare function parseShots(raw: unknown, source: string): ShotsFile;
+export declare function loadShots(filePath: string): ShotsFile;
+/**
+ * Turn shots into frame-exact clips. With `beats` every cut lands on the grid counted from the
+ * downbeat; without, each shot's `seconds` decides its length. Returns the EDL plus the numbers
+ * the command prints so the author can judge the fit.
+ */
+export declare function cutShots(shots: ShotsFile, beats: BeatAnalysis | null, fps: number, options?: CutOptions): CutResult;
+/** The one-line summary `bitmagic trailer cut` prints, mirroring the Python script's. */
+export declare function describeCut(result: CutResult, beats: BeatAnalysis | null): string;
+//# sourceMappingURL=beat-cut.d.ts.map

package/dist/trailer/beat-cut.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"beat-cut.d.ts","sourceRoot":"","sources":["../../src/trailer/beat-cut.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,KAAK,EAAE,GAAG,EAAW,MAAM,qBAAqB,CAAC;AAGxD,MAAM,WAAW,IAAI;IACnB,uCAAuC;IACvC,EAAE,EAAE,MAAM,CAAC;IACX,oDAAoD;IACpD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gGAAgG;IAChG,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,gFAAgF;IAChF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4EAA4E;IAC5E,EAAE,CAAC,EAAE,OAAO,CAAC;IACb,UAAU,CAAC,EAAE,KAAK,GAAG,WAAW,CAAC;IACjC,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,iGAAiG;AACjG,MAAM,MAAM,SAAS,GAAG,IAAI,CAAC,QAAQ,EAAE,IAAI,GAAG,KAAK,CAAC,GAAG;IAAE,EAAE,EAAE,MAAM,GAAG,WAAW,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAElG,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,CAAC,CAAC;IACX,kEAAkE;IAClE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8EAA8E;IAC9E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,UAAU;IACzB,mGAAmG;IACnG,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,SAAS;IACxB,GAAG,EAAE,GAAG,CAAC;IACT,2DAA2D;IAC3D,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,oFAAoF;IACpF,eAAe,EAAE,MAAM,CAAC;IACxB,2EAA2E;IAC3E,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AA+DD,6FAA6F;AAC7F,wBAAgB,UAAU,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,CAiBlE;AAED,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CASrD;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CACtB,KAAK,EAAE,SAAS,EAChB,KAAK,EAAE,YAAY,GAAG,IAAI,EAC1B,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,UAAe,GACvB,SAAS,CA0FX;AAED,yFAAyF;AACzF,wBAAgB,WAAW,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,YAAY,GAAG,IAAI,GAAG,MAAM,CASjF"}