npm - fast-replay - Versions diffs - 0.1.0 - Mend

fast-replay 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (111) hide show

package/LICENSE +21 -0
package/README.md +126 -0
package/dist/api.d.ts +65 -0
package/dist/api.js +78 -0
package/dist/api.js.map +1 -0
package/dist/browser.d.ts +67 -0
package/dist/browser.js +77 -0
package/dist/browser.js.map +1 -0
package/dist/cli/format.d.ts +12 -0
package/dist/cli/format.js +55 -0
package/dist/cli/format.js.map +1 -0
package/dist/cli/index.d.ts +2 -0
package/dist/cli/index.js +199 -0
package/dist/cli/index.js.map +1 -0
package/dist/compiler/compile.d.ts +18 -0
package/dist/compiler/compile.js +226 -0
package/dist/compiler/compile.js.map +1 -0
package/dist/compiler/normalize.d.ts +16 -0
package/dist/compiler/normalize.js +75 -0
package/dist/compiler/normalize.js.map +1 -0
package/dist/compiler/waits.d.ts +31 -0
package/dist/compiler/waits.js +69 -0
package/dist/compiler/waits.js.map +1 -0
package/dist/ir/io.d.ts +47 -0
package/dist/ir/io.js +122 -0
package/dist/ir/io.js.map +1 -0
package/dist/ir/schema.d.ts +236 -0
package/dist/ir/schema.js +153 -0
package/dist/ir/schema.js.map +1 -0
package/dist/mcp/index.d.ts +2 -0
package/dist/mcp/index.js +22 -0
package/dist/mcp/index.js.map +1 -0
package/dist/mcp/server.d.ts +8 -0
package/dist/mcp/server.js +268 -0
package/dist/mcp/server.js.map +1 -0
package/dist/noise.d.ts +20 -0
package/dist/noise.js +70 -0
package/dist/noise.js.map +1 -0
package/dist/recorder/agent/capture.d.ts +15 -0
package/dist/recorder/agent/capture.js +310 -0
package/dist/recorder/agent/capture.js.map +1 -0
package/dist/recorder/agent/config.d.ts +25 -0
package/dist/recorder/agent/config.js +23 -0
package/dist/recorder/agent/config.js.map +1 -0
package/dist/recorder/agent/dom-reaction.d.ts +13 -0
package/dist/recorder/agent/dom-reaction.js +166 -0
package/dist/recorder/agent/dom-reaction.js.map +1 -0
package/dist/recorder/agent/main.d.ts +1 -0
package/dist/recorder/agent/main.js +14 -0
package/dist/recorder/agent/main.js.map +1 -0
package/dist/recorder/agent/page-agent.d.ts +12 -0
package/dist/recorder/agent/page-agent.js +40 -0
package/dist/recorder/agent/page-agent.js.map +1 -0
package/dist/recorder/agent/reveal-tracker.d.ts +26 -0
package/dist/recorder/agent/reveal-tracker.js +41 -0
package/dist/recorder/agent/reveal-tracker.js.map +1 -0
package/dist/recorder/agent/roles.d.ts +11 -0
package/dist/recorder/agent/roles.js +148 -0
package/dist/recorder/agent/roles.js.map +1 -0
package/dist/recorder/agent/selectors.d.ts +26 -0
package/dist/recorder/agent/selectors.js +256 -0
package/dist/recorder/agent/selectors.js.map +1 -0
package/dist/recorder/agent/text.d.ts +19 -0
package/dist/recorder/agent/text.js +82 -0
package/dist/recorder/agent/text.js.map +1 -0
package/dist/recorder/agent/transport.d.ts +14 -0
package/dist/recorder/agent/transport.js +43 -0
package/dist/recorder/agent/transport.js.map +1 -0
package/dist/recorder/agent/visibility.d.ts +8 -0
package/dist/recorder/agent/visibility.js +20 -0
package/dist/recorder/agent/visibility.js.map +1 -0
package/dist/recorder/agent-bundle.generated.d.ts +2 -0
package/dist/recorder/agent-bundle.generated.js +6 -0
package/dist/recorder/agent-bundle.generated.js.map +1 -0
package/dist/recorder/attach.d.ts +52 -0
package/dist/recorder/attach.js +159 -0
package/dist/recorder/attach.js.map +1 -0
package/dist/recorder/instrument.d.ts +17 -0
package/dist/recorder/instrument.js +24 -0
package/dist/recorder/instrument.js.map +1 -0
package/dist/recorder/launch.d.ts +38 -0
package/dist/recorder/launch.js +72 -0
package/dist/recorder/launch.js.map +1 -0
package/dist/recorder/reaction.d.ts +13 -0
package/dist/recorder/reaction.js +65 -0
package/dist/recorder/reaction.js.map +1 -0
package/dist/recorder/types.d.ts +62 -0
package/dist/recorder/types.js +2 -0
package/dist/recorder/types.js.map +1 -0
package/dist/replayer/artifacts.d.ts +25 -0
package/dist/replayer/artifacts.js +58 -0
package/dist/replayer/artifacts.js.map +1 -0
package/dist/replayer/invariants.d.ts +26 -0
package/dist/replayer/invariants.js +109 -0
package/dist/replayer/invariants.js.map +1 -0
package/dist/replayer/resolve.d.ts +35 -0
package/dist/replayer/resolve.js +50 -0
package/dist/replayer/resolve.js.map +1 -0
package/dist/replayer/run.d.ts +104 -0
package/dist/replayer/run.js +467 -0
package/dist/replayer/run.js.map +1 -0
package/dist/replayer/values.d.ts +13 -0
package/dist/replayer/values.js +76 -0
package/dist/replayer/values.js.map +1 -0
package/dist/replayer/waits.d.ts +25 -0
package/dist/replayer/waits.js +90 -0
package/dist/replayer/waits.js.map +1 -0
package/dist/version.d.ts +1 -0
package/dist/version.js +10 -0
package/dist/version.js.map +1 -0
package/package.json +77 -0

package/dist/recorder/agent/capture.js ADDED Viewed

@@ -0,0 +1,310 @@
+import { isEditable } from './roles.js';
+import { describe } from './selectors.js';
+import { clean } from './text.js';
+/**
+ * Turns raw DOM events into recorded actions.
+ *
+ * Every listener is registered in the capturing phase on `document`, so an app
+ * that calls `stopPropagation` cannot hide a user's action from the recorder.
+ */
+/**
+ * How close two click events must be to be one physical click. A label
+ * forwarding to its control dispatches synchronously; a human clicking twice
+ * cannot get near this.
+ */
+const ECHO_WINDOW_MS = 30;
+/**
+ * How long a `pointerdown` stays eligible as the aim point of the click that
+ * follows it. A click is dispatched milliseconds after its pointerdown; this is
+ * generous enough to cover a slow frame and far too short to pair up two
+ * separate gestures.
+ */
+const GESTURE_WINDOW_MS = 1_000;
+/** Keys that carry meaning outside a text field. */
+const MEANINGFUL_KEYS = [
+    'Enter',
+    'Escape',
+    'Tab',
+    'ArrowUp',
+    'ArrowDown',
+    'ArrowLeft',
+    'ArrowRight',
+    'Backspace',
+    'Delete',
+    'Home',
+    'End',
+    'PageUp',
+    'PageDown',
+    ' ',
+];
+function targetOf(e) {
+    const t = e.target;
+    return t && t.nodeType === 1 ? t : null;
+}
+function playwrightKey(e) {
+    const mods = [];
+    if (e.ctrlKey)
+        mods.push('Control');
+    if (e.altKey)
+        mods.push('Alt');
+    if (e.metaKey)
+        mods.push('Meta');
+    if (e.shiftKey && e.key.length > 1)
+        mods.push('Shift');
+    const key = e.key === ' ' ? 'Space' : e.key;
+    return [...mods, key].join('+');
+}
+function isStopHotkey(e) {
+    return (e.ctrlKey || e.metaKey) && e.shiftKey && e.key.toLowerCase() === 'x';
+}
+export function installCapture(ctx) {
+    const { config, transport, reveals } = ctx;
+    // fill: committed on change/blur, never per keystroke
+    const focusValue = new WeakMap();
+    const committed = new WeakMap();
+    /**
+     * One physical click can dispatch more than once. A `<label>` forwards to its
+     * control; menu and dialog primitives re-dispatch a synthetic click on their
+     * trigger. Replaying every copy runs a different flow than the one recorded —
+     * two toggles instead of one, a menu opened and immediately closed.
+     *
+     * Tracked against the last click we actually RECORDED, never merely the last
+     * one seen. If a click is dropped because its target has no usable selector,
+     * the copy that follows must still be free to record: suppressing it too
+     * would leave the gesture with no step at all, which is the one outcome worse
+     * than a duplicate, because nothing in the artifact shows it happened.
+     */
+    let lastRecorded = null;
+    let lastPointerDown = null;
+    /**
+     * What the user actually aimed at.
+     *
+     * When a menu or dialog opens on `pointerdown` and portals content over the
+     * cursor, `pointerup` lands on that new content and the browser dispatches
+     * the click on the nearest common ancestor of the two — `<body>`, or `<html>`
+     * when the portal is a sibling of the trigger. The click event then names an
+     * element the user never touched, and for `<html>` there is no usable
+     * selector at all, so the gesture is dropped and the recording is silently
+     * missing a step.
+     *
+     * `pointerdown` fires before any of that reshuffling, so its target is the
+     * one thing in the sequence that reliably identifies the control.
+     */
+    function resolveGestureTarget(clicked) {
+        const pd = lastPointerDown;
+        if (!pd || pd.el === clicked)
+            return clicked;
+        if (Date.now() - pd.t > GESTURE_WINDOW_MS)
+            return clicked;
+        const retargeted = clicked === document.documentElement || clicked === document.body;
+        // Only trust the aim point if it is still addressable; a control that
+        // unmounted on open tells us nothing replay could act on.
+        if (retargeted && pd.el.isConnected && describe(pd.el))
+            return pd.el;
+        // The click target may also simply have no selector of its own.
+        if (!describe(clicked) && pd.el.isConnected && describe(pd.el))
+            return pd.el;
+        return clicked;
+    }
+    function isEchoOfRecordedClick(el) {
+        const prev = lastRecorded;
+        if (!prev)
+            return false;
+        // A forwarded or synthesized click lands in the same task as the one that
+        // caused it. Anything slower is a person clicking again.
+        if (Date.now() - prev.t > ECHO_WINDOW_MS)
+            return false;
+        if (prev.el === el)
+            return true;
+        if (prev.el.contains(el) || el.contains(prev.el))
+            return true;
+        const label = el.closest('label');
+        return Boolean(label && label === prev.el.closest('label'));
+    }
+    /** Returns false when the step was dropped for having no addressable target. */
+    function emitAction(action, el, value) {
+        ctx.beforeAction?.();
+        const target = el ? describe(el) : null;
+        if (el && !target)
+            return false; // nothing addressable — a step we could never replay
+        const t = Date.now();
+        reveals.noteAction(t);
+        const ev = { kind: 'action', action, value, target, t, author: 'human' };
+        transport.emit(ev);
+        return true;
+    }
+    /** Emit the preceding hover first, when that hover is what revealed this target. */
+    function flushRevealingHover(actionTarget) {
+        const hovered = reveals.takeLoadBearingHover(actionTarget);
+        if (hovered)
+            emitAction('hover', hovered, null);
+    }
+    function valueOf(el) {
+        if (el.isContentEditable)
+            return clean(el.innerText, 500);
+        return el.value ?? '';
+    }
+    function commitFill(el) {
+        if (!isEditable(el))
+            return;
+        const value = valueOf(el);
+        if (committed.get(el) === value)
+            return;
+        if (focusValue.get(el) === value && committed.get(el) === undefined)
+            return;
+        committed.set(el, value);
+        flushRevealingHover(el);
+        emitAction('fill', el, value);
+    }
+    /**
+     * Commit an edit that is still sitting in the focused field before recording
+     * whatever the user just did instead.
+     *
+     * `change`/`blur` are the commit triggers, but they are not guaranteed to
+     * fire *before* the next action: programmatic drivers frequently move on
+     * without blurring, which would emit the fill after the action it preceded
+     * and put the IR out of order. This only fixes ordering — it never commits a
+     * value that change/blur would not have committed anyway.
+     */
+    function flushPendingFill() {
+        const active = document.activeElement;
+        if (active && isEditable(active))
+            commitFill(active);
+    }
+    const on = (type, handler) => {
+        document.addEventListener(type, handler, true);
+    };
+    on('focusin', (e) => {
+        const el = targetOf(e);
+        if (el && isEditable(el))
+            focusValue.set(el, valueOf(el));
+    });
+    on('mouseover', (e) => {
+        const el = targetOf(e);
+        if (el)
+            reveals.noteHover(el);
+    });
+    on('pointerdown', (e) => {
+        const el = targetOf(e);
+        if (el)
+            lastPointerDown = { el, t: Date.now() };
+    });
+    on('click', (e) => {
+        const clicked = targetOf(e);
+        if (!clicked)
+            return;
+        const el = resolveGestureTarget(clicked);
+        if (isEchoOfRecordedClick(el))
+            return;
+        flushPendingFill();
+        flushRevealingHover(el);
+        if (emitAction('click', el, null))
+            lastRecorded = { el, t: Date.now() };
+    });
+    on('dblclick', (e) => {
+        const el = targetOf(e);
+        if (!el)
+            return;
+        flushPendingFill();
+        emitAction('dblclick', el, null);
+    });
+    on('change', (e) => {
+        const el = targetOf(e);
+        if (!el)
+            return;
+        if (el.tagName.toLowerCase() === 'select') {
+            const sel = el;
+            const opt = sel.selectedOptions[0];
+            flushPendingFill();
+            flushRevealingHover(el);
+            emitAction('select', el, opt ? opt.value || clean(opt.textContent) : sel.value);
+            return;
+        }
+        // Checkbox/radio state changes are already represented by their click.
+        if (isEditable(el))
+            commitFill(el);
+    });
+    on('blur', (e) => {
+        const el = targetOf(e);
+        if (el && isEditable(el))
+            commitFill(el);
+    });
+    on('keydown', (e) => {
+        // Recording hotkey: swallowed entirely so it never lands in the IR.
+        if (isStopHotkey(e)) {
+            e.preventDefault();
+            e.stopPropagation();
+            transport.binding(config.stopBinding)?.({ reason: 'hotkey' });
+            return;
+        }
+        const el = targetOf(e);
+        if (isEditable(el)) {
+            // Inside a field only Enter and Escape carry meaning (submit / dismiss).
+            // Typing itself is captured as a single `fill` on commit.
+            if (e.key !== 'Enter' && e.key !== 'Escape')
+                return;
+            commitFill(el);
+        }
+        else if (!MEANINGFUL_KEYS.includes(e.key) && !(e.ctrlKey || e.metaKey || e.altKey)) {
+            return;
+        }
+        else {
+            flushPendingFill();
+        }
+        emitAction('press', el, playwrightKey(e));
+    });
+    installScrollCapture(ctx, emitAction);
+}
+/**
+ * Offscreen probe elements that libraries scroll programmatically to detect
+ * resizes — element-resize-detector, react-virtualized, ResizeSensor. They fire
+ * a scroll during layout that no user performed, and recording it produces a
+ * step whose selector can never resolve.
+ */
+const RESIZE_PROBE = [
+    '.erd_scroll_detection_container',
+    '.resize-sensor',
+    '.resize-triggers',
+    '[data-resize-sensor]',
+];
+function isResizeProbe(el) {
+    if (!el)
+        return false;
+    return RESIZE_PROBE.some((sel) => {
+        try {
+            return el.matches(sel) || el.closest(sel) !== null;
+        }
+        catch {
+            return false;
+        }
+    });
+}
+/** Scroll is debounced and only recorded when the position actually moved. */
+function installScrollCapture(ctx, emitAction) {
+    const { config } = ctx;
+    const lastPosition = new WeakMap();
+    const timers = new WeakMap();
+    document.addEventListener('scroll', (e) => {
+        const raw = e.target;
+        if (raw && raw.nodeType === 1 && isResizeProbe(raw))
+            return;
+        const isDocument = !raw || raw === document || raw === document.documentElement || raw === document.body;
+        const key = isDocument ? document : raw;
+        const el = isDocument ? null : raw;
+        const x = el ? el.scrollLeft : window.scrollX;
+        const y = el ? el.scrollTop : window.scrollY;
+        const existing = timers.get(key);
+        if (existing)
+            clearTimeout(existing);
+        timers.set(key, setTimeout(() => {
+            const last = lastPosition.get(key) ?? { x: 0, y: 0 };
+            const moved = Math.abs(x - last.x) >= config.scrollMinDeltaPx ||
+                Math.abs(y - last.y) >= config.scrollMinDeltaPx;
+            if (!moved)
+                return;
+            lastPosition.set(key, { x, y });
+            emitAction('scroll', el, JSON.stringify({ x, y }));
+        }, config.scrollDebounceMs));
+    }, true);
+}
+//# sourceMappingURL=capture.js.map

package/dist/recorder/agent/capture.js.map ADDED Viewed

@@ -0,0 +1 @@

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

package/dist/recorder/agent/config.d.ts ADDED Viewed

@@ -0,0 +1,25 @@
+/**
+ * Shared between the bundled in-page agent and the Node side that injects it.
+ * Kept in its own module so neither direction pulls in the other's code.
+ */
+export interface AgentConfig {
+    emitBinding: string;
+    stopBinding: string;
+    scrollDebounceMs: number;
+    scrollMinDeltaPx: number;
+    /** Cap on selectors harvested from a single mutation record, to bound cost. */
+    maxSelectorsPerMutation: number;
+    /** A hover only becomes a step if it revealed content this recently. */
+    hoverRevealWindowMs: number;
+}
+export declare const DEFAULT_AGENT_CONFIG: AgentConfig;
+/** The bundle exposes the installer here; the injected tail calls it. */
+export declare const INSTALL_GLOBAL = "__replayInstall";
+/** Set once every listener is installed; see `verifyInstrumentation`. */
+export declare const AGENT_READY_FLAG = "__replayAgentReady";
+/**
+ * Settles any pending DOM reaction immediately. The host calls this when the
+ * recording stops, so the final action's reaction is not lost to a confirmation
+ * timer that would have fired after teardown.
+ */
+export declare const FLUSH_GLOBAL = "__replayFlush";

package/dist/recorder/agent/config.js ADDED Viewed

@@ -0,0 +1,23 @@
+/**
+ * Shared between the bundled in-page agent and the Node side that injects it.
+ * Kept in its own module so neither direction pulls in the other's code.
+ */
+export const DEFAULT_AGENT_CONFIG = {
+    emitBinding: '__replayEmit',
+    stopBinding: '__replayStop',
+    scrollDebounceMs: 150,
+    scrollMinDeltaPx: 50,
+    maxSelectorsPerMutation: 12,
+    hoverRevealWindowMs: 400,
+};
+/** The bundle exposes the installer here; the injected tail calls it. */
+export const INSTALL_GLOBAL = '__replayInstall';
+/** Set once every listener is installed; see `verifyInstrumentation`. */
+export const AGENT_READY_FLAG = '__replayAgentReady';
+/**
+ * Settles any pending DOM reaction immediately. The host calls this when the
+ * recording stops, so the final action's reaction is not lost to a confirmation
+ * timer that would have fired after teardown.
+ */
+export const FLUSH_GLOBAL = '__replayFlush';
+//# sourceMappingURL=config.js.map

package/dist/recorder/agent/config.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"config.js","sourceRoot":"","sources":["../../../src/recorder/agent/config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAaH,MAAM,CAAC,MAAM,oBAAoB,GAAgB;IAC/C,WAAW,EAAE,cAAc;IAC3B,WAAW,EAAE,cAAc;IAC3B,gBAAgB,EAAE,GAAG;IACrB,gBAAgB,EAAE,EAAE;IACpB,uBAAuB,EAAE,EAAE;IAC3B,mBAAmB,EAAE,GAAG;CACzB,CAAC;AAEF,yEAAyE;AACzE,MAAM,CAAC,MAAM,cAAc,GAAG,iBAAiB,CAAC;AAEhD,yEAAyE;AACzE,MAAM,CAAC,MAAM,gBAAgB,GAAG,oBAAoB,CAAC;AAErD;;;;GAIG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,eAAe,CAAC"}

package/dist/recorder/agent/dom-reaction.d.ts ADDED Viewed

@@ -0,0 +1,13 @@
+import type { AgentConfig } from './config.js';
+import type { RevealTracker } from './reveal-tracker.js';
+import type { Transport } from './transport.js';
+export interface DomReactionContext {
+    config: AgentConfig;
+    transport: Transport;
+    reveals: RevealTracker;
+}
+export interface DomReactionHandle {
+    /** Confirm and emit any pending appearances now. */
+    flushAppearances(): void;
+}
+export declare function observeDomReactions(ctx: DomReactionContext): DomReactionHandle;

package/dist/recorder/agent/dom-reaction.js ADDED Viewed

@@ -0,0 +1,166 @@
+import { isTransientIndicator } from '../../noise.js';
+import { accessibleName, getRole } from './roles.js';
+import { appearedSelector, goneSelector } from './selectors.js';
+import { isVisible } from './visibility.js';
+/**
+ * Summarizes DOM mutations into the appeared/gone selectors that become a
+ * step's `waitAfter`. This is what lets replay wait on a real signal instead of
+ * a guessed sleep.
+ */
+/** Descendants worth checking inside an added subtree. */
+const INTERESTING = '[data-testid], [data-test], [data-test-id], [data-cy], [id], [role], button, a[href]';
+const OBSERVED_ATTRS = ['class', 'style', 'hidden', 'aria-hidden'];
+/**
+ * Longest an appearance waits for confirmation before being recorded.
+ *
+ * On a busy React app most DOM churn after an action is unrelated to it —
+ * portals, context menus, tooltips and virtualised rows mount and unmount
+ * constantly. Recording all of it produces waits the app will never satisfy,
+ * and the replay then fails on a perfectly healthy build.
+ *
+ * The confirmation also flushes early, the moment the next action is captured,
+ * because that is exactly when replay stops waiting and moves on. Confirming on
+ * a fixed timer alone would discard real signals in a fast or agent-driven
+ * flow, where the next action lands well inside this window.
+ *
+ * `gone` needs no such check: a removed node stays removed.
+ */
+const APPEAR_CONFIRM_MS = 600;
+/** Playwright selector -> something document.querySelector can evaluate. */
+function toCssSelector(selector) {
+    if (selector.startsWith('role=') || selector.startsWith('text=')) {
+        throw new Error('not a CSS selector');
+    }
+    return selector;
+}
+function harvest(nodes, into, pick, revealed, max) {
+    for (let i = 0; i < nodes.length; i++) {
+        const node = nodes[i];
+        if (!node || node.nodeType !== 1)
+            continue;
+        const el = node;
+        revealed.push(el);
+        const own = pick(el);
+        if (own && into.size < max)
+            into.add(own);
+        const descendants = el.querySelectorAll(INTERESTING);
+        for (let j = 0; j < descendants.length && into.size < max; j++) {
+            const d = descendants[j];
+            if (!d)
+                continue;
+            const sel = pick(d);
+            if (sel)
+                into.add(sel);
+        }
+    }
+}
+export function observeDomReactions(ctx) {
+    const { config, transport, reveals } = ctx;
+    const visibility = new WeakMap();
+    /** Appearances awaiting confirmation, keyed by their original timestamp. */
+    let pending = [];
+    const stillVisible = (sel) => {
+        try {
+            const el = document.querySelector(toCssSelector(sel));
+            return el ? isVisible(el) : false;
+        }
+        catch {
+            // role=/text= selectors are not queryable here. Keep them: they came from
+            // a high-priority path, and dropping one on a syntax technicality would
+            // lose real signal.
+            return true;
+        }
+    };
+    const confirm = (entry) => {
+        const survived = entry.selectors.filter(stillVisible);
+        // Carries the ORIGINAL timestamp so the compiler still attributes it to the
+        // action that caused it, not to the confirmation delay.
+        if (survived.length) {
+            transport.emit({ kind: 'dom', appeared: survived, gone: [], t: entry.at });
+        }
+    };
+    const flushAppearances = () => {
+        const due = pending;
+        pending = [];
+        for (const entry of due) {
+            clearTimeout(entry.timer);
+            confirm(entry);
+        }
+    };
+    // Only rendered elements make usable appear-signals; see visibility.ts.
+    // Loading indicators are excluded by what they are, not how long they last:
+    // a spinner genuinely survives to the next action on a cold run, then never
+    // renders at all once the data is cached — so a healthy replay would fail.
+    const visibleAppearedSelector = (el) => {
+        if (!isVisible(el))
+            return null;
+        if (isTransientIndicator(getRole(el), accessibleName(el)))
+            return null;
+        return appearedSelector(el);
+    };
+    const start = () => {
+        const observer = new MutationObserver((records) => {
+            const appeared = new Set();
+            const gone = new Set();
+            const revealed = [];
+            for (const rec of records) {
+                if (rec.type === 'childList') {
+                    harvest(rec.addedNodes, appeared, visibleAppearedSelector, revealed, config.maxSelectorsPerMutation);
+                    harvest(rec.removedNodes, gone, goneSelector, [], config.maxSelectorsPerMutation);
+                    continue;
+                }
+                // An attribute change can flip visibility without touching the tree —
+                // the CSS-hidden toast case, which childList alone would miss.
+                const el = rec.target;
+                const sel = appearedSelector(el);
+                if (!sel)
+                    continue;
+                const now = isVisible(el);
+                const was = visibility.get(el);
+                visibility.set(el, now);
+                // First sighting only seeds the cache; it is not a transition.
+                if (was === undefined || was === now)
+                    continue;
+                if (now) {
+                    appeared.add(sel);
+                    revealed.push(el);
+                }
+                else {
+                    const g = goneSelector(el);
+                    if (g)
+                        gone.add(g);
+                }
+            }
+            const at = Date.now();
+            reveals.noteRevealed(revealed, at);
+            // Emitted immediately — a removal is already final.
+            if (gone.size) {
+                transport.emit({ kind: 'dom', appeared: [], gone: Array.from(gone), t: at });
+            }
+            if (appeared.size) {
+                const entry = {
+                    selectors: Array.from(appeared),
+                    at,
+                    timer: setTimeout(() => {
+                        pending = pending.filter((e) => e !== entry);
+                        confirm(entry);
+                    }, APPEAR_CONFIRM_MS),
+                };
+                pending.push(entry);
+            }
+        });
+        observer.observe(document.documentElement, {
+            childList: true,
+            subtree: true,
+            attributes: true,
+            attributeFilter: OBSERVED_ATTRS,
+        });
+    };
+    // The init script can run before <html> exists.
+    if (document.documentElement)
+        start();
+    else
+        document.addEventListener('DOMContentLoaded', start, { once: true });
+    return { flushAppearances };
+}
+//# sourceMappingURL=dom-reaction.js.map

package/dist/recorder/agent/dom-reaction.js.map ADDED Viewed

@@ -0,0 +1 @@

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

package/dist/recorder/agent/main.d.ts ADDED Viewed

	@@ -0,0 +1 @@
1	+ export {};

package/dist/recorder/agent/main.js ADDED Viewed

@@ -0,0 +1,14 @@
+import { INSTALL_GLOBAL } from './config.js';
+import { pageAgent } from './page-agent.js';
+/**
+ * Bundle entry point. esbuild compiles this and everything it imports into a
+ * single IIFE, which is injected into the page as source text.
+ *
+ * The bundle only *publishes* the installer — it does not run it. Config is
+ * applied by a short call appended after the bundle, so the bundle itself is a
+ * fixed, cacheable string.
+ */
+window[INSTALL_GLOBAL] = (config) => {
+    pageAgent(config);
+};
+//# sourceMappingURL=main.js.map

package/dist/recorder/agent/main.js.map ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"version":3,"file":"main.js","sourceRoot":"","sources":["../../../src/recorder/agent/main.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAoB,MAAM,aAAa,CAAC;AAC/D,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C;;;;;;;GAOG;AACF,MAA6C,CAAC,cAAc,CAAC,GAAG,CAAC,MAAmB,EAAQ,EAAE;IAC7F,SAAS,CAAC,MAAM,CAAC,CAAC;AACpB,CAAC,CAAC"}

package/dist/recorder/agent/page-agent.d.ts ADDED Viewed

@@ -0,0 +1,12 @@
+import { type AgentConfig } from './config.js';
+/**
+ * The in-page capture agent.
+ *
+ * Bundled by `scripts/build-agent.ts` into a standalone IIFE and injected as
+ * source text. It is ordinary module code — it may import freely.
+ *
+ * Only the top frame records. Selectors generated in a subframe would not
+ * resolve against the main frame at replay time, and Phase 0 has no frame
+ * addressing in the IR.
+ */
+export declare function pageAgent(config: AgentConfig): void;

package/dist/recorder/agent/page-agent.js ADDED Viewed

@@ -0,0 +1,40 @@
+import { installCapture } from './capture.js';
+import { AGENT_READY_FLAG, FLUSH_GLOBAL } from './config.js';
+import { observeDomReactions } from './dom-reaction.js';
+import { createRevealTracker } from './reveal-tracker.js';
+import { createTransport } from './transport.js';
+const INSTALLED_FLAG = '__replayAgentInstalled';
+/**
+ * The in-page capture agent.
+ *
+ * Bundled by `scripts/build-agent.ts` into a standalone IIFE and injected as
+ * source text. It is ordinary module code — it may import freely.
+ *
+ * Only the top frame records. Selectors generated in a subframe would not
+ * resolve against the main frame at replay time, and Phase 0 has no frame
+ * addressing in the IR.
+ */
+export function pageAgent(config) {
+    const globals = window;
+    if (globals[INSTALLED_FLAG])
+        return;
+    if (window.top !== window)
+        return;
+    globals[INSTALLED_FLAG] = true;
+    const transport = createTransport(config);
+    // Shared by both halves: the observer reports what appeared, the capture
+    // listeners report hovers and actions, and this decides when a hover mattered.
+    const reveals = createRevealTracker(config);
+    const dom = observeDomReactions({ config, transport, reveals });
+    // An action closes the previous action's reaction window, so pending
+    // appearances are confirmed at exactly the point replay would give up on them.
+    installCapture({ config, transport, reveals, beforeAction: () => dom.flushAppearances() });
+    // The last action has no successor to close its window, so the host settles
+    // it explicitly at teardown.
+    globals[FLUSH_GLOBAL] = () => dom.flushAppearances();
+    // Last line on purpose: reaching it proves every listener above installed.
+    // A recording that silently captures nothing is the worst failure this tool
+    // could have, so the host asserts on this flag.
+    globals[AGENT_READY_FLAG] = true;
+}
+//# sourceMappingURL=page-agent.js.map

package/dist/recorder/agent/page-agent.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"page-agent.js","sourceRoot":"","sources":["../../../src/recorder/agent/page-agent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAoB,MAAM,aAAa,CAAC;AAC/E,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEjD,MAAM,cAAc,GAAG,wBAAwB,CAAC;AAEhD;;;;;;;;;GASG;AACH,MAAM,UAAU,SAAS,CAAC,MAAmB;IAC3C,MAAM,OAAO,GAAG,MAA4C,CAAC;IAC7D,IAAI,OAAO,CAAC,cAAc,CAAC;QAAE,OAAO;IACpC,IAAI,MAAM,CAAC,GAAG,KAAK,MAAM;QAAE,OAAO;IAClC,OAAO,CAAC,cAAc,CAAC,GAAG,IAAI,CAAC;IAE/B,MAAM,SAAS,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;IAC1C,yEAAyE;IACzE,+EAA+E;IAC/E,MAAM,OAAO,GAAG,mBAAmB,CAAC,MAAM,CAAC,CAAC;IAE5C,MAAM,GAAG,GAAG,mBAAmB,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,CAAC;IAChE,qEAAqE;IACrE,+EAA+E;IAC/E,cAAc,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,YAAY,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,gBAAgB,EAAE,EAAE,CAAC,CAAC;IAE3F,4EAA4E;IAC5E,6BAA6B;IAC7B,OAAO,CAAC,YAAY,CAAC,GAAG,GAAG,EAAE,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC;IAErD,2EAA2E;IAC3E,4EAA4E;IAC5E,gDAAgD;IAChD,OAAO,CAAC,gBAAgB,CAAC,GAAG,IAAI,CAAC;AACnC,CAAC"}