@argo-video/cli 0.1.0 → 0.1.1

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,9 @@
+export declare class NarrationTimeline {
+    private timings;
+    private startTime;
+    start(): void;
+    mark(scene: string): void;
+    getTimings(): Record<string, number>;
+    flush(outputPath: string): Promise<void>;
+}
+//# 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":"AAGA,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,OAAO,CAAkC;IACjD,OAAO,CAAC,SAAS,CAAuB;IAExC,KAAK,IAAI,IAAI;IAKb,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAUzB,UAAU,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAI9B,KAAK,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAI/C"}

package/dist/narration.js

@@ -0,0 +1,27 @@
+import { mkdir, writeFile } from 'node:fs/promises';
+import { dirname } from 'node:path';
+export class NarrationTimeline {
+    timings = new Map();
+    startTime = null;
+    start() {
+        this.startTime = Date.now();
+        this.timings = new Map();
+    }
+    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);
+    }
+    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');
+    }
+}
+//# sourceMappingURL=narration.js.map

package/dist/narration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"narration.js","sourceRoot":"","sources":["../src/narration.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,MAAM,OAAO,iBAAiB;IACpB,OAAO,GAAwB,IAAI,GAAG,EAAE,CAAC;IACzC,SAAS,GAAkB,IAAI,CAAC;IAExC,KAAK;QACH,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC5B,IAAI,CAAC,OAAO,GAAG,IAAI,GAAG,EAAE,CAAC;IAC3B,CAAC;IAED,IAAI,CAAC,KAAa;QAChB,IAAI,IAAI,CAAC,SAAS,KAAK,IAAI,EAAE,CAAC;YAC5B,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;QAChE,CAAC;QACD,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YAC5B,MAAM,IAAI,KAAK,CAAC,0BAA0B,KAAK,GAAG,CAAC,CAAC;QACtD,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC;IACvD,CAAC;IAED,UAAU;QACR,OAAO,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC1C,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,UAAkB;QAC5B,MAAM,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACtD,MAAM,SAAS,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;IACnF,CAAC;CACF"}

package/dist/overlays/index.d.ts

@@ -0,0 +1,8 @@
+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 declare function showOverlay(page: Page, _scene: string, cue: OverlayCue, durationMs: number): 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>): 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;AAKnD,YAAY,EAAE,UAAU,EAAE,oBAAoB,EAAE,IAAI,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AACrG,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEhD,wBAAsB,WAAW,CAC/B,IAAI,EAAE,IAAI,EACV,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,UAAU,EACf,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC,CAWf;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,GAC1B,OAAO,CAAC,IAAI,CAAC,CAcf"}

package/dist/overlays/index.js

@@ -0,0 +1,34 @@
+import { injectIntoZone, removeZone, ZONE_ID_PREFIX } from './zones.js';
+import { renderTemplate } from './templates.js';
+import { getMotionCSS, getMotionStyles } from './motion.js';
+export { renderTemplate } from './templates.js';
+export async function showOverlay(page, _scene, cue, durationMs) {
+    const zone = cue.placement ?? 'bottom-center';
+    const motion = cue.motion ?? 'none';
+    const { contentHtml, styles } = renderTemplate(cue);
+    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) {
+    const zone = cue.placement ?? 'bottom-center';
+    const motion = cue.motion ?? 'none';
+    const { contentHtml, styles } = renderTemplate(cue);
+    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":"AAEA,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACxE,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAG5D,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEhD,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,IAAU,EACV,MAAc,EACd,GAAe,EACf,UAAkB;IAElB,MAAM,IAAI,GAAS,GAAG,CAAC,SAAS,IAAI,eAAe,CAAC;IACpD,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,IAAI,MAAM,CAAC;IACpC,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC;IACpD,MAAM,MAAM,GAAG,cAAc,GAAG,IAAI,CAAC;IACrC,MAAM,SAAS,GAAG,YAAY,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/C,MAAM,YAAY,GAAG,eAAe,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAErD,MAAM,cAAc,CAAC,IAAI,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE,GAAG,MAAM,EAAE,GAAG,YAAY,EAAE,EAAE,SAAS,CAAC,CAAC;IACzF,MAAM,IAAI,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC;IACtC,MAAM,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;AAC/B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,IAAU,EACV,OAAa,eAAe;IAE5B,MAAM,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;AAC/B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,IAAU,EACV,MAAc,EACd,GAAe,EACf,MAA2B;IAE3B,MAAM,IAAI,GAAS,GAAG,CAAC,SAAS,IAAI,eAAe,CAAC;IACpD,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,IAAI,MAAM,CAAC;IACpC,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC;IACpD,MAAM,MAAM,GAAG,cAAc,GAAG,IAAI,CAAC;IACrC,MAAM,SAAS,GAAG,YAAY,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/C,MAAM,YAAY,GAAG,eAAe,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAErD,MAAM,cAAc,CAAC,IAAI,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE,GAAG,MAAM,EAAE,GAAG,YAAY,EAAE,EAAE,SAAS,CAAC,CAAC;IACzF,IAAI,CAAC;QACH,MAAM,MAAM,EAAE,CAAC;IACjB,CAAC;YAAS,CAAC;QACT,MAAM,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAC/B,CAAC;AACH,CAAC"}

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,7 @@
+import type { OverlayCue } from './types.js';
+export interface TemplateResult {
+    contentHtml: string;
+    styles: Record<string, string>;
+}
+export declare function renderTemplate(cue: OverlayCue): 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;AAE7C,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChC;AAwGD,wBAAgB,cAAc,CAAC,GAAG,EAAE,UAAU,GAAG,cAAc,CAW9D"}

package/dist/overlays/templates.js

@@ -0,0 +1,98 @@
+function escapeHtml(str) {
+    return str
+        .replace(/&/g, '&')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;')
+        .replace(/"/g, '&quot;');
+}
+function lowerThird(text) {
+    return {
+        contentHtml: `<span>${escapeHtml(text)}</span>`,
+        styles: {
+            background: 'rgba(0, 0, 0, 0.85)',
+            color: '#fff',
+            padding: '16px 32px',
+            borderRadius: '12px',
+            fontSize: '28px',
+            fontWeight: '500',
+            textAlign: 'center',
+            maxWidth: '80vw',
+            letterSpacing: '0.01em',
+            lineHeight: '1.4',
+            boxShadow: '0 4px 24px rgba(0, 0, 0, 0.3)',
+        },
+    };
+}
+function headlineCard(title, kicker, body) {
+    const parts = [];
+    if (kicker) {
+        parts.push(`<div style="font-size:12px;font-weight:700;letter-spacing:0.08em;text-transform:uppercase;color:rgba(255,255,255,0.7);margin-bottom:8px">${escapeHtml(kicker)}</div>`);
+    }
+    parts.push(`<div style="font-size:26px;font-weight:700;line-height:1.25;color:#fff">${escapeHtml(title)}</div>`);
+    if (body) {
+        parts.push(`<div style="font-size:16px;line-height:1.5;color:rgba(255,255,255,0.85);margin-top:8px">${escapeHtml(body)}</div>`);
+    }
+    return {
+        contentHtml: parts.join(''),
+        styles: {
+            background: 'rgba(0, 0, 0, 0.7)',
+            backdropFilter: 'blur(16px)',
+            WebkitBackdropFilter: 'blur(16px)',
+            padding: '24px 28px',
+            borderRadius: '16px',
+            maxWidth: '420px',
+            boxShadow: '0 8px 32px rgba(0, 0, 0, 0.4)',
+        },
+    };
+}
+function callout(text) {
+    return {
+        contentHtml: `<span>${escapeHtml(text)}</span>`,
+        styles: {
+            background: 'rgba(0, 0, 0, 0.8)',
+            color: '#fff',
+            padding: '10px 18px',
+            borderRadius: '20px',
+            fontSize: '16px',
+            fontWeight: '500',
+            lineHeight: '1.3',
+            maxWidth: '300px',
+            boxShadow: '0 2px 12px rgba(0, 0, 0, 0.3)',
+        },
+    };
+}
+function imageCard(src, title, body) {
+    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:#fff;margin-top:12px">${escapeHtml(title)}</div>`);
+    }
+    if (body) {
+        parts.push(`<div style="font-size:14px;color:rgba(255,255,255,0.8);margin-top:4px;line-height:1.4">${escapeHtml(body)}</div>`);
+    }
+    return {
+        contentHtml: parts.join(''),
+        styles: {
+            background: 'rgba(0, 0, 0, 0.75)',
+            backdropFilter: 'blur(12px)',
+            WebkitBackdropFilter: 'blur(12px)',
+            padding: '16px',
+            borderRadius: '14px',
+            maxWidth: '360px',
+            boxShadow: '0 6px 24px rgba(0, 0, 0, 0.4)',
+        },
+    };
+}
+export function renderTemplate(cue) {
+    switch (cue.type) {
+        case 'lower-third':
+            return lowerThird(cue.text);
+        case 'headline-card':
+            return headlineCard(cue.title, cue.kicker, cue.body);
+        case 'callout':
+            return callout(cue.text);
+        case 'image-card':
+            return imageCard(cue.src, 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,42 @@
+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;
+}
+export interface HeadlineCardCue {
+    type: 'headline-card';
+    title: string;
+    kicker?: string;
+    body?: string;
+    placement?: Zone;
+    motion?: MotionPreset;
+}
+export interface CalloutCue {
+    type: 'callout';
+    text: string;
+    placement?: Zone;
+    motion?: MotionPreset;
+}
+export interface ImageCardCue {
+    type: 'image-card';
+    src: string;
+    title?: string;
+    body?: string;
+    placement?: Zone;
+    motion?: MotionPreset;
+}
+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;CACvB;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;CACvB;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;CACvB;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;CACvB;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"}

package/dist/overlays/types.js

@@ -0,0 +1,25 @@
+export const ZONES = [
+    'bottom-center',
+    'top-left',
+    'top-right',
+    'bottom-left',
+    'bottom-right',
+    'center',
+];
+export const TEMPLATE_TYPES = [
+    'lower-third',
+    'headline-card',
+    'callout',
+    'image-card',
+];
+export const MOTIONS = ['none', 'fade-in', 'slide-in'];
+export function isValidZone(value) {
+    return ZONES.includes(value);
+}
+export function isValidTemplateType(value) {
+    return TEMPLATE_TYPES.includes(value);
+}
+export function isValidMotion(value) {
+    return MOTIONS.includes(value);
+}
+//# sourceMappingURL=types.js.map

package/dist/overlays/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/overlays/types.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,KAAK,GAAG;IACnB,eAAe;IACf,UAAU;IACV,WAAW;IACX,aAAa;IACb,cAAc;IACd,QAAQ;CACA,CAAC;AAIX,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,aAAa;IACb,eAAe;IACf,SAAS;IACT,YAAY;CACJ,CAAC;AAIX,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,MAAM,EAAE,SAAS,EAAE,UAAU,CAAU,CAAC;AA0ChE,MAAM,UAAU,WAAW,CAAC,KAAa;IACvC,OAAQ,KAA2B,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AACtD,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,KAAa;IAC/C,OAAQ,cAAoC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AAC/D,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,KAAa;IACzC,OAAQ,OAA6B,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AACxD,CAAC"}

package/dist/overlays/zones.d.ts

@@ -0,0 +1,15 @@
+import type { Page } from '@playwright/test';
+import type { Zone } from './types.js';
+export declare const ZONE_ID_PREFIX = "argo-overlay-";
+/**
+ * Inject content into a zone. Replaces any existing overlay in that zone.
+ * Security: contentHtml is generated by template renderers which escape all
+ * text fields via escapeHtml(). Content originates from author-controlled
+ * manifest files, not end-user input.
+ */
+export declare function injectIntoZone(page: Page, zone: Zone, contentHtml: string, containerStyles: Record<string, string>, animationCSS?: string): Promise<void>;
+/**
+ * Remove the overlay in the specified zone, if any.
+ */
+export declare function removeZone(page: Page, zone: Zone): Promise<void>;
+//# sourceMappingURL=zones.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"zones.d.ts","sourceRoot":"","sources":["../../src/overlays/zones.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAEvC,eAAO,MAAM,cAAc,kBAAkB,CAAC;AAuB9C;;;;;GAKG;AACH,wBAAsB,cAAc,CAClC,IAAI,EAAE,IAAI,EACV,IAAI,EAAE,IAAI,EACV,WAAW,EAAE,MAAM,EACnB,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACvC,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,IAAI,CAAC,CAgCf;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAMtE"}

package/dist/overlays/zones.js

@@ -0,0 +1,69 @@
+export const ZONE_ID_PREFIX = 'argo-overlay-';
+const ZONE_POSITIONS = {
+    'bottom-center': {
+        position: 'fixed', bottom: '60px', left: '50%', transform: 'translateX(-50%)',
+    },
+    'top-left': {
+        position: 'fixed', top: '40px', left: '40px',
+    },
+    'top-right': {
+        position: 'fixed', top: '40px', right: '40px',
+    },
+    'bottom-left': {
+        position: 'fixed', bottom: '60px', left: '40px',
+    },
+    'bottom-right': {
+        position: 'fixed', bottom: '60px', right: '40px',
+    },
+    'center': {
+        position: 'fixed', top: '50%', left: '50%', transform: 'translate(-50%, -50%)',
+    },
+};
+/**
+ * Inject content into a zone. Replaces any existing overlay in that zone.
+ * Security: contentHtml is generated by template renderers which escape all
+ * text fields via escapeHtml(). Content originates from author-controlled
+ * manifest files, not end-user input.
+ */
+export async function injectIntoZone(page, zone, contentHtml, containerStyles, animationCSS) {
+    const zoneId = ZONE_ID_PREFIX + zone;
+    const positionStyles = ZONE_POSITIONS[zone];
+    const baseStyles = {
+        ...positionStyles,
+        zIndex: '999999',
+        pointerEvents: 'none',
+        fontFamily: 'system-ui, -apple-system, sans-serif',
+        ...containerStyles,
+    };
+    await page.evaluate(([id, html, styles, css]) => {
+        const existing = document.getElementById(id);
+        if (existing)
+            existing.remove();
+        if (css) {
+            const styleId = id + '-style';
+            let styleEl = document.getElementById(styleId);
+            if (!styleEl) {
+                styleEl = document.createElement('style');
+                styleEl.id = styleId;
+                document.head.appendChild(styleEl);
+            }
+            styleEl.textContent = css;
+        }
+        const container = document.createElement('div');
+        container.id = id;
+        container.innerHTML = html;
+        Object.assign(container.style, styles);
+        document.body.appendChild(container);
+    }, [zoneId, contentHtml, baseStyles, animationCSS ?? '']);
+}
+/**
+ * Remove the overlay in the specified zone, if any.
+ */
+export async function removeZone(page, zone) {
+    const zoneId = ZONE_ID_PREFIX + zone;
+    await page.evaluate((id) => {
+        document.getElementById(id)?.remove();
+        document.getElementById(id + '-style')?.remove();
+    }, zoneId);
+}
+//# sourceMappingURL=zones.js.map