videoclaw 3.0.0-alpha.1

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

@@ -0,0 +1,172 @@
+/**
+ * FFmpeg ingest for motion-overlay.
+ *
+ * Thin side-effecting helpers over ffmpeg/ffprobe that the plan/execute layers
+ * call to break an input video into the pieces the composer needs:
+ *  - `probeVideo`        — duration (s) + width/height + derived aspect label.
+ *  - `extractAudio`      — pull the audio track to a standalone file.
+ *  - `cutTake`           — frame-accurate `-ss/-to` cut, re-encoded CRF18.
+ *  - `extractFrames`     — sample reference frames for `readFrameObservations`.
+ *  - `readFrameObservations` — heuristic + notes stub from the sampled frames.
+ *
+ * Every ffmpeg/ffprobe call routes through an injectable `IngestDeps` so tests
+ * run fully offline (no ffmpeg required) by supplying fakes. The defaults wrap
+ * the proven `assemble/ffmpeg.ts` spawn primitives + a small ffprobe shell-out.
+ */
+import { spawn } from 'node:child_process';
+import { ffprobeDuration, resolveFfprobeBin, runFfmpeg } from '../assemble/ffmpeg.js';
+/** Reduce a width:height pair to a tidy aspect label. */
+export function aspectLabel(width, height) {
+    if (width <= 0 || height <= 0)
+        return `${width}:${height}`;
+    const g = gcd(width, height);
+    const w = width / g;
+    const h = height / g;
+    // Snap the common 16:9 / 9:16 / 1:1 families even when the source is slightly
+    // off (e.g. 1080x1920 reduces cleanly, but 1080x1916 should still read 9:16).
+    const ratio = width / height;
+    if (Math.abs(ratio - 16 / 9) < 0.02)
+        return '16:9';
+    if (Math.abs(ratio - 9 / 16) < 0.02)
+        return '9:16';
+    if (Math.abs(ratio - 1) < 0.02)
+        return '1:1';
+    return `${w}:${h}`;
+}
+function gcd(a, b) {
+    let x = Math.abs(a);
+    let y = Math.abs(b);
+    while (y) {
+        [x, y] = [y, x % y];
+    }
+    return x || 1;
+}
+/** Default ffprobe-backed probe: duration (s) + the first video stream's w/h. */
+const defaultProbe = async (path) => {
+    const durationMs = await ffprobeDuration(path);
+    const { width, height } = await probeDimensions(path);
+    return { durationSeconds: durationMs / 1000, width, height };
+};
+/** Default ffmpeg runner: the real spawn path from assemble/ffmpeg.ts. */
+const defaultRunFfmpeg = async (args) => {
+    const { command } = await runFfmpeg(args);
+    return { command };
+};
+/** ffprobe the first video stream's pixel dimensions. */
+function probeDimensions(path) {
+    const bin = resolveFfprobeBin();
+    const args = [
+        '-v',
+        'error',
+        '-select_streams',
+        'v:0',
+        '-show_entries',
+        'stream=width,height',
+        '-of',
+        'csv=s=x:p=0',
+        path,
+    ];
+    return new Promise((resolve, reject) => {
+        const child = spawn(bin, args, { stdio: ['ignore', 'pipe', 'pipe'] });
+        let stdout = '';
+        let stderr = '';
+        child.stdout?.on('data', (c) => {
+            stdout += c.toString();
+        });
+        child.stderr?.on('data', (c) => {
+            stderr += c.toString();
+        });
+        child.on('error', (err) => reject(new Error(`Failed to spawn ffprobe: ${err.message}`)));
+        child.on('close', (code) => {
+            if (code !== 0) {
+                reject(new Error(`ffprobe exited ${code}: ${stderr.trim().slice(0, 300)}`));
+                return;
+            }
+            const match = stdout.trim().split('\n')[0]?.match(/^(\d+)x(\d+)$/);
+            if (!match) {
+                reject(new Error(`ffprobe returned unparseable dimensions: ${JSON.stringify(stdout.trim())}`));
+                return;
+            }
+            resolve({ width: Number(match[1]), height: Number(match[2]) });
+        });
+    });
+}
+/** Probe a video for duration + dimensions + aspect label. */
+export async function probeVideo(path, deps = {}) {
+    const probe = deps.probe ?? defaultProbe;
+    const { durationSeconds, width, height } = await probe(path);
+    return { durationSeconds, width, height, aspect: aspectLabel(width, height) };
+}
+/** Extract the input's audio track to `outPath` (copy codec, no re-encode). */
+export async function extractAudio(inputPath, outPath, deps = {}) {
+    const run = deps.runFfmpeg ?? defaultRunFfmpeg;
+    // -vn drops video; copy the audio stream as-is for fidelity (CRITICAL RULE 1).
+    return run(['-i', inputPath, '-vn', '-c:a', 'copy', outPath]);
+}
+/**
+ * Cut a take frame-accurately from `inputPath` between `start` and `end`
+ * (absolute seconds), re-encoding so the cut is exact (not keyframe-snapped).
+ * Matches the design spec: `-ss/-to -c:v libx264 -crf 18 -preset fast -c:a aac`.
+ */
+export async function cutTake(inputPath, start, end, outPath, deps = {}) {
+    const run = deps.runFfmpeg ?? defaultRunFfmpeg;
+    return run([
+        '-i',
+        inputPath,
+        '-ss',
+        String(start),
+        '-to',
+        String(end),
+        '-c:v',
+        'libx264',
+        '-crf',
+        '18',
+        '-preset',
+        'fast',
+        '-c:a',
+        'aac',
+        outPath,
+    ]);
+}
+/**
+ * Sample `count` reference frames evenly across `[0, durationSeconds)` to
+ * `<outDir>/frame_%02d.jpg`. Returns the relative-ish filenames produced (the
+ * caller owns the dir). One ffmpeg call using the `fps` filter.
+ */
+export async function extractFrames(inputPath, outDir, durationSeconds, count, deps = {}) {
+    const run = deps.runFfmpeg ?? defaultRunFfmpeg;
+    const n = Math.max(1, Math.floor(count));
+    // Sample at count/duration fps so we land ~n frames across the clip.
+    const fps = durationSeconds > 0 ? n / durationSeconds : 1;
+    const pattern = `${outDir}/frame_%02d.jpg`;
+    await run(['-i', inputPath, '-vf', `fps=${fps.toFixed(6)}`, '-frames:v', String(n), pattern]);
+    const names = [];
+    for (let i = 1; i <= n; i++) {
+        names.push(`frame_${String(i).padStart(2, '0')}.jpg`);
+    }
+    return names;
+}
+/**
+ * Derive `FrameObservations` from the sampled frames + the probe aspect.
+ *
+ * v1 is a deterministic heuristic stub: a portrait (9:16) talking-head is
+ * assumed centred; a landscape source is assumed to have the speaker on one
+ * side. It records a note about the untouchable region so the composer's GLOBAL
+ * RULES carry it through. Pure given its inputs — no image decoding (that is a
+ * later enhancement) — so it stays offline-testable.
+ */
+export function readFrameObservations(probe, frameFiles) {
+    const notes = [];
+    notes.push(`Reference frames sampled: ${frameFiles.length}.`);
+    let speakerSide;
+    if (probe.aspect === '9:16' || probe.aspect === '1:1') {
+        speakerSide = 'center';
+        notes.push('Vertical/square source: assume the speaker is centred; keep the central region untouched.');
+    }
+    else {
+        speakerSide = 'left';
+        notes.push('Landscape source: assume the speaker occupies one side; keep that region untouched.');
+    }
+    return { speakerSide, notes };
+}
+//# sourceMappingURL=ingest.js.map

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

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

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

@@ -0,0 +1,63 @@
+/**
+ * Concept → visual motif layer (the source skill's "visualize what's being said").
+ *
+ * Scans the transcript and, at the moment a concept is spoken, surfaces a matching
+ * **hairline icon** (money → `$`, team → people, launch → rocket, …) or an
+ * **infographic stat callout** (a number/percentage with a ring gauge). These are
+ * full-frame SVG overlays composited in the upper area by the local renderer, the
+ * same way the giant anchor headlines are — free, no provider, no moderation.
+ *
+ * Everything here is pure + deterministic and unit-tested. Icons are simple stroked
+ * geometry (no portraits, no bitmaps) so `sharp`/resvg renders them reliably.
+ */
+/** A detected motif and the window it pulses on. */
+export interface MotifMoment {
+    kind: 'icon' | 'stat';
+    /** icon id (kind === 'icon'). */
+    iconId?: string;
+    /** display number, e.g. "40" or "3" (kind === 'stat'). */
+    value?: string;
+    /** unit suffix, e.g. "%" (kind === 'stat'). */
+    unit?: string;
+    /** ring-gauge fill 0..1 (percentages; kind === 'stat'). */
+    gauge?: number;
+    /** small caption under the motif (a short concept tag). */
+    label?: string;
+    start: number;
+    end: number;
+}
+/**
+ * Detect the strongest motif per segment — a numeric **stat** (preferred when a
+ * number is present) or a concept **icon**. Returns at most `max` moments (one per
+ * segment), each pulsed on a short window at the spoken moment, so the reel doesn't
+ * clutter. Pure & deterministic.
+ */
+export declare function detectMotifs(segments: Array<{
+    start: number;
+    end: number;
+    text: string;
+}>, max?: number): MotifMoment[];
+/**
+ * Full-frame SVG for an **icon motif** — a hairline concept icon in the accent
+ * colour, centred in the upper third, with a small uppercase concept tag beneath.
+ * Pure & deterministic.
+ */
+export declare function iconMotifSvg(motif: MotifMoment, dims: {
+    width: number;
+    height: number;
+}, opts: {
+    accent: string;
+    labelFamily: string;
+}): string;
+/**
+ * Full-frame SVG for a **stat callout** — a big accent number (+ optional unit) with
+ * a ring gauge for percentages, centred in the upper third. Pure & deterministic.
+ */
+export declare function statMotifSvg(motif: MotifMoment, dims: {
+    width: number;
+    height: number;
+}, opts: {
+    accent: string;
+    numberFamily: string;
+}): string;
+//# sourceMappingURL=motifs.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"motifs.d.ts","sourceRoot":"","sources":["../../../src/video/motion-overlay/motifs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,oDAAoD;AACpD,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IACtB,iCAAiC;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,0DAA0D;IAC1D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+CAA+C;IAC/C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,2DAA2D;IAC3D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2DAA2D;IAC3D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACb;AAwCD;;;;;GAKG;AACH,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,KAAK,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,EAC7D,GAAG,SAAI,GACN,WAAW,EAAE,CAuCf;AAyCD;;;;GAIG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,WAAW,EAClB,IAAI,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,EACvC,IAAI,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GAC5C,MAAM,CAgBR;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,WAAW,EAClB,IAAI,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,EACvC,IAAI,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,GAC7C,MAAM,CAyBR"}

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

@@ -0,0 +1,192 @@
+/**
+ * Concept → visual motif layer (the source skill's "visualize what's being said").
+ *
+ * Scans the transcript and, at the moment a concept is spoken, surfaces a matching
+ * **hairline icon** (money → `$`, team → people, launch → rocket, …) or an
+ * **infographic stat callout** (a number/percentage with a ring gauge). These are
+ * full-frame SVG overlays composited in the upper area by the local renderer, the
+ * same way the giant anchor headlines are — free, no provider, no moderation.
+ *
+ * Everything here is pure + deterministic and unit-tested. Icons are simple stroked
+ * geometry (no portraits, no bitmaps) so `sharp`/resvg renders them reliably.
+ */
+/** Spelled-number → value (covers the common reel vocabulary). */
+const NUMBER_WORDS = {
+    one: 1, two: 2, three: 3, four: 4, five: 5, six: 6, seven: 7, eight: 8, nine: 9, ten: 10,
+    eleven: 11, twelve: 12, thirteen: 13, fourteen: 14, fifteen: 15, sixteen: 16, seventeen: 17,
+    eighteen: 18, nineteen: 19, twenty: 20, thirty: 30, forty: 40, fifty: 50, sixty: 60,
+    seventy: 70, eighty: 80, ninety: 90, hundred: 100, thousand: 1000, million: 1000000,
+};
+/**
+ * Concept keyword → icon. Ordered by priority (first match wins per segment). Each
+ * entry: [matcher, iconId, short tag label]. Stems are matched word-wise.
+ */
+const CONCEPT_ICONS = [
+    { re: /\b(revenue|sales?|profit|money|dollars?|earn(ed|ings)?|paid|pricing|price|income)\b/i, icon: 'dollar', label: 'REVENUE' },
+    { re: /\b(budget|cost|costs|spend|spent|cheap|expensive|free)\b/i, icon: 'wallet', label: 'COST' },
+    { re: /\b(grow(th|s|n)?|grew|jump(ed)?|rise|rising|rose|increase[ds]?|scal(e|ing|ed)|surg(e|ed)|boom(ed)?)\b/i, icon: 'trend', label: 'GROWTH' },
+    { re: /\b(team|teams|people|audience|users?|customers?|community|everyone|hire[ds]?|crew)\b/i, icon: 'people', label: 'PEOPLE' },
+    { re: /\b(ai|a\.i\.|agents?|bots?|robots?|model(s)?|intelligence|neural|automation|automate[ds]?)\b/i, icon: 'nodes', label: 'AI' },
+    { re: /\b(build|built|building|ship(ped|s)?|launch(ed|es)?|create[ds]?|made|make|produc(e|ed|tion))\b/i, icon: 'rocket', label: 'BUILD' },
+    { re: /\b(time|days?|weeks?|months?|years?|hours?|minutes?|fast|quick(ly)?|now|today|instant(ly)?)\b/i, icon: 'clock', label: 'TIME' },
+    { re: /\b(world|global(ly)?|everywhere|planet|earth|international|worldwide)\b/i, icon: 'globe', label: 'GLOBAL' },
+    { re: /\b(video|videos|watch(ing|ed)?|reel|reels|content|stream(ing)?|clip)\b/i, icon: 'play', label: 'VIDEO' },
+    { re: /\b(energy|power(ful)?|force|impact|strong|surge|boost|electric)\b/i, icon: 'bolt', label: 'POWER' },
+    { re: /\b(idea|ideas|think(ing)?|learn(ing|ed)?|knowledge|insight|smart|discover(y|ed)?)\b/i, icon: 'bulb', label: 'IDEA' },
+    { re: /\b(goal|goals|target|campaign|mission|aim|focus|win(ning)?)\b/i, icon: 'target', label: 'GOAL' },
+    { re: /\b(data|stats?|metrics?|numbers?|chart|analytics|results?|performance)\b/i, icon: 'bars', label: 'DATA' },
+    { re: /\b(secret|hidden|unknown|reveal(ed|s)?|behind|beneath|surface)\b/i, icon: 'eye', label: 'REVEAL' },
+    { re: /\b(ocean|sea|water|wave|waves|tide|deep)\b/i, icon: 'wave', label: 'OCEAN' },
+];
+/** Parse a number value from a token (digit or spelled word). Pure. */
+function numberFromToken(tok) {
+    const bare = tok.toLowerCase().replace(/[^a-z0-9]/g, '');
+    if (/^\d+$/.test(bare))
+        return Number(bare);
+    if (bare in NUMBER_WORDS)
+        return NUMBER_WORDS[bare];
+    return undefined;
+}
+/**
+ * Detect the strongest motif per segment — a numeric **stat** (preferred when a
+ * number is present) or a concept **icon**. Returns at most `max` moments (one per
+ * segment), each pulsed on a short window at the spoken moment, so the reel doesn't
+ * clutter. Pure & deterministic.
+ */
+export function detectMotifs(segments, max = 5) {
+    const out = [];
+    for (const seg of segments) {
+        if (out.length >= max)
+            break;
+        const tokens = seg.text.split(/\s+/);
+        let motif;
+        // 1. Stat: the first number token (+ a trailing percent/unit).
+        for (let i = 0; i < tokens.length; i++) {
+            const n = numberFromToken(tokens[i]);
+            if (n === undefined)
+                continue;
+            const next = (tokens[i + 1] ?? '').toLowerCase().replace(/[^a-z%]/g, '');
+            const isPct = next === 'percent' || tokens[i].includes('%');
+            motif = {
+                kind: 'stat',
+                value: String(n),
+                ...(isPct ? { unit: '%', gauge: Math.max(0, Math.min(1, n / 100)) } : {}),
+                start: seg.start + 0.15,
+                end: Math.min(seg.end, seg.start + 1.8),
+            };
+            break;
+        }
+        // 2. Else a concept icon.
+        if (!motif) {
+            const hit = CONCEPT_ICONS.find((c) => c.re.test(seg.text));
+            if (hit) {
+                motif = {
+                    kind: 'icon',
+                    iconId: hit.icon,
+                    label: hit.label,
+                    start: seg.start + 0.15,
+                    end: Math.min(seg.end, seg.start + 1.8),
+                };
+            }
+        }
+        if (motif)
+            out.push(motif);
+    }
+    return out;
+}
+/** Inner stroked geometry for each icon, drawn in a 0..100 box. Pure. */
+function iconGeometry(iconId, color) {
+    const s = `stroke="${color}" stroke-width="6" fill="none" stroke-linecap="round" stroke-linejoin="round"`;
+    switch (iconId) {
+        case 'trend':
+            return `<polyline points="8,72 38,46 58,60 92,22" ${s}/><polyline points="74,22 92,22 92,40" ${s}/>`;
+        case 'bars':
+            return `<rect x="14" y="58" width="16" height="30" ${s}/><rect x="42" y="40" width="16" height="48" ${s}/><rect x="70" y="22" width="16" height="66" ${s}/>`;
+        case 'dollar':
+            return `<circle cx="50" cy="50" r="40" ${s}/><path d="M62 34 C62 28 56 24 50 24 C42 24 38 30 38 36 C38 50 64 46 64 62 C64 70 58 76 50 76 C42 76 36 72 36 64" ${s}/><line x1="50" y1="18" x2="50" y2="82" ${s}/>`;
+        case 'wallet':
+            return `<rect x="14" y="28" width="72" height="48" rx="8" ${s}/><path d="M64 46 h26 v12 h-26 a6 6 0 0 1 0-12 z" ${s}/>`;
+        case 'people':
+            return `<circle cx="36" cy="34" r="14" ${s}/><path d="M14 80 C14 62 26 54 36 54 C46 54 58 62 58 80" ${s}/><circle cx="70" cy="40" r="11" ${s}/><path d="M62 56 C72 56 86 62 86 80" ${s}/>`;
+        case 'nodes':
+            return `<circle cx="24" cy="30" r="9" ${s}/><circle cx="78" cy="26" r="9" ${s}/><circle cx="50" cy="68" r="9" ${s}/><circle cx="20" cy="74" r="8" ${s}/><line x1="31" y1="34" x2="71" y2="29" ${s}/><line x1="29" y1="36" x2="46" y2="61" ${s}/><line x1="74" y1="33" x2="55" y2="61" ${s}/><line x1="27" y1="71" x2="43" y2="69" ${s}/>`;
+        case 'rocket':
+            return `<path d="M50 12 C66 24 70 44 64 66 H36 C30 44 34 24 50 12 z" ${s}/><circle cx="50" cy="40" r="8" ${s}/><path d="M36 60 L22 74 L34 70 M64 60 L78 74 L66 70" ${s}/><path d="M44 66 L44 82 M56 66 L56 82" ${s}/>`;
+        case 'clock':
+            return `<circle cx="50" cy="50" r="40" ${s}/><line x1="50" y1="50" x2="50" y2="26" ${s}/><line x1="50" y1="50" x2="68" y2="58" ${s}/>`;
+        case 'globe':
+            return `<circle cx="50" cy="50" r="40" ${s}/><ellipse cx="50" cy="50" rx="18" ry="40" ${s}/><line x1="10" y1="50" x2="90" y2="50" ${s}/><line x1="16" y1="30" x2="84" y2="30" ${s}/><line x1="16" y1="70" x2="84" y2="70" ${s}/>`;
+        case 'play':
+            return `<rect x="14" y="22" width="72" height="56" rx="12" ${s}/><path d="M44 40 L62 50 L44 60 z" stroke="${color}" stroke-width="6" fill="${color}" stroke-linejoin="round"/>`;
+        case 'bolt':
+            return `<path d="M56 10 L26 56 H48 L42 90 L76 40 H52 z" stroke="${color}" stroke-width="6" fill="none" stroke-linejoin="round"/>`;
+        case 'bulb':
+            return `<path d="M50 16 C66 16 78 28 78 44 C78 56 70 62 64 70 H36 C30 62 22 56 22 44 C22 28 34 16 50 16 z" ${s}/><line x1="38" y1="80" x2="62" y2="80" ${s}/><line x1="42" y1="90" x2="58" y2="90" ${s}/>`;
+        case 'target':
+            return `<circle cx="50" cy="50" r="38" ${s}/><circle cx="50" cy="50" r="22" ${s}/><circle cx="50" cy="50" r="6" stroke="${color}" stroke-width="6" fill="${color}"/>`;
+        case 'eye':
+            return `<path d="M10 50 C26 26 74 26 90 50 C74 74 26 74 10 50 z" ${s}/><circle cx="50" cy="50" r="14" ${s}/>`;
+        case 'wave':
+            return `<path d="M8 44 C20 30 28 30 40 44 C52 58 60 58 72 44 C80 35 86 35 92 40" ${s}/><path d="M8 64 C20 50 28 50 40 64 C52 78 60 78 72 64 C80 55 86 55 92 60" ${s}/>`;
+        default:
+            return `<circle cx="50" cy="50" r="38" ${s}/>`;
+    }
+}
+/**
+ * Full-frame SVG for an **icon motif** — a hairline concept icon in the accent
+ * colour, centred in the upper third, with a small uppercase concept tag beneath.
+ * Pure & deterministic.
+ */
+export function iconMotifSvg(motif, dims, opts) {
+    const { width: W, height: H } = dims;
+    const box = Math.round(Math.min(W, H) * 0.14);
+    // Upper-right "stat bug" position — clears a centred talking-head / avatar face.
+    const cx = Math.round(W * 0.82);
+    const cy = Math.round(H * 0.22);
+    const x0 = cx - box / 2;
+    const y0 = cy - box / 2;
+    const label = (motif.label ?? '').toUpperCase();
+    const labelSvg = label
+        ? `<text x="${cx}" y="${cy + box / 2 + 40}" text-anchor="middle" font-family="${opts.labelFamily}" font-size="26" fill="${opts.accent}" letter-spacing="3">${esc(label)}</text>`
+        : '';
+    return `<svg xmlns="http://www.w3.org/2000/svg" width="${W}" height="${H}">
+  <g transform="translate(${x0},${y0}) scale(${box / 100})">${iconGeometry(motif.iconId ?? '', opts.accent)}</g>
+  ${labelSvg}
+</svg>`;
+}
+/**
+ * Full-frame SVG for a **stat callout** — a big accent number (+ optional unit) with
+ * a ring gauge for percentages, centred in the upper third. Pure & deterministic.
+ */
+export function statMotifSvg(motif, dims, opts) {
+    const { width: W, height: H } = dims;
+    // Upper-right "stat bug" position — clears a centred talking-head / avatar face.
+    const cx = Math.round(W * 0.82);
+    const cy = Math.round(H * 0.22);
+    const hasGauge = motif.gauge !== undefined;
+    const r = Math.round(Math.min(W, H) * 0.095);
+    const value = `${motif.value ?? ''}${motif.unit ?? ''}`;
+    // Plain numbers read bigger (no ring competing); percentages sit inside the ring.
+    const fontSize = hasGauge ? Math.round(r * 0.86) : Math.round(Math.min(W, H) * 0.1);
+    let deco = '';
+    if (hasGauge) {
+        const circ = 2 * Math.PI * r;
+        const fill = circ * Math.max(0, Math.min(1, motif.gauge));
+        deco = `<circle cx="${cx}" cy="${cy}" r="${r}" fill="none" stroke="rgba(255,255,255,0.18)" stroke-width="10"/>
+  <circle cx="${cx}" cy="${cy}" r="${r}" fill="none" stroke="${opts.accent}" stroke-width="10" stroke-linecap="round" stroke-dasharray="${fill.toFixed(1)} ${circ.toFixed(1)}" transform="rotate(-90 ${cx} ${cy})"/>`;
+    }
+    else {
+        // A thin accent underline turns a lone number into an infographic beat.
+        const half = Math.round(fontSize * 0.42);
+        deco = `<rect x="${cx - half}" y="${cy + fontSize * 0.34}" width="${half * 2}" height="6" rx="3" fill="${opts.accent}"/>`;
+    }
+    return `<svg xmlns="http://www.w3.org/2000/svg" width="${W}" height="${H}">
+  ${deco}
+  <text x="${cx}" y="${cy + fontSize / 3}" text-anchor="middle" font-family="${opts.numberFamily}" font-size="${fontSize}" font-weight="800" fill="${opts.accent}">${esc(value)}</text>
+</svg>`;
+}
+/** Local XML escaper (kept independent of render-local to avoid a cycle). */
+function esc(t) {
+    return t.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;').replace(/"/g, '&quot;').replace(/'/g, '&apos;');
+}
+//# sourceMappingURL=motifs.js.map

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

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

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

@@ -0,0 +1,56 @@
+/**
+ * Pure motion-style registry + concept→animation metaphor map.
+ *
+ * Three styles, each a {accent, visualBlock, motionBlock} record:
+ *  - `apple-clean`     — ported verbatim from the source skill (Apple-keynote
+ *    minimalism with tactile materiality).
+ *  - `editorial-dark`  — genericized from the source skill's "CODA Dark"
+ *    (manifesto / punchline editorial poster aesthetic). CRITICAL: the prose
+ *    carries NO numeric specs, hex codes, or font-family names (CRITICAL
+ *    RULE 2 — those leak as on-screen text). The accent is a configurable
+ *    field, never baked into the prose.
+ *  - `knowledge-tool`  — genericized from the source skill's "Brain Clone"
+ *    (dark-academia / knowledge-graph look). Same no-specs prose discipline.
+ *
+ * The accent default lives in `MOTION_STYLES[id].accent`; `resolveStyle` lets a
+ * caller override it (`--accent`) or supply a brand profile (`--brand`, which
+ * takes precedence over `--accent`).
+ *
+ * Pure: no I/O. Deterministic.
+ */
+import type { MotionStyleId, ResolvedStyle } from './types.js';
+export interface MotionStyleDef {
+    accent: string;
+    visualBlock: string;
+    motionBlock: string;
+}
+/**
+ * Style registry. The visual/motion prose is what gets sent to Omni, so it must
+ * stay free of any technical metadata (CRITICAL RULE 2). The accent is held
+ * separately as a hex value and is resolved into a HUMAN-NAMED colour at compose
+ * time — it never appears as a hex string in the prompt.
+ */
+export declare const MOTION_STYLES: Record<MotionStyleId, MotionStyleDef>;
+export interface ResolveStyleOptions {
+    /** Override the style's default accent (e.g. `--accent #00AAFF`). */
+    accent?: string;
+    /** Brand profile: its accent wins over both the style default AND `accent`. */
+    brand?: {
+        accent?: string;
+    };
+}
+/**
+ * Resolve a style id + optional accent/brand overrides into a `ResolvedStyle`.
+ *
+ * Accent precedence (highest first): `brand.accent` → `accent` → style default.
+ * Pure: returns a fresh object; never mutates the registry.
+ */
+export declare function resolveStyle(id: MotionStyleId, opts?: ResolveStyleOptions): ResolvedStyle;
+/**
+ * Resolve a single concept word to animation prose. Concrete → hairline icon;
+ * abstract → material metaphor; unknown abstract-ish words fall back to a
+ * generic light metaphor and unknown concrete-ish words to a generic hairline
+ * icon. Lookup is case-insensitive on the trimmed concept.
+ */
+export declare function conceptAnimation(concept: string): string;
+//# sourceMappingURL=motion-style.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"motion-style.d.ts","sourceRoot":"","sources":["../../../src/video/motion-overlay/motion-style.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE/D,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;;GAKG;AACH,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,aAAa,EAAE,cAAc,CA2B/D,CAAC;AAEF,MAAM,WAAW,mBAAmB;IAClC,qEAAqE;IACrE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,+EAA+E;IAC/E,KAAK,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC7B;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,EAAE,EAAE,aAAa,EAAE,IAAI,GAAE,mBAAwB,GAAG,aAAa,CAY7F;AAsDD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAYxD"}