deio-scroll 1.0.0

package/dist/capture/frameRecorder.js.map

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

package/dist/capture/stitchFrames.d.ts

@@ -0,0 +1,9 @@
+export interface StitchOptions {
+    width?: number;
+    height?: number;
+    preset?: string;
+    crf?: number;
+    signal?: AbortSignal;
+}
+export declare function stitchFramesToVideo(framesDir: string, outputPath: string, fps: number, options?: StitchOptions): Promise<void>;
+//# sourceMappingURL=stitchFrames.d.ts.map

package/dist/capture/stitchFrames.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stitchFrames.d.ts","sourceRoot":"","sources":["../../src/capture/stitchFrames.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,aAAa;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,wBAAsB,mBAAmB,CACvC,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,aAAa,GACtB,OAAO,CAAC,IAAI,CAAC,CAiEf"}

package/dist/capture/stitchFrames.js

@@ -0,0 +1,62 @@
+import { spawn } from "node:child_process";
+import path from "node:path";
+export async function stitchFramesToVideo(framesDir, outputPath, fps, options) {
+    const framePattern = path.join(framesDir, "frame-%06d.jpg");
+    const preset = options?.preset ?? "fast";
+    const crf = options?.crf ?? (preset === "fast" ? 26 : 18);
+    const args = [
+        "-y",
+        "-framerate",
+        String(fps),
+        "-i",
+        framePattern,
+        "-c:v",
+        "libx264",
+        "-pix_fmt",
+        "yuv420p",
+        "-preset",
+        preset,
+        "-crf",
+        String(crf),
+    ];
+    // Add scaling/padding filters to ensure width and height are divisible by 2 for libx264
+    const vfFilters = [];
+    if (options?.width && options?.height) {
+        const evenW = options.width % 2 === 0 ? options.width : options.width - 1;
+        const evenH = options.height % 2 === 0 ? options.height : options.height - 1;
+        vfFilters.push(`scale=${evenW}:${evenH}:flags=bicubic`);
+    }
+    else {
+        vfFilters.push("scale=trunc(iw/2)*2:trunc(ih/2)*2");
+    }
+    if (vfFilters.length > 0) {
+        args.push("-vf", vfFilters.join(","));
+    }
+    args.push(outputPath);
+    return new Promise((resolve, reject) => {
+        const proc = spawn("ffmpeg", args);
+        const abort = () => proc.kill("SIGTERM");
+        options?.signal?.addEventListener("abort", abort, { once: true });
+        let stderr = "";
+        proc.stderr?.on("data", (data) => {
+            stderr += data.toString();
+        });
+        proc.on("close", (code) => {
+            options?.signal?.removeEventListener("abort", abort);
+            if (options?.signal?.aborted) {
+                reject(options.signal.reason ?? new Error("Cancelled"));
+            }
+            else if (code === 0) {
+                resolve();
+            }
+            else {
+                const conciseStderr = stderr.trim().slice(-3000);
+                reject(new Error(`FFmpeg stitch failed with code ${code}: ${conciseStderr}`));
+            }
+        });
+        proc.on("error", (error) => {
+            reject(error);
+        });
+    });
+}
+//# sourceMappingURL=stitchFrames.js.map

package/dist/capture/stitchFrames.js.map

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

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+import "dotenv/config";
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,OAAO,eAAe,CAAC"}

package/dist/cli.js

@@ -0,0 +1,329 @@
+#!/usr/bin/env node
+import "dotenv/config";
+import { spawn, spawnSync } from "node:child_process";
+import fs from "node:fs";
+import fsPromises from "node:fs/promises";
+import path from "node:path";
+import { createRequire } from "node:module";
+import { RecordingJobManager } from "./jobs/manager.js";
+const packageRequire = createRequire(import.meta.url);
+const VERSION = packageRequire("../package.json").version;
+const DEFAULT_PORT = 3847;
+const CURVES = new Set([
+    "linear",
+    "ease-in",
+    "ease-out",
+    "ease-in-out",
+    "ease-in-cubic",
+    "ease-out-cubic",
+    "ease-in-out-cubic",
+]);
+async function main() {
+    const options = parseArgs(process.argv.slice(2));
+    if (options.command === "help")
+        return printHelp();
+    if (options.command === "version")
+        return console.log(VERSION);
+    if (options.command === "setup")
+        return setup();
+    if (options.command === "serve")
+        return serve(options);
+    return record(options);
+}
+function parseArgs(args) {
+    const options = {
+        command: "serve",
+        curve: "ease-in-out",
+        speed: 1,
+        quality: "medium",
+        viewport: { width: 1440, height: 900 },
+        outputDir: path.resolve("deio-output"),
+        port: DEFAULT_PORT,
+        host: "127.0.0.1",
+        open: true,
+    };
+    const first = args[0];
+    if (first === "--help" || first === "-h" || first === "help") {
+        options.command = "help";
+        return options;
+    }
+    if (first === "--version" || first === "-v" || first === "version") {
+        options.command = "version";
+        return options;
+    }
+    if (first === "setup") {
+        options.command = "setup";
+        return options;
+    }
+    let index = 0;
+    if (first === "serve") {
+        options.command = "serve";
+        index++;
+    }
+    else if (first === "record") {
+        options.command = "record";
+        index++;
+    }
+    else if (first && !first.startsWith("-")) {
+        options.command = "record";
+        options.target = first;
+        index++;
+    }
+    while (index < args.length) {
+        const arg = args[index++];
+        if (arg === "--no-open")
+            options.open = false;
+        else if (arg === "--open")
+            options.open = true;
+        else if (arg === "--curve")
+            options.curve = parseCurve(requiredValue(args, index++, arg));
+        else if (arg === "--speed")
+            options.speed = positiveNumber(requiredValue(args, index++, arg), "speed");
+        else if (arg === "--quality")
+            options.quality = parseQuality(requiredValue(args, index++, arg));
+        else if (arg === "--viewport")
+            options.viewport = parseViewport(requiredValue(args, index++, arg));
+        else if (arg === "--output")
+            options.outputDir = path.resolve(requiredValue(args, index++, arg));
+        else if (arg === "--port")
+            options.port = integer(requiredValue(args, index++, arg), "port", 1, 65_535);
+        else if (arg === "--host")
+            options.host = requiredValue(args, index++, arg);
+        else if (arg === "--help" || arg === "-h")
+            options.command = "help";
+        else if (!arg.startsWith("-") && options.command === "record" && !options.target)
+            options.target = arg;
+        // Friendly shorthand: `deio <url> linear speed-1`.
+        else if (CURVES.has(arg))
+            options.curve = parseCurve(arg);
+        else if (/^speed-/i.test(arg))
+            options.speed = positiveNumber(arg.slice(6), "speed");
+        else
+            throw new Error(`Unknown option: ${arg}. Run deio --help for usage.`);
+    }
+    if (options.command === "record" && options.target?.toLowerCase().endsWith(".json")) {
+        options.configPath = options.target;
+        options.target = undefined;
+    }
+    if (options.command === "record" && !options.target && !options.configPath) {
+        throw new Error("Missing website URL. Run deio --help for usage.");
+    }
+    return options;
+}
+async function serve(options) {
+    const localUrl = `http://${displayHost(options.host)}:${options.port}`;
+    if (await isRunningDeio(localUrl)) {
+        console.log(`Deio is already running at ${localUrl}`);
+        if (options.open)
+            openBrowser(localUrl);
+        return;
+    }
+    process.env.PORT = String(options.port);
+    process.env.HOST = options.host;
+    process.env.OUTPUT_DIR = options.outputDir;
+    console.log(`Starting Deio at ${localUrl}`);
+    if (options.open) {
+        void waitUntilReady(localUrl).then(() => openBrowser(localUrl));
+    }
+    await import("./api/server.js");
+}
+async function record(options) {
+    await assertRuntimeReady();
+    const request = options.configPath
+        ? JSON.parse(await fsPromises.readFile(path.resolve(options.configPath), "utf8"))
+        : buildRequest(options);
+    await fsPromises.mkdir(options.outputDir, { recursive: true });
+    const manager = new RecordingJobManager(options.outputDir);
+    await manager.initialize();
+    const shutdown = () => void manager.shutdown().finally(() => process.exit(130));
+    process.once("SIGINT", shutdown);
+    process.once("SIGTERM", shutdown);
+    try {
+        console.log(`Recording ${request.targetUrl}`);
+        console.log(`curve: ${request.animationConfig?.scrollCurve?.preset ?? "ease-in-out"} · speed: ${options.speed}x · quality: ${request.videoConfig.qualityPreset ?? "medium"}`);
+        const queued = await manager.create(request);
+        console.log(`job: ${queued.jobId}`);
+        const job = await manager.waitForCompletion(queued.jobId);
+        if (job.status !== "completed" || !job.result) {
+            throw new Error(job.error?.message ?? `Recording ${job.status}`);
+        }
+        console.log("Recording complete");
+        console.log(path.join(options.outputDir, job.jobId, "output.mp4"));
+    }
+    finally {
+        await manager.shutdown();
+    }
+}
+function buildRequest(options) {
+    return {
+        targetUrl: normalizeUrl(options.target),
+        exportFormat: "mp4",
+        videoConfig: {
+            framerate: options.quality === "low" ? 30 : 60,
+            qualityPreset: options.quality,
+            viewport: {
+                ...options.viewport,
+                deviceScaleFactor: options.quality === "high" ? 2 : 1,
+            },
+        },
+        animationConfig: {
+            pixelsPerFrame: 16 * options.speed,
+            preRecordingDelayMs: options.quality === "low" ? 500 : 2_000,
+            removeOverlayElements: true,
+            heroHoldMs: 1_500,
+            scrollCurve: { preset: options.curve },
+            scrollMode: "auto",
+            fastMode: options.quality === "low",
+            captureMode: options.quality === "low" ? "preview" : "export",
+        },
+        backgroundPreset: "none",
+        addShadow: false,
+        roundedCorners: false,
+    };
+}
+async function setup() {
+    console.log("Installing Playwright Chromium…");
+    const packageJson = packageRequire.resolve("playwright/package.json");
+    const cli = path.join(path.dirname(packageJson), "cli.js");
+    const result = spawnSync(process.execPath, [cli, "install", "chromium"], { stdio: "inherit" });
+    if (result.status !== 0)
+        throw new Error("Chromium installation failed.");
+    if (hasFfmpeg()) {
+        console.log("ffmpeg: found");
+    }
+    else {
+        console.warn("ffmpeg was not found on PATH. Install it with your system package manager:");
+        console.warn("  Ubuntu/Debian: sudo apt install ffmpeg");
+        console.warn("  macOS:         brew install ffmpeg");
+        console.warn("  Windows:       winget install Gyan.FFmpeg");
+    }
+    console.log("Deio setup complete.");
+}
+async function assertRuntimeReady() {
+    if (!hasFfmpeg())
+        throw new Error("ffmpeg was not found on PATH. Install ffmpeg, then run `npx deio-scroll setup`.");
+    const { chromium } = await import("playwright");
+    if (!fs.existsSync(chromium.executablePath())) {
+        throw new Error("Playwright Chromium is not installed. Run `npx deio-scroll setup` first.");
+    }
+}
+function hasFfmpeg() {
+    return spawnSync("ffmpeg", ["-version"], { stdio: "ignore" }).status === 0;
+}
+function openBrowser(url) {
+    let command;
+    let args;
+    if (process.platform === "darwin")
+        [command, args] = ["open", [url]];
+    else if (process.platform === "win32")
+        [command, args] = ["cmd", ["/c", "start", "", url]];
+    else
+        [command, args] = ["xdg-open", [url]];
+    const child = spawn(command, args, { detached: true, stdio: "ignore" });
+    child.on("error", () => console.log(`Open ${url} in your browser.`));
+    child.unref();
+}
+async function waitUntilReady(url) {
+    for (let attempt = 0; attempt < 50; attempt++) {
+        if (await isRunningDeio(url))
+            return;
+        await new Promise((resolve) => setTimeout(resolve, 100));
+    }
+    console.log(`Open ${url} in your browser.`);
+}
+async function isRunningDeio(url) {
+    try {
+        const response = await fetch(`${url}/health`, { signal: AbortSignal.timeout(400) });
+        const body = await response.json();
+        return response.ok && body.ok === true;
+    }
+    catch {
+        return false;
+    }
+}
+function normalizeUrl(value) {
+    const candidate = /^[a-z][a-z\d+.-]*:\/\//i.test(value) ? value : `https://${value}`;
+    try {
+        return new URL(candidate).toString();
+    }
+    catch {
+        throw new Error(`Invalid website URL: ${value}`);
+    }
+}
+function parseCurve(value) {
+    if (!CURVES.has(value)) {
+        throw new Error(`Invalid curve: ${value}. Choose ${[...CURVES].join(", ")}.`);
+    }
+    return value;
+}
+function parseQuality(value) {
+    if (value !== "high" && value !== "medium" && value !== "low") {
+        throw new Error("Quality must be high, medium, or low.");
+    }
+    return value;
+}
+function parseViewport(value) {
+    const match = value.match(/^(\d+)x(\d+)$/i);
+    if (!match)
+        throw new Error("Viewport must look like 1440x900.");
+    return {
+        width: integer(match[1], "viewport width", 320, 7680),
+        height: integer(match[2], "viewport height", 240, 4320),
+    };
+}
+function positiveNumber(value, name) {
+    const number = Number(value);
+    if (!Number.isFinite(number) || number <= 0)
+        throw new Error(`${name} must be greater than zero.`);
+    return number;
+}
+function integer(value, name, min, max) {
+    const number = Number(value);
+    if (!Number.isInteger(number) || number < min || number > max) {
+        throw new Error(`${name} must be an integer from ${min} to ${max}.`);
+    }
+    return number;
+}
+function requiredValue(args, index, option) {
+    const value = args[index];
+    if (!value || value.startsWith("--"))
+        throw new Error(`${option} requires a value.`);
+    return value;
+}
+function displayHost(host) {
+    return host === "0.0.0.0" ? "127.0.0.1" : host;
+}
+function printHelp() {
+    console.log(`Deio — smooth-scroll website recordings
+
+Usage:
+  deio                                      Open the local web app
+  deio serve [options]                      Open the local web app
+  deio <website> [options]                  Record a website
+  deio record <website|config.json> [options]
+  deio setup                                Install Chromium and check ffmpeg
+
+Recording options:
+  --curve <preset>       linear, ease-in, ease-out, ease-in-out, or cubic variants
+  --speed <multiplier>   Scroll speed multiplier (default: 1)
+  --quality <preset>     low, medium, or high (default: medium)
+  --viewport <WxH>       Browser viewport (default: 1440x900)
+  --output <directory>   Output root (default: ./deio-output)
+
+Server options:
+  --port <number>        Local port (default: 3847)
+  --host <address>       Bind address (default: 127.0.0.1)
+  --no-open              Do not open a browser
+
+Examples:
+  npx deio-scroll
+  npx deio-scroll example.com --curve linear --speed 1
+  npx deio-scroll record https://example.com --quality high --viewport 1920x1080
+
+The shorthand \`deio example.com linear speed-1\` is also accepted.`);
+}
+main().catch((error) => {
+    console.error(`deio: ${error instanceof Error ? error.message : error}`);
+    process.exitCode = 1;
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/config/browserLaunch.d.ts

@@ -0,0 +1,13 @@
+import type { AnimationConfig } from "../types.js";
+export interface BrowserLaunchOptions {
+    headless: boolean;
+    args: string[];
+}
+/**
+ * WebGL scroll-scrubbing sites run their render loop at only a few fps in
+ * headless Chromium. Use a headed browser with real GPU for virtual-scroll.
+ */
+export declare function resolveBrowserLaunch(animation: AnimationConfig): BrowserLaunchOptions;
+export declare function launchArgsForHeadless(headless: boolean): string[];
+export declare function shouldWarnHeadlessVirtualCapture(scrollStrategy: "document" | "virtual", captureHeadless: boolean): string | null;
+//# sourceMappingURL=browserLaunch.d.ts.map

package/dist/config/browserLaunch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browserLaunch.d.ts","sourceRoot":"","sources":["../../src/config/browserLaunch.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,OAAO,CAAC;IAClB,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AA4BD;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,eAAe,GACzB,oBAAoB,CA4BtB;AAED,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,OAAO,GAAG,MAAM,EAAE,CAEjE;AAED,wBAAgB,gCAAgC,CAC9C,cAAc,EAAE,UAAU,GAAG,SAAS,EACtC,eAAe,EAAE,OAAO,GACvB,MAAM,GAAG,IAAI,CAQf"}

package/dist/config/browserLaunch.js

@@ -0,0 +1,63 @@
+import fs from "node:fs";
+const SHARED_ARGS = [
+    "--disable-background-timer-throttling",
+    "--disable-backgrounding-occluded-windows",
+    "--disable-renderer-backgrounding",
+];
+/** Software WebGL — fine for headless document pages, too slow for headed WebGL captures. */
+const HEADLESS_ARGS = [
+    ...SHARED_ARGS,
+    "--enable-gpu",
+    "--use-angle=swiftshader-webgl",
+    "--enable-unsafe-swiftshader",
+];
+/** Real GPU — required for smooth WebGL scroll-scrubbing captures. */
+const HEADED_ARGS = [
+    ...SHARED_ARGS,
+    "--enable-gpu",
+    // Push the window completely off-screen so it doesn't appear to the user.
+    // --window-size must NOT be set here — Playwright controls the viewport
+    // via context options and any OS-level size constraint causes a mismatch
+    // that glitches the capture and can hang the browser on close.
+    "--window-position=-20000,-20000",
+    "--start-minimized",
+];
+/**
+ * WebGL scroll-scrubbing sites run their render loop at only a few fps in
+ * headless Chromium. Use a headed browser with real GPU for virtual-scroll.
+ */
+export function resolveBrowserLaunch(animation) {
+    // If running on a desktop environment but DISPLAY env variable is not inherited
+    // (e.g. VS Code / IDE background server process), auto-detect and restore it.
+    if (!process.env.DISPLAY && fs.existsSync("/tmp/.X11-unix/X0")) {
+        process.env.DISPLAY = ":0";
+    }
+    if (process.env.RECORD_HEADED === "1") {
+        return { headless: false, args: [...HEADED_ARGS] };
+    }
+    if (process.env.RECORD_HEADED === "0") {
+        return { headless: true, args: [...HEADLESS_ARGS] };
+    }
+    const scrollMode = animation.scrollMode ?? "auto";
+    if (scrollMode === "document") {
+        return { headless: true, args: [...HEADLESS_ARGS] };
+    }
+    if (scrollMode === "virtual") {
+        return { headless: false, args: [...HEADED_ARGS] };
+    }
+    return {
+        headless: !process.env.DISPLAY,
+        args: process.env.DISPLAY ? [...HEADED_ARGS] : [...HEADLESS_ARGS],
+    };
+}
+export function launchArgsForHeadless(headless) {
+    return headless ? [...HEADLESS_ARGS] : [...HEADED_ARGS];
+}
+export function shouldWarnHeadlessVirtualCapture(scrollStrategy, captureHeadless) {
+    if (scrollStrategy === "virtual" && captureHeadless) {
+        return ("Virtual scroll was captured headless; WebGL sites may look choppy. " +
+            "Set scrollMode to virtual, use a display (DISPLAY), or set RECORD_HEADED=1.");
+    }
+    return null;
+}
+//# sourceMappingURL=browserLaunch.js.map

package/dist/config/browserLaunch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browserLaunch.js","sourceRoot":"","sources":["../../src/config/browserLaunch.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AAQzB,MAAM,WAAW,GAAG;IAClB,uCAAuC;IACvC,0CAA0C;IAC1C,kCAAkC;CAC1B,CAAC;AAEX,6FAA6F;AAC7F,MAAM,aAAa,GAAG;IACpB,GAAG,WAAW;IACd,cAAc;IACd,+BAA+B;IAC/B,6BAA6B;CACrB,CAAC;AAEX,sEAAsE;AACtE,MAAM,WAAW,GAAG;IAClB,GAAG,WAAW;IACd,cAAc;IACd,0EAA0E;IAC1E,wEAAwE;IACxE,yEAAyE;IACzE,+DAA+D;IAC/D,iCAAiC;IACjC,mBAAmB;CACX,CAAC;AAEX;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAClC,SAA0B;IAE1B,gFAAgF;IAChF,8EAA8E;IAC9E,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC,UAAU,CAAC,mBAAmB,CAAC,EAAE,CAAC;QAC/D,OAAO,CAAC,GAAG,CAAC,OAAO,GAAG,IAAI,CAAC;IAC7B,CAAC;IACD,IAAI,OAAO,CAAC,GAAG,CAAC,aAAa,KAAK,GAAG,EAAE,CAAC;QACtC,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,GAAG,WAAW,CAAC,EAAE,CAAC;IACrD,CAAC;IAED,IAAI,OAAO,CAAC,GAAG,CAAC,aAAa,KAAK,GAAG,EAAE,CAAC;QACtC,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,GAAG,aAAa,CAAC,EAAE,CAAC;IACtD,CAAC;IAED,MAAM,UAAU,GAAG,SAAS,CAAC,UAAU,IAAI,MAAM,CAAC;IAElD,IAAI,UAAU,KAAK,UAAU,EAAE,CAAC;QAC9B,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,GAAG,aAAa,CAAC,EAAE,CAAC;IACtD,CAAC;IAED,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;QAC7B,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,GAAG,WAAW,CAAC,EAAE,CAAC;IACrD,CAAC;IAED,OAAO;QACL,QAAQ,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO;QAC9B,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC;KAClE,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,QAAiB;IACrD,OAAO,QAAQ,CAAC,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC,CAAC;AAC1D,CAAC;AAED,MAAM,UAAU,gCAAgC,CAC9C,cAAsC,EACtC,eAAwB;IAExB,IAAI,cAAc,KAAK,SAAS,IAAI,eAAe,EAAE,CAAC;QACpD,OAAO,CACL,qEAAqE;YACrE,6EAA6E,CAC9E,CAAC;IACJ,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/config/recordingProfile.d.ts

@@ -0,0 +1,10 @@
+import type { RecordRequest } from "../types.js";
+import { type EncodeSettings } from "../transcode/quality.js";
+export interface RecordingProfile {
+    pixelsPerFrame: number;
+    preRecordingDelayMs: number;
+    encode: EncodeSettings;
+    hydrateFast: boolean;
+}
+export declare function resolveRecordingProfile(request: RecordRequest): RecordingProfile;
+//# sourceMappingURL=recordingProfile.d.ts.map

package/dist/config/recordingProfile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recordingProfile.d.ts","sourceRoot":"","sources":["../../src/config/recordingProfile.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAEL,KAAK,cAAc,EACpB,MAAM,yBAAyB,CAAC;AAEjC,MAAM,WAAW,gBAAgB;IAC/B,cAAc,EAAE,MAAM,CAAC;IACvB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,MAAM,EAAE,cAAc,CAAC;IACvB,WAAW,EAAE,OAAO,CAAC;CACtB;AAQD,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,aAAa,GACrB,gBAAgB,CAsBlB"}

package/dist/config/recordingProfile.js

@@ -0,0 +1,25 @@
+import { resolveEncodeSettings, } from "../transcode/quality.js";
+const FAST_ENCODE = {
+    crf: 22,
+    preset: "fast",
+    deviceScaleFactor: 1,
+};
+export function resolveRecordingProfile(request) {
+    const animation = request.animationConfig ?? {};
+    const fastMode = animation.fastMode ?? false;
+    if (fastMode) {
+        return {
+            pixelsPerFrame: animation.pixelsPerFrame ?? 12,
+            preRecordingDelayMs: animation.preRecordingDelayMs ?? 500,
+            encode: FAST_ENCODE,
+            hydrateFast: true,
+        };
+    }
+    return {
+        pixelsPerFrame: animation.pixelsPerFrame ?? 4,
+        preRecordingDelayMs: animation.preRecordingDelayMs ?? 2000,
+        encode: resolveEncodeSettings(request.videoConfig.qualityPreset, request.videoConfig.viewport.deviceScaleFactor),
+        hydrateFast: false,
+    };
+}
+//# sourceMappingURL=recordingProfile.js.map

package/dist/config/recordingProfile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recordingProfile.js","sourceRoot":"","sources":["../../src/config/recordingProfile.ts"],"names":[],"mappings":"AACA,OAAO,EACL,qBAAqB,GAEtB,MAAM,yBAAyB,CAAC;AASjC,MAAM,WAAW,GAAmB;IAClC,GAAG,EAAE,EAAE;IACP,MAAM,EAAE,MAAM;IACd,iBAAiB,EAAE,CAAC;CACrB,CAAC;AAEF,MAAM,UAAU,uBAAuB,CACrC,OAAsB;IAEtB,MAAM,SAAS,GAAG,OAAO,CAAC,eAAe,IAAI,EAAE,CAAC;IAChD,MAAM,QAAQ,GAAG,SAAS,CAAC,QAAQ,IAAI,KAAK,CAAC;IAE7C,IAAI,QAAQ,EAAE,CAAC;QACb,OAAO;YACL,cAAc,EAAE,SAAS,CAAC,cAAc,IAAI,EAAE;YAC9C,mBAAmB,EAAE,SAAS,CAAC,mBAAmB,IAAI,GAAG;YACzD,MAAM,EAAE,WAAW;YACnB,WAAW,EAAE,IAAI;SAClB,CAAC;IACJ,CAAC;IAED,OAAO;QACL,cAAc,EAAE,SAAS,CAAC,cAAc,IAAI,CAAC;QAC7C,mBAAmB,EAAE,SAAS,CAAC,mBAAmB,IAAI,IAAI;QAC1D,MAAM,EAAE,qBAAqB,CAC3B,OAAO,CAAC,WAAW,CAAC,aAAa,EACjC,OAAO,CAAC,WAAW,CAAC,QAAQ,CAAC,iBAAiB,CAC/C;QACD,WAAW,EAAE,KAAK;KACnB,CAAC;AACJ,CAAC"}

package/dist/config/runtimeMode.d.ts

@@ -0,0 +1,2 @@
+export declare function embeddedWorkerEnabled(environment?: NodeJS.ProcessEnv): boolean;
+//# sourceMappingURL=runtimeMode.d.ts.map

package/dist/config/runtimeMode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtimeMode.d.ts","sourceRoot":"","sources":["../../src/config/runtimeMode.ts"],"names":[],"mappings":"AAAA,wBAAgB,qBAAqB,CACnC,WAAW,GAAE,MAAM,CAAC,UAAwB,WAG7C"}

package/dist/config/runtimeMode.js

@@ -0,0 +1,4 @@
+export function embeddedWorkerEnabled(environment = process.env) {
+    return environment.EMBEDDED_WORKER !== "0";
+}
+//# sourceMappingURL=runtimeMode.js.map

package/dist/config/runtimeMode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtimeMode.js","sourceRoot":"","sources":["../../src/config/runtimeMode.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,qBAAqB,CACnC,cAAiC,OAAO,CAAC,GAAG;IAE5C,OAAO,WAAW,CAAC,eAAe,KAAK,GAAG,CAAC;AAC7C,CAAC"}

package/dist/config/virtualScroll.d.ts

@@ -0,0 +1,8 @@
+import type { AnimationConfig } from "../types.js";
+export interface VirtualScrollSettings {
+    durationMs: number;
+    wheelBudget: number;
+    cycles: number;
+}
+export declare function resolveVirtualScrollSettings(animation: AnimationConfig, viewportHeight: number, _pixelsPerFrame: number, fastMode: boolean): VirtualScrollSettings;
+//# sourceMappingURL=virtualScroll.d.ts.map

package/dist/config/virtualScroll.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"virtualScroll.d.ts","sourceRoot":"","sources":["../../src/config/virtualScroll.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;CAChB;AAMD,wBAAgB,4BAA4B,CAC1C,SAAS,EAAE,eAAe,EAC1B,cAAc,EAAE,MAAM,EACtB,eAAe,EAAE,MAAM,EACvB,QAAQ,EAAE,OAAO,GAChB,qBAAqB,CAiBvB"}

package/dist/config/virtualScroll.js

@@ -0,0 +1,19 @@
+/** Wall-clock seconds per viewport cycle for virtual scroll (not document pixelsPerFrame). */
+const SECONDS_PER_CYCLE_NORMAL = 1.25;
+const SECONDS_PER_CYCLE_FAST = 0.75;
+export function resolveVirtualScrollSettings(animation, viewportHeight, _pixelsPerFrame, fastMode) {
+    const cycles = animation.virtualScrollCycles ?? (fastMode ? 6 : 8);
+    const wheelBudget = cycles * viewportHeight;
+    const secondsPerCycle = fastMode
+        ? SECONDS_PER_CYCLE_FAST
+        : SECONDS_PER_CYCLE_NORMAL;
+    const durationMs = animation.durationMs ??
+        animation.virtualScrollDurationMs ??
+        Math.round(cycles * secondsPerCycle * 1000);
+    return {
+        cycles,
+        wheelBudget,
+        durationMs,
+    };
+}
+//# sourceMappingURL=virtualScroll.js.map

package/dist/config/virtualScroll.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"virtualScroll.js","sourceRoot":"","sources":["../../src/config/virtualScroll.ts"],"names":[],"mappings":"AAQA,8FAA8F;AAC9F,MAAM,wBAAwB,GAAG,IAAI,CAAC;AACtC,MAAM,sBAAsB,GAAG,IAAI,CAAC;AAEpC,MAAM,UAAU,4BAA4B,CAC1C,SAA0B,EAC1B,cAAsB,EACtB,eAAuB,EACvB,QAAiB;IAEjB,MAAM,MAAM,GAAG,SAAS,CAAC,mBAAmB,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACnE,MAAM,WAAW,GAAG,MAAM,GAAG,cAAc,CAAC;IAC5C,MAAM,eAAe,GAAG,QAAQ;QAC9B,CAAC,CAAC,sBAAsB;QACxB,CAAC,CAAC,wBAAwB,CAAC;IAE7B,MAAM,UAAU,GACd,SAAS,CAAC,UAAU;QACpB,SAAS,CAAC,uBAAuB;QACjC,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,eAAe,GAAG,IAAI,CAAC,CAAC;IAE9C,OAAO;QACL,MAAM;QACN,WAAW;QACX,UAAU;KACX,CAAC;AACJ,CAAC"}