screenwright 0.1.45 → 0.2.1

package/dist/src/composition/frame-resolve.js.map

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

package/dist/src/composition/remotion-root.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"remotion-root.d.ts","sourceRoot":"","sources":["../../../src/composition/remotion-root.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAc1B,eAAO,MAAM,YAAY,EAAE,KAAK,CAAC,EA4ChC,CAAC"}
+{"version":3,"file":"remotion-root.d.ts","sourceRoot":"","sources":["../../../src/composition/remotion-root.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAa1B,eAAO,MAAM,YAAY,EAAE,KAAK,CAAC,EAwChC,CAAC"}

package/dist/src/composition/remotion-root.js

@@ -4,7 +4,7 @@ import { z } from 'zod';
 import { DemoVideo } from './DemoVideo.js';
 import { timelineSchema } from '../timeline/schema.js';
 import { brandingSchema } from '../config/config-schema.js';
-import { resolveSlideScenes, resolveTransitions, totalSlideDurationMs, totalTransitionDurationMs, msToFrames } from './time-remap.js';
+import { totalOutputFrames } from './frame-resolve.js';
 const propsSchema = z.object({
     timeline: timelineSchema,
     branding: brandingSchema.optional(),
@@ -12,29 +12,22 @@ const propsSchema = z.object({
 export const RemotionRoot = () => {
     return (_jsx(_Fragment, { children: _jsx(Composition, { id: "DemoVideo", lazyComponent: () => Promise.resolve({ default: DemoVideo }), schema: propsSchema, durationInFrames: 300, fps: 30, width: 1280, height: 720, defaultProps: {
                 timeline: {
-                    version: 1,
+                    version: 2,
                     metadata: {
                         testFile: '',
                         scenarioFile: '',
                         recordedAt: new Date().toISOString(),
                         viewport: { width: 1280, height: 720 },
-                        videoDurationMs: 0,
-                        videoFile: 'placeholder.webm',
+                        frameManifest: [{ type: 'frame', file: 'placeholder.jpg' }],
+                        transitionMarkers: [],
                     },
                     events: [],
                 },
             }, calculateMetadata: ({ props }) => {
-                const fps = 30;
-                const scenes = props.timeline.events.filter((e) => e.type === 'scene');
-                const slideScenes = resolveSlideScenes(scenes, props.timeline.events);
-                const resolvedTransitions = resolveTransitions(props.timeline.events);
-                const totalMs = props.timeline.metadata.videoDurationMs
-                    + totalSlideDurationMs(slideScenes)
-                    + totalTransitionDurationMs(resolvedTransitions);
-                const durationInFrames = Math.max(30, msToFrames(totalMs, fps));
+                const total = totalOutputFrames(props.timeline.metadata.frameManifest, props.timeline.metadata.transitionMarkers);
                 return {
-                    durationInFrames,
-                    fps,
+                    durationInFrames: Math.max(30, total),
+                    fps: 30,
                     width: props.timeline.metadata.viewport.width,
                     height: props.timeline.metadata.viewport.height,
                 };

package/dist/src/composition/remotion-root.js.map

@@ -1 +1 @@
-{"version":3,"file":"remotion-root.js","sourceRoot":"","sources":["../../../src/composition/remotion-root.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACrD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,yBAAyB,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAEtI,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3B,QAAQ,EAAE,cAAc;IACxB,QAAQ,EAAE,cAAc,CAAC,QAAQ,EAAE;CACpC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,YAAY,GAAa,GAAG,EAAE;IACzC,OAAO,CACL,4BACE,KAAC,WAAW,IACV,EAAE,EAAC,WAAW,EACd,aAAa,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,SAAgB,EAAE,CAAC,EACnE,MAAM,EAAE,WAAW,EACnB,gBAAgB,EAAE,GAAG,EACrB,GAAG,EAAE,EAAE,EACP,KAAK,EAAE,IAAI,EACX,MAAM,EAAE,GAAG,EACX,YAAY,EAAE;gBACZ,QAAQ,EAAE;oBACR,OAAO,EAAE,CAAU;oBACnB,QAAQ,EAAE;wBACR,QAAQ,EAAE,EAAE;wBACZ,YAAY,EAAE,EAAE;wBAChB,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;wBACpC,QAAQ,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE;wBACtC,eAAe,EAAE,CAAC;wBAClB,SAAS,EAAE,kBAAkB;qBAC9B;oBACD,MAAM,EAAE,EAAE;iBACX;aACF,EACD,iBAAiB,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE;gBAC/B,MAAM,GAAG,GAAG,EAAE,CAAC;gBACf,MAAM,MAAM,GAAG,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAmB,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC;gBACxF,MAAM,WAAW,GAAG,kBAAkB,CAAC,MAAM,EAAE,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;gBACtE,MAAM,mBAAmB,GAAG,kBAAkB,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;gBACtE,MAAM,OAAO,GAAG,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,eAAe;sBACnD,oBAAoB,CAAC,WAAW,CAAC;sBACjC,yBAAyB,CAAC,mBAAmB,CAAC,CAAC;gBACnD,MAAM,gBAAgB,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,UAAU,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC;gBAChE,OAAO;oBACL,gBAAgB;oBAChB,GAAG;oBACH,KAAK,EAAE,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,KAAK;oBAC7C,MAAM,EAAE,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM;iBAChD,CAAC;YACJ,CAAC,GACD,GACD,CACJ,CAAC;AACJ,CAAC,CAAC;AAEF,YAAY,CAAC,YAAY,CAAC,CAAC"}
+{"version":3,"file":"remotion-root.js","sourceRoot":"","sources":["../../../src/composition/remotion-root.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACrD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAEvD,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3B,QAAQ,EAAE,cAAc;IACxB,QAAQ,EAAE,cAAc,CAAC,QAAQ,EAAE;CACpC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,YAAY,GAAa,GAAG,EAAE;IACzC,OAAO,CACL,4BACE,KAAC,WAAW,IACV,EAAE,EAAC,WAAW,EACd,aAAa,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,SAAgB,EAAE,CAAC,EACnE,MAAM,EAAE,WAAW,EACnB,gBAAgB,EAAE,GAAG,EACrB,GAAG,EAAE,EAAE,EACP,KAAK,EAAE,IAAI,EACX,MAAM,EAAE,GAAG,EACX,YAAY,EAAE;gBACZ,QAAQ,EAAE;oBACR,OAAO,EAAE,CAAU;oBACnB,QAAQ,EAAE;wBACR,QAAQ,EAAE,EAAE;wBACZ,YAAY,EAAE,EAAE;wBAChB,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;wBACpC,QAAQ,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE;wBACtC,aAAa,EAAE,CAAC,EAAE,IAAI,EAAE,OAAgB,EAAE,IAAI,EAAE,iBAAiB,EAAE,CAAC;wBACpE,iBAAiB,EAAE,EAAE;qBACtB;oBACD,MAAM,EAAE,EAAE;iBACX;aACF,EACD,iBAAiB,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE;gBAC/B,MAAM,KAAK,GAAG,iBAAiB,CAC7B,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,aAAa,EACrC,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,iBAAiB,CAC1C,CAAC;gBACF,OAAO;oBACL,gBAAgB,EAAE,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,KAAK,CAAC;oBACrC,GAAG,EAAE,EAAE;oBACP,KAAK,EAAE,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,KAAK;oBAC7C,MAAM,EAAE,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM;iBAChD,CAAC;YACJ,CAAC,GACD,GACD,CACJ,CAAC;AACJ,CAAC,CAAC;AAEF,YAAY,CAAC,YAAY,CAAC,CAAC"}

package/dist/src/composition/render.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../../src/composition/render.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAEjE,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,QAAQ,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,cAAc,CAAC;CAC3B;AAyBD,wBAAsB,eAAe,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CAiC1E"}
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../../src/composition/render.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAEjE,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,QAAQ,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,cAAc,CAAC;CAC3B;AAqBD,wBAAsB,eAAe,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CAiC1E"}

package/dist/src/composition/render.js

@@ -5,16 +5,12 @@ import { resolve, basename } from 'node:path';
  * Rewrite absolute file paths in the timeline to basenames.
  * Remotion components run in a browser (webpack) and resolve assets
  * via staticFile() against the publicDir — they only need filenames.
+ *
+ * frameManifest paths are already relative to publicDir — no rewrite needed.
  */
 function toStaticPaths(timeline) {
-    const meta = { ...timeline.metadata };
-    if (meta.videoFile) {
-        meta.videoFile = basename(meta.videoFile);
-    }
-    // frameManifest paths are already relative to publicDir — no rewrite needed
     return {
         ...timeline,
-        metadata: meta,
         events: timeline.events.map(e => {
             if (e.type === 'narration' && e.audioFile) {
                 return { ...e, audioFile: basename(e.audioFile) };

package/dist/src/composition/render.js.map

@@ -1 +1 @@
-{"version":3,"file":"render.js","sourceRoot":"","sources":["../../../src/composition/render.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACpE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAY9C;;;;GAIG;AACH,SAAS,aAAa,CAAC,QAAkB;IACvC,MAAM,IAAI,GAAG,EAAE,GAAG,QAAQ,CAAC,QAAQ,EAAE,CAAC;IACtC,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;QACnB,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC5C,CAAC;IACD,4EAA4E;IAC5E,OAAO;QACL,GAAG,QAAQ;QACX,QAAQ,EAAE,IAAI;QACd,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE;YAC9B,IAAI,CAAC,CAAC,IAAI,KAAK,WAAW,IAAI,CAAC,CAAC,SAAS,EAAE,CAAC;gBAC1C,OAAO,EAAE,GAAG,CAAC,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE,CAAC;YACpD,CAAC;YACD,OAAO,CAAC,CAAC;QACX,CAAC,CAAC;KACH,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,IAAmB;IACvD,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,kBAAkB,CAAC,CAAC;IAEvF,MAAM,UAAU,GAAG,MAAM,MAAM,CAAC;QAC9B,UAAU;QACV,SAAS,EAAE,IAAI,CAAC,SAAS;KAC1B,CAAC,CAAC;IAEH,MAAM,cAAc,GAAG,aAAa,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAEpD,MAAM,UAAU,GAA4B,EAAE,QAAQ,EAAE,cAAc,EAAE,CAAC;IACzE,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;QAClB,UAAU,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;IACtC,CAAC;IAED,MAAM,WAAW,GAAG,MAAM,iBAAiB,CAAC;QAC1C,QAAQ,EAAE,UAAU;QACpB,EAAE,EAAE,WAAW;QACf,UAAU;KACX,CAAC,CAAC;IAEH,MAAM,WAAW,CAAC;QAChB,WAAW;QACX,QAAQ,EAAE,UAAU;QACpB,KAAK,EAAE,MAAM;QACb,GAAG,EAAE,EAAE;QACP,WAAW,EAAE,SAAS;QACtB,KAAK,EAAE,CAAC;QACR,cAAc,EAAE,IAAI,CAAC,UAAU;QAC/B,UAAU;KACX,CAAC,CAAC;IAEH,OAAO,IAAI,CAAC,UAAU,CAAC;AACzB,CAAC"}
+{"version":3,"file":"render.js","sourceRoot":"","sources":["../../../src/composition/render.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACpE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAY9C;;;;;;GAMG;AACH,SAAS,aAAa,CAAC,QAAkB;IACvC,OAAO;QACL,GAAG,QAAQ;QACX,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE;YAC9B,IAAI,CAAC,CAAC,IAAI,KAAK,WAAW,IAAI,CAAC,CAAC,SAAS,EAAE,CAAC;gBAC1C,OAAO,EAAE,GAAG,CAAC,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE,CAAC;YACpD,CAAC;YACD,OAAO,CAAC,CAAC;QACX,CAAC,CAAC;KACH,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,IAAmB;IACvD,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,kBAAkB,CAAC,CAAC;IAEvF,MAAM,UAAU,GAAG,MAAM,MAAM,CAAC;QAC9B,UAAU;QACV,SAAS,EAAE,IAAI,CAAC,SAAS;KAC1B,CAAC,CAAC;IAEH,MAAM,cAAc,GAAG,aAAa,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAEpD,MAAM,UAAU,GAA4B,EAAE,QAAQ,EAAE,cAAc,EAAE,CAAC;IACzE,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;QAClB,UAAU,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;IACtC,CAAC;IAED,MAAM,WAAW,GAAG,MAAM,iBAAiB,CAAC;QAC1C,QAAQ,EAAE,UAAU;QACpB,EAAE,EAAE,WAAW;QACf,UAAU;KACX,CAAC,CAAC;IAEH,MAAM,WAAW,CAAC;QAChB,WAAW;QACX,QAAQ,EAAE,UAAU;QACpB,KAAK,EAAE,MAAM;QACb,GAAG,EAAE,EAAE;QACP,WAAW,EAAE,SAAS;QACtB,KAAK,EAAE,CAAC;QACR,cAAc,EAAE,IAAI,CAAC,UAAU;QAC/B,UAAU;KACX,CAAC,CAAC;IAEH,OAAO,IAAI,CAAC,UAAU,CAAC;AACzB,CAAC"}

package/dist/src/index.d.ts

@@ -1,6 +1,6 @@
 export type { ScreenwrightHelpers, ActionOptions, SceneOptions, TransitionOptions } from './runtime/action-helpers.js';
 export type { ScenarioFn } from './runtime/instrumented-page.js';
-export type { Timeline, TimelineEvent, SceneEvent, ActionEvent, CursorTargetEvent, NarrationEvent, WaitEvent, TransitionEvent, FrameEntry, SceneSlideConfig, TransitionType } from './timeline/types.js';
+export type { Timeline, TimelineEvent, SceneEvent, ActionEvent, CursorTargetEvent, NarrationEvent, WaitEvent, ManifestEntry, TransitionMarker, SceneSlideConfig, TransitionType } from './timeline/types.js';
 export { transitionTypes } from './timeline/types.js';
 export type { ScreenwrightConfig, OpenaiVoice } from './config/config-schema.js';
 export { openaiVoices } from './config/config-schema.js';

package/dist/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AACA,YAAY,EAAE,mBAAmB,EAAE,aAAa,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AACvH,YAAY,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC;AACjE,YAAY,EAAE,QAAQ,EAAE,aAAa,EAAE,UAAU,EAAE,WAAW,EAAE,iBAAiB,EAAE,cAAc,EAAE,SAAS,EAAE,eAAe,EAAE,UAAU,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACzM,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,YAAY,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACjF,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AAC9F,YAAY,EAAE,gBAAgB,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AACA,YAAY,EAAE,mBAAmB,EAAE,aAAa,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AACvH,YAAY,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC;AACjE,YAAY,EAAE,QAAQ,EAAE,aAAa,EAAE,UAAU,EAAE,WAAW,EAAE,iBAAiB,EAAE,cAAc,EAAE,SAAS,EAAE,aAAa,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC7M,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,YAAY,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACjF,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AAC9F,YAAY,EAAE,gBAAgB,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC"}

package/dist/src/runtime/action-helpers.d.ts

@@ -1,6 +1,7 @@
 import type { Page } from 'playwright';
 import type { TimelineCollector } from './timeline-collector.js';
-import type { SceneSlideConfig, TransitionType } from '../timeline/types.js';
+import type { ManifestEntry, TransitionMarker, SceneSlideConfig, TransitionType } from '../timeline/types.js';
+import type { PregeneratedNarration } from './narration-preprocess.js';
 export interface ActionOptions {
     narration?: string;
 }
@@ -24,9 +25,18 @@ export interface ScreenwrightHelpers {
     narrate(text: string): Promise<void>;
     transition(opts?: TransitionOptions): Promise<void>;
 }
-export declare function calculateMoveDuration(fromX: number, fromY: number, toX: number, toY: number): number;
-export interface CreateHelpersOptions {
-    captureSnapshot?: () => Promise<string>;
+export interface RecordingContext {
+    pauseCapture(): Promise<void>;
+    resumeCapture(): void;
+    captureOneFrame(): Promise<string>;
+    addHold(file: string, count: number): void;
+    addTransitionMarker(marker: TransitionMarker): void;
+    popNarration(): PregeneratedNarration;
+    currentTimeMs(): number;
+    readonly manifest: ManifestEntry[];
+    transitionPending: boolean;
+    readonly narrationCount: number;
 }
-export declare function createHelpers(page: Page, collector: TimelineCollector, opts?: CreateHelpersOptions): ScreenwrightHelpers;
+export declare function calculateMoveDuration(fromX: number, fromY: number, toX: number, toY: number): number;
+export declare function createHelpers(page: Page, collector: TimelineCollector, ctx: RecordingContext): ScreenwrightHelpers;
 //# sourceMappingURL=action-helpers.d.ts.map

package/dist/src/runtime/action-helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"action-helpers.d.ts","sourceRoot":"","sources":["../../../src/runtime/action-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE7E,MAAM,WAAW,aAAa;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,YAAY;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,gBAAgB,CAAC;CAC1B;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,CAAC,EAAE,cAAc,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,IAAI,CAAC;IACX,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,oBAAoB,CAAC,EAAE,MAAM,GAAG,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClF,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3D,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7D,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3E,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7D,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxD,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChC,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrC,UAAU,CAAC,IAAI,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACrD;AAYD,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAGpG;AAED,MAAM,WAAW,oBAAoB;IACnC,eAAe,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;CACzC;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,iBAAiB,EAAE,IAAI,CAAC,EAAE,oBAAoB,GAAG,mBAAmB,CAuNxH"}
+{"version":3,"file":"action-helpers.d.ts","sourceRoot":"","sources":["../../../src/runtime/action-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC9G,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAEvE,MAAM,WAAW,aAAa;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,YAAY;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,gBAAgB,CAAC;CAC1B;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,CAAC,EAAE,cAAc,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,IAAI,CAAC;IACX,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,oBAAoB,CAAC,EAAE,MAAM,GAAG,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClF,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3D,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7D,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3E,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7D,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxD,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChC,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrC,UAAU,CAAC,IAAI,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACrD;AAED,MAAM,WAAW,gBAAgB;IAC/B,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9B,aAAa,IAAI,IAAI,CAAC;IACtB,eAAe,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IACnC,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3C,mBAAmB,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAAC;IACpD,YAAY,IAAI,qBAAqB,CAAC;IACtC,aAAa,IAAI,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,aAAa,EAAE,CAAC;IACnC,iBAAiB,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AAQD,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAGpG;AA6FD,wBAAgB,aAAa,CAAC,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,iBAAiB,EAAE,GAAG,EAAE,gBAAgB,GAAG,mBAAmB,CAsTlH"}

package/dist/src/runtime/action-helpers.js

@@ -1,42 +1,115 @@
-const NARRATION_WPM = 150;
+const DEFAULT_SLIDE_DURATION_MS = 2000;
 const CHAR_TYPE_DELAY_MS = 30;
 const CURSOR_MOVE_MIN_MS = 200;
 const CURSOR_MOVE_MAX_MS = 800;
-function estimateNarrationMs(text) {
-    const words = text.split(/\s+/).length;
-    return Math.round((words / NARRATION_WPM) * 60 * 1000);
-}
+const FPS = 30;
 export function calculateMoveDuration(fromX, fromY, toX, toY) {
     const distance = Math.sqrt((toX - fromX) ** 2 + (toY - fromY) ** 2);
     return Math.min(CURSOR_MOVE_MAX_MS, Math.max(CURSOR_MOVE_MIN_MS, Math.round(200 * Math.log2(distance / 10 + 1))));
 }
-export function createHelpers(page, collector, opts) {
-    let lastX = 640;
-    let lastY = 360;
-    async function takeSnapshot() {
-        if (!opts?.captureSnapshot)
-            return undefined;
-        const before = performance.now();
+function msToFrames(ms) {
+    return Math.ceil(ms / 1000 * FPS);
+}
+const SLIDE_OVERLAY_ID = '__screenwright_slide_overlay__';
+function escapeJs(s) {
+    return s.replace(/\\/g, '\\\\').replace(/'/g, "\\'").replace(/\n/g, '\\n');
+}
+async function injectSlideOverlay(page, title, description, config) {
+    const brandColor = config.brandColor ?? '#000000';
+    const textColor = config.textColor ?? '#FFFFFF';
+    const fontFamily = config.fontFamily;
+    const titleFontSize = config.titleFontSize ?? 64;
+    const descFontSize = Math.round(titleFontSize * 0.44);
+    const resolvedFont = fontFamily
+        ? `"${fontFamily}", system-ui, -apple-system, sans-serif`
+        : 'system-ui, -apple-system, sans-serif';
+    // Use string-based evaluate to avoid TypeScript checking browser globals
+    let script = '';
+    if (fontFamily) {
+        const encoded = encodeURIComponent(fontFamily);
+        script += `
+      if (!document.getElementById('${SLIDE_OVERLAY_ID}_font')) {
+        var link = document.createElement('link');
+        link.id = '${SLIDE_OVERLAY_ID}_font';
+        link.rel = 'stylesheet';
+        link.href = 'https://fonts.googleapis.com/css2?family=${encoded}&display=swap';
+        document.head.appendChild(link);
+      }
+    `;
+    }
+    script += `
+    var overlay = document.createElement('div');
+    overlay.id = '${SLIDE_OVERLAY_ID}';
+    overlay.style.cssText = 'position:fixed;inset:0;z-index:999999;display:flex;flex-direction:column;align-items:center;justify-content:center;background-color:${escapeJs(brandColor)};font-family:${escapeJs(resolvedFont)};';
+    var inner = document.createElement('div');
+    inner.style.cssText = 'text-align:center;padding:0 10%;';
+    var h1 = document.createElement('h1');
+    h1.textContent = '${escapeJs(title)}';
+    h1.style.cssText = 'color:${escapeJs(textColor)};font-size:${titleFontSize}px;font-weight:700;margin:0;line-height:1.2;';
+    inner.appendChild(h1);
+  `;
+    if (description) {
+        script += `
+      var divider = document.createElement('div');
+      divider.style.cssText = 'width:80px;height:4px;background-color:${escapeJs(textColor)};opacity:0.4;margin:24px auto;border-radius:2px;';
+      inner.appendChild(divider);
+      var p = document.createElement('p');
+      p.textContent = '${escapeJs(description)}';
+      p.style.cssText = 'color:${escapeJs(textColor)};font-size:${descFontSize}px;font-weight:400;margin:0;opacity:0.85;line-height:1.5;';
+      inner.appendChild(p);
+    `;
+    }
+    script += `
+    overlay.appendChild(inner);
+    document.body.appendChild(overlay);
+  `;
+    await page.evaluate(script);
+    // Wait for font to load if specified, with 3s timeout
+    if (fontFamily) {
+        await page.evaluate(`
+      (async () => {
         try {
-            return await opts.captureSnapshot();
-        }
-        catch {
-            return undefined;
-        }
-        finally {
-            collector.excludeTime(performance.now() - before);
-        }
+          await Promise.race([
+            document.fonts.load('700 64px "${escapeJs(fontFamily)}"'),
+            new Promise(r => setTimeout(r, 3000)),
+          ]);
+        } catch {}
+      })()
+    `).catch(() => { });
     }
+}
+async function removeSlideOverlay(page) {
+    await page.evaluate(`
+    var el = document.getElementById('${SLIDE_OVERLAY_ID}');
+    if (el) el.remove();
+    var fontLink = document.getElementById('${SLIDE_OVERLAY_ID}_font');
+    if (fontLink) fontLink.remove();
+  `).catch(() => { });
+}
+export function createHelpers(page, collector, ctx) {
+    let lastX = 640;
+    let lastY = 360;
     async function emitNarration(text) {
-        const estimatedMs = estimateNarrationMs(text);
-        collector.emit({ type: 'narration', text });
-        collector.emit({ type: 'wait', durationMs: estimatedMs, reason: 'narration_sync' });
-        await page.waitForTimeout(estimatedMs);
+        await ctx.pauseCapture();
+        const narration = ctx.popNarration();
+        const file = await ctx.captureOneFrame();
+        const holdFrames = msToFrames(narration.durationMs);
+        if (holdFrames > 1)
+            ctx.addHold(file, holdFrames - 1); // captureOneFrame already added 1
+        collector.emit({
+            type: 'narration',
+            timestampMs: ctx.currentTimeMs(),
+            text: narration.text,
+            audioDurationMs: narration.durationMs,
+            audioFile: narration.audioFile,
+        });
+        ctx.resumeCapture();
     }
     async function moveCursorTo(toX, toY) {
         const moveDurationMs = calculateMoveDuration(lastX, lastY, toX, toY);
         collector.emit({
             type: 'cursor_target',
+            timestampMs: ctx.currentTimeMs(),
             fromX: lastX, fromY: lastY,
             toX, toY,
             moveDurationMs,
@@ -61,22 +134,67 @@ export function createHelpers(page, collector, opts) {
         err.cause = cause;
         return err;
     }
+    /** Resolve a pending transition after an action settles. */
+    async function resolveTransition() {
+        if (!ctx.transitionPending)
+            return;
+        const file = await ctx.captureOneFrame();
+        // The "after" frame is now in the manifest — resume capture
+        ctx.transitionPending = false;
+        ctx.resumeCapture();
+        // We don't need the file reference; it's in the manifest at the correct position
+        void file;
+    }
     return {
         page,
         async scene(title, descriptionOrOptions) {
-            if (typeof descriptionOrOptions === 'string' || descriptionOrOptions === undefined) {
-                collector.emit({ type: 'scene', title, description: descriptionOrOptions });
+            let description;
+            let slide;
+            if (typeof descriptionOrOptions === 'string') {
+                description = descriptionOrOptions;
+            }
+            else if (descriptionOrOptions !== undefined) {
+                description = descriptionOrOptions.description;
+                slide = descriptionOrOptions.slide;
+            }
+            if (slide) {
+                // DOM injection slide
+                await ctx.pauseCapture();
+                const slideDurationMs = slide.duration ?? DEFAULT_SLIDE_DURATION_MS;
+                await injectSlideOverlay(page, title, description, slide);
+                try {
+                    const file = await ctx.captureOneFrame();
+                    const holdFrames = msToFrames(slideDurationMs);
+                    if (holdFrames > 1)
+                        ctx.addHold(file, holdFrames - 1);
+                }
+                finally {
+                    await removeSlideOverlay(page);
+                }
+                collector.emit({ type: 'scene', timestampMs: ctx.currentTimeMs(), title, description, slide });
+                // If transition was pending, the slide resolves it
+                if (ctx.transitionPending) {
+                    ctx.transitionPending = false;
+                }
+                // Do NOT resume capture here — the slide is self-contained.
+                // Resuming would capture blank-page frames that corrupt subsequent
+                // transition markers.  The next real action resumes capture.
             }
             else {
-                const { description, slide } = descriptionOrOptions;
-                collector.emit({ type: 'scene', title, description, slide });
+                // No slide — just emit scene marker
+                collector.emit({ type: 'scene', timestampMs: ctx.currentTimeMs(), title, description });
             }
         },
         async navigate(url, actionOpts) {
-            const startMs = collector.elapsed();
+            if (actionOpts?.narration)
+                await emitNarration(actionOpts.narration);
+            const wasPending = ctx.transitionPending;
+            if (wasPending) {
+                // Capture loop is already paused from transition()
+            }
+            const startMs = ctx.currentTimeMs();
             try {
                 await page.goto(url, { waitUntil: 'domcontentloaded' });
-                const settledSnapshot = await takeSnapshot();
                 collector.emit({
                     type: 'action',
                     action: 'navigate',
@@ -84,27 +202,30 @@ export function createHelpers(page, collector, opts) {
                     durationMs: 0,
                     boundingBox: null,
                     timestampMs: startMs,
-                    settledAtMs: collector.elapsed(),
-                    ...(settledSnapshot ? { settledSnapshot } : {}),
+                    settledAtMs: ctx.currentTimeMs(),
                 });
             }
             catch (err) {
                 throw actionError('navigate', url, err);
             }
-            if (actionOpts?.narration)
-                await emitNarration(actionOpts.narration);
+            if (wasPending) {
+                await resolveTransition();
+            }
+            else {
+                ctx.resumeCapture();
+            }
         },
         async click(selector, actionOpts) {
             if (actionOpts?.narration)
                 await emitNarration(actionOpts.narration);
+            const wasPending = ctx.transitionPending;
             try {
                 const center = await resolveCenter(selector);
                 await moveCursorTo(center.x, center.y);
                 const locator = page.locator(selector).first();
                 const box = await locator.boundingBox();
-                const startMs = collector.elapsed();
+                const startMs = ctx.currentTimeMs();
                 await locator.click();
-                const settledSnapshot = await takeSnapshot();
                 collector.emit({
                     type: 'action',
                     action: 'click',
@@ -112,28 +233,33 @@ export function createHelpers(page, collector, opts) {
                     durationMs: 200,
                     boundingBox: box ? { x: Math.round(box.x), y: Math.round(box.y), width: Math.round(box.width), height: Math.round(box.height) } : null,
                     timestampMs: startMs,
-                    settledAtMs: collector.elapsed(),
-                    ...(settledSnapshot ? { settledSnapshot } : {}),
+                    settledAtMs: ctx.currentTimeMs(),
                 });
             }
             catch (err) {
                 throw actionError('click', selector, err);
             }
+            if (wasPending) {
+                await resolveTransition();
+            }
+            else {
+                ctx.resumeCapture();
+            }
         },
         async fill(selector, value, actionOpts) {
             if (actionOpts?.narration)
                 await emitNarration(actionOpts.narration);
+            const wasPending = ctx.transitionPending;
             try {
                 const center = await resolveCenter(selector);
                 await moveCursorTo(center.x, center.y);
                 const locator = page.locator(selector).first();
                 const box = await locator.boundingBox();
                 await locator.click();
-                const startMs = collector.elapsed();
+                const startMs = ctx.currentTimeMs();
                 for (const char of value) {
                     await page.keyboard.type(char, { delay: CHAR_TYPE_DELAY_MS });
                 }
-                const settledSnapshot = await takeSnapshot();
                 collector.emit({
                     type: 'action',
                     action: 'fill',
@@ -142,25 +268,30 @@ export function createHelpers(page, collector, opts) {
                     durationMs: value.length * CHAR_TYPE_DELAY_MS,
                     boundingBox: box ? { x: Math.round(box.x), y: Math.round(box.y), width: Math.round(box.width), height: Math.round(box.height) } : null,
                     timestampMs: startMs,
-                    settledAtMs: collector.elapsed(),
-                    ...(settledSnapshot ? { settledSnapshot } : {}),
+                    settledAtMs: ctx.currentTimeMs(),
                 });
             }
             catch (err) {
                 throw actionError('fill', selector, err);
             }
+            if (wasPending) {
+                await resolveTransition();
+            }
+            else {
+                ctx.resumeCapture();
+            }
         },
         async hover(selector, actionOpts) {
             if (actionOpts?.narration)
                 await emitNarration(actionOpts.narration);
+            const wasPending = ctx.transitionPending;
             try {
                 const center = await resolveCenter(selector);
                 await moveCursorTo(center.x, center.y);
                 const locator = page.locator(selector).first();
                 const box = await locator.boundingBox();
-                const startMs = collector.elapsed();
+                const startMs = ctx.currentTimeMs();
                 await locator.hover();
-                const settledSnapshot = await takeSnapshot();
                 collector.emit({
                     type: 'action',
                     action: 'hover',
@@ -168,21 +299,26 @@ export function createHelpers(page, collector, opts) {
                     durationMs: 200,
                     boundingBox: box ? { x: Math.round(box.x), y: Math.round(box.y), width: Math.round(box.width), height: Math.round(box.height) } : null,
                     timestampMs: startMs,
-                    settledAtMs: collector.elapsed(),
-                    ...(settledSnapshot ? { settledSnapshot } : {}),
+                    settledAtMs: ctx.currentTimeMs(),
                 });
             }
             catch (err) {
                 throw actionError('hover', selector, err);
             }
+            if (wasPending) {
+                await resolveTransition();
+            }
+            else {
+                ctx.resumeCapture();
+            }
         },
         async press(key, actionOpts) {
             if (actionOpts?.narration)
                 await emitNarration(actionOpts.narration);
-            const startMs = collector.elapsed();
+            const wasPending = ctx.transitionPending;
+            const startMs = ctx.currentTimeMs();
             try {
                 await page.keyboard.press(key);
-                const settledSnapshot = await takeSnapshot();
                 collector.emit({
                     type: 'action',
                     action: 'press',
@@ -190,17 +326,35 @@ export function createHelpers(page, collector, opts) {
                     durationMs: 100,
                     boundingBox: null,
                     timestampMs: startMs,
-                    settledAtMs: collector.elapsed(),
-                    ...(settledSnapshot ? { settledSnapshot } : {}),
+                    settledAtMs: ctx.currentTimeMs(),
                 });
             }
             catch (err) {
                 throw actionError('press', key, err);
             }
+            if (wasPending) {
+                await resolveTransition();
+            }
+            else {
+                ctx.resumeCapture();
+            }
         },
         async wait(ms) {
-            collector.emit({ type: 'wait', durationMs: ms, reason: 'pacing' });
-            await page.waitForTimeout(ms);
+            if (ctx.transitionPending) {
+                // Capture loop is already paused. Wait for real settling, then hold.
+                await page.waitForTimeout(ms);
+                const file = await ctx.captureOneFrame();
+                const holdFrames = msToFrames(ms);
+                if (holdFrames > 1)
+                    ctx.addHold(file, holdFrames - 1);
+                collector.emit({ type: 'wait', timestampMs: ctx.currentTimeMs(), durationMs: ms, reason: 'pacing' });
+            }
+            else {
+                // Ensure capture is running — captures real frames during the wait
+                ctx.resumeCapture();
+                collector.emit({ type: 'wait', timestampMs: ctx.currentTimeMs(), durationMs: ms, reason: 'pacing' });
+                await page.waitForTimeout(ms);
+            }
         },
         async narrate(text) {
             await emitNarration(text);
@@ -210,17 +364,21 @@ export function createHelpers(page, collector, opts) {
             if (durationMs <= 0 || !Number.isFinite(durationMs)) {
                 throw new Error(`sw.transition() duration must be a positive number, got ${durationMs}`);
             }
-            const events = collector.getEvents();
-            if (events.length > 0 && events[events.length - 1].type === 'transition') {
-                console.warn('sw.transition() called twice with no action between them — both transitions will stack at the same output position.');
+            if (ctx.transitionPending) {
+                console.warn('sw.transition() called twice with no action between them — replacing previous transition marker.');
+                // Remove the last marker
+                const markers = ctx._transitionMarkers;
+                if (markers && markers.length > 0)
+                    markers.pop();
             }
-            const pageSnapshot = await takeSnapshot();
-            collector.emit({
-                type: 'transition',
+            await ctx.pauseCapture();
+            ctx.addTransitionMarker({
+                afterEntryIndex: ctx.manifest.length - 1,
                 transition: transitionOpts?.type ?? 'fade',
-                durationMs,
-                ...(pageSnapshot ? { pageSnapshot } : {}),
+                durationFrames: msToFrames(durationMs),
             });
+            ctx.transitionPending = true;
+            // Capture loop stays paused — next resolving action will resume it
         },
     };
 }