@argo-video/cli 0.1.0 → 0.2.0

package/{src/init.ts → dist/init.js}

@@ -1,21 +1,20 @@
 import { mkdir, writeFile, access } from 'node:fs/promises';
 import { join } from 'node:path';
-
-async function writeIfMissing(filePath: string, content: string): Promise<boolean> {
-  try {
-    await access(filePath);
-    console.log(`  skip ${filePath} (already exists)`);
-    return false;
-  } catch (err: any) {
-    if (err?.code !== 'ENOENT') {
-      throw new Error(`Cannot access ${filePath}: ${err.message}`);
+async function writeIfMissing(filePath, content) {
+    try {
+        await access(filePath);
+        console.log(`  skip ${filePath} (already exists)`);
+        return false;
+    }
+    catch (err) {
+        if (err?.code !== 'ENOENT') {
+            throw new Error(`Cannot access ${filePath}: ${err.message}`);
+        }
+        await writeFile(filePath, content, 'utf-8');
+        console.log(`  create ${filePath}`);
+        return true;
     }
-    await writeFile(filePath, content, 'utf-8');
-    console.log(`  create ${filePath}`);
-    return true;
-  }
 }
-
 const EXAMPLE_DEMO = `import { test } from '@argo-video/cli';
 import { showCaption, withCaption } from '@argo-video/cli';
 
@@ -34,37 +33,26 @@ test('example', async ({ page, narration }) => {
   await showCaption(page, 'done', 'All done!', 2000);
 });
 `;
-
-const EXAMPLE_VOICEOVER = JSON.stringify(
-  [
+const EXAMPLE_VOICEOVER = JSON.stringify([
     { scene: 'welcome', text: 'Welcome to our app — let me show you around.' },
     { scene: 'action', text: 'It only takes one click to get started.' },
     { scene: 'done', text: "And that's it. You're all set.", voice: 'af_heart' },
-  ],
-  null,
-  2,
-) + '\n';
-
-const EXAMPLE_OVERLAYS = JSON.stringify(
-  [
+], null, 2) + '\n';
+const EXAMPLE_OVERLAYS = JSON.stringify([
     {
-      scene: 'welcome',
-      type: 'lower-third',
-      text: 'Welcome to our app',
+        scene: 'welcome',
+        type: 'lower-third',
+        text: 'Welcome to our app',
     },
     {
-      scene: 'action',
-      type: 'headline-card',
-      placement: 'top-left',
-      title: 'One-click setup',
-      body: 'Just press the button to get started.',
-      motion: 'slide-in',
+        scene: 'action',
+        type: 'headline-card',
+        placement: 'top-left',
+        title: 'One-click setup',
+        body: 'Just press the button to get started.',
+        motion: 'slide-in',
     },
-  ],
-  null,
-  2,
-) + '\n';
-
+], null, 2) + '\n';
 const ARGO_CONFIG = `export default {
   baseURL: 'http://localhost:3000',
   demosDir: 'demos/',
@@ -74,7 +62,6 @@ const ARGO_CONFIG = `export default {
   export: { preset: 'slow', crf: 16 },
 };
 `;
-
 const PLAYWRIGHT_CONFIG = `import { defineConfig } from '@playwright/test';
 
 export default defineConfig({
@@ -96,19 +83,17 @@ export default defineConfig({
   ],
 });
 `;
-
-export async function init(cwd: string = process.cwd()): Promise<void> {
-  const demosDir = join(cwd, 'demos');
-  await mkdir(demosDir, { recursive: true });
-
-  await writeIfMissing(join(demosDir, 'example.demo.ts'), EXAMPLE_DEMO);
-  await writeIfMissing(join(demosDir, 'example.voiceover.json'), EXAMPLE_VOICEOVER);
-  await writeIfMissing(join(demosDir, 'example.overlays.json'), EXAMPLE_OVERLAYS);
-  await writeIfMissing(join(cwd, 'argo.config.js'), ARGO_CONFIG);
-  await writeIfMissing(join(cwd, 'playwright.config.ts'), PLAYWRIGHT_CONFIG);
-
-  console.log('\nArgo initialized! Next steps:');
-  console.log('  1. Edit demos/example.demo.ts');
-  console.log('  2. Run: npx argo record example');
-  console.log('  3. Run: npx argo pipeline example');
+export async function init(cwd = process.cwd()) {
+    const demosDir = join(cwd, 'demos');
+    await mkdir(demosDir, { recursive: true });
+    await writeIfMissing(join(demosDir, 'example.demo.ts'), EXAMPLE_DEMO);
+    await writeIfMissing(join(demosDir, 'example.voiceover.json'), EXAMPLE_VOICEOVER);
+    await writeIfMissing(join(demosDir, 'example.overlays.json'), EXAMPLE_OVERLAYS);
+    await writeIfMissing(join(cwd, 'argo.config.js'), ARGO_CONFIG);
+    await writeIfMissing(join(cwd, 'playwright.config.ts'), PLAYWRIGHT_CONFIG);
+    console.log('\nArgo initialized! Next steps:');
+    console.log('  1. Edit demos/example.demo.ts');
+    console.log('  2. Run: npx argo record example');
+    console.log('  3. Run: npx argo pipeline example');
 }
+//# sourceMappingURL=init.js.map

package/dist/init.js.map

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

package/dist/narration.d.ts

@@ -0,0 +1,32 @@
+export interface SceneDurationOptions {
+    leadInMs?: number;
+    leadOutMs?: number;
+    minMs?: number;
+    maxMs?: number;
+    multiplier?: number;
+    fallbackMs?: number;
+}
+export declare class NarrationTimeline {
+    private timings;
+    private startTime;
+    private sceneDurations;
+    private cachedPlacements;
+    constructor(sceneDurations?: Record<string, number>);
+    start(): void;
+    mark(scene: string): void;
+    getTimings(): Record<string, number>;
+    flush(outputPath: string): Promise<void>;
+    private getBaseDuration;
+    private getPlacements;
+    /**
+     * Compute a hold duration for a scene based on its TTS clip length.
+     * Use for overlay durations and passive reading time — not for
+     * page loads, click completion, or selector readiness.
+     *
+     * When the scene has already been marked, this returns the remaining wait
+     * from "now", not the full scene duration. It also accounts for any audio
+     * backlog caused by earlier clips running long.
+     */
+    durationFor(scene: string, options?: SceneDurationOptions): number;
+}
+//# sourceMappingURL=narration.d.ts.map

package/dist/narration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"narration.d.ts","sourceRoot":"","sources":["../src/narration.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,OAAO,CAAkC;IACjD,OAAO,CAAC,SAAS,CAAuB;IACxC,OAAO,CAAC,cAAc,CAA8B;IACpD,OAAO,CAAC,gBAAgB,CAA4B;gBAExC,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAMnD,KAAK,IAAI,IAAI;IAMb,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAWzB,UAAU,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAI9B,KAAK,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAK9C,OAAO,CAAC,eAAe;IAcvB,OAAO,CAAC,aAAa;IAerB;;;;;;;;OAQG;IACH,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,oBAAoB,GAAG,MAAM;CAmBnE"}

package/dist/narration.js

@@ -0,0 +1,86 @@
+import { mkdir, writeFile } from 'node:fs/promises';
+import { dirname } from 'node:path';
+import { schedulePlacements } from './tts/align.js';
+export class NarrationTimeline {
+    timings = new Map();
+    startTime = null;
+    sceneDurations = {};
+    cachedPlacements = null;
+    constructor(sceneDurations) {
+        if (sceneDurations) {
+            this.sceneDurations = sceneDurations;
+        }
+    }
+    start() {
+        this.startTime = Date.now();
+        this.timings = new Map();
+        this.cachedPlacements = null;
+    }
+    mark(scene) {
+        if (this.startTime === null) {
+            throw new Error('Cannot mark before start() has been called');
+        }
+        if (this.timings.has(scene)) {
+            throw new Error(`Duplicate scene name: "${scene}"`);
+        }
+        this.timings.set(scene, Date.now() - this.startTime);
+        this.cachedPlacements = null;
+    }
+    getTimings() {
+        return Object.fromEntries(this.timings);
+    }
+    async flush(outputPath) {
+        await mkdir(dirname(outputPath), { recursive: true });
+        await writeFile(outputPath, JSON.stringify(this.getTimings(), null, 2), 'utf-8');
+    }
+    getBaseDuration(scene, options) {
+        const clipMs = this.sceneDurations[scene];
+        const fallback = options?.fallbackMs ?? 3000;
+        if (clipMs === undefined)
+            return fallback;
+        const raw = clipMs * (options?.multiplier ?? 1)
+            + (options?.leadInMs ?? 200)
+            + (options?.leadOutMs ?? 400);
+        const min = options?.minMs ?? 2200;
+        const max = options?.maxMs ?? 8000;
+        return Math.max(min, Math.min(max, raw));
+    }
+    getPlacements() {
+        if (this.cachedPlacements)
+            return this.cachedPlacements;
+        const scheduledScenes = Array.from(this.timings.entries())
+            .filter(([name]) => this.sceneDurations[name] !== undefined)
+            .map(([name, startMs]) => ({
+            scene: name,
+            startMs,
+            durationMs: this.sceneDurations[name],
+        }));
+        this.cachedPlacements = schedulePlacements(scheduledScenes);
+        return this.cachedPlacements;
+    }
+    /**
+     * Compute a hold duration for a scene based on its TTS clip length.
+     * Use for overlay durations and passive reading time — not for
+     * page loads, click completion, or selector readiness.
+     *
+     * When the scene has already been marked, this returns the remaining wait
+     * from "now", not the full scene duration. It also accounts for any audio
+     * backlog caused by earlier clips running long.
+     */
+    durationFor(scene, options) {
+        const baseDurationMs = this.getBaseDuration(scene, options);
+        if (this.startTime === null)
+            return baseDurationMs;
+        const markMs = this.timings.get(scene);
+        if (markMs === undefined)
+            return baseDurationMs;
+        const placement = this.getPlacements().find((p) => p.scene === scene);
+        if (!placement)
+            return baseDurationMs;
+        const leadOutMs = options?.leadOutMs ?? 400;
+        const desiredEndMs = Math.max(markMs + baseDurationMs, placement.endMs + leadOutMs);
+        const nowMs = Math.max(0, Date.now() - this.startTime);
+        return Math.max(0, Math.ceil(desiredEndMs - nowMs));
+    }
+}
+//# sourceMappingURL=narration.js.map

package/dist/narration.js.map

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

package/dist/overlays/index.d.ts

@@ -0,0 +1,13 @@
+import type { Page } from '@playwright/test';
+import type { OverlayCue, Zone } from './types.js';
+export type { OverlayCue, OverlayManifestEntry, Zone, TemplateType, MotionPreset } from './types.js';
+export { renderTemplate } from './templates.js';
+export type { BackgroundTheme } from './zones.js';
+export declare function showOverlay(page: Page, _scene: string, cue: OverlayCue, durationMs: number, options?: {
+    autoBackground?: boolean;
+}): Promise<void>;
+export declare function hideOverlay(page: Page, zone?: Zone): Promise<void>;
+export declare function withOverlay(page: Page, _scene: string, cue: OverlayCue, action: () => Promise<void>, options?: {
+    autoBackground?: boolean;
+}): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

package/dist/overlays/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/overlays/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAMnD,YAAY,EAAE,UAAU,EAAE,oBAAoB,EAAE,IAAI,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AACrG,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,YAAY,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAiBlD,wBAAsB,WAAW,CAC/B,IAAI,EAAE,IAAI,EACV,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,UAAU,EACf,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE;IAAE,cAAc,CAAC,EAAE,OAAO,CAAA;CAAE,GACrC,OAAO,CAAC,IAAI,CAAC,CAYf;AAED,wBAAsB,WAAW,CAC/B,IAAI,EAAE,IAAI,EACV,IAAI,GAAE,IAAsB,GAC3B,OAAO,CAAC,IAAI,CAAC,CAEf;AAED,wBAAsB,WAAW,CAC/B,IAAI,EAAE,IAAI,EACV,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,UAAU,EACf,MAAM,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,EAC3B,OAAO,CAAC,EAAE;IAAE,cAAc,CAAC,EAAE,OAAO,CAAA;CAAE,GACrC,OAAO,CAAC,IAAI,CAAC,CAef"}

package/dist/overlays/index.js

@@ -0,0 +1,45 @@
+import { injectIntoZone, removeZone, ZONE_ID_PREFIX, detectBackgroundTheme } from './zones.js';
+import { renderTemplate } from './templates.js';
+import { getMotionCSS, getMotionStyles } from './motion.js';
+export { renderTemplate } from './templates.js';
+function getConfigAutoBackground() {
+    return process.env.ARGO_AUTO_BACKGROUND === '1';
+}
+async function resolveTheme(page, cue, zone, optionsAutoBackground) {
+    const shouldDetect = cue.autoBackground ?? optionsAutoBackground ?? getConfigAutoBackground();
+    if (!shouldDetect)
+        return 'dark';
+    return detectBackgroundTheme(page, zone);
+}
+export async function showOverlay(page, _scene, cue, durationMs, options) {
+    const zone = cue.placement ?? 'bottom-center';
+    const motion = cue.motion ?? 'none';
+    const theme = await resolveTheme(page, cue, zone, options?.autoBackground);
+    const { contentHtml, styles } = renderTemplate(cue, theme);
+    const zoneId = ZONE_ID_PREFIX + zone;
+    const motionCSS = getMotionCSS(motion, zoneId);
+    const motionStyles = getMotionStyles(motion, zoneId);
+    await injectIntoZone(page, zone, contentHtml, { ...styles, ...motionStyles }, motionCSS);
+    await page.waitForTimeout(durationMs);
+    await removeZone(page, zone);
+}
+export async function hideOverlay(page, zone = 'bottom-center') {
+    await removeZone(page, zone);
+}
+export async function withOverlay(page, _scene, cue, action, options) {
+    const zone = cue.placement ?? 'bottom-center';
+    const motion = cue.motion ?? 'none';
+    const theme = await resolveTheme(page, cue, zone, options?.autoBackground);
+    const { contentHtml, styles } = renderTemplate(cue, theme);
+    const zoneId = ZONE_ID_PREFIX + zone;
+    const motionCSS = getMotionCSS(motion, zoneId);
+    const motionStyles = getMotionStyles(motion, zoneId);
+    await injectIntoZone(page, zone, contentHtml, { ...styles, ...motionStyles }, motionCSS);
+    try {
+        await action();
+    }
+    finally {
+        await removeZone(page, zone);
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/overlays/index.js.map

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

package/dist/overlays/manifest.d.ts

@@ -0,0 +1,5 @@
+import type { OverlayManifestEntry } from './types.js';
+export declare function loadOverlayManifest(manifestPath: string): Promise<OverlayManifestEntry[] | null>;
+export declare function hasImageAssets(entries: OverlayManifestEntry[]): boolean;
+export declare function resolveAssetURLs(entries: OverlayManifestEntry[], assetBaseURL: string): OverlayManifestEntry[];
+//# sourceMappingURL=manifest.d.ts.map

package/dist/overlays/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../src/overlays/manifest.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAGvD,wBAAsB,mBAAmB,CACvC,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,oBAAoB,EAAE,GAAG,IAAI,CAAC,CA4CxC;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,oBAAoB,EAAE,GAAG,OAAO,CAEvE;AAED,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,oBAAoB,EAAE,EAC/B,YAAY,EAAE,MAAM,GACnB,oBAAoB,EAAE,CAOxB"}

package/dist/overlays/manifest.js

@@ -0,0 +1,52 @@
+import { readFile } from 'node:fs/promises';
+import { existsSync } from 'node:fs';
+import { isValidTemplateType, isValidZone, isValidMotion } from './types.js';
+export async function loadOverlayManifest(manifestPath) {
+    if (!existsSync(manifestPath))
+        return null;
+    const raw = await readFile(manifestPath, 'utf-8');
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch (err) {
+        throw new Error(`Failed to parse overlay manifest ${manifestPath}: ${err.message}`);
+    }
+    if (!Array.isArray(parsed)) {
+        throw new Error(`Overlay manifest ${manifestPath} must contain a JSON array`);
+    }
+    const entries = [];
+    for (let i = 0; i < parsed.length; i++) {
+        const entry = parsed[i];
+        const prefix = `Overlay manifest entry ${i}`;
+        if (!entry.scene || typeof entry.scene !== 'string') {
+            throw new Error(`${prefix}: missing required field "scene"`);
+        }
+        if (!entry.type || typeof entry.type !== 'string') {
+            throw new Error(`${prefix}: missing required field "type"`);
+        }
+        if (!isValidTemplateType(entry.type)) {
+            throw new Error(`${prefix}: unknown overlay type "${entry.type}"`);
+        }
+        if (entry.placement && !isValidZone(entry.placement)) {
+            throw new Error(`${prefix}: unknown placement "${entry.placement}"`);
+        }
+        if (entry.motion && !isValidMotion(entry.motion)) {
+            throw new Error(`${prefix}: unknown motion "${entry.motion}"`);
+        }
+        entries.push(entry);
+    }
+    return entries;
+}
+export function hasImageAssets(entries) {
+    return entries.some((e) => e.type === 'image-card');
+}
+export function resolveAssetURLs(entries, assetBaseURL) {
+    return entries.map((e) => {
+        if (e.type === 'image-card' && e.src && !e.src.startsWith('http')) {
+            return { ...e, src: `${assetBaseURL}/${e.src.replace(/^assets\//, '')}` };
+        }
+        return e;
+    });
+}
+//# sourceMappingURL=manifest.js.map

package/dist/overlays/manifest.js.map

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

package/dist/overlays/motion.d.ts

@@ -0,0 +1,4 @@
+import type { MotionPreset } from './types.js';
+export declare function getMotionCSS(motion: MotionPreset, elementId: string): string;
+export declare function getMotionStyles(motion: MotionPreset, elementId: string): Record<string, string>;
+//# sourceMappingURL=motion.d.ts.map

package/dist/overlays/motion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"motion.d.ts","sourceRoot":"","sources":["../../src/overlays/motion.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,wBAAgB,YAAY,CAAC,MAAM,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAW5E;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAW/F"}

package/dist/overlays/motion.js

@@ -0,0 +1,25 @@
+export function getMotionCSS(motion, elementId) {
+    const animName = `argo-${motion}-${elementId}`;
+    switch (motion) {
+        case 'fade-in':
+            return `@keyframes ${animName} { from { opacity: 0; } to { opacity: 1; } }`;
+        case 'slide-in':
+            return `@keyframes ${animName} { from { opacity: 0; transform: translateX(-20px); } to { opacity: 1; transform: translateX(0); } }`;
+        case 'none':
+        default:
+            return '';
+    }
+}
+export function getMotionStyles(motion, elementId) {
+    const animName = `argo-${motion}-${elementId}`;
+    switch (motion) {
+        case 'fade-in':
+            return { animation: `${animName} 300ms ease-out forwards` };
+        case 'slide-in':
+            return { animation: `${animName} 400ms ease-out forwards` };
+        case 'none':
+        default:
+            return {};
+    }
+}
+//# sourceMappingURL=motion.js.map

package/dist/overlays/motion.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"motion.js","sourceRoot":"","sources":["../../src/overlays/motion.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,YAAY,CAAC,MAAoB,EAAE,SAAiB;IAClE,MAAM,QAAQ,GAAG,QAAQ,MAAM,IAAI,SAAS,EAAE,CAAC;IAC/C,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,SAAS;YACZ,OAAO,cAAc,QAAQ,8CAA8C,CAAC;QAC9E,KAAK,UAAU;YACb,OAAO,cAAc,QAAQ,sGAAsG,CAAC;QACtI,KAAK,MAAM,CAAC;QACZ;YACE,OAAO,EAAE,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,MAAoB,EAAE,SAAiB;IACrE,MAAM,QAAQ,GAAG,QAAQ,MAAM,IAAI,SAAS,EAAE,CAAC;IAC/C,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,SAAS;YACZ,OAAO,EAAE,SAAS,EAAE,GAAG,QAAQ,0BAA0B,EAAE,CAAC;QAC9D,KAAK,UAAU;YACb,OAAO,EAAE,SAAS,EAAE,GAAG,QAAQ,0BAA0B,EAAE,CAAC;QAC9D,KAAK,MAAM,CAAC;QACZ;YACE,OAAO,EAAE,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/overlays/templates.d.ts

@@ -0,0 +1,8 @@
+import type { OverlayCue } from './types.js';
+import type { BackgroundTheme } from './zones.js';
+export interface TemplateResult {
+    contentHtml: string;
+    styles: Record<string, string>;
+}
+export declare function renderTemplate(cue: OverlayCue, theme?: BackgroundTheme): TemplateResult;
+//# sourceMappingURL=templates.d.ts.map

package/dist/overlays/templates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../../src/overlays/templates.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChC;AA4GD,wBAAgB,cAAc,CAAC,GAAG,EAAE,UAAU,EAAE,KAAK,GAAE,eAAwB,GAAG,cAAc,CAW/F"}

package/dist/overlays/templates.js

@@ -0,0 +1,102 @@
+function escapeHtml(str) {
+    return str
+        .replace(/&/g, '&')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;')
+        .replace(/"/g, '&quot;');
+}
+function lowerThird(text, theme) {
+    const isDark = theme === 'dark';
+    return {
+        contentHtml: `<span>${escapeHtml(text)}</span>`,
+        styles: {
+            background: isDark ? 'rgba(0, 0, 0, 0.85)' : 'rgba(255, 255, 255, 0.9)',
+            color: isDark ? '#fff' : '#1a1a1a',
+            padding: '16px 32px',
+            borderRadius: '12px',
+            fontSize: '28px',
+            fontWeight: '500',
+            textAlign: 'center',
+            maxWidth: '80vw',
+            letterSpacing: '0.01em',
+            lineHeight: '1.4',
+            boxShadow: isDark ? '0 4px 24px rgba(0, 0, 0, 0.3)' : '0 4px 24px rgba(0, 0, 0, 0.12)',
+        },
+    };
+}
+function headlineCard(title, theme, kicker, body) {
+    const isDark = theme === 'dark';
+    const parts = [];
+    if (kicker) {
+        parts.push(`<div style="font-size:12px;font-weight:700;letter-spacing:0.08em;text-transform:uppercase;color:${isDark ? 'rgba(255,255,255,0.7)' : 'rgba(0,0,0,0.5)'};margin-bottom:8px">${escapeHtml(kicker)}</div>`);
+    }
+    parts.push(`<div style="font-size:26px;font-weight:700;line-height:1.25;color:${isDark ? '#fff' : '#1a1a1a'}">${escapeHtml(title)}</div>`);
+    if (body) {
+        parts.push(`<div style="font-size:16px;line-height:1.5;color:${isDark ? 'rgba(255,255,255,0.85)' : 'rgba(0,0,0,0.7)'};margin-top:8px">${escapeHtml(body)}</div>`);
+    }
+    return {
+        contentHtml: parts.join(''),
+        styles: {
+            background: isDark ? 'rgba(0, 0, 0, 0.7)' : 'rgba(255, 255, 255, 0.85)',
+            backdropFilter: 'blur(16px)',
+            WebkitBackdropFilter: 'blur(16px)',
+            padding: '24px 28px',
+            borderRadius: '16px',
+            maxWidth: '420px',
+            boxShadow: isDark ? '0 8px 32px rgba(0, 0, 0, 0.4)' : '0 8px 32px rgba(0, 0, 0, 0.1)',
+        },
+    };
+}
+function callout(text, theme) {
+    const isDark = theme === 'dark';
+    return {
+        contentHtml: `<span>${escapeHtml(text)}</span>`,
+        styles: {
+            background: isDark ? 'rgba(0, 0, 0, 0.8)' : 'rgba(255, 255, 255, 0.9)',
+            color: isDark ? '#fff' : '#1a1a1a',
+            padding: '10px 18px',
+            borderRadius: '20px',
+            fontSize: '16px',
+            fontWeight: '500',
+            lineHeight: '1.3',
+            maxWidth: '300px',
+            boxShadow: isDark ? '0 2px 12px rgba(0, 0, 0, 0.3)' : '0 2px 12px rgba(0, 0, 0, 0.1)',
+        },
+    };
+}
+function imageCard(src, theme, title, body) {
+    const isDark = theme === 'dark';
+    const parts = [];
+    parts.push(`<img src="${escapeHtml(src)}" style="max-width:100%;border-radius:8px;display:block" />`);
+    if (title) {
+        parts.push(`<div style="font-size:18px;font-weight:600;color:${isDark ? '#fff' : '#1a1a1a'};margin-top:12px">${escapeHtml(title)}</div>`);
+    }
+    if (body) {
+        parts.push(`<div style="font-size:14px;color:${isDark ? 'rgba(255,255,255,0.8)' : 'rgba(0,0,0,0.7)'};margin-top:4px;line-height:1.4">${escapeHtml(body)}</div>`);
+    }
+    return {
+        contentHtml: parts.join(''),
+        styles: {
+            background: isDark ? 'rgba(0, 0, 0, 0.75)' : 'rgba(255, 255, 255, 0.85)',
+            backdropFilter: 'blur(12px)',
+            WebkitBackdropFilter: 'blur(12px)',
+            padding: '16px',
+            borderRadius: '14px',
+            maxWidth: '360px',
+            boxShadow: isDark ? '0 6px 24px rgba(0, 0, 0, 0.4)' : '0 6px 24px rgba(0, 0, 0, 0.1)',
+        },
+    };
+}
+export function renderTemplate(cue, theme = 'dark') {
+    switch (cue.type) {
+        case 'lower-third':
+            return lowerThird(cue.text, theme);
+        case 'headline-card':
+            return headlineCard(cue.title, theme, cue.kicker, cue.body);
+        case 'callout':
+            return callout(cue.text, theme);
+        case 'image-card':
+            return imageCard(cue.src, theme, cue.title, cue.body);
+    }
+}
+//# sourceMappingURL=templates.js.map

package/dist/overlays/templates.js.map

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

package/dist/overlays/types.d.ts

@@ -0,0 +1,46 @@
+export declare const ZONES: readonly ["bottom-center", "top-left", "top-right", "bottom-left", "bottom-right", "center"];
+export type Zone = (typeof ZONES)[number];
+export declare const TEMPLATE_TYPES: readonly ["lower-third", "headline-card", "callout", "image-card"];
+export type TemplateType = (typeof TEMPLATE_TYPES)[number];
+export declare const MOTIONS: readonly ["none", "fade-in", "slide-in"];
+export type MotionPreset = (typeof MOTIONS)[number];
+export interface LowerThirdCue {
+    type: 'lower-third';
+    text: string;
+    placement?: Zone;
+    motion?: MotionPreset;
+    autoBackground?: boolean;
+}
+export interface HeadlineCardCue {
+    type: 'headline-card';
+    title: string;
+    kicker?: string;
+    body?: string;
+    placement?: Zone;
+    motion?: MotionPreset;
+    autoBackground?: boolean;
+}
+export interface CalloutCue {
+    type: 'callout';
+    text: string;
+    placement?: Zone;
+    motion?: MotionPreset;
+    autoBackground?: boolean;
+}
+export interface ImageCardCue {
+    type: 'image-card';
+    src: string;
+    title?: string;
+    body?: string;
+    placement?: Zone;
+    motion?: MotionPreset;
+    autoBackground?: boolean;
+}
+export type OverlayCue = LowerThirdCue | HeadlineCardCue | CalloutCue | ImageCardCue;
+export type OverlayManifestEntry = OverlayCue & {
+    scene: string;
+};
+export declare function isValidZone(value: string): value is Zone;
+export declare function isValidTemplateType(value: string): value is TemplateType;
+export declare function isValidMotion(value: string): value is MotionPreset;
+//# sourceMappingURL=types.d.ts.map

package/dist/overlays/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/overlays/types.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,KAAK,8FAOR,CAAC;AAEX,MAAM,MAAM,IAAI,GAAG,CAAC,OAAO,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC;AAE1C,eAAO,MAAM,cAAc,oEAKjB,CAAC;AAEX,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC;AAE3D,eAAO,MAAM,OAAO,0CAA2C,CAAC;AAEhE,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC;AAEpD,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,aAAa,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,IAAI,CAAC;IACjB,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,eAAe,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,IAAI,CAAC;IACjB,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,SAAS,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,IAAI,CAAC;IACjB,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,YAAY,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,IAAI,CAAC;IACjB,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,MAAM,UAAU,GAAG,aAAa,GAAG,eAAe,GAAG,UAAU,GAAG,YAAY,CAAC;AAErF,MAAM,MAAM,oBAAoB,GAAG,UAAU,GAAG;IAC9C,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,IAAI,CAExD;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,YAAY,CAExE;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,YAAY,CAElE"}