@scalebun/web 1.0.0

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

@@ -0,0 +1,261 @@
+/**
+ * MutationRecorder — observes a subtree and emits compact delta ops (add/remove/attr/text) that
+ * reference registry ids. Masking is applied here too (text/attrs), so raw PII never escapes.
+ *
+ * Moves are encoded as remove(old) + add(new) — correct and simple; an optimized move op can come
+ * later. The observer callback only collects + resolves ids; heavier work (and later, the worker
+ * handoff) lives in `buildMutations`.
+ */
+import { serializeNode, serializeShadow, maskText, maskSecret, NO_MASK_TEXT_PARENTS, SENSITIVE_ATTRS, resolveSnapshotOpts, absolutizeAttrValue, isMaskedSubtree, isPasswordField, } from './snapshot';
+import { unregisterSubtree, markSubtree, collectShadowRoots } from './traverse';
+const shadowHandlers = new Set();
+let origAttachShadow = null;
+function addShadowHandler(h) {
+    shadowHandlers.add(h);
+    if (origAttachShadow || typeof Element === 'undefined' || typeof Element.prototype.attachShadow !== 'function')
+        return;
+    origAttachShadow = Element.prototype.attachShadow;
+    Element.prototype.attachShadow = function (init) {
+        const root = origAttachShadow.call(this, init);
+        if (init && init.mode === 'open') {
+            for (const handler of shadowHandlers) {
+                try {
+                    handler(this, root);
+                }
+                catch {
+                    /* a handler must never break the host's attachShadow */
+                }
+            }
+        }
+        return root;
+    };
+}
+function removeShadowHandler(h) {
+    shadowHandlers.delete(h);
+    if (shadowHandlers.size === 0 && origAttachShadow) {
+        Element.prototype.attachShadow = origAttachShadow;
+        origAttachShadow = null;
+    }
+}
+/** Visit every OPEN shadow root under `root` (recursing into shadow trees for nested roots). */
+function forEachOpenShadowRoot(root, fn) {
+    root.childNodes.forEach((child) => {
+        if (child.nodeType !== 1)
+            return;
+        const el = child;
+        const sr = el.shadowRoot;
+        if (sr) {
+            fn(el, sr);
+            forEachOpenShadowRoot(sr, fn);
+        }
+        forEachOpenShadowRoot(el, fn);
+    });
+}
+export class MutationRecorder {
+    constructor(reg, onMutations, opts = {}) {
+        this.reg = reg;
+        this.onMutations = onMutations;
+        this.observer = null;
+        // Coalesce: a busy app fires many MutationObserver callbacks per frame. We batch their records and
+        // build ONE delta per animation frame instead of one per callback — far less main-thread work and
+        // fewer frames to ship (buildMutations already dedups within a batch).
+        this.queued = [];
+        this.scheduled = false;
+        this.rafId = null;
+        // One observer per open shadow root (MO doesn't cross shadow boundaries); all feed `enqueue`.
+        this.shadowObservers = new Map();
+        this.shadowHandler = null;
+        this.observedDoc = null;
+        this.o = resolveSnapshotOpts(opts);
+    }
+    observe(root) {
+        if (typeof MutationObserver === 'undefined')
+            return;
+        this.observer = new MutationObserver((records) => this.enqueue(records));
+        this.observer.observe(root, { subtree: true, childList: true, attributes: true, characterData: true });
+        // Shadow DOM: observe every existing open root, and catch roots created later (this doc only).
+        this.observedDoc = root.ownerDocument ?? root;
+        forEachOpenShadowRoot(root, (_host, sr) => this.observeShadowRoot(sr));
+        this.shadowHandler = (host, sr) => {
+            if (host.ownerDocument !== this.observedDoc)
+                return; // belongs to another recorder's document
+            const isNew = !this.shadowObservers.has(sr);
+            this.observeShadowRoot(sr);
+            // Host already captured + a fresh root → emit a `shadow` op so the player attaches it.
+            const hostId = this.reg.getId(host);
+            if (isNew && hostId != null) {
+                this.onMutations([{ op: 'shadow', host: hostId, shadow: serializeShadow(sr, this.reg, this.o) }]);
+            }
+        };
+        addShadowHandler(this.shadowHandler);
+    }
+    /** Observe one open shadow root (+ any nested roots already inside it); idempotent. */
+    observeShadowRoot(sr) {
+        if (this.shadowObservers.has(sr) || typeof MutationObserver === 'undefined')
+            return;
+        const obs = new MutationObserver((records) => this.enqueue(records));
+        obs.observe(sr, { subtree: true, childList: true, attributes: true, characterData: true });
+        this.shadowObservers.set(sr, obs);
+        forEachOpenShadowRoot(sr, (_h, nested) => this.observeShadowRoot(nested));
+    }
+    enqueue(records) {
+        this.queued.push(...records);
+        if (this.scheduled)
+            return;
+        this.scheduled = true;
+        if (typeof requestAnimationFrame === 'function') {
+            this.rafId = requestAnimationFrame(() => this.drain());
+        }
+        else {
+            queueMicrotask(() => this.drain());
+        }
+    }
+    drain() {
+        this.scheduled = false;
+        this.rafId = null;
+        if (this.observer)
+            this.queued.push(...this.observer.takeRecords());
+        this.takeShadowRecords();
+        const records = this.queued;
+        this.queued = [];
+        this.process(records);
+    }
+    /** Synchronously drain queued + pending records (on-demand flush + deterministic in tests). */
+    flush() {
+        if (this.rafId != null && typeof cancelAnimationFrame === 'function')
+            cancelAnimationFrame(this.rafId);
+        this.scheduled = false;
+        this.rafId = null;
+        if (this.observer)
+            this.queued.push(...this.observer.takeRecords());
+        this.takeShadowRecords();
+        const records = this.queued;
+        this.queued = [];
+        this.process(records);
+    }
+    disconnect() {
+        if (this.rafId != null && typeof cancelAnimationFrame === 'function')
+            cancelAnimationFrame(this.rafId);
+        this.observer?.disconnect();
+        this.observer = null;
+        for (const o of this.shadowObservers.values())
+            o.disconnect();
+        this.shadowObservers.clear();
+        if (this.shadowHandler) {
+            removeShadowHandler(this.shadowHandler);
+            this.shadowHandler = null;
+        }
+        this.observedDoc = null;
+        this.queued = [];
+        this.scheduled = false;
+        this.rafId = null;
+    }
+    /** Pull pending records out of every shadow-root observer into the shared queue (coalesced build). */
+    takeShadowRecords() {
+        for (const o of this.shadowObservers.values())
+            this.queued.push(...o.takeRecords());
+    }
+    process(records) {
+        if (!records.length)
+            return;
+        this.releaseRemovedShadowRoots(records);
+        const muts = buildMutations(records, this.reg, this.o);
+        if (muts.length)
+            this.onMutations(muts);
+    }
+    /**
+     * Drop observers for shadow roots whose host was removed.
+     *
+     * `shadowObservers` keys ShadowRoots STRONGLY and was only cleared on `disconnect()`, so every
+     * unmounted web component left a live MutationObserver running against a detached tree — and the map
+     * entry retained that whole tree for the session. A long SPA session mounting/unmounting components
+     * leaked both observers and DOM.
+     *
+     * Only genuinely-detached hosts are released: a node removed and re-added in the same batch is a
+     * MOVE (still `isConnected`), and releasing it would silently stop observing it.
+     */
+    releaseRemovedShadowRoots(records) {
+        if (this.shadowObservers.size === 0)
+            return;
+        for (const r of records) {
+            if (r.type !== 'childList')
+                continue;
+            r.removedNodes.forEach((n) => {
+                if (n.isConnected)
+                    return; // moved, not removed
+                for (const sr of collectShadowRoots(n)) {
+                    const obs = this.shadowObservers.get(sr);
+                    if (obs) {
+                        obs.disconnect();
+                        this.shadowObservers.delete(sr);
+                    }
+                }
+            });
+        }
+    }
+}
+export function buildMutations(records, reg, o) {
+    const attrOps = new Map(); // `${id}:${key}` — last write wins
+    const textOps = new Map(); // id — last write wins
+    const removes = [];
+    const pendingAdds = [];
+    for (const r of records) {
+        if (r.type === 'attributes') {
+            const id = reg.getId(r.target);
+            if (id == null || !r.attributeName)
+                continue;
+            let value = r.target.getAttribute(r.attributeName);
+            if (value != null && o.maskAllInputs && SENSITIVE_ATTRS.has(r.attributeName))
+                value = maskText(value);
+            // A password field's value is length-masked on EVERY lane, masking on or off — the keyframe and
+            // input-event lanes already handled it unconditionally and this one did not. Must come after the
+            // mask above so it wins rather than passing through a maskText copy that keeps whitespace.
+            if (value != null && r.attributeName === 'value' && isPasswordField(r.target))
+                value = maskSecret(value);
+            if (value != null) {
+                const el = r.target;
+                value = absolutizeAttrValue(r.attributeName, value, el.tagName?.toLowerCase() ?? '', el.ownerDocument?.baseURI ?? '');
+            }
+            attrOps.set(`${id}:${r.attributeName}`, { op: 'attr', id, key: r.attributeName, value });
+        }
+        else if (r.type === 'characterData') {
+            const id = reg.getId(r.target);
+            if (id == null)
+                continue;
+            const parentTag = r.target.parentNode?.nodeName ?? '';
+            const data = r.target.data;
+            const mask = o.maskAllText || isMaskedSubtree(r.target.parentElement, o.maskSel);
+            const value = mask && !NO_MASK_TEXT_PARENTS.has(parentTag) ? maskText(data) : data;
+            textOps.set(id, { op: 'text', id, value });
+        }
+        else if (r.type === 'childList') {
+            r.removedNodes.forEach((n) => {
+                const id = reg.getId(n);
+                if (id != null) {
+                    removes.push({ op: 'remove', parent: reg.getId(r.target) ?? 0, id });
+                    unregisterSubtree(n, reg); // a moved node re-registers fresh on the add below
+                }
+            });
+            r.addedNodes.forEach((n) => pendingAdds.push({ node: n, parent: r.target, next: r.nextSibling }));
+        }
+    }
+    const considered = new Set();
+    const adds = [];
+    for (const { node, parent, next } of pendingAdds) {
+        if (considered.has(node))
+            continue;
+        if (!node.isConnected)
+            continue; // added then removed in the same batch — transient
+        const parentId = reg.getId(parent);
+        if (parentId == null)
+            continue; // inside an untracked added subtree → captured via its ancestor
+        const snode = serializeNode(node, reg, o);
+        if (!snode)
+            continue;
+        markSubtree(node, considered);
+        adds.push({ op: 'add', parent: parentId, next: next ? reg.getId(next) ?? null : null, node: snode });
+    }
+    // Order: removes → adds → attrs → texts (a move = remove old position then add new).
+    return [...removes, ...adds, ...attrOps.values(), ...textOps.values()];
+}
+//# sourceMappingURL=mutations.js.map

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

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

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

@@ -0,0 +1,23 @@
+/**
+ * Bidirectional Node↔id map — the heart of the engine. Every serialized node and every mutation op
+ * references an `id`, which keeps deltas tiny and replay deterministic. A WeakMap on the Node side
+ * means detached nodes are GC'd (no leak); the id→Node map is pruned on `remove`.
+ */
+export declare class NodeRegistry {
+    private idToNode;
+    private nodeToId;
+    private counter;
+    /** `startId` namespaces a cross-origin child frame's ids into a disjoint range (F-IFR P2) so the
+     *  child's nodes never collide with the parent's when stitched into one session. Default 1. */
+    constructor(startId?: number);
+    /** Assign (or return existing) id for a node. Idempotent. */
+    add(node: Node): number;
+    /** Map a SPECIFIC id (from the recorder's id space) to a node — used by the player on rebuild. */
+    set(id: number, node: Node): void;
+    getId(node: Node): number | undefined;
+    getNode(id: number): Node | undefined;
+    has(node: Node): boolean;
+    remove(node: Node): void;
+    get size(): number;
+}
+//# sourceMappingURL=nodeRegistry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"nodeRegistry.d.ts","sourceRoot":"","sources":["../../../../src/features/replay/engine/nodeRegistry.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAA2B;IAC3C,OAAO,CAAC,QAAQ,CAA+B;IAC/C,OAAO,CAAC,OAAO,CAAS;IAExB;mGAC+F;gBACnF,OAAO,SAAI;IAIvB,6DAA6D;IAC7D,GAAG,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM;IASvB,kGAAkG;IAClG,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,GAAG,IAAI;IAMjC,KAAK,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,GAAG,SAAS;IAIrC,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS;IAIrC,GAAG,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO;IAIxB,MAAM,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;IAQxB,IAAI,IAAI,IAAI,MAAM,CAEjB;CACF"}

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

@@ -0,0 +1,51 @@
+/**
+ * Bidirectional Node↔id map — the heart of the engine. Every serialized node and every mutation op
+ * references an `id`, which keeps deltas tiny and replay deterministic. A WeakMap on the Node side
+ * means detached nodes are GC'd (no leak); the id→Node map is pruned on `remove`.
+ */
+export class NodeRegistry {
+    /** `startId` namespaces a cross-origin child frame's ids into a disjoint range (F-IFR P2) so the
+     *  child's nodes never collide with the parent's when stitched into one session. Default 1. */
+    constructor(startId = 1) {
+        this.idToNode = new Map();
+        this.nodeToId = new WeakMap();
+        this.counter = startId;
+    }
+    /** Assign (or return existing) id for a node. Idempotent. */
+    add(node) {
+        const existing = this.nodeToId.get(node);
+        if (existing != null)
+            return existing;
+        const id = this.counter++;
+        this.nodeToId.set(node, id);
+        this.idToNode.set(id, node);
+        return id;
+    }
+    /** Map a SPECIFIC id (from the recorder's id space) to a node — used by the player on rebuild. */
+    set(id, node) {
+        this.nodeToId.set(node, id);
+        this.idToNode.set(id, node);
+        if (id >= this.counter)
+            this.counter = id + 1;
+    }
+    getId(node) {
+        return this.nodeToId.get(node);
+    }
+    getNode(id) {
+        return this.idToNode.get(id);
+    }
+    has(node) {
+        return this.nodeToId.has(node);
+    }
+    remove(node) {
+        const id = this.nodeToId.get(node);
+        if (id != null) {
+            this.nodeToId.delete(node);
+            this.idToNode.delete(id);
+        }
+    }
+    get size() {
+        return this.idToNode.size;
+    }
+}
+//# sourceMappingURL=nodeRegistry.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"nodeRegistry.js","sourceRoot":"","sources":["../../../../src/features/replay/engine/nodeRegistry.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,OAAO,YAAY;IAKvB;mGAC+F;IAC/F,YAAY,OAAO,GAAG,CAAC;QANf,aAAQ,GAAG,IAAI,GAAG,EAAgB,CAAC;QACnC,aAAQ,GAAG,IAAI,OAAO,EAAgB,CAAC;QAM7C,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED,6DAA6D;IAC7D,GAAG,CAAC,IAAU;QACZ,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACzC,IAAI,QAAQ,IAAI,IAAI;YAAE,OAAO,QAAQ,CAAC;QACtC,MAAM,EAAE,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;QAC1B,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAC5B,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;QAC5B,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,kGAAkG;IAClG,GAAG,CAAC,EAAU,EAAE,IAAU;QACxB,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAC5B,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;QAC5B,IAAI,EAAE,IAAI,IAAI,CAAC,OAAO;YAAE,IAAI,CAAC,OAAO,GAAG,EAAE,GAAG,CAAC,CAAC;IAChD,CAAC;IAED,KAAK,CAAC,IAAU;QACd,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACjC,CAAC;IAED,OAAO,CAAC,EAAU;QAChB,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC/B,CAAC;IAED,GAAG,CAAC,IAAU;QACZ,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACjC,CAAC;IAED,MAAM,CAAC,IAAU;QACf,MAAM,EAAE,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACnC,IAAI,EAAE,IAAI,IAAI,EAAE,CAAC;YACf,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YAC3B,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC;IAED,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;IAC5B,CAAC;CACF"}

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

@@ -0,0 +1,11 @@
+/**
+ * Player side — rebuild a keyframe into DOM (registering ids) and apply mutation deltas. Runs in
+ * the dashboard inside a sandboxed, script-free iframe; also used directly in tests so the recorder
+ * and player are verified as one unit. `rebuildWithRegistry` maps each SNode id → its DOM node, so
+ * subsequent deltas resolve.
+ */
+import type { SNode, Mutation } from './types';
+import { NodeRegistry } from './nodeRegistry';
+export declare function rebuildWithRegistry(s: SNode, reg: NodeRegistry, doc: Document): Node | null;
+export declare function applyMutations(muts: Mutation[], reg: NodeRegistry, doc: Document): void;
+//# sourceMappingURL=player.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"player.d.ts","sourceRoot":"","sources":["../../../../src/features/replay/engine/player.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAK9C,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,YAAY,EAAE,GAAG,EAAE,QAAQ,GAAG,IAAI,GAAG,IAAI,CAuE3F;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,QAAQ,EAAE,EAAE,GAAG,EAAE,YAAY,EAAE,GAAG,EAAE,QAAQ,GAAG,IAAI,CAsCvF"}

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

@@ -0,0 +1,284 @@
+/**
+ * Player side — rebuild a keyframe into DOM (registering ids) and apply mutation deltas. Runs in
+ * the dashboard inside a sandboxed, script-free iframe; also used directly in tests so the recorder
+ * and player are verified as one unit. `rebuildWithRegistry` maps each SNode id → its DOM node, so
+ * subsequent deltas resolve.
+ */
+import { unregisterSubtree } from './traverse';
+const SVG_NS = 'http://www.w3.org/2000/svg';
+export function rebuildWithRegistry(s, reg, doc) {
+    switch (s.t) {
+        case 'doc': {
+            const frag = doc.createDocumentFragment();
+            reg.set(s.id, frag);
+            for (const c of s.children) {
+                const n = rebuildWithRegistry(c, reg, doc);
+                if (n && n.nodeType !== 10)
+                    frag.appendChild(n);
+            }
+            return frag;
+        }
+        case 'dt': {
+            const n = doc.implementation.createDocumentType(s.name, s.publicId, s.systemId);
+            reg.set(s.id, n);
+            return n;
+        }
+        case 'el': {
+            const el = s.ns === 'svg' ? doc.createElementNS(SVG_NS, s.tag) : doc.createElement(s.tag);
+            reg.set(s.id, el);
+            for (const [k, v] of Object.entries(s.attrs)) {
+                try {
+                    el.setAttribute(k, v);
+                }
+                catch {
+                    /* invalid attribute name in this context */
+                }
+            }
+            // <template> children belong in its `.content` fragment, not as light children.
+            const sink = s.tag === 'template' ? el.content : el;
+            for (const c of s.children) {
+                const n = rebuildWithRegistry(c, reg, doc);
+                if (n)
+                    sink.appendChild(n);
+            }
+            // Web components: rebuild the open shadow root (host + light children + shadow → browser slots).
+            if (s.shadow) {
+                try {
+                    const root = el.attachShadow({ mode: 'open' });
+                    reg.set(s.shadow.id, root); // so in-shadow deltas resolve their parent
+                    for (const c of s.shadow.children) {
+                        const n = rebuildWithRegistry(c, reg, doc);
+                        if (n)
+                            root.appendChild(n);
+                    }
+                    if (s.shadow.adoptedStyles?.length && 'adoptedStyleSheets' in root) {
+                        try {
+                            root.adoptedStyleSheets = s.shadow.adoptedStyles.map((a) => {
+                                const sheet = new CSSStyleSheet();
+                                sheet.replaceSync(a.css);
+                                return sheet;
+                            });
+                        }
+                        catch {
+                            /* constructable sheets unsupported here — skip (DOM still rebuilt) */
+                        }
+                    }
+                }
+                catch {
+                    /* element can't host a shadow root (e.g. <img>) — skip */
+                }
+            }
+            return el;
+        }
+        case 'tx': {
+            const n = doc.createTextNode(s.value);
+            reg.set(s.id, n);
+            return n;
+        }
+        case 'cm': {
+            const n = doc.createComment(s.value);
+            reg.set(s.id, n);
+            return n;
+        }
+        default:
+            return null;
+    }
+}
+export function applyMutations(muts, reg, doc) {
+    for (const m of muts) {
+        if (m.op === 'remove') {
+            const node = reg.getNode(m.id);
+            if (node?.parentNode)
+                node.parentNode.removeChild(node);
+            if (node)
+                unregisterSubtree(node, reg);
+        }
+        else if (m.op === 'add') {
+            const parent = reg.getNode(m.parent);
+            if (!parent)
+                continue;
+            const node = rebuildWithRegistry(m.node, reg, doc);
+            if (!node)
+                continue;
+            let ref = m.next != null ? (reg.getNode(m.next) ?? null) : null;
+            if (ref && ref.parentNode !== parent)
+                ref = null; // stale ref → append
+            parent.insertBefore(node, ref);
+        }
+        else if (m.op === 'attr') {
+            const el = reg.getNode(m.id);
+            if (!el)
+                continue;
+            if (m.value == null)
+                el.removeAttribute(m.key);
+            else
+                el.setAttribute(m.key, m.value);
+        }
+        else if (m.op === 'text') {
+            const node = reg.getNode(m.id);
+            if (node)
+                node.data = m.value;
+        }
+        else if (m.op === 'sheet') {
+            applySheet(m, reg);
+        }
+        else if (m.op === 'canvas') {
+            applyCanvas(m, reg);
+        }
+        else if (m.op === 'iframe') {
+            applyIframe(m, reg);
+        }
+        else if (m.op === 'shadow') {
+            applyShadow(m, reg, doc);
+        }
+        else if (m.op === 'resource') {
+            applyResource(m, doc);
+        }
+        else {
+            // Exhaustiveness guard — a new Mutation op must be handled above, never silently dropped.
+            const _never = m;
+            void _never;
+        }
+    }
+}
+/** CSSOM delta (mirrors the dashboard engine's applySheetOp; {node} sheets only — the reference
+ *  player has no adopted-sheet registry). Best-effort: a bad rule/realm is skipped, never thrown. */
+function applySheet(m, reg) {
+    const styleEl = 'node' in m.sheet ? reg.getNode(m.sheet.node) : undefined;
+    const live = styleEl?.sheet ?? undefined;
+    try {
+        if (m.action === 'insert') {
+            if (live)
+                live.insertRule(m.rule, Math.min(m.index, live.cssRules.length));
+            else if (styleEl)
+                styleEl.textContent = (styleEl.textContent ?? '') + m.rule;
+        }
+        else if (m.action === 'delete') {
+            if (live && m.index < live.cssRules.length)
+                live.deleteRule(m.index);
+        }
+        else {
+            const css = m.rules.join('');
+            if (styleEl)
+                styleEl.textContent = css;
+            else if (live) {
+                while (live.cssRules.length)
+                    live.deleteRule(0);
+                m.rules.forEach((r, i) => {
+                    try {
+                        live.insertRule(r, i);
+                    }
+                    catch {
+                        /* skip a bad rule */
+                    }
+                });
+            }
+        }
+    }
+    catch {
+        /* invalid rule / cross-realm — skip */
+    }
+}
+/** Draw a captured canvas image back into the rebuilt <canvas> (mirrors the dashboard engine). */
+function applyCanvas(m, reg) {
+    const node = reg.getNode(m.id);
+    if (!node || node.tagName !== 'CANVAS')
+        return;
+    const win = node.ownerDocument?.defaultView ?? (typeof window !== 'undefined' ? window : undefined);
+    if (!win)
+        return;
+    try {
+        const img = new win.Image();
+        img.onload = () => {
+            try {
+                node.width = m.w;
+                node.height = m.h;
+                node.getContext('2d')?.drawImage(img, 0, 0, m.w, m.h);
+            }
+            catch {
+                /* drawing failed — skip */
+            }
+        };
+        img.src = m.data;
+    }
+    catch {
+        /* no Image in this realm — skip */
+    }
+}
+/** Append inlined font resources as stylesheets (idempotent by hash) so a later @font-face with a
+ *  data: src overrides the original cross-origin/non-CORS one that wouldn't load on replay. */
+function applyResource(m, doc) {
+    const sink = doc.head ?? doc.documentElement ?? doc;
+    for (const r of m.resources) {
+        if (doc.querySelector?.(`style[data-scalebun-resource="${r.hash}"]`))
+            continue; // already applied
+        const style = doc.createElement('style');
+        style.setAttribute('data-scalebun-resource', r.hash);
+        style.textContent = r.css;
+        sink.appendChild(style);
+    }
+}
+/** Attach a shadow root to an already-rebuilt host mid-session (host got `attachShadow` after it was
+ *  first captured). Registers the root id so subsequent in-shadow deltas resolve. */
+function applyShadow(m, reg, doc) {
+    const host = reg.getNode(m.host);
+    if (!host || typeof host.attachShadow !== 'function')
+        return;
+    let root;
+    try {
+        root = host.shadowRoot ?? host.attachShadow({ mode: 'open' });
+    }
+    catch {
+        return; // element can't host a shadow root
+    }
+    reg.set(m.shadow.id, root);
+    for (const c of m.shadow.children) {
+        const n = rebuildWithRegistry(c, reg, doc);
+        if (n)
+            root.appendChild(n);
+    }
+    if (m.shadow.adoptedStyles?.length && 'adoptedStyleSheets' in root) {
+        try {
+            root.adoptedStyleSheets = m.shadow.adoptedStyles.map((a) => {
+                const sheet = new CSSStyleSheet();
+                sheet.replaceSync(a.css);
+                return sheet;
+            });
+        }
+        catch {
+            /* constructable sheets unsupported — skip */
+        }
+    }
+}
+/** Write a captured same-origin iframe sub-document into the rebuilt <iframe>'s contentDocument, so
+ *  iframe-internal mutation deltas then resolve against the shared registry (mirrors the dashboard). */
+function applyIframe(m, reg) {
+    const iframe = reg.getNode(m.id);
+    if (!iframe || iframe.tagName !== 'IFRAME')
+        return;
+    let idoc = null;
+    try {
+        idoc = iframe.contentDocument;
+    }
+    catch {
+        return;
+    }
+    if (!idoc)
+        return;
+    const snap = m.doc;
+    const html = snap.t === 'doc' ? snap.children.find((c) => c.t === 'el') : snap.t === 'el' ? snap : null;
+    if (!html)
+        return;
+    try {
+        idoc.open();
+        idoc.write('<!doctype html><html></html>');
+        idoc.close();
+        const el = rebuildWithRegistry(html, reg, idoc);
+        if (el && idoc.documentElement)
+            idoc.replaceChild(el, idoc.documentElement);
+    }
+    catch {
+        /* iframe inaccessible — skip */
+    }
+}
+//# sourceMappingURL=player.js.map