screenwright 0.1.44 → 0.2.0

package/dist/src/runtime/instrumented-page.d.ts

@@ -1,5 +1,6 @@
 import type { Timeline } from '../timeline/types.js';
 import { type ScreenwrightHelpers } from './action-helpers.js';
+import type { PregeneratedNarration } from './narration-preprocess.js';
 export type ScenarioFn = (sw: ScreenwrightHelpers) => Promise<void>;
 export interface RunOptions {
     scenarioFile: string;
@@ -11,12 +12,12 @@ export interface RunOptions {
     colorScheme?: 'light' | 'dark';
     locale?: string;
     timezoneId?: string;
-    captureMode?: 'frames' | 'video';
+    pregenerated?: PregeneratedNarration[];
 }
 export interface RunResult {
     timeline: Timeline;
-    videoFile?: string;
     tempDir: string;
+    narrationCount: number;
 }
 export declare function runScenario(scenario: ScenarioFn, opts: RunOptions): Promise<RunResult>;
 //# sourceMappingURL=instrumented-page.d.ts.map

package/dist/src/runtime/instrumented-page.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"instrumented-page.d.ts","sourceRoot":"","sources":["../../../src/runtime/instrumented-page.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,QAAQ,EAAc,MAAM,sBAAsB,CAAC;AAEjE,OAAO,EAAiB,KAAK,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAE9E,MAAM,MAAM,UAAU,GAAG,CAAC,EAAE,EAAE,mBAAmB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAEpE,MAAM,WAAW,UAAU;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7C,WAAW,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC;CAClC;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,QAAQ,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAsB,WAAW,CAAC,QAAQ,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC,CAkK5F"}
+{"version":3,"file":"instrumented-page.d.ts","sourceRoot":"","sources":["../../../src/runtime/instrumented-page.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,QAAQ,EAAmC,MAAM,sBAAsB,CAAC;AAEtF,OAAO,EAAiB,KAAK,mBAAmB,EAAyB,MAAM,qBAAqB,CAAC;AACrG,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAEvE,MAAM,MAAM,UAAU,GAAG,CAAC,EAAE,EAAE,mBAAmB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAEpE,MAAM,WAAW,UAAU;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7C,WAAW,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,qBAAqB,EAAE,CAAC;CACxC;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,QAAQ,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;CACxB;AASD,wBAAsB,WAAW,CAAC,QAAQ,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC,CAkK5F"}

package/dist/src/runtime/instrumented-page.js

@@ -4,25 +4,26 @@ import { tmpdir } from 'node:os';
 import { join } from 'node:path';
 import { TimelineCollector } from './timeline-collector.js';
 import { createHelpers } from './action-helpers.js';
+const FRAME_INTERVAL_MS = 1000 / 30;
+const DPR = 2;
+function sleep(ms) {
+    return new Promise(r => setTimeout(r, Math.max(0, ms)));
+}
 export async function runScenario(scenario, opts) {
     const viewport = opts.viewport ?? { width: 1280, height: 720 };
-    const DPR = 2;
     const tempDir = await mkdtemp(join(tmpdir(), 'screenwright-'));
-    const captureMode = opts.captureMode ?? 'frames';
+    const framesDir = join(tempDir, 'frames');
+    await mkdir(framesDir, { recursive: true });
     const browser = await chromium.launch({
         args: ['--disable-gpu', '--font-render-hinting=none', '--disable-lcd-text'],
     });
-    const contextOpts = {
+    const context = await browser.newContext({
         viewport,
         deviceScaleFactor: DPR,
         colorScheme: opts.colorScheme ?? 'light',
         locale: opts.locale ?? 'en-US',
         timezoneId: opts.timezoneId ?? 'America/New_York',
-    };
-    if (captureMode === 'video') {
-        contextOpts.recordVideo = { dir: tempDir, size: viewport };
-    }
-    const context = await browser.newContext(contextOpts);
+    });
     // Hide the native cursor so only the Screenwright overlay cursor appears
     await context.addInitScript(`
     const s = document.createElement('style');
@@ -31,119 +32,122 @@ export async function runScenario(scenario, opts) {
   `);
     const page = await context.newPage();
     const collector = new TimelineCollector();
-    let frameManifest;
-    let cdpSession;
-    let frameCounter = 0;
-    let capturing = false;
+    const manifest = [];
+    const transitionMarkers = [];
+    // Narration queue from pre-generated audio
+    const narrationQueue = opts.pregenerated ? [...opts.pregenerated] : [];
+    let narrationConsumed = 0;
+    // Virtual clock: each frame = exactly 1000/30 ms
+    let virtualFrameIndex = 0;
+    let frameFileCounter = 0;
+    // Capture loop state
+    let captureRunning = false;
     let pendingScreenshot = Promise.resolve();
-    let captureSnapshot;
-    if (captureMode === 'frames') {
-        const framesDir = join(tempDir, 'frames');
-        const snapshotsDir = join(tempDir, 'snapshots');
-        await mkdir(framesDir, { recursive: true });
-        await mkdir(snapshotsDir, { recursive: true });
-        frameManifest = [];
-        let snapshotCounter = 0;
-        captureSnapshot = async () => {
-            snapshotCounter++;
-            const filename = `snapshot-${String(snapshotCounter).padStart(6, '0')}.jpg`;
-            await page.screenshot({ path: join(snapshotsDir, filename), type: 'jpeg', quality: 90 });
-            return `snapshots/${filename}`;
-        };
-        cdpSession = await context.newCDPSession(page);
-        // Hybrid approach: CDP screencast detects WHEN the page changes (high fps,
-        // low overhead). On each change we take a page.screenshot() which captures
-        // at the full deviceScaleFactor resolution (2×). The screencast pixel data
-        // itself is discarded — it only serves as a timing signal.
-        cdpSession.on('Page.screencastFrame', (params) => {
-            cdpSession.send('Page.screencastFrameAck', { sessionId: params.sessionId }).catch(() => { });
-            if (capturing)
-                return;
-            capturing = true;
-            const capturedAt = collector.elapsed();
-            pendingScreenshot = (async () => {
-                try {
-                    frameCounter++;
-                    const filename = `frame-${String(frameCounter).padStart(6, '0')}.jpg`;
-                    const filePath = join(framesDir, filename);
-                    await page.screenshot({ path: filePath, type: 'jpeg', quality: 90 });
-                    frameManifest.push({
-                        timestampMs: capturedAt,
-                        file: `frames/${filename}`,
-                    });
-                }
-                catch {
-                    // Page may not be ready or is closing
-                }
-                capturing = false;
-            })();
-        });
-    }
-    collector.start();
-    if (cdpSession) {
-        await cdpSession.send('Page.startScreencast', {
-            format: 'jpeg',
-            quality: 10,
-            maxWidth: viewport.width,
-            maxHeight: viewport.height,
-            everyNthFrame: 1,
-        });
-    }
-    const sw = createHelpers(page, collector, captureSnapshot ? { captureSnapshot } : undefined);
-    let videoFile;
-    try {
-        await scenario(sw);
-        // Stop screencast and flush pending captures
-        if (cdpSession) {
-            await page.waitForTimeout(100);
-            await cdpSession.send('Page.stopScreencast').catch(() => { });
-            await pendingScreenshot;
-            // Take one final 2× screenshot
+    async function runCaptureLoop() {
+        captureRunning = true;
+        while (captureRunning) {
+            const start = performance.now();
+            frameFileCounter++;
+            const filename = `frame-${String(frameFileCounter).padStart(6, '0')}.jpg`;
             try {
-                frameCounter++;
-                const filename = `frame-${String(frameCounter).padStart(6, '0')}.jpg`;
-                const filePath = join(join(tempDir, 'frames'), filename);
-                await page.screenshot({ path: filePath, type: 'jpeg', quality: 90 });
-                frameManifest.push({
-                    timestampMs: collector.elapsed(),
-                    file: `frames/${filename}`,
-                });
+                await page.screenshot({ path: join(framesDir, filename), type: 'jpeg', quality: 90 });
+                manifest.push({ type: 'frame', file: `frames/${filename}` });
+                virtualFrameIndex++;
             }
             catch {
-                // Page may already be closing
+                // Page may not be ready or is closing
             }
-            await cdpSession.detach().catch(() => { });
+            const elapsed = performance.now() - start;
+            await sleep(FRAME_INTERVAL_MS - elapsed);
+        }
+    }
+    async function pauseCapture() {
+        captureRunning = false;
+        await pendingScreenshot;
+    }
+    function resumeCapture() {
+        if (!captureRunning) {
+            pendingScreenshot = runCaptureLoop();
+        }
+    }
+    async function captureOneFrame() {
+        frameFileCounter++;
+        const filename = `frame-${String(frameFileCounter).padStart(6, '0')}.jpg`;
+        await page.screenshot({ path: join(framesDir, filename), type: 'jpeg', quality: 90 });
+        const file = `frames/${filename}`;
+        manifest.push({ type: 'frame', file });
+        virtualFrameIndex++;
+        return file;
+    }
+    function addHold(file, count) {
+        if (count <= 0)
+            return;
+        manifest.push({ type: 'hold', file, count });
+        virtualFrameIndex += count;
+    }
+    function addTransitionMarker(marker) {
+        transitionMarkers.push(marker);
+    }
+    function popNarration() {
+        if (narrationQueue.length === 0) {
+            throw new Error('No pre-generated narrations remaining in queue');
+        }
+        narrationConsumed++;
+        return narrationQueue.shift();
+    }
+    function currentTimeMs() {
+        return virtualFrameIndex * FRAME_INTERVAL_MS;
+    }
+    const ctx = {
+        pauseCapture,
+        resumeCapture,
+        captureOneFrame,
+        addHold,
+        addTransitionMarker,
+        popNarration,
+        currentTimeMs,
+        get manifest() { return manifest; },
+        transitionPending: false,
+        get narrationCount() { return narrationConsumed; },
+    };
+    // Expose transitionMarkers for the back-to-back transition warning hack
+    ctx._transitionMarkers = transitionMarkers;
+    const sw = createHelpers(page, collector, ctx);
+    try {
+        // Start capture loop
+        resumeCapture();
+        await scenario(sw);
+        // Stop capture loop and flush
+        await pauseCapture();
+        // Take one final frame
+        try {
+            await captureOneFrame();
+        }
+        catch {
+            // Page may already be closing
         }
-        // Close page to finalize video
-        await page.close();
-        if (captureMode === 'video') {
-            const video = page.video();
-            videoFile = video ? await video.path() : undefined;
+        // Warn about trailing transition
+        if (ctx.transitionPending) {
+            console.warn('sw.transition() at end of scenario with no following content — discarding marker.');
+            transitionMarkers.pop();
+            ctx.transitionPending = false;
         }
     }
     finally {
-        // Ensure browser resources are always cleaned up (idempotent if already closed)
         await page.close().catch(() => { });
         await context.close().catch(() => { });
         await browser.close().catch(() => { });
     }
-    const videoDurationMs = collector.getEvents()
-        .filter(e => e.type !== 'transition')
-        .reduce((max, e) => {
-        const ts = e.timestampMs + ('durationMs' in e ? (e.durationMs ?? 0) : 0);
-        return Math.max(max, ts);
-    }, 0);
     const timeline = collector.finalize({
         testFile: opts.testFile,
         scenarioFile: opts.scenarioFile,
         recordedAt: new Date().toISOString(),
         viewport,
-        videoDurationMs,
-        videoFile,
-        frameManifest,
+        frameManifest: manifest,
+        transitionMarkers,
     });
     const timelinePath = join(tempDir, 'timeline.json');
     await writeFile(timelinePath, JSON.stringify(timeline, null, 2));
-    return { timeline, videoFile, tempDir };
+    return { timeline, tempDir, narrationCount: narrationConsumed };
 }
 //# sourceMappingURL=instrumented-page.js.map

package/dist/src/runtime/instrumented-page.js.map

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

package/dist/src/runtime/narration-preprocess.d.ts

@@ -0,0 +1,30 @@
+import type { ScreenwrightHelpers } from './action-helpers.js';
+import type { OpenaiVoice } from '../config/config-schema.js';
+export type ScenarioFn = (sw: ScreenwrightHelpers) => Promise<void>;
+export interface PregeneratedNarration {
+    text: string;
+    audioFile: string;
+    durationMs: number;
+}
+export interface PreprocessOptions {
+    tempDir: string;
+    ttsProvider?: 'piper' | 'openai';
+    modelPath?: string;
+    openaiVoice?: OpenaiVoice;
+    openaiTtsInstructions?: string;
+}
+/**
+ * Run the scenario with a stub sw that collects narration texts in order.
+ * All page interactions are no-ops.
+ */
+export declare function extractNarrations(scenarioFn: ScenarioFn): Promise<string[]>;
+/**
+ * Pre-generate all narration audio files in parallel.
+ */
+export declare function pregenerateNarrations(texts: string[], opts: PreprocessOptions): Promise<PregeneratedNarration[]>;
+/**
+ * Validate that the number of narrations consumed during recording matches
+ * the number pre-generated during preprocessing.
+ */
+export declare function validateNarrationCount(pregenerated: number, consumed: number): void;
+//# sourceMappingURL=narration-preprocess.d.ts.map

package/dist/src/runtime/narration-preprocess.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"narration-preprocess.d.ts","sourceRoot":"","sources":["../../../src/runtime/narration-preprocess.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAG/D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAE9D,MAAM,MAAM,UAAU,GAAG,CAAC,EAAE,EAAE,mBAAmB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAEpE,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC;AA0BD;;;GAGG;AACH,wBAAsB,iBAAiB,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAgBjF;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,MAAM,EAAE,EACf,IAAI,EAAE,iBAAiB,GACtB,OAAO,CAAC,qBAAqB,EAAE,CAAC,CAWlC;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAOnF"}

package/dist/src/runtime/narration-preprocess.js

@@ -0,0 +1,79 @@
+import { join } from 'node:path';
+import { synthesize as piperSynthesize } from '../voiceover/piper-engine.js';
+import { synthesize as openaiSynthesize } from '../voiceover/openai-engine.js';
+/**
+ * Recursive proxy that returns async no-ops for any property/method access.
+ * Handles arbitrary page.evaluate(), page.waitForSelector(), etc.
+ */
+function noopPageProxy() {
+    const handler = {
+        get(_target, prop) {
+            // Prevent infinite thenable loop: await checks .then, which must be
+            // undefined so the proxy isn't treated as a thenable.
+            if (prop === 'then')
+                return undefined;
+            return new Proxy(function () { }, {
+                apply() {
+                    return Promise.resolve(new Proxy({}, handler));
+                },
+                get(_t, p) {
+                    if (p === 'then')
+                        return undefined;
+                    return new Proxy(function () { }, this);
+                },
+            });
+        },
+    };
+    return new Proxy({}, handler);
+}
+/**
+ * Run the scenario with a stub sw that collects narration texts in order.
+ * All page interactions are no-ops.
+ */
+export async function extractNarrations(scenarioFn) {
+    const narrations = [];
+    const stub = {
+        page: noopPageProxy(),
+        navigate: async (_url, opts) => { if (opts?.narration)
+            narrations.push(opts.narration); },
+        click: async (_sel, opts) => { if (opts?.narration)
+            narrations.push(opts.narration); },
+        fill: async (_sel, _v, opts) => { if (opts?.narration)
+            narrations.push(opts.narration); },
+        hover: async (_sel, opts) => { if (opts?.narration)
+            narrations.push(opts.narration); },
+        press: async (_key, opts) => { if (opts?.narration)
+            narrations.push(opts.narration); },
+        wait: async () => { },
+        narrate: async (text) => { narrations.push(text); },
+        scene: async () => { },
+        transition: async () => { },
+    };
+    await scenarioFn(stub);
+    return narrations;
+}
+/**
+ * Pre-generate all narration audio files in parallel.
+ */
+export async function pregenerateNarrations(texts, opts) {
+    const provider = opts.ttsProvider ?? 'piper';
+    const ext = provider === 'openai' ? '.mp3' : '.wav';
+    return Promise.all(texts.map(async (text, i) => {
+        const outputPath = join(opts.tempDir, `narration-${i}${ext}`);
+        const result = provider === 'openai'
+            ? await openaiSynthesize(text, outputPath, opts.openaiVoice, opts.openaiTtsInstructions)
+            : await piperSynthesize(text, outputPath, opts.modelPath);
+        return { text, audioFile: result.audioPath, durationMs: result.durationMs };
+    }));
+}
+/**
+ * Validate that the number of narrations consumed during recording matches
+ * the number pre-generated during preprocessing.
+ */
+export function validateNarrationCount(pregenerated, consumed) {
+    if (pregenerated !== consumed) {
+        throw new Error(`Scenario produced ${pregenerated} narrations during preprocessing but ${consumed} during recording. ` +
+            `Conditional narration is not supported.`);
+    }
+}
+//# sourceMappingURL=narration-preprocess.js.map

package/dist/src/runtime/narration-preprocess.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"narration-preprocess.js","sourceRoot":"","sources":["../../../src/runtime/narration-preprocess.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,UAAU,IAAI,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC7E,OAAO,EAAE,UAAU,IAAI,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAmB/E;;;GAGG;AACH,SAAS,aAAa;IACpB,MAAM,OAAO,GAAyB;QACpC,GAAG,CAAC,OAAO,EAAE,IAAI;YACf,oEAAoE;YACpE,sDAAsD;YACtD,IAAI,IAAI,KAAK,MAAM;gBAAE,OAAO,SAAS,CAAC;YACtC,OAAO,IAAI,KAAK,CAAC,cAAa,CAAC,EAAE;gBAC/B,KAAK;oBACH,OAAO,OAAO,CAAC,OAAO,CAAC,IAAI,KAAK,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC,CAAC;gBACjD,CAAC;gBACD,GAAG,CAAC,EAAE,EAAE,CAAC;oBACP,IAAI,CAAC,KAAK,MAAM;wBAAE,OAAO,SAAS,CAAC;oBACnC,OAAO,IAAI,KAAK,CAAC,cAAa,CAAC,EAAE,IAA4B,CAAC,CAAC;gBACjE,CAAC;aACF,CAAC,CAAC;QACL,CAAC;KACF,CAAC;IACF,OAAO,IAAI,KAAK,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;AAChC,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,UAAsB;IAC5D,MAAM,UAAU,GAAa,EAAE,CAAC;IAChC,MAAM,IAAI,GAAwB;QAChC,IAAI,EAAE,aAAa,EAAE;QACrB,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,IAAK,EAAE,EAAE,GAAG,IAAI,IAAI,EAAE,SAAS;YAAE,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;QAC1F,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,IAAK,EAAE,EAAE,GAAG,IAAI,IAAI,EAAE,SAAS;YAAE,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;QACvF,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,EAAE,IAAK,EAAE,EAAE,GAAG,IAAI,IAAI,EAAE,SAAS;YAAE,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;QAC1F,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,IAAK,EAAE,EAAE,GAAG,IAAI,IAAI,EAAE,SAAS;YAAE,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;QACvF,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,IAAK,EAAE,EAAE,GAAG,IAAI,IAAI,EAAE,SAAS;YAAE,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;QACvF,IAAI,EAAE,KAAK,IAAI,EAAE,GAAE,CAAC;QACpB,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,GAAG,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACnD,KAAK,EAAE,KAAK,IAAI,EAAE,GAAE,CAAC;QACrB,UAAU,EAAE,KAAK,IAAI,EAAE,GAAE,CAAC;KAC3B,CAAC;IACF,MAAM,UAAU,CAAC,IAAI,CAAC,CAAC;IACvB,OAAO,UAAU,CAAC;AACpB,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,KAAe,EACf,IAAuB;IAEvB,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,IAAI,OAAO,CAAC;IAC7C,MAAM,GAAG,GAAG,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC;IAEpD,OAAO,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,EAAE,EAAE;QAC7C,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,aAAa,CAAC,GAAG,GAAG,EAAE,CAAC,CAAC;QAC9D,MAAM,MAAM,GAAG,QAAQ,KAAK,QAAQ;YAClC,CAAC,CAAC,MAAM,gBAAgB,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,qBAAqB,CAAC;YACxF,CAAC,CAAC,MAAM,eAAe,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;QAC5D,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,UAAU,EAAE,MAAM,CAAC,UAAU,EAAE,CAAC;IAC9E,CAAC,CAAC,CAAC,CAAC;AACN,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CAAC,YAAoB,EAAE,QAAgB;IAC3E,IAAI,YAAY,KAAK,QAAQ,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CACb,qBAAqB,YAAY,wCAAwC,QAAQ,qBAAqB;YACtG,yCAAyC,CAC1C,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/src/runtime/timeline-collector.d.ts

@@ -2,18 +2,12 @@ import type { Timeline, TimelineMetadata, TimelineEvent } from '../timeline/type
 type PartialEvent = {
     type: string;
     id?: string;
-    timestampMs?: number;
+    timestampMs: number;
     [key: string]: unknown;
 };
 export declare class TimelineCollector {
     private events;
     private counter;
-    private startTime;
-    private excludedMs;
-    start(): void;
-    elapsed(): number;
-    /** Subtract wall-clock time that shouldn't count as scenario time (e.g. screenshot I/O). */
-    excludeTime(ms: number): void;
     nextId(): string;
     emit(event: PartialEvent): string;
     getEvents(): readonly TimelineEvent[];

package/dist/src/runtime/timeline-collector.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"timeline-collector.d.ts","sourceRoot":"","sources":["../../../src/runtime/timeline-collector.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAGtF,KAAK,YAAY,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,CAAC;AAEhG,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,OAAO,CAAK;IACpB,OAAO,CAAC,SAAS,CAAuB;IACxC,OAAO,CAAC,UAAU,CAAK;IAEvB,KAAK,IAAI,IAAI;IAIb,OAAO,IAAI,MAAM;IAKjB,4FAA4F;IAC5F,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAI7B,MAAM,IAAI,MAAM;IAIhB,IAAI,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM;IAQjC,SAAS,IAAI,SAAS,aAAa,EAAE;IAIrC,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,GAAG,QAAQ;CAc/C"}
+{"version":3,"file":"timeline-collector.d.ts","sourceRoot":"","sources":["../../../src/runtime/timeline-collector.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAGtF,KAAK,YAAY,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,CAAC;AAE/F,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,OAAO,CAAK;IAEpB,MAAM,IAAI,MAAM;IAIhB,IAAI,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM;IAOjC,SAAS,IAAI,SAAS,aAAa,EAAE;IAIrC,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,GAAG,QAAQ;CAc/C"}

package/dist/src/runtime/timeline-collector.js

@@ -2,27 +2,12 @@ import { timelineSchema } from '../timeline/schema.js';
 export class TimelineCollector {
     events = [];
     counter = 0;
-    startTime = null;
-    excludedMs = 0;
-    start() {
-        this.startTime = performance.now();
-    }
-    elapsed() {
-        if (this.startTime === null)
-            throw new Error('TimelineCollector not started');
-        return Math.round(performance.now() - this.startTime - this.excludedMs);
-    }
-    /** Subtract wall-clock time that shouldn't count as scenario time (e.g. screenshot I/O). */
-    excludeTime(ms) {
-        this.excludedMs += ms;
-    }
     nextId() {
         return `ev-${String(++this.counter).padStart(3, '0')}`;
     }
     emit(event) {
         const id = event.id ?? this.nextId();
-        const timestampMs = event.timestampMs ?? this.elapsed();
-        const full = { ...event, id, timestampMs };
+        const full = { ...event, id };
         this.events.push(full);
         return id;
     }
@@ -31,7 +16,7 @@ export class TimelineCollector {
     }
     finalize(metadata) {
         const timeline = {
-            version: 1,
+            version: 2,
             metadata,
             events: [...this.events],
         };

package/dist/src/runtime/timeline-collector.js.map

@@ -1 +1 @@
-{"version":3,"file":"timeline-collector.js","sourceRoot":"","sources":["../../../src/runtime/timeline-collector.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAIvD,MAAM,OAAO,iBAAiB;IACpB,MAAM,GAAoB,EAAE,CAAC;IAC7B,OAAO,GAAG,CAAC,CAAC;IACZ,SAAS,GAAkB,IAAI,CAAC;IAChC,UAAU,GAAG,CAAC,CAAC;IAEvB,KAAK;QACH,IAAI,CAAC,SAAS,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;IACrC,CAAC;IAED,OAAO;QACL,IAAI,IAAI,CAAC,SAAS,KAAK,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;QAC9E,OAAO,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC;IAC1E,CAAC;IAED,4FAA4F;IAC5F,WAAW,CAAC,EAAU;QACpB,IAAI,CAAC,UAAU,IAAI,EAAE,CAAC;IACxB,CAAC;IAED,MAAM;QACJ,OAAO,MAAM,MAAM,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;IACzD,CAAC;IAED,IAAI,CAAC,KAAmB;QACtB,MAAM,EAAE,GAAG,KAAK,CAAC,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;QACrC,MAAM,WAAW,GAAG,KAAK,CAAC,WAAW,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;QACxD,MAAM,IAAI,GAAG,EAAE,GAAG,KAAK,EAAE,EAAE,EAAE,WAAW,EAAmB,CAAC;QAC5D,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACvB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,SAAS;QACP,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,QAAQ,CAAC,QAA0B;QACjC,MAAM,QAAQ,GAAa;YACzB,OAAO,EAAE,CAAC;YACV,QAAQ;YACR,MAAM,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC;SACzB,CAAC;QAEF,MAAM,MAAM,GAAG,cAAc,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QAClD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CAAC,qBAAqB,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QAC/D,CAAC;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC;CACF"}
+{"version":3,"file":"timeline-collector.js","sourceRoot":"","sources":["../../../src/runtime/timeline-collector.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAIvD,MAAM,OAAO,iBAAiB;IACpB,MAAM,GAAoB,EAAE,CAAC;IAC7B,OAAO,GAAG,CAAC,CAAC;IAEpB,MAAM;QACJ,OAAO,MAAM,MAAM,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;IACzD,CAAC;IAED,IAAI,CAAC,KAAmB;QACtB,MAAM,EAAE,GAAG,KAAK,CAAC,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;QACrC,MAAM,IAAI,GAAG,EAAE,GAAG,KAAK,EAAE,EAAE,EAAmB,CAAC;QAC/C,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACvB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,SAAS;QACP,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,QAAQ,CAAC,QAA0B;QACjC,MAAM,QAAQ,GAAa;YACzB,OAAO,EAAE,CAAC;YACV,QAAQ;YACR,MAAM,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC;SACzB,CAAC;QAEF,MAAM,MAAM,GAAG,cAAc,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QAClD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CAAC,qBAAqB,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QAC/D,CAAC;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC;CACF"}