screenci 0.0.76 → 0.0.78

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

@@ -0,0 +1 @@
+{"version":3,"file":"recordingSize.d.ts","sourceRoot":"","sources":["../../src/recordingSize.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA;AAgBxC,MAAM,MAAM,sBAAsB,GAAG;IACnC,uEAAuE;IACvE,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,kEAAkE;IAClE,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB,CAAA;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,eAAe,CACnC,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,sBAAsB,GAC/B,OAAO,CAAC,IAAI,CAAC,CASf;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC,CAKxD"}

package/dist/src/recordingSize.js

@@ -0,0 +1,54 @@
+import { ScreenciError } from './errors.js';
+import { getActiveHideRecorder } from './timelineBlock.js';
+import { getRuntimeRecordingSize, setRuntimeRecordingSize, } from './runtimeContext.js';
+/**
+ * Full-screen size: the recording fills the output frame, with one side
+ * touching the background edge.
+ */
+const FULL_SCREEN_SIZE = 1;
+function assertValidSize(size) {
+    if (!Number.isFinite(size) || size <= 0 || size > 1) {
+        throw new ScreenciError(`resizeRecording(size) requires size in (0, 1]; received ${size}`);
+    }
+}
+/**
+ * Shrinks the recording to a limited size, revealing the styled background
+ * around it from this point on.
+ *
+ * `size` is a 0-1 fraction of the full frame: `1` is full screen, `0.8` shows
+ * the recording at 80% of the frame, centered. Call {@link resetRecordingSize}
+ * to return to full screen.
+ *
+ * Pass `duration` to animate the transition over that many milliseconds.
+ * Use `easing` to control the animation curve (defaults to `'ease-out'`).
+ *
+ * @example
+ * ```ts
+ * await resizeRecording(0.8, { duration: 400, easing: 'ease-in-out' })
+ * await page.getByRole('button', { name: 'Continue' }).click()
+ * await resetRecordingSize()
+ * ```
+ */
+export async function resizeRecording(size, options) {
+    assertValidSize(size);
+    const recorder = getActiveHideRecorder();
+    if (options !== undefined) {
+        recorder.addRecordingSizeStart(size, options);
+    }
+    else {
+        recorder.addRecordingSizeStart(size);
+    }
+    setRuntimeRecordingSize(size);
+}
+/**
+ * Returns the recording to full screen (size 1) from this point on. No-op when
+ * the recording is already full screen.
+ */
+export async function resetRecordingSize() {
+    if (getRuntimeRecordingSize() === FULL_SCREEN_SIZE)
+        return;
+    const recorder = getActiveHideRecorder();
+    recorder.addRecordingSizeEnd();
+    setRuntimeRecordingSize(FULL_SCREEN_SIZE);
+}
+//# sourceMappingURL=recordingSize.js.map

package/dist/src/recordingSize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recordingSize.js","sourceRoot":"","sources":["../../src/recordingSize.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAC3C,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAA;AAC1D,OAAO,EACL,uBAAuB,EACvB,uBAAuB,GACxB,MAAM,qBAAqB,CAAA;AAG5B;;;GAGG;AACH,MAAM,gBAAgB,GAAG,CAAC,CAAA;AAE1B,SAAS,eAAe,CAAC,IAAY;IACnC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,IAAI,GAAG,CAAC,EAAE,CAAC;QACpD,MAAM,IAAI,aAAa,CACrB,2DAA2D,IAAI,EAAE,CAClE,CAAA;IACH,CAAC;AACH,CAAC;AASD;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,IAAY,EACZ,OAAgC;IAEhC,eAAe,CAAC,IAAI,CAAC,CAAA;IACrB,MAAM,QAAQ,GAAG,qBAAqB,EAAE,CAAA;IACxC,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,QAAQ,CAAC,qBAAqB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;IAC/C,CAAC;SAAM,CAAC;QACN,QAAQ,CAAC,qBAAqB,CAAC,IAAI,CAAC,CAAA;IACtC,CAAC;IACD,uBAAuB,CAAC,IAAI,CAAC,CAAA;AAC/B,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB;IACtC,IAAI,uBAAuB,EAAE,KAAK,gBAAgB;QAAE,OAAM;IAC1D,MAAM,QAAQ,GAAG,qBAAqB,EAAE,CAAA;IACxC,QAAQ,CAAC,mBAAmB,EAAE,CAAA;IAC9B,uBAAuB,CAAC,gBAAgB,CAAC,CAAA;AAC3C,CAAC"}

package/dist/src/redact.d.ts

@@ -0,0 +1,68 @@
+import type { Locator, Page } from '@playwright/test';
+import type { RedactHandle, RedactOptions } from './types.js';
+import { type ResolvedRedactStyle } from './redactController.js';
+/** Default corner radius (px) for the mask. */
+export declare const DEFAULT_REDACT_RADIUS = 12;
+/** Default mask shadow. Reads as a raised chip so a redaction is obvious. */
+export declare const DEFAULT_REDACT_SHADOW = "0 2px 8px rgba(0,0,0,0.25)";
+/**
+ * How long `redact()` waits for at least one matching element before masking,
+ * so a redact issued just before the element renders does not silently no-op.
+ */
+export declare const REDACT_ATTACH_TIMEOUT_MS = 5000;
+/**
+ * Resolve user-facing {@link RedactOptions} to the concrete pixel values the
+ * in-page controller applies. Pure (no page access), so it is unit-testable on
+ * its own.
+ */
+export declare function resolveRedactStyle(options?: RedactOptions): ResolvedRedactStyle;
+/**
+ * Make sure the in-page controller is installed. `addInitScript` covers every
+ * future document (registered once per recording); the extra `evaluate` covers
+ * the document that is already open when `redact()` is first called. Both are
+ * idempotent.
+ */
+export declare function ensureRedactControllerInstalled(page: Page): Promise<void>;
+/**
+ * Install the in-page controller on a freshly created page, before its first
+ * navigation, so masks apply from the first painted frame. Also registers the
+ * `recordOptions.redact` first-paint selectors. Called once per page from the
+ * video fixture; the runtime flag is set on the passed context (which is not yet
+ * the active context at page-creation time).
+ */
+export declare function installRedactController(page: Page, redactState: {
+    controllerInstalled: boolean;
+}, configSelectors?: string[]): Promise<void>;
+/**
+ * Mask the element(s) matched by `locator` so the content never enters the
+ * recording. The mask is applied client side in the live DOM, so the obscured
+ * pixels are never captured and never uploaded to screenci. This is true
+ * redaction, unlike {@link cover}, which only hides content in the published
+ * output.
+ *
+ * To hide a secret that is already on screen without a visible flash, register
+ * the mask before revealing it (inside `hide()` or via the `recordOptions.redact`
+ * config for always-secret elements).
+ *
+ * @example Persistent
+ * ```ts
+ * const handle = await redact(page.getByTestId('api-key'))
+ * // ... later
+ * await handle.unredact()
+ * ```
+ *
+ * @example Scoped
+ * ```ts
+ * await redact(page.getByTestId('balance'), async () => {
+ *   await page.getByRole('button', { name: 'Reveal' }).click()
+ * })
+ * ```
+ */
+export declare function redact(locator: Locator, options?: RedactOptions): Promise<RedactHandle>;
+export declare function redact(locator: Locator, fn: () => Promise<void> | void, options?: RedactOptions): Promise<void>;
+/**
+ * Remove every active mask. Called automatically at the end of each recording
+ * so masks never leak across recordings that share a browser worker.
+ */
+export declare function unredactAll(): Promise<void>;
+//# sourceMappingURL=redact.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"redact.d.ts","sourceRoot":"","sources":["../../src/redact.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAA;AACrD,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAC7D,OAAO,EAIL,KAAK,mBAAmB,EACzB,MAAM,uBAAuB,CAAA;AAI9B,+CAA+C;AAC/C,eAAO,MAAM,qBAAqB,KAAK,CAAA;AACvC,6EAA6E;AAC7E,eAAO,MAAM,qBAAqB,+BAA+B,CAAA;AAEjE;;;GAGG;AACH,eAAO,MAAM,wBAAwB,OAAO,CAAA;AAE5C;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,CAAC,EAAE,aAAa,GACtB,mBAAmB,CAUrB;AAWD;;;;;GAKG;AACH,wBAAsB,+BAA+B,CACnD,IAAI,EAAE,IAAI,GACT,OAAO,CAAC,IAAI,CAAC,CAOf;AAED;;;;;;GAMG;AACH,wBAAsB,uBAAuB,CAC3C,IAAI,EAAE,IAAI,EACV,WAAW,EAAE;IAAE,mBAAmB,EAAE,OAAO,CAAA;CAAE,EAC7C,eAAe,CAAC,EAAE,MAAM,EAAE,GACzB,OAAO,CAAC,IAAI,CAAC,CASf;AAqDD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,MAAM,CACpB,OAAO,EAAE,OAAO,EAChB,OAAO,CAAC,EAAE,aAAa,GACtB,OAAO,CAAC,YAAY,CAAC,CAAA;AACxB,wBAAgB,MAAM,CACpB,OAAO,EAAE,OAAO,EAChB,EAAE,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,EAC9B,OAAO,CAAC,EAAE,aAAa,GACtB,OAAO,CAAC,IAAI,CAAC,CAAA;AAkBhB;;;GAGG;AACH,wBAAsB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAYjD"}

package/dist/src/redact.js

@@ -0,0 +1,138 @@
+import { redactApplyConfigSelectors, redactControllerBootstrap, } from './redactController.js';
+import { getRuntimePage, getRuntimeRedactState } from './runtimeContext.js';
+import { logger } from './logger.js';
+/** Default corner radius (px) for the mask. */
+export const DEFAULT_REDACT_RADIUS = 12;
+/** Default mask shadow. Reads as a raised chip so a redaction is obvious. */
+export const DEFAULT_REDACT_SHADOW = '0 2px 8px rgba(0,0,0,0.25)';
+/**
+ * How long `redact()` waits for at least one matching element before masking,
+ * so a redact issued just before the element renders does not silently no-op.
+ */
+export const REDACT_ATTACH_TIMEOUT_MS = 5000;
+/**
+ * Resolve user-facing {@link RedactOptions} to the concrete pixel values the
+ * in-page controller applies. Pure (no page access), so it is unit-testable on
+ * its own.
+ */
+export function resolveRedactStyle(options) {
+    const style = options?.style;
+    return {
+        // null means "sample a color from underneath" in the page.
+        color: style?.color ?? null,
+        radiusPx: style?.radius ?? DEFAULT_REDACT_RADIUS,
+        shadow: style?.shadow === false ? null : (style?.shadow ?? DEFAULT_REDACT_SHADOW),
+        css: style?.css ?? null,
+    };
+}
+let redactCounter = 0;
+function nextRedactId() {
+    redactCounter += 1;
+    return `__screenci_redact_${redactCounter}`;
+}
+/**
+ * Make sure the in-page controller is installed. `addInitScript` covers every
+ * future document (registered once per recording); the extra `evaluate` covers
+ * the document that is already open when `redact()` is first called. Both are
+ * idempotent.
+ */
+export async function ensureRedactControllerInstalled(page) {
+    const state = getRuntimeRedactState();
+    if (!state.controllerInstalled) {
+        await page.addInitScript(redactControllerBootstrap);
+        state.controllerInstalled = true;
+    }
+    await page.evaluate(redactControllerBootstrap);
+}
+/**
+ * Install the in-page controller on a freshly created page, before its first
+ * navigation, so masks apply from the first painted frame. Also registers the
+ * `recordOptions.redact` first-paint selectors. Called once per page from the
+ * video fixture; the runtime flag is set on the passed context (which is not yet
+ * the active context at page-creation time).
+ */
+export async function installRedactController(page, redactState, configSelectors) {
+    await page.addInitScript(redactControllerBootstrap);
+    redactState.controllerInstalled = true;
+    if (configSelectors && configSelectors.length > 0) {
+        await page.addInitScript(redactApplyConfigSelectors, {
+            selectors: configSelectors,
+            style: resolveRedactStyle(),
+        });
+    }
+}
+async function applyRedact(locator, options) {
+    const page = locator.page();
+    const resolved = resolveRedactStyle(options);
+    const id = nextRedactId();
+    await ensureRedactControllerInstalled(page);
+    // Wait for at least one match so a redact issued a beat before the element
+    // renders still masks it instead of silently doing nothing.
+    try {
+        await locator
+            .first()
+            .waitFor({ state: 'attached', timeout: REDACT_ATTACH_TIMEOUT_MS });
+    }
+    catch {
+        logger.warn('[screenci] redact() found no matching element to mask. The selector may be wrong or the element may not have rendered yet.');
+    }
+    // Register inside the page so the controller receives the real elements
+    // (this pierces shadow DOM, which a selector re-query could not). The
+    // controller positions the mask synchronously here, so no unmasked frame
+    // escapes once this resolves.
+    await locator.evaluateAll((elements, arg) => {
+        const api = window.__screenci_redact;
+        if (api)
+            api.addElements(arg.id, elements, arg.style);
+    }, { id, style: resolved });
+    getRuntimeRedactState().activeMasks.set(id, resolved);
+    return {
+        async unredact() {
+            getRuntimeRedactState().activeMasks.delete(id);
+            try {
+                await page.evaluate((maskId) => {
+                    const api = window.__screenci_redact;
+                    if (api)
+                        api.remove(maskId);
+                }, id);
+            }
+            catch {
+                // The page may already be closing; the mask dies with it.
+            }
+        },
+    };
+}
+export async function redact(locator, optionsOrFn, maybeOptions) {
+    if (typeof optionsOrFn === 'function') {
+        const handle = await applyRedact(locator, maybeOptions);
+        try {
+            await optionsOrFn();
+        }
+        finally {
+            await handle.unredact();
+        }
+        return;
+    }
+    return applyRedact(locator, optionsOrFn);
+}
+/**
+ * Remove every active mask. Called automatically at the end of each recording
+ * so masks never leak across recordings that share a browser worker.
+ */
+export async function unredactAll() {
+    getRuntimeRedactState().activeMasks.clear();
+    const page = getRuntimePage();
+    if (!page)
+        return;
+    try {
+        await page.evaluate(() => {
+            const api = window.__screenci_redact;
+            if (api)
+                api.clear();
+        });
+    }
+    catch {
+        // Best effort; the page may already be closing.
+    }
+}
+//# sourceMappingURL=redact.js.map

package/dist/src/redact.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redact.js","sourceRoot":"","sources":["../../src/redact.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,0BAA0B,EAC1B,yBAAyB,GAG1B,MAAM,uBAAuB,CAAA;AAC9B,OAAO,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAA;AAC3E,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAEpC,+CAA+C;AAC/C,MAAM,CAAC,MAAM,qBAAqB,GAAG,EAAE,CAAA;AACvC,6EAA6E;AAC7E,MAAM,CAAC,MAAM,qBAAqB,GAAG,4BAA4B,CAAA;AAEjE;;;GAGG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,IAAI,CAAA;AAE5C;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAChC,OAAuB;IAEvB,MAAM,KAAK,GAAG,OAAO,EAAE,KAAK,CAAA;IAC5B,OAAO;QACL,2DAA2D;QAC3D,KAAK,EAAE,KAAK,EAAE,KAAK,IAAI,IAAI;QAC3B,QAAQ,EAAE,KAAK,EAAE,MAAM,IAAI,qBAAqB;QAChD,MAAM,EACJ,KAAK,EAAE,MAAM,KAAK,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,MAAM,IAAI,qBAAqB,CAAC;QAC3E,GAAG,EAAE,KAAK,EAAE,GAAG,IAAI,IAAI;KACxB,CAAA;AACH,CAAC;AAID,IAAI,aAAa,GAAG,CAAC,CAAA;AAErB,SAAS,YAAY;IACnB,aAAa,IAAI,CAAC,CAAA;IAClB,OAAO,qBAAqB,aAAa,EAAE,CAAA;AAC7C,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,+BAA+B,CACnD,IAAU;IAEV,MAAM,KAAK,GAAG,qBAAqB,EAAE,CAAA;IACrC,IAAI,CAAC,KAAK,CAAC,mBAAmB,EAAE,CAAC;QAC/B,MAAM,IAAI,CAAC,aAAa,CAAC,yBAAyB,CAAC,CAAA;QACnD,KAAK,CAAC,mBAAmB,GAAG,IAAI,CAAA;IAClC,CAAC;IACD,MAAM,IAAI,CAAC,QAAQ,CAAC,yBAAyB,CAAC,CAAA;AAChD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,IAAU,EACV,WAA6C,EAC7C,eAA0B;IAE1B,MAAM,IAAI,CAAC,aAAa,CAAC,yBAAyB,CAAC,CAAA;IACnD,WAAW,CAAC,mBAAmB,GAAG,IAAI,CAAA;IACtC,IAAI,eAAe,IAAI,eAAe,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAClD,MAAM,IAAI,CAAC,aAAa,CAAC,0BAA0B,EAAE;YACnD,SAAS,EAAE,eAAe;YAC1B,KAAK,EAAE,kBAAkB,EAAE;SAC5B,CAAC,CAAA;IACJ,CAAC;AACH,CAAC;AAED,KAAK,UAAU,WAAW,CACxB,OAAgB,EAChB,OAAuB;IAEvB,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,EAAE,CAAA;IAC3B,MAAM,QAAQ,GAAG,kBAAkB,CAAC,OAAO,CAAC,CAAA;IAC5C,MAAM,EAAE,GAAG,YAAY,EAAE,CAAA;IAEzB,MAAM,+BAA+B,CAAC,IAAI,CAAC,CAAA;IAE3C,2EAA2E;IAC3E,4DAA4D;IAC5D,IAAI,CAAC;QACH,MAAM,OAAO;aACV,KAAK,EAAE;aACP,OAAO,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,wBAAwB,EAAE,CAAC,CAAA;IACtE,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,CAAC,IAAI,CACT,4HAA4H,CAC7H,CAAA;IACH,CAAC;IAED,wEAAwE;IACxE,sEAAsE;IACtE,yEAAyE;IACzE,8BAA8B;IAC9B,MAAM,OAAO,CAAC,WAAW,CACvB,CAAC,QAAQ,EAAE,GAA+C,EAAE,EAAE;QAC5D,MAAM,GAAG,GAAI,MAAuB,CAAC,iBAAiB,CAAA;QACtD,IAAI,GAAG;YAAE,GAAG,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,EAAE,QAAQ,EAAE,GAAG,CAAC,KAAK,CAAC,CAAA;IACvD,CAAC,EACD,EAAE,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CACxB,CAAA;IAED,qBAAqB,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAA;IAErD,OAAO;QACL,KAAK,CAAC,QAAQ;YACZ,qBAAqB,EAAE,CAAC,WAAW,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;YAC9C,IAAI,CAAC;gBACH,MAAM,IAAI,CAAC,QAAQ,CAAC,CAAC,MAAc,EAAE,EAAE;oBACrC,MAAM,GAAG,GAAI,MAAuB,CAAC,iBAAiB,CAAA;oBACtD,IAAI,GAAG;wBAAE,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;gBAC7B,CAAC,EAAE,EAAE,CAAC,CAAA;YACR,CAAC;YAAC,MAAM,CAAC;gBACP,0DAA0D;YAC5D,CAAC;QACH,CAAC;KACF,CAAA;AACH,CAAC;AAoCD,MAAM,CAAC,KAAK,UAAU,MAAM,CAC1B,OAAgB,EAChB,WAA0D,EAC1D,YAA4B;IAE5B,IAAI,OAAO,WAAW,KAAK,UAAU,EAAE,CAAC;QACtC,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,OAAO,EAAE,YAAY,CAAC,CAAA;QACvD,IAAI,CAAC;YACH,MAAM,WAAW,EAAE,CAAA;QACrB,CAAC;gBAAS,CAAC;YACT,MAAM,MAAM,CAAC,QAAQ,EAAE,CAAA;QACzB,CAAC;QACD,OAAM;IACR,CAAC;IACD,OAAO,WAAW,CAAC,OAAO,EAAE,WAAW,CAAC,CAAA;AAC1C,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW;IAC/B,qBAAqB,EAAE,CAAC,WAAW,CAAC,KAAK,EAAE,CAAA;IAC3C,MAAM,IAAI,GAAG,cAAc,EAAE,CAAA;IAC7B,IAAI,CAAC,IAAI;QAAE,OAAM;IACjB,IAAI,CAAC;QACH,MAAM,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE;YACvB,MAAM,GAAG,GAAI,MAAuB,CAAC,iBAAiB,CAAA;YACtD,IAAI,GAAG;gBAAE,GAAG,CAAC,KAAK,EAAE,CAAA;QACtB,CAAC,CAAC,CAAA;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,gDAAgD;IAClD,CAAC;AACH,CAAC"}

package/dist/src/redactController.d.ts

@@ -0,0 +1,61 @@
+/**
+ * In-page redaction controller.
+ *
+ * screenci records the live browser page, so the only way to keep a secret out
+ * of `recording.mp4` (and therefore out of the upload) is to mask it in the DOM
+ * before Chrome captures the frame. This module is the browser-side half: a
+ * self-contained controller installed via `addInitScript` that covers target
+ * elements with an opaque panel (by default tinted to match the surface beneath
+ * them), tracking their position every animation frame so the mask follows
+ * scroll, layout, and animation.
+ *
+ * The functions here are serialized and shipped to the page by Playwright, so
+ * they must not reference anything outside their own bodies.
+ */
+/**
+ * A redact style resolved to concrete pixel values, ready to apply in the page.
+ * `RedactStyle` (the user-facing option) is resolved to this by
+ * `resolveRedactStyle` in `redact.ts`.
+ */
+export type ResolvedRedactStyle = {
+    /** Fixed fill color, or null to sample one from underneath in the page. */
+    color: string | null;
+    radiusPx: number;
+    shadow: string | null;
+    /** Extra CSS for the mask panel, or null. */
+    css: string | null;
+};
+/** Window global exposed by the controller for the Node side to drive. */
+export type RedactWindowApi = {
+    /** Mask specific element handles (used by runtime `redact`; pierces shadow DOM). */
+    addElements: (id: string, elements: Element[], style: ResolvedRedactStyle) => void;
+    /** Mask everything matching a CSS selector, re-queried each frame. */
+    addSelector: (id: string, selector: string, style: ResolvedRedactStyle) => void;
+    /** Remove a mask by id, restoring the element. */
+    remove: (id: string) => void;
+    /** Remove every mask. */
+    clear: () => void;
+};
+/** Attribute stamped on elements masked by a runtime `redact` call. */
+export declare const REDACT_ID_ATTRIBUTE = "data-screenci-redact-id";
+/** Id of the fixed-position container that holds every tint div. */
+export declare const REDACT_ROOT_ID = "__screenci_redact_root";
+/** Name of the window global the controller installs. */
+export declare const REDACT_WINDOW_KEY = "__screenci_redact";
+/**
+ * The controller bootstrap. Runs in the page (via `addInitScript`) on every
+ * document. Idempotent: a second run is a no-op, so it is safe to inject more
+ * than once.
+ */
+export declare function redactControllerBootstrap(): void;
+/**
+ * Init script that masks the configured first-paint selectors. Registered after
+ * the bootstrap so `window.__screenci_redact` already exists. A CSS rule hides
+ * matches the instant they paint (race free, no JS timing), and the controller
+ * lays the opaque panel over them a frame later.
+ */
+export declare function redactApplyConfigSelectors(config: {
+    selectors: string[];
+    style: ResolvedRedactStyle;
+}): void;
+//# sourceMappingURL=redactController.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"redactController.d.ts","sourceRoot":"","sources":["../../src/redactController.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH;;;;GAIG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAChC,2EAA2E;IAC3E,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,6CAA6C;IAC7C,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;CACnB,CAAA;AAED,0EAA0E;AAC1E,MAAM,MAAM,eAAe,GAAG;IAC5B,oFAAoF;IACpF,WAAW,EAAE,CACX,EAAE,EAAE,MAAM,EACV,QAAQ,EAAE,OAAO,EAAE,EACnB,KAAK,EAAE,mBAAmB,KACvB,IAAI,CAAA;IACT,sEAAsE;IACtE,WAAW,EAAE,CACX,EAAE,EAAE,MAAM,EACV,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,mBAAmB,KACvB,IAAI,CAAA;IACT,kDAAkD;IAClD,MAAM,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAA;IAC5B,yBAAyB;IACzB,KAAK,EAAE,MAAM,IAAI,CAAA;CAClB,CAAA;AAED,uEAAuE;AACvE,eAAO,MAAM,mBAAmB,4BAA4B,CAAA;AAE5D,oEAAoE;AACpE,eAAO,MAAM,cAAc,2BAA2B,CAAA;AAEtD,yDAAyD;AACzD,eAAO,MAAM,iBAAiB,sBAAsB,CAAA;AAEpD;;;;GAIG;AACH,wBAAgB,yBAAyB,IAAI,IAAI,CAiMhD;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE;IACjD,SAAS,EAAE,MAAM,EAAE,CAAA;IACnB,KAAK,EAAE,mBAAmB,CAAA;CAC3B,GAAG,IAAI,CA0BP"}

package/dist/src/redactController.js

@@ -0,0 +1,232 @@
+/**
+ * In-page redaction controller.
+ *
+ * screenci records the live browser page, so the only way to keep a secret out
+ * of `recording.mp4` (and therefore out of the upload) is to mask it in the DOM
+ * before Chrome captures the frame. This module is the browser-side half: a
+ * self-contained controller installed via `addInitScript` that covers target
+ * elements with an opaque panel (by default tinted to match the surface beneath
+ * them), tracking their position every animation frame so the mask follows
+ * scroll, layout, and animation.
+ *
+ * The functions here are serialized and shipped to the page by Playwright, so
+ * they must not reference anything outside their own bodies.
+ */
+/** Attribute stamped on elements masked by a runtime `redact` call. */
+export const REDACT_ID_ATTRIBUTE = 'data-screenci-redact-id';
+/** Id of the fixed-position container that holds every tint div. */
+export const REDACT_ROOT_ID = '__screenci_redact_root';
+/** Name of the window global the controller installs. */
+export const REDACT_WINDOW_KEY = '__screenci_redact';
+/**
+ * The controller bootstrap. Runs in the page (via `addInitScript`) on every
+ * document. Idempotent: a second run is a no-op, so it is safe to inject more
+ * than once.
+ */
+export function redactControllerBootstrap() {
+    const KEY = '__screenci_redact';
+    const ROOT_ID = '__screenci_redact_root';
+    const win = window;
+    if (win[KEY])
+        return;
+    const entries = new Map();
+    let root = null;
+    let rafId = null;
+    function ensureRoot() {
+        if (root && root.isConnected)
+            return root;
+        // At document-start (init script) the parent may not exist yet; the rAF
+        // loop retries next frame rather than throwing and dying.
+        const parent = document.body ?? document.documentElement;
+        if (!parent)
+            return null;
+        const existing = document.getElementById(ROOT_ID);
+        if (existing) {
+            root = existing;
+            return root;
+        }
+        const el = document.createElement('div');
+        el.id = ROOT_ID;
+        el.setAttribute('aria-hidden', 'true');
+        el.style.cssText =
+            'position:fixed;top:0;left:0;width:0;height:0;margin:0;padding:0;' +
+                'border:0;pointer-events:none;z-index:2147483647;';
+        // Append to documentElement so it survives <body> swaps in SPAs.
+        document.documentElement.appendChild(el);
+        root = el;
+        return el;
+    }
+    function isTransparentColor(c) {
+        return (!c ||
+            c === 'transparent' ||
+            /rgba?\(\s*0\s*,\s*0\s*,\s*0\s*,\s*0\s*\)/.test(c));
+    }
+    // Pick an opaque fill color from the surface under the element: its own
+    // background, or the nearest ancestor (or the body) that paints one. This
+    // gives a clean, uniform panel that blends with the surrounding UI.
+    function sampleRegionColor(el) {
+        let node = el;
+        while (node) {
+            const bg = getComputedStyle(node).backgroundColor;
+            if (!isTransparentColor(bg))
+                return bg;
+            node = node.parentElement;
+        }
+        const bodyBg = document.body
+            ? getComputedStyle(document.body).backgroundColor
+            : '';
+        return isTransparentColor(bodyBg) ? '#e5e5e5' : bodyBg;
+    }
+    function styleMask(div, style, autoColor) {
+        // Opaque panel: a fixed color, or one sampled to match what is underneath.
+        div.style.background = style.color ?? autoColor ?? '#e5e5e5';
+        div.style.borderRadius = `${style.radiusPx}px`;
+        div.style.boxShadow = style.shadow ?? 'none';
+        // Custom styling, applied last so it can override the defaults.
+        if (style.css)
+            div.style.cssText += ';' + style.css;
+        // Keep the panel non-interactive and absolutely positioned regardless of
+        // any custom CSS.
+        div.style.position = 'absolute';
+        div.style.pointerEvents = 'none';
+    }
+    function resolveElements(entry) {
+        if (entry.selector !== null) {
+            return Array.from(document.querySelectorAll(entry.selector));
+        }
+        return (entry.elements ?? []).filter((el) => el.isConnected);
+    }
+    function positionFrame() {
+        const container = ensureRoot();
+        if (!container) {
+            // DOM not ready yet; try again next frame while masks are pending.
+            rafId = entries.size > 0 ? requestAnimationFrame(positionFrame) : null;
+            return;
+        }
+        for (const entry of entries.values()) {
+            const seen = new Set();
+            for (const el of resolveElements(entry)) {
+                const rect = el.getBoundingClientRect();
+                if (rect.width <= 0 || rect.height <= 0)
+                    continue;
+                seen.add(el);
+                let div = entry.masks.get(el);
+                if (!div) {
+                    div = document.createElement('div');
+                    div.style.cssText =
+                        'position:absolute;top:0;left:0;pointer-events:none;will-change:transform;';
+                    const autoColor = entry.style.color === null ? sampleRegionColor(el) : null;
+                    styleMask(div, entry.style, autoColor);
+                    container.appendChild(div);
+                    entry.masks.set(el, div);
+                }
+                // Inflate just enough that the rounded corners never expose the
+                // element's square corners underneath. A rounded rect of radius r covers
+                // an inner corner once it extends about 0.29*r beyond it, so this stays
+                // tight to the element rather than looking oversized.
+                const pad = Math.ceil(entry.style.radiusPx * 0.3);
+                div.style.transform = `translate(${rect.left - pad}px, ${rect.top - pad}px)`;
+                div.style.width = `${rect.width + pad * 2}px`;
+                div.style.height = `${rect.height + pad * 2}px`;
+                div.style.display = 'block';
+            }
+            // Tear down masks for elements that vanished this frame.
+            for (const [el, div] of entry.masks) {
+                if (seen.has(el))
+                    continue;
+                div.remove();
+                entry.masks.delete(el);
+            }
+        }
+        rafId = entries.size > 0 ? requestAnimationFrame(positionFrame) : null;
+    }
+    function startLoop() {
+        if (rafId !== null)
+            return;
+        // Run one synchronous frame so a freshly added mask covers its element
+        // before this call returns (no unmasked frame escapes to the recording),
+        // then keep tracking on rAF.
+        positionFrame();
+    }
+    function teardownEntry(entry) {
+        for (const [el, div] of entry.masks) {
+            div.remove();
+            entry.masks.delete(el);
+        }
+    }
+    const api = {
+        addElements(id, elements, style) {
+            const entry = {
+                style: style,
+                selector: null,
+                elements,
+                masks: new Map(),
+            };
+            const prev = entries.get(id);
+            if (prev)
+                teardownEntry(prev);
+            entries.set(id, entry);
+            startLoop();
+        },
+        addSelector(id, selector, style) {
+            const entry = {
+                style: style,
+                selector,
+                elements: null,
+                masks: new Map(),
+            };
+            const prev = entries.get(id);
+            if (prev)
+                teardownEntry(prev);
+            entries.set(id, entry);
+            startLoop();
+        },
+        remove(id) {
+            const entry = entries.get(id);
+            if (!entry)
+                return;
+            teardownEntry(entry);
+            entries.delete(id);
+        },
+        clear() {
+            for (const entry of entries.values())
+                teardownEntry(entry);
+            entries.clear();
+        },
+    };
+    win[KEY] = api;
+}
+/**
+ * Init script that masks the configured first-paint selectors. Registered after
+ * the bootstrap so `window.__screenci_redact` already exists. A CSS rule hides
+ * matches the instant they paint (race free, no JS timing), and the controller
+ * lays the opaque panel over them a frame later.
+ */
+export function redactApplyConfigSelectors(config) {
+    const KEY = '__screenci_redact';
+    const api = window[KEY];
+    if (!api || config.selectors.length === 0)
+        return;
+    // Hide matches the instant they paint, before the JS panel can position
+    // itself, so the secret never flashes on the first frame. `visibility:hidden`
+    // keeps the layout box so the panel is sized correctly, and it fails closed if
+    // the controller never runs.
+    const css = config.selectors
+        .map((sel) => `${sel}{visibility:hidden !important;}`)
+        .join('');
+    const style = document.createElement('style');
+    style.setAttribute('data-screenci-redact', 'config');
+    style.textContent = css;
+    const attach = () => {
+        ;
+        (document.head ?? document.documentElement).appendChild(style);
+    };
+    if (document.head)
+        attach();
+    else
+        document.addEventListener('DOMContentLoaded', attach, { once: true });
+    config.selectors.forEach((selector, index) => {
+        api.addSelector(`__screenci_config_${index}`, selector, config.style);
+    });
+}
+//# sourceMappingURL=redactController.js.map

package/dist/src/redactController.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redactController.js","sourceRoot":"","sources":["../../src/redactController.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAoCH,uEAAuE;AACvE,MAAM,CAAC,MAAM,mBAAmB,GAAG,yBAAyB,CAAA;AAE5D,oEAAoE;AACpE,MAAM,CAAC,MAAM,cAAc,GAAG,wBAAwB,CAAA;AAEtD,yDAAyD;AACzD,MAAM,CAAC,MAAM,iBAAiB,GAAG,mBAAmB,CAAA;AAEpD;;;;GAIG;AACH,MAAM,UAAU,yBAAyB;IACvC,MAAM,GAAG,GAAG,mBAAmB,CAAA;IAC/B,MAAM,OAAO,GAAG,wBAAwB,CAAA;IACxC,MAAM,GAAG,GAAG,MAA4C,CAAA;IACxD,IAAI,GAAG,CAAC,GAAG,CAAC;QAAE,OAAM;IAiBpB,MAAM,OAAO,GAAG,IAAI,GAAG,EAAiB,CAAA;IACxC,IAAI,IAAI,GAA0B,IAAI,CAAA;IACtC,IAAI,KAAK,GAAkB,IAAI,CAAA;IAE/B,SAAS,UAAU;QACjB,IAAI,IAAI,IAAI,IAAI,CAAC,WAAW;YAAE,OAAO,IAAI,CAAA;QACzC,wEAAwE;QACxE,0DAA0D;QAC1D,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,IAAI,QAAQ,CAAC,eAAe,CAAA;QACxD,IAAI,CAAC,MAAM;YAAE,OAAO,IAAI,CAAA;QACxB,MAAM,QAAQ,GAAG,QAAQ,CAAC,cAAc,CAAC,OAAO,CAAC,CAAA;QACjD,IAAI,QAAQ,EAAE,CAAC;YACb,IAAI,GAAG,QAA0B,CAAA;YACjC,OAAO,IAAI,CAAA;QACb,CAAC;QACD,MAAM,EAAE,GAAG,QAAQ,CAAC,aAAa,CAAC,KAAK,CAAC,CAAA;QACxC,EAAE,CAAC,EAAE,GAAG,OAAO,CAAA;QACf,EAAE,CAAC,YAAY,CAAC,aAAa,EAAE,MAAM,CAAC,CAAA;QACtC,EAAE,CAAC,KAAK,CAAC,OAAO;YACd,kEAAkE;gBAClE,kDAAkD,CAAA;QACpD,iEAAiE;QACjE,QAAQ,CAAC,eAAe,CAAC,WAAW,CAAC,EAAE,CAAC,CAAA;QACxC,IAAI,GAAG,EAAE,CAAA;QACT,OAAO,EAAE,CAAA;IACX,CAAC;IAED,SAAS,kBAAkB,CAAC,CAAS;QACnC,OAAO,CACL,CAAC,CAAC;YACF,CAAC,KAAK,aAAa;YACnB,0CAA0C,CAAC,IAAI,CAAC,CAAC,CAAC,CACnD,CAAA;IACH,CAAC;IAED,wEAAwE;IACxE,0EAA0E;IAC1E,oEAAoE;IACpE,SAAS,iBAAiB,CAAC,EAAW;QACpC,IAAI,IAAI,GAAmB,EAAE,CAAA;QAC7B,OAAO,IAAI,EAAE,CAAC;YACZ,MAAM,EAAE,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC,eAAe,CAAA;YACjD,IAAI,CAAC,kBAAkB,CAAC,EAAE,CAAC;gBAAE,OAAO,EAAE,CAAA;YACtC,IAAI,GAAG,IAAI,CAAC,aAAa,CAAA;QAC3B,CAAC;QACD,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI;YAC1B,CAAC,CAAC,gBAAgB,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,eAAe;YACjD,CAAC,CAAC,EAAE,CAAA;QACN,OAAO,kBAAkB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAA;IACxD,CAAC;IAED,SAAS,SAAS,CAChB,GAAmB,EACnB,KAAe,EACf,SAAwB;QAExB,2EAA2E;QAC3E,GAAG,CAAC,KAAK,CAAC,UAAU,GAAG,KAAK,CAAC,KAAK,IAAI,SAAS,IAAI,SAAS,CAAA;QAC5D,GAAG,CAAC,KAAK,CAAC,YAAY,GAAG,GAAG,KAAK,CAAC,QAAQ,IAAI,CAAA;QAC9C,GAAG,CAAC,KAAK,CAAC,SAAS,GAAG,KAAK,CAAC,MAAM,IAAI,MAAM,CAAA;QAC5C,gEAAgE;QAChE,IAAI,KAAK,CAAC,GAAG;YAAE,GAAG,CAAC,KAAK,CAAC,OAAO,IAAI,GAAG,GAAG,KAAK,CAAC,GAAG,CAAA;QACnD,yEAAyE;QACzE,kBAAkB;QAClB,GAAG,CAAC,KAAK,CAAC,QAAQ,GAAG,UAAU,CAAA;QAC/B,GAAG,CAAC,KAAK,CAAC,aAAa,GAAG,MAAM,CAAA;IAClC,CAAC;IAED,SAAS,eAAe,CAAC,KAAY;QACnC,IAAI,KAAK,CAAC,QAAQ,KAAK,IAAI,EAAE,CAAC;YAC5B,OAAO,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,gBAAgB,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAA;QAC9D,CAAC;QACD,OAAO,CAAC,KAAK,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,WAAW,CAAC,CAAA;IAC9D,CAAC;IAED,SAAS,aAAa;QACpB,MAAM,SAAS,GAAG,UAAU,EAAE,CAAA;QAC9B,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,mEAAmE;YACnE,KAAK,GAAG,OAAO,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,qBAAqB,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;YACtE,OAAM;QACR,CAAC;QACD,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;YACrC,MAAM,IAAI,GAAG,IAAI,GAAG,EAAW,CAAA;YAC/B,KAAK,MAAM,EAAE,IAAI,eAAe,CAAC,KAAK,CAAC,EAAE,CAAC;gBACxC,MAAM,IAAI,GAAG,EAAE,CAAC,qBAAqB,EAAE,CAAA;gBACvC,IAAI,IAAI,CAAC,KAAK,IAAI,CAAC,IAAI,IAAI,CAAC,MAAM,IAAI,CAAC;oBAAE,SAAQ;gBACjD,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;gBACZ,IAAI,GAAG,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;gBAC7B,IAAI,CAAC,GAAG,EAAE,CAAC;oBACT,GAAG,GAAG,QAAQ,CAAC,aAAa,CAAC,KAAK,CAAC,CAAA;oBACnC,GAAG,CAAC,KAAK,CAAC,OAAO;wBACf,2EAA2E,CAAA;oBAC7E,MAAM,SAAS,GACb,KAAK,CAAC,KAAK,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,iBAAiB,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;oBAC3D,SAAS,CAAC,GAAG,EAAE,KAAK,CAAC,KAAK,EAAE,SAAS,CAAC,CAAA;oBACtC,SAAS,CAAC,WAAW,CAAC,GAAG,CAAC,CAAA;oBAC1B,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,CAAA;gBAC1B,CAAC;gBACD,gEAAgE;gBAChE,yEAAyE;gBACzE,wEAAwE;gBACxE,sDAAsD;gBACtD,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ,GAAG,GAAG,CAAC,CAAA;gBACjD,GAAG,CAAC,KAAK,CAAC,SAAS,GAAG,aAAa,IAAI,CAAC,IAAI,GAAG,GAAG,OAAO,IAAI,CAAC,GAAG,GAAG,GAAG,KAAK,CAAA;gBAC5E,GAAG,CAAC,KAAK,CAAC,KAAK,GAAG,GAAG,IAAI,CAAC,KAAK,GAAG,GAAG,GAAG,CAAC,IAAI,CAAA;gBAC7C,GAAG,CAAC,KAAK,CAAC,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,GAAG,GAAG,GAAG,CAAC,IAAI,CAAA;gBAC/C,GAAG,CAAC,KAAK,CAAC,OAAO,GAAG,OAAO,CAAA;YAC7B,CAAC;YACD,yDAAyD;YACzD,KAAK,MAAM,CAAC,EAAE,EAAE,GAAG,CAAC,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;gBACpC,IAAI,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;oBAAE,SAAQ;gBAC1B,GAAG,CAAC,MAAM,EAAE,CAAA;gBACZ,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;YACxB,CAAC;QACH,CAAC;QACD,KAAK,GAAG,OAAO,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,qBAAqB,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;IACxE,CAAC;IAED,SAAS,SAAS;QAChB,IAAI,KAAK,KAAK,IAAI;YAAE,OAAM;QAC1B,uEAAuE;QACvE,yEAAyE;QACzE,6BAA6B;QAC7B,aAAa,EAAE,CAAA;IACjB,CAAC;IAED,SAAS,aAAa,CAAC,KAAY;QACjC,KAAK,MAAM,CAAC,EAAE,EAAE,GAAG,CAAC,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;YACpC,GAAG,CAAC,MAAM,EAAE,CAAA;YACZ,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;QACxB,CAAC;IACH,CAAC;IAED,MAAM,GAAG,GAAoB;QAC3B,WAAW,CAAC,EAAE,EAAE,QAAQ,EAAE,KAAK;YAC7B,MAAM,KAAK,GAAU;gBACnB,KAAK,EAAE,KAAiB;gBACxB,QAAQ,EAAE,IAAI;gBACd,QAAQ;gBACR,KAAK,EAAE,IAAI,GAAG,EAAE;aACjB,CAAA;YACD,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;YAC5B,IAAI,IAAI;gBAAE,aAAa,CAAC,IAAI,CAAC,CAAA;YAC7B,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,KAAK,CAAC,CAAA;YACtB,SAAS,EAAE,CAAA;QACb,CAAC;QACD,WAAW,CAAC,EAAE,EAAE,QAAQ,EAAE,KAAK;YAC7B,MAAM,KAAK,GAAU;gBACnB,KAAK,EAAE,KAAiB;gBACxB,QAAQ;gBACR,QAAQ,EAAE,IAAI;gBACd,KAAK,EAAE,IAAI,GAAG,EAAE;aACjB,CAAA;YACD,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;YAC5B,IAAI,IAAI;gBAAE,aAAa,CAAC,IAAI,CAAC,CAAA;YAC7B,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,KAAK,CAAC,CAAA;YACtB,SAAS,EAAE,CAAA;QACb,CAAC;QACD,MAAM,CAAC,EAAE;YACP,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;YAC7B,IAAI,CAAC,KAAK;gBAAE,OAAM;YAClB,aAAa,CAAC,KAAK,CAAC,CAAA;YACpB,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;QACpB,CAAC;QACD,KAAK;YACH,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,MAAM,EAAE;gBAAE,aAAa,CAAC,KAAK,CAAC,CAAA;YAC1D,OAAO,CAAC,KAAK,EAAE,CAAA;QACjB,CAAC;KACF,CAAA;IAED,GAAG,CAAC,GAAG,CAAC,GAAG,GAAG,CAAA;AAChB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,0BAA0B,CAAC,MAG1C;IACC,MAAM,GAAG,GAAG,mBAAmB,CAAA;IAC/B,MAAM,GAAG,GAAI,MAA6C,CAAC,GAAG,CAEjD,CAAA;IACb,IAAI,CAAC,GAAG,IAAI,MAAM,CAAC,SAAS,CAAC,MAAM,KAAK,CAAC;QAAE,OAAM;IAEjD,wEAAwE;IACxE,8EAA8E;IAC9E,+EAA+E;IAC/E,6BAA6B;IAC7B,MAAM,GAAG,GAAG,MAAM,CAAC,SAAS;SACzB,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,GAAG,iCAAiC,CAAC;SACrD,IAAI,CAAC,EAAE,CAAC,CAAA;IACX,MAAM,KAAK,GAAG,QAAQ,CAAC,aAAa,CAAC,OAAO,CAAC,CAAA;IAC7C,KAAK,CAAC,YAAY,CAAC,sBAAsB,EAAE,QAAQ,CAAC,CAAA;IACpD,KAAK,CAAC,WAAW,GAAG,GAAG,CAAA;IACvB,MAAM,MAAM,GAAG,GAAS,EAAE;QACxB,CAAC;QAAA,CAAC,QAAQ,CAAC,IAAI,IAAI,QAAQ,CAAC,eAAe,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,CAAA;IACjE,CAAC,CAAA;IACD,IAAI,QAAQ,CAAC,IAAI;QAAE,MAAM,EAAE,CAAA;;QACtB,QAAQ,CAAC,gBAAgB,CAAC,kBAAkB,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAA;IAE1E,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,KAAK,EAAE,EAAE;QAC3C,GAAG,CAAC,WAAW,CAAC,qBAAqB,KAAK,EAAE,EAAE,QAAQ,EAAE,MAAM,CAAC,KAAK,CAAC,CAAA;IACvE,CAAC,CAAC,CAAA;AACJ,CAAC"}

package/dist/src/runtimeContext.d.ts

@@ -2,6 +2,7 @@ import type { Page } from '@playwright/test';
 import { type IEventRecorder, type ElementRect } from './events.js';
 import type { AutoZoomOptions, RecordOptions, RenderOptions } from './types.js';
 import type { ScreenshotCropRecord } from './crop.js';
+import type { ResolvedRedactStyle } from './redactController.js';
 export type CurrentZoomViewport = {
     focusPoint: {
         x: number;
@@ -32,6 +33,13 @@ export type AutoZoomState = {
     mode: 'idle' | 'auto' | 'manual';
     options: AutoZoomOptions;
     currentZoomViewport: CurrentZoomViewport | null;
+    /**
+     * Vertical framing bias (0–1) applied when a plain interaction scrolls its
+     * target into view without zooming. Populated once at record init from
+     * `recordOptions.scrollCentering` (default `DEFAULT_SCROLL_CENTERING`). An
+     * explicit per-call `centering` still overrides this.
+     */
+    scrollCentering: number;
 };
 export type ActiveCueRun = {
     finished: Promise<void>;
@@ -113,6 +121,26 @@ export type ScreenCIRuntimeContext = {
         activeRuns: Map<string, ActiveAudioRun>;
     };
     autoZoom: AutoZoomState;
+    /**
+     * Tracks the recording's current display size (0-1 fraction of the frame; 1 =
+     * full screen) as toggled by `resizeRecording()`/`resetRecordingSize()`. Used
+     * to no-op a reset that is already at full screen and to detect redundant
+     * resizes. Resets to 1 with each fresh recording context.
+     */
+    recordingSize: {
+        current: number;
+    };
+    /**
+     * Client-side redaction state. `controllerInstalled` guards the one-time
+     * `addInitScript` install of the in-page mask controller; `activeMasks` maps
+     * each live mask id to its resolved style so masks can be cleaned up at the
+     * end of a recording. Redaction is purely client side, so nothing here is
+     * serialized to `data.json`.
+     */
+    redact: {
+        controllerInstalled: boolean;
+        activeMasks: Map<string, ResolvedRedactStyle>;
+    };
 };
 export declare function createScreenCIRuntimeContext(overrides?: {
     recorder?: IEventRecorder | null;
@@ -154,6 +182,8 @@ export declare function getRuntimeCrop(): ScreenshotCropRecord | undefined;
 export declare function resetCueRuntimeState(): void;
 export declare function resetAssetRuntimeState(): void;
 export declare function resetAudioRuntimeState(): void;
+export declare function getRuntimeRedactState(): ScreenCIRuntimeContext['redact'];
+export declare function resetRedactRuntimeState(): void;
 export declare function pushRuntimeTimelineBlock(block: TimelineBlockState): void;
 export declare function popRuntimeTimelineBlock(expectedType: TimelineBlockType): TimelineBlockState;
 export declare function hasRuntimeTimelineBlock(type: TimelineBlockType): boolean;
@@ -161,4 +191,6 @@ export declare function getRuntimeTimelineBlocks(): TimelineBlockState[];
 export declare function isRuntimeInsideHide(): boolean;
 export declare function getRuntimeAutoZoomState(): AutoZoomState;
 export declare function setRuntimeAutoZoomState(state: AutoZoomState): void;
+export declare function getRuntimeRecordingSize(): number;
+export declare function setRuntimeRecordingSize(size: number): void;
 //# sourceMappingURL=runtimeContext.d.ts.map