videoclaw 3.0.0-alpha.1

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

@@ -0,0 +1,130 @@
+/**
+ * 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.
+ */
+/**
+ * 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 const MOTION_STYLES = {
+    // ── apple-clean — ported verbatim from the source skill ──────────────────
+    'apple-clean': {
+        accent: '#FF5000',
+        visualBlock: 'Style: Apple-keynote minimalism with tactile materiality. Cards are dark frosted glass — they should feel like physical sheets of darkened glass with subtle refraction of the footage visible through them, not flat digital rectangles. Very soft rounded corners, a barely-visible hairline white edge that catches light like a real material seam, and a soft weighted drop shadow suggesting the card is floating slightly above the background. Text is clean modern white sans-serif, mostly sentence case, with category labels in uppercase. Typography itself behaves like an actor: each headline word feels deliberate, with tracking that breathes (slightly tighter on entry, settling into final spacing). The only accent colour is the configured accent — used SOLELY for the asterisk character (*) following key words, or as a thin underline below a single emphasized phrase. Never use the accent to fill or colour entire words; the accent is a beat marker, not decoration. Icons are pure white hairline outlines, never filled, never glowing. Backgrounded elements (cards no longer in focus) carry a subtle depth-of-field blur — the foreground is sharp, the background softens, like a cinematic lens.',
+        motionBlock: 'Motion: Slow, confident, premium — like an Apple product reveal directed with a real camera. Cards and headlines enter with a soft glide that decelerates into rest, NEVER linear motion — always settling under their own weight. Active camera movement is essential: elements use push-in and pull-out as if a slow cinematic lens is approaching and retreating. While an element holds on screen, it carries a slow gentle push-in — scaling up subtly over a beat, as if the camera is moving closer. When an element exits, it pulls back and slips into soft depth-of-field blur, shrinking slightly as it recedes. On key beats (asterisks, numbers, anchor words), a brief emphasis pulse hits the element — a quick scale up and settle that punctuates the rhythm. Idle elements carry a barely-perceptible parallax drift, suggesting the camera is never fully locked, always breathing slightly. Text reveals word by word with a small upward offset; on headline-anchor words (large dominant text), the letter tracking is slightly tight on entry and breathes outward into final spacing as the word settles — letters exhaling into place. Crossfades are smooth, outgoing elements fading while pulling back and slipping out of focus. Icons appear via stroke-on draw animation — lines drawing themselves like a pen on paper, never popping in. Kinetic typography mixes with cards: the speaker\'s anchor words appear as giant headline text dominating the frame, sometimes alone, sometimes alongside an icon — never let a take be only cards with icon labels; intersperse with at least one giant headline-anchor moment that syncs with the speaker\'s emphasis. Critical pacing principle: when the speaker pauses or breathes between sentences, the visual STOPS too — hold the current state silent and still during that beat. Silence before a reveal is more powerful than continuous animation. No bouncy springs, no whip pans, no pop-in, no constant motion filling every second. Subtle motion blur on all transforms.',
+    },
+    // ── editorial-dark — genericized from "CODA Dark" (no specs / no fonts) ───
+    'editorial-dark': {
+        accent: '#FF5000',
+        visualBlock: 'Style: Editorial dark manifesto — high-contrast poster typography in motion. Cards are solid deep-black surfaces with sharp, squared corners, no rounding — an editorial, decisive feel rather than a soft product look. Typography is a bold, condensed grotesque sans-serif set in uppercase with tight tracking and a low, punchy line height, treated like a magazine cover headline. The only accent colour is the configured accent, used SOLELY for a small asterisk (*) after each headline and for a thin underline on key shapes — never to fill whole words. Icons are minimal hairline strokes in the accent on key shapes only. A weighted drop shadow gives each black card real heft so it reads as a stacked poster panel floating above the frame. The overall feeling is a printed manifesto poster brought to life: stark, confident, punchline-driven, generous negative space around a single dominant statement.',
+        motionBlock: 'Motion: Snappy, decisive, high-contrast — an editorial poster animated. Cards and headlines enter fast and crisp, then settle without bounce, NEVER linear motion. Headlines snap in word by word in quick succession, each word landing with a confident stop. Exits are a quick fade with a small upward drift, the panel slipping away cleanly. There is still a real camera: a subtle push-in while a statement holds, a slight pull-back on exit, and a brief emphasis pulse on the asterisk or a key number to mark the beat. Idle panels carry a barely-perceptible parallax drift. Keep the rhythm decisive and poster-like rather than soft and floaty. Kinetic typography dominates: anchor words from the speech appear as giant uppercase headlines filling the frame, sometimes alone, sometimes with one hairline icon — never a take that is only icon-labelled cards. Critical pacing principle: when the speaker pauses, the visual STOPS too — hold the current panel silent and still during that beat. Silence before a reveal lands harder than constant motion. No springs, no whip pans, no pop-in clutter.',
+    },
+    // ── knowledge-tool — genericized from "Brain Clone" (no specs / no fonts) ─
+    'knowledge-tool': {
+        accent: '#A78BFA',
+        visualBlock: 'Style: Dark-academia digital meeting a knowledge-graph aesthetic — a knowledge-tool look, not generic motion graphics. Cards are deep near-black surfaces with the slightest cool blue undertone (never pure black), with very subtle hairline edges and a soft weighted shadow suggesting weight. Two typographic worlds intermix: headline anchors use a classical editorial serif — italic-capable, manuscript-like, the kind of letterforms on the cover of an old hardcover book; card labels and sublines use a clean modern sans-serif; small technical brackets and timestamps use a monospace typewriter-style face like an editor label. The only accent colour is the configured accent — a soft, calm lavender, never neon, never magenta — used SOLELY for the asterisk character (*) after key words and occasionally a thin underline. The asterisks have a slightly hand-drawn, brushy quality, like an ink stroke rather than a perfectly geometric character. The accent is a beat marker, never decoration. Icons are clean hairline outlines in soft, slightly cool off-white. Backgrounded elements carry depth-of-field blur. The composition feels like a knowledge tool: editorial magazine layout, generous negative space, considered hierarchy — not a slick product ad.',
+        motionBlock: 'Motion: Slow, contemplative, scholarly — directed like a documentary about a thinker\'s notebook rather than a product reveal. Cards and headlines enter with a soft glide that decelerates into rest, NEVER linear motion. Active cinematic camera: a slow push-in during a hold, as if a lens is approaching a page; a pull-out on exit where the element shrinks slightly and slips into soft depth-of-field blur; an emphasis pulse on key beats (asterisks, anchor words) — a quick scale up and settle. Idle elements carry a barely-perceptible parallax drift. The serif headline letters enter with tracking slightly tight, then breathe outward into final spacing as the word settles — letters exhaling like the word is being read aloud and considered. The brushy accent asterisk lands distinct from the word, a beat marker punctuating thought. Icons appear via stroke-on draw animation, lines forming like ink on paper. Kinetic typography mixes with cards: anchor words appear as giant serif headlines dominating the frame, sometimes alone, sometimes alongside an icon — never a take that is only cards with icon labels. Critical pacing principle: when the speaker pauses, the visual STOPS too — hold silent and still. Silence before a reveal is more powerful than continuous motion. The overall feeling: a quiet, deliberate study session, premium and considered.',
+    },
+};
+/**
+ * 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 function resolveStyle(id, opts = {}) {
+    const def = MOTION_STYLES[id];
+    if (!def) {
+        throw new Error(`resolveStyle: unknown style "${id}"`);
+    }
+    const accent = opts.brand?.accent ?? opts.accent ?? def.accent;
+    return {
+        id,
+        accent,
+        visualBlock: def.visualBlock,
+        motionBlock: def.motionBlock,
+    };
+}
+/**
+ * Concept → animation prose.
+ *
+ * Concrete concepts (real-world objects) map to minimalist hairline-icon prose;
+ * abstract concepts (states/processes — AI, clones, intelligence, insight) map
+ * to a MATERIAL METAPHOR (particles / grids / light), never a generic hairline
+ * icon (which reads weak for an abstract idea). Pure — returns prose with no
+ * numeric specs.
+ */
+const CONCRETE_ICONS = {
+    carousel: 'three staggered diagonal portrait rectangles, like a deck of slides fanned out',
+    slides: 'three staggered diagonal portrait rectangles, like a deck of slides fanned out',
+    website: 'a browser window outline with three dots in the top-left and a few horizontal content lines',
+    'web page': 'a browser window outline with three dots in the top-left and a few horizontal content lines',
+    app: 'the hairline outline of a vertical phone with a small notch',
+    application: 'the hairline outline of a vertical phone with a small notch',
+    code: 'a window outline holding a few lines of code suggested as hairlines with varied indentation',
+    programming: 'a window outline holding a few lines of code suggested as hairlines with varied indentation',
+    chat: 'two stacked speech bubbles, one showing typing dots',
+    conversation: 'two stacked speech bubbles, one showing typing dots',
+    money: 'a currency mark inside a hairline circle',
+    revenue: 'a currency mark inside a hairline circle',
+    time: 'a clock outline with slim hands',
+    fast: 'a clock outline with slim hands',
+    data: 'a hairline bar chart with a few rising bars',
+    analytics: 'a hairline bar chart with a few rising bars',
+    vault: 'a hexagonal outline with a central dot and radial lines',
+    obsidian: 'a hexagonal outline with a central dot and radial lines',
+};
+const ABSTRACT_METAPHORS = {
+    ai: 'soft white particles drifting upward, slowly coalescing into a brain-like silhouette outlined in hairlines, with a subtle inner glow',
+    intelligence: 'soft white particles drifting upward, slowly coalescing into a brain-like silhouette outlined in hairlines, with a subtle inner glow',
+    thinking: 'soft white particles drifting upward, slowly coalescing into a brain-like silhouette outlined in hairlines, with a subtle inner glow',
+    clone: 'thin hairline lines drawing themselves one by one between scattered white dots, forming a network constellation that settles into a stable graph',
+    clones: 'thin hairline lines drawing themselves one by one between scattered white dots, forming a network constellation that settles into a stable graph',
+    sources: 'thin hairline lines drawing themselves one by one between scattered white dots, forming a network constellation that settles into a stable graph',
+    knowledge: 'thin hairline lines drawing themselves one by one between scattered white dots, forming a network constellation that settles into a stable graph',
+    insight: 'a soft warm-white bloom of light expanding outward from a central point, then settling into a clean centred headline as the light fades',
+    reveal: 'a soft warm-white bloom of light expanding outward from a central point, then settling into a clean centred headline as the light fades',
+    answer: 'a soft warm-white bloom of light expanding outward from a central point, then settling into a clean centred headline as the light fades',
+    agent: 'interconnected nodes with one node pulsing softly, suggesting a continuous process — gentle, not mechanical',
+    automation: 'interconnected nodes with one node pulsing softly, suggesting a continuous process — gentle, not mechanical',
+    processing: 'particles flowing into a structured grid that locks into place line by line, then settles',
+    analysis: 'particles flowing into a structured grid that locks into place line by line, then settles',
+};
+/**
+ * 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 function conceptAnimation(concept) {
+    const key = concept.trim().toLowerCase();
+    if (key in ABSTRACT_METAPHORS) {
+        return ABSTRACT_METAPHORS[key];
+    }
+    if (key in CONCRETE_ICONS) {
+        return CONCRETE_ICONS[key];
+    }
+    // Unknown: keep the concrete default (a hairline icon). Abstract concepts the
+    // map doesn't know about should be added rather than guessed at — a hairline
+    // icon is the safer generic than an over-specific metaphor.
+    return `a minimalist hairline icon representing "${concept.trim()}"`;
+}
+//# sourceMappingURL=motion-style.js.map

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

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

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

@@ -0,0 +1,49 @@
+/**
+ * Pure motion-overlay plan assembler.
+ *
+ * `buildMotionOverlayPlan` composes a `MotionOverlayPlan` (`schemaVersion: 1`)
+ * from already-computed inputs: the input probe, the resolved style, the take
+ * splits, each take's analysis, and each take's composed prompt. It performs NO
+ * I/O and NO provider/ffmpeg/STT calls — those happen upstream (transcribe,
+ * slice, analyze-reel, compose-prompt) and are passed in. This keeps the
+ * manifest shape deterministic and unit-testable.
+ *
+ * The per-take `file` / `promptFile` paths are the work-folder-relative names
+ * (`takes/…mp4`, `prompts/…md`) the `write.ts` emitter will produce; this module
+ * only names them, it does not write them.
+ */
+import type { MotionLayout, MotionOverlayPlan, MotionStyleId, TakeAnalysis, TakeSplit } from './types.js';
+export interface BuildMotionOverlayPlanArgs {
+    input: {
+        path: string;
+        durationSeconds: number;
+        width: number;
+        height: number;
+        aspect: string;
+    };
+    layout: MotionLayout;
+    style: MotionStyleId;
+    /** Resolved accent (hex or already-resolved name) recorded on the manifest. */
+    accent: string;
+    language: string;
+    /** Work-folder path (absolute or relative; recorded verbatim). */
+    workdir: string;
+    /** The take splits (one per output clip), in order. */
+    splits: TakeSplit[];
+    /** Per-take analysis, parallel to `splits` (keyed by index). */
+    analyses: TakeAnalysis[];
+    /** Per-take composed prompts, parallel to `splits` (keyed by index). */
+    prompts: string[];
+}
+/** Build the work-folder-relative take clip filename for a take. */
+export declare function takeFileName(split: TakeSplit): string;
+/** Build the work-folder-relative prompt markdown filename for a take. */
+export declare function takePromptFileName(split: TakeSplit): string;
+/** Shared stem, e.g. `take-01_0s-10s` (1-based index, whole-second bounds). */
+export declare function takeStem(split: TakeSplit): string;
+/**
+ * Assemble the `MotionOverlayPlan`. Pure. Throws if the analyses/prompts arrays
+ * don't line up with the splits (a programmer error, surfaced loudly).
+ */
+export declare function buildMotionOverlayPlan(args: BuildMotionOverlayPlanArgs): MotionOverlayPlan;
+//# sourceMappingURL=plan.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"plan.d.ts","sourceRoot":"","sources":["../../../src/video/motion-overlay/plan.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EACV,YAAY,EACZ,iBAAiB,EACjB,aAAa,EAEb,YAAY,EACZ,SAAS,EACV,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,0BAA0B;IACzC,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,eAAe,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAChG,MAAM,EAAE,YAAY,CAAC;IACrB,KAAK,EAAE,aAAa,CAAC;IACrB,+EAA+E;IAC/E,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,kEAAkE;IAClE,OAAO,EAAE,MAAM,CAAC;IAChB,uDAAuD;IACvD,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,gEAAgE;IAChE,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,wEAAwE;IACxE,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,oEAAoE;AACpE,wBAAgB,YAAY,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,CAErD;AAED,0EAA0E;AAC1E,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,CAE3D;AAED,+EAA+E;AAC/E,wBAAgB,QAAQ,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,CAKjD;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,0BAA0B,GAAG,iBAAiB,CA2C1F"}

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

@@ -0,0 +1,79 @@
+/**
+ * Pure motion-overlay plan assembler.
+ *
+ * `buildMotionOverlayPlan` composes a `MotionOverlayPlan` (`schemaVersion: 1`)
+ * from already-computed inputs: the input probe, the resolved style, the take
+ * splits, each take's analysis, and each take's composed prompt. It performs NO
+ * I/O and NO provider/ffmpeg/STT calls — those happen upstream (transcribe,
+ * slice, analyze-reel, compose-prompt) and are passed in. This keeps the
+ * manifest shape deterministic and unit-testable.
+ *
+ * The per-take `file` / `promptFile` paths are the work-folder-relative names
+ * (`takes/…mp4`, `prompts/…md`) the `write.ts` emitter will produce; this module
+ * only names them, it does not write them.
+ */
+/** Build the work-folder-relative take clip filename for a take. */
+export function takeFileName(split) {
+    return `takes/${takeStem(split)}.mp4`;
+}
+/** Build the work-folder-relative prompt markdown filename for a take. */
+export function takePromptFileName(split) {
+    return `prompts/${takeStem(split)}.md`;
+}
+/** Shared stem, e.g. `take-01_0s-10s` (1-based index, whole-second bounds). */
+export function takeStem(split) {
+    const n = String(split.index + 1).padStart(2, '0');
+    const start = Math.round(split.start);
+    const end = Math.round(split.end);
+    return `take-${n}_${start}s-${end}s`;
+}
+/**
+ * Assemble the `MotionOverlayPlan`. Pure. Throws if the analyses/prompts arrays
+ * don't line up with the splits (a programmer error, surfaced loudly).
+ */
+export function buildMotionOverlayPlan(args) {
+    const { splits, analyses, prompts } = args;
+    if (analyses.length !== splits.length) {
+        throw new Error(`buildMotionOverlayPlan: ${splits.length} splits but ${analyses.length} analyses.`);
+    }
+    if (prompts.length !== splits.length) {
+        throw new Error(`buildMotionOverlayPlan: ${splits.length} splits but ${prompts.length} prompts.`);
+    }
+    const takes = splits.map((split, i) => {
+        const analysis = analyses[i];
+        if (!analysis || analysis.index !== split.index) {
+            throw new Error(`buildMotionOverlayPlan: analysis ${i} does not match split index ${split.index}.`);
+        }
+        const prompt = prompts[i];
+        return {
+            index: split.index,
+            start: split.start,
+            end: split.end,
+            durationSeconds: round(split.end - split.start),
+            file: takeFileName(split),
+            promptFile: takePromptFileName(split),
+            anatomy: analysis.anatomy,
+            prompt,
+        };
+    });
+    return {
+        schemaVersion: 1,
+        input: {
+            path: args.input.path,
+            durationSeconds: args.input.durationSeconds,
+            width: args.input.width,
+            height: args.input.height,
+            aspect: args.input.aspect,
+        },
+        layout: args.layout,
+        style: args.style,
+        accent: args.accent,
+        language: args.language,
+        workdir: args.workdir,
+        takes,
+    };
+}
+function round(n) {
+    return Math.round(n * 1000) / 1000;
+}
+//# sourceMappingURL=plan.js.map

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

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

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

@@ -0,0 +1,36 @@
+/**
+ * Motion-overlay review surface (Phase 3).
+ *
+ * Renders a finished `MotionOverlayPlan` into a standalone, self-contained
+ * `review/review.html` approval surface — the **contract** the operator signs
+ * off before any provider spend. Each take card shows:
+ *   - the take clip filename + reel beat (anatomy),
+ *   - the take's anatomy / span / duration,
+ *   - the FULL composed prompt that will be sent to Omni Flash V2V verbatim.
+ *
+ * It reuses the preview-portal's `PORTAL_CSS` (including its aspect-aware media
+ * classes via `body[data-aspect]`) for visual consistency, but it does NOT go
+ * through the portal's project-discovery `render.ts` — that surface is driven by
+ * on-disk project assets, whereas motion-overlay renders straight from the
+ * deterministic plan manifest. Pure string assembly except for the single
+ * file write in `writeMotionOverlayReview`.
+ */
+import type { MotionOverlayPlan } from './types.js';
+export interface RenderMotionOverlayReviewResult {
+    /** Absolute path to the emitted review.html. */
+    reviewPath: string;
+    /** The full rendered HTML (returned for tests / callers that want it inline). */
+    html: string;
+}
+/**
+ * Render the plan into the review HTML string. Pure — no I/O. The aspect
+ * (`plan.input.aspect`) drives `body[data-aspect]` so portrait/square clips get
+ * tall cards via PORTAL_CSS's aspect-aware rules.
+ */
+export declare function renderMotionOverlayReview(plan: MotionOverlayPlan): string;
+/**
+ * Render the plan into `<workdir>/review/review.html` and return its path + html.
+ * Creates the `review/` dir if needed. The only side effect.
+ */
+export declare function writeMotionOverlayReview(workdir: string, plan: MotionOverlayPlan): Promise<RenderMotionOverlayReviewResult>;
+//# sourceMappingURL=preview.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"preview.d.ts","sourceRoot":"","sources":["../../../src/video/motion-overlay/preview.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAKH,OAAO,KAAK,EAAE,iBAAiB,EAAc,MAAM,YAAY,CAAC;AAEhE,MAAM,WAAW,+BAA+B;IAC9C,gDAAgD;IAChD,UAAU,EAAE,MAAM,CAAC;IACnB,iFAAiF;IACjF,IAAI,EAAE,MAAM,CAAC;CACd;AAWD;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,iBAAiB,GAAG,MAAM,CAiDzE;AAED;;;GAGG;AACH,wBAAsB,wBAAwB,CAC5C,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,iBAAiB,GACtB,OAAO,CAAC,+BAA+B,CAAC,CAO1C"}

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

@@ -0,0 +1,169 @@
+/**
+ * Motion-overlay review surface (Phase 3).
+ *
+ * Renders a finished `MotionOverlayPlan` into a standalone, self-contained
+ * `review/review.html` approval surface — the **contract** the operator signs
+ * off before any provider spend. Each take card shows:
+ *   - the take clip filename + reel beat (anatomy),
+ *   - the take's anatomy / span / duration,
+ *   - the FULL composed prompt that will be sent to Omni Flash V2V verbatim.
+ *
+ * It reuses the preview-portal's `PORTAL_CSS` (including its aspect-aware media
+ * classes via `body[data-aspect]`) for visual consistency, but it does NOT go
+ * through the portal's project-discovery `render.ts` — that surface is driven by
+ * on-disk project assets, whereas motion-overlay renders straight from the
+ * deterministic plan manifest. Pure string assembly except for the single
+ * file write in `writeMotionOverlayReview`.
+ */
+import { mkdir, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { PORTAL_CSS } from '../preview-portal/shared-assets.js';
+/** Human-friendly label for the reel-anatomy beat. */
+const ANATOMY_LABELS = {
+    hook: 'Hook',
+    contextualize: 'Contextualize',
+    burst: 'Burst',
+    breath: 'Breath',
+    cta: 'CTA',
+};
+/**
+ * Render the plan into the review HTML string. Pure — no I/O. The aspect
+ * (`plan.input.aspect`) drives `body[data-aspect]` so portrait/square clips get
+ * tall cards via PORTAL_CSS's aspect-aware rules.
+ */
+export function renderMotionOverlayReview(plan) {
+    const aspect = plan.input.aspect;
+    const takeCards = plan.takes.map((take) => renderTakeCard(take)).join('\n');
+    const totalDuration = plan.takes.reduce((sum, t) => sum + t.durationSeconds, 0);
+    return `<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+<title>Motion-overlay review — ${esc(layoutTitle(plan))}</title>
+<style>${PORTAL_CSS}${EXTRA_CSS}</style>
+</head>
+<body data-aspect="${escAttr(aspect)}">
+<header class="hero">
+  <div class="eyebrow">motion-overlay review · approve before spend</div>
+  <h1>Motion-overlay plan</h1>
+  <p class="sub">Review each take's clip and the exact prompt that will be sent to Omni Flash V2V. This is the contract — nothing renders until you approve.</p>
+</header>
+
+<div class="stats">
+  <div class="stat"><div class="v">${plan.takes.length}</div><div class="l">Takes</div></div>
+  <div class="stat"><div class="v">${esc(plan.layout)}</div><div class="l">Layout</div></div>
+  <div class="stat"><div class="v">${esc(plan.style)}</div><div class="l">Style</div></div>
+  <div class="stat"><div class="v">${fmt(totalDuration)}s</div><div class="l">Total</div></div>
+</div>
+
+<div class="mo-meta">
+  <span><b>Input</b> ${esc(plan.input.path)}</span>
+  <span><b>Frame</b> ${plan.input.width}×${plan.input.height} (${esc(aspect)})</span>
+  <span><b>Accent</b> <i class="mo-swatch" style="background:${escAttr(plan.accent)}"></i>${esc(plan.accent)}</span>
+  <span><b>Language</b> ${esc(plan.language)}</span>
+</div>
+
+<section data-toc="Takes">
+  <div class="section-head">
+    <h2>Per-take contract</h2>
+    <div class="section-title">${plan.takes.length} take${plan.takes.length === 1 ? '' : 's'}</div>
+    <div class="section-sub">Each card is one Omni Flash V2V generation: the base clip, its reel beat, and the full composed prompt verbatim.</div>
+  </div>
+  <div class="mo-grid">
+${takeCards}
+  </div>
+</section>
+
+<footer>Generated by <code>vclaw video motion-overlay --preview</code>${plan.generatedAt ? ` · ${esc(plan.generatedAt)}` : ''}</footer>
+</body>
+</html>
+`;
+}
+/**
+ * Render the plan into `<workdir>/review/review.html` and return its path + html.
+ * Creates the `review/` dir if needed. The only side effect.
+ */
+export async function writeMotionOverlayReview(workdir, plan) {
+    const html = renderMotionOverlayReview(plan);
+    const reviewDir = join(workdir, 'review');
+    await mkdir(reviewDir, { recursive: true });
+    const reviewPath = join(reviewDir, 'review.html');
+    await writeFile(reviewPath, html, 'utf-8');
+    return { reviewPath, html };
+}
+/** Render one take card: clip filename, beat, anatomy/span, and full prompt. */
+function renderTakeCard(take) {
+    const beat = ANATOMY_LABELS[take.anatomy] ?? take.anatomy;
+    const clipName = baseName(take.file);
+    return `    <article class="mo-card" data-card-kind="take" data-card-id="${take.index + 1}">
+      <div class="mo-card-head">
+        <span class="num">TAKE ${String(take.index + 1).padStart(2, '0')}</span>
+        <span class="mo-beat" data-anatomy="${escAttr(take.anatomy)}">${esc(beat)}</span>
+      </div>
+      <div class="mo-clip">
+        <video src="../${escAttr(take.file)}" controls preload="none"></video>
+        <div class="mo-clip-name">${esc(clipName)}</div>
+      </div>
+      <dl class="mo-anatomy">
+        <div><dt>Beat</dt><dd>${esc(beat)}</dd></div>
+        <div><dt>Span</dt><dd>${fmt(take.start)}s → ${fmt(take.end)}s</dd></div>
+        <div><dt>Duration</dt><dd>${fmt(take.durationSeconds)}s</dd></div>
+        <div><dt>Clip</dt><dd><code>${esc(take.file)}</code></dd></div>
+      </dl>
+      <div class="mo-prompt">
+        <div class="mo-prompt-label">Composed prompt (the contract)</div>
+        <pre>${esc(take.prompt)}</pre>
+      </div>
+    </article>`;
+}
+/** A short title line summarizing the plan's layout + style. */
+function layoutTitle(plan) {
+    return `${plan.layout} / ${plan.style}`;
+}
+function baseName(p) {
+    const i = p.lastIndexOf('/');
+    return i >= 0 ? p.slice(i + 1) : p;
+}
+function fmt(seconds) {
+    return (Math.round(seconds * 10) / 10).toFixed(1);
+}
+function esc(value) {
+    return value
+        .replaceAll('&', '&amp;')
+        .replaceAll('<', '&lt;')
+        .replaceAll('>', '&gt;')
+        .replaceAll('"', '&quot;');
+}
+function escAttr(value) {
+    return esc(value).replaceAll("'", '&#39;');
+}
+/**
+ * Motion-overlay-specific styling layered on top of PORTAL_CSS. Cards are
+ * aspect-aware: the clip <video> inherits PORTAL_CSS's `.card video` aspect
+ * rules via the same `aspect-ratio` defaults, re-stated here for the `.mo-clip`
+ * scope so portrait/square plans render tall clips.
+ */
+const EXTRA_CSS = `
+.mo-meta{display:flex;gap:10px 22px;flex-wrap:wrap;align-items:center;margin:0 0 30px;color:var(--ink2);font-size:12px;font-family:ui-monospace,"SF Mono",monospace}
+.mo-meta b{color:var(--ink3);font-weight:600;letter-spacing:.06em;text-transform:uppercase;font-size:10px;margin-right:6px}
+.mo-swatch{display:inline-block;width:11px;height:11px;border-radius:50%;border:1px solid rgba(255,255,255,.25);margin-right:6px;vertical-align:middle}
+.mo-grid{display:grid;grid-template-columns:repeat(2,1fr);gap:18px}
+.mo-card{background:var(--panel);border:1px solid var(--line);border-radius:14px;overflow:hidden;display:flex;flex-direction:column}
+.mo-card-head{display:flex;align-items:center;justify-content:space-between;padding:13px 16px;border-bottom:1px solid var(--line)}
+.mo-beat{font-size:10px;font-weight:700;letter-spacing:.1em;text-transform:uppercase;color:var(--accent);background:rgba(255,180,84,.12);border:1px solid rgba(255,180,84,.35);border-radius:999px;padding:3px 10px}
+.mo-clip video{width:100%;aspect-ratio:16/9;object-fit:cover;display:block;background:#000}
+.mo-clip-name{padding:8px 16px 0;color:var(--ink3);font-family:ui-monospace,"SF Mono",monospace;font-size:11px;overflow-wrap:anywhere}
+.mo-anatomy{display:grid;grid-template-columns:repeat(2,1fr);gap:8px 16px;padding:14px 16px;margin:0}
+.mo-anatomy>div{display:flex;flex-direction:column;gap:2px}
+.mo-anatomy dt{font-size:9px;font-weight:700;letter-spacing:.12em;text-transform:uppercase;color:var(--ink3)}
+.mo-anatomy dd{font-size:12px;color:var(--ink);margin:0;overflow-wrap:anywhere}
+.mo-anatomy code{font-family:ui-monospace,"SF Mono",monospace;font-size:11px;color:var(--ink2)}
+.mo-prompt{border-top:1px solid var(--line);padding:14px 16px}
+.mo-prompt-label{font-size:9px;font-weight:700;letter-spacing:.14em;text-transform:uppercase;color:var(--accent);margin-bottom:8px}
+.mo-prompt pre{white-space:pre-wrap;overflow-wrap:anywhere;font-family:ui-monospace,"SF Mono",monospace;font-size:11px;line-height:1.6;color:var(--ink2);background:#0c0c11;border:1px solid var(--line);border-radius:8px;padding:12px 14px;max-height:none}
+body[data-aspect="9:16"] .mo-clip video{aspect-ratio:9/16;width:auto;max-width:100%;max-height:70vh;margin:0 auto}
+body[data-aspect="1:1"] .mo-clip video{aspect-ratio:1/1}
+@media(max-width:900px){.mo-grid{grid-template-columns:1fr}}
+`;
+//# sourceMappingURL=preview.js.map

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

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

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

@@ -0,0 +1,118 @@
+import { type MotifMoment } from './motifs.js';
+/** One caption: the spoken text and its absolute window in the source clip. */
+export interface LocalCaption {
+    text: string;
+    start: number;
+    end: number;
+}
+/**
+ * The three card looks, ported from the source skill's style catalog so
+ * `--render local --style X` actually changes the rendered overlay (previously
+ * only the V2V *prompt* varied by style; the local card was fixed).
+ *  - `apple-clean`    — rounded dark frosted glass, clean sans-serif sentence case.
+ *  - `editorial-dark` — squared solid-black poster panel, bold condensed UPPERCASE.
+ *  - `knowledge-tool` — soft cool-dark card, editorial serif, calm lavender accent.
+ */
+export type CardVariant = 'apple-clean' | 'editorial-dark' | 'knowledge-tool';
+/** Visual config for the lower-third (accent hex + small kicker label + style). */
+export interface LocalRenderStyle {
+    accent: string;
+    /** Optional small kicker label above the caption (e.g. a brand). Omitted when blank. */
+    kicker?: string;
+    /** Lowercased words that get the accent colour (e.g. brand/anchor words). */
+    accentWords?: string[];
+    /** Which card look to render (default `apple-clean`). */
+    variant?: CardVariant;
+    /**
+     * Word-by-word reveal: only the first N words of the caption are visible; the rest
+     * render transparent (so the panel keeps its full size — no per-frame reflow). The
+     * animated renderer drives this with `revealWordCount(t)`. Omitted → all words.
+     */
+    visibleWords?: number;
+}
+/** Escape the five XML entities so arbitrary transcript text is SVG-safe. Pure. */
+export declare function xmlEscape(text: string): string;
+/**
+ * Word-wrap `text` to at most `maxChars` per line (greedy by words). Pure — used
+ * to size the panel and lay out tspans.
+ */
+export declare function wrapWords(text: string, maxChars: number): string[];
+/**
+ * Build the lower-third SVG for one caption. Pure & deterministic. `style.variant`
+ * selects a **structurally distinct** card per the source skill's catalog — a
+ * floating inset frosted card (apple-clean), a full-bleed near-black poster bar with
+ * an accent top rule and a solid accent tag (editorial-dark), or a left-anchored cool
+ * study card with a `[[ MONO ]]` bracket label and serif body (knowledge-tool).
+ */
+export declare function lowerThirdSvg(caption: Pick<LocalCaption, 'text'>, dims: {
+    width: number;
+    height: number;
+}, style: LocalRenderStyle): string;
+/**
+ * Build the giant **anchor-headline** SVG — a single dominant keyword centred in
+ * the upper-middle of the frame, with the accent asterisk beat-marker after it
+ * (the source skill's signature kinetic-typography moment). Pure & deterministic.
+ */
+export declare function anchorHeadlineSvg(word: string, dims: {
+    width: number;
+    height: number;
+}, style: LocalRenderStyle): string;
+/** Rasterise a lower-third SVG to a PNG buffer via sharp. Side effect (sharp). */
+export declare function rasteriseCaption(svg: string): Promise<Buffer>;
+/**
+ * Build the ffmpeg `-filter_complex` graph compositing N pre-rendered full-frame
+ * card PNGs (inputs 1..N; input 0 is the source video) onto the source — each
+ * card fades in/out and slides up 36px on entrance over its [start,end] window.
+ * Pure (string only).
+ */
+export declare function buildLocalFiltergraph(cards: Array<{
+    start: number;
+    end: number;
+}>): string;
+/**
+ * Build the ffmpeg argv for the overlay composite. Pure — the source is input 0,
+ * each card PNG is a looped image input, the graph maps [vout] + the source audio.
+ */
+export declare function buildLocalRenderArgs(sourceVideo: string, cardPngPaths: string[], filtergraph: string, outputPath: string): string[];
+/** Runs ffmpeg with the given argv. Injectable so the orchestrator tests offline. */
+export type FfmpegRunner = (args: string[]) => Promise<void>;
+export interface RenderLocalDeps {
+    ffmpeg: FfmpegRunner;
+    /** Override the rasteriser (tests). Defaults to the live sharp path. */
+    rasterise?: (svg: string) => Promise<Buffer>;
+}
+/** A giant anchor-headline moment: the word + the short window it pulses on. */
+export interface HeadlineMoment {
+    word: string;
+    start: number;
+    end: number;
+}
+export interface RenderLocalOptions {
+    sourceVideo: string;
+    captions: LocalCaption[];
+    dims: {
+        width: number;
+        height: number;
+    };
+    style: LocalRenderStyle;
+    /** Optional giant anchor-headline overlays, composited above the lower-thirds. */
+    headlines?: HeadlineMoment[];
+    /** Optional concept icons / stat callouts, composited in the upper third. */
+    motifs?: MotifMoment[];
+    /** Dir for the intermediate card PNGs. */
+    cardDir: string;
+    outputPath: string;
+}
+/** Resolve a motif into its full-frame SVG using the active style. Pure. */
+export declare function motifSvg(m: MotifMoment, dims: {
+    width: number;
+    height: number;
+}, style: LocalRenderStyle): string;
+/**
+ * Render the local overlay reel: rasterise one lower-third per caption (plus any
+ * giant anchor-headline moments), then composite all elements onto the source with
+ * the fade/slide filtergraph, sorted by start time. Returns the list of card PNG
+ * paths written (for provenance / tests).
+ */
+export declare function renderLocalOverlay(opts: RenderLocalOptions, deps: RenderLocalDeps): Promise<string[]>;
+//# sourceMappingURL=render-local.d.ts.map

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

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