screenci 0.0.69 → 0.0.71

package/dist/src/cue.d.ts

@@ -22,15 +22,28 @@ export type NarrationCue = {
     start(): Promise<void>;
     end(): Promise<void>;
 };
-type NarrationCueObject = {
+/**
+ * Linear gain applied to a cue's narration audio at mix time. `1` is the natural
+ * level (the default), `0` mutes it, and values above `1` boost it. Capped at
+ * {@link MAX_AUDIO_LEVEL}.
+ *
+ * Volume is a per-cue, render-time mix property: it is applied with ffmpeg when
+ * the narration is mixed and is deliberately not part of the voice/generation
+ * settings, so changing it never regenerates the audio. When more than one
+ * language sets a volume for the same cue, the first one wins.
+ */
+type NarrationVolume = {
+    volume?: number;
+};
+type NarrationCueObject = ({
     text: string;
-} | {
+} & NarrationVolume) | ({
     media: string;
     subtitle?: string;
-} | {
+} & NarrationVolume) | ({
     path: string;
     subtitle?: string;
-};
+} & NarrationVolume);
 /** A single narration cue value in a multi-language map. */
 export type CueMapValue = string | NarrationCueObject;
 /** Typed narration controllers keyed by the cue names in a language map. */

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

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

package/dist/src/cue.js

@@ -1,5 +1,6 @@
 import { supportedLanguages, voices, } from './voices.js';
 import { isCustomVoiceRef } from './customVoiceRef.js';
+import { MAX_AUDIO_LEVEL } from './asset.js';
 import { isInsideHide } from './hide.js';
 import { logger } from './logger.js';
 import { readFile } from 'fs/promises';
@@ -261,18 +262,33 @@ export function createStudioNarration(...keys) {
 }
 const RESERVED_LANGUAGE_METADATA_KEYS = new Set(['voice']);
 const SUPPORTED_LANGUAGE_SET = new Set(supportedLanguages);
+/**
+ * Validates a per-cue narration volume and returns it unchanged. A volume must
+ * be a finite number between 0 and {@link MAX_AUDIO_LEVEL}. Throws otherwise.
+ */
+function validateCueVolume(name, volume) {
+    if (!Number.isFinite(volume) || volume < 0 || volume > MAX_AUDIO_LEVEL) {
+        throw new Error(`[screenci] Narration cue "${name}" must provide a finite volume between 0 and ${MAX_AUDIO_LEVEL}. 1 is the natural level, 0 is silent, and values above 1 boost it.`);
+    }
+    return volume;
+}
 function normalizeCueMapValue(value) {
     if (typeof value === 'string') {
         return { type: 'text', text: value };
     }
     if ('text' in value) {
-        return { type: 'text', text: value.text };
+        return {
+            type: 'text',
+            text: value.text,
+            ...(value.volume !== undefined && { volume: value.volume }),
+        };
     }
     const mediaPath = 'media' in value ? value.media : value.path;
     return {
         type: 'file',
         path: mediaPath,
         ...(value.subtitle !== undefined && { subtitle: value.subtitle }),
+        ...(value.volume !== undefined && { volume: value.volume }),
     };
 }
 function getLanguageCues(lang, entry) {
@@ -397,6 +413,9 @@ function buildCuesFromInput(topVoice, languages) {
         const normalizedByLang = new Map();
         // Normalize shorthand values and determine if any language uses a file entry for this key.
         let hasFileEntry = false;
+        // Volume is per-cue (a render-time mix property, not per-language): the first
+        // language that sets a volume for this cue wins.
+        let cueVolume;
         for (const lang of langs) {
             const val = getLanguageCues(lang, languages[lang])?.[keyStr];
             if (val !== undefined) {
@@ -405,6 +424,9 @@ function buildCuesFromInput(topVoice, languages) {
                 if (normalized.type === 'file') {
                     hasFileEntry = true;
                 }
+                if (cueVolume === undefined && normalized.volume !== undefined) {
+                    cueVolume = validateCueVolume(keyStr, normalized.volume);
+                }
             }
         }
         if (hasFileEntry) {
@@ -452,7 +474,10 @@ function buildCuesFromInput(topVoice, languages) {
                     }
                 }
                 sleepForCueFrameGap();
-                recorder.addVideoCueStart(keyStr, undefined, undefined, undefined, videoTranslations);
+                recorder.addVideoCueStart(keyStr, undefined, undefined, undefined, videoTranslations, 
+                // Spread so the volume arg is omitted entirely (not passed as
+                // undefined) when no per-cue volume was set.
+                ...(cueVolume !== undefined ? [cueVolume] : []));
             });
         }
         else {
@@ -491,7 +516,10 @@ function buildCuesFromInput(topVoice, languages) {
                     }
                 }
                 sleepForCueFrameGap();
-                recorder.addCueStart('', keyStr, undefined, textTranslations);
+                recorder.addCueStart('', keyStr, undefined, textTranslations, 
+                // Spread so the volume arg is omitted entirely (not passed as
+                // undefined) when no per-cue volume was set.
+                ...(cueVolume !== undefined ? [cueVolume] : []));
             });
         }
     }

package/dist/src/cue.js.map

@@ -1 +1 @@
-{"version":3,"file":"cue.js","sourceRoot":"","sources":["../../src/cue.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"cue.js","sourceRoot":"","sources":["../../src/cue.ts"],"names":[],"mappings":"AAQA,OAAO,EACL,kBAAkB,EAClB,MAAM,GAOP,MAAM,aAAa,CAAA;AACpB,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAA;AACxC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACpC,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AACtC,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAA;AACnC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AACvC,OAAO,EACL,yBAAyB,EACzB,qBAAqB,EACrB,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,qBAAqB,CAAA;AAC5B,OAAO,EAAE,8BAA8B,EAAE,MAAM,kBAAkB,CAAA;AAEjE,oFAAoF;AACpF,MAAM,CAAC,MAAM,YAAY,GAAG,IAAI,GAAG,EAAE,CAAA;AACrC,MAAM,mBAAmB,GACvB,6DAA6D,CAAA;AAE/D,0DAA0D;AAC1D,IAAI,OAAO,GAAG,CAAC,EAAU,EAAQ,EAAE;IACjC,MAAM,GAAG,GAAG,WAAW,CAAC,GAAG,EAAE,GAAG,EAAE,CAAA;IAClC,OAAO,WAAW,CAAC,GAAG,EAAE,GAAG,GAAG,EAAE,CAAC;QAC/B,UAAU;IACZ,CAAC;AACH,CAAC,CAAA;AAED,SAAS,mBAAmB;IAC1B,MAAM,UAAU,GAAG,8BAA8B,CAAC,CAAC,GAAG,YAAY,CAAC,CAAA;IACnE,IAAI,UAAU,IAAI,CAAC,EAAE,CAAC;QACpB,OAAM;IACR,CAAC;IAED,OAAO,CAAC,UAAU,CAAC,CAAA;AACrB,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,EAAwB;IACjD,OAAO,GAAG,EAAE,CAAA;AACd,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,QAA+B;IAClE,qBAAqB,CAAC,QAAQ,CAAC,CAAA;IAC/B,oBAAoB,EAAE,CAAA;AACxB,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,oBAAoB,EAAE,CAAA;AACxB,CAAC;AAED,MAAM,UAAU,8BAA8B;IAC5C,uEAAuE;IACvE,uCAAuC;AACzC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,aAAqB;IAErB,6EAA6E;IAC7E,0EAA0E;IAC1E,qBAAqB;AACvB,CAAC;AAED,KAAK,UAAU,oBAAoB,CACjC,SAAiB,EACjB,YAA2B;IAE3B,MAAM,UAAU,GAAG,CAAC,SAAS,CAAC,CAAA;IAC9B,IAAI,YAAY,KAAK,IAAI,EAAE,CAAC;QAC1B,MAAM,OAAO,GAAG,OAAO,CAAC,YAAY,CAAC,CAAA;QACrC,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC,CAAA;IAC9C,CAAC;IAED,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,IAAI,CAAC;YACH,MAAM,UAAU,GAAG,MAAM,QAAQ,CAAC,SAAS,CAAC,CAAA;YAC5C,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;QAC9D,CAAC;QAAC,MAAM,CAAC;YACP,qBAAqB;QACvB,CAAC;IACH,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,yBAAyB,SAAS,EAAE,CAAC,CAAA;AACvD,CAAC;AAED,KAAK,UAAU,eAAe,CAC5B,KAAgC;IAEhC,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAA;IAC1C,MAAM,YAAY,GAAG,yBAAyB,EAAE,CAAC,YAAY,CAAA;IAC7D,OAAO;QACL,SAAS,EAAE,MAAM,oBAAoB,CAAC,KAAK,CAAC,IAAI,EAAE,YAAY,CAAC;QAC/D,SAAS,EAAE,KAAK,CAAC,IAAI;KACtB,CAAA;AACH,CAAC;AAED,SAAS,mBAAmB,CAAC,KAAgC;IAC3D,IAAI,gBAAgB,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAA;IACxC,OAAO,KAAK,CAAC,UAAU,CAAC,aAAa,CAAC,CAAA;AACxC,CAAC;AAED,SAAS,gCAAgC,CACvC,KAAgC,EAChC,QAAgB;IAEhB,IAAI,CAAC,mBAAmB,CAAC,KAAK,CAAC;QAAE,OAAM;IACvC,IAAI,OAAO,CAAC,GAAG,CAAC,kBAAkB,EAAE,IAAI,EAAE;QAAE,OAAM;IAElD,MAAM,IAAI,KAAK,CACb,GAAG,QAAQ,qIAAqI,mBAAmB,GAAG,CACvK,CAAA;AACH,CAAC;AAED;;;GAGG;AACH,SAAS,UAAU,CAAC,WAAmB;IACrC,MAAM,OAAO,GAAG,yBAAyB,EAAE,CAAA;IAC3C,IAAI,OAAO,CAAC,GAAG,CAAC,YAAY,KAAK,IAAI;QAAE,OAAM;IAC7C,IACE,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,wBAAwB;QACjD,OAAO,CAAC,GAAG,CAAC,aAAa,KAAK,IAAI,EAClC,CAAC;QACD,MAAM,CAAC,IAAI,CACT,mBAAmB,OAAO,CAAC,GAAG,CAAC,aAAa,wDAAwD,WAAW,2EAA2E,CAC3L,CAAA;IACH,CAAC;IACD,OAAO,CAAC,WAAW,CAAC,SAAS,CAAC,MAAM,CAAC,CAAA;IACrC,mBAAmB,EAAE,CAAA;IACrB,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,eAAe,EAAE,CAAA;IAC1C,OAAO,CAAC,GAAG,CAAC,aAAa,GAAG,IAAI,CAAA;IAChC,OAAO,CAAC,GAAG,CAAC,YAAY,GAAG,IAAI,CAAA;AACjC,CAAC;AAED,SAAS,mBAAmB,CAAC,IAAY;IACvC,MAAM,YAAY,GAAG,yBAAyB,EAAE,CAAC,GAAG,CAAC,YAAY,CAAA;IACjE,IAAI,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CACb,uBAAuB,IAAI,qDAAqD,CACjF,CAAA;IACH,CAAC;IACD,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;AACxB,CAAC;AAED,SAAS,cAAc;IAIrB,IAAI,OAAoB,CAAA;IACxB,MAAM,OAAO,GAAG,IAAI,OAAO,CAAO,CAAC,SAAS,EAAE,EAAE;QAC9C,OAAO,GAAG,SAAS,CAAA;IACrB,CAAC,CAAC,CAAA;IACF,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,CAAA;AAC7B,CAAC;AAED,SAAS,kBAAkB,CAAC,wBAAiC;IAK3D,MAAM,QAAQ,GAAG,cAAc,EAAE,CAAA;IACjC,OAAO;QACL,QAAQ,EAAE,QAAQ,CAAC,OAAO;QAC1B,eAAe,EAAE,QAAQ,CAAC,OAAO;QACjC,wBAAwB;KACzB,CAAA;AACH,CAAC;AAED,KAAK,UAAU,YAAY;IACzB,MAAM,OAAO,GAAG,yBAAyB,EAAE,CAAA;IAC3C,IAAI,OAAO,CAAC,GAAG,CAAC,YAAY,KAAK,IAAI;QAAE,OAAM;IAC7C,IAAI,YAAY,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAA;IACtE,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,CAAA;IACpC,OAAO,CAAC,WAAW,CAAC,SAAS,CAAC,MAAM,CAAC,CAAA;IACrC,mBAAmB,EAAE,CAAA;IACrB,GAAG,CAAC,eAAe,EAAE,CAAA;IACrB,IAAI,OAAO,CAAC,GAAG,CAAC,YAAY,KAAK,GAAG,EAAE,CAAC;QACrC,OAAO,CAAC,GAAG,CAAC,aAAa,GAAG,IAAI,CAAA;QAChC,OAAO,CAAC,GAAG,CAAC,YAAY,GAAG,IAAI,CAAA;IACjC,CAAC;AACH,CAAC;AAwND;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,MAAM,UAAU,eAAe,CAE7B,KAAwB;IACxB,IAAI,WAAW,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CACb,2JAA2J,CAC5J,CAAA;IACH,CAAC;IAED,MAAM,SAAS,GAAG,uBAAuB,CAAC,KAAK,CAAC,CAAA;IAEhD,OAAO,kBAAkB,CACvB,KAAK,CAAC,KAAK,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,EACtC,SAAS,CACU,CAAA;AACvB,CAAC;AAED,SAAS,mBAAmB,CAC1B,IAAY,EACZ,SAA6D;IAE7D,IAAI,eAAe,GAAG,KAAK,CAAA;IAE3B,MAAM,KAAK,GAAG,KAAK,EAAE,wBAAwB,GAAG,IAAI,EAAiB,EAAE;QACrE,IAAI,YAAY,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAA;QAC3E,MAAM,QAAQ,GAAG,qBAAqB,EAAE,CAAA;QACxC,MAAM,OAAO,GAAG,yBAAyB,EAAE,CAAA;QAC3C,IAAI,CAAC,eAAe,EAAE,CAAC;YACrB,mBAAmB,CAAC,IAAI,CAAC,CAAA;YACzB,eAAe,GAAG,IAAI,CAAA;QACxB,CAAC;QACD,UAAU,CAAC,IAAI,CAAC,CAAA;QAChB,MAAM,GAAG,GAAG,kBAAkB,CAAC,wBAAwB,CAAC,CAAA;QACxD,OAAO,CAAC,GAAG,CAAC,aAAa,GAAG,IAAI,CAAA;QAChC,OAAO,CAAC,GAAG,CAAC,YAAY,GAAG,GAAG,CAAA;QAC9B,MAAM,SAAS,CAAC,QAAQ,CAAC,CAAA;IAC3B,CAAC,CAAA;IAED,MAAM,GAAG,GAAG,KAAK,IAAmB,EAAE;QACpC,IAAI,YAAY,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAA;QACtE,MAAM,OAAO,GAAG,yBAAyB,EAAE,CAAA;QAC3C,IACE,OAAO,CAAC,GAAG,CAAC,aAAa,KAAK,IAAI;YAClC,OAAO,CAAC,GAAG,CAAC,YAAY,KAAK,IAAI,EACjC,CAAC;YACD,MAAM,IAAI,KAAK,CACb,8BAA8B,IAAI,4CAA4C,CAC/E,CAAA;QACH,CAAC;QAED,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,CAAA;QACpC,MAAM,YAAY,EAAE,CAAA;QACpB,MAAM,GAAG,CAAC,QAAQ,CAAA;IACpB,CAAC,CAAA;IAED,MAAM,GAAG,GAAG,CAAC,KAAK,IAAmB,EAAE;QACrC,MAAM,KAAK,CAAC,KAAK,CAAC,CAAA;QAClB,mBAAmB,EAAE,CAAA;QACrB,MAAM,GAAG,EAAE,CAAA;IACb,CAAC,CAAiB,CAAA;IAElB,GAAG,CAAC,KAAK,GAAG,KAAK,CAAA;IACjB,GAAG,CAAC,GAAG,GAAG,GAAG,CAAA;IACb,OAAO,GAAG,CAAA;AACZ,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,UAAU,qBAAqB,CAEnC,GAAG,IAAO;IACV,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAA;IAC9B,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YAClB,MAAM,IAAI,KAAK,CACb,sBAAsB,GAAG,6DAA6D,CACvF,CAAA;QACH,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;IACf,CAAC;IAED,MAAM,MAAM,GAAG,EAA0C,CAAA;IACzD,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,CAAC,GAAgB,CAAC,GAAG,mBAAmB,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,EAAE;YAC/D,mBAAmB,EAAE,CAAA;YACrB,QAAQ,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAA;QACjC,CAAC,CAAC,CAAA;IACJ,CAAC;IACD,OAAO,MAAM,CAAA;AACf,CAAC;AAMD,MAAM,+BAA+B,GAAG,IAAI,GAAG,CAAsB,CAAC,OAAO,CAAC,CAAC,CAAA;AAC/E,MAAM,sBAAsB,GAAG,IAAI,GAAG,CAAO,kBAAkB,CAAC,CAAA;AAEhE;;;GAGG;AACH,SAAS,iBAAiB,CAAC,IAAY,EAAE,MAAc;IACrD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,CAAC,IAAI,MAAM,GAAG,eAAe,EAAE,CAAC;QACvE,MAAM,IAAI,KAAK,CACb,6BAA6B,IAAI,gDAAgD,eAAe,qEAAqE,CACtK,CAAA;IACH,CAAC;IACD,OAAO,MAAM,CAAA;AACf,CAAC;AAED,SAAS,oBAAoB,CAAC,KAAkB;IAC9C,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,CAAA;IACtC,CAAC;IAED,IAAI,MAAM,IAAI,KAAK,EAAE,CAAC;QACpB,OAAO;YACL,IAAI,EAAE,MAAM;YACZ,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,GAAG,CAAC,KAAK,CAAC,MAAM,KAAK,SAAS,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC;SAC5D,CAAA;IACH,CAAC;IAED,MAAM,SAAS,GAAG,OAAO,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAA;IAE7D,OAAO;QACL,IAAI,EAAE,MAAM;QACZ,IAAI,EAAE,SAAS;QACf,GAAG,CAAC,KAAK,CAAC,QAAQ,KAAK,SAAS,IAAI,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC;QACjE,GAAG,CAAC,KAAK,CAAC,MAAM,KAAK,SAAS,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC;KAC5D,CAAA;AACH,CAAC;AAED,SAAS,eAAe,CACtB,IAAU,EACV,KAA6D;IAE7D,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAA;IACzC,IAAI,MAAM,IAAI,KAAK,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CACb,sCAAsC,IAAI,sCAAsC,IAAI,wDAAwD,CAC7I,CAAA;IACH,CAAC;IAED,IAAI,QAAQ,IAAI,KAAK,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CACb,sCAAsC,IAAI,gDAAgD,IAAI,iCAAiC,CAChI,CAAA;IACH,CAAC;IAED,OAAO,MAAM,CAAC,WAAW,CACvB,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,MAAM,CAC1B,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE,CACR,CAAC,+BAA+B,CAAC,GAAG,CAAC,GAA0B,CAAC,CACnE,CAC6B,CAAA;AAClC,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAgC;IACxD,IAAI,gBAAgB,CAAC,KAAK,CAAC;QAAE,OAAO,UAAU,KAAK,CAAC,IAAI,EAAE,CAAA;IAC1D,OAAO,KAAK,CAAA;AACd,CAAC;AAED,SAAS,uBAAuB,CAC9B,KAAoE;IAEpE,MAAM,SAAS,GAEX,EAAE,CAAA;IAEN,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACjD,IAAI,GAAG,KAAK,OAAO,EAAE,CAAC;YACpB,SAAQ;QACV,CAAC;QAED,IAAI,CAAC,sBAAsB,CAAC,GAAG,CAAC,GAAW,CAAC,EAAE,CAAC;YAC7C,MAAM,IAAI,KAAK,CACb,uDAAuD,GAAG,mEAAmE,CAC9H,CAAA;QACH,CAAC;QAED,SAAS,CAAC,GAAW,CAAC,GAAG,KAAmD,CAAA;IAC9E,CAAC;IAED,OAAO,SAAS,CAAA;AAClB,CAAC;AAED,SAAS,kBAAkB,CACzB,QAA6B,EAC7B,SAA4E;IAE5E,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,SAAS,CAAW,CAAA;IAC9C,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,CAAC,CAAA;IAC1B,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CACb,+EAA+E,CAChF,CAAA;IACH,CAAC;IAED,gDAAgD;IAChD,MAAM,cAAc,GAAG,IAAI,GAAG,EAAqC,CAAA;IACnE,MAAM,iBAAiB,GAAG,IAAI,GAAG,EAA6B,CAAA;IAE9D,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,CAAC,CAAA;QAC7B,MAAM,YAAY,GAAG,KAAK,EAAE,KAAK,CAAA;QACjC,MAAM,kBAAkB,GAAG,YAAY,EAAE,IAAI,IAAI,QAAQ,CAAC,IAAI,CAAA;QAC9D,MAAM,aAAa,GAAG,YAAY,EAAE,IAAI,CAAA;QACxC,yEAAyE;QACzE,oEAAoE;QACpE,MAAM,cAAc,GAClB,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAA;QAClE,MAAM,eAAe,GACnB,YAAY,KAAK,SAAS;YACxB,CAAC,CAAC,YAAY,EAAE,MAAM;YACtB,CAAC,CAAC,QAAQ,IAAI,QAAQ;gBACpB,CAAC,CAAE,QAAgC,CAAC,MAAM;gBAC1C,CAAC,CAAC,SAAS,CAAA;QACjB,MAAM,eAAe,GACnB,YAAY,KAAK,SAAS;YACxB,CAAC,CAAC,YAAY,EAAE,MAAM;YACtB,CAAC,CAAC,QAAQ,IAAI,QAAQ;gBACpB,CAAC,CAAE,QAAyC,CAAC,MAAM;gBACnD,CAAC,CAAC,SAAS,CAAA;QACjB,MAAM,kBAAkB,GACtB,YAAY,KAAK,SAAS;YACxB,CAAC,CAAC,WAAW,IAAI,YAAY;gBAC3B,CAAC,CAAC,YAAY,CAAC,SAAS;gBACxB,CAAC,CAAC,SAAS;YACb,CAAC,CAAC,WAAW,IAAI,QAAQ;gBACvB,CAAC,CAAC,QAAQ,CAAC,SAAS;gBACpB,CAAC,CAAC,SAAS,CAAA;QACjB,MAAM,wBAAwB,GAC5B,YAAY,KAAK,SAAS;YACxB,CAAC,CAAC,iBAAiB,IAAI,YAAY;gBACjC,CAAC,CAAC,YAAY,CAAC,eAAe;gBAC9B,CAAC,CAAC,SAAS;YACb,CAAC,CAAC,iBAAiB,IAAI,QAAQ;gBAC7B,CAAC,CAAC,QAAQ,CAAC,eAAe;gBAC1B,CAAC,CAAC,SAAS,CAAA;QACjB,MAAM,cAAc,GAClB,YAAY,KAAK,SAAS;YACxB,CAAC,CAAC,OAAO,IAAI,YAAY;gBACvB,CAAC,CAAC,YAAY,CAAC,KAAK;gBACpB,CAAC,CAAC,SAAS;YACb,CAAC,CAAC,OAAO,IAAI,QAAQ;gBACnB,CAAC,CAAC,QAAQ,CAAC,KAAK;gBAChB,CAAC,CAAC,SAAS,CAAA;QACjB,MAAM,wBAAwB,GAC5B,YAAY,KAAK,SAAS;YACxB,CAAC,CAAC,iBAAiB,IAAI,YAAY;gBACjC,CAAC,CAAC,YAAY,CAAC,eAAe;gBAC9B,CAAC,CAAC,SAAS;YACb,CAAC,CAAC,iBAAiB,IAAI,QAAQ;gBAC7B,CAAC,CAAC,QAAQ,CAAC,eAAe;gBAC1B,CAAC,CAAC,SAAS,CAAA;QACjB,MAAM,kBAAkB,GACtB,OAAO,cAAc,KAAK,QAAQ;YAChC,CAAC,CAAC,YAAY;YACd,CAAC,CAAC,CAAC,YAAY,EAAE,SAAS,IAAI,QAAQ,CAAC,SAAS,CAAC,CAAA;QAErD,gCAAgC,CAC9B,kBAAkB,EAClB,mBAAmB,IAAI,GAAG,CAC3B,CAAA;QAED,cAAc,CAAC,GAAG,CAAC,IAAI,EAAE,kBAAkB,CAAC,CAAA;QAC5C,iBAAiB,CAAC,GAAG,CAAC,IAAI,EAAE;YAC1B,IAAI,EAAE,gBAAgB,CAAC,kBAAkB,CAAC;YAC1C,GAAG,CAAC,aAAa,KAAK,SAAS,IAAI,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC;YAC3D,GAAG,CAAC,kBAAkB,KAAK,SAAS,IAAI;gBACtC,SAAS,EAAE,kBAAkB;aAC9B,CAAC;YACF,GAAG,CAAC,cAAc,KAAK,SAAS,IAAI,EAAE,KAAK,EAAE,cAAc,EAAE,CAAC;YAC9D,GAAG,CAAC,eAAe,KAAK,SAAS,IAAI,EAAE,MAAM,EAAE,eAAe,EAAE,CAAC;YACjE,GAAG,CAAC,eAAe,KAAK,SAAS,IAAI,EAAE,MAAM,EAAE,eAAe,EAAE,CAAC;YACjE,GAAG,CAAC,kBAAkB,KAAK,SAAS,IAAI;gBACtC,SAAS,EAAE,kBAAkB;aAC9B,CAAC;YACF,GAAG,CAAC,wBAAwB,KAAK,SAAS,IAAI;gBAC5C,eAAe,EAAE,wBAAwB;aAC1C,CAAC;YACF,GAAG,CAAC,cAAc,KAAK,SAAS,IAAI,EAAE,KAAK,EAAE,cAAc,EAAE,CAAC;YAC9D,GAAG,CAAC,wBAAwB,KAAK,SAAS,IAAI;gBAC5C,eAAe,EAAE,wBAAwB;aAC1C,CAAC;SACH,CAAC,CAAA;IACJ,CAAC;IAED,MAAM,UAAU,GAAG,SAAS,CAAC,SAAS,CAAC,CAAA;IACvC,IAAI,CAAC,UAAU;QAAE,OAAO,EAAuC,CAAA;IAE/D,MAAM,MAAM,GAAG,EAAuC,CAAA;IAEtD,MAAM,SAAS,GAAG,eAAe,CAAC,SAAS,EAAE,UAAU,CAAC,CAAA;IACxD,IAAI,SAAS,KAAK,SAAS;QAAE,OAAO,EAAuC,CAAA;IAE3E,KAAK,MAAM,GAAG,IAAI,SAAS,EAAE,CAAC;QAC5B,MAAM,MAAM,GAAG,GAAG,CAAA;QAElB,MAAM,gBAAgB,GAAG,IAAI,GAAG,EAA+B,CAAA;QAE/D,2FAA2F;QAC3F,IAAI,YAAY,GAAG,KAAK,CAAA;QACxB,8EAA8E;QAC9E,iDAAiD;QACjD,IAAI,SAA6B,CAAA;QACjC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,GAAG,GAAG,eAAe,CAAC,IAAI,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,CAAA;YAC5D,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;gBACtB,MAAM,UAAU,GAAG,oBAAoB,CAAC,GAAG,CAAC,CAAA;gBAC5C,gBAAgB,CAAC,GAAG,CAAC,IAAI,EAAE,UAAU,CAAC,CAAA;gBACtC,IAAI,UAAU,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;oBAC/B,YAAY,GAAG,IAAI,CAAA;gBACrB,CAAC;gBACD,IAAI,SAAS,KAAK,SAAS,IAAI,UAAU,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;oBAC/D,SAAS,GAAG,iBAAiB,CAAC,MAAM,EAAE,UAAU,CAAC,MAAM,CAAC,CAAA;gBAC1D,CAAC;YACH,CAAC;QACH,CAAC;QAED,IAAI,YAAY,EAAE,CAAC;YACjB,MAAM,CAAC,MAAM,CAAC,GAAG,mBAAmB,CAAC,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE;gBAC9D,MAAM,YAAY,GAAG,yBAAyB,EAAE,CAAC,YAAY,CAAA;gBAC7D,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;oBACzB,QAAQ,CAAC,oBAAoB,CAAC,IAAI,EAAE,iBAAiB,CAAC,GAAG,CAAC,IAAI,CAAE,CAAC,CAAA;gBACnE,CAAC;gBACD,MAAM,iBAAiB,GAAwC,EAAE,CAAA;gBACjE,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;oBACzB,MAAM,GAAG,GAAG,gBAAgB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;oBACtC,IAAI,GAAG,KAAK,SAAS;wBAAE,SAAQ;oBAC/B,MAAM,KAAK,GAAG,cAAc,CAAC,GAAG,CAAC,IAAI,CAAE,CAAA;oBACvC,MAAM,IAAI,GAAG,iBAAiB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;oBACxC,MAAM,SAAS,GAAG,IAAI,EAAE,SAAS,CAAA;oBACjC,MAAM,KAAK,GAAG,IAAI,EAAE,KAAK,CAAA;oBACzB,MAAM,MAAM,GAAG,IAAI,EAAE,MAAM,CAAA;oBAC3B,MAAM,MAAM,GAAG,IAAI,EAAE,MAAM,CAAA;oBAC3B,MAAM,SAAS,GAAG,IAAI,EAAE,SAAS,CAAA;oBACjC,MAAM,eAAe,GAAG,IAAI,EAAE,eAAe,CAAA;oBAC7C,MAAM,KAAK,GAAG,IAAI,EAAE,KAAK,CAAA;oBACzB,MAAM,eAAe,GAAG,IAAI,EAAE,eAAe,CAAA;oBAC7C,MAAM,IAAI,GAAG,IAAI,EAAE,IAAI,CAAA;oBACvB,IAAI,GAAG,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;wBACxB,iBAAiB,CAAC,IAAI,CAAC,GAAG;4BACxB,IAAI,EAAE,GAAG,CAAC,IAAI;4BACd,KAAK,EAAE,MAAM,eAAe,CAAC,KAAK,CAAC;4BACnC,GAAG,CAAC,SAAS,KAAK,SAAS,IAAI,EAAE,SAAS,EAAE,CAAC;4BAC7C,GAAG,CAAC,KAAK,KAAK,SAAS,IAAI,EAAE,KAAK,EAAE,CAAC;4BACrC,GAAG,CAAC,MAAM,KAAK,SAAS,IAAI,EAAE,MAAM,EAAE,CAAC;4BACvC,GAAG,CAAC,MAAM,KAAK,SAAS,IAAI,EAAE,MAAM,EAAE,CAAC;4BACvC,GAAG,CAAC,SAAS,KAAK,SAAS,IAAI,EAAE,SAAS,EAAE,CAAC;4BAC7C,GAAG,CAAC,eAAe,KAAK,SAAS,IAAI,EAAE,eAAe,EAAE,CAAC;4BACzD,GAAG,CAAC,KAAK,KAAK,SAAS,IAAI,EAAE,KAAK,EAAE,CAAC;4BACrC,GAAG,CAAC,eAAe,KAAK,SAAS,IAAI,EAAE,eAAe,EAAE,CAAC;4BACzD,GAAG,CAAC,IAAI,KAAK,SAAS,IAAI,EAAE,IAAI,EAAE,CAAC;yBACpC,CAAA;oBACH,CAAC;yBAAM,CAAC;wBACN,iBAAiB,CAAC,IAAI,CAAC,GAAG,MAAM,uBAAuB,CACrD,YAAY,EACZ;4BACE,IAAI,EAAE,GAAG,CAAC,IAAI;4BACd,GAAG,CAAC,GAAG,CAAC,QAAQ,KAAK,SAAS,IAAI,EAAE,QAAQ,EAAE,GAAG,CAAC,QAAQ,EAAE,CAAC;yBAC9D,CACF,CAAA;oBACH,CAAC;gBACH,CAAC;gBACD,mBAAmB,EAAE,CAAA;gBACrB,QAAQ,CAAC,gBAAgB,CACvB,MAAM,EACN,SAAS,EACT,SAAS,EACT,SAAS,EACT,iBAAiB;gBACjB,8DAA8D;gBAC9D,6CAA6C;gBAC7C,GAAG,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAChD,CAAA;YACH,CAAC,CAAC,CAAA;QACJ,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,MAAM,CAAC,GAAG,mBAAmB,CAAC,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE;gBAC9D,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;oBACzB,QAAQ,CAAC,oBAAoB,CAAC,IAAI,EAAE,iBAAiB,CAAC,GAAG,CAAC,IAAI,CAAE,CAAC,CAAA;gBACnE,CAAC;gBACD,MAAM,gBAAgB,GAAmC,EAAE,CAAA;gBAC3D,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;oBACzB,MAAM,GAAG,GAAG,gBAAgB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;oBACtC,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;wBAC7C,MAAM,KAAK,GAAG,cAAc,CAAC,GAAG,CAAC,IAAI,CAAE,CAAA;wBACvC,MAAM,IAAI,GAAG,iBAAiB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;wBACxC,MAAM,SAAS,GAAG,IAAI,EAAE,SAAS,CAAA;wBACjC,MAAM,KAAK,GAAG,IAAI,EAAE,KAAK,CAAA;wBACzB,MAAM,MAAM,GAAG,IAAI,EAAE,MAAM,CAAA;wBAC3B,MAAM,MAAM,GAAG,IAAI,EAAE,MAAM,CAAA;wBAC3B,MAAM,SAAS,GAAG,IAAI,EAAE,SAAS,CAAA;wBACjC,MAAM,eAAe,GAAG,IAAI,EAAE,eAAe,CAAA;wBAC7C,MAAM,KAAK,GAAG,IAAI,EAAE,KAAK,CAAA;wBACzB,MAAM,eAAe,GAAG,IAAI,EAAE,eAAe,CAAA;wBAC7C,MAAM,IAAI,GAAG,IAAI,EAAE,IAAI,CAAA;wBACvB,gBAAgB,CAAC,IAAI,CAAC,GAAG;4BACvB,IAAI,EAAE,GAAG,CAAC,IAAI;4BACd,KAAK,EAAE,MAAM,eAAe,CAAC,KAAK,CAAC;4BACnC,GAAG,CAAC,SAAS,KAAK,SAAS,IAAI,EAAE,SAAS,EAAE,CAAC;4BAC7C,GAAG,CAAC,KAAK,KAAK,SAAS,IAAI,EAAE,KAAK,EAAE,CAAC;4BACrC,GAAG,CAAC,MAAM,KAAK,SAAS,IAAI,EAAE,MAAM,EAAE,CAAC;4BACvC,GAAG,CAAC,MAAM,KAAK,SAAS,IAAI,EAAE,MAAM,EAAE,CAAC;4BACvC,GAAG,CAAC,SAAS,KAAK,SAAS,IAAI,EAAE,SAAS,EAAE,CAAC;4BAC7C,GAAG,CAAC,eAAe,KAAK,SAAS,IAAI,EAAE,eAAe,EAAE,CAAC;4BACzD,GAAG,CAAC,KAAK,KAAK,SAAS,IAAI,EAAE,KAAK,EAAE,CAAC;4BACrC,GAAG,CAAC,eAAe,KAAK,SAAS,IAAI,EAAE,eAAe,EAAE,CAAC;4BACzD,GAAG,CAAC,IAAI,KAAK,SAAS,IAAI,EAAE,IAAI,EAAE,CAAC;yBACpC,CAAA;oBACH,CAAC;gBACH,CAAC;gBACD,mBAAmB,EAAE,CAAA;gBACrB,QAAQ,CAAC,WAAW,CAClB,EAAE,EACF,MAAM,EACN,SAAS,EACT,gBAAgB;gBAChB,8DAA8D;gBAC9D,6CAA6C;gBAC7C,GAAG,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAChD,CAAA;YACH,CAAC,CAAC,CAAA;QACJ,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAA;AACf,CAAC;AAED,KAAK,UAAU,uBAAuB,CACpC,YAA2B,EAC3B,KAAmD;IAEnD,MAAM,IAAI,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAA;IAC3D,MAAM,QAAQ,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAA;IACvE,OAAO;QACL,SAAS,EAAE,MAAM,oBAAoB,CAAC,IAAI,EAAE,YAAY,CAAC;QACzD,SAAS,EAAE,IAAI;QACf,GAAG,CAAC,QAAQ,KAAK,SAAS,IAAI,EAAE,QAAQ,EAAE,CAAC;KAC5C,CAAA;AACH,CAAC"}

package/dist/src/defaults.d.ts

@@ -12,6 +12,12 @@ export declare const DEFAULT_ASPECT_RATIO: AspectRatio;
  * Default resolution quality preset
  */
 export declare const DEFAULT_QUALITY: Quality;
+/**
+ * Default device scale factor (DPR) for screenshots. Stills default to 2 so they
+ * are crisp; override with `recordOptions.deviceScaleFactor`. Video ignores this
+ * (the screencast encoder needs frames at the viewport resolution).
+ */
+export declare const DEFAULT_SCREENSHOT_DEVICE_SCALE_FACTOR = 2;
 /**
  * Default frames per second for video recording
  */

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

@@ -1 +1 @@
-{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../../src/defaults.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EACX,eAAe,EACf,GAAG,EACH,OAAO,EACP,kBAAkB,EAClB,aAAa,EACb,kBAAkB,EACnB,MAAM,YAAY,CAAA;AAQnB,eAAO,MAAM,oBAAoB,EAAE,QAAQ,CAAC,eAAe,CAQ1D,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,iCAAiC,EAAE,MAAY,CAAA;AAE5D;;GAEG;AACH,eAAO,MAAM,oBAAoB,EAAE,WAAoB,CAAA;AAEvD;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,OAAiB,CAAA;AAE/C;;GAEG;AACH,eAAO,MAAM,WAAW,EAAE,GAAQ,CAAA;AAElC;;GAEG;AACH,eAAO,MAAM,iBAAiB,EAAE,MAAmB,CAAA;AAEnD;;GAEG;AACH,eAAO,MAAM,4BAA4B,EAAE,kBAAkC,CAAA;AAE7E;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,MAAuB,CAAA;AAErD;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,EAAE,MAAe,CAAA;AAEpD;;;;GAIG;AACH,eAAO,MAAM,0BAA0B,EAAE,MAAe,CAAA;AAExD;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,EAAE,kBAA2B,CAAA;AAE/D;;GAEG;AACH,eAAO,MAAM,qBAAqB,EAAE,aAKnC,CAAA"}
+{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../../src/defaults.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EACX,eAAe,EACf,GAAG,EACH,OAAO,EACP,kBAAkB,EAClB,aAAa,EACb,kBAAkB,EACnB,MAAM,YAAY,CAAA;AAQnB,eAAO,MAAM,oBAAoB,EAAE,QAAQ,CAAC,eAAe,CAQ1D,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,iCAAiC,EAAE,MAAY,CAAA;AAE5D;;GAEG;AACH,eAAO,MAAM,oBAAoB,EAAE,WAAoB,CAAA;AAEvD;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,OAAiB,CAAA;AAE/C;;;;GAIG;AACH,eAAO,MAAM,sCAAsC,IAAI,CAAA;AAEvD;;GAEG;AACH,eAAO,MAAM,WAAW,EAAE,GAAQ,CAAA;AAElC;;GAEG;AACH,eAAO,MAAM,iBAAiB,EAAE,MAAmB,CAAA;AAEnD;;GAEG;AACH,eAAO,MAAM,4BAA4B,EAAE,kBAAkC,CAAA;AAE7E;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,MAAuB,CAAA;AAErD;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,EAAE,MAAe,CAAA;AAEpD;;;;GAIG;AACH,eAAO,MAAM,0BAA0B,EAAE,MAAe,CAAA;AAExD;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,EAAE,kBAA2B,CAAA;AAE/D;;GAEG;AACH,eAAO,MAAM,qBAAqB,EAAE,aAKnC,CAAA"}

package/dist/src/defaults.js

@@ -25,6 +25,12 @@ export const DEFAULT_ASPECT_RATIO = '16:9';
  * Default resolution quality preset
  */
 export const DEFAULT_QUALITY = '1080p';
+/**
+ * Default device scale factor (DPR) for screenshots. Stills default to 2 so they
+ * are crisp; override with `recordOptions.deviceScaleFactor`. Video ignores this
+ * (the screencast encoder needs frames at the viewport resolution).
+ */
+export const DEFAULT_SCREENSHOT_DEVICE_SCALE_FACTOR = 2;
 /**
  * Default frames per second for video recording
  */

package/dist/src/defaults.js.map

@@ -1 +1 @@
-{"version":3,"file":"defaults.js","sourceRoot":"","sources":["../../src/defaults.ts"],"names":[],"mappings":"AAUA,aAAa;AACb,4EAA4E;AAC5E,wBAAwB;AACxB,0BAA0B;AAC1B,+BAA+B;AAC/B,cAAc;AACd,MAAM,CAAC,MAAM,oBAAoB,GAA8B;IAC7D,MAAM,EAAE,UAAU;IAClB,QAAQ,EAAE,GAAG;IACb,MAAM,EAAE,IAAI;IACZ,OAAO,EAAE,GAAG;IACZ,SAAS,EAAE,CAAC;IACZ,YAAY,EAAE,CAAC;IACf,aAAa,EAAE,GAAG;CACnB,CAAA;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,iCAAiC,GAAW,GAAG,CAAA;AAE5D;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAgB,MAAM,CAAA;AAEvD;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAY,OAAO,CAAA;AAE/C;;GAEG;AACH,MAAM,CAAC,MAAM,WAAW,GAAQ,EAAE,CAAA;AAElC;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAW,UAAU,CAAA;AAEnD;;GAEG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAuB,aAAa,CAAA;AAE7E;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAW,EAAE,GAAG,EAAE,GAAG,IAAI,CAAA;AAErD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAW,MAAM,CAAA;AAEpD;;;;GAIG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAW,MAAM,CAAA;AAExD;;;;GAIG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAuB,MAAM,CAAA;AAE/D;;GAEG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAkB;IAClD,WAAW,EAAE,oBAAoB;IACjC,OAAO,EAAE,eAAe;IACxB,GAAG,EAAE,WAAW;IAChB,OAAO,EAAE,qBAAqB;CAC/B,CAAA"}
+{"version":3,"file":"defaults.js","sourceRoot":"","sources":["../../src/defaults.ts"],"names":[],"mappings":"AAUA,aAAa;AACb,4EAA4E;AAC5E,wBAAwB;AACxB,0BAA0B;AAC1B,+BAA+B;AAC/B,cAAc;AACd,MAAM,CAAC,MAAM,oBAAoB,GAA8B;IAC7D,MAAM,EAAE,UAAU;IAClB,QAAQ,EAAE,GAAG;IACb,MAAM,EAAE,IAAI;IACZ,OAAO,EAAE,GAAG;IACZ,SAAS,EAAE,CAAC;IACZ,YAAY,EAAE,CAAC;IACf,aAAa,EAAE,GAAG;CACnB,CAAA;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,iCAAiC,GAAW,GAAG,CAAA;AAE5D;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAgB,MAAM,CAAA;AAEvD;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAY,OAAO,CAAA;AAE/C;;;;GAIG;AACH,MAAM,CAAC,MAAM,sCAAsC,GAAG,CAAC,CAAA;AAEvD;;GAEG;AACH,MAAM,CAAC,MAAM,WAAW,GAAQ,EAAE,CAAA;AAElC;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAW,UAAU,CAAA;AAEnD;;GAEG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAuB,aAAa,CAAA;AAE7E;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAW,EAAE,GAAG,EAAE,GAAG,IAAI,CAAA;AAErD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAW,MAAM,CAAA;AAEpD;;;;GAIG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAW,MAAM,CAAA;AAExD;;;;GAIG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAuB,MAAM,CAAA;AAE/D;;GAEG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAkB;IAClD,WAAW,EAAE,oBAAoB;IACjC,OAAO,EAAE,eAAe;IACxB,GAAG,EAAE,WAAW;IAChB,OAAO,EAAE,qBAAqB;CAC/B,CAAA"}

package/dist/src/dimensions.d.ts

@@ -26,6 +26,12 @@ export declare function getDimensions(aspectRatio: AspectRatio, quality: Quality
     width: number;
     height: number;
 };
+/**
+ * Convert an {@link AspectRatio} (e.g. `'16:9'`) to its `width / height` number.
+ * Parses the `'W:H'` form; malformed input returns `NaN` so callers can validate
+ * and report it.
+ */
+export declare function aspectRatioToNumber(value: AspectRatio): number;
 export declare function getViewportCenter(dimensions: {
     width: number;
     height: number;

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

@@ -1 +1 @@
-{"version":3,"file":"dimensions.d.ts","sourceRoot":"","sources":["../../src/dimensions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AAEtD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,aAAa,CAC3B,WAAW,EAAE,WAAW,EACxB,OAAO,EAAE,OAAO,GACf;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAwBnC;AAED,wBAAgB,iBAAiB,CAAC,UAAU,EAAE;IAC5C,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;CACf,GAAG;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAK3B"}
+{"version":3,"file":"dimensions.d.ts","sourceRoot":"","sources":["../../src/dimensions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AAEtD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,aAAa,CAC3B,WAAW,EAAE,WAAW,EACxB,OAAO,EAAE,OAAO,GACf;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAwBnC;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CAO9D;AAED,wBAAgB,iBAAiB,CAAC,UAAU,EAAE;IAC5C,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;CACf,GAAG;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAK3B"}

package/dist/src/dimensions.js

@@ -44,6 +44,21 @@ export function getDimensions(aspectRatio, quality) {
     };
     return dimensions[aspectRatio];
 }
+/**
+ * Convert an {@link AspectRatio} (e.g. `'16:9'`) to its `width / height` number.
+ * Parses the `'W:H'` form; malformed input returns `NaN` so callers can validate
+ * and report it.
+ */
+export function aspectRatioToNumber(value) {
+    const parts = value.split(':');
+    if (parts.length !== 2)
+        return NaN;
+    const w = Number(parts[0]);
+    const h = Number(parts[1]);
+    if (!Number.isFinite(w) || !Number.isFinite(h) || h === 0)
+        return NaN;
+    return w / h;
+}
 export function getViewportCenter(dimensions) {
     return {
         x: Math.floor(dimensions.width / 2),

package/dist/src/dimensions.js.map

@@ -1 +1 @@
-{"version":3,"file":"dimensions.js","sourceRoot":"","sources":["../../src/dimensions.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,UAAU,aAAa,CAC3B,WAAwB,EACxB,OAAgB;IAEhB,qDAAqD;IACrD,MAAM,QAAQ,GAA4B;QACxC,MAAM,EAAE,GAAG;QACX,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,IAAI;KACd,CAAA;IACD,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAA;IAE9B,mEAAmE;IACnE,oEAAoE;IACpE,uDAAuD;IACvD,MAAM,UAAU,GAA2D;QACzE,MAAM,EAAE,EAAE,KAAK,EAAE,CAAC,IAAI,GAAG,EAAE,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE;QAChD,MAAM,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,IAAI,GAAG,EAAE,CAAC,GAAG,CAAC,EAAE;QAChD,KAAK,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE;QACpC,KAAK,EAAE,EAAE,KAAK,EAAE,CAAC,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE;QAC9C,KAAK,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,EAAE;QAC9C,KAAK,EAAE,EAAE,KAAK,EAAE,CAAC,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE;QAC9C,KAAK,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,EAAE;KAC/C,CAAA;IAED,OAAO,UAAU,CAAC,WAAW,CAAC,CAAA;AAChC,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,UAGjC;IACC,OAAO;QACL,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,KAAK,GAAG,CAAC,CAAC;QACnC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC;KACrC,CAAA;AACH,CAAC"}
+{"version":3,"file":"dimensions.js","sourceRoot":"","sources":["../../src/dimensions.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,UAAU,aAAa,CAC3B,WAAwB,EACxB,OAAgB;IAEhB,qDAAqD;IACrD,MAAM,QAAQ,GAA4B;QACxC,MAAM,EAAE,GAAG;QACX,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,IAAI;KACd,CAAA;IACD,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAA;IAE9B,mEAAmE;IACnE,oEAAoE;IACpE,uDAAuD;IACvD,MAAM,UAAU,GAA2D;QACzE,MAAM,EAAE,EAAE,KAAK,EAAE,CAAC,IAAI,GAAG,EAAE,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE;QAChD,MAAM,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,IAAI,GAAG,EAAE,CAAC,GAAG,CAAC,EAAE;QAChD,KAAK,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE;QACpC,KAAK,EAAE,EAAE,KAAK,EAAE,CAAC,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE;QAC9C,KAAK,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,EAAE;QAC9C,KAAK,EAAE,EAAE,KAAK,EAAE,CAAC,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE;QAC9C,KAAK,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,EAAE;KAC/C,CAAA;IAED,OAAO,UAAU,CAAC,WAAW,CAAC,CAAA;AAChC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAkB;IACpD,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;IAC9B,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,GAAG,CAAA;IAClC,MAAM,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA;IAC1B,MAAM,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA;IAC1B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,GAAG,CAAA;IACrE,OAAO,CAAC,GAAG,CAAC,CAAA;AACd,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,UAGjC;IACC,OAAO;QACL,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,KAAK,GAAG,CAAC,CAAC;QACnC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC;KACrC,CAAA;AACH,CAAC"}

package/dist/src/events.d.ts

@@ -1,4 +1,5 @@
 import type { AutoZoomOptions, CueConfig, Easing, RecordOptions, RenderOptions, ResolvedRenderOptions } from './types.js';
+import type { ScreenshotCropRecord } from './crop.js';
 import { type StudioRenderOptionsSentinel } from './studio.js';
 import type { VoiceKey } from './voices.js';
 import { type PerformanceIntervals } from './performance.js';
@@ -140,6 +141,13 @@ export type CueStartEvent = {
     cueConfig?: CueConfig;
     /** Multi-language API — all language translations keyed by language code */
     translations?: Record<string, CueTranslation>;
+    /**
+     * Linear gain applied to this cue's narration audio at mix time (`1` is the
+     * natural level, `0` mutes it, values above `1` boost it). It is a render-time
+     * mix property, not a generation setting: it is deliberately kept out of the
+     * translations so it never changes the audio cache key. Omitted plays at unity.
+     */
+    volume?: number;
 };
 export type CueEndEvent = {
     type: 'cueEnd';
@@ -191,17 +199,27 @@ export type VideoCueStartEvent = {
     subtitle?: string;
     /** Multi-language API — per-language translations keyed by language code. */
     translations?: Record<string, VideoCueTranslation>;
+    /**
+     * Linear gain applied to this cue's narration audio at mix time (`1` is the
+     * natural level). A render-time mix property kept out of the translations so it
+     * never affects the audio cache key. Omitted plays at unity. See
+     * {@link CueStartEvent.volume}.
+     */
+    volume?: number;
 };
 /**
- * Placement of a visual asset overlay. Coordinates are normalized 0-1 fractions
- * of a reference box, with the asset anchored at its top-left corner.
+ * Placement of a visual asset overlay. Coordinates are CSS pixels in the
+ * recording viewport (the same space Playwright's `boundingBox()`, `page.mouse`,
+ * and `viewportSize()` use), with the asset anchored at its top-left corner. The
+ * renderer maps these recording-viewport pixels into the final output frame, so
+ * the output size never has to be known when the recording is authored.
  *
  * - `fullScreen` fills the entire output frame.
  * - The positioned variants place the asset against the full output frame
  *   (`relativeTo: 'screen'`) or the composited recording area
  *   (`relativeTo: 'recording'`, the default). Provide exactly one of `width` or
  *   `height`; the other dimension is derived from the asset's intrinsic aspect
- *   ratio.
+ *   ratio, or from `aspectRatio` (width / height) when given.
  */
 export type OverlayPlacement = {
     fullScreen: true;
@@ -210,11 +228,13 @@ export type OverlayPlacement = {
     x: number;
     y: number;
     width: number;
+    aspectRatio?: number;
 } | {
     relativeTo: 'screen' | 'recording';
     x: number;
     y: number;
     height: number;
+    aspectRatio?: number;
 };
 /**
  * Asset format policy is recorded explicitly so renderers never need to infer
@@ -245,6 +265,20 @@ export type VideoAssetStartEvent = {
     audio: number;
     fullScreen: boolean;
     placement?: OverlayPlacement;
+    /**
+     * Playback-rate multiplier for the overlay video (and its audio). `2` plays
+     * it twice as fast, `0.5` at half speed. Omitted plays at the natural rate.
+     * For a blocking overlay this also shortens/lengthens the frozen window it
+     * holds (so later content shifts); a live overlay keeps its window and just
+     * plays the source faster/slower inside it.
+     */
+    speed?: number;
+    /**
+     * Target playback duration (ms) for the overlay video, an alternative to
+     * {@link speed}: the effective rate is the source duration divided by this.
+     * Takes precedence over `speed` when both are set.
+     */
+    time?: number;
 };
 /**
  * An animated HTML/React overlay captured to a single alpha-preserving video.
@@ -283,6 +317,48 @@ export type AssetEndEvent = {
     reason?: 'auto' | 'wait';
 };
 export type AssetStartEvent = ImageAssetStartEvent | VideoAssetStartEvent | AnimationAssetStartEvent;
+/**
+ * The resolved markup and render parameters captured during the test for a
+ * rendered (HTML/React) or animated overlay whose rasterization is deferred to
+ * after the test body succeeds. `css` is already merged with the global default
+ * (frozen at call time). These fields fully determine the rasterized bytes, so
+ * they double as the in-run de-duplication key (see `overlayInputHash`).
+ */
+export type DeferredRasterizeRequest = {
+    kind: 'image';
+    name: string;
+    html: string;
+    css: string;
+    capturePadding: number;
+    deviceScaleFactor: number;
+} | {
+    kind: 'animation';
+    name: string;
+    html: string;
+    css: string;
+    capturePadding: number;
+    deviceScaleFactor: number;
+    fps: number;
+    durationMs: number;
+};
+/**
+ * A recorded `assetStart` whose `path`/`fileHash` are not yet known because its
+ * overlay is rasterized after the test. The `event` reference is the same object
+ * pushed into the recorder's event list, so patching it in place updates what
+ * `writeToFile` serializes.
+ */
+export type PendingOverlay = {
+    event: ImageAssetStartEvent | AnimationAssetStartEvent;
+    request: DeferredRasterizeRequest;
+};
+/** Payload for {@link IEventRecorder.addPendingAssetStart}. */
+export type PendingAssetStart = {
+    kind: 'image' | 'animation';
+    durationMs?: number;
+    fullScreen: boolean;
+    placement?: OverlayPlacement;
+    request: DeferredRasterizeRequest;
+};
 export type AssetStartPayload = Omit<ImageAssetStartEvent, 'type' | 'timeMs' | 'name'> | Omit<VideoAssetStartEvent, 'type' | 'timeMs' | 'name'> | Omit<AnimationAssetStartEvent, 'type' | 'timeMs' | 'name'>;
 /**
  * Asset declared via `createStudioOverlays` — the file and display options are
@@ -310,6 +386,18 @@ export type AudioStartEvent = {
     fileHash?: string;
     volume: number;
     repeat: boolean;
+    /**
+     * Playback-rate multiplier for the track. `2` plays it twice as fast, `0.5`
+     * at half speed. Omitted plays at the natural rate. The track keeps its
+     * output span; only the source is consumed faster/slower (no timeline shift).
+     */
+    speed?: number;
+    /**
+     * Target playback duration (ms) for the track, an alternative to
+     * {@link speed}: the effective rate is the source duration divided by this.
+     * Takes precedence over `speed` when both are set.
+     */
+    time?: number;
 };
 /**
  * End marker for a background audio track. `name` pairs it to its
@@ -405,7 +493,7 @@ export type RecordingMetadata = {
     sourceFilePath?: string;
     /**
      * Which parts of this recording opted into Studio configuration.
-     * `renderOptions` is set when `STUDIO_RENDER_OPTIONS` was used; `narration`
+     * `renderOptions` is set when `renderOptions: 'studio'` was used; `narration`
      * when the recording contains `createStudioNarration` cues; `assets` when it
      * contains `createStudioOverlays` assets; `audio` when it contains
      * `createStudioAudio` tracks.
@@ -417,11 +505,48 @@ export type RecordingMetadata = {
         audio?: boolean;
     };
 };
+/** Crop rect for a screenshot, in CSS pixels of the recording viewport. */
+export type ScreenshotCrop = {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+};
+/**
+ * Capture details for a screenshot output. The raw page capture is saved beside
+ * `data.json` (as `path`) at `width`×`height` device pixels (the viewport scaled
+ * by `deviceScaleFactor`). The crop is a render option
+ * (`renderOptions.screenshot.crop`), not a capture detail.
+ */
+export type ScreenshotInfo = {
+    path: string;
+    width: number;
+    height: number;
+    deviceScaleFactor: number;
+};
 export type RecordingData = {
     events: RecordingEvent[];
     renderOptions: ResolvedRenderOptions;
     recordOptions?: RecordOptions;
     metadata?: RecordingMetadata;
+    /**
+     * Output kind for this recording. Absent is treated as `'video'` so existing
+     * recordings, stored versions, and manifests keep working without migration.
+     */
+    output?: 'video' | 'screenshot';
+    /** Capture details. Present only when `output === 'screenshot'`. */
+    screenshot?: ScreenshotInfo;
+};
+/** Extra, output-specific fields written into `data.json`. */
+export type WriteRecordingOptions = {
+    output?: 'video' | 'screenshot';
+    screenshot?: ScreenshotInfo;
+    /**
+     * Crop recorded at capture time (a `crop()` call or `page.screenshot({ crop })`).
+     * Merged into `renderOptions.screenshot.crop`, overriding any crop set in
+     * config, so it is editable in Studio afterward.
+     */
+    crop?: ScreenshotCropRecord;
 };
 export interface IEventRecorder {
     start(): void;
@@ -432,12 +557,26 @@ export interface IEventRecorder {
      */
     addInput(subType: InputEvent['subType'], elementRect: ElementRect | undefined, events: InputEvent['events']): void;
     addInput(subType: InputEvent['subType'], events: InputEvent['events']): void;
-    addCueStart(text: string, name: string, cueConfig?: CueConfig, translations?: Record<string, CueTranslation>): void;
+    addCueStart(text: string, name: string, cueConfig?: CueConfig, translations?: Record<string, CueTranslation>, volume?: number): void;
     /** Records a studio-mode cue start — text and voice are configured in Studio. */
     addStudioCueStart(name: string): void;
     addCueEnd(reason?: 'auto' | 'wait'): void;
-    addVideoCueStart(name: string, assetPath: string | undefined, assetHash: string | undefined, subtitle?: string, translations?: Record<string, VideoCueTranslation>): void;
+    addVideoCueStart(name: string, assetPath: string | undefined, assetHash: string | undefined, subtitle?: string, translations?: Record<string, VideoCueTranslation>, volume?: number): void;
     addAssetStart(name: string, asset: AssetStartPayload): void;
+    /**
+     * Records a rendered/animated overlay `assetStart` whose bytes are produced
+     * after the test. The event is pushed at the current timeline position with a
+     * placeholder `path` and no `fileHash`; the deferred flush rasterizes the
+     * captured {@link DeferredRasterizeRequest} and patches the event in place.
+     */
+    addPendingAssetStart(name: string, pending: PendingAssetStart): void;
+    /**
+     * The overlays awaiting deferred rasterization, in record order. Each entry's
+     * `event` is the live object in the recording, so the flush patches it
+     * directly. Empty for the no-op recorder and for runs without deferred
+     * overlays.
+     */
+    getPendingOverlays(): readonly PendingOverlay[];
     /**
      * Records the end of a `start()`/`end()`-driven asset overlay. `name`
      * identifies which overlay ended (overlays may overlap), so the renderer can
@@ -471,11 +610,12 @@ export interface IEventRecorder {
      */
     registerVoiceForLang(lang: string, meta: VoiceLanguageMeta): void;
     getEvents(): RecordingEvent[];
-    writeToFile(dir: string, videoName: string, sourceFilePath?: string): Promise<void>;
+    writeToFile(dir: string, videoName: string, sourceFilePath?: string, options?: WriteRecordingOptions): Promise<void>;
 }
 export declare const NOOP_EVENT_RECORDER: IEventRecorder;
 export declare class EventRecorder implements IEventRecorder {
     private readonly events;
+    private readonly pendingOverlays;
     private startTime;
     private readonly recordOptions;
     private readonly renderOptions;
@@ -487,11 +627,13 @@ export declare class EventRecorder implements IEventRecorder {
     private getInputEventBounds;
     private relativizeFocusChangeEvent;
     addInput(subType: InputEvent['subType'], elementRectOrEvents: ElementRect | InputEvent['events'] | undefined, maybeEvents?: InputEvent['events']): void;
-    addCueStart(text: string, name: string, cueConfig?: CueConfig, translations?: Record<string, CueTranslation>): void;
+    addCueStart(text: string, name: string, cueConfig?: CueConfig, translations?: Record<string, CueTranslation>, volume?: number): void;
     addStudioCueStart(name: string): void;
     addCueEnd(reason?: 'auto' | 'wait'): void;
-    addVideoCueStart(name: string, assetPath: string | undefined, assetHash: string | undefined, subtitle?: string, translations?: Record<string, VideoCueTranslation>): void;
+    addVideoCueStart(name: string, assetPath: string | undefined, assetHash: string | undefined, subtitle?: string, translations?: Record<string, VideoCueTranslation>, volume?: number): void;
     addAssetStart(name: string, asset: AssetStartPayload): void;
+    addPendingAssetStart(name: string, pending: PendingAssetStart): void;
+    getPendingOverlays(): readonly PendingOverlay[];
     addAssetEnd(name: string | undefined, reason?: 'auto' | 'wait'): void;
     addStudioAssetStart(name: string): void;
     addAudioStart(name: string, audio: AudioStartPayload): void;
@@ -507,6 +649,6 @@ export declare class EventRecorder implements IEventRecorder {
     addAutoZoomStart(options?: AutoZoomOptions): void;
     addAutoZoomEnd(options?: AutoZoomOptions): void;
     getEvents(): RecordingEvent[];
-    writeToFile(dir: string, videoName: string, sourceFilePath?: string): Promise<void>;
+    writeToFile(dir: string, videoName: string, sourceFilePath?: string, options?: WriteRecordingOptions): Promise<void>;
 }
 //# sourceMappingURL=events.d.ts.map