@carlesandres/webreel-core 0.2.0

package/dist/media.js.map

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

package/dist/overlays.d.ts

@@ -0,0 +1,21 @@
+import type { CDPClient } from "./types.js";
+export interface OverlayTheme {
+    cursorSvg?: string;
+    cursorSize?: number;
+    cursorHotspot?: "top-left" | "center";
+    hud?: {
+        background?: string;
+        color?: string;
+        fontSize?: number;
+        fontFamily?: string;
+        borderRadius?: number;
+        position?: "top" | "bottom";
+    };
+}
+export declare function injectOverlays(client: CDPClient, theme?: OverlayTheme, initialPosition?: {
+    x: number;
+    y: number;
+}): Promise<void>;
+export declare function showKeys(client: CDPClient, labels: string[]): Promise<void>;
+export declare function hideKeys(client: CDPClient): Promise<void>;
+//# sourceMappingURL=overlays.d.ts.map

package/dist/overlays.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"overlays.d.ts","sourceRoot":"","sources":["../src/overlays.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAQ5C,MAAM,WAAW,YAAY;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,UAAU,GAAG,QAAQ,CAAC;IACtC,GAAG,CAAC,EAAE;QACJ,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,EAAE,KAAK,GAAG,QAAQ,CAAC;KAC7B,CAAC;CACH;AAED,wBAAsB,cAAc,CAClC,MAAM,EAAE,SAAS,EACjB,KAAK,CAAC,EAAE,YAAY,EACpB,eAAe,CAAC,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,GACzC,OAAO,CAAC,IAAI,CAAC,CAwEf;AAED,wBAAsB,QAAQ,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAcjF;AAED,wBAAsB,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAO/D"}

package/dist/overlays.js

@@ -0,0 +1,97 @@
+import { DEFAULT_CURSOR_SVG, OFFSCREEN_MARGIN, DEFAULT_CURSOR_SIZE, DEFAULT_HUD_THEME, } from "./types.js";
+export async function injectOverlays(client, theme, initialPosition) {
+    const cursorSize = theme?.cursorSize ?? DEFAULT_CURSOR_SIZE;
+    const cursorSvg = theme?.cursorSvg ?? DEFAULT_CURSOR_SVG;
+    const hotspotOffset = theme?.cursorHotspot === "center" ? cursorSize / 2 : 0;
+    const hudBg = theme?.hud?.background ?? DEFAULT_HUD_THEME.background;
+    const hudColor = theme?.hud?.color ?? DEFAULT_HUD_THEME.color;
+    const hudFontSize = theme?.hud?.fontSize ?? DEFAULT_HUD_THEME.fontSize;
+    const hudFontFamily = theme?.hud?.fontFamily ?? DEFAULT_HUD_THEME.fontFamily;
+    const hudBorderRadius = theme?.hud?.borderRadius ?? DEFAULT_HUD_THEME.borderRadius;
+    const hudPosition = theme?.hud?.position ?? DEFAULT_HUD_THEME.position;
+    await client.Runtime.evaluate({
+        expression: `(() => {
+      const zoom = parseFloat(getComputedStyle(document.documentElement).zoom) || 1;
+
+      const cursor = document.createElement("div");
+      cursor.id = "__demo-cursor";
+      cursor.style.cssText = [
+        "position:fixed",
+        "left:0",
+        "top:0",
+        "z-index:999999",
+        "pointer-events:none",
+        "width:${cursorSize}px",
+        "height:${cursorSize}px",
+        "margin-left:${-hotspotOffset}px",
+        "margin-top:${-hotspotOffset}px",
+        "transform-origin:top left",
+        "will-change:transform",
+        "transform:translate(${initialPosition?.x ?? -OFFSCREEN_MARGIN}px,${initialPosition?.y ?? -OFFSCREEN_MARGIN}px)",
+        "filter:drop-shadow(0 1px 2px rgba(0,0,0,0.5))",
+      ].join(";");
+      cursor.dataset.cx = "${initialPosition?.x ?? -OFFSCREEN_MARGIN}";
+      cursor.dataset.cy = "${initialPosition?.y ?? -OFFSCREEN_MARGIN}";
+      cursor.innerHTML = ${JSON.stringify(cursorSvg)};
+      document.body.appendChild(cursor);
+
+      const z = (v) => (v / zoom) + "px";
+      const keys = document.createElement("div");
+      keys.id = "__demo-keys";
+      keys.style.cssText = [
+        "position:fixed",
+        "z-index:999999",
+        "pointer-events:none",
+        "${hudPosition}:" + z(48),
+        "left:50%",
+        "transform:translateX(-50%)",
+        "display:flex",
+        "gap:" + z(14),
+        "padding:" + z(16) + " " + z(36),
+        "border-radius:" + z(${hudBorderRadius}),
+        "background:${hudBg}",
+        "opacity:0",
+      ].join(";");
+      document.body.appendChild(keys);
+
+      const style = document.createElement("style");
+      style.textContent = \`
+        .__demo-key {
+          display: inline-flex;
+          align-items: center;
+          justify-content: center;
+          color: ${hudColor};
+          font-family: ${hudFontFamily};
+          font-size: \${${hudFontSize} / zoom}px;
+          font-weight: 500;
+          white-space: nowrap;
+        }
+      \`;
+      document.head.appendChild(style);
+    })()`,
+    });
+}
+export async function showKeys(client, labels) {
+    await client.Runtime.evaluate({
+        expression: `(() => {
+      const container = document.getElementById("__demo-keys");
+      if (!container) return;
+      container.innerHTML = ${JSON.stringify(labels)}
+        .map(k => {
+          const e = k.replace(/&/g,"&amp;").replace(/</g,"&lt;").replace(/>/g,"&gt;");
+          return '<span class="__demo-key">' + e + '</span>';
+        })
+        .join("");
+      container.style.opacity = "1";
+    })()`,
+    });
+}
+export async function hideKeys(client) {
+    await client.Runtime.evaluate({
+        expression: `(() => {
+      const container = document.getElementById("__demo-keys");
+      if (container) container.style.opacity = "0";
+    })()`,
+    });
+}
+//# sourceMappingURL=overlays.js.map

package/dist/overlays.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"overlays.js","sourceRoot":"","sources":["../src/overlays.ts"],"names":[],"mappings":"AACA,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,YAAY,CAAC;AAgBpB,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,MAAiB,EACjB,KAAoB,EACpB,eAA0C;IAE1C,MAAM,UAAU,GAAG,KAAK,EAAE,UAAU,IAAI,mBAAmB,CAAC;IAC5D,MAAM,SAAS,GAAG,KAAK,EAAE,SAAS,IAAI,kBAAkB,CAAC;IACzD,MAAM,aAAa,GAAG,KAAK,EAAE,aAAa,KAAK,QAAQ,CAAC,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7E,MAAM,KAAK,GAAG,KAAK,EAAE,GAAG,EAAE,UAAU,IAAI,iBAAiB,CAAC,UAAU,CAAC;IACrE,MAAM,QAAQ,GAAG,KAAK,EAAE,GAAG,EAAE,KAAK,IAAI,iBAAiB,CAAC,KAAK,CAAC;IAC9D,MAAM,WAAW,GAAG,KAAK,EAAE,GAAG,EAAE,QAAQ,IAAI,iBAAiB,CAAC,QAAQ,CAAC;IACvE,MAAM,aAAa,GAAG,KAAK,EAAE,GAAG,EAAE,UAAU,IAAI,iBAAiB,CAAC,UAAU,CAAC;IAC7E,MAAM,eAAe,GAAG,KAAK,EAAE,GAAG,EAAE,YAAY,IAAI,iBAAiB,CAAC,YAAY,CAAC;IACnF,MAAM,WAAW,GAAG,KAAK,EAAE,GAAG,EAAE,QAAQ,IAAI,iBAAiB,CAAC,QAAQ,CAAC;IAEvE,MAAM,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC;QAC5B,UAAU,EAAE;;;;;;;;;;;iBAWC,UAAU;kBACT,UAAU;uBACL,CAAC,aAAa;sBACf,CAAC,aAAa;;;+BAGL,eAAe,EAAE,CAAC,IAAI,CAAC,gBAAgB,MAAM,eAAe,EAAE,CAAC,IAAI,CAAC,gBAAgB;;;6BAGtF,eAAe,EAAE,CAAC,IAAI,CAAC,gBAAgB;6BACvC,eAAe,EAAE,CAAC,IAAI,CAAC,gBAAgB;2BACzC,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC;;;;;;;;;;WAUzC,WAAW;;;;;;+BAMS,eAAe;sBACxB,KAAK;;;;;;;;;;;mBAWR,QAAQ;yBACF,aAAa;0BACZ,WAAW;;;;;;SAM5B;KACN,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,MAAiB,EAAE,MAAgB;IAChE,MAAM,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC;QAC5B,UAAU,EAAE;;;8BAGc,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC;;;;;;;SAO3C;KACN,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,MAAiB;IAC9C,MAAM,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC;QAC5B,UAAU,EAAE;;;SAGP;KACN,CAAC,CAAC;AACL,CAAC"}

package/dist/recorder.d.ts

@@ -0,0 +1,60 @@
+import type { CDPClient, CaptureFormat } from "./types.js";
+import type { RecordingContext } from "./actions.js";
+import { type SfxConfig } from "./media.js";
+import type { InteractionTimeline, TimelineData } from "./timeline.js";
+export declare function getFfmpegInputCodec(format: CaptureFormat): "mjpeg" | "png";
+export declare function getFrameExtension(format: CaptureFormat): ".jpg" | ".png";
+export declare function getCaptureScreenshotParams(format: CaptureFormat): {
+    format: CaptureFormat;
+    quality?: number;
+    optimizeForSpeed: true;
+};
+export interface RecorderOptions {
+    sfx?: SfxConfig;
+    fps?: number;
+    crf?: number;
+    framesDir?: string;
+    captureFormat?: CaptureFormat;
+}
+export declare function buildFfmpegRecorderArgs(options: {
+    fps: number;
+    crf: number;
+    captureFormat: CaptureFormat;
+    outputPath: string;
+}): string[];
+export declare class Recorder {
+    private outputPath;
+    private frameCount;
+    private running;
+    private capturePromise;
+    private events;
+    private outputWidth;
+    private outputHeight;
+    private sfx;
+    private fps;
+    private frameMs;
+    private crf;
+    private ffmpegPath;
+    private ffmpegProcess;
+    private tempVideo;
+    private drainResolve;
+    private droppedFrames;
+    private timeline;
+    private ctx;
+    private framesDir;
+    private stopResolve;
+    private stoppedPromise;
+    private captureFormat;
+    constructor(outputWidth?: number, outputHeight?: number, options?: RecorderOptions);
+    setTimeline(timeline: InteractionTimeline): void;
+    getTimeline(): InteractionTimeline | null;
+    getTimelineData(): TimelineData | null;
+    addEvent(type: "click" | "key"): void;
+    start(client: CDPClient, outputPath: string, ctx?: RecordingContext): Promise<void>;
+    private writeFrame;
+    private raceStop;
+    private captureLoop;
+    getTempVideoPath(): string;
+    stop(): Promise<void>;
+}
+//# sourceMappingURL=recorder.d.ts.map

package/dist/recorder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recorder.d.ts","sourceRoot":"","sources":["../src/recorder.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,SAAS,EAAc,aAAa,EAAE,MAAM,YAAY,CAAC;AACvE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAErD,OAAO,EAA0C,KAAK,SAAS,EAAE,MAAM,YAAY,CAAC;AACpF,OAAO,KAAK,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAEvE,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,GAAG,KAAK,CAE1E;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,GAAG,MAAM,CAExE;AAED,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,aAAa,GAAG;IACjE,MAAM,EAAE,aAAa,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gBAAgB,EAAE,IAAI,CAAC;CACxB,CAKA;AAED,MAAM,WAAW,eAAe;IAC9B,GAAG,CAAC,EAAE,SAAS,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,aAAa,CAAC;CAC/B;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE;IAC/C,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,aAAa,EAAE,aAAa,CAAC;IAC7B,UAAU,EAAE,MAAM,CAAC;CACpB,GAAG,MAAM,EAAE,CA+BX;AAED,qBAAa,QAAQ;IACnB,OAAO,CAAC,UAAU,CAAM;IACxB,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,cAAc,CAA8B;IACpD,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,GAAG,CAAwB;IACnC,OAAO,CAAC,GAAG,CAAS;IACpB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,GAAG,CAAS;IACpB,OAAO,CAAC,UAAU,CAAY;IAC9B,OAAO,CAAC,aAAa,CAA6B;IAClD,OAAO,CAAC,SAAS,CAAM;IACvB,OAAO,CAAC,YAAY,CAA6B;IACjD,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,QAAQ,CAAoC;IACpD,OAAO,CAAC,GAAG,CAAiC;IAC5C,OAAO,CAAC,SAAS,CAAuB;IACxC,OAAO,CAAC,WAAW,CAA6B;IAChD,OAAO,CAAC,cAAc,CAA8B;IACpD,OAAO,CAAC,aAAa,CAAgB;gBAGnC,WAAW,SAAwB,EACnC,YAAY,SAAwB,EACpC,OAAO,CAAC,EAAE,eAAe;IAe3B,WAAW,CAAC,QAAQ,EAAE,mBAAmB,GAAG,IAAI;IAIhD,WAAW,IAAI,mBAAmB,GAAG,IAAI;IAIzC,eAAe,IAAI,YAAY,GAAG,IAAI;IAItC,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,KAAK;IAOxB,KAAK,CAAC,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,gBAAgB;YA6C3D,UAAU;YAeV,QAAQ;YAMR,WAAW;IAgEzB,gBAAgB,IAAI,MAAM;IAIpB,IAAI;CAsFX"}

package/dist/recorder.js

@@ -0,0 +1,283 @@
+import { spawn } from "node:child_process";
+import { mkdirSync, rmSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { resolve, extname } from "node:path";
+import { TARGET_FPS, DEFAULT_VIEWPORT_SIZE } from "./types.js";
+import { ensureFfmpeg } from "./ffmpeg.js";
+import { finalizeMp4, finalizeWebm, finalizeGif } from "./media.js";
+export function getFfmpegInputCodec(format) {
+    return format === "png" ? "png" : "mjpeg";
+}
+export function getFrameExtension(format) {
+    return format === "png" ? ".png" : ".jpg";
+}
+export function getCaptureScreenshotParams(format) {
+    if (format === "png") {
+        return { format: "png", optimizeForSpeed: true };
+    }
+    return { format: "jpeg", quality: 60, optimizeForSpeed: true };
+}
+export function buildFfmpegRecorderArgs(options) {
+    return [
+        "-y",
+        "-f",
+        "image2pipe",
+        "-framerate",
+        String(options.fps),
+        "-c:v",
+        getFfmpegInputCodec(options.captureFormat),
+        "-i",
+        "pipe:0",
+        "-c:v",
+        "libx264",
+        "-preset",
+        "ultrafast",
+        "-crf",
+        String(options.crf),
+        "-pix_fmt",
+        "yuv420p",
+        "-color_primaries",
+        "bt709",
+        "-color_trc",
+        "bt709",
+        "-colorspace",
+        "bt709",
+        "-movflags",
+        "+faststart",
+        "-r",
+        String(options.fps),
+        options.outputPath,
+    ];
+}
+export class Recorder {
+    outputPath = "";
+    frameCount = 0;
+    running = false;
+    capturePromise = null;
+    events = [];
+    outputWidth;
+    outputHeight;
+    sfx;
+    fps;
+    frameMs;
+    crf;
+    ffmpegPath = "ffmpeg";
+    ffmpegProcess = null;
+    tempVideo = "";
+    drainResolve = null;
+    droppedFrames = 0;
+    timeline = null;
+    ctx = null;
+    framesDir = null;
+    stopResolve = null;
+    stoppedPromise = null;
+    captureFormat;
+    constructor(outputWidth = DEFAULT_VIEWPORT_SIZE, outputHeight = DEFAULT_VIEWPORT_SIZE, options) {
+        this.outputWidth = outputWidth;
+        this.outputHeight = outputHeight;
+        this.sfx = options?.sfx;
+        this.fps = options?.fps ?? TARGET_FPS;
+        this.frameMs = 1000 / this.fps;
+        this.crf = options?.crf ?? 18;
+        this.captureFormat = options?.captureFormat ?? "jpeg";
+        if (options?.framesDir) {
+            this.framesDir = options.framesDir;
+            mkdirSync(this.framesDir, { recursive: true });
+        }
+    }
+    setTimeline(timeline) {
+        this.timeline = timeline;
+    }
+    getTimeline() {
+        return this.timeline;
+    }
+    getTimelineData() {
+        return this.timeline?.toJSON() ?? null;
+    }
+    addEvent(type) {
+        if (this.running) {
+            const timeMs = (this.frameCount / this.fps) * 1000;
+            this.events.push({ type, timeMs });
+        }
+    }
+    async start(client, outputPath, ctx) {
+        this.ffmpegPath = await ensureFfmpeg();
+        this.outputPath = outputPath;
+        this.frameCount = 0;
+        this.droppedFrames = 0;
+        this.running = true;
+        this.events = [];
+        this.ctx = ctx ?? null;
+        if (this.ctx)
+            this.ctx.setRecorder(this);
+        const workDir = resolve(homedir(), ".webreel");
+        mkdirSync(workDir, { recursive: true });
+        this.tempVideo = resolve(workDir, `_rec_${Date.now()}.mp4`);
+        this.ffmpegProcess = spawn(this.ffmpegPath, buildFfmpegRecorderArgs({
+            fps: this.fps,
+            crf: this.crf,
+            captureFormat: this.captureFormat,
+            outputPath: this.tempVideo,
+        }), { stdio: ["pipe", "pipe", "pipe"] });
+        const resolveDrain = () => {
+            const resolve = this.drainResolve;
+            if (resolve) {
+                this.drainResolve = null;
+                resolve();
+            }
+        };
+        const stdin = this.ffmpegProcess.stdin;
+        if (!stdin)
+            throw new Error("ffmpeg process has no stdin pipe");
+        stdin.on("drain", resolveDrain);
+        this.ffmpegProcess.on("close", resolveDrain);
+        this.stoppedPromise = new Promise((resolve) => {
+            this.stopResolve = resolve;
+        });
+        this.capturePromise = this.captureLoop(client);
+    }
+    async writeFrame(buffer) {
+        if (!this.running)
+            return;
+        const stdin = this.ffmpegProcess?.stdin;
+        if (!stdin?.writable) {
+            this.droppedFrames++;
+            return;
+        }
+        const ok = stdin.write(buffer);
+        if (!ok) {
+            await new Promise((res) => {
+                this.drainResolve = res;
+            });
+        }
+    }
+    async raceStop(promise) {
+        const stopped = this.stoppedPromise.then(() => null);
+        const result = await Promise.race([promise, stopped]);
+        return result;
+    }
+    async captureLoop(client) {
+        let lastFrameTime = Date.now();
+        let consecutiveErrors = 0;
+        while (this.running) {
+            try {
+                if (this.timeline) {
+                    this.timeline.tick();
+                }
+                else {
+                    const evalResult = await this.raceStop(client.Runtime.evaluate({
+                        expression: "window.__tickCursor&&window.__tickCursor()",
+                    }));
+                    if (!evalResult)
+                        break;
+                }
+                const screenshotResult = await this.raceStop(client.Page.captureScreenshot(getCaptureScreenshotParams(this.captureFormat)));
+                if (!screenshotResult)
+                    break;
+                const buffer = Buffer.from(screenshotResult.data, "base64");
+                const now = Date.now();
+                const elapsed = now - lastFrameTime;
+                const frameSlots = Math.min(3, Math.max(1, Math.round(elapsed / this.frameMs)));
+                if (frameSlots > 1) {
+                    for (let i = 0; i < frameSlots - 1; i++) {
+                        if (this.timeline)
+                            this.timeline.tickDuplicate();
+                        await this.writeFrame(buffer);
+                        this.frameCount++;
+                    }
+                }
+                await this.writeFrame(buffer);
+                this.frameCount++;
+                if (this.framesDir) {
+                    const padded = String(this.frameCount).padStart(5, "0");
+                    writeFileSync(resolve(this.framesDir, `frame-${padded}${getFrameExtension(this.captureFormat)}`), buffer);
+                }
+                lastFrameTime = now;
+                consecutiveErrors = 0;
+            }
+            catch (err) {
+                if (!this.running)
+                    break;
+                consecutiveErrors++;
+                if (consecutiveErrors >= 10) {
+                    console.error(`Recording aborted after ${consecutiveErrors} consecutive capture failures:`, err);
+                    break;
+                }
+            }
+        }
+    }
+    getTempVideoPath() {
+        return this.tempVideo;
+    }
+    async stop() {
+        this.running = false;
+        if (this.ctx)
+            this.ctx.setRecorder(null);
+        if (this.drainResolve) {
+            this.drainResolve();
+            this.drainResolve = null;
+        }
+        if (this.stopResolve) {
+            this.stopResolve();
+            this.stopResolve = null;
+        }
+        await this.capturePromise;
+        if (this.droppedFrames > 0) {
+            console.warn(`Warning: ${this.droppedFrames} frame(s) dropped during recording`);
+        }
+        if (this.ffmpegProcess) {
+            const proc = this.ffmpegProcess;
+            const FFMPEG_CLOSE_TIMEOUT_MS = 10_000;
+            const killTimer = setTimeout(() => {
+                try {
+                    proc.kill("SIGKILL");
+                }
+                catch {
+                    // Process may have already exited
+                }
+            }, FFMPEG_CLOSE_TIMEOUT_MS);
+            await new Promise((res) => {
+                if (proc.exitCode !== null) {
+                    res();
+                    return;
+                }
+                proc.once("close", () => res());
+                try {
+                    proc.stdin?.end();
+                }
+                catch (err) {
+                    console.warn("Failed to close ffmpeg stdin:", err);
+                    res();
+                }
+            });
+            clearTimeout(killTimer);
+            this.ffmpegProcess = null;
+        }
+        if (this.frameCount === 0) {
+            rmSync(this.tempVideo, { force: true });
+            return;
+        }
+        // When a timeline is set, the caller is responsible for the temp video
+        // (e.g. renaming it for later compositing). Don't delete or finalize it.
+        if (this.timeline) {
+            return;
+        }
+        try {
+            const durationSec = this.frameCount / this.fps;
+            const ext = extname(this.outputPath).toLowerCase();
+            if (ext === ".webm") {
+                finalizeWebm(this.ffmpegPath, this.tempVideo, this.outputPath, this.events, durationSec, this.sfx);
+            }
+            else if (ext === ".gif") {
+                finalizeGif(this.ffmpegPath, this.tempVideo, this.outputPath, this.outputWidth);
+            }
+            else {
+                finalizeMp4(this.ffmpegPath, this.tempVideo, this.outputPath, this.events, durationSec, { sfx: this.sfx });
+            }
+        }
+        finally {
+            rmSync(this.tempVideo, { force: true });
+        }
+    }
+}
+//# sourceMappingURL=recorder.js.map

package/dist/recorder.js.map

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

package/dist/timeline.d.ts

@@ -0,0 +1,82 @@
+import type { Point, SoundEvent } from "./types.js";
+interface CursorState {
+    x: number;
+    y: number;
+    scale: number;
+}
+interface HudState {
+    labels: string[];
+}
+interface FrameData {
+    cursor: CursorState;
+    hud: HudState | null;
+}
+export interface TimelineData {
+    fps: number;
+    width: number;
+    height: number;
+    zoom: number;
+    theme: {
+        cursorSvg: string;
+        cursorSize: number;
+        cursorHotspot: "top-left" | "center";
+        hud: {
+            background: string;
+            color: string;
+            fontSize: number;
+            fontFamily: string;
+            borderRadius: number;
+            position: "top" | "bottom";
+        };
+    };
+    frames: FrameData[];
+    events: SoundEvent[];
+}
+export declare class InteractionTimeline {
+    private cursorPath;
+    private pathIndex;
+    private currentCursor;
+    private currentHud;
+    private frames;
+    private events;
+    private frameCount;
+    private tickResolvers;
+    private width;
+    private height;
+    private zoom;
+    private fps;
+    private cursorSvg;
+    private cursorSize;
+    private cursorHotspot;
+    private hudConfig;
+    constructor(width?: number, height?: number, options?: {
+        zoom?: number;
+        fps?: number;
+        initialCursor?: {
+            x: number;
+            y: number;
+        };
+        cursorSvg?: string;
+        cursorSize?: number;
+        cursorHotspot?: "top-left" | "center";
+        hud?: Partial<TimelineData["theme"]["hud"]>;
+        loadedFrames?: FrameData[];
+        loadedEvents?: SoundEvent[];
+    });
+    setCursorPath(positions: Point[]): void;
+    setCursorScale(scale: number): void;
+    showHud(labels: string[]): void;
+    hideHud(): void;
+    addEvent(type: "click" | "key"): void;
+    waitForNextTick(): Promise<void>;
+    tick(): void;
+    tickDuplicate(): void;
+    private pushCurrentState;
+    getEvents(): SoundEvent[];
+    getFrameCount(): number;
+    toJSON(): TimelineData;
+    save(path: string): void;
+    static load(json: TimelineData): InteractionTimeline;
+}
+export {};
+//# sourceMappingURL=timeline.d.ts.map

package/dist/timeline.d.ts.map

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