@kvman/kvvideo 0.1.0 → 0.1.2

package/dist/compose/drawn-images.js

@@ -0,0 +1,75 @@
+import { readFileSync } from 'node:fs';
+import path from 'node:path';
+/** A painter on a browser, drawing at one pixel per CSS pixel. */
+export function painterOf(browser) {
+    return {
+        draw: async (file, size, html, clear) => {
+            const context = await browser.newContext({ viewport: size, deviceScaleFactor: 1 });
+            try {
+                const page = await context.newPage();
+                await page.setContent(html, { waitUntil: 'load' });
+                await page.evaluate('document.fonts.ready.then(() => true)');
+                await page.screenshot({ path: file, omitBackground: clear, scale: 'css' });
+            }
+            finally {
+                await context.close();
+            }
+        },
+    };
+}
+const px = (value) => `${String(Math.round(value))}px`;
+const placed = (rect) => `position:absolute;inset-inline-start:${px(rect.x)};inset-block-start:${px(rect.y)};inline-size:${px(rect.width)};block-size:${px(rect.height)}`;
+const pageOf = (body, background) => `<!doctype html><html dir="ltr"><head><style>html,body{margin:0;background:${background};overflow:hidden}</style></head><body>${body}</body></html>`;
+/** The window's shadow or the phone's body, on a clear picture. */
+export function chromeHtml(layout) {
+    if (layout.kind === 'window') {
+        const { offset, blur } = layout.shadow;
+        return pageOf(`<div style="${placed(layout.screen)};border-radius:${px(layout.radius)};background:#000;box-shadow:0 ${px(offset)} ${px(blur)} rgba(0,0,0,.45)"></div>`, 'transparent');
+    }
+    const outline = Math.max(1, Math.round(layout.body.width * 0.006));
+    return pageOf(`<div style="${placed(layout.body)};border-radius:${px(layout.bodyRadius)};background:#111;box-shadow:inset 0 0 0 ${px(outline)} #3a3a3a,0 ${px(layout.body.height * 0.02)} ${px(layout.body.height * 0.05)} rgba(0,0,0,.45)"></div>`, 'transparent');
+}
+/** The clip's rounded corners: white inside, black outside, the size of the clip's place. */
+export function maskHtml(size, radius) {
+    return pageOf(`<div style="${placed({ x: 0, y: 0, ...size })};border-radius:${px(radius)};background:#fff"></div>`, '#000');
+}
+/** A highlight over a page of `size`: dimmed to 55% black but the box, with 12 CSS pixels around it, rounded. */
+export function highlightHtml(box, scale) {
+    const around = 12 * scale;
+    const hole = { x: box.x - around, y: box.y - around, width: box.width + 2 * around, height: box.height + 2 * around };
+    return pageOf(`<div style="${placed(hole)};border-radius:${px(around)};box-shadow:0 0 0 99999px rgba(0,0,0,.55)"></div>`, 'transparent');
+}
+const escaped = (text) => text.replace(/[&<>"']/g, (character) => `&#${String(character.codePointAt(0))};`);
+const luminance = (colour) => {
+    const [red, green, blue] = [1, 3, 5].map((at) => {
+        const value = Number.parseInt(colour.slice(at, at + 2), 16) / 255;
+        return value <= 0.03928 ? value / 12.92 : ((value + 0.055) / 1.055) ** 2.4;
+    });
+    return 0.2126 * (red ?? 0) + 0.7152 * (green ?? 0) + 0.0722 * (blue ?? 0);
+};
+/** White or near-black, whichever contrasts more with `background`. */
+export function textOn(background) {
+    const light = luminance(background);
+    return 1.05 / (light + 0.05) >= (light + 0.05) / (luminance('#111111') + 0.05) ? '#ffffff' : '#111111';
+}
+const fontFace = (font) => `@font-face{font-family:kvvideo;src:url(data:font/${path.extname(font.file).slice(1).toLowerCase()};base64,${readFileSync(font.file).toString('base64')})}`;
+/** A callout's label over a page of `size`, pointing at the box: above it when there is room, else below. */
+export function calloutHtml(size, box, text, colour, font) {
+    const fontSize = Math.round(size.height * 0.045);
+    const arrow = Math.round(fontSize * 0.5);
+    const margin = Math.round(size.width * 0.02);
+    const script = `const label = document.getElementById('label'); const tip = document.getElementById('tip');
+const box = ${JSON.stringify(box)}; const width = label.offsetWidth; const height = label.offsetHeight;
+const above = box.y - height - ${String(arrow * 2)} > ${String(margin)};
+const left = Math.min(Math.max(${String(margin)}, box.x + box.width / 2 - width / 2), ${String(size.width - margin)} - width);
+const top = above ? box.y - height - ${String(arrow * 2)} : box.y + box.height + ${String(arrow * 2)};
+label.style.insetInlineStart = left + 'px'; label.style.insetBlockStart = top + 'px';
+tip.style.insetInlineStart = (box.x + box.width / 2 - ${String(arrow)}) + 'px';
+tip.style.insetBlockStart = (above ? top + height : top - ${String(arrow)}) + 'px';
+tip.style.borderBlockStart = above ? '${String(arrow)}px solid ${colour}' : '0'; tip.style.borderBlockEnd = above ? '0' : '${String(arrow)}px solid ${colour}';`;
+    // The label's box is placed left to right; its text takes its own direction inside it, so an Arabic label stays put.
+    const label = `<div id="label" dir="ltr" style="position:absolute;white-space:nowrap;font:700 ${px(fontSize)}/1.2 kvvideo,sans-serif;color:${textOn(colour)};background:${colour};padding:.45em .9em;border-radius:999px;box-shadow:0 ${px(fontSize * 0.15)} ${px(fontSize * 0.5)} rgba(0,0,0,.35)"><span dir="auto">${escaped(text)}</span></div>`;
+    const tip = `<div id="tip" style="position:absolute;inline-size:0;block-size:0;border-inline:${px(arrow)} solid transparent"></div>`;
+    return pageOf(`<style>${fontFace(font)}</style>${label}${tip}<script>document.fonts.ready.then(() => {${script}});</script>`, 'transparent');
+}
+//# sourceMappingURL=drawn-images.js.map

package/dist/compose/drawn-images.js.map

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

package/dist/compose/final-pass.d.ts

@@ -0,0 +1,34 @@
+import { z } from '@kvman/sdk';
+import { type SoundEvent } from './sound-effects.ts';
+import { type Transition } from './transitions.ts';
+export type FinalPlan = {
+    parts: readonly string[];
+    starts: readonly number[];
+    transitions: readonly Transition[];
+    direction: 'ltr' | 'rtl';
+    events: readonly SoundEvent[];
+    durationMs: number;
+};
+/** The final pass's inputs: the parts, then each sound used, the key taps looped. */
+export declare function finalInputs(plan: FinalPlan): string[];
+/** The loudness filter: measuring when `measured` is undefined, else applying the measure; silence is left as it is. */
+export declare function loudnessFilter(measured: Loudness | undefined): string;
+/** The final pass's graph: the sound alone to measure, or the picture and the sound to encode. */
+export declare function finalGraph(plan: FinalPlan, measured: Loudness | undefined): string;
+declare const loudnessSchema: z.ZodObject<{
+    input_i: z.ZodString;
+    input_tp: z.ZodString;
+    input_lra: z.ZodString;
+    input_thresh: z.ZodString;
+    target_offset: z.ZodString;
+}, z.core.$strip>;
+/** What `loudnorm` measured. */
+export type Loudness = z.output<typeof loudnessSchema>;
+/** The measure in a measuring run's output: its last JSON object; one that isn't there fails the final pass. */
+export declare function measuredLoudness(output: string): Loudness;
+export declare function measureArgs(plan: FinalPlan, graph: string): string[];
+export declare function finalArgs(plan: FinalPlan, graph: string, output: string): string[];
+/** The poster: the frame at `atMs`, 1280 px on its longer side. */
+export declare function posterArgs(video: string, atMs: number, output: string): string[];
+export {};
+//# sourceMappingURL=final-pass.d.ts.map

package/dist/compose/final-pass.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"final-pass.d.ts","sourceRoot":"","sources":["../../src/compose/final-pass.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,YAAY,CAAC;AAE/B,OAAO,EAA4B,KAAK,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAC/E,OAAO,EAAa,KAAK,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAM9D,MAAM,MAAM,SAAS,GAAG;IAAE,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IAAC,WAAW,EAAE,SAAS,UAAU,EAAE,CAAC;IAAC,SAAS,EAAE,KAAK,GAAG,KAAK,CAAC;IAAC,MAAM,EAAE,SAAS,UAAU,EAAE,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC;AAUjM,qFAAqF;AACrF,wBAAgB,WAAW,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,EAAE,CAErD;AAsCD,wHAAwH;AACxH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,QAAQ,GAAG,SAAS,GAAG,MAAM,CAIrE;AAED,kGAAkG;AAClG,wBAAgB,UAAU,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,GAAG,SAAS,GAAG,MAAM,CAGlF;AAED,QAAA,MAAM,cAAc;;;;;;iBAAsI,CAAC;AAE3J,gCAAgC;AAChC,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,cAAc,CAAC,CAAC;AAWvD,gHAAgH;AAChH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ,CAOzD;AAID,wBAAgB,WAAW,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAEpE;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAUlF;AAED,mEAAmE;AACnE,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAEhF"}

package/dist/compose/final-pass.js

@@ -0,0 +1,106 @@
+import path from 'node:path';
+import { z } from '@kvman/sdk';
+import { kvvideoProblem } from "../problems.js";
+import { soundsFolder } from "./sound-effects.js";
+import { xfadeName } from "./transitions.js";
+const seconds = (ms) => (ms / 1000).toFixed(3);
+const target = 'I=-14:TP=-1:LRA=11';
+const gains = { click: '-18dB', keys: '-24dB', whoosh: '-18dB', pop: '-18dB' };
+function soundsUsed(plan) {
+    return [...new Set(plan.events.map((event) => event.sound))].sort();
+}
+/** The final pass's inputs: the parts, then each sound used, the key taps looped. */
+export function finalInputs(plan) {
+    return [...plan.parts.flatMap((part) => ['-i', part]), ...soundsUsed(plan).flatMap((sound) => [...(sound === 'keys' ? ['-stream_loop', '-1'] : []), '-i', path.join(soundsFolder, `${sound}.wav`)])];
+}
+function joined(plan, media) {
+    const filters = [];
+    let current = `0:${media}`;
+    plan.parts.slice(1).forEach((_, index) => {
+        const transition = plan.transitions[index];
+        const name = transition === undefined ? undefined : xfadeName(transition, plan.direction);
+        const next = `j${media}${String(index + 1)}`;
+        const input = `${String(index + 1)}:${media}`;
+        if (name === undefined || transition === undefined)
+            filters.push(`[${current}][${input}]concat=n=2:v=${media === 'v' ? 1 : 0}:a=${media === 'a' ? 1 : 0}[${next}]`);
+        else if (media === 'v')
+            filters.push(`[${current}][${input}]xfade=transition=${name}:duration=${seconds(transition.ms)}:offset=${seconds(plan.starts[index + 1] ?? 0)}[${next}]`);
+        else
+            filters.push(`[${current}][${input}]acrossfade=d=${seconds(transition.ms)}:c1=tri:c2=tri[${next}]`);
+        current = next;
+    });
+    return [...filters, media === 'v' ? `[${current}]format=yuv420p[v]` : `[${current}]anull[joineda]`];
+}
+function effects(plan) {
+    const sounds = soundsUsed(plan);
+    const filters = [];
+    const labels = [];
+    sounds.forEach((sound, soundIndex) => {
+        const events = plan.events.filter((event) => event.sound === sound);
+        const input = `${String(plan.parts.length + soundIndex)}:a`;
+        const copies = events.map((_, index) => `${sound}${String(index)}`);
+        filters.push(`[${input}]asplit=${String(events.length)}${copies.map((copy) => `[${copy}]`).join('')}`);
+        events.forEach((event, index) => {
+            const trim = event.untilMs === undefined ? '' : `atrim=0:${seconds(event.untilMs - event.atMs)},asetpts=PTS-STARTPTS,`;
+            const label = `e${sound}${String(index)}`;
+            filters.push(`[${copies[index] ?? ''}]${trim}aformat=sample_rates=48000:channel_layouts=stereo,adelay=delays=${String(Math.round(event.atMs))}:all=1,volume=${gains[sound]}[${label}]`);
+            labels.push(label);
+        });
+    });
+    const mix = labels.length === 0 ? '[joineda]anull[mixed]' : `[joineda]${labels.map((label) => `[${label}]`).join('')}amix=inputs=${String(labels.length + 1)}:duration=first:normalize=0[mixed]`;
+    return [...filters, mix];
+}
+/** The loudness filter: measuring when `measured` is undefined, else applying the measure; silence is left as it is. */
+export function loudnessFilter(measured) {
+    if (measured === undefined)
+        return `loudnorm=${target}:print_format=json`;
+    if (!Number.isFinite(Number(measured.input_i)))
+        return 'anull';
+    return `loudnorm=${target}:measured_I=${measured.input_i}:measured_TP=${measured.input_tp}:measured_LRA=${measured.input_lra}:measured_thresh=${measured.input_thresh}:offset=${measured.target_offset}:linear=true`;
+}
+/** The final pass's graph: the sound alone to measure, or the picture and the sound to encode. */
+export function finalGraph(plan, measured) {
+    const picture = measured === undefined ? [] : joined(plan, 'v');
+    return [...picture, ...joined(plan, 'a'), ...effects(plan), `[mixed]${loudnessFilter(measured)},aresample=48000[a]`].join(';\n');
+}
+const loudnessSchema = z.object({ input_i: z.string(), input_tp: z.string(), input_lra: z.string(), input_thresh: z.string(), target_offset: z.string() });
+function parsedJson(text) {
+    try {
+        return JSON.parse(text);
+    }
+    catch (error) {
+        if (error instanceof SyntaxError)
+            return undefined;
+        throw error;
+    }
+}
+/** The measure in a measuring run's output: its last JSON object; one that isn't there fails the final pass. */
+export function measuredLoudness(output) {
+    const start = output.lastIndexOf('{');
+    const end = output.lastIndexOf('}');
+    const text = start === -1 || end < start ? '' : output.slice(start, end + 1);
+    const parsed = loudnessSchema.safeParse(text === '' ? undefined : parsedJson(text));
+    if (!parsed.success)
+        throw kvvideoProblem('RENDER_FAILED', "ffmpeg's loudness measure couldn't be read", { scene: null, reason: "ffmpeg's loudness measure couldn't be read" });
+    return parsed.data;
+}
+const quiet = ['-hide_banner', '-loglevel', 'error'];
+export function measureArgs(plan, graph) {
+    return ['-hide_banner', '-nostats', '-loglevel', 'info', ...finalInputs(plan), '-filter_complex_script', graph, '-map', '[a]', '-t', seconds(plan.durationMs), '-f', 'null', '-'];
+}
+export function finalArgs(plan, graph, output) {
+    return [
+        ...quiet,
+        ...finalInputs(plan),
+        '-filter_complex_script', graph,
+        '-map', '[v]', '-map', '[a]',
+        '-c:v', 'libx264', '-preset', 'medium', '-crf', '18', '-pix_fmt', 'yuv420p', '-r', '30',
+        '-c:a', 'aac', '-b:a', '192k', '-ar', '48000', '-ac', '2',
+        '-t', seconds(plan.durationMs), '-movflags', '+faststart', '-progress', 'pipe:1', '-nostats', '-y', output,
+    ];
+}
+/** The poster: the frame at `atMs`, 1280 px on its longer side. */
+export function posterArgs(video, atMs, output) {
+    return [...quiet, '-ss', seconds(atMs), '-i', video, '-frames:v', '1', '-vf', "scale='if(gte(iw,ih),1280,-2)':'if(gte(iw,ih),-2,1280)'", '-q:v', '3', '-y', output];
+}
+//# sourceMappingURL=final-pass.js.map

package/dist/compose/final-pass.js.map

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

package/dist/compose/frame-layout.d.ts

@@ -0,0 +1,30 @@
+export type Size = {
+    width: number;
+    height: number;
+};
+export type Rect = {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+};
+export type WindowLayout = {
+    kind: 'window';
+    screen: Rect;
+    radius: number;
+    shadow: {
+        offset: number;
+        blur: number;
+    };
+};
+export type PhoneLayout = {
+    kind: 'phone';
+    body: Rect;
+    bodyRadius: number;
+    screen: Rect;
+    radius: number;
+};
+export type Layout = WindowLayout | PhoneLayout;
+export declare function windowLayout(picture: Size, clip: Size, captionsAtBottom: boolean): WindowLayout;
+export declare function phoneLayout(picture: Size, clip: Size): PhoneLayout;
+//# sourceMappingURL=frame-layout.d.ts.map

package/dist/compose/frame-layout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frame-layout.d.ts","sourceRoot":"","sources":["../../src/compose/frame-layout.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,IAAI,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAErD,MAAM,MAAM,IAAI,GAAG;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAE3E,MAAM,MAAM,YAAY,GAAG;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,CAAC;AAEtH,MAAM,MAAM,WAAW,GAAG;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,IAAI,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAE1G,MAAM,MAAM,MAAM,GAAG,YAAY,GAAG,WAAW,CAAC;AAWhD,wBAAgB,YAAY,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,gBAAgB,EAAE,OAAO,GAAG,YAAY,CAM/F;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,GAAG,WAAW,CAclE"}

package/dist/compose/frame-layout.js

@@ -0,0 +1,33 @@
+// Where a clip sits in the picture (plan 16 §16.8; ADR 0115, 10): in a window inside margins of 6% of the picture's
+// shorter side, 14% at the bottom when captions are at the bottom, so they sit on the background; in a phone 88% of
+// the picture's height; or, with no frame, as large as fits. Sizes are even, as H.264 needs.
+const even = (value) => Math.max(2, 2 * Math.round(value / 2));
+function fitted(clip, room) {
+    const scale = Math.min(room.width / clip.width, room.height / clip.height);
+    const width = even(clip.width * scale);
+    const height = even(clip.height * scale);
+    return { x: Math.round(room.x + (room.width - width) / 2), y: Math.round(room.y + (room.height - height) / 2), width, height };
+}
+export function windowLayout(picture, clip, captionsAtBottom) {
+    const shorter = Math.min(picture.width, picture.height);
+    const margin = 0.06 * shorter;
+    const bottom = captionsAtBottom ? 0.14 * shorter : margin;
+    const room = { x: margin, y: margin, width: picture.width - 2 * margin, height: picture.height - margin - bottom };
+    return { kind: 'window', screen: fitted(clip, room), radius: Math.round(0.015 * shorter), shadow: { offset: Math.round(0.02 * shorter), blur: Math.round(0.05 * shorter) } };
+}
+export function phoneLayout(picture, clip) {
+    let bodyHeight = 0.88 * picture.height;
+    let bezel = 0.022 * bodyHeight;
+    let screenHeight = bodyHeight - 2 * bezel;
+    let bodyWidth = (screenHeight * clip.width) / clip.height + 2 * bezel;
+    const widest = 0.88 * picture.width;
+    if (bodyWidth > widest) {
+        const shrink = widest / bodyWidth;
+        [bodyHeight, bezel, screenHeight, bodyWidth] = [bodyHeight * shrink, bezel * shrink, screenHeight * shrink, widest];
+    }
+    const body = { x: Math.round((picture.width - bodyWidth) / 2), y: Math.round((picture.height - bodyHeight) / 2), width: even(bodyWidth), height: even(bodyHeight) };
+    const screen = { x: Math.round(body.x + bezel), y: Math.round(body.y + bezel), width: even(bodyWidth - 2 * bezel), height: even(screenHeight) };
+    const bodyRadius = Math.round(0.12 * bodyWidth);
+    return { kind: 'phone', body, bodyRadius, screen, radius: Math.max(0, Math.round(bodyRadius - bezel)) };
+}
+//# sourceMappingURL=frame-layout.js.map

package/dist/compose/frame-layout.js.map

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

package/dist/compose/overlays.d.ts

@@ -0,0 +1,20 @@
+import type { Rect, Size } from './frame-layout.ts';
+export type PlacedOverlay = {
+    kind: 'callout' | 'highlight';
+    fromMs: number;
+    toMs: number;
+    input: number;
+} | {
+    kind: 'blur';
+    fromMs: number;
+    toMs: number;
+    box: Rect;
+};
+/** A box kept inside the page, at least 2 × 2 pixels. */
+export declare function insidePage(box: Rect, page: Size): Rect;
+/** The filters that lay the overlays on the stream `input`, in order, and the stream they end in. */
+export declare function overlayFilters(input: string, overlays: readonly PlacedOverlay[]): {
+    filters: string[];
+    output: string;
+};
+//# sourceMappingURL=overlays.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"overlays.d.ts","sourceRoot":"","sources":["../../src/compose/overlays.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAMpD,MAAM,MAAM,aAAa,GAAG;IAAE,IAAI,EAAE,SAAS,GAAG,WAAW,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,IAAI,CAAA;CAAE,CAAC;AAMvK,yDAAyD;AACzD,wBAAgB,UAAU,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,GAAG,IAAI,CAItD;AAaD,qGAAqG;AACrG,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,aAAa,EAAE,GAAG;IAAE,OAAO,EAAE,MAAM,EAAE,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CASvH"}

package/dist/compose/overlays.js

@@ -0,0 +1,30 @@
+const seconds = (ms) => (ms / 1000).toFixed(3);
+const shown = (overlay) => `enable='between(t,${seconds(overlay.fromMs)},${seconds(overlay.toMs)})'`;
+/** A box kept inside the page, at least 2 × 2 pixels. */
+export function insidePage(box, page) {
+    const x = Math.min(Math.max(0, Math.round(box.x)), page.width - 2);
+    const y = Math.min(Math.max(0, Math.round(box.y)), page.height - 2);
+    return { x, y, width: Math.max(2, Math.min(Math.round(box.width), page.width - x)), height: Math.max(2, Math.min(Math.round(box.height), page.height - y)) };
+}
+function overlayFilter(overlay, from, to, index) {
+    if (overlay.kind === 'blur') {
+        const { x, y, width, height } = overlay.box;
+        const [whole, part, blurred] = [`ow${String(index)}`, `op${String(index)}`, `ob${String(index)}`];
+        return [`[${from}]split[${whole}][${part}]`, `[${part}]crop=${String(width)}:${String(height)}:${String(x)}:${String(y)},gblur=sigma=20[${blurred}]`, `[${whole}][${blurred}]overlay=${String(x)}:${String(y)}:${shown(overlay)}[${to}]`];
+    }
+    const image = `oi${String(index)}`;
+    const fades = overlay.kind === 'callout' ? `,fade=t=in:st=${seconds(overlay.fromMs)}:d=0.2:alpha=1,fade=t=out:st=${seconds(Math.max(overlay.fromMs, overlay.toMs - 200))}:d=0.2:alpha=1` : '';
+    return [`[${String(overlay.input)}:v]format=rgba${fades}[${image}]`, `[${from}][${image}]overlay=0:0:${shown(overlay)}[${to}]`];
+}
+/** The filters that lay the overlays on the stream `input`, in order, and the stream they end in. */
+export function overlayFilters(input, overlays) {
+    let current = input;
+    const filters = [];
+    for (const [index, overlay] of overlays.entries()) {
+        const next = `oo${String(index)}`;
+        filters.push(...overlayFilter(overlay, current, next, index));
+        current = next;
+    }
+    return { filters, output: current };
+}
+//# sourceMappingURL=overlays.js.map

package/dist/compose/overlays.js.map

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

package/dist/compose/page-again.d.ts

@@ -0,0 +1,26 @@
+import type { Browser } from 'playwright-core';
+import type { Program } from '../programs/run-program.ts';
+import type { Size } from './frame-layout.ts';
+import type { Recording } from './scene-look.ts';
+/** Whether a recording's shape differs from the size's by more than 1%. */
+export declare function otherShape(recording: Recording, size: Size): boolean;
+/** The CSS size of a page recorded again for `size`: its shorter side 720, its sides even. */
+export declare function pageSizeFor(size: Size): Size;
+export type PageAgain = {
+    root: string;
+    folder: string;
+    number: number;
+    recording: Recording;
+    narration: string | undefined;
+    size: Size;
+    browser: () => Promise<Browser>;
+    ffmpeg: Program;
+    ownPort: number | null;
+    signal: AbortSignal;
+};
+/**
+ * Records the page again and answers the new clip's path, with its sidecar beside it. The sidecar is a file of the
+ * workspace, so its page is checked as `record` checks one: an HTML file inside the workspace, with no `goto`.
+ */
+export declare function recordPageAgain(again: PageAgain): Promise<string>;
+//# sourceMappingURL=page-again.d.ts.map

package/dist/compose/page-again.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-again.d.ts","sourceRoot":"","sources":["../../src/compose/page-again.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAO/C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAQjD,2EAA2E;AAC3E,wBAAgB,UAAU,CAAC,SAAS,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,GAAG,OAAO,CAIpE;AAED,8FAA8F;AAC9F,wBAAgB,WAAW,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAG5C;AAED,MAAM,MAAM,SAAS,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,SAAS,CAAC;IAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,IAAI,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IAAC,MAAM,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,MAAM,EAAE,WAAW,CAAA;CAAE,CAAC;AAEzO;;;GAGG;AACH,wBAAsB,eAAe,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,CAkBvE"}

package/dist/compose/page-again.js

@@ -0,0 +1,50 @@
+import { copyFileSync, mkdirSync } from 'node:fs';
+import { performance } from 'node:perf_hooks';
+import path from 'node:path';
+import { placeOutput, workFolder } from "../files/place-output.js";
+import { readSidecar, sidecarPath, writeSidecar } from "../files/sidecar.js";
+import { inputPath } from "../files/workspace-paths.js";
+import { invalid } from "../problems.js";
+import { cuesOf } from "../record/narration-cues.js";
+import { record } from "../record/recorder.js";
+// A recorded page at another shape (plan 16 §16.8; ADR 0115, 44): an HTML scene is laid out for its shape, so for a
+// size of another shape it is recorded again, with the same steps, at that shape with its shorter side 720 CSS
+// pixels, into the size's folder, its sidecar beside it.
+const shorterSide = 720;
+/** Whether a recording's shape differs from the size's by more than 1%. */
+export function otherShape(recording, size) {
+    const recorded = recording.width / recording.height;
+    const wanted = size.width / size.height;
+    return Math.abs(recorded - wanted) / wanted > 0.01;
+}
+/** The CSS size of a page recorded again for `size`: its shorter side 720, its sides even. */
+export function pageSizeFor(size) {
+    const even = (value) => 2 * Math.round(value / 2);
+    return size.width >= size.height ? { width: even((shorterSide * size.width) / size.height), height: shorterSide } : { width: shorterSide, height: even((shorterSide * size.height) / size.width) };
+}
+/**
+ * Records the page again and answers the new clip's path, with its sidecar beside it. The sidecar is a file of the
+ * workspace, so its page is checked as `record` checks one: an HTML file inside the workspace, with no `goto`.
+ */
+export async function recordPageAgain(again) {
+    const file = inputPath(again.root, again.recording.source, ['.html', '.htm']);
+    if (again.recording.steps.some((step) => step.do === 'goto'))
+        throw invalid(`Scene ${String(again.number)}'s recorded page has a goto step, which a page can't have.`, { scene: again.number });
+    const page = pageSizeFor(again.size);
+    const narration = again.narration === undefined ? undefined : readSidecar(again.narration);
+    const cues = narration?.kind === 'narration' ? cuesOf(narration) : undefined;
+    const work = workFolder();
+    try {
+        const plan = { source: { kind: 'page', file }, steps: again.recording.steps, ...page, device: 'desktop', cues, folder: work.folder, ownPort: again.ownPort, ffmpeg: again.ffmpeg, signal: again.signal, now: () => performance.now(), stepStarted: () => undefined };
+        const recording = await record(await again.browser(), plan);
+        mkdirSync(again.folder, { recursive: true });
+        const clip = path.join(again.folder, `page-${String(again.number)}.mp4`);
+        copyFileSync(recording.video, clip);
+        placeOutput(writeSidecar(work.folder, { ...again.recording, ...page, durationMs: recording.durationMs, actions: recording.actions }), sidecarPath(clip));
+        return clip;
+    }
+    finally {
+        work.remove();
+    }
+}
+//# sourceMappingURL=page-again.js.map

package/dist/compose/page-again.js.map

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

package/dist/compose/player-copies.d.ts

@@ -2,5 +2,9 @@ import { type Ctx } from '@kvman/sdk';
 export declare const largestCopyBytes: number;
 /** Whether a video of this size gets a copy for the player. */
 export declare function copied(bytes: number): boolean;
-export declare function keepCopy(ctx: Ctx, file: string, shownPath: string, bytes: number): Promise<string | null>;
+export type PlayerCopy = {
+    fileId: string | null;
+    posterFileId: string | null;
+};
+export declare function keepCopy(ctx: Ctx, file: string, shownPath: string, bytes: number, poster: string): Promise<PlayerCopy>;
 //# sourceMappingURL=player-copies.d.ts.map

package/dist/compose/player-copies.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"player-copies.d.ts","sourceRoot":"","sources":["../../src/compose/player-copies.ts"],"names":[],"mappings":"AAEA,OAAO,EAAK,KAAK,GAAG,EAAE,MAAM,YAAY,CAAC;AAMzC,eAAO,MAAM,gBAAgB,QAAoB,CAAC;AAKlD,+DAA+D;AAC/D,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAE7C;AAED,wBAAsB,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAe/G"}
+{"version":3,"file":"player-copies.d.ts","sourceRoot":"","sources":["../../src/compose/player-copies.ts"],"names":[],"mappings":"AAEA,OAAO,EAAK,KAAK,GAAG,EAAE,MAAM,YAAY,CAAC;AAMzC,eAAO,MAAM,gBAAgB,QAAoB,CAAC;AAKlD,+DAA+D;AAC/D,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAE7C;AAED,MAAM,MAAM,UAAU,GAAG;IAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC;AAQhF,wBAAsB,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAU5H"}

package/dist/compose/player-copies.js

@@ -1,31 +1,34 @@
 import { readFileSync } from 'node:fs';
 import path from 'node:path';
 import { z } from '@kvman/sdk';
-// The player's copies (plan 16 §16.7, ADR 0107, 13 and 14): a video of at most 512 MiB is copied into the kernel's
-// files, so the chat's card can play it. A new copy of a path replaces the old one, and only the newest 10 copies of
-// the workspace are kept; the collection's ids rise with time, so the oldest come first.
+// The player's copies (plan 16 §16.8; ADR 0107, 13 and 14; ADR 0115, 45): a video of at most 512 MiB is copied into
+// the kernel's files with its poster, so the chat's card can play it. A new copy of a path replaces the old one, and
+// only the newest 10 copies of the workspace are kept; the collection's ids rise with time, so the oldest come first.
 export const largestCopyBytes = 512 * 1024 * 1024;
 const kept = 10;
-const playerSchema = z.object({ path: z.string(), fileId: z.string(), createdAt: z.string() });
+const playerSchema = z.object({ path: z.string(), fileId: z.string(), posterFileId: z.string().nullable(), createdAt: z.string() });
 /** Whether a video of this size gets a copy for the player. */
 export function copied(bytes) {
     return bytes <= largestCopyBytes;
 }
-export async function keepCopy(ctx, file, shownPath, bytes) {
+async function forget(ctx, row) {
+    await ctx.files.unlink(row.fileId);
+    if (row.posterFileId !== null)
+        await ctx.files.unlink(row.posterFileId);
+    await ctx.store.collection('players', playerSchema).delete(row.id);
+}
+export async function keepCopy(ctx, file, shownPath, bytes, poster) {
     if (!copied(bytes))
-        return null;
+        return { fileId: null, posterFileId: null };
     const players = ctx.store.collection('players', playerSchema);
     const copy = await ctx.files.write(path.basename(file), readFileSync(file), 'video/mp4');
-    for (const old of await players.find({ path: shownPath }, { limit: 1000 })) {
-        await ctx.files.unlink(old.fileId);
-        await players.delete(old.id);
-    }
-    await players.insert({ path: shownPath, fileId: copy.id, createdAt: new Date().toISOString() });
+    const posterCopy = await ctx.files.write(path.basename(poster), readFileSync(poster), 'image/jpeg');
+    for (const old of await players.find({ path: shownPath }, { limit: 1000 }))
+        await forget(ctx, old);
+    await players.insert({ path: shownPath, fileId: copy.id, posterFileId: posterCopy.id, createdAt: new Date().toISOString() });
     const all = await players.find({}, { limit: 1000, order: 'asc' });
-    for (const old of all.slice(0, Math.max(0, all.length - kept))) {
-        await ctx.files.unlink(old.fileId);
-        await players.delete(old.id);
-    }
-    return copy.id;
+    for (const old of all.slice(0, Math.max(0, all.length - kept)))
+        await forget(ctx, old);
+    return { fileId: copy.id, posterFileId: posterCopy.id };
 }
 //# sourceMappingURL=player-copies.js.map

package/dist/compose/player-copies.js.map

@@ -1 +1 @@
-{"version":3,"file":"player-copies.js","sourceRoot":"","sources":["../../src/compose/player-copies.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,CAAC,EAAY,MAAM,YAAY,CAAC;AAEzC,mHAAmH;AACnH,qHAAqH;AACrH,yFAAyF;AAEzF,MAAM,CAAC,MAAM,gBAAgB,GAAG,GAAG,GAAG,IAAI,GAAG,IAAI,CAAC;AAClD,MAAM,IAAI,GAAG,EAAE,CAAC;AAEhB,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AAE/F,+DAA+D;AAC/D,MAAM,UAAU,MAAM,CAAC,KAAa;IAClC,OAAO,KAAK,IAAI,gBAAgB,CAAC;AACnC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,GAAQ,EAAE,IAAY,EAAE,SAAiB,EAAE,KAAa;IACrF,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAChC,MAAM,OAAO,GAAG,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;IAC9D,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,YAAY,CAAC,IAAI,CAAC,EAAE,WAAW,CAAC,CAAC;IACzF,KAAK,MAAM,GAAG,IAAI,MAAM,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;QAC3E,MAAM,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACnC,MAAM,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC/B,CAAC;IACD,MAAM,OAAO,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;IAChG,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;IAClE,KAAK,MAAM,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC,EAAE,CAAC;QAC/D,MAAM,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACnC,MAAM,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC/B,CAAC;IACD,OAAO,IAAI,CAAC,EAAE,CAAC;AACjB,CAAC"}
+{"version":3,"file":"player-copies.js","sourceRoot":"","sources":["../../src/compose/player-copies.ts"],"names":[],"mappings":"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"}

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

@@ -1 +1 @@
-{"version":3,"file":"register-compose.d.ts","sourceRoot":"","sources":["../../src/compose/register-compose.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC;AAkCtC,wBAAgB,eAAe,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI,CA+B9C"}
+{"version":3,"file":"register-compose.d.ts","sourceRoot":"","sources":["../../src/compose/register-compose.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC;AAyDtC,wBAAgB,eAAe,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI,CAuF9C"}