@kvman/kvvideo 0.0.0-stage → 0.1.0

package/dist/compose/scene-args.d.ts

@@ -0,0 +1,12 @@
+import type { PlannedScene } from './scene-plan.ts';
+export type Size = {
+    width: number;
+    height: number;
+};
+/** The ASS file of a scene with captions, relative to the work folder. */
+export declare function assName(scene: PlannedScene): string;
+export declare function sceneArgs(scene: PlannedScene, size: Size, output: string): string[];
+/** The concat demuxer's list of the parts, in order. */
+export declare function joinList(parts: readonly string[]): string;
+export declare function joinArgs(list: string, output: string): string[];
+//# sourceMappingURL=scene-args.d.ts.map

package/dist/compose/scene-args.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scene-args.d.ts","sourceRoot":"","sources":["../../src/compose/scene-args.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAMpD,MAAM,MAAM,IAAI,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAgBrD,0EAA0E;AAC1E,wBAAgB,OAAO,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,CAEnD;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAgBnF;AAED,wDAAwD;AACxD,wBAAgB,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAEzD;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAE/D"}

package/dist/compose/scene-args.js

@@ -0,0 +1,42 @@
+import { framesPerSecond } from "../record/frame-writer.js";
+const seconds = (ms) => (ms / 1000).toFixed(3);
+const quiet = ['-hide_banner', '-loglevel', 'error'];
+function clipInput(scene) {
+    if (scene.kind === 'image')
+        return ['-loop', '1', '-framerate', String(framesPerSecond), '-t', seconds(scene.lengthMs), '-i', scene.clip];
+    return ['-ss', seconds(scene.startMs), '-t', seconds(scene.partMs), '-i', scene.clip];
+}
+function soundInput(scene) {
+    if (scene.narration !== undefined)
+        return ['-i', scene.narration];
+    return ['-f', 'lavfi', '-t', seconds(scene.lengthMs), '-i', 'anullsrc=channel_layout=stereo:sample_rate=48000'];
+}
+/** The ASS file of a scene with captions, relative to the work folder. */
+export function assName(scene) {
+    return `scene-${String(scene.number)}.ass`;
+}
+export function sceneArgs(scene, size, output) {
+    const { width, height } = size;
+    const fit = `scale=${String(width)}:${String(height)}:force_original_aspect_ratio=decrease,pad=${String(width)}:${String(height)}:(ow-iw)/2:(oh-ih)/2:color=black`;
+    const hold = `tpad=stop_mode=clone:stop_duration=${seconds(scene.lengthMs)}`;
+    const captions = scene.captions.length === 0 ? '' : `,subtitles=filename=${assName(scene)}:fontsdir=fonts`;
+    const graph = `[0:v]${fit},fps=${String(framesPerSecond)},format=yuv420p,${hold}${captions}[v];[1:a]aresample=48000,apad[a]`;
+    return [
+        ...quiet,
+        ...clipInput(scene),
+        ...soundInput(scene),
+        '-filter_complex', graph,
+        '-map', '[v]', '-map', '[a]',
+        '-c:v', 'libx264', '-preset', 'medium', '-crf', '20', '-pix_fmt', 'yuv420p', '-r', String(framesPerSecond),
+        '-c:a', 'aac', '-b:a', '160k', '-ar', '48000', '-ac', '2',
+        '-t', seconds(scene.lengthMs), '-y', output,
+    ];
+}
+/** The concat demuxer's list of the parts, in order. */
+export function joinList(parts) {
+    return parts.map((part) => `file '${part.replace(/'/g, "'\\''")}'\n`).join('');
+}
+export function joinArgs(list, output) {
+    return [...quiet, '-f', 'concat', '-safe', '0', '-i', list, '-c', 'copy', '-movflags', '+faststart', '-y', output];
+}
+//# sourceMappingURL=scene-args.js.map

package/dist/compose/scene-args.js.map

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

package/dist/compose/scene-plan.d.ts

@@ -0,0 +1,28 @@
+import type { Caption } from '../narration/captions.ts';
+import type { Scene } from './compose-input.ts';
+export declare const videoExtensions: string[];
+export declare const imageExtensions: string[];
+export declare const audioExtensions: string[];
+export type PlannedScene = {
+    number: number;
+    kind: 'video' | 'image';
+    clip: string;
+    startMs: number;
+    partMs: number;
+    lengthMs: number;
+    narration: string | undefined;
+    captions: Caption[];
+};
+export type SceneFiles = {
+    clip: string;
+    narration: string | undefined;
+};
+export type SceneDurations = {
+    clipMs: number | undefined;
+    narrationMs: number | undefined;
+};
+export declare function isImage(file: string): boolean;
+/** Checks what a scene needs before any file is read: an image has no part and has a length. */
+export declare function checkScene(number: number, scene: Scene): void;
+export declare function planScene(number: number, scene: Scene, files: SceneFiles, durations: SceneDurations): PlannedScene;
+//# sourceMappingURL=scene-plan.d.ts.map

package/dist/compose/scene-plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scene-plan.d.ts","sourceRoot":"","sources":["../../src/compose/scene-plan.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAKhD,eAAO,MAAM,eAAe,UAAoC,CAAC;AACjE,eAAO,MAAM,eAAe,UAAqC,CAAC;AAClE,eAAO,MAAM,eAAe,UAA2B,CAAC;AAExD,MAAM,MAAM,YAAY,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,QAAQ,EAAE,OAAO,EAAE,CAAA;CAAE,CAAC;AAE5L,MAAM,MAAM,UAAU,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC;AAEzE,MAAM,MAAM,cAAc,GAAG;IAAE,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,WAAW,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC;AAE7F,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE7C;AAED,gGAAgG;AAChG,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI,CAI7D;AAED,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,cAAc,GAAG,YAAY,CASlH"}

package/dist/compose/scene-plan.js

@@ -0,0 +1,32 @@
+import path from 'node:path';
+import { invalid } from "../problems.js";
+// A scene's length (plan 16 §16.7): its `durationMs`, else its narration's, else its video part's. A video part
+// shorter than the scene holds its last frame, and a longer one is cut.
+export const videoExtensions = ['.webm', '.mp4', '.mov', '.mkv'];
+export const imageExtensions = ['.png', '.jpg', '.jpeg', '.webp'];
+export const audioExtensions = ['.mp3', '.wav', '.m4a'];
+export function isImage(file) {
+    return imageExtensions.includes(path.extname(file).toLowerCase());
+}
+/** Checks what a scene needs before any file is read: an image has no part and has a length. */
+export function checkScene(number, scene) {
+    if (!isImage(scene.clip))
+        return;
+    if (scene.from !== undefined || scene.to !== undefined)
+        throw invalid(`Scene ${String(number)} is an image, which has no from or to.`, { scene: number });
+    if (scene.durationMs === undefined && scene.narration === undefined)
+        throw invalid(`Scene ${String(number)} is an image without a narration or durationMs, so it has no length.`, { scene: number });
+}
+export function planScene(number, scene, files, durations) {
+    checkScene(number, scene);
+    const base = { number, clip: files.clip, narration: files.narration, captions: scene.captions ?? [] };
+    if (isImage(files.clip))
+        return { ...base, kind: 'image', startMs: 0, partMs: 0, lengthMs: scene.durationMs ?? durations.narrationMs ?? 0 };
+    const clipMs = durations.clipMs ?? 0;
+    const startMs = scene.from ?? 0;
+    if (startMs >= clipMs)
+        throw invalid(`Scene ${String(number)} starts at ${String(startMs)} ms, past its clip's end.`, { scene: number });
+    const partMs = Math.min(scene.to ?? clipMs, clipMs) - startMs;
+    return { ...base, kind: 'video', startMs, partMs, lengthMs: scene.durationMs ?? durations.narrationMs ?? partMs };
+}
+//# sourceMappingURL=scene-plan.js.map

package/dist/compose/scene-plan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scene-plan.js","sourceRoot":"","sources":["../../src/compose/scene-plan.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAIzC,gHAAgH;AAChH,wEAAwE;AAExE,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AACjE,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;AAClE,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAQxD,MAAM,UAAU,OAAO,CAAC,IAAY;IAClC,OAAO,eAAe,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;AACpE,CAAC;AAED,gGAAgG;AAChG,MAAM,UAAU,UAAU,CAAC,MAAc,EAAE,KAAY;IACrD,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC;QAAE,OAAO;IACjC,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,IAAI,KAAK,CAAC,EAAE,KAAK,SAAS;QAAE,MAAM,OAAO,CAAC,SAAS,MAAM,CAAC,MAAM,CAAC,wCAAwC,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;IAC1J,IAAI,KAAK,CAAC,UAAU,KAAK,SAAS,IAAI,KAAK,CAAC,SAAS,KAAK,SAAS;QAAE,MAAM,OAAO,CAAC,SAAS,MAAM,CAAC,MAAM,CAAC,sEAAsE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;AACvM,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,MAAc,EAAE,KAAY,EAAE,KAAiB,EAAE,SAAyB;IAClG,UAAU,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAC1B,MAAM,IAAI,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,EAAE,EAAE,CAAC;IACtG,IAAI,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC;QAAE,OAAO,EAAE,GAAG,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,QAAQ,EAAE,KAAK,CAAC,UAAU,IAAI,SAAS,CAAC,WAAW,IAAI,CAAC,EAAE,CAAC;IAC5I,MAAM,MAAM,GAAG,SAAS,CAAC,MAAM,IAAI,CAAC,CAAC;IACrC,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,IAAI,CAAC,CAAC;IAChC,IAAI,OAAO,IAAI,MAAM;QAAE,MAAM,OAAO,CAAC,SAAS,MAAM,CAAC,MAAM,CAAC,cAAc,MAAM,CAAC,OAAO,CAAC,2BAA2B,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;IACzI,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,IAAI,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC;IAC9D,OAAO,EAAE,GAAG,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,CAAC,UAAU,IAAI,SAAS,CAAC,WAAW,IAAI,MAAM,EAAE,CAAC;AACpH,CAAC"}

package/dist/connector.d.ts

@@ -0,0 +1,79 @@
+export declare const connectorName = "video";
+export declare const videoConnector: {
+    name: string;
+    optIn: true;
+    description: string;
+    commands: ({
+        name: string;
+        command: string;
+        examples: {
+            description: string;
+            input: {};
+        }[];
+        card?: never;
+    } | {
+        name: string;
+        command: string;
+        examples: {
+            description: string;
+            input: {
+                url: string;
+                file: string;
+                steps: ({
+                    do: string;
+                    target: string;
+                    text: string;
+                    ms?: never;
+                } | {
+                    do: string;
+                    target: string;
+                    text?: never;
+                    ms?: never;
+                } | {
+                    do: string;
+                    ms: number;
+                    target?: never;
+                    text?: never;
+                })[];
+            };
+        }[];
+        card?: never;
+    } | {
+        name: string;
+        command: string;
+        examples: {
+            description: string;
+            input: {
+                text: string;
+                file: string;
+            };
+        }[];
+        card?: never;
+    } | {
+        name: string;
+        command: string;
+        card: string;
+        examples: {
+            description: string;
+            input: {
+                file: string;
+                scenes: ({
+                    clip: string;
+                    durationMs: number;
+                    narration?: never;
+                    captions?: never;
+                } | {
+                    clip: string;
+                    narration: string;
+                    captions: {
+                        text: string;
+                        startMs: number;
+                        endMs: number;
+                    }[];
+                    durationMs?: never;
+                })[];
+            };
+        }[];
+    })[];
+};
+//# sourceMappingURL=connector.d.ts.map

package/dist/connector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connector.d.ts","sourceRoot":"","sources":["../src/connector.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,aAAa,UAAU,CAAC;AAErC,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwC1B,CAAC"}

package/dist/connector.js

@@ -0,0 +1,44 @@
+// The `video` connector (plan 16 §16.1 and §16.3; ADR 0107, 11): `optIn`, so a chat has it only after `/video`.
+export const connectorName = 'video';
+export const videoConnector = {
+    name: connectorName,
+    optIn: true,
+    description: 'Make videos: record pages of an app running on this computer, narrate a script, and join them with captions into an MP4. Use it when the person asks for a video, a tutorial, a demo, or a promotion.',
+    commands: [
+        { name: 'check', command: 'kvvideo.setup.get', examples: [{ description: 'See what is ready before making a video', input: {} }] },
+        { name: 'fonts', command: 'kvvideo.font.list', examples: [{ description: 'List the bundled caption fonts', input: {} }] },
+        {
+            name: 'record',
+            command: 'kvvideo.clip.record',
+            examples: [
+                {
+                    description: 'Record signing in to the app on its dev server',
+                    input: { url: 'http://localhost:5173/', file: 'videos/tour/01-sign-in.mp4', steps: [{ do: 'type', target: 'role=textbox[name="Email"]', text: 'sam@example.com' }, { do: 'click', target: 'role=button[name="Sign in"]' }, { do: 'wait', ms: 1500 }] },
+                },
+            ],
+        },
+        {
+            name: 'narrate',
+            command: 'kvvideo.narration.make',
+            examples: [{ description: "Narrate the first scene's script", input: { text: 'This is Notes. Sign in with your email to see your notes.', file: 'videos/tour/01-sign-in.mp3' } }],
+        },
+        {
+            name: 'compose',
+            command: 'kvvideo.video.compose',
+            card: 'kvvideo.player',
+            examples: [
+                {
+                    description: 'Join a title image and a narrated recording, with captions',
+                    input: {
+                        file: 'videos/tour.mp4',
+                        scenes: [
+                            { clip: 'videos/tour/00-title.png', durationMs: 2000 },
+                            { clip: 'videos/tour/01-sign-in.mp4', narration: 'videos/tour/01-sign-in.mp3', captions: [{ text: 'This is Notes.', startMs: 0, endMs: 1200 }] },
+                        ],
+                    },
+                },
+            ],
+        },
+    ],
+};
+//# sourceMappingURL=connector.js.map

package/dist/connector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connector.js","sourceRoot":"","sources":["../src/connector.ts"],"names":[],"mappings":"AAAA,gHAAgH;AAEhH,MAAM,CAAC,MAAM,aAAa,GAAG,OAAO,CAAC;AAErC,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,IAAI,EAAE,aAAa;IACnB,KAAK,EAAE,IAAa;IACpB,WAAW,EAAE,uMAAuM;IACpN,QAAQ,EAAE;QACR,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,mBAAmB,EAAE,QAAQ,EAAE,CAAC,EAAE,WAAW,EAAE,yCAAyC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,EAAE;QAClI,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,mBAAmB,EAAE,QAAQ,EAAE,CAAC,EAAE,WAAW,EAAE,gCAAgC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,EAAE;QACzH;YACE,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,qBAAqB;YAC9B,QAAQ,EAAE;gBACR;oBACE,WAAW,EAAE,gDAAgD;oBAC7D,KAAK,EAAE,EAAE,GAAG,EAAE,wBAAwB,EAAE,IAAI,EAAE,4BAA4B,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,4BAA4B,EAAE,IAAI,EAAE,iBAAiB,EAAE,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,6BAA6B,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE;iBACvP;aACF;SACF;QACD;YACE,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,wBAAwB;YACjC,QAAQ,EAAE,CAAC,EAAE,WAAW,EAAE,kCAAkC,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,2DAA2D,EAAE,IAAI,EAAE,4BAA4B,EAAE,EAAE,CAAC;SAClL;QACD;YACE,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,uBAAuB;YAChC,IAAI,EAAE,gBAAgB;YACtB,QAAQ,EAAE;gBACR;oBACE,WAAW,EAAE,4DAA4D;oBACzE,KAAK,EAAE;wBACL,IAAI,EAAE,iBAAiB;wBACvB,MAAM,EAAE;4BACN,EAAE,IAAI,EAAE,0BAA0B,EAAE,UAAU,EAAE,IAAI,EAAE;4BACtD,EAAE,IAAI,EAAE,4BAA4B,EAAE,SAAS,EAAE,4BAA4B,EAAE,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,EAAE;yBACjJ;qBACF;iBACF;aACF;SACF;KACF;CACF,CAAC"}

package/dist/files/answer-path.d.ts

@@ -0,0 +1,3 @@
+/** A workspace file as an answer names it: relative to the workspace, with `/` on every OS. */
+export declare function answerPath(root: string, absolute: string): string;
+//# sourceMappingURL=answer-path.d.ts.map

package/dist/files/answer-path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"answer-path.d.ts","sourceRoot":"","sources":["../../src/files/answer-path.ts"],"names":[],"mappings":"AAEA,+FAA+F;AAC/F,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEjE"}

package/dist/files/answer-path.js

@@ -0,0 +1,6 @@
+import path from 'node:path';
+/** A workspace file as an answer names it: relative to the workspace, with `/` on every OS. */
+export function answerPath(root, absolute) {
+    return path.relative(root, absolute).split(path.sep).join('/');
+}
+//# sourceMappingURL=answer-path.js.map

package/dist/files/answer-path.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"answer-path.js","sourceRoot":"","sources":["../../src/files/answer-path.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,+FAA+F;AAC/F,MAAM,UAAU,UAAU,CAAC,IAAY,EAAE,QAAgB;IACvD,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACjE,CAAC"}

package/dist/files/place-output.d.ts

@@ -0,0 +1,8 @@
+/** A temporary folder for one call's work, deleted with `remove`. */
+export declare function workFolder(): {
+    folder: string;
+    remove(): void;
+};
+/** Puts a finished file at its output path. */
+export declare function placeOutput(made: string, output: string): void;
+//# sourceMappingURL=place-output.d.ts.map

package/dist/files/place-output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"place-output.d.ts","sourceRoot":"","sources":["../../src/files/place-output.ts"],"names":[],"mappings":"AASA,qEAAqE;AACrE,wBAAgB,UAAU,IAAI;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,IAAI,IAAI,CAAA;CAAE,CAG/D;AAED,+CAA+C;AAC/C,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAQ9D"}

package/dist/files/place-output.js

@@ -0,0 +1,24 @@
+import { randomUUID } from 'node:crypto';
+import { copyFileSync, mkdtempSync, renameSync, rmSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import path from 'node:path';
+// Outputs are made in a temporary folder and placed beside their path under a temporary name, then renamed over it,
+// so a failed call leaves no file and the old one in place (plan 16 §16.3). The temporary folder may be on another
+// disk, so the file is copied beside its path first.
+/** A temporary folder for one call's work, deleted with `remove`. */
+export function workFolder() {
+    const folder = mkdtempSync(path.join(tmpdir(), 'kvvideo-'));
+    return { folder, remove: () => rmSync(folder, { recursive: true, force: true }) };
+}
+/** Puts a finished file at its output path. */
+export function placeOutput(made, output) {
+    const beside = path.join(path.dirname(output), `.${path.basename(output)}.${randomUUID()}.tmp`);
+    try {
+        copyFileSync(made, beside);
+        renameSync(beside, output);
+    }
+    finally {
+        rmSync(beside, { force: true });
+    }
+}
+//# sourceMappingURL=place-output.js.map

package/dist/files/place-output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"place-output.js","sourceRoot":"","sources":["../../src/files/place-output.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACxE,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,oHAAoH;AACpH,mHAAmH;AACnH,qDAAqD;AAErD,qEAAqE;AACrE,MAAM,UAAU,UAAU;IACxB,MAAM,MAAM,GAAG,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,UAAU,CAAC,CAAC,CAAC;IAC5D,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;AACpF,CAAC;AAED,+CAA+C;AAC/C,MAAM,UAAU,WAAW,CAAC,IAAY,EAAE,MAAc;IACtD,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,UAAU,EAAE,MAAM,CAAC,CAAC;IAChG,IAAI,CAAC;QACH,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAC3B,UAAU,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,CAAC;YAAS,CAAC;QACT,MAAM,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAClC,CAAC;AACH,CAAC"}

package/dist/files/workspace-paths.d.ts

@@ -0,0 +1,7 @@
+/** A path of the workspace, made absolute; one that leaves it fails `VALIDATION_FAILED`. */
+export declare function workspacePath(root: string, file: string): string;
+/** An existing input file of one of the extensions. */
+export declare function inputPath(root: string, file: string, extensions: readonly string[]): string;
+/** An output file with the extension, its folders made; an existing one only with `replace`. */
+export declare function outputPath(root: string, file: string, extension: string, replace: boolean): string;
+//# sourceMappingURL=workspace-paths.d.ts.map

package/dist/files/workspace-paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-paths.d.ts","sourceRoot":"","sources":["../../src/files/workspace-paths.ts"],"names":[],"mappings":"AAmBA,4FAA4F;AAC5F,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAKhE;AAMD,uDAAuD;AACvD,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAK3F;AAED,gGAAgG;AAChG,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,MAAM,CAMlG"}

package/dist/files/workspace-paths.js

@@ -0,0 +1,48 @@
+import { existsSync, mkdirSync, realpathSync, statSync } from 'node:fs';
+import path from 'node:path';
+import { invalid, notFound } from "../problems.js";
+// Where kvvideo reads and writes (plan 16 §16.3): every path is inside the workspace folder, through `..` and symlinks
+// alike. An input must exist; an output has its command's extension and is replaced only when asked.
+function inside(root, candidate) {
+    const relative = path.relative(root, candidate);
+    return relative === '' || (!relative.startsWith('..') && !path.isAbsolute(relative));
+}
+// The real path of the nearest part of `absolute` that exists, so a symlink anywhere along it is followed.
+function realOfNearest(absolute) {
+    let existing = absolute;
+    while (!existsSync(existing))
+        existing = path.dirname(existing);
+    return path.join(realpathSync(existing), path.relative(existing, absolute));
+}
+/** A path of the workspace, made absolute; one that leaves it fails `VALIDATION_FAILED`. */
+export function workspacePath(root, file) {
+    if (file.trim() === '')
+        throw invalid('The path is empty.', { path: file });
+    const absolute = path.resolve(root, file);
+    if (!inside(root, absolute) || !inside(realpathSync(root), realOfNearest(absolute)))
+        throw invalid(`${file} is outside the workspace folder.`, { path: file });
+    return absolute;
+}
+function hasExtension(file, extensions) {
+    return extensions.includes(path.extname(file).toLowerCase());
+}
+/** An existing input file of one of the extensions. */
+export function inputPath(root, file, extensions) {
+    const absolute = workspacePath(root, file);
+    if (!hasExtension(file, extensions))
+        throw invalid(`${file} isn't one of ${extensions.join(', ')}.`, { path: file, extensions: [...extensions] });
+    if (!existsSync(absolute) || !statSync(absolute).isFile())
+        throw notFound(`${file} doesn't exist.`, { path: file });
+    return absolute;
+}
+/** An output file with the extension, its folders made; an existing one only with `replace`. */
+export function outputPath(root, file, extension, replace) {
+    const absolute = workspacePath(root, file);
+    if (!hasExtension(file, [extension]))
+        throw invalid(`${file} must end with ${extension}.`, { path: file, extension });
+    if (existsSync(absolute) && !replace)
+        throw invalid(`${file} exists; set replace to true to write over it.`, { path: file });
+    mkdirSync(path.dirname(absolute), { recursive: true });
+    return absolute;
+}
+//# sourceMappingURL=workspace-paths.js.map

package/dist/files/workspace-paths.js.map

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

package/dist/fonts/bundled-fonts.d.ts

@@ -0,0 +1,10 @@
+export type FontScript = 'latin' | 'arabic';
+export type BundledFont = {
+    name: string;
+    file: string;
+    scripts: FontScript[];
+};
+export declare const bundledFonts: readonly BundledFont[];
+/** The folder that holds the bundled fonts, from the source and the build alike. */
+export declare const fontsFolder: string;
+//# sourceMappingURL=bundled-fonts.d.ts.map

package/dist/fonts/bundled-fonts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundled-fonts.d.ts","sourceRoot":"","sources":["../../src/fonts/bundled-fonts.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,QAAQ,CAAC;AAE5C,MAAM,MAAM,WAAW,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,UAAU,EAAE,CAAA;CAAE,CAAC;AAEhF,eAAO,MAAM,YAAY,EAAE,SAAS,WAAW,EAK9C,CAAC;AAEF,oFAAoF;AACpF,eAAO,MAAM,WAAW,QAA0D,CAAC"}

package/dist/fonts/bundled-fonts.js

@@ -0,0 +1,10 @@
+import { fileURLToPath } from 'node:url';
+export const bundledFonts = [
+    { name: 'Amiri', file: 'Amiri-Bold.ttf', scripts: ['arabic', 'latin'] },
+    { name: 'IBM Plex Sans Arabic', file: 'IBMPlexSansArabic-Bold.ttf', scripts: ['arabic', 'latin'] },
+    { name: 'Lato', file: 'Lato-Bold.ttf', scripts: ['latin'] },
+    { name: 'Poppins', file: 'Poppins-Bold.ttf', scripts: ['latin'] },
+];
+/** The folder that holds the bundled fonts, from the source and the build alike. */
+export const fontsFolder = fileURLToPath(new URL('../../fonts/', import.meta.url));
+//# sourceMappingURL=bundled-fonts.js.map

package/dist/fonts/bundled-fonts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundled-fonts.js","sourceRoot":"","sources":["../../src/fonts/bundled-fonts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAQzC,MAAM,CAAC,MAAM,YAAY,GAA2B;IAClD,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,CAAC,QAAQ,EAAE,OAAO,CAAC,EAAE;IACvE,EAAE,IAAI,EAAE,sBAAsB,EAAE,IAAI,EAAE,4BAA4B,EAAE,OAAO,EAAE,CAAC,QAAQ,EAAE,OAAO,CAAC,EAAE;IAClG,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,CAAC,OAAO,CAAC,EAAE;IAC3D,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,kBAAkB,EAAE,OAAO,EAAE,CAAC,OAAO,CAAC,EAAE;CAClE,CAAC;AAEF,oFAAoF;AACpF,MAAM,CAAC,MAAM,WAAW,GAAG,aAAa,CAAC,IAAI,GAAG,CAAC,cAAc,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC"}

package/dist/fonts/font-family.d.ts

@@ -0,0 +1,2 @@
+export declare function fontFamily(font: Buffer, file: string): string;
+//# sourceMappingURL=font-family.d.ts.map

package/dist/fonts/font-family.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"font-family.d.ts","sourceRoot":"","sources":["../../src/fonts/font-family.ts"],"names":[],"mappings":"AAoCA,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAS7D"}

package/dist/fonts/font-family.js

@@ -0,0 +1,43 @@
+import { invalid } from "../problems.js";
+function nameTableOffset(font) {
+    if (font.length < 12)
+        return undefined;
+    const version = font.readUInt32BE(0);
+    if (version !== 0x00010000 && version !== 0x4f54544f && version !== 0x74727565)
+        return undefined;
+    const tables = font.readUInt16BE(4);
+    for (let index = 0; index < tables; index += 1) {
+        const at = 12 + index * 16;
+        if (at + 16 > font.length)
+            return undefined;
+        if (font.toString('latin1', at, at + 4) === 'name')
+            return font.readUInt32BE(at + 8);
+    }
+    return undefined;
+}
+function recordsOf(font, table) {
+    const count = font.readUInt16BE(table + 2);
+    const strings = table + font.readUInt16BE(table + 4);
+    const records = Array.from({ length: count }, (_, index) => {
+        const at = table + 6 + index * 12;
+        return { platform: font.readUInt16BE(at), encoding: font.readUInt16BE(at + 2), language: font.readUInt16BE(at + 4), nameId: font.readUInt16BE(at + 6), length: font.readUInt16BE(at + 8), offset: font.readUInt16BE(at + 10) };
+    });
+    return { records, strings };
+}
+function decode(font, strings, record) {
+    const bytes = font.subarray(strings + record.offset, strings + record.offset + record.length);
+    return record.platform === 3 ? Buffer.from(bytes).swap16().toString('utf16le') : bytes.toString('latin1');
+}
+export function fontFamily(font, file) {
+    const table = nameTableOffset(font);
+    if (table === undefined || table + 6 > font.length)
+        throw invalid(`${file} isn't a TrueType or OpenType font.`, { path: file });
+    const { records, strings } = recordsOf(font, table);
+    const families = records.filter((record) => record.nameId === 1);
+    const windows = families.filter((record) => record.platform === 3 && (record.encoding === 1 || record.encoding === 10));
+    const chosen = windows.find((record) => record.language === 0x409) ?? windows[0] ?? families.find((record) => record.platform === 1 && record.encoding === 0);
+    if (chosen === undefined || strings + chosen.offset + chosen.length > font.length)
+        throw invalid(`${file} has no family name.`, { path: file });
+    return decode(font, strings, chosen);
+}
+//# sourceMappingURL=font-family.js.map

package/dist/fonts/font-family.js.map

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

package/dist/fonts/register-fonts.d.ts

@@ -0,0 +1,3 @@
+import { type Ctx } from '@kvman/sdk';
+export declare function registerFonts(ctx: Ctx): void;
+//# sourceMappingURL=register-fonts.d.ts.map

package/dist/fonts/register-fonts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-fonts.d.ts","sourceRoot":"","sources":["../../src/fonts/register-fonts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAK,KAAK,GAAG,EAAE,MAAM,YAAY,CAAC;AAGzC,wBAAgB,aAAa,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI,CAQ5C"}

package/dist/fonts/register-fonts.js

@@ -0,0 +1,12 @@
+import { z } from '@kvman/sdk';
+import { bundledFonts } from "./bundled-fonts.js";
+export function registerFonts(ctx) {
+    ctx.registerQuery('kvvideo.font.list', {
+        description: 'Lists the fonts bundled for captions, with the scripts each one writes.',
+        input: z.object({}),
+        output: z.array(z.object({ name: z.string(), scripts: z.array(z.enum(['latin', 'arabic'])) })),
+        public: true,
+        handle: () => bundledFonts.map(({ name, scripts }) => ({ name, scripts })),
+    });
+}
+//# sourceMappingURL=register-fonts.js.map

package/dist/fonts/register-fonts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-fonts.js","sourceRoot":"","sources":["../../src/fonts/register-fonts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAY,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,MAAM,UAAU,aAAa,CAAC,GAAQ;IACpC,GAAG,CAAC,aAAa,CAAC,mBAAmB,EAAE;QACrC,WAAW,EAAE,yEAAyE;QACtF,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;QACnB,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAC9F,MAAM,EAAE,IAAI;QACZ,MAAM,EAAE,GAAG,EAAE,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;KAC3E,CAAC,CAAC;AACL,CAAC"}

package/dist/guide.d.ts

@@ -0,0 +1,3 @@
+/** The guide `/video` puts in a chat's prompt (plan 16 §16.1), from `docs/guide.md`. */
+export declare function readGuide(): string;
+//# sourceMappingURL=guide.d.ts.map

package/dist/guide.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guide.d.ts","sourceRoot":"","sources":["../src/guide.ts"],"names":[],"mappings":"AAEA,wFAAwF;AACxF,wBAAgB,SAAS,IAAI,MAAM,CAElC"}

package/dist/guide.js

@@ -0,0 +1,6 @@
+import { readFileSync } from 'node:fs';
+/** The guide `/video` puts in a chat's prompt (plan 16 §16.1), from `docs/guide.md`. */
+export function readGuide() {
+    return readFileSync(new URL('../docs/guide.md', import.meta.url), 'utf8');
+}
+//# sourceMappingURL=guide.js.map

package/dist/guide.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"guide.js","sourceRoot":"","sources":["../src/guide.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEvC,wFAAwF;AACxF,MAAM,UAAU,SAAS;IACvB,OAAO,YAAY,CAAC,IAAI,GAAG,CAAC,kBAAkB,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,CAAC;AAC5E,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+import type { Ctx } from '@kvman/sdk';
+export type {} from './api.ts';
+declare const _default: (ctx: Ctx) => void;
+export default _default;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC;AAWtC,YAAY,EAAE,MAAM,UAAU,CAAC;yBAKf,KAAK,GAAG,KAAG,IAAI;AAA/B,wBAUE"}

package/dist/index.js

@@ -0,0 +1,24 @@
+import { registerCompose } from "./compose/register-compose.js";
+import { registerFonts } from "./fonts/register-fonts.js";
+import { registerNarration } from "./narration/register-narration.js";
+import { registerRecord } from "./record/register-record.js";
+import { registerWithKvcoder } from "./register-with-kvcoder.js";
+import { registerSettings } from "./settings.js";
+import { registerSetup } from "./setup/register-setup.js";
+import { registerUi } from "./ui.js";
+import { registerVideoStart } from "./video-start.js";
+// kvvideo (plan 16): makes videos of the person's app, recorded in the installed browser, narrated, and captioned. It
+// has no loop of its own; it extends kvcoder with the `video` connector and its guide, which a chat has once the
+// person runs `/video` in it (ADR 0107).
+export default (ctx) => {
+    registerSettings(ctx);
+    registerUi(ctx);
+    registerSetup(ctx);
+    registerFonts(ctx);
+    registerRecord(ctx);
+    registerNarration(ctx);
+    registerCompose(ctx);
+    registerVideoStart(ctx);
+    registerWithKvcoder(ctx);
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AACtE,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAItD,sHAAsH;AACtH,iHAAiH;AACjH,yCAAyC;AACzC,eAAe,CAAC,GAAQ,EAAQ,EAAE;IAChC,gBAAgB,CAAC,GAAG,CAAC,CAAC;IACtB,UAAU,CAAC,GAAG,CAAC,CAAC;IAChB,aAAa,CAAC,GAAG,CAAC,CAAC;IACnB,aAAa,CAAC,GAAG,CAAC,CAAC;IACnB,cAAc,CAAC,GAAG,CAAC,CAAC;IACpB,iBAAiB,CAAC,GAAG,CAAC,CAAC;IACvB,eAAe,CAAC,GAAG,CAAC,CAAC;IACrB,kBAAkB,CAAC,GAAG,CAAC,CAAC;IACxB,mBAAmB,CAAC,GAAG,CAAC,CAAC;AAC3B,CAAC,CAAC"}

package/dist/narration/captions.d.ts

@@ -0,0 +1,10 @@
+export type Caption = {
+    text: string;
+    startMs: number;
+    endMs: number;
+};
+/** The caption lines of a text, in order. */
+export declare function captionLines(text: string): string[];
+/** The text's captions over a narration of `durationMs`. */
+export declare function timedCaptions(text: string, durationMs: number): Caption[];
+//# sourceMappingURL=captions.d.ts.map

package/dist/narration/captions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"captions.d.ts","sourceRoot":"","sources":["../../src/narration/captions.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,OAAO,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AA0BvE,6CAA6C;AAC7C,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAGnD;AAED,4DAA4D;AAC5D,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,EAAE,CAUzE"}