@braidlabs/core 0.1.1

package/src/compat/fragment-boundary.js

@@ -0,0 +1,335 @@
+/* eslint-disable @typescript-eslint/no-unsafe-function-type, prefer-rest-params --
+ * ported from the matrix-tested web-fragments fork: the wrappers must forward the exact
+ * original `arguments` object to native DOM methods, and accept any native function shape. */
+import { compatDomInsertion, compatMultiNodeDomInsertion, executeInertScript, executeInertPreloadLink, restoreScriptType, alreadyExecutedScriptsAndLinks, } from './script-execution.js';
+import { removeBornInertShadowing, unwrapBornInertScriptToLive } from './born-inert-scripts.js';
+import { isDevMode } from '../config.js';
+/**
+ * The fragment boundary: all main-realm interception is confined here — the
+ * host page's `Node`/`Element` prototypes are never touched.
+ *
+ * Every node inside a fragment's DOM is "stamped" with a per-fragment prototype spliced above
+ * its native prototype (`Object.create(nativeProto, overrides)` + `Object.setPrototypeOf(node, …)`).
+ * The overrides provide script/preload activation on insertion and virtualized
+ * `ownerDocument`/`getRootNode` — but only for nodes that belong to the fragment. The host page
+ * runs on pristine prototypes.
+ *
+ * Stamping is applied synchronously at every point where nodes enter the fragment world, and
+ * stamped entry points propagate the stamp to whatever they create or admit (insertion methods,
+ * `cloneNode`, `innerHTML`, `insertAdjacentHTML`), so the stamped set is closed under the
+ * operations fragment code can perform on it.
+ *
+ * A `MutationObserver` scoped to the fragment's shadow root acts as the safety net for
+ * insertions that bypass stamped methods (e.g. code calling captured native functions): scripts
+ * reaching the DOM through such paths are inert by construction (see `born-inert-scripts.ts`
+ * and the gateway's SSR neutralization), and the observer activates them — one microtask later —
+ * in the fragment's realm, stamps the stray subtree, and reports the bypass in dev mode.
+ */
+// Native main-realm references, captured at module load.
+const native = {
+    appendChild: Node.prototype.appendChild,
+    insertBefore: Node.prototype.insertBefore,
+    replaceChild: Node.prototype.replaceChild,
+    getRootNode: Node.prototype.getRootNode,
+    cloneNode: Node.prototype.cloneNode,
+    ownerDocument: Object.getOwnPropertyDescriptor(Node.prototype, 'ownerDocument').get,
+    elementAppend: Element.prototype.append,
+    elementPrepend: Element.prototype.prepend,
+    elementReplaceChildren: Element.prototype.replaceChildren,
+    elementReplaceWith: Element.prototype.replaceWith,
+    insertAdjacentElement: Element.prototype.insertAdjacentElement,
+    insertAdjacentHTML: Element.prototype.insertAdjacentHTML,
+    elementInnerHTML: Object.getOwnPropertyDescriptor(Element.prototype, 'innerHTML'),
+    fragmentAppend: DocumentFragment.prototype.append,
+    fragmentPrepend: DocumentFragment.prototype.prepend,
+    fragmentReplaceChildren: DocumentFragment.prototype.replaceChildren,
+    shadowRootInnerHTML: Object.getOwnPropertyDescriptor(ShadowRoot.prototype, 'innerHTML'),
+};
+export function createFragmentBoundary(options) {
+    const { realmDocument, shadowRoot, braidDocumentElement, abortSignal } = options;
+    const stampedNodes = new WeakSet();
+    const stampedProtos = new Map();
+    const stampedProtoSet = new WeakSet();
+    let warnedAboutUnstampedEntry = false;
+    /** A node is inside this fragment's DOM iff its plain root is the fragment's shadow root. */
+    function isInFragmentDom(node) {
+        return native.getRootNode.call(node) === shadowRoot;
+    }
+    /**
+     * Reverts any born-inert scripts in the given node (or its subtree) to their live form, so
+     * the standard insertion handling below can process them like any other insertion.
+     *
+     * This also covers *clones* of born-inert scripts: clones carry the `type="inert"` +
+     * `data-script-type` attributes (attributes copy with cloneNode) but not the WeakSet
+     * membership. Reviving them here restores standalone-behavior parity.
+     */
+    function reviveInertScript(script) {
+        unwrapBornInertScriptToLive(script);
+        if (script.getAttribute('type') === 'inert' && !alreadyExecutedScriptsAndLinks.has(script)) {
+            restoreScriptType(script);
+        }
+    }
+    function prepareForInsertion(node) {
+        if (node instanceof HTMLScriptElement) {
+            reviveInertScript(node);
+        }
+        else if (node.nodeType === Node.ELEMENT_NODE || node.nodeType === Node.DOCUMENT_FRAGMENT_NODE) {
+            node.querySelectorAll?.('script').forEach((script) => {
+                reviveInertScript(script);
+            });
+        }
+        return node;
+    }
+    /**
+     * Nodes to stamp after an insertion: the node itself, or — for a DocumentFragment, whose
+     * children move into the target during insertion — its current children.
+     */
+    function nodesToStampAfterInsertion(node) {
+        return node.nodeType === Node.DOCUMENT_FRAGMENT_NODE ? [...node.childNodes] : [node];
+    }
+    /**
+     * Creates a wrapper for a single-child insertion method (appendChild, insertBefore).
+     *
+     * When the target is inside the fragment's DOM, the insertion gets script handling (via
+     * `compatDomInsertion`). In all cases the inserted subtree is stamped so the stamped set
+     * stays closed.
+     */
+    function makeSingleNodeInsertion(nativeFn) {
+        return function boundaryInsertion(childNode) {
+            const args = arguments;
+            const futureStamps = nodesToStampAfterInsertion(childNode);
+            const doInsertTheNode = () => {
+                const result = nativeFn.apply(this, args);
+                futureStamps.forEach(stampTree);
+                return result;
+            };
+            if (!isInFragmentDom(this)) {
+                // insertions into unattached trees are not script-processed; scripts are handled when
+                // the tree itself is inserted into the fragment's DOM
+                return doInsertTheNode();
+            }
+            return compatDomInsertion(prepareForInsertion(childNode), doInsertTheNode, realmDocument);
+        };
+    }
+    function boundaryReplaceChild(newChild, oldChild) {
+        const args = arguments;
+        const futureStamps = nodesToStampAfterInsertion(newChild);
+        const doInsertTheNode = () => {
+            const result = native.replaceChild.apply(this, args);
+            futureStamps.forEach(stampTree);
+            return result;
+        };
+        if (!isInFragmentDom(this)) {
+            doInsertTheNode();
+        }
+        else {
+            compatDomInsertion(prepareForInsertion(newChild), doInsertTheNode, realmDocument);
+        }
+        return oldChild;
+    }
+    function boundaryInsertAdjacentElement(where, element) {
+        const args = arguments;
+        const doInsertTheNode = () => {
+            const result = native.insertAdjacentElement.apply(this, args);
+            stampTree(element);
+            return result;
+        };
+        if (!isInFragmentDom(this)) {
+            return doInsertTheNode();
+        }
+        return compatDomInsertion(prepareForInsertion(element), doInsertTheNode, realmDocument);
+    }
+    /**
+     * Creates a wrapper for the multi-node insertion methods (append, prepend, replaceChildren,
+     * replaceWith): the native insertion runs once, after every node argument has been
+     * preprocessed.
+     */
+    function makeMultiNodeInsertion(nativeFn) {
+        return function boundaryMultiInsertion(...nodes) {
+            const args = arguments;
+            const nodeArgs = nodes.filter((node) => typeof node !== 'string');
+            const futureStamps = nodeArgs.flatMap(nodesToStampAfterInsertion);
+            const doInsertTheNodes = () => {
+                nativeFn.apply(this, args);
+                futureStamps.forEach(stampTree);
+            };
+            if (!isInFragmentDom(this)) {
+                return doInsertTheNodes();
+            }
+            nodeArgs.forEach(prepareForInsertion);
+            compatMultiNodeDomInsertion(nodes, doInsertTheNodes, realmDocument);
+        };
+    }
+    function makeHtmlParsingOverrides(innerHTMLDescriptor) {
+        return {
+            // scripts parsed from html never execute (per spec), so parsing only needs stamp propagation
+            innerHTML: {
+                configurable: true,
+                enumerable: true,
+                get() {
+                    return innerHTMLDescriptor.get.call(this);
+                },
+                set(value) {
+                    innerHTMLDescriptor.set.call(this, value);
+                    stampTree(this);
+                },
+            },
+        };
+    }
+    const elementOverrides = {
+        appendChild: { configurable: true, writable: true, value: makeSingleNodeInsertion(native.appendChild) },
+        insertBefore: { configurable: true, writable: true, value: makeSingleNodeInsertion(native.insertBefore) },
+        replaceChild: { configurable: true, writable: true, value: boundaryReplaceChild },
+        insertAdjacentElement: { configurable: true, writable: true, value: boundaryInsertAdjacentElement },
+        append: { configurable: true, writable: true, value: makeMultiNodeInsertion(native.elementAppend) },
+        prepend: { configurable: true, writable: true, value: makeMultiNodeInsertion(native.elementPrepend) },
+        replaceChildren: {
+            configurable: true,
+            writable: true,
+            value: makeMultiNodeInsertion(native.elementReplaceChildren),
+        },
+        replaceWith: { configurable: true, writable: true, value: makeMultiNodeInsertion(native.elementReplaceWith) },
+        insertAdjacentHTML: {
+            configurable: true,
+            writable: true,
+            value: function boundaryInsertAdjacentHTML(position, text) {
+                const result = native.insertAdjacentHTML.call(this, position, text);
+                const lowercasePosition = String(position).toLowerCase();
+                stampTree(lowercasePosition === 'afterbegin' || lowercasePosition === 'beforeend' ? this : this.parentNode ?? this);
+                return result;
+            },
+        },
+        cloneNode: {
+            configurable: true,
+            writable: true,
+            value: function boundaryCloneNode(deep) {
+                const clone = native.cloneNode.call(this, deep);
+                stampTree(clone);
+                return clone;
+            },
+        },
+        ownerDocument: {
+            configurable: true,
+            enumerable: true,
+            get() {
+                return isInFragmentDom(this) ? realmDocument : native.ownerDocument.call(this);
+            },
+        },
+        getRootNode: {
+            configurable: true,
+            writable: true,
+            value: function boundaryGetRootNode(getRootNodeOptions) {
+                const plainRoot = native.getRootNode.call(this);
+                if (plainRoot === shadowRoot) {
+                    // nodes in a fragment report the fragment's document as their root
+                    return realmDocument;
+                }
+                return getRootNodeOptions ? native.getRootNode.call(this, getRootNodeOptions) : plainRoot;
+            },
+        },
+        ...makeHtmlParsingOverrides(native.elementInnerHTML),
+    };
+    function stampNode(node) {
+        if (node.nodeType !== Node.ELEMENT_NODE)
+            return;
+        if (stampedNodes.has(node))
+            return;
+        const proto = Object.getPrototypeOf(node);
+        if (proto === null || stampedProtoSet.has(proto)) {
+            stampedNodes.add(node);
+            return;
+        }
+        let stampedProto = stampedProtos.get(proto);
+        if (!stampedProto) {
+            stampedProto = Object.create(proto, elementOverrides);
+            stampedProtos.set(proto, stampedProto);
+            stampedProtoSet.add(stampedProto);
+        }
+        Object.setPrototypeOf(node, stampedProto);
+        stampedNodes.add(node);
+    }
+    function stampTree(root) {
+        if (root.nodeType === Node.ELEMENT_NODE) {
+            stampNode(root);
+        }
+        else if (root.nodeType !== Node.DOCUMENT_FRAGMENT_NODE) {
+            return;
+        }
+        root.querySelectorAll('*').forEach(stampNode);
+    }
+    /**
+     * Stamp the shadow root itself with own-property overrides (a shadow root is a per-fragment
+     * singleton, so instance properties are simpler than a spliced prototype and just as
+     * effective). The shadow root keeps its native `ownerDocument`/`getRootNode` behavior
+     * (reporting the main document) — only insertions are intercepted.
+     */
+    Object.defineProperties(shadowRoot, {
+        appendChild: { configurable: true, writable: true, value: makeSingleNodeInsertion(native.appendChild) },
+        insertBefore: { configurable: true, writable: true, value: makeSingleNodeInsertion(native.insertBefore) },
+        replaceChild: { configurable: true, writable: true, value: boundaryReplaceChild },
+        append: { configurable: true, writable: true, value: makeMultiNodeInsertion(native.fragmentAppend) },
+        prepend: { configurable: true, writable: true, value: makeMultiNodeInsertion(native.fragmentPrepend) },
+        replaceChildren: {
+            configurable: true,
+            writable: true,
+            value: makeMultiNodeInsertion(native.fragmentReplaceChildren),
+        },
+        ...makeHtmlParsingOverrides(native.shadowRootInnerHTML),
+    });
+    // stamp the initial fragment DOM (for pierced fragments this includes the SSR'ed content;
+    // for slot-fetched fragments this is the already-inserted, neutralized content)
+    stampTree(braidDocumentElement);
+    /**
+     * The boundary observer: activates inert scripts/preload-links that entered the fragment's
+     * DOM through unstamped paths, stamps stray subtrees, and reports bypasses in dev mode.
+     * Everything it does is idempotent with the synchronous stamped-insertion handling.
+     */
+    const observer = new MutationObserver((records) => {
+        for (const record of records) {
+            for (const addedNode of record.addedNodes) {
+                if (addedNode.nodeType !== Node.ELEMENT_NODE)
+                    continue;
+                const addedElement = addedNode;
+                if (!stampedNodes.has(addedElement)) {
+                    if (isDevMode() && !warnedAboutUnstampedEntry) {
+                        warnedAboutUnstampedEntry = true;
+                        console.warn(`Braid compat: a node entered a fragment's DOM through a code path the fragment boundary doesn't intercept synchronously (e.g. a captured native DOM function).\n` +
+                            `Scripts inserted this way still execute in the fragment's realm, but one microtask later than usual. Node:`, addedElement);
+                    }
+                    stampTree(addedElement);
+                }
+                activateInertScriptsAndLinks(addedElement);
+            }
+        }
+    });
+    function activateInertScriptsAndLinks(root) {
+        const inertSelector = 'script[type="inert"],link[rel="inert-preload"],link[rel="inert-prefetch"],link[rel="inert-modulepreload"]';
+        const candidates = [];
+        if (root.matches(inertSelector)) {
+            candidates.push(root);
+        }
+        candidates.push(...root.querySelectorAll(inertSelector));
+        for (const candidate of candidates) {
+            if (candidate instanceof HTMLLinkElement) {
+                executeInertPreloadLink(candidate, realmDocument);
+            }
+            else {
+                if (!candidate.src && !candidate.textContent) {
+                    // an empty inert script can't execute; leave it be
+                    continue;
+                }
+                removeBornInertShadowing(candidate);
+                restoreScriptType(candidate);
+                executeInertScript(candidate, realmDocument);
+            }
+        }
+    }
+    observer.observe(shadowRoot, { childList: true, subtree: true });
+    abortSignal.addEventListener('abort', () => observer.disconnect());
+    return {
+        stampNode,
+        stampTree,
+        disconnect: () => observer.disconnect(),
+    };
+}
+//# sourceMappingURL=fragment-boundary.js.map

package/src/compat/fragment-boundary.js.map

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

package/src/compat/metadata.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Per-fragment metadata the compat adapter attaches to the fragment's shadow root.
+ *
+ * The virtualized `document.readyState` can't be delegated to either document (the fragment
+ * needs its own lifecycle), so the adapter manages it here and the document facade reads it.
+ */
+export interface CompatMetadata {
+    documentReadyState: DocumentReadyState;
+}
+export declare const compatMetadataSymbol: unique symbol;
+export type CompatShadowRoot = ShadowRoot & {
+    [compatMetadataSymbol]: CompatMetadata;
+};
+export declare function setInternalReference<T extends object>(target: T, key: keyof T): void;
+export declare function getInternalReference<T extends object, K extends keyof T>(target: T, key: K): T[K];

package/src/compat/metadata.js

@@ -0,0 +1,21 @@
+/**
+ * Per-fragment metadata the compat adapter attaches to the fragment's shadow root.
+ *
+ * The virtualized `document.readyState` can't be delegated to either document (the fragment
+ * needs its own lifecycle), so the adapter manages it here and the document facade reads it.
+ */
+export const compatMetadataSymbol = Symbol('braid-compat:metadata');
+/** Internal-reference bookkeeping: native members captured before facade/patch installation. */
+const compatReferencesSymbol = Symbol('braid-compat:references');
+export function setInternalReference(target, key) {
+    target[compatReferencesSymbol] ??= {};
+    target[compatReferencesSymbol][key] = Reflect.get(target, key);
+}
+export function getInternalReference(target, key) {
+    const references = target[compatReferencesSymbol];
+    if (!references || references[key] === undefined) {
+        throw new Error(`Attempted to access internal reference "${String(key)}" before it was set.`);
+    }
+    return references[key];
+}
+//# sourceMappingURL=metadata.js.map

package/src/compat/metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata.js","sourceRoot":"","sources":["../../../../../libs/core/src/compat/metadata.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,MAAM,CAAC,MAAM,oBAAoB,GAAG,MAAM,CAAC,uBAAuB,CAAC,CAAC;AAMpE,gGAAgG;AAChG,MAAM,sBAAsB,GAAG,MAAM,CAAC,yBAAyB,CAAC,CAAC;AAEjE,MAAM,UAAU,oBAAoB,CAAmB,MAAS,EAAE,GAAY;IAC3E,MAAc,CAAC,sBAAsB,CAAC,KAAK,EAAE,CAAC;IAC9C,MAAc,CAAC,sBAAsB,CAAC,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AAC1E,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAsC,MAAS,EAAE,GAAM;IACzF,MAAM,UAAU,GAAI,MAAc,CAAC,sBAAsB,CAAC,CAAC;IAC3D,IAAI,CAAC,UAAU,IAAI,UAAU,CAAC,GAAG,CAAC,KAAK,SAAS,EAAE,CAAC;QACjD,MAAM,IAAI,KAAK,CAAC,2CAA2C,MAAM,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAC;IAChG,CAAC;IAED,OAAO,UAAU,CAAC,GAAG,CAAC,CAAC;AACzB,CAAC"}

package/src/compat/navigation-bus.d.ts

@@ -0,0 +1,29 @@
+export declare const navigationBus: {
+    /** Subscribes to host-initiated navigations. Returns an unsubscribe function. */
+    subscribe(subscriber: () => void): () => void;
+    /**
+     * Applies a fragment-initiated history mutation, suppressing the automatic host navigation
+     * sources for its (synchronous) duration so the mutation isn't re-reported as a host
+     * navigation.
+     */
+    withFragmentNavigation<T>(applyNavigation: () => T): T;
+    /**
+     * Reports a host-initiated navigation (from an adapter or an automatic source).
+     *
+     * The first detection is delivered to fragments synchronously (fragments must observe the new
+     * location before the host performs any follow-up history operations — delayed delivery can
+     * cancel pending history traversals in some browsers). Further detections of the same
+     * navigation by other sources — e.g. the Navigation API firing synchronously during
+     * `pushState` plus the host router calling the `onHostNavigation` notify callback right after
+     * — are swallowed until the current microtask queue drains.
+     *
+     * Suppression is keyed on the location, not on time alone. Routers report navigation in
+     * several phases, and the early ones fire *before* the URL changes: Angular's `NavigationStart`
+     * is the common case. Time-only suppression would deliver that stale phase and then swallow
+     * the one that actually moved the page, leaving fragments a navigation behind — so a detection
+     * that finds a location we haven't delivered yet always gets through.
+     */
+    hostNavigationDetected(): void;
+};
+/** Installs the host navigation sources (idempotent). Neither source mutates any host global. */
+export declare function ensureHostNavigationSources(): void;

package/src/compat/navigation-bus.js

@@ -0,0 +1,92 @@
+import { getBraidConfig } from '../config.js';
+/**
+ * Host navigation detection — without host patches, ever.
+ *
+ * Fragment-initiated navigations are broadcast via a synthetic popstate event dispatched on the
+ * main window — that mechanism mutates no host globals and is part of the observable contract
+ * (the host application can react to fragment-driven URL changes through a regular popstate
+ * listener).
+ *
+ * Host-initiated `pushState`/`replaceState` calls are detected through patch-free sources:
+ *
+ * 1. the `onHostNavigation` adapter from the library config: the host wires its router's
+ *    after-navigation hook to our notify callback;
+ * 2. the Navigation API's `currententrychange` event, where available. Traversals are ignored
+ *    (covered natively by `popstate`), and fragment-initiated mutations are suppressed via
+ *    {@link navigationBus.withFragmentNavigation} so they aren't double-reported.
+ */
+const hostNavigationSubscribers = new Set();
+/** True while a fragment-initiated history mutation is being applied. */
+let fragmentNavigationInProgress = false;
+/** True right after a host navigation was delivered, until the current microtask queue drains. */
+let suppressDuplicateDetections = false;
+/** The location as of the last delivered detection, used to tell duplicates from real moves. */
+let lastDeliveredHref;
+export const navigationBus = {
+    /** Subscribes to host-initiated navigations. Returns an unsubscribe function. */
+    subscribe(subscriber) {
+        hostNavigationSubscribers.add(subscriber);
+        return () => hostNavigationSubscribers.delete(subscriber);
+    },
+    /**
+     * Applies a fragment-initiated history mutation, suppressing the automatic host navigation
+     * sources for its (synchronous) duration so the mutation isn't re-reported as a host
+     * navigation.
+     */
+    withFragmentNavigation(applyNavigation) {
+        fragmentNavigationInProgress = true;
+        try {
+            return applyNavigation();
+        }
+        finally {
+            fragmentNavigationInProgress = false;
+        }
+    },
+    /**
+     * Reports a host-initiated navigation (from an adapter or an automatic source).
+     *
+     * The first detection is delivered to fragments synchronously (fragments must observe the new
+     * location before the host performs any follow-up history operations — delayed delivery can
+     * cancel pending history traversals in some browsers). Further detections of the same
+     * navigation by other sources — e.g. the Navigation API firing synchronously during
+     * `pushState` plus the host router calling the `onHostNavigation` notify callback right after
+     * — are swallowed until the current microtask queue drains.
+     *
+     * Suppression is keyed on the location, not on time alone. Routers report navigation in
+     * several phases, and the early ones fire *before* the URL changes: Angular's `NavigationStart`
+     * is the common case. Time-only suppression would deliver that stale phase and then swallow
+     * the one that actually moved the page, leaving fragments a navigation behind — so a detection
+     * that finds a location we haven't delivered yet always gets through.
+     */
+    hostNavigationDetected() {
+        if (fragmentNavigationInProgress)
+            return;
+        const href = typeof location === 'undefined' ? undefined : location.href;
+        if (suppressDuplicateDetections && href === lastDeliveredHref)
+            return;
+        lastDeliveredHref = href;
+        suppressDuplicateDetections = true;
+        queueMicrotask(() => {
+            suppressDuplicateDetections = false;
+        });
+        hostNavigationSubscribers.forEach((subscriber) => subscriber());
+    },
+};
+let hostNavigationSourcesInstalled = false;
+/** Installs the host navigation sources (idempotent). Neither source mutates any host global. */
+export function ensureHostNavigationSources() {
+    if (hostNavigationSourcesInstalled)
+        return;
+    hostNavigationSourcesInstalled = true;
+    const { onHostNavigation } = getBraidConfig();
+    onHostNavigation?.(() => navigationBus.hostNavigationDetected());
+    const navigation = window.navigation;
+    if (navigation?.addEventListener) {
+        navigation.addEventListener('currententrychange', (event) => {
+            if (event?.navigationType === 'traverse')
+                return;
+            navigationBus.hostNavigationDetected();
+        });
+    }
+}
+//# sourceMappingURL=navigation-bus.js.map

package/src/compat/navigation-bus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"navigation-bus.js","sourceRoot":"","sources":["../../../../../libs/core/src/compat/navigation-bus.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9C;;;;;;;;;;;;;;;GAeG;AAEH,MAAM,yBAAyB,GAAG,IAAI,GAAG,EAAc,CAAC;AAExD,yEAAyE;AACzE,IAAI,4BAA4B,GAAG,KAAK,CAAC;AAEzC,kGAAkG;AAClG,IAAI,2BAA2B,GAAG,KAAK,CAAC;AAExC,gGAAgG;AAChG,IAAI,iBAAqC,CAAC;AAE1C,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,iFAAiF;IACjF,SAAS,CAAC,UAAsB;QAC9B,yBAAyB,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAC1C,OAAO,GAAG,EAAE,CAAC,yBAAyB,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IAC5D,CAAC;IAED;;;;OAIG;IACH,sBAAsB,CAAI,eAAwB;QAChD,4BAA4B,GAAG,IAAI,CAAC;QACpC,IAAI,CAAC;YACH,OAAO,eAAe,EAAE,CAAC;QAC3B,CAAC;gBAAS,CAAC;YACT,4BAA4B,GAAG,KAAK,CAAC;QACvC,CAAC;IACH,CAAC;IAED;;;;;;;;;;;;;;;OAeG;IACH,sBAAsB;QACpB,IAAI,4BAA4B;YAAE,OAAO;QAEzC,MAAM,IAAI,GAAG,OAAO,QAAQ,KAAK,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC;QACzE,IAAI,2BAA2B,IAAI,IAAI,KAAK,iBAAiB;YAAE,OAAO;QAEtE,iBAAiB,GAAG,IAAI,CAAC;QACzB,2BAA2B,GAAG,IAAI,CAAC;QACnC,cAAc,CAAC,GAAG,EAAE;YAClB,2BAA2B,GAAG,KAAK,CAAC;QACtC,CAAC,CAAC,CAAC;QACH,yBAAyB,CAAC,OAAO,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,EAAE,CAAC,CAAC;IAClE,CAAC;CACF,CAAC;AAEF,IAAI,8BAA8B,GAAG,KAAK,CAAC;AAE3C,iGAAiG;AACjG,MAAM,UAAU,2BAA2B;IACzC,IAAI,8BAA8B;QAAE,OAAO;IAC3C,8BAA8B,GAAG,IAAI,CAAC;IAEtC,MAAM,EAAE,gBAAgB,EAAE,GAAG,cAAc,EAAE,CAAC;IAC9C,gBAAgB,EAAE,CAAC,GAAG,EAAE,CAAC,aAAa,CAAC,sBAAsB,EAAE,CAAC,CAAC;IAEjE,MAAM,UAAU,GAAI,MAAc,CAAC,UAAU,CAAC;IAC9C,IAAI,UAAU,EAAE,gBAAgB,EAAE,CAAC;QACjC,UAAU,CAAC,gBAAgB,CAAC,oBAAoB,EAAE,CAAC,KAAU,EAAE,EAAE;YAC/D,IAAI,KAAK,EAAE,cAAc,KAAK,UAAU;gBAAE,OAAO;YACjD,aAAa,CAAC,sBAAsB,EAAE,CAAC;QACzC,CAAC,CAAC,CAAC;IACL,CAAC;AACH,CAAC"}

package/src/compat/realm-patches.d.ts

@@ -0,0 +1,21 @@
+import { CompatShadowRoot } from './metadata.js';
+import { FragmentBoundary } from './fragment-boundary.js';
+import { RealmHandle } from '../realm/realm-manager.js';
+/**
+ * Realm-side monkey patches: applied to the fragment's own realm window so
+ * that code running in it behaves as if it were running in the main frame.
+ *
+ * Everything here patches objects the runtime itself created (the hidden realm iframe) or nodes
+ * confined to the fragment's boundary — the host page's globals and prototypes are never
+ * touched.
+ */
+export interface RealmContext extends FragmentBoundary {
+    /**
+     * Ends the boot window, after which a bound fragment's navigations may drive the host URL.
+     *
+     * Called by the adapter once the fragment's own scripts have run. See the boot-window note in
+     * the history patches: a router resolving its initial route is not the user navigating.
+     */
+    bootComplete(): void;
+}
+export declare function initializeRealmContext(realm: RealmHandle, fragmentShadowRoot: CompatShadowRoot, braidDocumentElement: HTMLElement, boundNavigation: boolean, fragmentAbortController: AbortController): RealmContext;