@scalebun/web 1.0.0

package/dist/features/replay/engine/crossOrigin.js.map

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

package/dist/features/replay/engine/cssom.d.ts

@@ -0,0 +1,31 @@
+/**
+ * CssomRecorder — captures live CSSOM changes that `MutationObserver` is blind to: `insertRule`,
+ * `deleteRule`, and (for constructable sheets) `replace`/`replaceSync`. Modern CSS-in-JS libs
+ * (styled-components, Emotion "speedy" mode, Lit) mutate stylesheets via these APIs without touching
+ * the DOM, so without this the keyframe captures the initial CSS but mid-session style changes are
+ * lost. We monkey-patch the prototype, emit compact `sheet` deltas, and restore the originals on
+ * teardown. Fail-isolated: a throwing patch never breaks the host app's CSS call.
+ */
+import type { Mutation } from './types';
+import { NodeRegistry } from './nodeRegistry';
+export declare function adoptedSheetId(sheet: CSSStyleSheet): number;
+export declare class CssomRecorder {
+    private readonly reg;
+    private readonly onMutations;
+    private installed;
+    private origInsert?;
+    private origDelete?;
+    private origReplaceSync?;
+    private origReplace?;
+    private pending;
+    private scheduled;
+    constructor(reg: NodeRegistry, onMutations: (m: Mutation[]) => void);
+    install(): void;
+    disconnect(): void;
+    /** Resolve the sheet → ref. Owned sheet → its node id; constructable → synthetic adopted id. */
+    private ref;
+    private record;
+    /** Synchronously emit any queued stylesheet deltas — used to drain before a checkpoint snapshot. */
+    flush(): void;
+}
+//# sourceMappingURL=cssom.d.ts.map

package/dist/features/replay/engine/cssom.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cssom.d.ts","sourceRoot":"","sources":["../../../../src/features/replay/engine/cssom.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAY,MAAM,SAAS,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAM9C,wBAAgB,cAAc,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CAO3D;AAMD,qBAAa,aAAa;IAUtB,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,WAAW;IAV9B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,UAAU,CAAC,CAA4C;IAC/D,OAAO,CAAC,UAAU,CAAC,CAA4C;IAC/D,OAAO,CAAC,eAAe,CAAC,CAA+B;IACvD,OAAO,CAAC,WAAW,CAAC,CAA2B;IAC/C,OAAO,CAAC,OAAO,CAAkB;IACjC,OAAO,CAAC,SAAS,CAAS;gBAGP,GAAG,EAAE,YAAY,EACjB,WAAW,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,KAAK,IAAI;IAGvD,OAAO,IAAI,IAAI;IA+Cf,UAAU,IAAI,IAAI;IAYlB,gGAAgG;IAChG,OAAO,CAAC,GAAG;IAUX,OAAO,CAAC,MAAM;IAQd,oGAAoG;IACpG,KAAK,IAAI,IAAI;CAOd"}

package/dist/features/replay/engine/cssom.js

@@ -0,0 +1,128 @@
+/**
+ * CssomRecorder — captures live CSSOM changes that `MutationObserver` is blind to: `insertRule`,
+ * `deleteRule`, and (for constructable sheets) `replace`/`replaceSync`. Modern CSS-in-JS libs
+ * (styled-components, Emotion "speedy" mode, Lit) mutate stylesheets via these APIs without touching
+ * the DOM, so without this the keyframe captures the initial CSS but mid-session style changes are
+ * lost. We monkey-patch the prototype, emit compact `sheet` deltas, and restore the originals on
+ * teardown. Fail-isolated: a throwing patch never breaks the host app's CSS call.
+ */
+// Stable id per constructable (adopted) sheet — shared with snapshot's serializeAdopted so a delta
+// and the keyframe agree on which adopted sheet they mean.
+const sheetIds = new WeakMap();
+let sheetCounter = 1;
+export function adoptedSheetId(sheet) {
+    let id = sheetIds.get(sheet);
+    if (id == null) {
+        id = sheetCounter++;
+        sheetIds.set(sheet, id);
+    }
+    return id;
+}
+const PATCH_FLAG = '__scalebun_cssom_patched__';
+export class CssomRecorder {
+    constructor(reg, onMutations) {
+        this.reg = reg;
+        this.onMutations = onMutations;
+        this.installed = false;
+        this.pending = [];
+        this.scheduled = false;
+    }
+    install() {
+        if (typeof CSSStyleSheet === 'undefined')
+            return;
+        const proto = CSSStyleSheet.prototype;
+        if (proto[PATCH_FLAG])
+            return; // already patched (another instance / library) — don't double-wrap
+        const self = this;
+        this.origInsert = proto.insertRule;
+        proto.insertRule = function (rule, index) {
+            const ret = self.origInsert.call(this, rule, index);
+            const ref = self.ref(this);
+            if (ref)
+                self.record({ op: 'sheet', sheet: ref, action: 'insert', rule, index: ret });
+            return ret;
+        };
+        this.origDelete = proto.deleteRule;
+        proto.deleteRule = function (index) {
+            self.origDelete.call(this, index);
+            const ref = self.ref(this);
+            if (ref)
+                self.record({ op: 'sheet', sheet: ref, action: 'delete', index });
+        };
+        if (typeof proto.replaceSync === 'function') {
+            this.origReplaceSync = proto.replaceSync;
+            proto.replaceSync = function (css) {
+                self.origReplaceSync.call(this, css);
+                const ref = self.ref(this);
+                if (ref)
+                    self.record({ op: 'sheet', sheet: ref, action: 'replace', rules: rulesOf(this) });
+            };
+        }
+        if (typeof proto.replace === 'function') {
+            this.origReplace = proto.replace;
+            proto.replace = function (css) {
+                const p = self.origReplace.call(this, css);
+                // replace() is async; emit once the rules have settled.
+                Promise.resolve(p).then(() => {
+                    const ref = self.ref(this);
+                    if (ref)
+                        self.record({ op: 'sheet', sheet: ref, action: 'replace', rules: rulesOf(this) });
+                });
+                return p;
+            };
+        }
+        proto[PATCH_FLAG] = true;
+        this.installed = true;
+    }
+    disconnect() {
+        if (!this.installed)
+            return;
+        const proto = CSSStyleSheet.prototype;
+        if (this.origInsert)
+            proto.insertRule = this.origInsert;
+        if (this.origDelete)
+            proto.deleteRule = this.origDelete;
+        if (this.origReplaceSync)
+            proto.replaceSync = this.origReplaceSync;
+        if (this.origReplace)
+            proto.replace = this.origReplace;
+        delete proto[PATCH_FLAG];
+        this.installed = false;
+        this.pending = [];
+    }
+    /** Resolve the sheet → ref. Owned sheet → its node id; constructable → synthetic adopted id. */
+    ref(sheet) {
+        const owner = sheet.ownerNode;
+        if (owner) {
+            const id = this.reg.getId(owner);
+            return id != null ? { node: id } : null; // owner not yet registered → skip (re-keyframe covers it)
+        }
+        return { adopted: adoptedSheetId(sheet) };
+    }
+    // Coalesce a burst (Emotion speedy mode fires thousands of insertRule) into one delta per microtask.
+    record(mut) {
+        this.pending.push(mut);
+        if (!this.scheduled) {
+            this.scheduled = true;
+            queueMicrotask(() => this.flush());
+        }
+    }
+    /** Synchronously emit any queued stylesheet deltas — used to drain before a checkpoint snapshot. */
+    flush() {
+        this.scheduled = false;
+        if (!this.pending.length)
+            return;
+        const batch = this.pending;
+        this.pending = [];
+        this.onMutations(batch);
+    }
+}
+function rulesOf(sheet) {
+    try {
+        return Array.from(sheet.cssRules).map((r) => r.cssText);
+    }
+    catch {
+        return []; // cross-origin
+    }
+}
+//# sourceMappingURL=cssom.js.map

package/dist/features/replay/engine/cssom.js.map

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

package/dist/features/replay/engine/iframe.d.ts

@@ -0,0 +1,65 @@
+/**
+ * IframeManager (F-IFR) — captures SAME-ORIGIN iframe content, which the serializer otherwise misses
+ * (an iframe's DOM lives in a separate Document; the parent observer can't see it and cross-origin
+ * frames are fully opaque). For each accessible iframe it serializes the sub-document (`op:'iframe'`)
+ * using the SHARED registry, observes that document's mutations (→ plain add/remove/attr/text ops),
+ * and (via the `onFrame` hook) lets the interaction recorder capture clicks/moves inside it. Handles
+ * dynamically-added frames + navigation via a capture-phase `load` listener per document, and recurses
+ * into nested iframes up to `maxDepth`. Cross-origin / sandboxed frames throw on access → skipped.
+ *
+ * Deferred: precise nested-offset for interactions beyond depth 1 (approximated by the immediate
+ * parent's box).
+ */
+import type { Mutation, SnapshotOptions } from './types';
+import { NodeRegistry } from './nodeRegistry';
+export interface IframeHooks {
+    /** Called for each accessible sub-document so interactions can be captured there (with an offset). */
+    onFrame?: (doc: Document, getOffset: () => {
+        x: number;
+        y: number;
+    }) => void;
+    /** Called with a sub-document the frame is navigating AWAY from, so interactions stop observing it. */
+    onUnframe?: (doc: Document) => void;
+    maxDepth?: number;
+    /** F-IFR P2 — origin allowlist for cross-origin frame bridging. Empty = cross-origin frames skipped. */
+    frameOrigins?: string[];
+}
+export declare class IframeManager {
+    private readonly reg;
+    private readonly onMutations;
+    private readonly o;
+    private readonly onFrame?;
+    private readonly onUnframe?;
+    private readonly maxDepth;
+    private readonly attached;
+    private loadListeners;
+    private readonly bridges;
+    private readonly frameOrigins;
+    private started;
+    constructor(reg: NodeRegistry, onMutations: (m: Mutation[]) => void, opts?: SnapshotOptions, hooks?: IframeHooks);
+    start(): void;
+    private scan;
+    /**
+     * Drop state for iframes no longer in the DOM.
+     *
+     * `attached` (element → { doc, recorder }) and `bridges` key iframe ELEMENTS strongly and were only
+     * cleared on stop(). An SPA that mounts/unmounts iframes therefore retained every removed one —
+     * its entire sub-Document plus a MutationObserver still running against it.
+     *
+     * Runs off the existing walk points (scan + getDocs) rather than a new timer, so it costs nothing
+     * when nothing changes.
+     */
+    private sweep;
+    private installLoad;
+    /** Serialize a same-origin iframe's document + observe it; recurse into nested frames. */
+    private attach;
+    /** F-IFR P2 — an opaque (cross-origin) frame: bridge it via postMessage when the origin allowlist is
+     *  set + the iframe element is in the captured tree. The child SDK volunteers its capture; we forward
+     *  it through onMutations (op:'iframe' + deltas), exactly like a same-origin frame. */
+    private bridgeCrossOrigin;
+    /** Currently-observed same-origin iframe sub-documents (for the canvas recorder to scan too — A7).
+     *  Sweeps detached iframes first, so a removed frame's document is never handed out for scanning. */
+    subDocuments(): Document[];
+    disconnect(): void;
+}
+//# sourceMappingURL=iframe.d.ts.map

package/dist/features/replay/engine/iframe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"iframe.d.ts","sourceRoot":"","sources":["../../../../src/features/replay/engine/iframe.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAK9C,MAAM,WAAW,WAAW;IAC1B,sGAAsG;IACtG,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IAC7E,uGAAuG;IACvG,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,QAAQ,KAAK,IAAI,CAAC;IACpC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,wGAAwG;IACxG,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,qBAAa,aAAa;IAetB,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,WAAW;IAf9B,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAuB;IACzC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAyB;IAClD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAA2B;IACtD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAGlC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA0E;IACnG,OAAO,CAAC,aAAa,CAAmD;IAExE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA4C;IACpE,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAW;IACxC,OAAO,CAAC,OAAO,CAAS;gBAGL,GAAG,EAAE,YAAY,EACjB,WAAW,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,KAAK,IAAI,EACrD,IAAI,GAAE,eAAoB,EAC1B,KAAK,GAAE,WAAgB;IASzB,KAAK,IAAI,IAAI;IAOb,OAAO,CAAC,IAAI;IAUZ;;;;;;;;;OASG;IACH,OAAO,CAAC,KAAK;IAmBb,OAAO,CAAC,WAAW;IAanB,0FAA0F;IAC1F,OAAO,CAAC,MAAM;IAgDd;;2FAEuF;IACvF,OAAO,CAAC,iBAAiB;IAYzB;yGACqG;IACrG,YAAY,IAAI,QAAQ,EAAE;IAK1B,UAAU,IAAI,IAAI;CAenB"}

package/dist/features/replay/engine/iframe.js

@@ -0,0 +1,186 @@
+/**
+ * IframeManager (F-IFR) — captures SAME-ORIGIN iframe content, which the serializer otherwise misses
+ * (an iframe's DOM lives in a separate Document; the parent observer can't see it and cross-origin
+ * frames are fully opaque). For each accessible iframe it serializes the sub-document (`op:'iframe'`)
+ * using the SHARED registry, observes that document's mutations (→ plain add/remove/attr/text ops),
+ * and (via the `onFrame` hook) lets the interaction recorder capture clicks/moves inside it. Handles
+ * dynamically-added frames + navigation via a capture-phase `load` listener per document, and recurses
+ * into nested iframes up to `maxDepth`. Cross-origin / sandboxed frames throw on access → skipped.
+ *
+ * Deferred: precise nested-offset for interactions beyond depth 1 (approximated by the immediate
+ * parent's box).
+ */
+import { serializeNode, resolveSnapshotOpts } from './snapshot';
+import { MutationRecorder } from './mutations';
+import { bridgeCrossOriginFrame, nodeIdBaseFor } from './crossOrigin';
+export class IframeManager {
+    constructor(reg, onMutations, opts = {}, hooks = {}) {
+        this.reg = reg;
+        this.onMutations = onMutations;
+        // Per-iframe-element state: one recorder per element. On navigation the element's contentDocument
+        // changes — we disconnect the prior recorder before observing the new doc (no leak; A2).
+        this.attached = new Map();
+        this.loadListeners = [];
+        // F-IFR P2 — one postMessage bridge per cross-origin iframe (when frameOrigins is configured).
+        this.bridges = new Map();
+        this.started = false;
+        this.o = resolveSnapshotOpts(opts);
+        this.onFrame = hooks.onFrame;
+        this.onUnframe = hooks.onUnframe;
+        this.maxDepth = hooks.maxDepth ?? 3;
+        this.frameOrigins = hooks.frameOrigins ?? [];
+    }
+    start() {
+        if (this.started || typeof document === 'undefined')
+            return;
+        this.started = true;
+        this.installLoad(document, 0);
+        this.scan(document, 0);
+    }
+    scan(root, depth) {
+        if (depth > this.maxDepth)
+            return;
+        this.sweep();
+        try {
+            root.querySelectorAll('iframe').forEach((f) => this.attach(f, depth));
+        }
+        catch {
+            /* ignore */
+        }
+    }
+    /**
+     * Drop state for iframes no longer in the DOM.
+     *
+     * `attached` (element → { doc, recorder }) and `bridges` key iframe ELEMENTS strongly and were only
+     * cleared on stop(). An SPA that mounts/unmounts iframes therefore retained every removed one —
+     * its entire sub-Document plus a MutationObserver still running against it.
+     *
+     * Runs off the existing walk points (scan + getDocs) rather than a new timer, so it costs nothing
+     * when nothing changes.
+     */
+    sweep() {
+        if (this.attached.size) {
+            for (const [iframe, { doc, rec }] of this.attached) {
+                if (iframe.isConnected)
+                    continue;
+                rec.disconnect();
+                this.onUnframe?.(doc);
+                this.attached.delete(iframe);
+            }
+        }
+        if (this.bridges.size) {
+            for (const [iframe, stop] of this.bridges) {
+                if (iframe.isConnected)
+                    continue;
+                stop();
+                this.bridges.delete(iframe);
+            }
+        }
+    }
+    // Capture phase catches iframe `load` (doesn't bubble) — covers dynamic + navigation. One per doc.
+    installLoad(doc, depth) {
+        const fn = (e) => {
+            const t = e.target;
+            if (t && t.tagName === 'IFRAME')
+                this.attach(t, depth);
+        };
+        try {
+            doc.addEventListener('load', fn, true);
+            this.loadListeners.push({ doc, fn });
+        }
+        catch {
+            /* ignore */
+        }
+    }
+    /** Serialize a same-origin iframe's document + observe it; recurse into nested frames. */
+    attach(iframe, depth) {
+        if (depth > this.maxDepth)
+            return;
+        let idoc = null;
+        try {
+            idoc = iframe.contentDocument; // cross-origin / sandboxed → throws or null
+        }
+        catch {
+            this.bridgeCrossOrigin(iframe); // F-IFR P2 — opaque frame: try the postMessage bridge
+            return;
+        }
+        if (!idoc || !idoc.documentElement) {
+            this.bridgeCrossOrigin(iframe); // null contentDocument (cross-origin) → bridge
+            return;
+        }
+        const prev = this.attached.get(iframe);
+        if (prev) {
+            if (prev.doc === idoc)
+                return; // already observing this exact document (load + scan dedup)
+            // Navigation: tear down the previous document's recorder + interaction listeners before the new.
+            prev.rec.disconnect();
+            this.onUnframe?.(prev.doc);
+            this.attached.delete(iframe);
+        }
+        const id = this.reg.getId(iframe);
+        if (id == null)
+            return; // the iframe element isn't in the captured tree
+        const doc = serializeNode(idoc, this.reg, this.o); // registers nested nodes in the shared registry
+        if (doc)
+            this.onMutations([{ op: 'iframe', id, doc }]);
+        const rec = new MutationRecorder(this.reg, this.onMutations, this.o);
+        rec.observe(idoc.documentElement);
+        this.attached.set(iframe, { doc: idoc, rec });
+        // Interactions inside the frame, offset into the top document's coordinate space (computed live).
+        this.onFrame?.(idoc, () => {
+            try {
+                const r = iframe.getBoundingClientRect();
+                return { x: r.left, y: r.top };
+            }
+            catch {
+                return { x: 0, y: 0 };
+            }
+        });
+        // Nested iframes (bounded).
+        if (depth < this.maxDepth) {
+            this.installLoad(idoc, depth + 1);
+            this.scan(idoc, depth + 1);
+        }
+    }
+    /** F-IFR P2 — an opaque (cross-origin) frame: bridge it via postMessage when the origin allowlist is
+     *  set + the iframe element is in the captured tree. The child SDK volunteers its capture; we forward
+     *  it through onMutations (op:'iframe' + deltas), exactly like a same-origin frame. */
+    bridgeCrossOrigin(iframe) {
+        if (!this.frameOrigins.length || this.bridges.has(iframe))
+            return;
+        const id = this.reg.getId(iframe);
+        if (id == null)
+            return; // iframe element not in the captured tree yet
+        const stop = bridgeCrossOriginFrame(iframe, id, {
+            nodeIdBase: nodeIdBaseFor(id),
+            allowedChildOrigins: this.frameOrigins,
+            emit: this.onMutations,
+        });
+        this.bridges.set(iframe, stop);
+    }
+    /** Currently-observed same-origin iframe sub-documents (for the canvas recorder to scan too — A7).
+     *  Sweeps detached iframes first, so a removed frame's document is never handed out for scanning. */
+    subDocuments() {
+        this.sweep();
+        return [...this.attached.values()].map((a) => a.doc);
+    }
+    disconnect() {
+        for (const { rec } of this.attached.values())
+            rec.disconnect();
+        this.attached.clear();
+        for (const stop of this.bridges.values())
+            stop();
+        this.bridges.clear();
+        for (const { doc, fn } of this.loadListeners) {
+            try {
+                doc.removeEventListener('load', fn, true);
+            }
+            catch {
+                /* ignore */
+            }
+        }
+        this.loadListeners = [];
+        this.started = false;
+    }
+}
+//# sourceMappingURL=iframe.js.map

package/dist/features/replay/engine/iframe.js.map

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

package/dist/features/replay/engine/interactions.d.ts

@@ -0,0 +1,142 @@
+/**
+ * InteractionRecorder — the user layer on top of DOM mutations: cursor moves, clicks (with target +
+ * rage + dead-click detection), scroll, masked input, viewport. This is what turns "DOM playback"
+ * into a real session replay (the parallel to the mobile SDK's native touch layer).
+ *
+ * - move:      throttled cursor positions (clientX/clientY)
+ * - click:     every click + target node id; `rage` when ≥N clicks cluster in time+space
+ * - deadclick: a click with NO DOM activity and NO navigation within `deadMs` → friction signal
+ * - scroll:    throttled scroll offset of the scrolled element
+ * - input:     masked value (password → empty)
+ * - viewport:  on resize
+ *
+ * Events are batched and flushed on an interval (and on demand via flush() for tests). Dead-click
+ * detection uses `notifyDomActivity()`, which the ReplayFeature calls on every mutation/navigation.
+ */
+import { NodeRegistry } from './nodeRegistry';
+export interface ClickTarget {
+    tag: string;
+    interactive: boolean;
+    role?: string;
+    label?: string;
+}
+/**
+ * `sx`/`sy` — the ROOT scroll offset at the instant the pointer event fired.
+ *
+ * `x`/`y` are viewport coords (`clientX/clientY`), so on their own they are only interpretable against
+ * the scroll position that was in force when they were captured. Playback used to recover that from the
+ * separate `scroll` stream, which made click accuracy depend on a stream that is throttled to 100ms and
+ * was, until recently, sheddable under load — reported live as clicks landing "a lil diff space".
+ *
+ * Carrying the offset ON the event makes it self-describing: document position is `(x + sx, y + sy)`, and
+ * the player subtracts whatever scroll it actually applied. Optional because every session captured
+ * before this shipped has no offset; the reader falls back to raw `x`/`y` (see DomReplayer.overlayAt).
+ */
+export type Interaction = {
+    k: 'move';
+    x: number;
+    y: number;
+    sx?: number;
+    sy?: number;
+    t: number;
+} | {
+    k: 'click';
+    x: number;
+    y: number;
+    sx?: number;
+    sy?: number;
+    id?: number;
+    t: number;
+    rage?: boolean;
+    el?: ClickTarget;
+} | {
+    k: 'deadclick';
+    x: number;
+    y: number;
+    sx?: number;
+    sy?: number;
+    id?: number;
+    t: number;
+    el?: ClickTarget;
+} | {
+    k: 'scroll';
+    id: number;
+    x: number;
+    y: number;
+    t: number;
+} | {
+    k: 'input';
+    id: number;
+    value: string;
+    t: number;
+} | {
+    k: 'viewport';
+    w: number;
+    h: number;
+    t: number;
+};
+export interface InteractionOptions {
+    moveThrottleMs?: number;
+    scrollThrottleMs?: number;
+    flushMs?: number;
+    deadMs?: number;
+    rageWindowMs?: number;
+    rageRadius?: number;
+    rageMin?: number;
+    maskInputs?: boolean;
+    maskText?: boolean;
+}
+export declare class InteractionRecorder {
+    private readonly reg;
+    private readonly onEvents;
+    private pending;
+    private listeners;
+    private timer;
+    private deadTimers;
+    private deadObservers;
+    private lastMoveT;
+    private lastScrollT;
+    private lastActivityT;
+    private clickHistory;
+    private startHref;
+    private frameOffsets;
+    private readonly o;
+    constructor(reg: NodeRegistry, onEvents: (events: Interaction[]) => void, opts?: InteractionOptions);
+    /** Fed by the ReplayFeature on every mutation/navigation — powers dead-click detection. */
+    notifyDomActivity(t?: number): void;
+    observe(): void;
+    /** Also capture interactions inside a same-origin iframe document; `getOffset` maps its viewport
+     *  coords into the top document's space (computed live — the iframe can move/scroll). */
+    observeFrame(doc: Document, getOffset: () => {
+        x: number;
+        y: number;
+    }): void;
+    /** Stop capturing in a sub-document (iframe navigated away / removed) — removes its 4 listeners +
+     *  offset entry, so a frequently-reloading frame doesn't accumulate stale docs/listeners (A3). */
+    unobserveFrame(doc: Document): void;
+    /**
+     * Root scroll of the document the event fired in.
+     *
+     * `defaultView.scrollX/scrollY` first: it is correct whether the page scrolls `documentElement` or
+     * `body` (quirks mode, and some frameworks), which the element properties are not. Falls back through
+     * both elements, then 0 — a missing offset must degrade to "no correction", never to a wrong one.
+     */
+    private rootScroll;
+    private offsetFor;
+    flush(): void;
+    disconnect(): void;
+    private add;
+    private onMove;
+    private onClick;
+    /**
+     * Arm a per-click "did anything respond?" check. A click is dead when, within `deadMs`, NONE of these
+     * happen: (1) navigation; (2) a mutation inside the click TARGET's subtree (in-place response);
+     * (3) a structural change anywhere — an element added OR removed under the document (modal/toast/route
+     * swap/removal). Attribute-only / characterData-only churn (animation noise) is ignored on purpose.
+     */
+    private armDeadCheck;
+    private onScroll;
+    private onInput;
+    private onResize;
+}
+//# sourceMappingURL=interactions.d.ts.map

package/dist/features/replay/engine/interactions.d.ts.map

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