@kvman/kvvideo 0.1.0 → 0.1.2

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

@@ -0,0 +1,24 @@
+import { z, type Ctx } from '@kvman/sdk';
+export declare const reviewOutputSchema: z.ZodObject<{
+    durationMs: z.ZodNumber;
+    loudness: z.ZodNullable<z.ZodObject<{
+        integratedLufs: z.ZodNumber;
+        truePeakDb: z.ZodNumber;
+    }, z.core.$strip>>;
+    problems: z.ZodArray<z.ZodObject<{
+        kind: z.ZodEnum<{
+            silence: "silence";
+            black: "black";
+            frozen: "frozen";
+            loudness: "loudness";
+        }>;
+        atMs: z.ZodNumber;
+        lengthMs: z.ZodNumber;
+    }, z.core.$strip>>;
+    images: z.ZodArray<z.ZodObject<{
+        fileId: z.ZodString;
+        name: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare function registerReview(ctx: Ctx): void;
+//# sourceMappingURL=register-review.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"register-review.d.ts","sourceRoot":"","sources":["../../src/review/register-review.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,KAAK,GAAG,EAAE,MAAM,YAAY,CAAC;AAsBzC,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;iBAK7B,CAAC;AAQH,wBAAgB,cAAc,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI,CA4C7C"}

package/dist/review/register-review.js

@@ -0,0 +1,81 @@
+import { copyFileSync, readFileSync, writeFileSync } from 'node:fs';
+import path from 'node:path';
+import { z } from '@kvman/sdk';
+import { readSidecar } from "../files/sidecar.js";
+import { inputPath } from "../files/workspace-paths.js";
+import { workFolder } from "../files/place-output.js";
+import { bundledFonts, fontsFolder } from "../fonts/bundled-fonts.js";
+import { trimOldest } from "../narration/narration-cache.js";
+import { hasSound, mediaDuration, mediaSize } from "../programs/media-duration.js";
+import { programOf } from "../programs/programs.js";
+import { lastLines, runProgram } from "../programs/run-program.js";
+import { kvvideoProblem } from "../problems.js";
+import { analysisArgs, analysisOf } from "./analysis.js";
+import { frameTimes, sheetsOf } from "./frames.js";
+import { sheetArgs, sheetGraph, tileOf } from "./sheet-args.js";
+// `video review` (plan 16 §16.10; ADR 0115, 20 and 48): measures a video's silences, black and frozen pictures, and
+// loudness, and makes contact sheets of its frames that the model sees through kvcoder (`images: true`). The newest 24
+// sheets of the workspace are kept in the kernel's files.
+const keptSheets = 24;
+const problemSchema = z.object({ kind: z.enum(['silence', 'black', 'frozen', 'loudness']), atMs: z.number().int().nonnegative(), lengthMs: z.number().int().nonnegative() });
+export const reviewOutputSchema = z.object({
+    durationMs: z.number().int().nonnegative(),
+    loudness: z.object({ integratedLufs: z.number(), truePeakDb: z.number() }).nullable(),
+    problems: z.array(problemSchema),
+    images: z.array(z.object({ fileId: z.string(), name: z.string() })),
+});
+const sheetRowSchema = z.object({ fileId: z.string(), createdAt: z.string() });
+function failed(reason) {
+    return kvvideoProblem('RENDER_FAILED', `ffmpeg couldn't review the video: ${reason}`, { scene: null, reason });
+}
+export function registerReview(ctx) {
+    ctx.registerCommand('kvvideo.video.review', {
+        description: "Reviews an MP4 of the workspace: its silences, black and frozen pictures, and loudness, and contact sheets of its frames to look at before telling the person it's ready.",
+        input: z.strictObject({ file: z.string().min(1).max(1000).describe('The .mp4 file to review, in the workspace.') }),
+        output: reviewOutputSchema,
+        public: true,
+        retries: 0,
+        timeoutMs: 600_000,
+        handle: async ({ file }) => {
+            const video = inputPath(ctx.job.workspace.path, file, ['.mp4']);
+            const [ffmpeg, ffprobe] = [await programOf(ctx, 'ffmpeg'), await programOf(ctx, 'ffprobe')];
+            const signal = ctx.job.signal;
+            const duration = await mediaDuration(ffprobe, video, signal);
+            const size = await mediaSize(ffprobe, video, signal);
+            if (!duration.ok || !size.ok)
+                throw failed(duration.ok ? (size.ok ? '' : size.reason) : duration.reason);
+            const sound = await hasSound(ffprobe, video, signal);
+            const measured = await runProgram(ffmpeg, analysisArgs(video, sound), { signal });
+            if (measured.exitCode !== 0)
+                throw failed(lastLines(measured.output));
+            const analysis = analysisOf(measured.output, duration.ms, sound);
+            const sidecar = readSidecar(video);
+            const sheets = sheetsOf(frameTimes(sidecar?.kind === 'video' ? sidecar : undefined, duration.ms)).slice(0, 8);
+            const tile = tileOf(size.width, size.height);
+            const work = workFolder();
+            try {
+                copyFileSync(path.join(fontsFolder, bundledFonts.find((font) => font.name === 'Poppins')?.file ?? ''), path.join(work.folder, 'font.ttf'));
+                const images = [];
+                for (const [index, times] of sheets.entries()) {
+                    ctx.job.progress({ key: 'kvvideo.progress.sheet', params: { n: index + 1, of: sheets.length } });
+                    writeFileSync(path.join(work.folder, 'sheet.graph'), sheetGraph(times, tile));
+                    const made = await runProgram(ffmpeg, sheetArgs(video, times, 'sheet.graph', 'sheet.jpg'), { cwd: work.folder, signal });
+                    if (made.exitCode !== 0)
+                        throw failed(lastLines(made.output));
+                    const name = `review-${String(index + 1)}.jpg`;
+                    const stored = await ctx.files.write(name, readFileSync(path.join(work.folder, 'sheet.jpg')), 'image/jpeg');
+                    images.push({ fileId: stored.id, name });
+                }
+                const rows = ctx.store.collection('reviewSheets', sheetRowSchema);
+                for (const image of images)
+                    await rows.insert({ fileId: image.fileId, createdAt: new Date().toISOString() });
+                await trimOldest(rows, ctx.files, keptSheets);
+                return { durationMs: duration.ms, loudness: analysis.loudness, problems: analysis.problems, images };
+            }
+            finally {
+                work.remove();
+            }
+        },
+    });
+}
+//# sourceMappingURL=register-review.js.map

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

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

package/dist/review/sheet-args.d.ts

@@ -0,0 +1,11 @@
+export type Tile = {
+    width: number;
+    height: number;
+};
+/** A frame's size on the sheet, for a video of `width` × `height`. */
+export declare function tileOf(width: number, height: number): Tile;
+/** A time as the sheet labels it, `m:ss.s`. */
+export declare function timeLabel(ms: number): string;
+export declare function sheetGraph(times: readonly number[], tile: Tile): string;
+export declare function sheetArgs(video: string, times: readonly number[], graph: string, output: string): string[];
+//# sourceMappingURL=sheet-args.d.ts.map

package/dist/review/sheet-args.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sheet-args.d.ts","sourceRoot":"","sources":["../../src/review/sheet-args.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,IAAI,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAIrD,sEAAsE;AACtE,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAE1D;AAED,+CAA+C;AAC/C,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAG5C;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,EAAE,IAAI,EAAE,IAAI,GAAG,MAAM,CAMvE;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAE1G"}

package/dist/review/sheet-args.js

@@ -0,0 +1,24 @@
+// ffmpeg's arguments for one contact sheet (plan 16 §16.10; ADR 0115, 48): each frame taken at its time, 480 px on its
+// longer side, labelled with its time (`m:ss.s`) in the bundled font, laid out 3 frames wide, as a JPEG. ffmpeg runs in
+// the work folder, where the font is `font.ttf`.
+const even = (value) => Math.max(2, 2 * Math.round(value / 2));
+/** A frame's size on the sheet, for a video of `width` × `height`. */
+export function tileOf(width, height) {
+    return width >= height ? { width: 480, height: even((480 * height) / width) } : { width: even((480 * width) / height), height: 480 };
+}
+/** A time as the sheet labels it, `m:ss.s`. */
+export function timeLabel(ms) {
+    const tenths = Math.floor(ms / 100);
+    return `${String(Math.floor(tenths / 600))}:${String(Math.floor(tenths / 10) % 60).padStart(2, '0')}.${String(tenths % 10)}`;
+}
+export function sheetGraph(times, tile) {
+    const tiles = times.map((at, index) => `[${String(index)}:v]scale=${String(tile.width)}:${String(tile.height)},drawtext=fontfile=font.ttf:text='${timeLabel(at).replace(':', '\\:')}':x=10:y=h-th-10:fontsize=24:fontcolor=white:box=1:boxcolor=black@0.6:boxborderw=6[t${String(index)}]`);
+    const labels = times.map((_, index) => `[t${String(index)}]`).join('');
+    const layout = times.map((_, index) => `${String((index % 3) * tile.width)}_${String(Math.floor(index / 3) * tile.height)}`).join('|');
+    const stack = times.length === 1 ? `${labels}null[sheet]` : `${labels}xstack=inputs=${String(times.length)}:layout=${layout}:fill=black[sheet]`;
+    return [...tiles, stack].join(';\n');
+}
+export function sheetArgs(video, times, graph, output) {
+    return ['-hide_banner', '-loglevel', 'error', ...times.flatMap((at) => ['-ss', (at / 1000).toFixed(3), '-i', video]), '-filter_complex_script', graph, '-map', '[sheet]', '-frames:v', '1', '-q:v', '4', '-y', output];
+}
+//# sourceMappingURL=sheet-args.js.map

package/dist/review/sheet-args.js.map

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

package/dist/settings.d.ts

@@ -22,6 +22,10 @@ export declare const settingSchemas: {
         msedge: "msedge";
     }>;
     program: z.ZodString;
+    pronunciations: z.ZodArray<z.ZodObject<{
+        word: z.ZodString;
+        say: z.ZodString;
+    }, z.core.$strict>>;
 };
 /** The setting that names a program. */
 export declare function programSetting(program: ProgramName): `kvvideo.programs.${ProgramName}`;

package/dist/settings.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"settings.d.ts","sourceRoot":"","sources":["../src/settings.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,KAAK,GAAG,EAAE,MAAM,YAAY,CAAC;AAKzC,eAAO,MAAM,iBAAiB,4CAA6C,CAAC;AAE5E,2BAA2B;AAC3B,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC;AAElE,eAAO,MAAM,cAAc,uCAAwC,CAAC;AAEpE,uCAAuC;AACvC,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC;AAE5D,eAAO,MAAM,YAAY,yCAA0C,CAAC;AAEpE,8BAA8B;AAC9B,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC;AAExD,eAAO,MAAM,cAAc;;;;;;;;;;;;;;CAM1B,CAAC;AAEF,wCAAwC;AACxC,wBAAgB,cAAc,CAAC,OAAO,EAAE,WAAW,GAAG,oBAAoB,WAAW,EAAE,CAEtF;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI,CAQ/C"}
+{"version":3,"file":"settings.d.ts","sourceRoot":"","sources":["../src/settings.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,KAAK,GAAG,EAAE,MAAM,YAAY,CAAC;AAKzC,eAAO,MAAM,iBAAiB,4CAA6C,CAAC;AAE5E,2BAA2B;AAC3B,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC;AAElE,eAAO,MAAM,cAAc,uCAAwC,CAAC;AAEpE,uCAAuC;AACvC,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC;AAE5D,eAAO,MAAM,YAAY,yCAA0C,CAAC;AAEpE,8BAA8B;AAC9B,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC;AAExD,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;CAO1B,CAAC;AAEF,wCAAwC;AACxC,wBAAgB,cAAc,CAAC,OAAO,EAAE,WAAW,GAAG,oBAAoB,WAAW,EAAE,CAEtF;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI,CAS/C"}

package/dist/settings.js

@@ -1,6 +1,6 @@
 import { z } from '@kvman/sdk';
-// kvvideo's settings (plan 16 §16.2, ADR 0107, 5 and 20): no narration service until the person chooses one, and the
-// programs as a name on the PATH or a full path.
+// kvvideo's settings (plan 16 §16.2; ADR 0107, 5 and 20; ADR 0115, 15): no narration service until the person
+// chooses one, the words the narration says differently, and the programs as a name on the PATH or a full path.
 export const narrationServices = ['elevenlabs', 'openai', 'piper'];
 export const browserChoices = ['auto', 'chrome', 'msedge'];
 export const programNames = ['ffmpeg', 'ffprobe', 'piper'];
@@ -10,6 +10,7 @@ export const settingSchemas = {
     model: z.string().min(1).max(100).nullable(),
     browser: z.enum(browserChoices),
     program: z.string().min(1).max(1000),
+    pronunciations: z.array(z.strictObject({ word: z.string().min(1).max(100), say: z.string().min(1).max(200) })).max(200),
 };
 /** The setting that names a program. */
 export function programSetting(program) {
@@ -19,6 +20,7 @@ export function registerSettings(ctx) {
     ctx.registerSetting('kvvideo.narration.service', { description: 'The text-to-speech service that narrates; null until the person chooses one.', schema: settingSchemas.service, default: null });
     ctx.registerSetting('kvvideo.narration.voice', { description: "The narration voice: a voice id for ElevenLabs or OpenAI, or the path of a Piper voice's .onnx file; null is the service's default.", schema: settingSchemas.voice, default: null });
     ctx.registerSetting('kvvideo.narration.model', { description: "The narration model of ElevenLabs or OpenAI; null is the service's default.", schema: settingSchemas.model, default: null });
+    ctx.registerSetting('kvvideo.narration.pronunciations', { description: 'How the narration says words: each word, as a whole word in any case, is said as its say; captions keep the word as written.', schema: settingSchemas.pronunciations, default: [] });
     ctx.registerSetting('kvvideo.browser', { description: 'The installed browser that records pages: auto tries Chrome, then Edge.', schema: settingSchemas.browser, default: 'auto', scopes: ['global'] });
     for (const program of programNames) {
         ctx.registerSetting(programSetting(program), { description: `The ${program} program: a name on the PATH, or a full path.`, schema: settingSchemas.program, default: program, scopes: ['global'] });

package/dist/settings.js.map

@@ -1 +1 @@
-{"version":3,"file":"settings.js","sourceRoot":"","sources":["../src/settings.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAY,MAAM,YAAY,CAAC;AAEzC,qHAAqH;AACrH,iDAAiD;AAEjD,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,YAAY,EAAE,QAAQ,EAAE,OAAO,CAAU,CAAC;AAK5E,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,QAAQ,CAAU,CAAC;AAKpE,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,QAAQ,EAAE,SAAS,EAAE,OAAO,CAAU,CAAC;AAKpE,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC,QAAQ,EAAE;IAC7C,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;IAC5C,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;IAC5C,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC;IAC/B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC;CACrC,CAAC;AAEF,wCAAwC;AACxC,MAAM,UAAU,cAAc,CAAC,OAAoB;IACjD,OAAO,oBAAoB,OAAO,EAAE,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,GAAQ;IACvC,GAAG,CAAC,eAAe,CAAC,2BAA2B,EAAE,EAAE,WAAW,EAAE,8EAA8E,EAAE,MAAM,EAAE,cAAc,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;IACjM,GAAG,CAAC,eAAe,CAAC,yBAAyB,EAAE,EAAE,WAAW,EAAE,qIAAqI,EAAE,MAAM,EAAE,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;IACpP,GAAG,CAAC,eAAe,CAAC,yBAAyB,EAAE,EAAE,WAAW,EAAE,6EAA6E,EAAE,MAAM,EAAE,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5L,GAAG,CAAC,eAAe,CAAC,iBAAiB,EAAE,EAAE,WAAW,EAAE,yEAAyE,EAAE,MAAM,EAAE,cAAc,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IACxM,KAAK,MAAM,OAAO,IAAI,YAAY,EAAE,CAAC;QACnC,GAAG,CAAC,eAAe,CAAC,cAAc,CAAC,OAAO,CAAC,EAAE,EAAE,WAAW,EAAE,OAAO,OAAO,+CAA+C,EAAE,MAAM,EAAE,cAAc,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IACrM,CAAC;AACH,CAAC"}
+{"version":3,"file":"settings.js","sourceRoot":"","sources":["../src/settings.ts"],"names":[],"mappings":"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"}

package/dist/setup/ffmpeg-readiness.js

@@ -1,5 +1,5 @@
 const encoders = ['libx264', 'aac', 'libmp3lame'];
-const filters = ['subtitles'];
+const filters = ['subtitles', 'xfade', 'loudnorm', 'afftdn', 'gradients', 'perspective', 'alphamerge', 'drawtext', 'xstack'];
 function succeeded(answer) {
     return answer !== undefined && answer.exitCode === 0;
 }

package/dist/setup/ffmpeg-readiness.js.map

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

package/dist/ui.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ui.d.ts","sourceRoot":"","sources":["../src/ui.ts"],"names":[],"mappings":"AAAA,OAAO,EAAK,KAAK,GAAG,EAAE,MAAM,YAAY,CAAC;AAoBzC,wBAAgB,UAAU,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI,CAQzC"}
+{"version":3,"file":"ui.d.ts","sourceRoot":"","sources":["../src/ui.ts"],"names":[],"mappings":"AAAA,OAAO,EAAK,KAAK,GAAG,EAAE,MAAM,YAAY,CAAC;AAqBzC,wBAAgB,UAAU,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI,CAQzC"}

package/dist/ui.js

@@ -1,5 +1,5 @@
 import { z } from '@kvman/sdk';
-// kvvideo's configuration on its extension page (plan 16 §16.2): three cards of setting rows, and nothing else. The
+// kvvideo's configuration on its extension page (plan 16 §16.2): four cards of setting rows, and nothing else. The
 // keys' secrets are added in the page's own Secrets section (plan 06 §6.6).
 const settings = (keys) => keys.map((key) => ({ type: 'setting', key }));
 const configuration = {
@@ -7,7 +7,8 @@ const configuration = {
     direction: 'vertical',
     gap: 'md',
     children: [
-        { type: 'card', title: 'kvvideo.config.narration', children: settings(['kvvideo.narration.service', 'kvvideo.narration.voice', 'kvvideo.narration.model']) },
+        { type: 'card', title: 'kvvideo.config.narration', children: settings(['kvvideo.narration.service', 'kvvideo.narration.voice', 'kvvideo.narration.model', 'kvvideo.narration.pronunciations']) },
+        { type: 'card', title: 'kvvideo.config.brand', children: settings(['kvvideo.brand']) },
         { type: 'card', title: 'kvvideo.config.recording', children: settings(['kvvideo.browser']) },
         { type: 'card', title: 'kvvideo.config.programs', children: settings(['kvvideo.programs.ffmpeg', 'kvvideo.programs.ffprobe', 'kvvideo.programs.piper']) },
     ],

package/dist/ui.js.map

@@ -1 +1 @@
-{"version":3,"file":"ui.js","sourceRoot":"","sources":["../src/ui.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAY,MAAM,YAAY,CAAC;AAEzC,oHAAoH;AACpH,4EAA4E;AAE5E,MAAM,QAAQ,GAAG,CAAC,IAAuB,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;AAE5F,MAAM,aAAa,GAAG;IACpB,IAAI,EAAE,OAAO;IACb,SAAS,EAAE,UAAU;IACrB,GAAG,EAAE,IAAI;IACT,QAAQ,EAAE;QACR,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,0BAA0B,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,2BAA2B,EAAE,yBAAyB,EAAE,yBAAyB,CAAC,CAAC,EAAE;QAC5J,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,0BAA0B,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,iBAAiB,CAAC,CAAC,EAAE;QAC5F,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,yBAAyB,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,yBAAyB,EAAE,0BAA0B,EAAE,wBAAwB,CAAC,CAAC,EAAE;KAC1J;CACF,CAAC;AAEF,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,aAAa,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;AAE1K,MAAM,UAAU,UAAU,CAAC,GAAQ;IACjC,GAAG,CAAC,aAAa,CAAC,gBAAgB,EAAE;QAClC,WAAW,EAAE,8DAA8D;QAC3E,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;QACnB,MAAM,EAAE,mBAAmB;QAC3B,MAAM,EAAE,IAAI;QACZ,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,aAAa,EAAE,CAAC;KAC9E,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"ui.js","sourceRoot":"","sources":["../src/ui.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAY,MAAM,YAAY,CAAC;AAEzC,mHAAmH;AACnH,4EAA4E;AAE5E,MAAM,QAAQ,GAAG,CAAC,IAAuB,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;AAE5F,MAAM,aAAa,GAAG;IACpB,IAAI,EAAE,OAAO;IACb,SAAS,EAAE,UAAU;IACrB,GAAG,EAAE,IAAI;IACT,QAAQ,EAAE;QACR,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,0BAA0B,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,2BAA2B,EAAE,yBAAyB,EAAE,yBAAyB,EAAE,kCAAkC,CAAC,CAAC,EAAE;QAChM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,sBAAsB,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,eAAe,CAAC,CAAC,EAAE;QACtF,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,0BAA0B,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,iBAAiB,CAAC,CAAC,EAAE;QAC5F,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,yBAAyB,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,yBAAyB,EAAE,0BAA0B,EAAE,wBAAwB,CAAC,CAAC,EAAE;KAC1J;CACF,CAAC;AAEF,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,aAAa,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;AAE1K,MAAM,UAAU,UAAU,CAAC,GAAQ;IACjC,GAAG,CAAC,aAAa,CAAC,gBAAgB,EAAE;QAClC,WAAW,EAAE,8DAA8D;QAC3E,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;QACnB,MAAM,EAAE,mBAAmB;QAC3B,MAAM,EAAE,IAAI;QACZ,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,aAAa,EAAE,CAAC;KAC9E,CAAC,CAAC;AACL,CAAC"}

package/dist/web/components/player.css

@@ -1,2 +1,2 @@
-.kvvideo-player{padding:var(--kv-space-sm);border:1px solid var(--kv-color-border);border-radius:var(--kv-radius);background:var(--kv-color-surface);max-inline-size:640px;margin:0}.kvvideo-player-head{gap:var(--kv-space-sm);color:var(--kv-color-muted);justify-content:space-between;padding-block-end:var(--kv-space-sm);font-size:.85em;display:flex}.kvvideo-player-file{text-overflow:ellipsis;white-space:nowrap;font-family:var(--kv-font-mono);overflow:hidden}.kvvideo-player-video{border-radius:calc(var(--kv-radius) / 2);background:#000;max-block-size:360px;inline-size:100%;display:block}.kvvideo-player-unavailable{color:var(--kv-color-text);margin:0}
+.kvvideo-player{padding:var(--kv-space-sm);border:1px solid var(--kv-color-border);border-radius:var(--kv-radius);background:var(--kv-color-surface);max-inline-size:640px;margin:0}.kvvideo-player-head{gap:var(--kv-space-sm);color:var(--kv-color-muted);justify-content:space-between;padding-block-end:var(--kv-space-sm);font-size:.85em;display:flex}.kvvideo-player-file{text-overflow:ellipsis;white-space:nowrap;font-family:var(--kv-font-mono);overflow:hidden}.kvvideo-player-video{border-radius:calc(var(--kv-radius) / 2);background:#000;max-block-size:360px;inline-size:100%;display:block}.kvvideo-player-unavailable{color:var(--kv-color-text);margin:0}.kvvideo-player-others{color:var(--kv-color-muted);font-family:var(--kv-font-mono);margin:0;padding-block-start:var(--kv-space-sm);padding-inline-start:0;font-size:.85em;list-style:none}
 /*$vite$:1*/

package/dist/web/components/player.js

@@ -1,43 +1,55 @@
-import { computed as e, createElementBlock as t, createElementVNode as n, defineComponent as r, inject as i, openBlock as a, ref as o, toDisplayString as s, unref as c } from "vue";
+import { Fragment as e, computed as t, createCommentVNode as n, createElementBlock as r, createElementVNode as i, defineComponent as a, inject as o, openBlock as s, ref as c, renderList as l, toDisplayString as u, unref as d } from "vue";
 //#region web/components/player.vue?vue&type=script&setup=true&lang.ts
-var l = {
+var f = {
 	class: "kvvideo-player",
 	"data-test": "player"
-}, u = { class: "kvvideo-player-head" }, d = {
+}, p = { class: "kvvideo-player-head" }, m = {
 	class: "kvvideo-player-file",
 	dir: "auto",
 	"data-test": "file"
-}, f = {
+}, h = {
 	class: "kvvideo-player-length",
 	dir: "ltr",
 	"data-test": "length"
-}, p = ["src"], m = {
+}, g = ["src", "poster"], _ = {
 	key: 1,
 	class: "kvvideo-player-unavailable",
 	"data-test": "unavailable"
-}, h = /* @__PURE__ */ r({
+}, v = {
+	key: 2,
+	class: "kvvideo-player-others",
+	"data-test": "others"
+}, y = /* @__PURE__ */ a({
 	__name: "player",
 	props: {
 		payload: {},
 		output: {}
 	},
-	setup(r) {
-		let h = r, g = i("kvman");
-		if (g === void 0) throw Error("kvvideo components run inside kvwebui, which provides kvman.");
-		let { t: _, workspace: v } = g, y = o(!1), b = e(() => typeof h.output.file == "string" ? h.output.file : ""), x = e(() => typeof h.output.fileId == "string" ? h.output.fileId : void 0), S = e(() => x.value === void 0 ? void 0 : `/api/files/${encodeURIComponent(x.value)}?workspaceId=${encodeURIComponent(v.value.id)}`), C = e(() => {
-			let e = Math.round((typeof h.output.durationMs == "number" ? h.output.durationMs : 0) / 1e3);
+	setup(a) {
+		let y = a, b = o("kvman");
+		if (b === void 0) throw Error("kvvideo components run inside kvwebui, which provides kvman.");
+		let { t: x, workspace: S } = b, C = c(!1), w = t(() => typeof y.output.file == "string" ? y.output.file : ""), T = t(() => typeof y.output.fileId == "string" ? y.output.fileId : void 0), E = (e) => `/api/files/${encodeURIComponent(e)}?workspaceId=${encodeURIComponent(S.value.id)}`, D = t(() => T.value === void 0 ? void 0 : E(T.value)), O = t(() => typeof y.output.posterFileId == "string" ? E(y.output.posterFileId) : void 0), k = t(() => Array.isArray(y.output.others) ? y.output.others.flatMap((e) => typeof e == "object" && e && "file" in e && typeof e.file == "string" ? [e.file] : []) : []), A = t(() => {
+			let e = Math.round((typeof y.output.durationMs == "number" ? y.output.durationMs : 0) / 1e3);
 			return `${String(Math.floor(e / 60))}:${String(e % 60).padStart(2, "0")}`;
 		});
-		return (e, r) => (a(), t("figure", l, [n("figcaption", u, [n("span", d, s(b.value), 1), n("span", f, s(C.value), 1)]), S.value !== void 0 && !y.value ? (a(), t("video", {
-			key: 0,
-			class: "kvvideo-player-video",
-			"data-test": "video",
-			src: S.value,
-			controls: "",
-			preload: "metadata",
-			onError: r[0] ||= (e) => y.value = !0
-		}, null, 40, p)) : (a(), t("p", m, s(c(_)("kvvideo.player.unavailable", { file: b.value })), 1))]));
+		return (t, a) => (s(), r("figure", f, [
+			i("figcaption", p, [i("span", m, u(w.value), 1), i("span", h, u(A.value), 1)]),
+			D.value !== void 0 && !C.value ? (s(), r("video", {
+				key: 0,
+				class: "kvvideo-player-video",
+				"data-test": "video",
+				src: D.value,
+				poster: O.value,
+				controls: "",
+				preload: "metadata",
+				onError: a[0] ||= (e) => C.value = !0
+			}, null, 40, g)) : (s(), r("p", _, u(d(x)("kvvideo.player.unavailable", { file: w.value })), 1)),
+			k.value.length > 0 ? (s(), r("ul", v, [(s(!0), r(e, null, l(k.value, (e) => (s(), r("li", {
+				key: e,
+				dir: "auto"
+			}, u(e), 1))), 128))])) : n("v-if", !0)
+		]));
 	}
 });
 //#endregion
-export { h as default };
+export { y as default };

package/docs/guide.md

@@ -1,16 +1,45 @@
-You can make videos with the `video` connector: tutorials that show how to use the person's app, demos, and promotional videos. A video is composed from pages of an app running on this computer, recorded in the installed browser, a narration of your script, and captions burned into the picture.
+You can make any kind of video with the `video` connector: a lesson, an explainer, a tutorial of an app or a website, a promotion, an announcement, a story, a social clip. A video is composed, not generated: HTML scenes you write and websites, recorded in the installed browser; the person's images and clips, and licensed ones from the web; a narration from a voice service or recorded by the person; captions; joined with ffmpeg. Never generate images. Make it polished unless the person asks otherwise.
 
-How to make one:
+Make every video through these stages, in order; each ends with what it gives the next, and a stage the request already settles takes a line (a script the person gave settles the concept). Keep a video's files in its own folder, such as `videos/<name>/`, and the video beside it.
 
-1. Run `video check` first. When something is missing, tell the person in plain words what to install or set, and stop until it is there: ffmpeg (with libass) from https://ffmpeg.org/download.html; Google Chrome or Microsoft Edge; a narration service chosen on kvvideo's extension page, with its key added there as a secret (`elevenlabs.apiKey` or `openai.apiKey`), or Piper (`pip install piper-tts`) with a voice file.
-2. Make sure the app runs: start its dev server in the background with `shell`, and use its localhost address. Only pages on this computer can be recorded.
-3. Write the script as a Markdown artifact: one section per scene, each with its narration and what is on screen. Keep scenes short, a few sentences each. Have the person agree to it before you narrate, since narration with ElevenLabs or OpenAI costs money.
-4. For each scene, run `narrate` first: its answer has the narration's length and its captions. Then `record` the scene, with `wait` steps so the picture lasts about as long as the narration; each step's `atMs` says when it happened.
-5. Run `compose` last, with each scene's clip, narration, and captions. Tell the person where the file is; the chat shows a player.
+1. **Ready.** Run `video check`. When something is missing, tell the person in plain words what to install or set, and stop until it is there: ffmpeg (with libass and libfreetype) from https://ffmpeg.org/download.html; Google Chrome or Microsoft Edge; a narration service chosen on kvvideo's extension page, with its key added there as a secret (`elevenlabs.apiKey` or `openai.apiKey`), or Piper (`pip install piper-tts`) with a voice file.
+2. **Brief.** Read everything the person sent, and look at what the video is about (their app, site, or files, and the workspace's brand with `video brand`) before you ask. Then ask in one round only what is still open, your recommendation first in each: what the viewer should know or do after watching, who they are, where it will be shown (this sets the shapes and the length: a social clip is 1080 × 1920, under 60 s, and works on mute), the length, the language, and the voice (generated, or the person's own). Write the answers to `brief.md` in the video's folder.
+3. **Research.** Gather the facts with their sources, the person's media, and licensed media from the web, and add them to `brief.md`. When the video shows an app of the workspace, start it in the background with `shell`, walk its flows once in the browser, and note the real labels, the selectors, and the demo data each scene needs: clean, believable data, never the person's private data.
+4. **Concept.** Write the core message in one sentence, the hook of the first 3 s, and the structure, starting from the video's kind:
+   - a tutorial: the goal, each step in order, the result, what to do next;
+   - an explainer: the problem, why it matters, how it works, an example, a recap;
+   - a promotion: a hook, the pain, the product as the answer, proof, the offer and its call to action;
+   - an announcement: what is new, why it matters, how to get it;
+   - a story: the setting, the turn, the resolution;
+   - a social clip: the payoff promised in the first 2 s, delivered fast, then a call to action.
+   When the concept is open (a promotion, a story, an explainer without a script, or any video whose angle could go several ways), hand the brief in one `delegate run` to the worker that debates approaches, when the `delegate` entry lists one, asking for two or three directions, the strongest first, each with its hook, structure, and look; then offer them to the person with `ask choice`. Choose the concept yourself for a tutorial of clear steps or a script the person gave. Add the chosen concept to `brief.md`.
+5. **Treatment.** Show the person the whole video before anything costs money:
+   - a Markdown artifact: the concept in a line; "Look and sound" (the shapes, the brand, the framing, the caption style, the transitions, the sound effects, and the voice: generated, with its service, tone, and speed, or recorded by the person, with what the examples cost); a table with one row per scene: its purpose, its narration, its picture (an HTML scene, a website, an image, or a clip), its on-screen text, its motion, its transition, and its length; then the media from the web with their sources and licences;
+   - `style.css` in the video's folder: the colours, fonts, type sizes, spacing, and motion (easing and durations) that every HTML scene uses, from the brand;
+   - one or two style frames, the title and a typical scene, as HTML scenes you checked with `video look`, each shown as an HTML artifact with `style.css` copied into a `<style>` element, since an artifact can't load the workspace's files.
+   Narration runs about 2.5 words a second in English and 2 in Arabic: each scene's narration fits its length, and the whole is within 10% of the length asked. Then ask with `ask choice`, the option that makes the video first and one that changes something. The person's agreement covers everything the treatment lists and is the go-ahead for the production map: never ask it again. When they change something, change the treatment and ask again. Save a new brand with `video brand-set` once they agree.
+6. **Production map.** When the `execution-map` connector is listed, set a map from the treatment: the voice, the scenes, the recordings, the assembly and review, and the delivery, with scenes that can be made at once as parallel steps, and start at once.
+7. **Voice first.** Make each scene's narration before its picture: `narrate`; or, for the person's own voice, `narrate` each sentence as an example, `ask record` with one card per scene (each sentence a line, with the words to stress and where to pause), and `voice` with the takes it answers. The caption times it answers are the clock the picture follows.
+8. **Pictures.**
+   - **HTML scenes** link `style.css` and move with CSS animations and transitions only, never script timers. Time each element to its words: a page's clock starts when its recording starts and the narration 300 ms later, so an element that comes in with caption line n has an `animation-delay` of 300 ms plus that line's `startMs`. Look at each scene with `video look` at the moments that matter, and fix it before you record it. With four or more HTML scenes besides the style frames, hand them to designer workers of the `delegate` connector, one scene file each, all in the same reply: each brief, titled motion graphics designer, names `brief.md`, `style.css`, and the style frames in its context, gives the scene's row of the treatment and its caption times, and says to check the scene with `video look`; check each again with `video look` when it comes back.
+   - **Websites**: `record` with the scene's `narration`, each action at its caption line with `atLine`. Mark where the eye must go with a `callout` or a `highlight` in `compose`, and `blur` anything private.
+   - **Images and clips** go to `compose` as they are, a clip's part chosen with `from` and `to`.
+   Then `record` each HTML scene with its `narration`.
+9. **Assemble and review.** `compose`, then `video review`, and look at every sheet against the treatment: each scene says and shows what its row says; actions land on their words; text is spelled right, readable on its background, and inside the middle 90% of the frame; nothing is cut off, overlapping, empty, or badly zoomed; the look is the same in every scene; private data is blurred; credits are there; and the review reports no problem. Fix each fault at its cause and compose again, at most three rounds; after the third, tell the person what is still wrong.
+10. **Deliver.** Make the other shapes the brief needs with `extraSizes`. Tell the person where the file is, its length, and its shapes; the chat shows a player. When they ask for a change at a time ("at 0:42"), find its scene from the video's scene times, make only that scene again, and compose again: unchanged narration comes free from the cache.
+
+How a good video looks and sounds:
+
+- **Story.** Show rather than tell: the narration explains what the picture can't, and on-screen text is a few words. One idea per scene, in a logical order, ending with the next step or a call to action. No filler, repetition, or long still shots; scenes of 3 to 12 s unless the content needs more.
+- **Look.** The same colours, type, and style in every scene, from `style.css`. For the first video, take the brand from what the person gave or what the video is about (their app's or site's styles, their logo file), or design one. Give each HTML scene a clear hierarchy, alignment, contrast, and space, with important things inside the middle 90% of the frame. Draw titles, diagrams, charts, and illustrations as HTML, CSS, and SVG; use the person's media and licensed media from the web for what drawing can't show. Show a recorded website in a `window` frame, a phone site in a `phone` frame.
+- **Motion.** Let `record` and `compose` move the pointer and the camera. In an HTML scene, enter with an ease-out of 300 to 600 ms, never linear, one thing moving at a time, and kinetic text only for the key words. Use `crossfade` between scenes, `slide` for a step forward in a sequence, and `fade-black` before the ending.
+- **Text.** Short, correctly spelled, readable on its background, and in the video's language. Arabic reads right to left in an Arabic font, with `dir="auto"` on every text element of an HTML scene.
+- **Sound.** A clear, natural voice whose `tone` and `speed` fit the purpose; names said right through the pronunciation list (`kvvideo.narration.pronunciations`). Sound effects stay on unless the person asks otherwise. There is no music.
+- **Accuracy and licences.** Say only what is true: what the person gave, what was recorded, or what a source read through a connector says; no invented numbers, features, quotes, or claims. Blur emails, keys, names, and other personal data on screen. A font, library, image, or clip from the web is used only under a licence that allows it, saved in the video's folder, with its source and licence in the treatment and its credit in the end scene when the licence asks for one; pin a library's exact version.
 
 Rules:
 
-- Narrate a scene again only when its text changed.
-- Put the parts of a video in their own folder, such as `videos/<name>/`, and the video beside it.
-- When the person asks for a font, find it on the web, save its .ttf or .otf file in the workspace, and name that file in `compose`'s `captions.font`. `video fonts` lists the bundled ones.
+- In a chat without `ask` (Decide for me), choose the concept yourself, show the treatment, say what you chose, and go on; the person's voice can't be recorded there, so use a generated one and say so in the treatment.
+- Narrate a sentence again only when it changed; the cache makes an unchanged one free.
+- When the person asks for a font, find it on the web, save its `.ttf` or `.otf` file in the workspace, and name that file.
 - A target in `record` is a Playwright selector: prefer `role=button[name="Save"]` or `text=Save` to CSS classes.

package/locales/ar.json

@@ -33,5 +33,16 @@
   "kvvideo.errors.NARRATION_KEY_MISSING": "مفتاح {service} مفقود: أضف السر {secret} في صفحة إضافة kvvideo.",
   "kvvideo.errors.NARRATION_FAILED": "تعذّر على {service} التعليق الصوتي: {reason}",
   "kvvideo.errors.RENDER_FAILED": "تعذّر على ffmpeg صنع الفيديو: {reason}",
-  "kvvideo.player.unavailable": "لا يمكن تشغيل هذا الفيديو هنا. افتح {file} في مساحة العمل."
+  "kvvideo.player.unavailable": "لا يمكن تشغيل هذا الفيديو هنا. افتح {file} في مساحة العمل.",
+  "kvvideo.progress.step": "تسجيل الخطوة {n} من {of}",
+  "kvvideo.narration.pronunciations.title": "النطق",
+  "kvvideo.narration.pronunciations.description": "كلمات يُنطق بها الراوي بطريقة مختلفة، في قائمة من { \"word\", \"say\" }: تُقرأ \"kvman\" كـ \"kay-vee-man\". تبقى الكلمة في الترجمة النصية كما كُتبت.",
+  "kvvideo.progress.sentence": "قراءة الجملة {n} من {of}",
+  "kvvideo.config.brand": "الهوية",
+  "kvvideo.brand.title": "الهوية",
+  "kvvideo.brand.description": "شعار فيديوهات مساحة العمل هذه وألوانها وخطها، بالصيغة { \"logo\", \"colors\": { \"primary\", \"background\", \"text\" }, \"font\" }. يقترحها الوكيل في نص الفيديو ويحفظها حين توافق.",
+  "kvvideo.progress.scene": "المشهد {n} من {of}",
+  "kvvideo.progress.final": "المرحلة الأخيرة، {percent}%",
+  "kvvideo.progress.sheet": "الورقة {n} من {of}",
+  "kvvideo.progress.take": "تنقية التسجيل {n} من {of}"
 }

package/locales/en.json

@@ -33,5 +33,16 @@
   "kvvideo.errors.NARRATION_KEY_MISSING": "The {service} key is missing: add the secret {secret} on kvvideo's extension page.",
   "kvvideo.errors.NARRATION_FAILED": "{service} couldn't narrate: {reason}",
   "kvvideo.errors.RENDER_FAILED": "ffmpeg couldn't make the video: {reason}",
-  "kvvideo.player.unavailable": "This video can't play here. Open {file} in the workspace."
+  "kvvideo.player.unavailable": "This video can't play here. Open {file} in the workspace.",
+  "kvvideo.progress.step": "Recording step {n} of {of}",
+  "kvvideo.narration.pronunciations.title": "Pronunciations",
+  "kvvideo.narration.pronunciations.description": "Words the narration says differently, as a list of { \"word\", \"say\" }: \"kvman\" said as \"kay-vee-man\". The captions keep the word as written.",
+  "kvvideo.progress.sentence": "Narrating sentence {n} of {of}",
+  "kvvideo.config.brand": "Brand",
+  "kvvideo.brand.title": "Brand",
+  "kvvideo.brand.description": "The logo, colours, and font of this workspace's videos, as { \"logo\", \"colors\": { \"primary\", \"background\", \"text\" }, \"font\" }. The agent proposes it in a video's script and saves it once you agree.",
+  "kvvideo.progress.scene": "Scene {n} of {of}",
+  "kvvideo.progress.final": "Final pass, {percent}%",
+  "kvvideo.progress.sheet": "Sheet {n} of {of}",
+  "kvvideo.progress.take": "Cleaning take {n} of {of}"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@kvman/kvvideo",
-  "version": "0.1.0",
-  "description": "kvvideo: the kvcoder extension that makes videos of the person's app, recorded, narrated, and captioned.",
+  "version": "0.1.2",
+  "description": "kvvideo: the kvcoder extension that makes any kind of video, from websites and pages recorded in the browser, narrated, and captioned.",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -26,7 +26,8 @@
     "dist",
     "docs",
     "fonts",
-    "locales"
+    "locales",
+    "sounds"
   ],
   "peerDependencies": {
     "@kvman/sdk": "^0.1.5"
@@ -36,8 +37,8 @@
     "vue": "3.5.43"
   },
   "devDependencies": {
-    "@kvman/kvai": "0.1.8",
-    "@kvman/kvcoder": "0.1.16",
+    "@kvman/kvai": "0.1.9",
+    "@kvman/kvcoder": "0.1.21",
     "@kvman/kvwebui": "0.1.8",
     "@kvman/sdk": "0.1.5",
     "@kvman/testkit": "0.1.10",
@@ -60,6 +61,11 @@
         [
           "path"
         ]
+      ],
+      "narrations": [
+        [
+          "key"
+        ]
       ]
     }
   },

package/sounds/SOURCES.md

@@ -0,0 +1,13 @@
+# kvvideo's sound effects
+
+kvvideo made these four sounds itself with ffmpeg (plan 16 §16.8, ADR 0115, 62). They are released under CC0 1.0
+(public domain): https://creativecommons.org/publicdomain/zero/1.0/
+
+Each was made as 48 kHz mono 16-bit PCM from the source below, then turned up or down so its peak is −3 dBFS.
+
+| File | Length | Source (`ffmpeg -f lavfi -i <source> -af <filters> -ac 1 -ar 48000 -c:a pcm_s16le`) |
+|---|---|---|
+| `click.wav` | 45 ms | `aevalsrc='0.6*sin(2*PI*2400*t)*exp(-t*180)+0.4*(random(0)-0.5)*exp(-t*320)':d=0.045:s=48000`, filters `highpass=f=900` |
+| `keys.wav` | 2.07 s, a loop of key taps every 115 ms | `aevalsrc='(random(0)-0.5)*exp(-mod(t,0.115)*380)*(0.7+0.3*sin(2*PI*t*0.9))':d=2.07:s=48000`, filters `highpass=f=1800,lowpass=f=9000` |
+| `whoosh.wav` | 550 ms | `aevalsrc='(random(0)-0.5)*pow(sin(PI*t/0.55),2)':d=0.55:s=48000`, filters `highpass=f=250,lowpass=f=2600` |
+| `pop.wav` | 140 ms | `aevalsrc='0.9*sin(2*PI*(380*t+2600*t*t))*exp(-t*38)':d=0.14:s=48000`, filters `afade=t=in:d=0.004` |