playwright-recast 0.1.0

package/dist/parse/jsonl-parser.d.ts

@@ -0,0 +1,87 @@
+/** Raw trace event as parsed from JSONL */
+export type TraceEventRaw = ContextOptionsEvent | BeforeActionEvent | AfterActionEvent | InputEvent | ScreencastFrameEvent | ResourceSnapshotEvent | ConsoleEvent | GenericEvent;
+export interface ContextOptionsEvent {
+    type: 'context-options';
+    browserName?: string;
+    platform?: string;
+    options?: {
+        viewport?: {
+            width: number;
+            height: number;
+        };
+    };
+    wallTime?: number;
+    monotonicTime?: number;
+    playwrightVersion?: string;
+}
+export interface BeforeActionEvent {
+    type: 'before';
+    callId: string;
+    stepId?: string;
+    title: string;
+    class: string;
+    method: string;
+    params?: Record<string, unknown>;
+    startTime: number;
+    pageId?: string;
+    parentId?: string;
+    stack?: unknown;
+}
+export interface AfterActionEvent {
+    type: 'after';
+    callId: string;
+    endTime: number;
+    error?: {
+        message: string;
+    };
+    result?: unknown;
+    point?: {
+        x: number;
+        y: number;
+    };
+}
+export interface InputEvent {
+    type: 'input';
+    callId: string;
+    point?: {
+        x: number;
+        y: number;
+    };
+}
+export interface ScreencastFrameEvent {
+    type: 'screencast-frame';
+    pageId: string;
+    sha1: string;
+    width: number;
+    height: number;
+    timestamp: number;
+}
+export interface ResourceSnapshotEvent {
+    type: 'resource-snapshot';
+    snapshot: {
+        request: {
+            url: string;
+            method: string;
+        };
+        response: {
+            status: number;
+            mimeType?: string;
+        };
+        startedDateTime: string;
+        time: number;
+        _monotonicTime?: number;
+    };
+}
+export interface ConsoleEvent {
+    type: 'console';
+    time: number;
+    text?: string;
+    pageId?: string;
+}
+export interface GenericEvent {
+    type: string;
+    [key: string]: unknown;
+}
+/** Parse a JSONL string into typed trace events, skipping malformed lines */
+export declare function parseJsonl(content: string): TraceEventRaw[];
+//# sourceMappingURL=jsonl-parser.d.ts.map

package/dist/parse/jsonl-parser.d.ts.map

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

package/dist/parse/jsonl-parser.js

@@ -0,0 +1,17 @@
+/** Parse a JSONL string into typed trace events, skipping malformed lines */
+export function parseJsonl(content) {
+    const events = [];
+    for (const line of content.split('\n')) {
+        const trimmed = line.trim();
+        if (!trimmed)
+            continue;
+        try {
+            events.push(JSON.parse(trimmed));
+        }
+        catch {
+            // Skip malformed lines
+        }
+    }
+    return events;
+}
+//# sourceMappingURL=jsonl-parser.js.map

package/dist/parse/jsonl-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonl-parser.js","sourceRoot":"","sources":["../../src/parse/jsonl-parser.ts"],"names":[],"mappings":"AAoFA,6EAA6E;AAC7E,MAAM,UAAU,UAAU,CAAC,OAAe;IACxC,MAAM,MAAM,GAAoB,EAAE,CAAA;IAElC,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACvC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAA;QAC3B,IAAI,CAAC,OAAO;YAAE,SAAQ;QACtB,IAAI,CAAC;YACH,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAkB,CAAC,CAAA;QACnD,CAAC;QAAC,MAAM,CAAC;YACP,uBAAuB;QACzB,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAA;AACf,CAAC"}

package/dist/parse/trace-parser.d.ts

@@ -0,0 +1,6 @@
+import type { ParsedTrace } from '../types/trace';
+/**
+ * Parse a Playwright trace zip into structured data.
+ */
+export declare function parseTrace(tracePath: string): Promise<ParsedTrace>;
+//# sourceMappingURL=trace-parser.d.ts.map

package/dist/parse/trace-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace-parser.d.ts","sourceRoot":"","sources":["../../src/parse/trace-parser.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EAQZ,MAAM,gBAAgB,CAAA;AAcvB;;GAEG;AACH,wBAAsB,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAiKxE"}

package/dist/parse/trace-parser.js

@@ -0,0 +1,149 @@
+import { toMonotonic } from '../types/trace';
+import { ZipReader } from './zip-reader';
+import { parseJsonl, } from './jsonl-parser';
+/**
+ * Parse a Playwright trace zip into structured data.
+ */
+export async function parseTrace(tracePath) {
+    const zip = ZipReader.open(tracePath);
+    const entries = zip.entryNames();
+    // Parse ALL trace and network JSONL files (multiple contexts in one zip)
+    const traceFiles = entries.filter((n) => n.endsWith('.trace'));
+    const networkFiles = entries.filter((n) => n.endsWith('.network'));
+    const traceEvents = traceFiles.flatMap((f) => parseJsonl(zip.readText(f)));
+    const networkEvents = networkFiles.flatMap((f) => parseJsonl(zip.readText(f)));
+    // Find the most informative context-options event (one with browserName set)
+    const ctxOptsAll = traceEvents.filter((e) => e.type === 'context-options');
+    const ctxOpts = ctxOptsAll.find((e) => e.browserName && e.browserName.length > 0) ??
+        ctxOptsAll[0];
+    // Build action map: before + after events paired by callId
+    const actionStarts = new Map();
+    const actionEnds = new Map();
+    const inputPoints = new Map();
+    for (const event of traceEvents) {
+        switch (event.type) {
+            case 'before': {
+                const e = event;
+                actionStarts.set(e.callId, e);
+                break;
+            }
+            case 'after': {
+                const e = event;
+                actionEnds.set(e.callId, e);
+                break;
+            }
+            case 'input': {
+                const e = event;
+                if (e.point)
+                    inputPoints.set(e.callId, e.point);
+                break;
+            }
+        }
+    }
+    // Build actions
+    const actions = [];
+    for (const [callId, start] of actionStarts) {
+        const end = actionEnds.get(callId);
+        const point = inputPoints.get(callId);
+        actions.push({
+            callId,
+            stepId: start.stepId,
+            title: start.title,
+            class: start.class,
+            method: start.method,
+            params: start.params ?? {},
+            startTime: toMonotonic(start.startTime),
+            endTime: toMonotonic(end?.endTime ?? start.startTime),
+            parentId: start.parentId,
+            error: end?.error,
+            point: point
+                ? { x: point.x, y: point.y, timestamp: toMonotonic(start.startTime) }
+                : undefined,
+        });
+    }
+    actions.sort((a, b) => a.startTime - b.startTime);
+    // Extract screencast frames
+    const frames = traceEvents
+        .filter((e) => e.type === 'screencast-frame')
+        .map((e) => ({
+        sha1: e.sha1,
+        timestamp: toMonotonic(e.timestamp),
+        pageId: e.pageId,
+        width: e.width,
+        height: e.height,
+    }))
+        .sort((a, b) => a.timestamp - b.timestamp);
+    // Extract network resources
+    const resources = networkEvents
+        .filter((e) => e.type === 'resource-snapshot')
+        .map((e) => {
+        const s = e.snapshot;
+        const startTime = s._monotonicTime ?? 0;
+        return {
+            url: s.request.url,
+            method: s.request.method,
+            status: s.response.status,
+            startTime: toMonotonic(startTime),
+            endTime: toMonotonic(startTime + (s.time ?? 0)),
+            mimeType: s.response.mimeType ?? '',
+        };
+    });
+    // Extract cursor positions from input events
+    const cursorPositions = [];
+    for (const [callId, point] of inputPoints) {
+        const start = actionStarts.get(callId);
+        if (start) {
+            cursorPositions.push({
+                x: point.x,
+                y: point.y,
+                timestamp: toMonotonic(start.startTime),
+            });
+        }
+    }
+    cursorPositions.sort((a, b) => a.timestamp - b.timestamp);
+    // Extract console/page events
+    const events = traceEvents
+        .filter((e) => e.type === 'console' || e.type === 'event')
+        .map((e) => ({
+        type: e.type,
+        time: toMonotonic(e.time),
+        pageId: e.pageId,
+        text: e.text,
+    }));
+    // Compute time boundaries
+    const allTimes = [
+        ...actions.map((a) => a.startTime),
+        ...actions.map((a) => a.endTime),
+        ...frames.map((f) => f.timestamp),
+    ].filter((t) => t > 0);
+    const startTime = allTimes.length > 0 ? Math.min(...allTimes) : 0;
+    const endTime = allTimes.length > 0 ? Math.max(...allTimes) : 0;
+    // Create frame reader
+    const frameReader = {
+        readFrame(sha1) {
+            const name = `resources/${sha1}`;
+            return Promise.resolve(zip.readBinary(name));
+        },
+        dispose() {
+            zip.dispose();
+        },
+    };
+    return {
+        metadata: {
+            browserName: ctxOpts?.browserName ?? 'unknown',
+            platform: ctxOpts?.platform ?? 'unknown',
+            viewport: ctxOpts?.options?.viewport ?? { width: 1920, height: 1080 },
+            startTime: toMonotonic(startTime),
+            endTime: toMonotonic(endTime),
+            wallTime: ctxOpts?.wallTime ?? 0,
+            playwrightVersion: ctxOpts?.playwrightVersion,
+        },
+        frames,
+        actions,
+        resources,
+        events,
+        cursorPositions,
+        frameReader,
+    };
+}
+//# sourceMappingURL=trace-parser.js.map

package/dist/parse/trace-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace-parser.js","sourceRoot":"","sources":["../../src/parse/trace-parser.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AACxC,OAAO,EACL,UAAU,GAQX,MAAM,gBAAgB,CAAA;AAEvB;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,SAAiB;IAChD,MAAM,GAAG,GAAG,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;IACrC,MAAM,OAAO,GAAG,GAAG,CAAC,UAAU,EAAE,CAAA;IAEhC,yEAAyE;IACzE,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAA;IAC9D,MAAM,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAA;IAElE,MAAM,WAAW,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;IAC1E,MAAM,aAAa,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;IAE9E,6EAA6E;IAC7E,MAAM,UAAU,GAAG,WAAW,CAAC,MAAM,CACnC,CAAC,CAAC,EAA4B,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,iBAAiB,CAC9D,CAAA;IACD,MAAM,OAAO,GACX,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,IAAI,CAAC,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC;QACjE,UAAU,CAAC,CAAC,CAAC,CAAA;IAEf,2DAA2D;IAC3D,MAAM,YAAY,GAAG,IAAI,GAAG,EAA6B,CAAA;IACzD,MAAM,UAAU,GAAG,IAAI,GAAG,EAA4B,CAAA;IACtD,MAAM,WAAW,GAAG,IAAI,GAAG,EAAoC,CAAA;IAE/D,KAAK,MAAM,KAAK,IAAI,WAAW,EAAE,CAAC;QAChC,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;YACnB,KAAK,QAAQ,CAAC,CAAC,CAAC;gBACd,MAAM,CAAC,GAAG,KAA0B,CAAA;gBACpC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAA;gBAC7B,MAAK;YACP,CAAC;YACD,KAAK,OAAO,CAAC,CAAC,CAAC;gBACb,MAAM,CAAC,GAAG,KAAyB,CAAA;gBACnC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAA;gBAC3B,MAAK;YACP,CAAC;YACD,KAAK,OAAO,CAAC,CAAC,CAAC;gBACb,MAAM,CAAC,GAAG,KAAmB,CAAA;gBAC7B,IAAI,CAAC,CAAC,KAAK;oBAAE,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAA;gBAC/C,MAAK;YACP,CAAC;QACH,CAAC;IACH,CAAC;IAED,gBAAgB;IAChB,MAAM,OAAO,GAAkB,EAAE,CAAA;IACjC,KAAK,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,YAAY,EAAE,CAAC;QAC3C,MAAM,GAAG,GAAG,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;QAClC,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;QACrC,OAAO,CAAC,IAAI,CAAC;YACX,MAAM;YACN,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,EAAE;YAC1B,SAAS,EAAE,WAAW,CAAC,KAAK,CAAC,SAAS,CAAC;YACvC,OAAO,EAAE,WAAW,CAAC,GAAG,EAAE,OAAO,IAAI,KAAK,CAAC,SAAS,CAAC;YACrD,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,KAAK,EAAE,GAAG,EAAE,KAAK;YACjB,KAAK,EAAE,KAAK;gBACV,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC,EAAE,SAAS,EAAE,WAAW,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE;gBACrE,CAAC,CAAC,SAAS;SACd,CAAC,CAAA;IACJ,CAAC;IACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAE,CAAC,CAAC,SAAoB,GAAI,CAAC,CAAC,SAAoB,CAAC,CAAA;IAEzE,4BAA4B;IAC5B,MAAM,MAAM,GAAsB,WAAW;SAC1C,MAAM,CAAC,CAAC,CAAC,EAA6B,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,kBAAkB,CAAC;SACvE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACX,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,SAAS,EAAE,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC;QACnC,MAAM,EAAE,CAAC,CAAC,MAAM;QAChB,KAAK,EAAE,CAAC,CAAC,KAAK;QACd,MAAM,EAAE,CAAC,CAAC,MAAM;KACjB,CAAC,CAAC;SACF,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAE,CAAC,CAAC,SAAoB,GAAI,CAAC,CAAC,SAAoB,CAAC,CAAA;IAEpE,4BAA4B;IAC5B,MAAM,SAAS,GAAoB,aAAa;SAC7C,MAAM,CAAC,CAAC,CAAC,EAA8B,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,mBAAmB,CAAC;SACzE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QACT,MAAM,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAA;QACpB,MAAM,SAAS,GAAG,CAAC,CAAC,cAAc,IAAI,CAAC,CAAA;QACvC,OAAO;YACL,GAAG,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG;YAClB,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM;YACxB,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,MAAM;YACzB,SAAS,EAAE,WAAW,CAAC,SAAS,CAAC;YACjC,OAAO,EAAE,WAAW,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC;YAC/C,QAAQ,EAAE,CAAC,CAAC,QAAQ,CAAC,QAAQ,IAAI,EAAE;SACpC,CAAA;IACH,CAAC,CAAC,CAAA;IAEJ,6CAA6C;IAC7C,MAAM,eAAe,GAAqB,EAAE,CAAA;IAC5C,KAAK,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,WAAW,EAAE,CAAC;QAC1C,MAAM,KAAK,GAAG,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;QACtC,IAAI,KAAK,EAAE,CAAC;YACV,eAAe,CAAC,IAAI,CAAC;gBACnB,CAAC,EAAE,KAAK,CAAC,CAAC;gBACV,CAAC,EAAE,KAAK,CAAC,CAAC;gBACV,SAAS,EAAE,WAAW,CAAC,KAAK,CAAC,SAAS,CAAC;aACxC,CAAC,CAAA;QACJ,CAAC;IACH,CAAC;IACD,eAAe,CAAC,IAAI,CAClB,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAE,CAAC,CAAC,SAAoB,GAAI,CAAC,CAAC,SAAoB,CAC5D,CAAA;IAED,8BAA8B;IAC9B,MAAM,MAAM,GAAiB,WAAW;SACrC,MAAM,CACL,CAAC,CAAC,EAAqB,EAAE,CACvB,CAAC,CAAC,IAAI,KAAK,SAAS,IAAI,CAAC,CAAC,IAAI,KAAK,OAAO,CAC7C;SACA,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACX,IAAI,EAAE,CAAC,CAAC,IAA2B;QACnC,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC;QACzB,MAAM,EAAE,CAAC,CAAC,MAAM;QAChB,IAAI,EAAE,CAAC,CAAC,IAAI;KACb,CAAC,CAAC,CAAA;IAEL,0BAA0B;IAC1B,MAAM,QAAQ,GAAG;QACf,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAmB,CAAC;QAC5C,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAiB,CAAC;QAC1C,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAmB,CAAC;KAC5C,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAA;IACtB,MAAM,SAAS,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;IACjE,MAAM,OAAO,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;IAE/D,sBAAsB;IACtB,MAAM,WAAW,GAAgB;QAC/B,SAAS,CAAC,IAAY;YACpB,MAAM,IAAI,GAAG,aAAa,IAAI,EAAE,CAAA;YAChC,OAAO,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAA;QAC9C,CAAC;QACD,OAAO;YACL,GAAG,CAAC,OAAO,EAAE,CAAA;QACf,CAAC;KACF,CAAA;IAED,OAAO;QACL,QAAQ,EAAE;YACR,WAAW,EAAE,OAAO,EAAE,WAAW,IAAI,SAAS;YAC9C,QAAQ,EAAE,OAAO,EAAE,QAAQ,IAAI,SAAS;YACxC,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE;YACrE,SAAS,EAAE,WAAW,CAAC,SAAS,CAAC;YACjC,OAAO,EAAE,WAAW,CAAC,OAAO,CAAC;YAC7B,QAAQ,EAAE,OAAO,EAAE,QAAQ,IAAI,CAAC;YAChC,iBAAiB,EAAE,OAAO,EAAE,iBAAiB;SAC9C;QACD,MAAM;QACN,OAAO;QACP,SAAS;QACT,MAAM;QACN,eAAe;QACf,WAAW;KACZ,CAAA;AACH,CAAC"}

package/dist/parse/zip-reader.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Reads entries from a Playwright trace ZIP file.
+ * Uses fflate (pure JS) for zero-dependency ZIP extraction.
+ */
+export declare class ZipReader {
+    private entries;
+    private constructor();
+    /** Open a zip file and extract all entries into memory */
+    static open(zipPath: string): ZipReader;
+    /** Get all entry names in the zip */
+    entryNames(): string[];
+    /** Read an entry as UTF-8 text */
+    readText(name: string): string;
+    /** Read an entry as raw binary buffer */
+    readBinary(name: string): Buffer;
+    /** Check if an entry exists */
+    has(name: string): boolean;
+    /** Release memory */
+    dispose(): void;
+}
+//# sourceMappingURL=zip-reader.d.ts.map

package/dist/parse/zip-reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zip-reader.d.ts","sourceRoot":"","sources":["../../src/parse/zip-reader.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,OAAO,CAA4B;IAE3C,OAAO;IAIP,0DAA0D;IAC1D,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS;IAMvC,qCAAqC;IACrC,UAAU,IAAI,MAAM,EAAE;IAItB,kCAAkC;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAM9B,yCAAyC;IACzC,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAMhC,+BAA+B;IAC/B,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B,qBAAqB;IACrB,OAAO,IAAI,IAAI;CAGhB"}

package/dist/parse/zip-reader.js

@@ -0,0 +1,45 @@
+import * as fs from 'node:fs';
+import { unzipSync, strFromU8 } from 'fflate';
+/**
+ * Reads entries from a Playwright trace ZIP file.
+ * Uses fflate (pure JS) for zero-dependency ZIP extraction.
+ */
+export class ZipReader {
+    entries;
+    constructor(entries) {
+        this.entries = entries;
+    }
+    /** Open a zip file and extract all entries into memory */
+    static open(zipPath) {
+        const data = fs.readFileSync(zipPath);
+        const entries = unzipSync(new Uint8Array(data));
+        return new ZipReader(entries);
+    }
+    /** Get all entry names in the zip */
+    entryNames() {
+        return Object.keys(this.entries);
+    }
+    /** Read an entry as UTF-8 text */
+    readText(name) {
+        const entry = this.entries[name];
+        if (!entry)
+            throw new Error(`Entry not found in zip: ${name}`);
+        return strFromU8(entry);
+    }
+    /** Read an entry as raw binary buffer */
+    readBinary(name) {
+        const entry = this.entries[name];
+        if (!entry)
+            throw new Error(`Entry not found in zip: ${name}`);
+        return Buffer.from(entry);
+    }
+    /** Check if an entry exists */
+    has(name) {
+        return name in this.entries;
+    }
+    /** Release memory */
+    dispose() {
+        this.entries = {};
+    }
+}
+//# sourceMappingURL=zip-reader.js.map

package/dist/parse/zip-reader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zip-reader.js","sourceRoot":"","sources":["../../src/parse/zip-reader.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,SAAS,CAAA;AAC7B,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAA;AAE7C;;;GAGG;AACH,MAAM,OAAO,SAAS;IACZ,OAAO,CAA4B;IAE3C,YAAoB,OAAmC;QACrD,IAAI,CAAC,OAAO,GAAG,OAAO,CAAA;IACxB,CAAC;IAED,0DAA0D;IAC1D,MAAM,CAAC,IAAI,CAAC,OAAe;QACzB,MAAM,IAAI,GAAG,EAAE,CAAC,YAAY,CAAC,OAAO,CAAC,CAAA;QACrC,MAAM,OAAO,GAAG,SAAS,CAAC,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC,CAAA;QAC/C,OAAO,IAAI,SAAS,CAAC,OAAO,CAAC,CAAA;IAC/B,CAAC;IAED,qCAAqC;IACrC,UAAU;QACR,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IAClC,CAAC;IAED,kCAAkC;IAClC,QAAQ,CAAC,IAAY;QACnB,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;QAChC,IAAI,CAAC,KAAK;YAAE,MAAM,IAAI,KAAK,CAAC,2BAA2B,IAAI,EAAE,CAAC,CAAA;QAC9D,OAAO,SAAS,CAAC,KAAK,CAAC,CAAA;IACzB,CAAC;IAED,yCAAyC;IACzC,UAAU,CAAC,IAAY;QACrB,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;QAChC,IAAI,CAAC,KAAK;YAAE,MAAM,IAAI,KAAK,CAAC,2BAA2B,IAAI,EAAE,CAAC,CAAA;QAC9D,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IAC3B,CAAC;IAED,+BAA+B;IAC/B,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,IAAI,IAAI,CAAC,OAAO,CAAA;IAC7B,CAAC;IAED,qBAAqB;IACrB,OAAO;QACL,IAAI,CAAC,OAAO,GAAG,EAAE,CAAA;IACnB,CAAC;CACF"}

package/dist/pipeline/executor.d.ts

@@ -0,0 +1,16 @@
+import type { StageDescriptor } from './stages';
+/**
+ * Executes a pipeline by walking through stages sequentially.
+ * Each stage transforms the state into the next type in the chain.
+ */
+export declare class PipelineExecutor {
+    private readonly source;
+    private readonly stages;
+    constructor(source: string, stages: readonly StageDescriptor[]);
+    execute(outputPath: string): Promise<void>;
+    executeToBuffer(): Promise<Buffer>;
+    private runStages;
+    private findTraceZip;
+    private findSourceVideo;
+}
+//# sourceMappingURL=executor.d.ts.map

package/dist/pipeline/executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../src/pipeline/executor.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAA;AAyB/C;;;GAGG;AACH,qBAAa,gBAAgB;IAEzB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM;gBADN,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,SAAS,eAAe,EAAE;IAG/C,OAAO,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA8D1C,eAAe,IAAI,OAAO,CAAC,MAAM,CAAC;YAQ1B,SAAS;IA6KvB,OAAO,CAAC,YAAY;IAuBpB,OAAO,CAAC,eAAe;CAwBxB"}

package/dist/pipeline/executor.js

@@ -0,0 +1,283 @@
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { parseTrace } from '../parse/trace-parser';
+import { filterSteps } from '../filter/step-filter';
+import { processSpeed } from '../speed/speed-processor';
+import { generateSubtitles } from '../subtitles/subtitle-generator';
+import { parseSrt } from '../subtitles/srt-parser';
+import { generateVoiceover } from '../voiceover/voiceover-processor';
+import { renderVideo } from '../render/renderer';
+import { writeSrt } from '../subtitles/srt-writer';
+import { writeVtt } from '../subtitles/vtt-writer';
+import { assertFfmpegAvailable } from '../utils/ffmpeg';
+/**
+ * Executes a pipeline by walking through stages sequentially.
+ * Each stage transforms the state into the next type in the chain.
+ */
+export class PipelineExecutor {
+    source;
+    stages;
+    constructor(source, stages) {
+        this.source = source;
+        this.stages = stages;
+    }
+    async execute(outputPath) {
+        assertFfmpegAvailable();
+        const state = await this.runStages();
+        const outputDir = path.dirname(outputPath);
+        const tmpDir = path.join(outputDir, '.recast-tmp');
+        fs.mkdirSync(tmpDir, { recursive: true });
+        fs.mkdirSync(outputDir, { recursive: true });
+        // Find the render config
+        const renderStage = this.stages.find((s) => s.type === 'render');
+        const renderConfig = renderStage?.type === 'render' ? renderStage.config : {};
+        // Determine the most advanced state for rendering
+        const renderableTrace = state.voiceovered ?? state.subtitled ?? state.speedMapped ?? state.filtered ?? state.parsed;
+        if (!renderableTrace) {
+            throw new Error('Pipeline has no data to render. Did you call .parse()?');
+        }
+        // Build the renderable trace with source video and optional subtitle/voiceover fields
+        const traceWithVideo = {
+            ...renderableTrace,
+            sourceVideoPath: state.sourceVideoPath,
+            subtitles: state.subtitled?.subtitles,
+            voiceover: state.voiceovered?.voiceover,
+        };
+        // Render final video
+        renderVideo(traceWithVideo, renderConfig, outputPath, tmpDir);
+        // Write subtitle files next to the output
+        if (state.subtitled) {
+            const baseName = path.basename(outputPath, path.extname(outputPath));
+            const srtPath = path.join(outputDir, `${baseName}.srt`);
+            const vttPath = path.join(outputDir, `${baseName}.vtt`);
+            fs.writeFileSync(srtPath, writeSrt(state.subtitled.subtitles));
+            fs.writeFileSync(vttPath, writeVtt(state.subtitled.subtitles));
+        }
+        // Write report.json
+        if (state.parsed) {
+            const reportPath = path.join(outputDir, 'report.json');
+            const report = {
+                scenario: 'playwright-recast output',
+                sourceVideo: state.sourceVideoPath,
+                actionsCount: state.parsed.actions.length,
+                framesCount: state.parsed.frames.length,
+                resourcesCount: state.parsed.resources.length,
+                subtitlesCount: state.subtitled?.subtitles.length ?? 0,
+                voiceoverSegments: state.voiceovered?.voiceover.entries.length ?? 0,
+                outputFile: path.basename(outputPath),
+            };
+            fs.writeFileSync(reportPath, JSON.stringify(report, null, 2) + '\n');
+        }
+        // Cleanup
+        fs.rmSync(tmpDir, { recursive: true, force: true });
+        // Dispose frame reader
+        state.parsed?.frameReader.dispose();
+    }
+    async executeToBuffer() {
+        const tmpOutput = path.join('/tmp', `recast-${Date.now()}.mp4`);
+        await this.execute(tmpOutput);
+        const buffer = fs.readFileSync(tmpOutput);
+        fs.unlinkSync(tmpOutput);
+        return buffer;
+    }
+    async runStages() {
+        const state = {};
+        // Find source video in the trace directory
+        state.sourceVideoPath = this.findSourceVideo();
+        for (const stage of this.stages) {
+            switch (stage.type) {
+                case 'parse': {
+                    const tracePath = this.findTraceZip();
+                    state.parsed = await parseTrace(tracePath);
+                    // Default filter (no-op) for downstream stages
+                    state.filtered = {
+                        ...state.parsed,
+                        originalActions: state.parsed.actions,
+                        hiddenRanges: [],
+                    };
+                    break;
+                }
+                case 'hideSteps': {
+                    if (!state.parsed)
+                        throw new Error('hideSteps() requires parse() first');
+                    state.filtered = filterSteps(state.parsed, stage.predicate);
+                    break;
+                }
+                case 'speedUp': {
+                    if (!state.filtered)
+                        throw new Error('speedUp() requires parse() first');
+                    state.speedMapped = processSpeed(state.filtered, stage.config);
+                    break;
+                }
+                case 'subtitles': {
+                    // If no speed processing, create a pass-through speed map
+                    if (!state.speedMapped && state.filtered) {
+                        state.speedMapped = {
+                            ...state.filtered,
+                            speedSegments: [],
+                            timeRemap: (t) => t,
+                            outputDuration: state.filtered.metadata.endTime - state.filtered.metadata.startTime,
+                        };
+                    }
+                    if (!state.speedMapped)
+                        throw new Error('subtitles() requires parse() first');
+                    state.subtitled = generateSubtitles(state.speedMapped, stage.textFn, stage.options);
+                    break;
+                }
+                case 'subtitlesFromSrt': {
+                    // Load subtitles directly from an existing SRT file
+                    const srtContent = fs.readFileSync(stage.srtPath, 'utf-8');
+                    const subtitles = parseSrt(srtContent);
+                    // Promote to SubtitledTrace, filling in any missing intermediate fields
+                    const srtBase = state.speedMapped ?? state.filtered ?? state.parsed;
+                    if (!srtBase)
+                        throw new Error('subtitlesFromSrt() requires parse() first');
+                    const asFiltered = 'originalActions' in srtBase
+                        ? srtBase
+                        : { ...srtBase, originalActions: srtBase.actions, hiddenRanges: [] };
+                    const asSpeedMapped = 'speedSegments' in srtBase
+                        ? srtBase
+                        : { ...asFiltered, speedSegments: [], timeRemap: (t) => t, outputDuration: 0 };
+                    state.subtitled = { ...asSpeedMapped, subtitles };
+                    break;
+                }
+                case 'subtitlesFromTrace': {
+                    // Generate subtitles from BDD step titles extracted from the parsed trace actions.
+                    // Uses action.text (BDD step text) or falls back to action.title.
+                    const traceBase = state.speedMapped ?? state.filtered ?? state.parsed;
+                    if (!traceBase)
+                        throw new Error('subtitlesFromTrace() requires parse() first');
+                    // Ensure we have a SpeedMappedTrace (create pass-through if missing)
+                    let speedMapped;
+                    if (state.speedMapped) {
+                        speedMapped = state.speedMapped;
+                    }
+                    else {
+                        const filtered = state.filtered ?? {
+                            ...state.parsed,
+                            originalActions: state.parsed.actions,
+                            hiddenRanges: [],
+                        };
+                        speedMapped = {
+                            ...filtered,
+                            speedSegments: [],
+                            timeRemap: (t) => t,
+                            outputDuration: filtered.metadata.endTime - filtered.metadata.startTime,
+                        };
+                    }
+                    // Extract BDD step text from trace actions
+                    const defaultTextFn = (action) => action.text ?? (action.keyword ? `${action.keyword} ${action.title}` : undefined);
+                    state.subtitled = generateSubtitles(speedMapped, defaultTextFn, stage.options);
+                    break;
+                }
+                case 'enrichZoomFromReport': {
+                    if (!state.subtitled)
+                        throw new Error('enrichZoomFromReport() requires subtitles() first');
+                    const reportSteps = stage.steps;
+                    for (let i = 0; i < Math.min(state.subtitled.subtitles.length, reportSteps.length); i++) {
+                        const z = reportSteps[i]?.zoom;
+                        if (z) {
+                            state.subtitled.subtitles[i].zoom = { x: z.x, y: z.y, level: z.level };
+                        }
+                    }
+                    break;
+                }
+                case 'autoZoom': {
+                    if (!state.subtitled)
+                        throw new Error('autoZoom() requires subtitles() first');
+                    if (!state.parsed)
+                        throw new Error('autoZoom() requires parse() first');
+                    const actionLevel = stage.config.actionLevel ?? 1.5;
+                    const viewport = state.parsed.metadata.viewport;
+                    // Use the first screencast frame timestamp as video t=0.
+                    // This is the most reliable clock reference for the recording context.
+                    const firstFrameTime = state.parsed.frames.length > 0
+                        ? state.parsed.frames[0].timestamp
+                        : state.parsed.metadata.startTime;
+                    // Find click/fill actions and compute their video-relative time
+                    const USER_METHODS = new Set(['click', 'fill', 'type', 'press', 'selectOption']);
+                    const clickActions = state.parsed.actions
+                        .filter((a) => USER_METHODS.has(a.method))
+                        .map((a) => ({
+                        action: a,
+                        videoTimeSec: (a.startTime - firstFrameTime) / 1000,
+                        point: a.point,
+                    }))
+                        .filter((a) => a.videoTimeSec >= 0);
+                    for (const subtitle of state.subtitled.subtitles) {
+                        const subStartSec = subtitle.startMs / 1000;
+                        const subEndSec = subtitle.endMs / 1000;
+                        // Find actions with cursor points that fall within this subtitle
+                        const matching = clickActions.filter((a) => a.videoTimeSec >= subStartSec - 1 && a.videoTimeSec <= subEndSec + 1 && a.point);
+                        if (matching.length > 0) {
+                            const best = matching[0];
+                            subtitle.zoom = {
+                                x: best.point.x / viewport.width,
+                                y: best.point.y / viewport.height,
+                                level: actionLevel,
+                            };
+                        }
+                    }
+                    break;
+                }
+                case 'voiceover': {
+                    if (!state.subtitled)
+                        throw new Error('voiceover() requires subtitles() first');
+                    const tmpDir = path.join(path.dirname(state.sourceVideoPath ?? '/tmp'), '.recast-vo-tmp');
+                    state.voiceovered = await generateVoiceover(state.subtitled, stage.provider, tmpDir);
+                    break;
+                }
+                case 'render':
+                    // Config is read during execute(), not here
+                    break;
+            }
+        }
+        return state;
+    }
+    findTraceZip() {
+        // Check if source is a zip file directly
+        if (this.source.endsWith('.zip') && fs.existsSync(this.source)) {
+            return this.source;
+        }
+        // Search in directory for trace.zip
+        if (fs.existsSync(this.source) && fs.statSync(this.source).isDirectory()) {
+            const traceZip = path.join(this.source, 'trace.zip');
+            if (fs.existsSync(traceZip))
+                return traceZip;
+            // Search subdirectories
+            for (const entry of fs.readdirSync(this.source, { withFileTypes: true })) {
+                if (entry.isDirectory()) {
+                    const subTrace = path.join(this.source, entry.name, 'trace.zip');
+                    if (fs.existsSync(subTrace))
+                        return subTrace;
+                }
+            }
+        }
+        throw new Error(`No trace.zip found at: ${this.source}`);
+    }
+    findSourceVideo() {
+        const dir = this.source.endsWith('.zip')
+            ? path.dirname(this.source)
+            : this.source;
+        if (!fs.existsSync(dir) || !fs.statSync(dir).isDirectory())
+            return undefined;
+        // Search for .webm files
+        const searchDir = (d) => {
+            for (const file of fs.readdirSync(d)) {
+                if (file.endsWith('.webm'))
+                    return path.join(d, file);
+            }
+            // Check subdirectories
+            for (const entry of fs.readdirSync(d, { withFileTypes: true })) {
+                if (entry.isDirectory() && !entry.name.startsWith('.')) {
+                    const found = searchDir(path.join(d, entry.name));
+                    if (found)
+                        return found;
+                }
+            }
+            return undefined;
+        };
+        return searchDir(dir);
+    }
+}
+//# sourceMappingURL=executor.js.map