@kvman/kvvideo 0.0.0-stage → 0.1.1

package/dist/files/sidecar.d.ts

@@ -0,0 +1,209 @@
+import { z } from '@kvman/sdk';
+export declare const sidecarCaptionSchema: z.ZodObject<{
+    text: z.ZodString;
+    startMs: z.ZodNumber;
+    endMs: z.ZodNumber;
+    words: z.ZodExactOptional<z.ZodArray<z.ZodObject<{
+        text: z.ZodString;
+        startMs: z.ZodNumber;
+        endMs: z.ZodNumber;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export declare const recordingSidecarSchema: z.ZodObject<{
+    kind: z.ZodEnum<{
+        page: "page";
+        site: "site";
+    }>;
+    source: z.ZodString;
+    width: z.ZodNumber;
+    height: z.ZodNumber;
+    device: z.ZodEnum<{
+        phone: "phone";
+        desktop: "desktop";
+    }>;
+    scale: z.ZodLiteral<2>;
+    durationMs: z.ZodNumber;
+    steps: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        do: z.ZodLiteral<"goto">;
+        url: z.ZodString;
+        atLine: z.ZodExactOptional<z.ZodNumber>;
+    }, z.core.$strict>, z.ZodObject<{
+        do: z.ZodLiteral<"click">;
+        target: z.ZodString;
+        atLine: z.ZodExactOptional<z.ZodNumber>;
+    }, z.core.$strict>, z.ZodObject<{
+        do: z.ZodLiteral<"type">;
+        target: z.ZodString;
+        text: z.ZodString;
+        atLine: z.ZodExactOptional<z.ZodNumber>;
+    }, z.core.$strict>, z.ZodObject<{
+        do: z.ZodLiteral<"press">;
+        key: z.ZodString;
+        atLine: z.ZodExactOptional<z.ZodNumber>;
+    }, z.core.$strict>, z.ZodObject<{
+        do: z.ZodLiteral<"hover">;
+        target: z.ZodString;
+        atLine: z.ZodExactOptional<z.ZodNumber>;
+    }, z.core.$strict>, z.ZodObject<{
+        do: z.ZodLiteral<"scroll">;
+        pixels: z.ZodNumber;
+        atLine: z.ZodExactOptional<z.ZodNumber>;
+    }, z.core.$strict>, z.ZodObject<{
+        do: z.ZodLiteral<"wait">;
+        ms: z.ZodNumber;
+    }, z.core.$strict>, z.ZodObject<{
+        do: z.ZodLiteral<"waitFor">;
+        target: z.ZodString;
+        atLine: z.ZodExactOptional<z.ZodNumber>;
+    }, z.core.$strict>], "do">>;
+    actions: z.ZodArray<z.ZodObject<{
+        do: z.ZodString;
+        atMs: z.ZodNumber;
+        actMs: z.ZodOptional<z.ZodNumber>;
+        endMs: z.ZodNumber;
+        box: z.ZodOptional<z.ZodObject<{
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+            width: z.ZodNumber;
+            height: z.ZodNumber;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const narrationSidecarSchema: z.ZodObject<{
+    kind: z.ZodLiteral<"narration">;
+    durationMs: z.ZodNumber;
+    captions: z.ZodArray<z.ZodObject<{
+        text: z.ZodString;
+        startMs: z.ZodNumber;
+        endMs: z.ZodNumber;
+        words: z.ZodExactOptional<z.ZodArray<z.ZodObject<{
+            text: z.ZodString;
+            startMs: z.ZodNumber;
+            endMs: z.ZodNumber;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const videoSidecarSchema: z.ZodObject<{
+    kind: z.ZodLiteral<"video">;
+    durationMs: z.ZodNumber;
+    width: z.ZodNumber;
+    height: z.ZodNumber;
+    scenes: z.ZodArray<z.ZodObject<{
+        startMs: z.ZodNumber;
+        endMs: z.ZodNumber;
+    }, z.core.$strip>>;
+    captions: z.ZodArray<z.ZodObject<{
+        text: z.ZodString;
+        startMs: z.ZodNumber;
+        endMs: z.ZodNumber;
+        words: z.ZodExactOptional<z.ZodArray<z.ZodObject<{
+            text: z.ZodString;
+            startMs: z.ZodNumber;
+            endMs: z.ZodNumber;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+declare const sidecarSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodEnum<{
+        page: "page";
+        site: "site";
+    }>;
+    source: z.ZodString;
+    width: z.ZodNumber;
+    height: z.ZodNumber;
+    device: z.ZodEnum<{
+        phone: "phone";
+        desktop: "desktop";
+    }>;
+    scale: z.ZodLiteral<2>;
+    durationMs: z.ZodNumber;
+    steps: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        do: z.ZodLiteral<"goto">;
+        url: z.ZodString;
+        atLine: z.ZodExactOptional<z.ZodNumber>;
+    }, z.core.$strict>, z.ZodObject<{
+        do: z.ZodLiteral<"click">;
+        target: z.ZodString;
+        atLine: z.ZodExactOptional<z.ZodNumber>;
+    }, z.core.$strict>, z.ZodObject<{
+        do: z.ZodLiteral<"type">;
+        target: z.ZodString;
+        text: z.ZodString;
+        atLine: z.ZodExactOptional<z.ZodNumber>;
+    }, z.core.$strict>, z.ZodObject<{
+        do: z.ZodLiteral<"press">;
+        key: z.ZodString;
+        atLine: z.ZodExactOptional<z.ZodNumber>;
+    }, z.core.$strict>, z.ZodObject<{
+        do: z.ZodLiteral<"hover">;
+        target: z.ZodString;
+        atLine: z.ZodExactOptional<z.ZodNumber>;
+    }, z.core.$strict>, z.ZodObject<{
+        do: z.ZodLiteral<"scroll">;
+        pixels: z.ZodNumber;
+        atLine: z.ZodExactOptional<z.ZodNumber>;
+    }, z.core.$strict>, z.ZodObject<{
+        do: z.ZodLiteral<"wait">;
+        ms: z.ZodNumber;
+    }, z.core.$strict>, z.ZodObject<{
+        do: z.ZodLiteral<"waitFor">;
+        target: z.ZodString;
+        atLine: z.ZodExactOptional<z.ZodNumber>;
+    }, z.core.$strict>], "do">>;
+    actions: z.ZodArray<z.ZodObject<{
+        do: z.ZodString;
+        atMs: z.ZodNumber;
+        actMs: z.ZodOptional<z.ZodNumber>;
+        endMs: z.ZodNumber;
+        box: z.ZodOptional<z.ZodObject<{
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+            width: z.ZodNumber;
+            height: z.ZodNumber;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"narration">;
+    durationMs: z.ZodNumber;
+    captions: z.ZodArray<z.ZodObject<{
+        text: z.ZodString;
+        startMs: z.ZodNumber;
+        endMs: z.ZodNumber;
+        words: z.ZodExactOptional<z.ZodArray<z.ZodObject<{
+            text: z.ZodString;
+            startMs: z.ZodNumber;
+            endMs: z.ZodNumber;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"video">;
+    durationMs: z.ZodNumber;
+    width: z.ZodNumber;
+    height: z.ZodNumber;
+    scenes: z.ZodArray<z.ZodObject<{
+        startMs: z.ZodNumber;
+        endMs: z.ZodNumber;
+    }, z.core.$strip>>;
+    captions: z.ZodArray<z.ZodObject<{
+        text: z.ZodString;
+        startMs: z.ZodNumber;
+        endMs: z.ZodNumber;
+        words: z.ZodExactOptional<z.ZodArray<z.ZodObject<{
+            text: z.ZodString;
+            startMs: z.ZodNumber;
+            endMs: z.ZodNumber;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>], "kind">;
+/** What a sidecar holds. */
+export type Sidecar = z.output<typeof sidecarSchema>;
+/** The sidecar's path beside a file. */
+export declare function sidecarPath(file: string): string;
+/** The sidecar beside an output; an existing one is replaced only with `replace` (plan 16 §16.3). */
+export declare function sidecarOutputPath(output: string, replace: boolean, shown: string): string;
+/** The sidecar beside `file`, or `undefined` when it is missing or invalid. */
+export declare function readSidecar(file: string): Sidecar | undefined;
+/** Writes a sidecar into a work folder, to be placed beside its output; answers its path there. */
+export declare function writeSidecar(folder: string, sidecar: Sidecar): string;
+export {};
+//# sourceMappingURL=sidecar.d.ts.map

package/dist/files/sidecar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sidecar.d.ts","sourceRoot":"","sources":["../../src/files/sidecar.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,YAAY,CAAC;AAS/B,eAAO,MAAM,oBAAoB;;;;;;;;;iBAA6J,CAAC;AAE/L,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAUjC,CAAC;AAEH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;iBAAkI,CAAC;AAEtK,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;iBAO7B,CAAC;AAEH,QAAA,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2BAAqG,CAAC;AAEzH,4BAA4B;AAC5B,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,aAAa,CAAC,CAAC;AAErD,wCAAwC;AACxC,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED,qGAAqG;AACrG,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAIzF;AAWD,+EAA+E;AAC/E,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAK7D;AAED,mGAAmG;AACnG,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,MAAM,CAIrE"}

package/dist/files/sidecar.js

@@ -0,0 +1,66 @@
+import { existsSync, readFileSync, writeFileSync } from 'node:fs';
+import path from 'node:path';
+import { z } from '@kvman/sdk';
+import { invalid } from "../problems.js";
+import { actionSchema, stepSchema } from "../record/steps.js";
+// The sidecar beside an output, `<file>.kvvideo.json` (plan 16 §16.3; ADR 0115, 31): what a later command needs from
+// it, so the agent copies no numbers between calls. It is validated when read; a missing or invalid one is absent.
+const wordSchema = z.object({ text: z.string(), startMs: z.number().int().nonnegative(), endMs: z.number().int().nonnegative() });
+export const sidecarCaptionSchema = z.object({ text: z.string(), startMs: z.number().int().nonnegative(), endMs: z.number().int().nonnegative(), words: z.array(wordSchema).exactOptional() });
+export const recordingSidecarSchema = z.object({
+    kind: z.enum(['site', 'page']),
+    source: z.string(),
+    width: z.number().int().positive(),
+    height: z.number().int().positive(),
+    device: z.enum(['desktop', 'phone']),
+    scale: z.literal(2),
+    durationMs: z.number().int().nonnegative(),
+    steps: z.array(stepSchema),
+    actions: z.array(actionSchema),
+});
+export const narrationSidecarSchema = z.object({ kind: z.literal('narration'), durationMs: z.number().int().nonnegative(), captions: z.array(sidecarCaptionSchema) });
+export const videoSidecarSchema = z.object({
+    kind: z.literal('video'),
+    durationMs: z.number().int().nonnegative(),
+    width: z.number().int().positive(),
+    height: z.number().int().positive(),
+    scenes: z.array(z.object({ startMs: z.number().int().nonnegative(), endMs: z.number().int().nonnegative() })),
+    captions: z.array(sidecarCaptionSchema),
+});
+const sidecarSchema = z.discriminatedUnion('kind', [recordingSidecarSchema, narrationSidecarSchema, videoSidecarSchema]);
+/** The sidecar's path beside a file. */
+export function sidecarPath(file) {
+    return `${file}.kvvideo.json`;
+}
+/** The sidecar beside an output; an existing one is replaced only with `replace` (plan 16 §16.3). */
+export function sidecarOutputPath(output, replace, shown) {
+    const beside = sidecarPath(output);
+    if (existsSync(beside) && !replace)
+        throw invalid(`${sidecarPath(shown)} exists; set replace to true to write over it.`, { path: sidecarPath(shown) });
+    return beside;
+}
+function parsed(text) {
+    try {
+        return JSON.parse(text);
+    }
+    catch (error) {
+        if (error instanceof SyntaxError)
+            return undefined;
+        throw error;
+    }
+}
+/** The sidecar beside `file`, or `undefined` when it is missing or invalid. */
+export function readSidecar(file) {
+    const beside = sidecarPath(file);
+    if (!existsSync(beside))
+        return undefined;
+    const result = sidecarSchema.safeParse(parsed(readFileSync(beside, 'utf8')));
+    return result.success ? result.data : undefined;
+}
+/** Writes a sidecar into a work folder, to be placed beside its output; answers its path there. */
+export function writeSidecar(folder, sidecar) {
+    const made = path.join(folder, 'sidecar.json');
+    writeFileSync(made, `${JSON.stringify(sidecar, null, 2)}\n`);
+    return made;
+}
+//# sourceMappingURL=sidecar.js.map

package/dist/files/sidecar.js.map

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

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;AActC,YAAY,EAAE,MAAM,UAAU,CAAC;yBAKf,KAAK,GAAG,KAAG,IAAI;AAA/B,wBAaE"}

package/dist/index.js

@@ -0,0 +1,30 @@
+import { registerBrand } from "./brand/brand.js";
+import { registerCompose } from "./compose/register-compose.js";
+import { registerFonts } from "./fonts/register-fonts.js";
+import { registerNarration } from "./narration/register-narration.js";
+import { registerVoice } from "./narration/register-voice.js";
+import { registerRecord } from "./record/register-record.js";
+import { registerReview } from "./review/register-review.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 any kind of video, 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);
+    registerBrand(ctx);
+    registerUi(ctx);
+    registerSetup(ctx);
+    registerFonts(ctx);
+    registerRecord(ctx);
+    registerNarration(ctx);
+    registerVoice(ctx);
+    registerCompose(ctx);
+    registerReview(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,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,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,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,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,6GAA6G;AAC7G,iHAAiH;AACjH,yCAAyC;AACzC,eAAe,CAAC,GAAQ,EAAQ,EAAE;IAChC,gBAAgB,CAAC,GAAG,CAAC,CAAC;IACtB,aAAa,CAAC,GAAG,CAAC,CAAC;IACnB,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,aAAa,CAAC,GAAG,CAAC,CAAC;IACnB,eAAe,CAAC,GAAG,CAAC,CAAC;IACrB,cAAc,CAAC,GAAG,CAAC,CAAC;IACpB,kBAAkB,CAAC,GAAG,CAAC,CAAC;IACxB,mBAAmB,CAAC,GAAG,CAAC,CAAC;AAC3B,CAAC,CAAC"}

package/dist/narration/alignment.d.ts

@@ -0,0 +1,15 @@
+import { z } from '@kvman/sdk';
+export declare const alignmentSchema: z.ZodObject<{
+    startsMs: z.ZodArray<z.ZodNumber>;
+    endsMs: z.ZodArray<z.ZodNumber>;
+}, z.core.$strip>;
+/** When each spoken character starts and ends, in ms from the sentence's start. */
+export type Alignment = z.output<typeof alignmentSchema>;
+export declare const elevenLabsAlignmentSchema: z.ZodObject<{
+    characters: z.ZodArray<z.ZodString>;
+    character_start_times_seconds: z.ZodArray<z.ZodNumber>;
+    character_end_times_seconds: z.ZodArray<z.ZodNumber>;
+}, z.core.$strip>;
+/** The alignment of `spoken`; one whose characters aren't the text fails `kvvideo/NARRATION_FAILED`. */
+export declare function alignmentOf(answer: z.output<typeof elevenLabsAlignmentSchema>, spoken: string): Alignment;
+//# sourceMappingURL=alignment.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"alignment.d.ts","sourceRoot":"","sources":["../../src/narration/alignment.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,YAAY,CAAC;AAM/B,eAAO,MAAM,eAAe;;;iBAAmH,CAAC;AAEhJ,mFAAmF;AACnF,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,eAAe,CAAC,CAAC;AAEzD,eAAO,MAAM,yBAAyB;;;;iBAIpC,CAAC;AAIH,wGAAwG;AACxG,wBAAgB,WAAW,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,yBAAyB,CAAC,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,CAOzG"}

package/dist/narration/alignment.js

@@ -0,0 +1,21 @@
+import { z } from '@kvman/sdk';
+import { kvvideoProblem } from "../problems.js";
+// ElevenLabs's character times (plan 16 §16.6; ADR 0115, 17): each character of the text it was sent, by code point,
+// with when it starts and ends, kept in whole milliseconds.
+export const alignmentSchema = z.object({ startsMs: z.array(z.number().int().nonnegative()), endsMs: z.array(z.number().int().nonnegative()) });
+export const elevenLabsAlignmentSchema = z.object({
+    characters: z.array(z.string()),
+    character_start_times_seconds: z.array(z.number()),
+    character_end_times_seconds: z.array(z.number()),
+});
+const ms = (seconds) => Math.max(0, Math.round(seconds * 1000));
+/** The alignment of `spoken`; one whose characters aren't the text fails `kvvideo/NARRATION_FAILED`. */
+export function alignmentOf(answer, spoken) {
+    const { characters, character_start_times_seconds: starts, character_end_times_seconds: ends } = answer;
+    if (characters.join('') !== spoken || [...spoken].length !== characters.length || starts.length !== characters.length || ends.length !== characters.length) {
+        const reason = "ElevenLabs's character times don't match the text it was sent";
+        throw kvvideoProblem('NARRATION_FAILED', reason, { service: 'elevenlabs', reason });
+    }
+    return { startsMs: starts.map(ms), endsMs: ends.map(ms) };
+}
+//# sourceMappingURL=alignment.js.map

package/dist/narration/alignment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"alignment.js","sourceRoot":"","sources":["../../src/narration/alignment.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,YAAY,CAAC;AAC/B,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEhD,qHAAqH;AACrH,4DAA4D;AAE5D,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,EAAE,CAAC,CAAC;AAKhJ,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChD,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAC/B,6BAA6B,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAClD,2BAA2B,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;CACjD,CAAC,CAAC;AAEH,MAAM,EAAE,GAAG,CAAC,OAAe,EAAU,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC;AAEhF,wGAAwG;AACxG,MAAM,UAAU,WAAW,CAAC,MAAkD,EAAE,MAAc;IAC5F,MAAM,EAAE,UAAU,EAAE,6BAA6B,EAAE,MAAM,EAAE,2BAA2B,EAAE,IAAI,EAAE,GAAG,MAAM,CAAC;IACxG,IAAI,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC,KAAK,MAAM,IAAI,CAAC,GAAG,MAAM,CAAC,CAAC,MAAM,KAAK,UAAU,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,KAAK,UAAU,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,KAAK,UAAU,CAAC,MAAM,EAAE,CAAC;QAC3J,MAAM,MAAM,GAAG,+DAA+D,CAAC;QAC/E,MAAM,cAAc,CAAC,kBAAkB,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,CAAC,CAAC;IACtF,CAAC;IACD,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;AAC5D,CAAC"}

package/dist/narration/captions.d.ts

@@ -0,0 +1,28 @@
+import type { Alignment } from './alignment.ts';
+import type { Spoken } from './pronunciations.ts';
+export type Word = {
+    text: string;
+    startMs: number;
+    endMs: number;
+};
+export type Caption = {
+    text: string;
+    startMs: number;
+    endMs: number;
+    words?: Word[];
+};
+/** The text's sentences, in order: cut at line breaks and after `.`, `!`, `?`, `؟`, and `…` followed by a space. */
+export declare function sentencesOf(text: string): string[];
+/** A sentence's caption lines: whole words, each line as long as it can be up to 42 characters. */
+export declare function linesOf(sentence: string): string[];
+/** One sentence's place in the narration: its audio from `startMs` for `durationMs`, and its character times. */
+export type PlacedSentence = {
+    text: string;
+    spoken: Spoken;
+    startMs: number;
+    durationMs: number;
+    alignment: Alignment | null;
+};
+/** The captions of placed sentences over a narration of `durationMs`: each line ends where the next starts. */
+export declare function captionsOf(sentences: readonly PlacedSentence[], 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":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAMlD,MAAM,MAAM,IAAI,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEpE,MAAM,MAAM,OAAO,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,IAAI,EAAE,CAAA;CAAE,CAAC;AAMvF,oHAAoH;AACpH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAMlD;AAED,mGAAmG;AACnG,wBAAgB,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAclD;AAED,iHAAiH;AACjH,MAAM,MAAM,cAAc,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,SAAS,GAAG,IAAI,CAAA;CAAE,CAAC;AAwChI,+GAA+G;AAC/G,wBAAgB,UAAU,CAAC,SAAS,EAAE,SAAS,cAAc,EAAE,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,EAAE,CAG9F"}