@carlesandres/webreel-core 0.2.0

package/dist/__tests__/media.test.js.map

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

package/dist/__tests__/overlays.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=overlays.test.d.ts.map

package/dist/__tests__/overlays.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"overlays.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/overlays.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/overlays.test.js

@@ -0,0 +1,109 @@
+import { describe, it, expect } from "vitest";
+import { DEFAULT_CURSOR_SVG, DEFAULT_CURSOR_SIZE, DEFAULT_HUD_THEME } from "../types.js";
+import { injectOverlays, showKeys, hideKeys } from "../overlays.js";
+function createMockClient() {
+    const calls = [];
+    const client = {
+        Runtime: {
+            evaluate: async (params) => {
+                calls.push({ method: "evaluate", expression: params.expression });
+                return { result: {} };
+            },
+        },
+    };
+    return { client, calls };
+}
+describe("injectOverlays", () => {
+    it("uses default cursor size when no theme provided", async () => {
+        const { client, calls } = createMockClient();
+        await injectOverlays(client);
+        expect(calls).toHaveLength(1);
+        expect(calls[0].expression).toContain(`width:${DEFAULT_CURSOR_SIZE}px`);
+        expect(calls[0].expression).toContain(`height:${DEFAULT_CURSOR_SIZE}px`);
+    });
+    it("uses custom cursor size from theme", async () => {
+        const { client, calls } = createMockClient();
+        await injectOverlays(client, { cursorSize: 48 });
+        expect(calls[0].expression).toContain("width:48px");
+        expect(calls[0].expression).toContain("height:48px");
+    });
+    it("applies top-left hotspot with zero margin offset", async () => {
+        const { client, calls } = createMockClient();
+        await injectOverlays(client, { cursorHotspot: "top-left" });
+        expect(calls[0].expression).toContain("margin-left:0px");
+        expect(calls[0].expression).toContain("margin-top:0px");
+    });
+    it("applies center hotspot with half-size margin offset", async () => {
+        const { client, calls } = createMockClient();
+        await injectOverlays(client, { cursorSize: 32, cursorHotspot: "center" });
+        expect(calls[0].expression).toContain("margin-left:-16px");
+        expect(calls[0].expression).toContain("margin-top:-16px");
+    });
+    it("uses default HUD theme values when not overridden", async () => {
+        const { client, calls } = createMockClient();
+        await injectOverlays(client);
+        const expr = calls[0].expression;
+        expect(expr).toContain(`background:${DEFAULT_HUD_THEME.background}`);
+        expect(expr).toContain(`border-radius:" + z(${DEFAULT_HUD_THEME.borderRadius})`);
+    });
+    it("uses custom HUD theme values", async () => {
+        const { client, calls } = createMockClient();
+        const theme = {
+            hud: {
+                background: "red",
+                color: "blue",
+                fontSize: 32,
+                borderRadius: 8,
+                position: "top",
+            },
+        };
+        await injectOverlays(client, theme);
+        const expr = calls[0].expression;
+        expect(expr).toContain("background:red");
+        expect(expr).toContain("color: blue");
+        expect(expr).toContain('border-radius:" + z(8)');
+        expect(expr).toContain('"top:"');
+    });
+    it("uses custom cursor SVG", async () => {
+        const { client, calls } = createMockClient();
+        const svg = '<svg><circle r="10"/></svg>';
+        await injectOverlays(client, { cursorSvg: svg });
+        expect(calls[0].expression).toContain(JSON.stringify(svg));
+    });
+    it("uses default cursor SVG when none provided", async () => {
+        const { client, calls } = createMockClient();
+        await injectOverlays(client);
+        expect(calls[0].expression).toContain(JSON.stringify(DEFAULT_CURSOR_SVG));
+    });
+    it("applies initial cursor position", async () => {
+        const { client, calls } = createMockClient();
+        await injectOverlays(client, undefined, { x: 100, y: 200 });
+        const expr = calls[0].expression;
+        expect(expr).toContain("translate(100px,200px)");
+        expect(expr).toContain('dataset.cx = "100"');
+        expect(expr).toContain('dataset.cy = "200"');
+    });
+});
+describe("showKeys", () => {
+    it("passes labels to the expression", async () => {
+        const { client, calls } = createMockClient();
+        await showKeys(client, ["Ctrl", "Z"]);
+        expect(calls[0].expression).toContain(JSON.stringify(["Ctrl", "Z"]));
+    });
+    it("expression includes HTML entity escaping for &, <, >", async () => {
+        const { client, calls } = createMockClient();
+        await showKeys(client, ["<test>"]);
+        const expr = calls[0].expression;
+        expect(expr).toContain("&amp;");
+        expect(expr).toContain("&lt;");
+        expect(expr).toContain("&gt;");
+    });
+});
+describe("hideKeys", () => {
+    it("sets opacity to 0", async () => {
+        const { client, calls } = createMockClient();
+        await hideKeys(client);
+        expect(calls[0].expression).toContain('opacity = "0"');
+    });
+});
+//# sourceMappingURL=overlays.test.js.map

package/dist/__tests__/overlays.test.js.map

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

package/dist/__tests__/recorder.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=recorder.test.d.ts.map

package/dist/__tests__/recorder.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recorder.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/recorder.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/recorder.test.js

@@ -0,0 +1,60 @@
+import { describe, it, expect } from "vitest";
+import { buildFfmpegRecorderArgs, getCaptureScreenshotParams, getFfmpegInputCodec, getFrameExtension, } from "../recorder.js";
+function expectPipeInputCodec(args, codec) {
+    const inputIndex = args.indexOf("pipe:0");
+    expect(inputIndex).toBeGreaterThan(0);
+    expect(args.slice(inputIndex - 3, inputIndex + 1)).toEqual([
+        "-c:v",
+        codec,
+        "-i",
+        "pipe:0",
+    ]);
+}
+describe("getCaptureScreenshotParams", () => {
+    it("returns jpeg capture settings by default", () => {
+        expect(getCaptureScreenshotParams("jpeg")).toEqual({
+            format: "jpeg",
+            quality: 60,
+            optimizeForSpeed: true,
+        });
+    });
+    it("returns png capture settings without jpeg quality", () => {
+        expect(getCaptureScreenshotParams("png")).toEqual({
+            format: "png",
+            optimizeForSpeed: true,
+        });
+    });
+});
+describe("capture format helpers", () => {
+    it("uses mjpeg ffmpeg input for jpeg frames", () => {
+        expect(getFfmpegInputCodec("jpeg")).toBe("mjpeg");
+        expect(getFrameExtension("jpeg")).toBe(".jpg");
+    });
+    it("uses png ffmpeg input for png frames", () => {
+        expect(getFfmpegInputCodec("png")).toBe("png");
+        expect(getFrameExtension("png")).toBe(".png");
+    });
+});
+describe("buildFfmpegRecorderArgs", () => {
+    it("uses image2pipe with the jpeg decoder by default", () => {
+        const args = buildFfmpegRecorderArgs({
+            fps: 60,
+            crf: 18,
+            captureFormat: "jpeg",
+            outputPath: "out.mp4",
+        });
+        expect(args.slice(1, 3)).toEqual(["-f", "image2pipe"]);
+        expectPipeInputCodec(args, "mjpeg");
+    });
+    it("uses image2pipe with the png decoder for png source frames", () => {
+        const args = buildFfmpegRecorderArgs({
+            fps: 60,
+            crf: 18,
+            captureFormat: "png",
+            outputPath: "out.mp4",
+        });
+        expect(args.slice(1, 3)).toEqual(["-f", "image2pipe"]);
+        expectPipeInputCodec(args, "png");
+    });
+});
+//# sourceMappingURL=recorder.test.js.map

package/dist/__tests__/recorder.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recorder.test.js","sourceRoot":"","sources":["../../src/__tests__/recorder.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EACL,uBAAuB,EACvB,0BAA0B,EAC1B,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,gBAAgB,CAAC;AAExB,SAAS,oBAAoB,CAAC,IAAc,EAAE,KAAa;IACzD,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC1C,MAAM,CAAC,UAAU,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;IACtC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,GAAG,CAAC,EAAE,UAAU,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;QACzD,MAAM;QACN,KAAK;QACL,IAAI;QACJ,QAAQ;KACT,CAAC,CAAC;AACL,CAAC;AAED,QAAQ,CAAC,4BAA4B,EAAE,GAAG,EAAE;IAC1C,EAAE,CAAC,0CAA0C,EAAE,GAAG,EAAE;QAClD,MAAM,CAAC,0BAA0B,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC;YACjD,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE;YACX,gBAAgB,EAAE,IAAI;SACvB,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mDAAmD,EAAE,GAAG,EAAE;QAC3D,MAAM,CAAC,0BAA0B,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC;YAChD,MAAM,EAAE,KAAK;YACb,gBAAgB,EAAE,IAAI;SACvB,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,wBAAwB,EAAE,GAAG,EAAE;IACtC,EAAE,CAAC,yCAAyC,EAAE,GAAG,EAAE;QACjD,MAAM,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAClD,MAAM,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACjD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;QAC9C,MAAM,CAAC,mBAAmB,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC/C,MAAM,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAChD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,yBAAyB,EAAE,GAAG,EAAE;IACvC,EAAE,CAAC,kDAAkD,EAAE,GAAG,EAAE;QAC1D,MAAM,IAAI,GAAG,uBAAuB,CAAC;YACnC,GAAG,EAAE,EAAE;YACP,GAAG,EAAE,EAAE;YACP,aAAa,EAAE,MAAM;YACrB,UAAU,EAAE,SAAS;SACtB,CAAC,CAAC;QAEH,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC,CAAC;QACvD,oBAAoB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4DAA4D,EAAE,GAAG,EAAE;QACpE,MAAM,IAAI,GAAG,uBAAuB,CAAC;YACnC,GAAG,EAAE,EAAE;YACP,GAAG,EAAE,EAAE;YACP,aAAa,EAAE,KAAK;YACpB,UAAU,EAAE,SAAS;SACtB,CAAC,CAAC;QAEH,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC,CAAC;QACvD,oBAAoB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/__tests__/recording-context.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=recording-context.test.d.ts.map

package/dist/__tests__/recording-context.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recording-context.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/recording-context.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/recording-context.test.js

@@ -0,0 +1,46 @@
+import { describe, it, expect } from "vitest";
+import { RecordingContext } from "../actions.js";
+describe("RecordingContext", () => {
+    it("defaults to preview mode", () => {
+        const ctx = new RecordingContext();
+        expect(ctx.mode).toBe("preview");
+        expect(ctx.isRecording).toBe(false);
+    });
+    it("isRecording is true when mode is record and timeline is set", () => {
+        const ctx = new RecordingContext();
+        ctx.setMode("record");
+        expect(ctx.isRecording).toBe(false);
+        ctx.setTimeline({ addEvent: () => { } });
+        expect(ctx.isRecording).toBe(true);
+    });
+    it("resetCursorPosition places cursor off-screen", () => {
+        const ctx = new RecordingContext();
+        ctx.resetCursorPosition(1920, 1080);
+        const pos = ctx.getCursorPosition();
+        const offScreen = pos.x < 0 || pos.x > 1920 || pos.y < 0 || pos.y > 1080;
+        expect(offScreen).toBe(true);
+    });
+    it("getCursorPosition returns initial off-screen position", () => {
+        const ctx = new RecordingContext();
+        const pos = ctx.getCursorPosition();
+        expect(pos.x).toBe(-40);
+        expect(pos.y).toBe(-40);
+    });
+    it("markEvent delegates to recorder when set", () => {
+        const ctx = new RecordingContext();
+        const events = [];
+        ctx.setRecorder({ addEvent: (type) => events.push(type) });
+        ctx.markEvent("click");
+        ctx.markEvent("key");
+        expect(events).toEqual(["click", "key"]);
+    });
+    it("markEvent delegates to timeline when recording", () => {
+        const ctx = new RecordingContext();
+        const events = [];
+        ctx.setMode("record");
+        ctx.setTimeline({ addEvent: (type) => events.push(type) });
+        ctx.markEvent("click");
+        expect(events).toEqual(["click"]);
+    });
+});
+//# sourceMappingURL=recording-context.test.js.map

package/dist/__tests__/recording-context.test.js.map

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

package/dist/__tests__/timeline.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=timeline.test.d.ts.map

package/dist/__tests__/timeline.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeline.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/timeline.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/timeline.test.js

@@ -0,0 +1,88 @@
+import { describe, it, expect } from "vitest";
+import { InteractionTimeline } from "../timeline.js";
+describe("InteractionTimeline", () => {
+    it("starts with zero frames", () => {
+        const tl = new InteractionTimeline(1080, 1080);
+        expect(tl.getFrameCount()).toBe(0);
+        expect(tl.getEvents()).toEqual([]);
+    });
+    it("tick advances frame count", () => {
+        const tl = new InteractionTimeline(800, 600);
+        tl.tick();
+        tl.tick();
+        tl.tick();
+        expect(tl.getFrameCount()).toBe(3);
+    });
+    it("tickDuplicate also advances frame count", () => {
+        const tl = new InteractionTimeline(800, 600);
+        tl.tick();
+        tl.tickDuplicate();
+        expect(tl.getFrameCount()).toBe(2);
+    });
+    it("addEvent records events with correct timing", () => {
+        const tl = new InteractionTimeline(1080, 1080);
+        for (let i = 0; i < 60; i++)
+            tl.tick();
+        tl.addEvent("click");
+        const events = tl.getEvents();
+        expect(events).toHaveLength(1);
+        expect(events[0].type).toBe("click");
+        expect(events[0].timeMs).toBeCloseTo(1000, 0);
+    });
+    it("toJSON produces valid timeline data", () => {
+        const tl = new InteractionTimeline(1920, 1080, { zoom: 2 });
+        tl.tick();
+        const data = tl.toJSON();
+        expect(data.fps).toBe(60);
+        expect(data.width).toBe(1920);
+        expect(data.height).toBe(1080);
+        expect(data.zoom).toBe(2);
+        expect(data.frames).toHaveLength(1);
+        expect(data.theme.cursorSize).toBe(24);
+    });
+    it("load roundtrips correctly", () => {
+        const tl = new InteractionTimeline(800, 600, {
+            zoom: 1.5,
+            cursorSize: 32,
+        });
+        tl.setCursorPath([{ x: 100, y: 200 }]);
+        tl.tick();
+        tl.addEvent("key");
+        tl.tick();
+        const json = tl.toJSON();
+        const loaded = InteractionTimeline.load(json);
+        const reJson = loaded.toJSON();
+        expect(reJson.frames).toEqual(json.frames);
+        expect(reJson.events).toEqual(json.events);
+        expect(reJson.width).toBe(json.width);
+        expect(reJson.height).toBe(json.height);
+        expect(reJson.zoom).toBe(json.zoom);
+    });
+    it("showHud and hideHud affect frame data", () => {
+        const tl = new InteractionTimeline(1080, 1080);
+        tl.showHud(["Ctrl", "A"]);
+        tl.tick();
+        tl.hideHud();
+        tl.tick();
+        const data = tl.toJSON();
+        expect(data.frames[0].hud).toEqual({ labels: ["Ctrl", "A"] });
+        expect(data.frames[1].hud).toBeNull();
+    });
+    it("setCursorPath advances cursor through positions", () => {
+        const tl = new InteractionTimeline(1080, 1080);
+        tl.setCursorPath([
+            { x: 10, y: 20 },
+            { x: 30, y: 40 },
+        ]);
+        tl.tick();
+        tl.tick();
+        tl.tick();
+        const data = tl.toJSON();
+        expect(data.frames[0].cursor.x).toBe(10);
+        expect(data.frames[0].cursor.y).toBe(20);
+        expect(data.frames[1].cursor.x).toBe(30);
+        expect(data.frames[1].cursor.y).toBe(40);
+        expect(data.frames[2].cursor.x).toBe(30);
+    });
+});
+//# sourceMappingURL=timeline.test.js.map

package/dist/__tests__/timeline.test.js.map

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

package/dist/actions.d.ts

@@ -0,0 +1,65 @@
+import type { CDPClient, BoundingBox } from "./types.js";
+import type { InteractionTimeline } from "./timeline.js";
+export declare class RecordingContext {
+    private _mode;
+    private _timeline;
+    private _recorder;
+    private _cursorX;
+    private _cursorY;
+    private _clickDwell;
+    get mode(): "record" | "preview";
+    setMode(mode: "record" | "preview"): void;
+    get timeline(): InteractionTimeline | null;
+    setTimeline(timeline: InteractionTimeline | null): void;
+    setRecorder(recorder: {
+        addEvent: (type: "click" | "key") => void;
+    } | null): void;
+    get cursorX(): number;
+    get cursorY(): number;
+    setCursorPosition(x: number, y: number): void;
+    get isRecording(): boolean;
+    resetCursorPosition(cssWidth?: number, cssHeight?: number): void;
+    setClickDwell(ms: number | undefined): void;
+    getClickDwellMs(): number;
+    getCursorPosition(): {
+        x: number;
+        y: number;
+    };
+    markEvent(type: "click" | "key"): void;
+}
+export declare function modKey(): string;
+export declare function pause(ms?: number): Promise<void>;
+export declare function navigate(client: CDPClient, url: string): Promise<void>;
+export declare function waitForSelector(client: CDPClient, selector: string, timeoutMs?: number): Promise<void>;
+export declare function waitForText(client: CDPClient, text: string, within?: string, timeoutMs?: number): Promise<void>;
+export declare function findElementByText(client: CDPClient, text: string, within?: string): Promise<BoundingBox | null>;
+export declare function findElementBySelector(client: CDPClient, selector: string, within?: string): Promise<BoundingBox | null>;
+export declare function moveCursorTo(ctx: RecordingContext, client: CDPClient, x: number, y: number): Promise<void>;
+export declare function resolveMod(mod: string): string;
+export declare function modifierFlag(mod: string): number;
+export declare function modifiersToFlag(mods?: string[]): number;
+export declare function modLabel(mod: string): string;
+interface ModKeyInfo {
+    key: string;
+    code: string;
+    keyCode: number;
+    location: number;
+}
+export declare function modKeyInfo(mod: string): ModKeyInfo | null;
+export declare function clickAt(ctx: RecordingContext, client: CDPClient, x: number, y: number, modifiers?: string[]): Promise<void>;
+export declare const KEY_CODES: Record<string, {
+    code: string;
+    keyCode: number;
+}>;
+export declare const SHORTCUT_COMMANDS: Record<string, string[]>;
+export declare function resolveCommands(modifiers: string[], mainKey: string): string[] | undefined;
+export declare function pressKey(ctx: RecordingContext, client: CDPClient, key: string, label?: string): Promise<void>;
+export declare const CHAR_CODES: Record<string, {
+    code: string;
+    keyCode: number;
+}>;
+export declare function typeText(ctx: RecordingContext, client: CDPClient, text: string, delayMs?: number): Promise<void>;
+export declare function dragFromTo(ctx: RecordingContext, client: CDPClient, fromBox: BoundingBox, toBox: BoundingBox): Promise<void>;
+export declare function captureScreenshot(client: CDPClient, outputPath: string): Promise<void>;
+export {};
+//# sourceMappingURL=actions.d.ts.map

package/dist/actions.d.ts.map

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