videoclaw 3.0.0-alpha.1

package/dist/video/motion-overlay/analyze-reel.js

@@ -0,0 +1,185 @@
+/**
+ * Pure per-take reel analysis.
+ *
+ * Derives, for a single take, the IP from the source skill's "Anatomy of the
+ * reel" + retention principles:
+ *  - `anatomy` — where the take sits in the reel (hook / contextualize / burst /
+ *    breath / cta), from its position `index / totalTakes`. This calibrates
+ *    visual load downstream.
+ *  - `anchorWords` — the speech keywords worth animating as giant headlines:
+ *    numbers, strong verbs, capitalized entities, otherwise notable keywords.
+ *    Each carries a take-relative time so the composer can sync the reveal.
+ *  - `pauses` — gaps > 0.4s between segments WITHIN the take, take-relative.
+ *    The composer holds the frame silent during these (silence before a reveal).
+ *
+ * Pure: no I/O. Deterministic for a given (split, segments, totalTakes).
+ */
+/** Minimum gap between segments (seconds) to count as a held pause. */
+export const PAUSE_THRESHOLD_SECONDS = 0.4;
+// A small, deliberately conservative list of strong/action verbs. Matched
+// case-insensitively on a normalized token. Kept short so detection stays
+// predictable and testable.
+const STRONG_VERBS = new Set([
+    'build',
+    'building',
+    'built',
+    'create',
+    'creating',
+    'created',
+    'launch',
+    'launching',
+    'launched',
+    'sell',
+    'selling',
+    'sold',
+    'grow',
+    'growing',
+    'grew',
+    'scale',
+    'scaling',
+    'ship',
+    'shipping',
+    'shipped',
+    'win',
+    'winning',
+    'won',
+    'transform',
+    'automate',
+    'automating',
+    'dominate',
+    'dominating',
+]);
+// Common short keywords worth surfacing as anchors when nothing stronger hits.
+const KEYWORDS = new Set([
+    'ai',
+    'time',
+    'money',
+    'revenue',
+    'growth',
+    'data',
+    'agent',
+    'agents',
+    'clone',
+    'clones',
+    'system',
+    'workflow',
+    'product',
+    'launch',
+]);
+// A token that contains a digit (currency, percentages, plain numbers, ranges).
+const NUMBER_RE = /\d/;
+/** Strip surrounding punctuation so word-matching is stable. Keeps inner chars. */
+function coreToken(raw) {
+    return raw.replace(/^[^\p{L}\p{N}$%#@*]+/u, '').replace(/[^\p{L}\p{N}$%#@*]+$/u, '');
+}
+/** True when the token's first letter is uppercase and it is not all-caps noise. */
+function isCapitalizedEntity(core) {
+    const first = core[0];
+    if (!first || first.toUpperCase() !== first || first.toLowerCase() === first) {
+        return false;
+    }
+    // Require at least one more letter so single capital letters don't qualify.
+    return /\p{L}/u.test(core.slice(1));
+}
+function classifyAnchor(core, isFirstWordOfSegment) {
+    if (!core) {
+        return null;
+    }
+    if (NUMBER_RE.test(core)) {
+        return 'number';
+    }
+    const lower = core.toLowerCase();
+    if (STRONG_VERBS.has(lower)) {
+        return 'verb';
+    }
+    // Sentence-leading capitalization is grammar, not an entity; require the
+    // capitalized token to NOT be the first word of its segment.
+    if (!isFirstWordOfSegment && isCapitalizedEntity(core)) {
+        return 'entity';
+    }
+    if (KEYWORDS.has(lower)) {
+        return 'keyword';
+    }
+    return null;
+}
+/**
+ * Map a take's position fraction (`index / totalTakes`) to its reel anatomy.
+ *
+ *  - first take            → hook
+ *  - last take             → cta
+ *  - position < 0.25       → contextualize
+ *  - 0.25 ≤ position < 0.6 → burst
+ *  - otherwise             → breath
+ */
+export function anatomyForPosition(index, totalTakes) {
+    if (totalTakes <= 0) {
+        return 'hook';
+    }
+    if (index <= 0) {
+        return 'hook';
+    }
+    if (index >= totalTakes - 1) {
+        return 'cta';
+    }
+    const position = index / totalTakes;
+    if (position < 0.25) {
+        return 'contextualize';
+    }
+    if (position < 0.6) {
+        return 'burst';
+    }
+    return 'breath';
+}
+/**
+ * Analyze one take: anatomy + anchor words + held pauses, all take-relative.
+ *
+ * @param split the take's span + the indices of the segments it covers.
+ * @param segments the full transcript segments (absolute timing).
+ * @param totalTakes number of takes in the reel (for anatomy positioning).
+ */
+export function analyzeTake(split, segments, totalTakes) {
+    const anatomy = anatomyForPosition(split.index, totalTakes);
+    const anchorWords = [];
+    const pauses = [];
+    let prevEnd = null;
+    for (const segIndex of split.segmentIndices) {
+        const seg = segments[segIndex];
+        if (!seg) {
+            continue;
+        }
+        // Pause: gap from the previous segment's end to this segment's start.
+        if (prevEnd !== null) {
+            const gap = seg.start - prevEnd;
+            if (gap > PAUSE_THRESHOLD_SECONDS) {
+                pauses.push({
+                    start: round(prevEnd - split.start),
+                    end: round(seg.start - split.start),
+                });
+            }
+        }
+        prevEnd = seg.end;
+        // Anchor words: scan tokens, time them within the segment by token order.
+        const tokens = seg.text.split(/\s+/).filter(Boolean);
+        const segDuration = Math.max(seg.end - seg.start, 0);
+        for (let t = 0; t < tokens.length; t++) {
+            const core = coreToken(tokens[t]);
+            const kind = classifyAnchor(core, t === 0);
+            if (!kind) {
+                continue;
+            }
+            const frac = tokens.length > 1 ? t / (tokens.length - 1) : 0;
+            const absTime = seg.start + frac * segDuration;
+            anchorWords.push({
+                word: core,
+                kind,
+                relativeTime: round(absTime - split.start),
+            });
+        }
+    }
+    return { index: split.index, anatomy, anchorWords, pauses };
+}
+/** Round to milliseconds to keep output stable and free of float noise. */
+function round(n) {
+    return Math.round(n * 1000) / 1000;
+}
+//# sourceMappingURL=analyze-reel.js.map

package/dist/video/motion-overlay/analyze-reel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyze-reel.js","sourceRoot":"","sources":["../../../src/video/motion-overlay/analyze-reel.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAIH,uEAAuE;AACvE,MAAM,CAAC,MAAM,uBAAuB,GAAG,GAAG,CAAC;AAE3C,0EAA0E;AAC1E,0EAA0E;AAC1E,4BAA4B;AAC5B,MAAM,YAAY,GAAwB,IAAI,GAAG,CAAC;IAChD,OAAO;IACP,UAAU;IACV,OAAO;IACP,QAAQ;IACR,UAAU;IACV,SAAS;IACT,QAAQ;IACR,WAAW;IACX,UAAU;IACV,MAAM;IACN,SAAS;IACT,MAAM;IACN,MAAM;IACN,SAAS;IACT,MAAM;IACN,OAAO;IACP,SAAS;IACT,MAAM;IACN,UAAU;IACV,SAAS;IACT,KAAK;IACL,SAAS;IACT,KAAK;IACL,WAAW;IACX,UAAU;IACV,YAAY;IACZ,UAAU;IACV,YAAY;CACb,CAAC,CAAC;AAEH,+EAA+E;AAC/E,MAAM,QAAQ,GAAwB,IAAI,GAAG,CAAC;IAC5C,IAAI;IACJ,MAAM;IACN,OAAO;IACP,SAAS;IACT,QAAQ;IACR,MAAM;IACN,OAAO;IACP,QAAQ;IACR,OAAO;IACP,QAAQ;IACR,QAAQ;IACR,UAAU;IACV,SAAS;IACT,QAAQ;CACT,CAAC,CAAC;AAEH,gFAAgF;AAChF,MAAM,SAAS,GAAG,IAAI,CAAC;AAEvB,mFAAmF;AACnF,SAAS,SAAS,CAAC,GAAW;IAC5B,OAAO,GAAG,CAAC,OAAO,CAAC,uBAAuB,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,uBAAuB,EAAE,EAAE,CAAC,CAAC;AACvF,CAAC;AAED,oFAAoF;AACpF,SAAS,mBAAmB,CAAC,IAAY;IACvC,MAAM,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IACtB,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,WAAW,EAAE,KAAK,KAAK,IAAI,KAAK,CAAC,WAAW,EAAE,KAAK,KAAK,EAAE,CAAC;QAC7E,OAAO,KAAK,CAAC;IACf,CAAC;IACD,4EAA4E;IAC5E,OAAO,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;AACtC,CAAC;AAED,SAAS,cAAc,CAAC,IAAY,EAAE,oBAA6B;IACjE,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACzB,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;IACjC,IAAI,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;QAC5B,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,yEAAyE;IACzE,6DAA6D;IAC7D,IAAI,CAAC,oBAAoB,IAAI,mBAAmB,CAAC,IAAI,CAAC,EAAE,CAAC;QACvD,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,IAAI,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAa,EAAE,UAAkB;IAClE,IAAI,UAAU,IAAI,CAAC,EAAE,CAAC;QACpB,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;QACf,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,IAAI,KAAK,IAAI,UAAU,GAAG,CAAC,EAAE,CAAC;QAC5B,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,QAAQ,GAAG,KAAK,GAAG,UAAU,CAAC;IACpC,IAAI,QAAQ,GAAG,IAAI,EAAE,CAAC;QACpB,OAAO,eAAe,CAAC;IACzB,CAAC;IACD,IAAI,QAAQ,GAAG,GAAG,EAAE,CAAC;QACnB,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CAAC,KAAgB,EAAE,QAA6B,EAAE,UAAkB;IAC7F,MAAM,OAAO,GAAG,kBAAkB,CAAC,KAAK,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;IAC5D,MAAM,WAAW,GAAiB,EAAE,CAAC;IACrC,MAAM,MAAM,GAAgB,EAAE,CAAC;IAE/B,IAAI,OAAO,GAAkB,IAAI,CAAC;IAClC,KAAK,MAAM,QAAQ,IAAI,KAAK,CAAC,cAAc,EAAE,CAAC;QAC5C,MAAM,GAAG,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC;QAC/B,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,SAAS;QACX,CAAC;QAED,sEAAsE;QACtE,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;YACrB,MAAM,GAAG,GAAG,GAAG,CAAC,KAAK,GAAG,OAAO,CAAC;YAChC,IAAI,GAAG,GAAG,uBAAuB,EAAE,CAAC;gBAClC,MAAM,CAAC,IAAI,CAAC;oBACV,KAAK,EAAE,KAAK,CAAC,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC;oBACnC,GAAG,EAAE,KAAK,CAAC,GAAG,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;iBACpC,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QACD,OAAO,GAAG,GAAG,CAAC,GAAG,CAAC;QAElB,0EAA0E;QAC1E,MAAM,MAAM,GAAG,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACrD,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,GAAG,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;QACrD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACvC,MAAM,IAAI,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;YAClC,MAAM,IAAI,GAAG,cAAc,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;YAC3C,IAAI,CAAC,IAAI,EAAE,CAAC;gBACV,SAAS;YACX,CAAC;YACD,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAC7D,MAAM,OAAO,GAAG,GAAG,CAAC,KAAK,GAAG,IAAI,GAAG,WAAW,CAAC;YAC/C,WAAW,CAAC,IAAI,CAAC;gBACf,IAAI,EAAE,IAAI;gBACV,IAAI;gBACJ,YAAY,EAAE,KAAK,CAAC,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC;aAC3C,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC;AAC9D,CAAC;AAED,2EAA2E;AAC3E,SAAS,KAAK,CAAC,CAAS;IACtB,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;AACrC,CAAC"}

package/dist/video/motion-overlay/animate-render.d.ts

@@ -0,0 +1,63 @@
+import { type LocalRenderStyle } from './render-local.js';
+import type { MotifMoment } from './motifs.js';
+/** An overlay element placed on the animation timeline. */
+export type AnimElement = {
+    kind: 'lower-third';
+    start: number;
+    end: number;
+    text: string;
+} | {
+    kind: 'headline';
+    start: number;
+    end: number;
+    word: string;
+} | {
+    kind: 'stat';
+    start: number;
+    end: number;
+    value: number;
+    unit?: string;
+    gauge?: number;
+} | {
+    kind: 'icon';
+    start: number;
+    end: number;
+    motif: MotifMoment;
+};
+/**
+ * Build the composite overlay SVG for one timestamp `t` — every active element with
+ * its animation applied. Pure & deterministic.
+ */
+export declare function animatedFrameSvg(t: number, dims: {
+    width: number;
+    height: number;
+}, style: LocalRenderStyle, elements: AnimElement[]): string;
+/** Pure: ffmpeg argv overlaying the rendered frame sequence onto the source at `fps`. */
+export declare function buildAnimateRenderArgs(sourceVideo: string, framePattern: string, fps: number, outputPath: string): string[];
+export type FfmpegRunner = (args: string[]) => Promise<void>;
+export interface AnimateRenderDeps {
+    ffmpeg: FfmpegRunner;
+    /** Override the rasteriser (tests). Defaults to the live sharp path. */
+    rasterise?: (svg: string) => Promise<Buffer>;
+}
+export interface AnimateRenderOptions {
+    sourceVideo: string;
+    dims: {
+        width: number;
+        height: number;
+    };
+    durationSeconds: number;
+    style: LocalRenderStyle;
+    elements: AnimElement[];
+    fps?: number;
+    /** Dir for the intermediate frame PNGs. */
+    frameDir: string;
+    outputPath: string;
+}
+/**
+ * Render the animated overlay reel: rasterise one transparent frame per output frame
+ * (each the composite for that timestamp), then overlay the sequence on the source.
+ * Returns the frame paths written.
+ */
+export declare function renderAnimatedOverlay(opts: AnimateRenderOptions, deps: AnimateRenderDeps): Promise<string[]>;
+//# sourceMappingURL=animate-render.d.ts.map

package/dist/video/motion-overlay/animate-render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"animate-render.d.ts","sourceRoot":"","sources":["../../../src/video/motion-overlay/animate-render.ts"],"names":[],"mappings":"AAgBA,OAAO,EAA8C,KAAK,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACtG,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAY/C,2DAA2D;AAC3D,MAAM,MAAM,WAAW,GACnB;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACjE;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC9D;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAC1F;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,WAAW,CAAA;CAAE,CAAC;AAkBrE;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,CAAC,EAAE,MAAM,EACT,IAAI,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,EACvC,KAAK,EAAE,gBAAgB,EACvB,QAAQ,EAAE,WAAW,EAAE,GACtB,MAAM,CA8BR;AAED,yFAAyF;AACzF,wBAAgB,sBAAsB,CACpC,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,EACpB,GAAG,EAAE,MAAM,EACX,UAAU,EAAE,MAAM,GACjB,MAAM,EAAE,CAiCV;AAED,MAAM,MAAM,YAAY,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAE7D,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,YAAY,CAAC;IACrB,wEAAwE;IACxE,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;CAC9C;AAED,MAAM,WAAW,oBAAoB;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IACxC,eAAe,EAAE,MAAM,CAAC;IACxB,KAAK,EAAE,gBAAgB,CAAC;IACxB,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,2CAA2C;IAC3C,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;GAIG;AACH,wBAAsB,qBAAqB,CAAC,IAAI,EAAE,oBAAoB,EAAE,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAgBlH"}

package/dist/video/motion-overlay/animate-render.js

@@ -0,0 +1,128 @@
+/**
+ * Per-frame animated overlay renderer (`--animate`).
+ *
+ * The static path composites one PNG per overlay with a fade. This path instead
+ * evaluates every overlay as a function of time and rasterises ONE transparent frame
+ * per output frame — a real motion-graphics layer — then ffmpeg overlays the frame
+ * sequence on the footage. Animations: lower-third fade + slide-up entrance + a
+ * word-by-word reveal; stat callouts count up (0→N) and the % gauge fills; icons /
+ * headlines pop in with a small overshoot. Original audio is preserved.
+ *
+ * `animatedFrameSvg` is pure (one composite SVG for a timestamp); the sharp rasterise
+ * + the ffmpeg run are injectable seams, so the pipeline is unit-tested offline.
+ */
+import sharp from 'sharp';
+import { mkdir, writeFile } from 'node:fs/promises';
+import { dirname, join } from 'node:path';
+import { lowerThirdSvg, anchorHeadlineSvg, motifSvg } from './render-local.js';
+import { elementOpacity, slideOffset, popScale, revealWordCount, countUpValue, gaugeProgress, frameCount, frameTime, } from './animate.js';
+/** Strip the outer `<svg>` wrapper so an element's content can be re-wrapped in a `<g>`. */
+function svgInner(svg) {
+    return svg.replace(/^\s*<svg[^>]*>/, '').replace(/<\/svg>\s*$/, '');
+}
+/** Wrap content with an opacity + optional transform group. */
+function group(content, opacity, transform) {
+    const tr = transform ? ` transform="${transform}"` : '';
+    return `<g opacity="${opacity.toFixed(3)}"${tr}>${content}</g>`;
+}
+/** SVG transform that scales by `s` about the point (cx,cy). */
+function scaleAbout(s, cx, cy) {
+    return `translate(${cx.toFixed(1)} ${cy.toFixed(1)}) scale(${s.toFixed(3)}) translate(${(-cx).toFixed(1)} ${(-cy).toFixed(1)})`;
+}
+/**
+ * Build the composite overlay SVG for one timestamp `t` — every active element with
+ * its animation applied. Pure & deterministic.
+ */
+export function animatedFrameSvg(t, dims, style, elements) {
+    const { width: W, height: H } = dims;
+    const motifCx = Math.round(W * 0.82);
+    const motifCy = Math.round(H * 0.22);
+    const parts = [];
+    for (const el of elements) {
+        const op = elementOpacity(t, el.start, el.end, 0.3);
+        if (op <= 0.001)
+            continue;
+        if (el.kind === 'lower-third') {
+            const words = el.text.split(/\s+/).filter(Boolean).length;
+            const visible = revealWordCount(t, el.start, el.end, words);
+            const dy = slideOffset(t, el.start, 0.35, 40);
+            const content = svgInner(lowerThirdSvg({ text: el.text }, dims, { ...style, visibleWords: visible }));
+            parts.push(group(content, op, `translate(0 ${dy.toFixed(1)})`));
+        }
+        else if (el.kind === 'stat') {
+            const value = countUpValue(t, el.start, 0.6, el.value);
+            const gauge = el.gauge !== undefined ? gaugeProgress(t, el.start, 0.7, el.gauge) : undefined;
+            const motif = { kind: 'stat', value: String(value), ...(el.unit ? { unit: el.unit } : {}), ...(gauge !== undefined ? { gauge } : {}), start: el.start, end: el.end };
+            const content = svgInner(motifSvg(motif, dims, style));
+            parts.push(group(content, op, scaleAbout(popScale(t, el.start, 0.4), motifCx, motifCy)));
+        }
+        else if (el.kind === 'icon') {
+            const content = svgInner(motifSvg(el.motif, dims, style));
+            parts.push(group(content, op, scaleAbout(popScale(t, el.start, 0.4), motifCx, motifCy)));
+        }
+        else {
+            // headline — pop in larger about its centre
+            const content = svgInner(anchorHeadlineSvg(el.word, dims, style));
+            parts.push(group(content, op, scaleAbout(popScale(t, el.start, 0.45, 0.82), W / 2, Math.round(H * 0.42))));
+        }
+    }
+    return `<svg xmlns="http://www.w3.org/2000/svg" width="${W}" height="${H}">${parts.join('')}</svg>`;
+}
+/** Pure: ffmpeg argv overlaying the rendered frame sequence onto the source at `fps`. */
+export function buildAnimateRenderArgs(sourceVideo, framePattern, fps, outputPath) {
+    return [
+        '-i',
+        sourceVideo,
+        '-framerate',
+        String(fps),
+        '-i',
+        framePattern,
+        '-filter_complex',
+        `[0:v]fps=${fps}[base];[base][1:v]overlay=shortest=1[v]`,
+        '-map',
+        '[v]',
+        '-map',
+        '0:a?',
+        '-c:v',
+        'libx264',
+        '-crf',
+        '18',
+        '-preset',
+        'fast',
+        '-pix_fmt',
+        'yuv420p',
+        '-r',
+        String(fps),
+        '-c:a',
+        'aac',
+        '-b:a',
+        '192k',
+        '-movflags',
+        '+faststart',
+        '-shortest',
+        outputPath,
+    ];
+}
+/**
+ * Render the animated overlay reel: rasterise one transparent frame per output frame
+ * (each the composite for that timestamp), then overlay the sequence on the source.
+ * Returns the frame paths written.
+ */
+export async function renderAnimatedOverlay(opts, deps) {
+    const fps = opts.fps ?? 30;
+    const rasterise = deps.rasterise ?? ((svg) => sharp(Buffer.from(svg)).png().toBuffer());
+    await mkdir(opts.frameDir, { recursive: true });
+    await mkdir(dirname(opts.outputPath), { recursive: true });
+    const n = frameCount(opts.durationSeconds, fps);
+    const paths = [];
+    for (let i = 0; i < n; i++) {
+        const svg = animatedFrameSvg(frameTime(i, fps), opts.dims, opts.style, opts.elements);
+        const png = await rasterise(svg);
+        const p = join(opts.frameDir, `frame_${String(i).padStart(5, '0')}.png`);
+        await writeFile(p, png);
+        paths.push(p);
+    }
+    await deps.ffmpeg(buildAnimateRenderArgs(opts.sourceVideo, join(opts.frameDir, 'frame_%05d.png'), fps, opts.outputPath));
+    return paths;
+}
+//# sourceMappingURL=animate-render.js.map

package/dist/video/motion-overlay/animate-render.js.map

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

package/dist/video/motion-overlay/animate.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Animation timing math for the per-frame overlay renderer.
+ *
+ * The static `render-local` path composites one PNG per element with a fade + slide.
+ * The animated path instead evaluates every overlay as a function of time `t` (in
+ * seconds) — entrance, word-by-word reveal, stat count-up, gauge fill, push-in — and
+ * rasterises one transparent frame per output frame, which ffmpeg overlays on the
+ * footage. Everything here is pure and unit-tested; the rasterise + ffmpeg run are
+ * injected by the caller (see `animate-render.ts`).
+ */
+export declare function clamp01(x: number): number;
+/** ease-out cubic — fast in, decelerate into rest (the Apple-ish settle). */
+export declare function easeOutCubic(t: number): number;
+/** ease-out back — a slight overshoot then settle (spring-like entrance). */
+export declare function easeOutBack(t: number): number;
+/** Opacity over an element's [start,end] window with symmetric fade in/out. */
+export declare function elementOpacity(t: number, start: number, end: number, fade?: number): number;
+/** Entrance slide offset in px (eased): `dist` at `start`, 0 once the entrance ends. */
+export declare function slideOffset(t: number, start: number, dur: number, dist: number): number;
+/** Entrance scale (eased, overshoot): `from` at `start`, settles to 1 over `dur`. */
+export declare function popScale(t: number, start: number, dur: number, from?: number): number;
+/** Slow push-in scale across the whole window: `from`→`to` (e.g. 1.0→1.02). */
+export declare function pushInScale(t: number, start: number, end: number, from?: number, to?: number): number;
+/**
+ * Word-by-word reveal: how many of `totalWords` are visible at `t`. Words appear
+ * across the first `leadFrac` of the window, then all hold. At least 1 once started.
+ */
+export declare function revealWordCount(t: number, start: number, end: number, totalWords: number, leadFrac?: number): number;
+/** Integer count-up 0→`target` over [start, start+dur], eased. */
+export declare function countUpValue(t: number, start: number, dur: number, target: number): number;
+/** Gauge fill 0→`targetPct` (0..1) over [start, start+dur], eased. */
+export declare function gaugeProgress(t: number, start: number, dur: number, targetPct: number): number;
+/** Number of frames for a clip of `durationSeconds` at `fps` (inclusive of frame 0). */
+export declare function frameCount(durationSeconds: number, fps: number): number;
+/** Timestamp (seconds) of frame index `i` at `fps`. */
+export declare function frameTime(i: number, fps: number): number;
+//# sourceMappingURL=animate.d.ts.map

package/dist/video/motion-overlay/animate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"animate.d.ts","sourceRoot":"","sources":["../../../src/video/motion-overlay/animate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,wBAAgB,OAAO,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAEzC;AAED,6EAA6E;AAC7E,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAG9C;AAED,6EAA6E;AAC7E,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAK7C;AAED,+EAA+E;AAC/E,wBAAgB,cAAc,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,SAAM,GAAG,MAAM,CAKxF;AAED,wFAAwF;AACxF,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAIvF;AAED,qFAAqF;AACrF,wBAAgB,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,SAAM,GAAG,MAAM,CAIlF;AAED,+EAA+E;AAC/E,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,SAAI,EAAE,EAAE,SAAO,GAAG,MAAM,CAI9F;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,SAAM,GAAG,MAAM,CAMjH;AAED,kEAAkE;AAClE,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAI1F;AAED,sEAAsE;AACtE,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAI9F;AAED,wFAAwF;AACxF,wBAAgB,UAAU,CAAC,eAAe,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAEvE;AAED,uDAAuD;AACvD,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAExD"}

package/dist/video/motion-overlay/animate.js

@@ -0,0 +1,97 @@
+/**
+ * Animation timing math for the per-frame overlay renderer.
+ *
+ * The static `render-local` path composites one PNG per element with a fade + slide.
+ * The animated path instead evaluates every overlay as a function of time `t` (in
+ * seconds) — entrance, word-by-word reveal, stat count-up, gauge fill, push-in — and
+ * rasterises one transparent frame per output frame, which ffmpeg overlays on the
+ * footage. Everything here is pure and unit-tested; the rasterise + ffmpeg run are
+ * injected by the caller (see `animate-render.ts`).
+ */
+export function clamp01(x) {
+    return x < 0 ? 0 : x > 1 ? 1 : x;
+}
+/** ease-out cubic — fast in, decelerate into rest (the Apple-ish settle). */
+export function easeOutCubic(t) {
+    const u = 1 - clamp01(t);
+    return 1 - u * u * u;
+}
+/** ease-out back — a slight overshoot then settle (spring-like entrance). */
+export function easeOutBack(t) {
+    const c1 = 1.70158;
+    const c3 = c1 + 1;
+    const u = clamp01(t) - 1;
+    return 1 + c3 * u * u * u + c1 * u * u;
+}
+/** Opacity over an element's [start,end] window with symmetric fade in/out. */
+export function elementOpacity(t, start, end, fade = 0.3) {
+    if (t <= start || t >= end)
+        return 0;
+    if (t < start + fade)
+        return clamp01((t - start) / fade);
+    if (t > end - fade)
+        return clamp01((end - t) / fade);
+    return 1;
+}
+/** Entrance slide offset in px (eased): `dist` at `start`, 0 once the entrance ends. */
+export function slideOffset(t, start, dur, dist) {
+    if (t <= start)
+        return dist;
+    if (t >= start + dur)
+        return 0;
+    return dist * (1 - easeOutCubic((t - start) / dur));
+}
+/** Entrance scale (eased, overshoot): `from` at `start`, settles to 1 over `dur`. */
+export function popScale(t, start, dur, from = 0.9) {
+    if (t <= start)
+        return from;
+    if (t >= start + dur)
+        return 1;
+    return from + (1 - from) * easeOutBack((t - start) / dur);
+}
+/** Slow push-in scale across the whole window: `from`→`to` (e.g. 1.0→1.02). */
+export function pushInScale(t, start, end, from = 1, to = 1.02) {
+    if (t <= start)
+        return from;
+    if (t >= end)
+        return to;
+    return from + (to - from) * clamp01((t - start) / (end - start));
+}
+/**
+ * Word-by-word reveal: how many of `totalWords` are visible at `t`. Words appear
+ * across the first `leadFrac` of the window, then all hold. At least 1 once started.
+ */
+export function revealWordCount(t, start, end, totalWords, leadFrac = 0.6) {
+    if (totalWords <= 0 || t <= start)
+        return 0;
+    const revealEnd = start + (end - start) * leadFrac;
+    if (t >= revealEnd || revealEnd <= start)
+        return totalWords;
+    const frac = (t - start) / (revealEnd - start);
+    return Math.min(totalWords, Math.max(1, Math.ceil(frac * totalWords)));
+}
+/** Integer count-up 0→`target` over [start, start+dur], eased. */
+export function countUpValue(t, start, dur, target) {
+    if (t <= start)
+        return 0;
+    if (t >= start + dur)
+        return target;
+    return Math.round(target * easeOutCubic((t - start) / dur));
+}
+/** Gauge fill 0→`targetPct` (0..1) over [start, start+dur], eased. */
+export function gaugeProgress(t, start, dur, targetPct) {
+    if (t <= start)
+        return 0;
+    if (t >= start + dur)
+        return targetPct;
+    return targetPct * easeOutCubic((t - start) / dur);
+}
+/** Number of frames for a clip of `durationSeconds` at `fps` (inclusive of frame 0). */
+export function frameCount(durationSeconds, fps) {
+    return Math.max(1, Math.ceil(durationSeconds * fps));
+}
+/** Timestamp (seconds) of frame index `i` at `fps`. */
+export function frameTime(i, fps) {
+    return i / fps;
+}
+//# sourceMappingURL=animate.js.map

package/dist/video/motion-overlay/animate.js.map

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