versioncam 0.1.1

package/dist/cli/commands/measure.js

@@ -0,0 +1,36 @@
+import { parseArgs } from "node:util";
+import { launchBrowser } from "../../driver/launch.js";
+import { loadConfig } from "../../loader.js";
+import { formatMeasurement, measureSelector } from "../../inspect/measure.js";
+import { drivingApp } from "../app.js";
+import { openAppPage } from "./open-app.js";
+export async function measure(argv) {
+    const { positionals, values } = parseArgs({
+        args: argv,
+        options: { json: { type: "boolean" } },
+        strict: false,
+        allowPositionals: true,
+    });
+    const [path, selector] = positionals;
+    if (!path || !selector) {
+        process.stderr.write("Usage: versioncam measure <path> <selector>\n");
+        return 1;
+    }
+    const config = await loadConfig(process.cwd());
+    return drivingApp(config, async () => {
+        const browser = await launchBrowser();
+        try {
+            const { page, context } = await openAppPage(browser, config, path);
+            const measurement = await measureSelector(page, selector);
+            process.stdout.write(values.json
+                ? `${JSON.stringify(measurement, null, 2)}\n`
+                : `${formatMeasurement(measurement)}\n`);
+            await context.close();
+            return measurement.count > 0 ? 0 : 1;
+        }
+        finally {
+            await browser.close();
+        }
+    });
+}
+//# sourceMappingURL=measure.js.map

package/dist/cli/commands/measure.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"measure.js","sourceRoot":"","sources":["../../../src/cli/commands/measure.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAC9E,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,IAAc;IAC1C,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;QACxC,IAAI,EAAE,IAAI;QACV,OAAO,EAAE,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE;QACtC,MAAM,EAAE,KAAK;QACb,gBAAgB,EAAE,IAAI;KACvB,CAAC,CAAC;IAEH,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,GAAG,WAAuB,CAAC;IACjD,IAAI,CAAC,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;QACvB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,+CAA+C,CAAC,CAAC;QACtE,OAAO,CAAC,CAAC;IACX,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IAC/C,OAAO,UAAU,CAAC,MAAM,EAAE,KAAK,IAAI,EAAE;QACnC,MAAM,OAAO,GAAG,MAAM,aAAa,EAAE,CAAC;QACtC,IAAI,CAAC;YACH,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,MAAM,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;YACnE,MAAM,WAAW,GAAG,MAAM,eAAe,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;YAC1D,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,MAAM,CAAC,IAAI;gBACT,CAAC,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI;gBAC7C,CAAC,CAAC,GAAG,iBAAiB,CAAC,WAAW,CAAC,IAAI,CAC1C,CAAC;YACF,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;YACtB,OAAO,WAAW,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACvC,CAAC;gBAAS,CAAC;YACT,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;QACxB,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/cli/commands/open-app.d.ts

@@ -0,0 +1,14 @@
+import type { Browser, BrowserContext, Page } from "playwright";
+import type { ResolvedConfig } from "../../config.js";
+/**
+ * Open the app the way a clip would, minus the capture.
+ *
+ * The inspection commands have to see the page in the state a clip would find
+ * it in — signed in, settled — or their inventory describes a loading screen.
+ * The freeze script is deliberately not installed: a person looking at the
+ * page wants it behaving normally.
+ */
+export declare function openAppPage(browser: Browser, config: ResolvedConfig, path: string): Promise<{
+    page: Page;
+    context: BrowserContext;
+}>;

package/dist/cli/commands/open-app.js

@@ -0,0 +1,45 @@
+import { MUTATION_COUNTER_SCRIPT } from "../../driver/page-hooks.js";
+import { settlePage } from "../../driver/settle.js";
+/**
+ * Open the app the way a clip would, minus the capture.
+ *
+ * The inspection commands have to see the page in the state a clip would find
+ * it in — signed in, settled — or their inventory describes a loading screen.
+ * The freeze script is deliberately not installed: a person looking at the
+ * page wants it behaving normally.
+ */
+export async function openAppPage(browser, config, path) {
+    const context = await browser.newContext({
+        viewport: config.viewport,
+        deviceScaleFactor: config.dpr,
+        timezoneId: config.clock.timezoneId,
+        locale: config.clock.locale,
+        storageState: config.auth?.storageState,
+    });
+    const page = await context.newPage();
+    await page.addInitScript(MUTATION_COUNTER_SCRIPT);
+    let inFlight = 0;
+    page.on("request", () => (inFlight += 1));
+    page.on("requestfinished", () => (inFlight = Math.max(0, inFlight - 1)));
+    page.on("requestfailed", () => (inFlight = Math.max(0, inFlight - 1)));
+    const url = path.startsWith("http") ? path : `${config.baseUrl}${path}`;
+    await page.goto(url, { waitUntil: "domcontentloaded" });
+    if (config.auth?.login)
+        await config.auth.login(page);
+    await settlePage(page, () => inFlight, {
+        label: "inspect",
+        quietMs: config.settle.quietMs,
+        // A cold open, not a mid-clip wait, so it gets a cold open's budget — the
+        // same ninety seconds `open()` allows. The general `settle.timeoutMs` is
+        // fifteen, which a map app exceeds every single time: `inspect` then warned
+        // "timed out, still waiting on hook" on every call and returned complete,
+        // correct data anyway. An agent using it second-guessed that data for
+        // several calls before trusting it, which is a fair reading of a message
+        // that says a thing failed when it did not.
+        timeoutMs: 90_000,
+        yieldMs: config.settle.yieldMs,
+        hook: config.settle.ready ? () => config.settle.ready(page) : undefined,
+    });
+    return { page, context };
+}
+//# sourceMappingURL=open-app.js.map

package/dist/cli/commands/open-app.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"open-app.js","sourceRoot":"","sources":["../../../src/cli/commands/open-app.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AACrE,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEpD;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,OAAgB,EAChB,MAAsB,EACtB,IAAY;IAEZ,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC;QACvC,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,iBAAiB,EAAE,MAAM,CAAC,GAAG;QAC7B,UAAU,EAAE,MAAM,CAAC,KAAK,CAAC,UAAU;QACnC,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM;QAC3B,YAAY,EAAE,MAAM,CAAC,IAAI,EAAE,YAAY;KACxC,CAAC,CAAC;IACH,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC;IACrC,MAAM,IAAI,CAAC,aAAa,CAAC,uBAAuB,CAAC,CAAC;IAElD,IAAI,QAAQ,GAAG,CAAC,CAAC;IACjB,IAAI,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,CAAC,CAAC;IAC1C,IAAI,CAAC,EAAE,CAAC,iBAAiB,EAAE,GAAG,EAAE,CAAC,CAAC,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IACzE,IAAI,CAAC,EAAE,CAAC,eAAe,EAAE,GAAG,EAAE,CAAC,CAAC,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAEvE,MAAM,GAAG,GAAG,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,OAAO,GAAG,IAAI,EAAE,CAAC;IACxE,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,kBAAkB,EAAE,CAAC,CAAC;IAExD,IAAI,MAAM,CAAC,IAAI,EAAE,KAAK;QAAE,MAAM,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAEtD,MAAM,UAAU,CAAC,IAAI,EAAE,GAAG,EAAE,CAAC,QAAQ,EAAE;QACrC,KAAK,EAAE,SAAS;QAChB,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,OAAO;QAC9B,0EAA0E;QAC1E,yEAAyE;QACzE,4EAA4E;QAC5E,0EAA0E;QAC1E,sEAAsE;QACtE,yEAAyE;QACzE,4CAA4C;QAC5C,SAAS,EAAE,MAAM;QACjB,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,OAAO;QAC9B,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,KAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS;KACzE,CAAC,CAAC;IAEH,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;AAC3B,CAAC"}

package/dist/cli/commands/preview.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Open the scrubber, in a browser a person can see.
+ *
+ * Tuning a clip's easing and framing is done by eye, frame by frame, and this
+ * is the only way to do it — against exactly the code path the encoder uses,
+ * so what is tuned is what ships.
+ */
+export declare function preview(argv: string[]): Promise<number>;

package/dist/cli/commands/preview.js

@@ -0,0 +1,55 @@
+import { parseArgs } from "node:util";
+import { existsSync } from "node:fs";
+import { join } from "node:path";
+import { launchBrowser } from "../../driver/launch.js";
+import { loadConfig } from "../../loader.js";
+import { renderConfigOf } from "../../config.js";
+import { bundleScenes } from "../../loader.js";
+import { distPageDir, installRenderRoutes, RENDER_ORIGIN, } from "../../render/serve.js";
+/**
+ * Open the scrubber, in a browser a person can see.
+ *
+ * Tuning a clip's easing and framing is done by eye, frame by frame, and this
+ * is the only way to do it — against exactly the code path the encoder uses,
+ * so what is tuned is what ships.
+ */
+export async function preview(argv) {
+    const { positionals, values } = parseArgs({
+        args: argv,
+        options: { scene: { type: "string" }, frame: { type: "string" } },
+        strict: false,
+        allowPositionals: true,
+    });
+    const config = await loadConfig(process.cwd());
+    const sceneId = values.scene;
+    const id = sceneId ?? positionals[0];
+    if (!id) {
+        process.stderr.write("Usage: versioncam preview <id> | --scene <id>\n");
+        return 1;
+    }
+    const dir = join(config.recordingsDir, id);
+    if (!sceneId && !existsSync(join(dir, "timeline.json"))) {
+        process.stderr.write(`No recording for "${id}".\n`);
+        return 1;
+    }
+    const browser = await launchBrowser({ headless: false });
+    const context = await browser.newContext({
+        viewport: { width: 1400, height: 1000 },
+        deviceScaleFactor: 1,
+    });
+    const page = await context.newPage();
+    await installRenderRoutes(page, {
+        distDir: distPageDir(),
+        renderConfig: renderConfigOf(config),
+        recordingDir: sceneId ? undefined : dir,
+        scenesBundle: (await bundleScenes(config)) ?? undefined,
+    });
+    const query = sceneId ? `scene=${encodeURIComponent(sceneId)}` : "recording";
+    const frame = values.frame ? `&frame=${values.frame}` : "";
+    await page.goto(`${RENDER_ORIGIN}/?${query}${frame}`);
+    process.stdout.write("Scrubber open. Close the window to finish.\n");
+    await page.waitForEvent("close", { timeout: 0 });
+    await browser.close();
+    return 0;
+}
+//# sourceMappingURL=preview.js.map

package/dist/cli/commands/preview.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preview.js","sourceRoot":"","sources":["../../../src/cli/commands/preview.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EACL,WAAW,EACX,mBAAmB,EACnB,aAAa,GACd,MAAM,uBAAuB,CAAC;AAE/B;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,IAAc;IAC1C,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;QACxC,IAAI,EAAE,IAAI;QACV,OAAO,EAAE,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;QACjE,MAAM,EAAE,KAAK;QACb,gBAAgB,EAAE,IAAI;KACvB,CAAC,CAAC;IAEH,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IAC/C,MAAM,OAAO,GAAG,MAAM,CAAC,KAA2B,CAAC;IACnD,MAAM,EAAE,GAAG,OAAO,IAAK,WAAW,CAAC,CAAC,CAAwB,CAAC;IAC7D,IAAI,CAAC,EAAE,EAAE,CAAC;QACR,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,iDAAiD,CAAC,CAAC;QACxE,OAAO,CAAC,CAAC;IACX,CAAC;IAED,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC;IAC3C,IAAI,CAAC,OAAO,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,eAAe,CAAC,CAAC,EAAE,CAAC;QACxD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;QACpD,OAAO,CAAC,CAAC;IACX,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,aAAa,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC;IACzD,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC;QACvC,QAAQ,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE;QACvC,iBAAiB,EAAE,CAAC;KACrB,CAAC,CAAC;IACH,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC;IAErC,MAAM,mBAAmB,CAAC,IAAI,EAAE;QAC9B,OAAO,EAAE,WAAW,EAAE;QACtB,YAAY,EAAE,cAAc,CAAC,MAAM,CAAC;QACpC,YAAY,EAAE,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG;QACvC,YAAY,EAAE,CAAC,MAAM,YAAY,CAAC,MAAM,CAAC,CAAC,IAAI,SAAS;KACxD,CAAC,CAAC;IAEH,MAAM,KAAK,GAAG,OAAO,CAAC,CAAC,CAAC,SAAS,kBAAkB,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC;IAC7E,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,UAAU,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAC3D,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,aAAa,KAAK,KAAK,GAAG,KAAK,EAAE,CAAC,CAAC;IAEtD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,8CAA8C,CAAC,CAAC;IACrE,MAAM,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC;IACjD,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;IACtB,OAAO,CAAC,CAAC;AACX,CAAC"}

package/dist/cli/commands/record.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Record every clip the config points at, serially.
+ *
+ * Serial by necessity rather than by caution: clips drive one app, and apps
+ * commonly hold per-session server state that two concurrent recordings
+ * corrupt. A failure does not stop the run — the other clips are still worth
+ * having, and a report of which ones broke is more useful than the first
+ * error alone.
+ */
+export declare function record(argv: string[]): Promise<number>;

package/dist/cli/commands/record.js

@@ -0,0 +1,86 @@
+import { existsSync } from "node:fs";
+import { join } from "node:path";
+import { parseArgs } from "node:util";
+import { launchBrowser } from "../../driver/launch.js";
+import { runClip } from "../../driver/clip.js";
+import { formatTiming } from "../../core/timing.js";
+import { loadClips, loadConfig } from "../../loader.js";
+import { drivingApp } from "../app.js";
+/**
+ * Record every clip the config points at, serially.
+ *
+ * Serial by necessity rather than by caution: clips drive one app, and apps
+ * commonly hold per-session server state that two concurrent recordings
+ * corrupt. A failure does not stop the run — the other clips are still worth
+ * having, and a report of which ones broke is more useful than the first
+ * error alone.
+ */
+export async function record(argv) {
+    const { values, positionals } = parseArgs({
+        args: argv,
+        options: { draft: { type: "boolean", default: false } },
+        strict: false,
+        allowPositionals: true,
+    });
+    const draft = values.draft === true;
+    const config = await loadConfig(process.cwd());
+    const clips = await loadClips(config, positionals);
+    if (clips.length === 0) {
+        process.stderr.write(positionals.length > 0
+            ? `No clip matched ${positionals.join(", ")}.\n`
+            : `No clips found. The config looks for ${config.clips.join(", ")} under ${config.root}.\n`);
+        return 1;
+    }
+    return drivingApp(config, () => recordAll(config, clips, draft));
+}
+async function recordAll(config, clips, draft) {
+    const browser = await launchBrowser();
+    const failures = [];
+    try {
+        for (const clip of clips) {
+            const started = Date.now();
+            try {
+                const { timeline, cost } = await runClip(browser, config, clip, {
+                    draft,
+                });
+                // Both seconds are named. The line used to print "(7.5s) … — 2.6s" and
+                // leave the reader to work out that the first is the clip and the
+                // second is the machine; they move in opposite directions when a clip
+                // gets slower to record, which makes guessing worse than useless.
+                const plays = (timeline.durationFrames / timeline.fps).toFixed(1);
+                const took = ((Date.now() - started) / 1000).toFixed(1);
+                process.stdout.write(`  ${clip.id}${draft ? " (draft)" : ""}: ${timeline.durationFrames} frames, ` +
+                    `${timeline.states.length} states, ${timeline.cuts.length} cuts ` +
+                    `— plays ${plays}s · took ${took}s\n` +
+                    `    ${formatTiming(cost)}\n`);
+            }
+            catch (error) {
+                failures.push({ id: clip.id, error: error });
+                process.stdout.write(`  ${clip.id}: FAILED\n`);
+            }
+        }
+    }
+    finally {
+        await browser.close();
+    }
+    if (failures.length > 0) {
+        process.stderr.write("\n");
+        for (const { id, error } of failures) {
+            // The message says what broke; the picture says why. An authoring agent
+            // spent two of its three attempts reasoning about plausible causes —
+            // timing races, mount races, drag granularity — for a failure that was
+            // obvious in one look at the screenshot: its drag had landed on the
+            // chart's axis labels instead of the brush. It had been told to read the
+            // file and still treated it as a secondary check, because nothing at the
+            // moment of failure said the file was there. Now it does.
+            const shot = join(config.recordingsDir, id, "failure.png");
+            const picture = existsSync(shot)
+                ? `\n  the page when it gave up: ${shot}`
+                : "";
+            process.stderr.write(`${id}\n  ${error.message}${picture}\n\n`);
+        }
+        return 1;
+    }
+    return 0;
+}
+//# sourceMappingURL=record.js.map

package/dist/cli/commands/record.js.map

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

package/dist/cli/commands/render.d.ts

@@ -0,0 +1 @@
+export declare function render(argv: string[]): Promise<number>;

package/dist/cli/commands/render.js

@@ -0,0 +1,93 @@
+import { parseArgs } from "node:util";
+import { existsSync, readdirSync } from "node:fs";
+import { join } from "node:path";
+import { launchBrowser } from "../../driver/launch.js";
+import { loadConfig, loadSceneIds } from "../../loader.js";
+import { renderRecording, renderScene } from "../../render/render.js";
+import { buildSequence } from "../../render/sequence.js";
+/** Recordings on disk, newest config first, filtered by substring. */
+function recordedIds(recordingsDir, only) {
+    if (!existsSync(recordingsDir))
+        return [];
+    return readdirSync(recordingsDir, { withFileTypes: true })
+        .filter((e) => e.isDirectory())
+        .map((e) => e.name)
+        .filter((id) => existsSync(join(recordingsDir, id, "timeline.json")))
+        .filter((id) => only.length === 0 || only.some((n) => id.includes(n)))
+        .sort();
+}
+export async function render(argv) {
+    const { positionals, values } = parseArgs({
+        args: argv,
+        options: {
+            scene: { type: "string", multiple: true },
+            sequence: { type: "boolean" },
+        },
+        strict: false,
+        allowPositionals: true,
+    });
+    const config = await loadConfig(process.cwd());
+    const only = positionals;
+    const wantedScenes = values.scene ?? [];
+    // With no `--scene`, every scene the app defines is rendered too: a config
+    // that names a scenes module means those scenes are part of the deliverable.
+    const sceneIds = wantedScenes.length > 0 ? wantedScenes : await loadSceneIds(config);
+    const recordings = recordedIds(config.recordingsDir, only);
+    if (recordings.length === 0 && sceneIds.length === 0) {
+        process.stderr.write(`Nothing to render. Run \`versioncam record\` first — recordings live in ${config.recordingsDir}.\n`);
+        return 1;
+    }
+    const browser = await launchBrowser();
+    const rendered = [];
+    const failures = [];
+    try {
+        for (const id of recordings) {
+            try {
+                const out = await renderRecording(browser, config, id);
+                rendered.push(id);
+                process.stdout.write(`  ${id}: ${out.durationFrames} frames at ${out.fps}fps ` +
+                    `(${(out.durationFrames / out.fps).toFixed(1)}s)\n`);
+            }
+            catch (error) {
+                failures.push({ id, error: error });
+            }
+        }
+        for (const id of sceneIds) {
+            if (only.length > 0 && !only.some((n) => id.includes(n)))
+                continue;
+            try {
+                const out = await renderScene(browser, config, id);
+                rendered.push(id);
+                process.stdout.write(`  ${id} (scene): ${out.durationFrames} frames at ${out.fps}fps\n`);
+            }
+            catch (error) {
+                failures.push({ id, error: error });
+            }
+        }
+    }
+    finally {
+        await browser.close();
+    }
+    if (values.sequence && rendered.length >= 2) {
+        // The config's order when it states one, since a sequence is an argument
+        // and not an accident of how the directory happens to sort.
+        const order = config.sequence ?? rendered;
+        const result = await buildSequence(order.filter((id) => rendered.includes(id)), config.outputDir);
+        process.stdout.write(`  sequence: ${result.used.length} clips, ${result.total.toFixed(1)}s\n`);
+        if (result.missing.length > 0) {
+            process.stdout.write(`  (not rendered: ${result.missing.join(", ")})\n`);
+        }
+    }
+    else if (values.sequence) {
+        process.stderr.write("  sequence needs at least two rendered clips.\n");
+    }
+    if (failures.length > 0) {
+        process.stderr.write("\n");
+        for (const { id, error } of failures) {
+            process.stderr.write(`${id}\n  ${error.message}\n\n`);
+        }
+        return 1;
+    }
+    return 0;
+}
+//# sourceMappingURL=render.js.map

package/dist/cli/commands/render.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.js","sourceRoot":"","sources":["../../../src/cli/commands/render.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAClD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACtE,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAEzD,sEAAsE;AACtE,SAAS,WAAW,CAAC,aAAqB,EAAE,IAAc;IACxD,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC;QAAE,OAAO,EAAE,CAAC;IAC1C,OAAO,WAAW,CAAC,aAAa,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;SACvD,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;SAC9B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;SAClB,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,aAAa,EAAE,EAAE,EAAE,eAAe,CAAC,CAAC,CAAC;SACpE,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;SACrE,IAAI,EAAE,CAAC;AACZ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,IAAc;IACzC,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;QACxC,IAAI,EAAE,IAAI;QACV,OAAO,EAAE;YACP,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;YACzC,QAAQ,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;SAC9B;QACD,MAAM,EAAE,KAAK;QACb,gBAAgB,EAAE,IAAI;KACvB,CAAC,CAAC;IAEH,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IAC/C,MAAM,IAAI,GAAG,WAAuB,CAAC;IACrC,MAAM,YAAY,GAAI,MAAM,CAAC,KAA8B,IAAI,EAAE,CAAC;IAElE,2EAA2E;IAC3E,6EAA6E;IAC7E,MAAM,QAAQ,GACZ,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,MAAM,YAAY,CAAC,MAAM,CAAC,CAAC;IACtE,MAAM,UAAU,GAAG,WAAW,CAAC,MAAM,CAAC,aAAa,EAAE,IAAI,CAAC,CAAC;IAE3D,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACrD,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,2EAA2E,MAAM,CAAC,aAAa,KAAK,CACrG,CAAC;QACF,OAAO,CAAC,CAAC;IACX,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,aAAa,EAAE,CAAC;IACtC,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,MAAM,QAAQ,GAAmC,EAAE,CAAC;IAEpD,IAAI,CAAC;QACH,KAAK,MAAM,EAAE,IAAI,UAAU,EAAE,CAAC;YAC5B,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,MAAM,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC;gBACvD,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;gBAClB,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,KAAK,EAAE,KAAK,GAAG,CAAC,cAAc,cAAc,GAAG,CAAC,GAAG,MAAM;oBACvD,IAAI,CAAC,GAAG,CAAC,cAAc,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CACtD,CAAC;YACJ,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,QAAQ,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,KAAc,EAAE,CAAC,CAAC;YAC/C,CAAC;QACH,CAAC;QACD,KAAK,MAAM,EAAE,IAAI,QAAQ,EAAE,CAAC;YAC1B,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;gBAAE,SAAS;YACnE,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,MAAM,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC;gBACnD,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;gBAClB,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,KAAK,EAAE,aAAa,GAAG,CAAC,cAAc,cAAc,GAAG,CAAC,GAAG,OAAO,CACnE,CAAC;YACJ,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,QAAQ,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,KAAc,EAAE,CAAC,CAAC;YAC/C,CAAC;QACH,CAAC;IACH,CAAC;YAAS,CAAC;QACT,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC;IAED,IAAI,MAAM,CAAC,QAAQ,IAAI,QAAQ,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;QAC5C,yEAAyE;QACzE,4DAA4D;QAC5D,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,IAAI,QAAQ,CAAC;QAC1C,MAAM,MAAM,GAAG,MAAM,aAAa,CAChC,KAAK,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,EAC3C,MAAM,CAAC,SAAS,CACjB,CAAC;QACF,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,eAAe,MAAM,CAAC,IAAI,CAAC,MAAM,WAAW,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CACzE,CAAC;QACF,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC9B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,oBAAoB,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC3E,CAAC;IACH,CAAC;SAAM,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QAC3B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,iDAAiD,CAAC,CAAC;IAC1E,CAAC;IAED,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC3B,KAAK,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,QAAQ,EAAE,CAAC;YACrC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,OAAO,KAAK,CAAC,OAAO,MAAM,CAAC,CAAC;QACxD,CAAC;QACD,OAAO,CAAC,CAAC;IACX,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC"}

package/dist/cli/commands/review.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Check a recording against what it was supposed to be — without a model, and
+ * without a browser. Everything here is in the files the recording left
+ * behind, which is what makes it something CI can run.
+ */
+export declare function review(argv: string[]): Promise<number>;

package/dist/cli/commands/review.js

@@ -0,0 +1,89 @@
+import { parseArgs } from "node:util";
+import { existsSync, readFileSync } from "node:fs";
+import { join, resolve } from "node:path";
+import { loadConfig } from "../../loader.js";
+import { formatReview, reviewRecording } from "../../review/review.js";
+const USAGE = "Usage: versioncam review <id> [--beats <file>] [--min <s>] [--max <s>]\n";
+/** The beat sheet, checked as it is read: a bad one is an authoring mistake. */
+function readBeats(file) {
+    const parsed = JSON.parse(readFileSync(file, "utf8"));
+    if (!Array.isArray(parsed)) {
+        throw new Error(`${file} must be an array of { label, expect }.`);
+    }
+    return parsed.map((entry, index) => {
+        const beat = entry;
+        if (typeof beat?.label !== "string" || beat.label.length === 0) {
+            throw new Error(`${file}: beat ${index} has no \`label\`.`);
+        }
+        return { label: beat.label, expect: beat.expect };
+    });
+}
+function bound(value, flag) {
+    if (value === undefined)
+        return undefined;
+    const seconds = Number(value);
+    if (!Number.isFinite(seconds)) {
+        throw new Error(`--${flag} must be a number of seconds, got "${value}".`);
+    }
+    return seconds;
+}
+/**
+ * Check a recording against what it was supposed to be — without a model, and
+ * without a browser. Everything here is in the files the recording left
+ * behind, which is what makes it something CI can run.
+ */
+export async function review(argv) {
+    const { positionals, values } = parseArgs({
+        args: argv,
+        options: {
+            beats: { type: "string" },
+            min: { type: "string" },
+            max: { type: "string" },
+        },
+        strict: false,
+        allowPositionals: true,
+    });
+    const id = positionals[0];
+    if (!id) {
+        process.stderr.write(USAGE);
+        return 1;
+    }
+    const config = await loadConfig(process.cwd());
+    const dir = join(config.recordingsDir, id);
+    const timelineFile = join(dir, "timeline.json");
+    if (!existsSync(timelineFile)) {
+        process.stderr.write(`No recording for "${id}". Run \`versioncam record ${id}\` first.\n`);
+        return 1;
+    }
+    const recorded = JSON.parse(readFileSync(timelineFile, "utf8"));
+    const settlesFile = join(dir, "settles.json");
+    const settles = existsSync(settlesFile)
+        ? JSON.parse(readFileSync(settlesFile, "utf8"))
+        : [];
+    let beats = [];
+    if (typeof values.beats === "string") {
+        const file = resolve(process.cwd(), values.beats);
+        if (!existsSync(file)) {
+            process.stderr.write(`No beat sheet at ${file}.\n`);
+            return 1;
+        }
+        beats = readBeats(file);
+    }
+    const result = reviewRecording({
+        // A recording made before marks existed has none, and then the beat and
+        // progress clauses have nothing to work with — which they say.
+        timeline: { ...recorded, marks: recorded.marks ?? [] },
+        settles,
+        beats,
+        // The flags override the config, which overrides the default. A clip's
+        // right length is a house style, not a law: an app whose clips are one
+        // crisp interaction each says so in `review` and is not argued with.
+        bounds: {
+            minSeconds: bound(values.min, "min") ?? config.review.minSeconds,
+            maxSeconds: bound(values.max, "max") ?? config.review.maxSeconds,
+        },
+    });
+    process.stdout.write(`${formatReview(id, result)}\n`);
+    return result.pass ? 0 : 1;
+}
+//# sourceMappingURL=review.js.map

package/dist/cli/commands/review.js.map

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

package/dist/cli/commands/sheet.d.ts

@@ -0,0 +1 @@
+export declare function sheet(argv: string[]): Promise<number>;

package/dist/cli/commands/sheet.js

@@ -0,0 +1,48 @@
+import { parseArgs } from "node:util";
+import { existsSync } from "node:fs";
+import { join } from "node:path";
+import { launchBrowser } from "../../driver/launch.js";
+import { loadConfig } from "../../loader.js";
+import { contactSheet, readTimeline } from "../../render/render.js";
+import { markedFrames } from "../../render/sampling.js";
+export async function sheet(argv) {
+    const { positionals, values } = parseArgs({
+        args: argv,
+        options: { "at-marks": { type: "boolean", default: false } },
+        strict: false,
+        allowPositionals: true,
+    });
+    const id = positionals[0];
+    if (!id) {
+        process.stderr.write("Usage: versioncam sheet <id> [--at-marks]\n");
+        return 1;
+    }
+    const config = await loadConfig(process.cwd());
+    const dir = join(config.recordingsDir, id);
+    if (!existsSync(join(dir, "timeline.json"))) {
+        process.stderr.write(`No recording for "${id}".\n`);
+        return 1;
+    }
+    let frames;
+    if (values["at-marks"] === true) {
+        const timeline = await readTimeline(config, id);
+        // A recording made before marks existed has none, and then this is the
+        // first frame and the last one — which is honest: there are no beats to
+        // aim at, and saying so beats inventing eight.
+        frames = markedFrames(timeline.durationFrames, timeline.marks ?? [], undefined, config.motion.crossfadeFrames, timeline.cuts);
+    }
+    const browser = await launchBrowser();
+    try {
+        const file = await contactSheet(browser, config, { kind: "recording", id, dir }, { frames });
+        // The path first, on its own line: everything that calls this reads it.
+        process.stdout.write(`${file}\n`);
+        if (frames) {
+            process.stdout.write(`frames ${frames.join(" · ")}\n`);
+        }
+        return 0;
+    }
+    finally {
+        await browser.close();
+    }
+}
+//# sourceMappingURL=sheet.js.map

package/dist/cli/commands/sheet.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sheet.js","sourceRoot":"","sources":["../../../src/cli/commands/sheet.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACpE,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAExD,MAAM,CAAC,KAAK,UAAU,KAAK,CAAC,IAAc;IACxC,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;QACxC,IAAI,EAAE,IAAI;QACV,OAAO,EAAE,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE;QAC5D,MAAM,EAAE,KAAK;QACb,gBAAgB,EAAE,IAAI;KACvB,CAAC,CAAC;IACH,MAAM,EAAE,GAAG,WAAW,CAAC,CAAC,CAAuB,CAAC;IAChD,IAAI,CAAC,EAAE,EAAE,CAAC;QACR,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,6CAA6C,CAAC,CAAC;QACpE,OAAO,CAAC,CAAC;IACX,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IAC/C,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC;IAC3C,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,eAAe,CAAC,CAAC,EAAE,CAAC;QAC5C,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;QACpD,OAAO,CAAC,CAAC;IACX,CAAC;IAED,IAAI,MAA4B,CAAC;IACjC,IAAI,MAAM,CAAC,UAAU,CAAC,KAAK,IAAI,EAAE,CAAC;QAChC,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QAChD,uEAAuE;QACvE,wEAAwE;QACxE,+CAA+C;QAC/C,MAAM,GAAG,YAAY,CACnB,QAAQ,CAAC,cAAc,EACvB,QAAQ,CAAC,KAAK,IAAI,EAAE,EACpB,SAAS,EACT,MAAM,CAAC,MAAM,CAAC,eAAe,EAC7B,QAAQ,CAAC,IAAI,CACd,CAAC;IACJ,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,aAAa,EAAE,CAAC;IACtC,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,YAAY,CAC7B,OAAO,EACP,MAAM,EACN,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE,EAAE,GAAG,EAAE,EAC9B,EAAE,MAAM,EAAE,CACX,CAAC;QACF,wEAAwE;QACxE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,IAAI,CAAC,CAAC;QAClC,IAAI,MAAM,EAAE,CAAC;YACX,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACzD,CAAC;QACD,OAAO,CAAC,CAAC;IACX,CAAC;YAAS,CAAC;QACT,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC;AACH,CAAC"}

package/dist/cli/commands/stability.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Does this app record the same way twice?
+ *
+ * The README's rule — when a clip will not reproduce, record it twice the same
+ * way first — as a command, and as the first thing done in a repository before
+ * anything is authored for it. A clip is only as deterministic as the app it
+ * films: a page that renders the wall-clock time, or animates something the
+ * recorder's clock does not drive, gives a different video every run, and
+ * every clip written against it will fail CI for reasons nobody wrote.
+ *
+ * Draft by default, because the question is about the app and not the pixels:
+ * a draft is the same page at the same size, a quarter of the frames.
+ */
+export declare function stability(argv: string[]): Promise<number>;