screenci 0.0.85 → 0.0.87

package/dist/src/anonSession.d.ts

@@ -1,5 +1,13 @@
+export declare const ANON_SESSION_FILE = "anon-session.json";
 export declare const ANON_TOKEN_HEADER = "X-ScreenCI-Anon-Token";
 export declare const SECRET_HEADER = "X-ScreenCI-Secret";
+export declare const SCREENCI_TERMS_URL = "https://screenci.com/legal/tos";
+/**
+ * Single-line browsewrap notice shown on the anonymous trial path. Kept pure
+ * (no logger dependency) so it is trivially unit-testable and reusable in both
+ * the up-front record gate and the post-upload summary.
+ */
+export declare function formatAnonTermsNotice(): string;
 export type CliCredential = {
     header: typeof SECRET_HEADER;
     value: string;
@@ -22,19 +30,38 @@ export type AnonSessionStatus = {
     status: 'expired';
 } | {
     status: 'pending';
+    used: boolean;
 } | {
     status: 'claimed';
     secret: string;
 };
 /**
- * Checks the server-side status of a locally stored anon token before every
- * upload attempt: still pending (proceed anonymously), claimed (the CLI
- * should self-upgrade to the real secret), or expired/not found (start a
- * fresh trial). Defaults to `pending` on a network failure so a transient
- * outage doesn't block an otherwise-working anonymous upload.
+ * Checks the server-side status of a locally stored anon token: still pending
+ * (with `used` telling whether the one free trial recording is already spent),
+ * claimed (the CLI should self-upgrade to the real secret), or expired/not
+ * found. Defaults to a fresh, unused `pending` on a network failure so a
+ * transient outage doesn't block an otherwise-working first anonymous upload.
  */
 export declare function checkAnonSessionStatus(token: string, options?: {
     backendUrl?: string;
     fetchImpl?: typeof fetch;
 }): Promise<AnonSessionStatus>;
+export type AnonRecordingGate = {
+    allowed: true;
+} | {
+    allowed: false;
+    reason: 'used' | 'expired';
+};
+/**
+ * Decides whether a fresh anonymous `record` is allowed to START, given the
+ * session's current status. An anonymous trial gets exactly one recording:
+ * once it is used (a pending session that already spent its trial) or the
+ * session has expired, a second recording is refused up front so the user is
+ * told to sign up before anything renders, rather than silently minting a new
+ * trial or only failing after the whole recording ran. A first-run token the
+ * server has not seen yet (`not_found`), a pending-but-unused session, and a
+ * `claimed` session (the upload path self-upgrades to the real secret) all
+ * proceed.
+ */
+export declare function evaluateAnonRecordingGate(status: AnonSessionStatus): AnonRecordingGate;
 //# sourceMappingURL=anonSession.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"anonSession.d.ts","sourceRoot":"","sources":["../../src/anonSession.ts"],"names":[],"mappings":"AAaA,eAAO,MAAM,iBAAiB,0BAA0B,CAAA;AACxD,eAAO,MAAM,aAAa,sBAAsB,CAAA;AAEhD,MAAM,MAAM,aAAa,GACrB;IAAE,MAAM,EAAE,OAAO,aAAa,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC/C;IAAE,MAAM,EAAE,OAAO,iBAAiB,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAA;AAEvD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,CAE9D;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa,CAE3D;AA+BD,wBAAsB,qBAAqB,CACzC,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,IAAI,CAAC,CASf;AAED;;;;GAIG;AACH,wBAAsB,oBAAoB,CACxC,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,MAAM,CAAC,CAOjB;AAED,MAAM,MAAM,iBAAiB,GACzB;IAAE,MAAM,EAAE,WAAW,CAAA;CAAE,GACvB;IAAE,MAAM,EAAE,SAAS,CAAA;CAAE,GACrB;IAAE,MAAM,EAAE,SAAS,CAAA;CAAE,GACrB;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAA;AAEzC;;;;;;GAMG;AACH,wBAAsB,sBAAsB,CAC1C,KAAK,EAAE,MAAM,EACb,OAAO,GAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,OAAO,KAAK,CAAA;CAAO,GAC9D,OAAO,CAAC,iBAAiB,CAAC,CAwB5B"}
+{"version":3,"file":"anonSession.d.ts","sourceRoot":"","sources":["../../src/anonSession.ts"],"names":[],"mappings":"AAgBA,eAAO,MAAM,iBAAiB,sBAAsB,CAAA;AAEpD,eAAO,MAAM,iBAAiB,0BAA0B,CAAA;AACxD,eAAO,MAAM,aAAa,sBAAsB,CAAA;AAOhD,eAAO,MAAM,kBAAkB,mCAAmC,CAAA;AAElE;;;;GAIG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,CAE9C;AAED,MAAM,MAAM,aAAa,GACrB;IAAE,MAAM,EAAE,OAAO,aAAa,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC/C;IAAE,MAAM,EAAE,OAAO,iBAAiB,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAA;AAEvD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,CAE9D;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa,CAE3D;AA+BD,wBAAsB,qBAAqB,CACzC,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,IAAI,CAAC,CASf;AAED;;;;GAIG;AACH,wBAAsB,oBAAoB,CACxC,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,MAAM,CAAC,CAOjB;AAED,MAAM,MAAM,iBAAiB,GACzB;IAAE,MAAM,EAAE,WAAW,CAAA;CAAE,GACvB;IAAE,MAAM,EAAE,SAAS,CAAA;CAAE,GAErB;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,GACpC;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAA;AAEzC;;;;;;GAMG;AACH,wBAAsB,sBAAsB,CAC1C,KAAK,EAAE,MAAM,EACb,OAAO,GAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,OAAO,KAAK,CAAA;CAAO,GAC9D,OAAO,CAAC,iBAAiB,CAAC,CAyB5B;AAED,MAAM,MAAM,iBAAiB,GACzB;IAAE,OAAO,EAAE,IAAI,CAAA;CAAE,GACjB;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAA;AAElD;;;;;;;;;;GAUG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,iBAAiB,GACxB,iBAAiB,CAMnB"}

package/dist/src/anonSession.js

@@ -7,9 +7,28 @@ import { getDevBackendUrl } from './linkSession.js';
 // under a locally generated token instead of requiring an account up front.
 // The token lives only in `.screenci/anon-session.json` and, server-side, in
 // the anonymousSessions table (never printed or embedded in any URL).
-const ANON_SESSION_FILE = 'anon-session.json';
+// The anon session token file lives directly inside `.screenci/`, alongside
+// the per-recording directories. It must survive the per-run wipe of that
+// directory (see clearRecordingDirectories), or every `record` would mint a
+// fresh trial and the one-recording cap, claim, and auto-graduate would all
+// break. Exported so the wipe can preserve it by name.
+export const ANON_SESSION_FILE = 'anon-session.json';
 export const ANON_TOKEN_HEADER = 'X-ScreenCI-Anon-Token';
 export const SECRET_HEADER = 'X-ScreenCI-Secret';
+// Canonical Terms of Service URL. Hardcoded like the docs links elsewhere in
+// the CLI (the legal pages are not environment-specific). Anonymous trial
+// recordings upload to our servers without an account, so the CLI surfaces this
+// up front (before recording) and again in the post-upload summary. Signed-in
+// users accept the versioned Terms server-side in the web app instead.
+export const SCREENCI_TERMS_URL = 'https://screenci.com/legal/tos';
+/**
+ * Single-line browsewrap notice shown on the anonymous trial path. Kept pure
+ * (no logger dependency) so it is trivially unit-testable and reusable in both
+ * the up-front record gate and the post-upload summary.
+ */
+export function formatAnonTermsNotice() {
+    return `By recording an anonymous ScreenCI trial you agree to the Terms: ${SCREENCI_TERMS_URL}`;
+}
 export function secretCredential(secret) {
     return { header: SECRET_HEADER, value: secret };
 }
@@ -59,11 +78,11 @@ export async function getOrCreateAnonToken(screenciDir) {
     return token;
 }
 /**
- * Checks the server-side status of a locally stored anon token before every
- * upload attempt: still pending (proceed anonymously), claimed (the CLI
- * should self-upgrade to the real secret), or expired/not found (start a
- * fresh trial). Defaults to `pending` on a network failure so a transient
- * outage doesn't block an otherwise-working anonymous upload.
+ * Checks the server-side status of a locally stored anon token: still pending
+ * (with `used` telling whether the one free trial recording is already spent),
+ * claimed (the CLI should self-upgrade to the real secret), or expired/not
+ * found. Defaults to a fresh, unused `pending` on a network failure so a
+ * transient outage doesn't block an otherwise-working first anonymous upload.
  */
 export async function checkAnonSessionStatus(token, options = {}) {
     const backendUrl = options.backendUrl ?? getDevBackendUrl();
@@ -82,10 +101,29 @@ export async function checkAnonSessionStatus(token, options = {}) {
             return { status: 'expired' };
         if (body.status === 'not_found')
             return { status: 'not_found' };
-        return { status: 'pending' };
+        return { status: 'pending', used: body.used === true };
     }
     catch {
-        return { status: 'pending' };
+        return { status: 'pending', used: false };
+    }
+}
+/**
+ * Decides whether a fresh anonymous `record` is allowed to START, given the
+ * session's current status. An anonymous trial gets exactly one recording:
+ * once it is used (a pending session that already spent its trial) or the
+ * session has expired, a second recording is refused up front so the user is
+ * told to sign up before anything renders, rather than silently minting a new
+ * trial or only failing after the whole recording ran. A first-run token the
+ * server has not seen yet (`not_found`), a pending-but-unused session, and a
+ * `claimed` session (the upload path self-upgrades to the real secret) all
+ * proceed.
+ */
+export function evaluateAnonRecordingGate(status) {
+    if (status.status === 'expired')
+        return { allowed: false, reason: 'expired' };
+    if (status.status === 'pending' && status.used) {
+        return { allowed: false, reason: 'used' };
     }
+    return { allowed: true };
 }
 //# sourceMappingURL=anonSession.js.map

package/dist/src/anonSession.js.map

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

package/dist/src/asset.d.ts

@@ -111,15 +111,16 @@ type OverlayCommon = {
      */
     pinToScreen?: boolean;
     /**
-     * Hide the synthetic mouse cursor while this overlay is displayed, restoring
-     * its prior visibility when the overlay ends. Useful for full-screen intro or
-     * outro cards where a cursor would be a distraction. Placement-agnostic, so it
-     * works for every overlay variant. Overlapping `hideMouse` overlays keep the
-     * cursor hidden until the last one ends, and a cursor already hidden (for
-     * example via `page.mouse.hide()`) is left hidden. Has no effect on
+     * Draw this overlay ABOVE the synthetic mouse cursor, so the cursor passes
+     * underneath it instead of on top. The cursor stays visible everywhere else in
+     * the frame; only where the overlay sits does the overlay cover it. Useful for
+     * full-screen intro or outro cards (the cursor disappears behind the card) and
+     * for HUD elements like a corner logo the cursor should slide under.
+     * Placement-agnostic, so it works for every overlay variant. Overlapping
+     * `overMouse` overlays each draw above the cursor. Has no effect on
      * screenshots, whose cursor is hidden by default.
      */
-    hideMouse?: boolean;
+    overMouse?: boolean;
 };
 /** Fields that only apply to a `.mp4` video overlay (a file `path`). */
 type OverlayVideoFields = {
@@ -230,7 +231,7 @@ export declare const MAX_AUDIO_LEVEL = 4;
  * is a finished still or clip, so source-only fields (`over`/`margin`/`animate`/
  * `css`/`capturePadding`) do not apply.
  */
-export type DependencyOverlayOptions = Pick<OverlayCommon, 'relativeTo' | 'x' | 'y' | 'width' | 'height' | 'aspectRatio' | 'fill' | 'duration' | 'crop' | 'pinToScreen' | 'hideMouse'> & {
+export type DependencyOverlayOptions = Pick<OverlayCommon, 'relativeTo' | 'x' | 'y' | 'width' | 'height' | 'aspectRatio' | 'fill' | 'duration' | 'crop' | 'pinToScreen' | 'overMouse'> & {
     /**
      * Late start into the embedded VIDEO (a `'2s'`/timecode/`'50%'` position).
      * Video dependencies only; rejected when the target resolves to a screenshot.

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

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

package/dist/src/asset.js

@@ -1,6 +1,5 @@
 import { timelineAnchorFields, } from './events.js';
 import { parseTimelineOffset } from './timelineOffset.js';
-import { isMouseVisible } from './mouse.js';
 import { validateCrop, resolveSourceTrim } from './sourceTrim.js';
 import { overlayRect } from './overlayRect.js';
 import { captureCallerFile } from './callerFile.js';
@@ -10,7 +9,7 @@ import { dirname, resolve } from 'path';
 import { resolveRecordingTimingDuration } from './runtimeMode.js';
 import { resolveOverlayCss, DEFAULT_OVERLAY_DEVICE_SCALE_FACTOR, DEFAULT_ANIMATION_FPS, } from './htmlRasterizer.js';
 export { setOverlayCss } from './htmlRasterizer.js';
-import { getScreenCIRuntimeContext, getRuntimeAssetRecorder, getRuntimePage, getRuntimeRecordingDir, setRuntimeAssetRecorder, resetAssetRuntimeState, isScreenshotCapture, } from './runtimeContext.js';
+import { getScreenCIRuntimeContext, getRuntimeAssetRecorder, getRuntimePage, getRuntimeRecordingDir, setRuntimeAssetRecorder, resetAssetRuntimeState, } from './runtimeContext.js';
 /**
  * Upper bound for an audio level (linear gain). `4` is +12 dB, plenty of
  * headroom for a boost while guarding against accidental extreme distortion.
@@ -277,7 +276,7 @@ function buildOverlayFromConfig(name, config) {
     });
     const fullScreen = config.fill === 'screen';
     const pinToScreen = config.pinToScreen === true;
-    const hideMouse = config.hideMouse === true;
+    const overMouse = config.overMouse === true;
     const animate = config.animate === true;
     // Parse the relative `duration` string into ms once; reused by every branch.
     const configDurationMs = resolveConfigDuration(name, config.duration);
@@ -313,9 +312,9 @@ function buildOverlayFromConfig(name, config) {
             ? () => renderElementToMarkup(name, config.element)
             : () => Promise.resolve(config.html);
         if (animate) {
-            return createAnimatedOverlayController(name, getMarkup, placementSource, fullScreen, pinToScreen, hideMouse, config.fps, configDurationMs, renderOpts);
+            return createAnimatedOverlayController(name, getMarkup, placementSource, fullScreen, pinToScreen, overMouse, config.fps, configDurationMs, renderOpts);
         }
-        return createRenderedOverlayController(name, getMarkup, placementSource, fullScreen, pinToScreen, hideMouse, configDurationMs, renderOpts);
+        return createRenderedOverlayController(name, getMarkup, placementSource, fullScreen, pinToScreen, overMouse, configDurationMs, renderOpts);
     }
     const path = config.path;
     const extension = getAssetExtension(path);
@@ -346,9 +345,9 @@ function buildOverlayFromConfig(name, config) {
         registerAssetPath(path);
         const getMarkup = () => readHtmlOverlayFile(path);
         if (animate) {
-            return createAnimatedOverlayController(name, getMarkup, placementSource, fullScreen, pinToScreen, hideMouse, config.fps, configDurationMs, renderOpts);
+            return createAnimatedOverlayController(name, getMarkup, placementSource, fullScreen, pinToScreen, overMouse, config.fps, configDurationMs, renderOpts);
         }
-        return createRenderedOverlayController(name, getMarkup, placementSource, fullScreen, pinToScreen, hideMouse, configDurationMs, renderOpts);
+        return createRenderedOverlayController(name, getMarkup, placementSource, fullScreen, pinToScreen, overMouse, configDurationMs, renderOpts);
     }
     // File-backed image / video overlays.
     if (extension === '.svg' || extension === '.png') {
@@ -365,9 +364,10 @@ function buildOverlayFromConfig(name, config) {
             ...(placement !== undefined && { placement }),
             fullScreen,
             ...(pinToScreen && { pinToScreen: true }),
+            ...(overMouse && { overMouse: true }),
             ...(configDurationMs !== undefined && { durationMs: configDurationMs }),
             ...(config.crop !== undefined && { crop: config.crop }),
-        }, hideMouse);
+        });
     }
     if (extension === '.mp4') {
         if (config.duration !== undefined) {
@@ -391,13 +391,14 @@ function buildOverlayFromConfig(name, config) {
             ...(placement !== undefined && { placement }),
             fullScreen,
             ...(pinToScreen && { pinToScreen: true }),
+            ...(overMouse && { overMouse: true }),
             ...(config.volume !== undefined && { audio: config.volume }),
             ...(config.speed !== undefined && { speed: config.speed }),
             ...(config.time !== undefined && { time: config.time }),
             ...(config.crop !== undefined && { crop: config.crop }),
             ...(sourceStart !== undefined && { sourceStart }),
             ...(sourceEnd !== undefined && { sourceEnd }),
-        }, hideMouse);
+        });
     }
     throw new Error(`[screenci] Overlay "${name}" must use one of: .html, .svg, .png, .mp4. Received: ${path}`);
 }
@@ -628,7 +629,7 @@ function resolveConfigDuration(name, duration) {
         return undefined;
     return resolveRelativeDuration(duration, `Overlay "${name}" duration`);
 }
-function createActiveAssetRun(startedWithExplicitStart, hideMouse) {
+function createActiveAssetRun(startedWithExplicitStart) {
     let resolve;
     const finished = new Promise((resolveFn) => {
         resolve = resolveFn;
@@ -637,7 +638,6 @@ function createActiveAssetRun(startedWithExplicitStart, hideMouse) {
         finished,
         resolveFinished: resolve,
         startedWithExplicitStart,
-        hideMouse,
     };
 }
 /**
@@ -653,63 +653,10 @@ function endLiveAsset(name, reason) {
     getRuntimeAssetRecorder().addAssetEnd(name, reason);
     sleepForAssetFrameGap();
     context.asset.activeRuns.delete(name);
-    if (run.hideMouse)
-        performOverlayMouseShow();
     run.resolveFinished();
 }
-/**
- * Hide the cursor for a `hideMouse` overlay, ref-counted so overlapping overlays
- * only hide once. Reuses the instrumented `page.mouse.hide()`, which records the
- * `mouseHide` event on the shared recorder. When emitted before a blocking
- * overlay's `assetStart`, that event brackets the frozen hold in the rendered
- * timeline (the show emitted after `assetStart` lands past the hold).
- */
-function performOverlayMouseHide() {
-    // Stills hide the cursor by default (see renderOptions.screenshot.mouse.show)
-    // and have no timeline to bracket, so hideMouse is a no-op for screenshots.
-    if (isScreenshotCapture())
-        return;
-    const page = getRuntimePage();
-    if (page === null)
-        return;
-    const state = getScreenCIRuntimeContext().asset.mouseHide;
-    state.count += 1;
-    // Only the first overlay in an overlapping group changes visibility.
-    if (state.count !== 1)
-        return;
-    // A cursor already hidden (e.g. via page.mouse.hide()) is left as-is, and we
-    // remember not to force it back on when the overlay ends.
-    if (!isMouseVisible(page)) {
-        state.hiddenByOverlay = false;
-        return;
-    }
-    state.hiddenByOverlay = true;
-    page.mouse.hide();
-}
-/**
- * Restore the cursor when a `hideMouse` overlay ends. Only acts once the
- * ref-count returns to 0, and only if an overlay was the one that hid it (so a
- * cursor that was already hidden stays hidden).
- */
-function performOverlayMouseShow() {
-    if (isScreenshotCapture())
-        return;
-    const page = getRuntimePage();
-    if (page === null)
-        return;
-    const state = getScreenCIRuntimeContext().asset.mouseHide;
-    if (state.count === 0)
-        return;
-    state.count -= 1;
-    if (state.count !== 0)
-        return;
-    if (!state.hiddenByOverlay)
-        return;
-    state.hiddenByOverlay = false;
-    page.mouse.show();
-}
 function createAssetControllerCore(name, validate, emitStart, options = {}) {
-    const { prepare, hideMouse = false } = options;
+    const { prepare } = options;
     const start = async (startedWithExplicitStart = true) => {
         await validate();
         await prepare?.({ type: 'live' });
@@ -718,10 +665,8 @@ function createAssetControllerCore(name, validate, emitStart, options = {}) {
         if (context.asset.activeRuns.has(name)) {
             throw new Error(`[screenci] Overlay "${name}" is already started. Call end() for it before starting it again.`);
         }
-        const run = createActiveAssetRun(startedWithExplicitStart, hideMouse);
+        const run = createActiveAssetRun(startedWithExplicitStart);
         context.asset.activeRuns.set(name, run);
-        if (hideMouse)
-            performOverlayMouseHide();
         emitStart(recorder, { type: 'live' });
     };
     const end = async () => {
@@ -740,14 +685,7 @@ function createAssetControllerCore(name, validate, emitStart, options = {}) {
         await validate();
         await prepare?.(mode);
         const recorder = getRuntimeAssetRecorder();
-        // Order is load-bearing: the mouseHide must precede the assetStart and the
-        // mouseShow follow it, so the renderer's frozen hold (inserted at the
-        // assetStart) is bracketed by the hide/show in the final timeline.
-        if (hideMouse)
-            performOverlayMouseHide();
         emitStart(recorder, mode);
-        if (hideMouse)
-            performOverlayMouseShow();
     };
     const controller = (async () => {
         // Bare call: hold for the source's natural length. Length-less overlays
@@ -818,14 +756,15 @@ function createDependencyOverlayController(name, input) {
             ...timelineAnchorFields(until),
             fullScreen,
             ...(pinToScreen && { pinToScreen: true }),
+            ...(input.config.overMouse === true && { overMouse: true }),
             ...(placement !== undefined && { placement }),
             ...(input.config.crop !== undefined && { crop: input.config.crop }),
             ...(sourceStart !== undefined && { sourceStart }),
             ...(sourceEnd !== undefined && { sourceEnd }),
         });
-    }, { hideMouse: input.config.hideMouse === true });
+    });
 }
-function createFileOverlayController(name, resolved, hideMouse) {
+function createFileOverlayController(name, resolved) {
     return createAssetControllerCore(name, async () => {
         const testFilePath = getScreenCIRuntimeContext().testFilePath;
         if (testFilePath !== null) {
@@ -833,13 +772,13 @@ function createFileOverlayController(name, resolved, hideMouse) {
         }
     }, (recorder, mode) => {
         recorder.addAssetStart(name, toRecordedFileStart(name, resolved, mode));
-    }, { hideMouse });
+    });
 }
 /**
  * An overlay rendered to a transparent PNG at recording time, from either an
  * HTML file or a React element. `getMarkup` produces the HTML to rasterize.
  */
-function createRenderedOverlayController(name, getMarkup, placementSource, fullScreen, pinToScreen, hideMouse, durationMs, renderOpts = {}) {
+function createRenderedOverlayController(name, getMarkup, placementSource, fullScreen, pinToScreen, overMouse, durationMs, renderOpts = {}) {
     // The markup and placement are resolved during the test (cheap:
     // renderToStaticMarkup / a string, plus a boundingBox read for `over`), but
     // rasterization (a browser screenshot) is deferred to after the test so
@@ -875,6 +814,7 @@ function createRenderedOverlayController(name, getMarkup, placementSource, fullS
             ...timelineAnchorFields(until),
             fullScreen,
             ...(pinToScreen && { pinToScreen: true }),
+            ...(overMouse && { overMouse: true }),
             ...(resolvedPlacement !== undefined && {
                 placement: resolvedPlacement,
             }),
@@ -904,7 +844,6 @@ function createRenderedOverlayController(name, getMarkup, placementSource, fullS
             resolvedHtml =
                 sizePx !== undefined ? sizeWrapMarkup(markup, sizePx) : markup;
         },
-        hideMouse,
     });
 }
 /**
@@ -918,7 +857,7 @@ function createRenderedOverlayController(name, getMarkup, placementSource, fullS
  * the recording, the old "hide block" that cut capture wall-clock from the
  * timeline is no longer needed.
  */
-function createAnimatedOverlayController(name, getMarkup, placementSource, fullScreen, pinToScreen, hideMouse, fps, configDurationMs, renderOpts = {}) {
+function createAnimatedOverlayController(name, getMarkup, placementSource, fullScreen, pinToScreen, overMouse, fps, configDurationMs, renderOpts = {}) {
     let resolved;
     let skipped = false;
     const resolveDurationMs = (mode) => {
@@ -951,6 +890,7 @@ function createAnimatedOverlayController(name, getMarkup, placementSource, fullS
             durationMs: resolved.durationMs,
             fullScreen,
             ...(pinToScreen && { pinToScreen: true }),
+            ...(overMouse && { overMouse: true }),
             ...(resolved.placement !== undefined && {
                 placement: resolved.placement,
             }),
@@ -982,7 +922,6 @@ function createAnimatedOverlayController(name, getMarkup, placementSource, fullS
                 ...(placement !== undefined && { placement }),
             };
         },
-        hideMouse,
     });
 }
 function getAssetExtension(path) {
@@ -1205,6 +1144,7 @@ function toRecordedFileStart(name, resolved, mode) {
             ...timelineAnchorFields(until),
             fullScreen: resolved.fullScreen,
             ...(resolved.pinToScreen && { pinToScreen: true }),
+            ...(resolved.overMouse && { overMouse: true }),
             ...(resolved.placement !== undefined && {
                 placement: resolved.placement,
             }),
@@ -1223,6 +1163,7 @@ function toRecordedFileStart(name, resolved, mode) {
         audio: resolved.audio ?? 1,
         fullScreen: resolved.fullScreen,
         ...(resolved.pinToScreen && { pinToScreen: true }),
+        ...(resolved.overMouse && { overMouse: true }),
         ...(resolved.placement !== undefined && { placement: resolved.placement }),
         ...(resolved.speed !== undefined && { speed: resolved.speed }),
         ...(resolved.time !== undefined && { time: resolved.time }),