@kvman/kvvideo 0.0.0-stage → 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ahmed Deif
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,11 @@
-# Temporary Holding Version
+# @kvman/kvvideo
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+The [kvman](https://github.com/ibndeif/kvman) extension that makes any kind of video from a chat (a lesson, an explainer, a tutorial, a promotion, a story, a social clip): it records websites and HTML pages in the installed Chrome or Edge, narrates a script with ElevenLabs, OpenAI, or Piper, and joins them with burned-in captions into an MP4 with ffmpeg. It is bundled with kvman, and needs `@kvman/kvcoder` and `@kvman/kvwebui`. Type `/video` in a chat to turn it on.
+
+## Fonts
+
+`fonts/` holds Amiri, IBM Plex Sans Arabic, Lato, and Poppins in their bold weights, each under the SIL Open Font License beside it.
+
+## License
+
+MIT

package/dist/api.d.ts

@@ -0,0 +1,105 @@
+import type { z } from '@kvman/sdk';
+import type { composeInputSchema, composeOutputSchema } from './compose/compose-input.ts';
+import type { narrateInputSchema, narrateOutputSchema } from './narration/register-narration.ts';
+import type { recordInputSchema, recordOutputSchema } from './record/steps.ts';
+import type { reviewOutputSchema } from './review/register-review.ts';
+import type { voiceInputSchema, voiceOutputSchema } from './narration/register-voice.ts';
+import type { Brand } from './brand/brand.ts';
+import type { BrowserChoice, NarrationService } from './settings.ts';
+type Empty = Record<string, never>;
+type Channel = 'chrome' | 'msedge';
+declare module '@kvman/sdk' {
+    interface Commands {
+        'kvvideo.video.start': {
+            input: {
+                sessionId: string;
+                argument: string;
+            };
+            output: Empty;
+        };
+        'kvvideo.video.compose': {
+            input: z.input<typeof composeInputSchema>;
+            output: z.output<typeof composeOutputSchema>;
+        };
+        'kvvideo.narration.make': {
+            input: z.input<typeof narrateInputSchema>;
+            output: z.output<typeof narrateOutputSchema>;
+        };
+        'kvvideo.clip.record': {
+            input: z.input<typeof recordInputSchema>;
+            output: z.output<typeof recordOutputSchema>;
+        };
+        'kvvideo.brand.set': {
+            input: Brand;
+            output: Empty;
+        };
+        'kvvideo.voice.make': {
+            input: z.input<typeof voiceInputSchema>;
+            output: z.output<typeof voiceOutputSchema>;
+        };
+        'kvvideo.video.review': {
+            input: {
+                file: string;
+            };
+            output: z.output<typeof reviewOutputSchema>;
+        };
+    }
+    interface Queries {
+        'kvvideo.setup.get': {
+            input: Empty;
+            output: {
+                ffmpeg: {
+                    ready: boolean;
+                    version: string | null;
+                    missing: string[];
+                };
+                browser: {
+                    ready: boolean;
+                    channel: Channel | null;
+                };
+                narration: {
+                    service: NarrationService | null;
+                    ready: boolean;
+                    missing: string | null;
+                };
+            };
+        };
+        'kvvideo.ui.get': {
+            input: Empty;
+            output: {
+                pages: unknown[];
+                nav: unknown[];
+                panels: unknown[];
+                status: unknown[];
+                configuration: unknown;
+            };
+        };
+        'kvvideo.font.list': {
+            input: Empty;
+            output: {
+                name: string;
+                scripts: ('latin' | 'arabic')[];
+            }[];
+        };
+        'kvvideo.brand.get': {
+            input: Empty;
+            output: Brand | null;
+        };
+    }
+    interface Settings {
+        'kvvideo.narration.service': NarrationService | null;
+        'kvvideo.narration.voice': string | null;
+        'kvvideo.narration.model': string | null;
+        'kvvideo.narration.pronunciations': {
+            word: string;
+            say: string;
+        }[];
+        'kvvideo.brand': Brand | null;
+        'kvvideo.browser': BrowserChoice;
+        'kvvideo.programs.ffmpeg': string;
+        'kvvideo.programs.ffprobe': string;
+        'kvvideo.programs.piper': string;
+    }
+}
+export {};
+//# sourceMappingURL=api.d.ts.map

package/dist/api.d.ts.map

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

package/dist/api.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=api.js.map

package/dist/api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":""}

package/dist/brand/brand.d.ts

@@ -0,0 +1,17 @@
+import { z, type Ctx } from '@kvman/sdk';
+export declare const brandSchema: z.ZodObject<{
+    logo: z.ZodNullable<z.ZodString>;
+    colors: z.ZodObject<{
+        primary: z.ZodString;
+        background: z.ZodString;
+        text: z.ZodString;
+    }, z.core.$strict>;
+    font: z.ZodNullable<z.ZodString>;
+}, z.core.$strict>;
+/** A workspace's brand. */
+export type Brand = z.output<typeof brandSchema>;
+export declare const logoExtensions: string[];
+/** Checks a brand's files and font in the workspace `root`. */
+export declare function checkBrand(root: string, brand: Brand): void;
+export declare function registerBrand(ctx: Ctx): void;
+//# sourceMappingURL=brand.d.ts.map

package/dist/brand/brand.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"brand.d.ts","sourceRoot":"","sources":["../../src/brand/brand.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,KAAK,GAAG,EAAE,MAAM,YAAY,CAAC;AASzC,eAAO,MAAM,WAAW;;;;;;;;kBAItB,CAAC;AAEH,2BAA2B;AAC3B,MAAM,MAAM,KAAK,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,WAAW,CAAC,CAAC;AAEjD,eAAO,MAAM,cAAc,UAA6C,CAAC;AAEzE,+DAA+D;AAC/D,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI,CAG3D;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI,CAuB5C"}

package/dist/brand/brand.js

@@ -0,0 +1,44 @@
+import { z } from '@kvman/sdk';
+import { captionFont } from "../compose/caption-font.js";
+import { inputPath } from "../files/workspace-paths.js";
+// The workspace's brand (plan 16 §16.2 and §16.4; ADR 0115, 21 and 43): its logo, colours, and font, read with
+// `video brand` and set with `video brand-set` without asking, since the person agreed to it in the script.
+const colour = z.string().regex(/^#[0-9a-fA-F]{6}$/, 'A colour is #RRGGBB.');
+export const brandSchema = z.strictObject({
+    logo: z.string().min(1).max(1000).nullable().describe('A .png, .svg, .jpg, or .webp file in the workspace, or null.'),
+    colors: z.strictObject({ primary: colour, background: colour, text: colour }),
+    font: z.string().min(1).max(1000).nullable().describe('A bundled font (video fonts), a .ttf or .otf file in the workspace, or null.'),
+});
+export const logoExtensions = ['.png', '.svg', '.jpg', '.jpeg', '.webp'];
+/** Checks a brand's files and font in the workspace `root`. */
+export function checkBrand(root, brand) {
+    if (brand.logo !== null)
+        inputPath(root, brand.logo, logoExtensions);
+    if (brand.font !== null)
+        captionFont(root, brand.font, []);
+}
+export function registerBrand(ctx) {
+    ctx.registerSetting('kvvideo.brand', { description: "The workspace's brand for its videos: a logo file, the primary, background, and text colours, and a font; null for none.", schema: brandSchema.nullable(), default: null });
+    ctx.registerQuery('kvvideo.brand.get', {
+        description: "Gives the workspace's brand for videos: its logo, colours, and font, or null.",
+        input: z.strictObject({}),
+        output: brandSchema.nullable(),
+        public: true,
+        timeoutMs: 60_000,
+        handle: async () => ctx.settings.get('kvvideo.brand'),
+    });
+    ctx.registerCommand('kvvideo.brand.set', {
+        description: "Sets the workspace's brand for videos: its logo, colours, and font.",
+        input: brandSchema,
+        output: z.strictObject({}),
+        public: true,
+        retries: 0,
+        timeoutMs: 60_000,
+        handle: async (input) => {
+            checkBrand(ctx.job.workspace.path, input);
+            await ctx.settings.set('kvvideo.brand', input, { scope: 'workspace' });
+            return {};
+        },
+    });
+}
+//# sourceMappingURL=brand.js.map

package/dist/brand/brand.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"brand.js","sourceRoot":"","sources":["../../src/brand/brand.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAY,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAExD,+GAA+G;AAC/G,4GAA4G;AAE5G,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,mBAAmB,EAAE,sBAAsB,CAAC,CAAC;AAE7E,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAC,YAAY,CAAC;IACxC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,8DAA8D,CAAC;IACrH,MAAM,EAAE,CAAC,CAAC,YAAY,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IAC7E,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,8EAA8E,CAAC;CACtI,CAAC,CAAC;AAKH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;AAEzE,+DAA+D;AAC/D,MAAM,UAAU,UAAU,CAAC,IAAY,EAAE,KAAY;IACnD,IAAI,KAAK,CAAC,IAAI,KAAK,IAAI;QAAE,SAAS,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC;IACrE,IAAI,KAAK,CAAC,IAAI,KAAK,IAAI;QAAE,WAAW,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;AAC7D,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,GAAQ;IACpC,GAAG,CAAC,eAAe,CAAC,eAAe,EAAE,EAAE,WAAW,EAAE,0HAA0H,EAAE,MAAM,EAAE,WAAW,CAAC,QAAQ,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;IACjO,GAAG,CAAC,aAAa,CAAC,mBAAmB,EAAE;QACrC,WAAW,EAAE,+EAA+E;QAC5F,KAAK,EAAE,CAAC,CAAC,YAAY,CAAC,EAAE,CAAC;QACzB,MAAM,EAAE,WAAW,CAAC,QAAQ,EAAE;QAC9B,MAAM,EAAE,IAAI;QACZ,SAAS,EAAE,MAAM;QACjB,MAAM,EAAE,KAAK,IAAI,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,eAAe,CAAC;KACtD,CAAC,CAAC;IACH,GAAG,CAAC,eAAe,CAAC,mBAAmB,EAAE;QACvC,WAAW,EAAE,qEAAqE;QAClF,KAAK,EAAE,WAAW;QAClB,MAAM,EAAE,CAAC,CAAC,YAAY,CAAC,EAAE,CAAC;QAC1B,MAAM,EAAE,IAAI;QACZ,OAAO,EAAE,CAAC;QACV,SAAS,EAAE,MAAM;QACjB,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;YACtB,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;YAC1C,MAAM,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,eAAe,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC,CAAC;YACvE,OAAO,EAAE,CAAC;QACZ,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/browser/channels.d.ts

@@ -0,0 +1,6 @@
+import type { BrowserChoice } from '../settings.ts';
+/** An installed browser that Playwright can drive. */
+export type Channel = 'chrome' | 'msedge';
+/** The channels a choice tries, in order (plan 16 §16.4). */
+export declare function channelsOf(choice: BrowserChoice): Channel[];
+//# sourceMappingURL=channels.d.ts.map

package/dist/browser/channels.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"channels.d.ts","sourceRoot":"","sources":["../../src/browser/channels.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAEpD,sDAAsD;AACtD,MAAM,MAAM,OAAO,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE1C,6DAA6D;AAC7D,wBAAgB,UAAU,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,EAAE,CAE3D"}

package/dist/browser/channels.js

@@ -0,0 +1,5 @@
+/** The channels a choice tries, in order (plan 16 §16.4). */
+export function channelsOf(choice) {
+    return choice === 'auto' ? ['chrome', 'msedge'] : [choice];
+}
+//# sourceMappingURL=channels.js.map

package/dist/browser/channels.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"channels.js","sourceRoot":"","sources":["../../src/browser/channels.ts"],"names":[],"mappings":"AAKA,6DAA6D;AAC7D,MAAM,UAAU,UAAU,CAAC,MAAqB;IAC9C,OAAO,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;AAC7D,CAAC"}

package/dist/browser/launch.d.ts

@@ -0,0 +1,6 @@
+import type { Browser } from 'playwright-core';
+import type { Channel } from './channels.ts';
+export declare function launchChannel(channel: Channel): Promise<Browser>;
+/** The browser that draws a scene's frames and overlays, at one pixel per CSS pixel (ADR 0115, 36). */
+export declare function launchDrawing(channel: Channel): Promise<Browser>;
+//# sourceMappingURL=launch.d.ts.map

package/dist/browser/launch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"launch.d.ts","sourceRoot":"","sources":["../../src/browser/launch.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAO7C,wBAAsB,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAGtE;AAED,uGAAuG;AACvG,wBAAsB,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAGtE"}

package/dist/browser/launch.js

@@ -0,0 +1,14 @@
+// The installed Chrome or Edge, driven headless through playwright-core (ADR 0107, 9): no browser is downloaded. It
+// draws at 2× density, so the screencast's frames are twice the page's CSS size (ADR 0115, 8).
+// playwright-core is imported when a browser starts, not when kvvideo loads, since every worker loads kvvideo and
+// most never record.
+export async function launchChannel(channel) {
+    const { chromium } = await import('playwright-core');
+    return chromium.launch({ channel, headless: true, args: ['--force-device-scale-factor=2'] });
+}
+/** The browser that draws a scene's frames and overlays, at one pixel per CSS pixel (ADR 0115, 36). */
+export async function launchDrawing(channel) {
+    const { chromium } = await import('playwright-core');
+    return chromium.launch({ channel, headless: true });
+}
+//# sourceMappingURL=launch.js.map

package/dist/browser/launch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"launch.js","sourceRoot":"","sources":["../../src/browser/launch.ts"],"names":[],"mappings":"AAGA,oHAAoH;AACpH,+FAA+F;AAC/F,kHAAkH;AAClH,qBAAqB;AAErB,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,OAAgB;IAClD,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,MAAM,CAAC,iBAAiB,CAAC,CAAC;IACrD,OAAO,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,+BAA+B,CAAC,EAAE,CAAC,CAAC;AAC/F,CAAC;AAED,uGAAuG;AACvG,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,OAAgB;IAClD,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,MAAM,CAAC,iBAAiB,CAAC,CAAC;IACrD,OAAO,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;AACtD,CAAC"}

package/dist/browser/start-browser.d.ts

@@ -0,0 +1,5 @@
+import type { BrowserChoice } from '../settings.ts';
+import { type Channel } from './channels.ts';
+/** The first channel of the choice that starts, or `kvvideo/BROWSER_MISSING` with the channels tried (plan 16 §16.5). */
+export declare function startBrowser<Started>(choice: BrowserChoice, launch: (channel: Channel) => Promise<Started>): Promise<Started>;
+//# sourceMappingURL=start-browser.d.ts.map

package/dist/browser/start-browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"start-browser.d.ts","sourceRoot":"","sources":["../../src/browser/start-browser.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAc,KAAK,OAAO,EAAE,MAAM,eAAe,CAAC;AAEzD,yHAAyH;AACzH,wBAAsB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAWnI"}

package/dist/browser/start-browser.js

@@ -0,0 +1,17 @@
+import { kvvideoProblem } from "../problems.js";
+import { channelsOf } from "./channels.js";
+/** The first channel of the choice that starts, or `kvvideo/BROWSER_MISSING` with the channels tried (plan 16 §16.5). */
+export async function startBrowser(choice, launch) {
+    const channels = channelsOf(choice);
+    const reasons = [];
+    for (const channel of channels) {
+        try {
+            return await launch(channel);
+        }
+        catch (error) {
+            reasons.push(`${channel}: ${error instanceof Error ? (error.message.split('\n')[0] ?? '') : String(error)}`);
+        }
+    }
+    throw kvvideoProblem('BROWSER_MISSING', `No installed browser could start (${reasons.join('; ')}); install Google Chrome or Microsoft Edge.`, { channels });
+}
+//# sourceMappingURL=start-browser.js.map

package/dist/browser/start-browser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"start-browser.js","sourceRoot":"","sources":["../../src/browser/start-browser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEhD,OAAO,EAAE,UAAU,EAAgB,MAAM,eAAe,CAAC;AAEzD,yHAAyH;AACzH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAU,MAAqB,EAAE,MAA8C;IAC/G,MAAM,QAAQ,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;IACpC,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,IAAI,CAAC;YACH,OAAO,MAAM,MAAM,CAAC,OAAO,CAAC,CAAC;QAC/B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,KAAK,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAC/G,CAAC;IACH,CAAC;IACD,MAAM,cAAc,CAAC,iBAAiB,EAAE,qCAAqC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,6CAA6C,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;AAC9J,CAAC"}

package/dist/compose/ass-file.d.ts

@@ -0,0 +1,17 @@
+import type { Caption } from '../narration/captions.ts';
+export type CaptionLook = 'boxed' | 'outline' | 'highlight';
+export type CaptionStyle = {
+    width: number;
+    height: number;
+    family: string;
+    size: number | undefined;
+    position: 'bottom' | 'top';
+    look: CaptionLook;
+    highlight: string;
+};
+/** A caption's text as ASS shows it: no override braces, no backslashes, one line. */
+export declare function assText(text: string): string;
+/** `#RRGGBB` as an ASS colour, `&HAABBGGRR`, opaque. */
+export declare function assColour(colour: string): string;
+export declare function assFile(style: CaptionStyle, captions: readonly Caption[]): string;
+//# sourceMappingURL=ass-file.d.ts.map

package/dist/compose/ass-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ass-file.d.ts","sourceRoot":"","sources":["../../src/compose/ass-file.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AAQxD,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,SAAS,GAAG,WAAW,CAAC;AAE5D,MAAM,MAAM,YAAY,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,QAAQ,EAAE,QAAQ,GAAG,KAAK,CAAC;IAAC,IAAI,EAAE,WAAW,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC;AAWzK,sFAAsF;AACtF,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE5C;AAED,wDAAwD;AACxD,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEhD;AAiCD,wBAAgB,OAAO,CAAC,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,SAAS,OAAO,EAAE,GAAG,MAAM,CAoBjF"}

package/dist/compose/ass-file.js

@@ -0,0 +1,65 @@
+function timeOf(ms) {
+    const centiseconds = Math.floor(ms / 10);
+    const hours = Math.floor(centiseconds / 360_000);
+    const minutes = Math.floor(centiseconds / 6000) % 60;
+    const seconds = Math.floor(centiseconds / 100) % 60;
+    const pad = (value) => String(value).padStart(2, '0');
+    return `${String(hours)}:${pad(minutes)}:${pad(seconds)}.${pad(centiseconds % 100)}`;
+}
+/** A caption's text as ASS shows it: no override braces, no backslashes, one line. */
+export function assText(text) {
+    return text.replace(/[{}\\]/g, '').replace(/\s+/g, ' ').trim();
+}
+/** `#RRGGBB` as an ASS colour, `&HAABBGGRR`, opaque. */
+export function assColour(colour) {
+    return `&H00${`${colour.slice(5, 7)}${colour.slice(3, 5)}${colour.slice(1, 3)}`.toUpperCase()}`;
+}
+const box = '&H59000000';
+function styleLine(name, style, primary, secondary) {
+    const size = style.size ?? Math.round(style.height / 18);
+    const alignment = style.position === 'top' ? 8 : 2;
+    const margin = Math.round(style.height * 0.06);
+    const family = style.family.replace(/,/g, ' ');
+    const border = style.look === 'outline' ? `0,0,1,3,0` : `0,0,3,${String(Math.round(size / 3))},0`;
+    const outline = style.look === 'outline' ? '&H00000000' : box;
+    const back = style.look === 'outline' ? '&H00000000' : box;
+    return `Style: ${name},${family},${String(size)},${primary},${secondary},${outline},${back},0,0,0,0,100,100,${border},${String(alignment)},40,40,${String(margin)},-1`;
+}
+// A line's words, each held as ASS karaoke from the line's start: the words already spoken take the primary colour.
+function karaoke(caption) {
+    const centiseconds = (ms) => Math.max(0, Math.round(ms / 10));
+    const first = caption.words[0]?.startMs ?? caption.startMs;
+    const parts = first > caption.startMs ? [`{\\k${String(centiseconds(first - caption.startMs))}}`] : [];
+    caption.words.forEach((word, index) => {
+        const next = caption.words[index + 1]?.startMs ?? caption.endMs;
+        parts.push(`{\\k${String(centiseconds(next - word.startMs))}}${assText(word.text)}${index === caption.words.length - 1 ? '' : ' '}`);
+    });
+    return parts.join('');
+}
+function dialogue(style, caption) {
+    const timed = style.look === 'highlight' && caption.words !== undefined && caption.words.length > 0;
+    const text = timed && caption.words !== undefined ? karaoke({ ...caption, words: caption.words }) : assText(caption.text);
+    return `Dialogue: 0,${timeOf(caption.startMs)},${timeOf(caption.endMs)},${timed ? 'Spoken' : 'Default'},,0,0,0,,${text}`;
+}
+export function assFile(style, captions) {
+    const white = '&H00FFFFFF';
+    return [
+        '[Script Info]',
+        'ScriptType: v4.00+',
+        `PlayResX: ${String(style.width)}`,
+        `PlayResY: ${String(style.height)}`,
+        'WrapStyle: 0',
+        'ScaledBorderAndShadow: yes',
+        '',
+        '[V4+ Styles]',
+        'Format: Name, Fontname, Fontsize, PrimaryColour, SecondaryColour, OutlineColour, BackColour, Bold, Italic, Underline, StrikeOut, ScaleX, ScaleY, Spacing, Angle, BorderStyle, Outline, Shadow, Alignment, MarginL, MarginR, MarginV, Encoding',
+        styleLine('Default', style, white, white),
+        ...(style.look === 'highlight' ? [styleLine('Spoken', style, assColour(style.highlight), white)] : []),
+        '',
+        '[Events]',
+        'Format: Layer, Start, End, Style, Name, MarginL, MarginR, MarginV, Effect, Text',
+        ...captions.map((caption) => dialogue(style, caption)),
+        '',
+    ].join('\n');
+}
+//# sourceMappingURL=ass-file.js.map

package/dist/compose/ass-file.js.map

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

package/dist/compose/background.d.ts

@@ -0,0 +1,23 @@
+import type { Brand } from '../brand/brand.ts';
+import type { Size } from './frame-layout.ts';
+export type Background = {
+    kind: 'image';
+    file: string;
+} | {
+    kind: 'gradient';
+    from: string;
+    to: string;
+};
+/** `colour` mixed with `share` of `other`, as #rrggbb. */
+export declare function mixed(colour: string, other: string, share: number): string;
+/** The scene's background, from its `background` (a colour or an image file already checked) and the brand. */
+export declare function backgroundOf(background: {
+    colour: string;
+} | {
+    file: string;
+} | undefined, brand: Brand | null): Background;
+/** ffmpeg's input for the background, `lengthMs` long at 30 frames a second. */
+export declare function backgroundInput(background: Background, size: Size, lengthMs: number): string[];
+/** The filter that makes the background input the picture's size. */
+export declare function backgroundFit(background: Background, size: Size): string;
+//# sourceMappingURL=background.d.ts.map

package/dist/compose/background.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"background.d.ts","sourceRoot":"","sources":["../../src/compose/background.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAM9C,MAAM,MAAM,UAAU,GAAG;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC;AAI1G,0DAA0D;AAC1D,wBAAgB,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAG1E;AAED,+GAA+G;AAC/G,wBAAgB,YAAY,CAAC,UAAU,EAAE;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI,GAAG,UAAU,CAK3H;AAID,gFAAgF;AAChF,wBAAgB,eAAe,CAAC,UAAU,EAAE,UAAU,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAK9F;AAED,qEAAqE;AACrE,wBAAgB,aAAa,CAAC,UAAU,EAAE,UAAU,EAAE,IAAI,EAAE,IAAI,GAAG,MAAM,CAIxE"}

package/dist/compose/background.js

@@ -0,0 +1,31 @@
+const channels = (colour) => [1, 3, 5].map((at) => Number.parseInt(colour.slice(at, at + 2), 16));
+/** `colour` mixed with `share` of `other`, as #rrggbb. */
+export function mixed(colour, other, share) {
+    const [base, added] = [channels(colour), channels(other)];
+    return `#${base.map((value, index) => Math.round(value * (1 - share) + (added[index] ?? 0) * share).toString(16).padStart(2, '0')).join('')}`;
+}
+/** The scene's background, from its `background` (a colour or an image file already checked) and the brand. */
+export function backgroundOf(background, brand) {
+    if (background !== undefined && 'file' in background)
+        return { kind: 'image', file: background.file };
+    const colour = background?.colour ?? brand?.colors.background;
+    if (colour === undefined)
+        return { kind: 'gradient', from: '#0F172A', to: '#1E293B' };
+    return { kind: 'gradient', from: colour, to: brand === null ? colour : mixed(colour, brand.colors.primary, 0.18) };
+}
+const seconds = (ms) => (ms / 1000).toFixed(3);
+/** ffmpeg's input for the background, `lengthMs` long at 30 frames a second. */
+export function backgroundInput(background, size, lengthMs) {
+    const { width, height } = size;
+    if (background.kind === 'image')
+        return ['-loop', '1', '-framerate', '30', '-t', seconds(lengthMs), '-i', background.file];
+    const hex = (colour) => `0x${colour.slice(1)}`;
+    return ['-f', 'lavfi', '-t', seconds(lengthMs), '-i', `gradients=s=${String(width)}x${String(height)}:r=30:c0=${hex(background.from)}:c1=${hex(background.to)}:x0=0:y0=0:x1=${String(width)}:y1=${String(height)}:n=2:speed=0`];
+}
+/** The filter that makes the background input the picture's size. */
+export function backgroundFit(background, size) {
+    const { width, height } = size;
+    const fit = background.kind === 'image' ? `scale=${String(width)}:${String(height)}:force_original_aspect_ratio=increase,crop=${String(width)}:${String(height)},` : '';
+    return `${fit}fps=30,format=yuv420p`;
+}
+//# sourceMappingURL=background.js.map

package/dist/compose/background.js.map

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

package/dist/compose/camera.d.ts

@@ -0,0 +1,32 @@
+import type { Action } from '../record/steps.ts';
+export type View = {
+    x: number;
+    y: number;
+    zoom: number;
+};
+/** One move of the view, from its start to its end. */
+export type Shot = {
+    startMs: number;
+    endMs: number;
+    from: View;
+    to: View;
+    easing: 'cubic' | 'even';
+};
+export type CameraPlan = {
+    width: number;
+    height: number;
+    start: View;
+    shots: Shot[];
+};
+/** The camera of a recording of `width` × `height` CSS pixels, from its actions. */
+export declare function cameraOfActions(actions: readonly Action[], width: number, height: number): CameraPlan;
+/** An image's slow zoom over `lengthMs`; its size is the input's, read by ffmpeg. */
+export declare function imageZoom(lengthMs: number): CameraPlan;
+/** The view at `ms`. */
+export declare function viewAt(plan: CameraPlan, ms: number): View;
+/**
+ * The `perspective` filter that shows the plan's view of a frame `scale` times the plan's size, or of the input's own
+ * size for an image's zoom. `offsetMs` is where the part starts in the recording; the frames are at 30 a second.
+ */
+export declare function perspectiveFilter(plan: CameraPlan, scale: number | 'input', offsetMs: number): string;
+//# sourceMappingURL=camera.d.ts.map

package/dist/compose/camera.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"camera.d.ts","sourceRoot":"","sources":["../../src/compose/camera.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAO,MAAM,oBAAoB,CAAC;AAQtD,MAAM,MAAM,IAAI,GAAG;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAE1D,uDAAuD;AACvD,MAAM,MAAM,IAAI,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,IAAI,CAAC;IAAC,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,OAAO,GAAG,MAAM,CAAA;CAAE,CAAC;AAEtG,MAAM,MAAM,UAAU,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,IAAI,EAAE,CAAA;CAAE,CAAC;AAiBvF,oFAAoF;AACpF,wBAAgB,eAAe,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,UAAU,CAuBrG;AAED,qFAAqF;AACrF,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,UAAU,CAEtD;AAID,wBAAwB;AACxB,wBAAgB,MAAM,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,CAczD;AAmBD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAarG"}

package/dist/compose/camera.js

@@ -0,0 +1,98 @@
+const maximumZoom = 1.6;
+const panMs = 600;
+const runGapMs = 2500;
+const holdMs = 1500;
+const outMs = 800;
+const leastInMs = 400;
+const whole = (width, height) => ({ x: width / 2, y: height / 2, zoom: 1 });
+function stopView(box, width, height) {
+    const zoom = Math.max(1, Math.min(maximumZoom, (0.8 * width) / box.width, (0.8 * height) / box.height));
+    const keep = (center, side) => Math.min(Math.max(center, side / (2 * zoom)), side - side / (2 * zoom));
+    return { x: keep(box.x + box.width / 2, width), y: keep(box.y + box.height / 2, height), zoom };
+}
+/** The camera of a recording of `width` × `height` CSS pixels, from its actions. */
+export function cameraOfActions(actions, width, height) {
+    const start = whole(width, height);
+    const shots = [];
+    let current = start;
+    let lastEndMs;
+    const easeOut = (endMs) => {
+        shots.push({ startMs: endMs + holdMs, endMs: endMs + holdMs + outMs, from: current, to: start, easing: 'cubic' });
+        current = start;
+    };
+    for (const action of actions) {
+        if ((action.do !== 'click' && action.do !== 'type') || action.box === undefined || action.actMs === undefined)
+            continue;
+        const target = stopView(action.box, width, height);
+        if (lastEndMs !== undefined && action.atMs - lastEndMs <= runGapMs) {
+            shots.push({ startMs: action.atMs, endMs: action.atMs + panMs, from: current, to: target, easing: 'cubic' });
+        }
+        else {
+            if (lastEndMs !== undefined)
+                easeOut(lastEndMs);
+            shots.push({ startMs: action.atMs, endMs: Math.max(action.actMs, action.atMs + leastInMs), from: current, to: target, easing: 'cubic' });
+        }
+        current = target;
+        lastEndMs = action.endMs;
+    }
+    if (lastEndMs !== undefined)
+        easeOut(lastEndMs);
+    return { width, height, start, shots };
+}
+/** An image's slow zoom over `lengthMs`; its size is the input's, read by ffmpeg. */
+export function imageZoom(lengthMs) {
+    return { width: 1, height: 1, start: whole(1, 1), shots: [{ startMs: 0, endMs: lengthMs, from: whole(1, 1), to: { ...whole(1, 1), zoom: 1.08 }, easing: 'even' }] };
+}
+const cubic = (share) => (share < 0.5 ? 4 * share ** 3 : 1 - (-2 * share + 2) ** 3 / 2);
+/** The view at `ms`. */
+export function viewAt(plan, ms) {
+    let view = plan.start;
+    for (const shot of plan.shots) {
+        if (ms < shot.startMs)
+            break;
+        if (ms >= shot.endMs) {
+            view = shot.to;
+            continue;
+        }
+        const share = (ms - shot.startMs) / (shot.endMs - shot.startMs);
+        const eased = shot.easing === 'even' ? share : cubic(share);
+        const between = (key) => shot.from[key] + (shot.to[key] - shot.from[key]) * eased;
+        return { x: between('x'), y: between('y'), zoom: between('zoom') };
+    }
+    return view;
+}
+const number = (value) => String(Math.round(value * 10_000) / 10_000);
+// One part of the view (x, y, or zoom) as an ffmpeg expression of the time `T` in ms.
+function partExpression(plan, key, time) {
+    let expression = number(plan.shots.at(-1)?.to[key] ?? plan.start[key]);
+    for (let index = plan.shots.length - 1; index >= 0; index -= 1) {
+        const shot = plan.shots[index];
+        if (shot === undefined)
+            continue;
+        const before = number(plan.shots[index - 1]?.to[key] ?? plan.start[key]);
+        const share = `((${time}-${number(shot.startMs)})/${number(shot.endMs - shot.startMs)})`;
+        const eased = shot.easing === 'even' ? share : `if(lt(${share},0.5),4*pow(${share},3),1-pow(-2*${share}+2,3)/2)`;
+        const moving = `(${number(shot.from[key])}+${number(shot.to[key] - shot.from[key])}*${eased})`;
+        expression = `if(lt(${time},${number(shot.startMs)}),${before},if(lt(${time},${number(shot.endMs)}),${moving},${expression}))`;
+    }
+    return expression;
+}
+/**
+ * The `perspective` filter that shows the plan's view of a frame `scale` times the plan's size, or of the input's own
+ * size for an image's zoom. `offsetMs` is where the part starts in the recording; the frames are at 30 a second.
+ */
+export function perspectiveFilter(plan, scale, offsetMs) {
+    const time = `(in*1000/30+${number(offsetMs)})`;
+    const zoom = partExpression(plan, 'zoom', time);
+    const [pageWidth, pageHeight] = scale === 'input' ? ['W', 'H'] : [number(plan.width * scale), number(plan.height * scale)];
+    const factor = scale === 'input' ? 'W' : number(scale);
+    const factorY = scale === 'input' ? 'H' : number(scale);
+    const halfWidth = `(${pageWidth}/(2*${zoom}))`;
+    const halfHeight = `(${pageHeight}/(2*${zoom}))`;
+    const left = `clip(${partExpression(plan, 'x', time)}*${factor}-${halfWidth},0,${pageWidth}-2*${halfWidth})`;
+    const top = `clip(${partExpression(plan, 'y', time)}*${factorY}-${halfHeight},0,${pageHeight}-2*${halfHeight})`;
+    const right = `${left}+2*${halfWidth}`;
+    const bottom = `${top}+2*${halfHeight}`;
+    return `perspective=x0='${left}':y0='${top}':x1='${right}':y1='${top}':x2='${left}':y2='${bottom}':x3='${right}':y3='${bottom}':interpolation=cubic:sense=source:eval=frame`;
+}
+//# sourceMappingURL=camera.js.map