@mml-io/networked-dom-web 0.25.0 → 0.26.0

package/build/DOMSanitizer.d.ts

@@ -1,11 +1,29 @@
+import { IDocumentFactory, IElementLike, INodeLike } from "./DocumentInterface";
 export type DOMSanitizerOptions = {
     tagPrefix?: string;
     replacementTagPrefix?: string;
 };
 export declare class DOMSanitizer {
-    static sanitise(node: HTMLElement, options?: DOMSanitizerOptions): HTMLElement;
-    static replaceNodeTagName(node: HTMLElement, newTagName: string): HTMLElement;
-    static stripAllAttributes(node: HTMLElement): void;
+    /** Tags whose content and attributes are always stripped. */
+    static readonly BLOCKED_TAGS: Set<string>;
+    /**
+     * Returns true if a tag with the given name should be stripped of all
+     * content and attributes during sanitisation.
+     */
+    static isBlockedTag(tagName: string): boolean;
+    /**
+     * Given a tag name and sanitisation options, returns the sanitised tag name.
+     * Non-prefixed tags are renamed (e.g. "div" → "x-div"). Returns null for
+     * blocked tags that should be skipped entirely.
+     */
+    static sanitiseTagName(tagName: string, options: DOMSanitizerOptions): string | null;
+    /**
+     * Sanitises a DOM node in-place. When tag replacement occurs (via tagPrefix option),
+     * the returned node may be a different object than the input node.
+     */
+    static sanitise(node: INodeLike, options?: DOMSanitizerOptions, doc?: IDocumentFactory): INodeLike;
+    static replaceNodeTagName(node: IElementLike, newTagName: string, doc?: IDocumentFactory): IElementLike;
+    static stripAllAttributes(node: IElementLike): void;
     static IsASCIIDigit(c: string): boolean;
     static IsASCIIAlpha(c: string): boolean;
     static IsValidAttributeName(characters: string): boolean;

package/build/DOMSanitizer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DOMSanitizer.d.ts","sourceRoot":"","sources":["../src/DOMSanitizer.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,mBAAmB,GAAG;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B,CAAC;AAEF,qBAAa,YAAY;IACvB,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,WAAW,EAAE,OAAO,GAAE,mBAAwB;IAwCpE,MAAM,CAAC,kBAAkB,CAAC,IAAI,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM;IAa/D,MAAM,CAAC,kBAAkB,CAAC,IAAI,EAAE,WAAW;IAQ3C,MAAM,CAAC,YAAY,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO;IAIvC,MAAM,CAAC,YAAY,CAAC,CAAC,EAAE,MAAM;IAI7B,MAAM,CAAC,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAyBxD,MAAM,CAAC,qBAAqB,CAAC,SAAS,EAAE,MAAM;CAS/C"}
+{"version":3,"file":"DOMSanitizer.d.ts","sourceRoot":"","sources":["../src/DOMSanitizer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,SAAS,EAAiB,MAAM,qBAAqB,CAAC;AAE/F,MAAM,MAAM,mBAAmB,GAAG;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B,CAAC;AAEF,qBAAa,YAAY;IACvB,6DAA6D;IAC7D,MAAM,CAAC,QAAQ,CAAC,YAAY,cAA2C;IAEvE;;;OAGG;IACH,MAAM,CAAC,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAI7C;;;;OAIG;IACH,MAAM,CAAC,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,mBAAmB,GAAG,MAAM,GAAG,IAAI;IAWpF;;;OAGG;IACH,MAAM,CAAC,QAAQ,CACb,IAAI,EAAE,SAAS,EACf,OAAO,GAAE,mBAAwB,EACjC,GAAG,CAAC,EAAE,gBAAgB,GACrB,SAAS;IAyCZ,MAAM,CAAC,kBAAkB,CAAC,IAAI,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,gBAAgB;IAkBxF,MAAM,CAAC,kBAAkB,CAAC,IAAI,EAAE,YAAY;IAQ5C,MAAM,CAAC,YAAY,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO;IAIvC,MAAM,CAAC,YAAY,CAAC,CAAC,EAAE,MAAM;IAI7B,MAAM,CAAC,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAyBxD,MAAM,CAAC,qBAAqB,CAAC,SAAS,EAAE,MAAM;CAS/C"}

package/build/DocumentInterface.d.ts

@@ -0,0 +1,84 @@
+/**
+ * Well-known symbols used to identify virtual DOM nodes without instanceof checks.
+ * Using Symbol.for() ensures the same symbol is used across packages and module boundaries.
+ *
+ * These are defined here (in networked-dom-web) so that both this package and
+ * higher-level packages (mml-web) share a single source of truth.
+ */
+export declare const VIRTUAL_ELEMENT_BRAND: unique symbol;
+export declare const VIRTUAL_TEXT_BRAND: unique symbol;
+export declare const VIRTUAL_DOCUMENT_BRAND: unique symbol;
+export declare const VIRTUAL_FRAGMENT_BRAND: unique symbol;
+/**
+ * Minimal node interface covering the DOM methods used by networked-dom-web.
+ *
+ * Properties like `parentNode`, `ownerDocument`, and method parameters use `any`
+ * intentionally so that `INodeLike` remains structurally compatible with the real
+ * DOM's `Node` type (where e.g. `parentNode` is `ParentNode | null`, not `INodeLike`).
+ */
+export interface INodeLike {
+    readonly [VIRTUAL_ELEMENT_BRAND]?: true;
+    readonly [VIRTUAL_TEXT_BRAND]?: true;
+    readonly [VIRTUAL_FRAGMENT_BRAND]?: true;
+    nodeName: string;
+    textContent: string | null;
+    readonly parentNode: any;
+    readonly childNodes: ArrayLike<INodeLike>;
+    readonly firstChild: INodeLike | null;
+    readonly nextSibling: INodeLike | null;
+    readonly ownerDocument: any;
+    appendChild(child: any): any;
+    insertBefore(newChild: any, refChild: any): any;
+    removeChild(child: any): any;
+    replaceChild(newChild: any, oldChild: any): any;
+    remove(): void;
+}
+export interface IStyleLike {
+    [key: string]: any;
+    setProperty?(name: string, value: string | null): void;
+    getPropertyValue?(name: string): string;
+    removeProperty?(name: string): string;
+}
+export interface IElementLike extends INodeLike {
+    setAttribute(name: string, value: string): void;
+    getAttribute(name: string): string | null;
+    removeAttribute(name: string): void;
+    getAttributeNames(): string[];
+    hasAttribute(name: string): boolean;
+    attributes: ArrayLike<{
+        name: string;
+        value: string;
+    }>;
+    style: IStyleLike;
+    innerHTML: string;
+    outerHTML: string;
+    readonly parentElement: any;
+    addEventListener(type: string, listener: (event: any) => void): void;
+    removeEventListener(type: string, listener: (event: any) => void): void;
+    dispatchEvent(event: any): boolean;
+    append(...nodes: any[]): void;
+    prepend(...nodes: any[]): void;
+}
+/**
+ * Elements that support portal-based child delegation (e.g. Overlay).
+ */
+export interface IPortalElement extends IElementLike {
+    getPortalElement(): IElementLike;
+    getPortalDocumentFactory?(): IDocumentFactory | null;
+}
+export interface IDocumentFactory {
+    createElement(tagName: string): IElementLike;
+    createElementNS?(namespace: string, tagName: string): IElementLike;
+    createTextNode(text: string): INodeLike;
+    createDocumentFragment(): any;
+}
+/**
+ * Type guard to check if a node is an element (has setAttribute).
+ * Works for both real DOM Elements and VirtualHTMLElements.
+ */
+export declare function isElementLike(node: INodeLike): node is IElementLike;
+/**
+ * Type guard to check if an element supports portal-based child delegation.
+ */
+export declare function isPortalElement(element: IElementLike): element is IPortalElement;
+//# sourceMappingURL=DocumentInterface.d.ts.map

package/build/DocumentInterface.d.ts.map

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

package/build/ElementUtils.d.ts

@@ -1,3 +1,4 @@
+import { IDocumentFactory, IElementLike } from "./DocumentInterface";
 import { NetworkedDOMWebsocketOptions } from "./NetworkedDOMWebsocket";
 /**
  * Remaps attribute names to their proper case for SVG elements
@@ -6,17 +7,17 @@ export declare function remapAttributeName(attrName: string): string;
 /**
  * Creates an HTML Element (and optionally SVG Elements) with proper namespace handling
  */
-export declare function createElementWithSVGSupport(tag: string, options?: NetworkedDOMWebsocketOptions): Element;
+export declare function createElementWithSVGSupport(tag: string, options?: NetworkedDOMWebsocketOptions, doc?: IDocumentFactory): IElementLike;
 /**
  * Sets attributes on an element with proper SVG attribute name mapping
  */
-export declare function setElementAttribute(element: Element, key: string, value: string): void;
+export declare function setElementAttribute(element: IElementLike, key: string, value: string): void;
 /**
  * Gets the target element for children operations, handling portal elements
  */
-export declare function getChildrenTarget(parent: Element): Element;
+export declare function getChildrenTarget(parent: IElementLike): IElementLike;
 /**
  * Gets the target element for removal operations, handling portal elements
  */
-export declare function getRemovalTarget(parent: Element): Element;
+export declare function getRemovalTarget(parent: IElementLike): IElementLike;
 //# sourceMappingURL=ElementUtils.d.ts.map

package/build/ElementUtils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ElementUtils.d.ts","sourceRoot":"","sources":["../src/ElementUtils.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,4BAA4B,EAAE,MAAM,yBAAyB,CAAC;AA0HvE;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAM3D;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,4BAAiC,GACzC,OAAO,CA2BT;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAKtF;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAM1D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAMzD"}
+{"version":3,"file":"ElementUtils.d.ts","sourceRoot":"","sources":["../src/ElementUtils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAmB,MAAM,qBAAqB,CAAC;AAEtF,OAAO,EAAE,4BAA4B,EAAE,MAAM,yBAAyB,CAAC;AA0HvE;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAM3D;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,4BAAiC,EAC1C,GAAG,CAAC,EAAE,gBAAgB,GACrB,YAAY,CAoCd;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAK3F;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,YAAY,GAAG,YAAY,CAKpE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,YAAY,GAAG,YAAY,CAKnE"}

package/build/NetworkedDOMWebsocket.d.ts

@@ -1,3 +1,4 @@
+import { IDocumentFactory, IElementLike, INodeLike } from "./DocumentInterface";
 export type NetworkedDOMWebsocketFactory = (url: string) => WebSocket;
 export declare enum NetworkedDOMWebsocketStatus {
     Connecting = 0,
@@ -15,9 +16,7 @@ export type NetworkedDOMWebsocketOptions = {
 };
 export type NetworkedDOMWebsocketAdapter = {
     receiveMessage: (message: MessageEvent) => void;
-    handleEvent: (element: HTMLElement, event: CustomEvent<{
-        element: HTMLElement;
-    }>) => void;
+    handleEvent: (element: IElementLike, event: CustomEvent) => void;
     clearContents: () => boolean;
 };
 /**
@@ -33,22 +32,21 @@ export declare class NetworkedDOMWebsocket {
     private timeCallback?;
     private statusUpdateCallback?;
     private options;
+    private doc?;
     private websocket;
     private websocketAdapter;
     private stopped;
     private backoffTime;
     private status;
     static createWebSocket(url: string): WebSocket;
-    constructor(url: string, websocketFactory: NetworkedDOMWebsocketFactory, parentElement: HTMLElement, timeCallback?: ((time: number) => void) | undefined, statusUpdateCallback?: ((status: NetworkedDOMWebsocketStatus) => void) | undefined, options?: NetworkedDOMWebsocketOptions);
+    constructor(url: string, websocketFactory: NetworkedDOMWebsocketFactory, parentElement: IElementLike, timeCallback?: ((time: number) => void) | undefined, statusUpdateCallback?: ((status: NetworkedDOMWebsocketStatus) => void) | undefined, options?: NetworkedDOMWebsocketOptions, doc?: IDocumentFactory | undefined);
     private setStatus;
     private createWebsocketWithTimeout;
     private waitBackoffTime;
     private startWebSocketConnectionAttempt;
     stop(): void;
-    handleEvent(element: HTMLElement, event: CustomEvent<{
-        element: HTMLElement;
-    }>): void;
+    handleEvent(element: IElementLike, event: CustomEvent): void;
 }
-export declare function isHTMLElement(node: unknown, rootNode: HTMLElement): node is HTMLElement;
-export declare function isText(node: unknown, rootNode: HTMLElement): node is Text;
+export declare function isHTMLElement(node: unknown, rootNode?: unknown): node is IElementLike;
+export declare function isText(node: unknown, rootNode?: unknown): node is INodeLike;
 //# sourceMappingURL=NetworkedDOMWebsocket.d.ts.map

package/build/NetworkedDOMWebsocket.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"NetworkedDOMWebsocket.d.ts","sourceRoot":"","sources":["../src/NetworkedDOMWebsocket.ts"],"names":[],"mappings":"AAaA,MAAM,MAAM,4BAA4B,GAAG,CAAC,GAAG,EAAE,MAAM,KAAK,SAAS,CAAC;AAEtE,oBAAY,2BAA2B;IACrC,UAAU,IAAA;IACV,cAAc,IAAA,CAAE,8EAA8E;IAC9F,SAAS,IAAA,CAAE,uEAAuE;IAClF,YAAY,IAAA;IACZ,YAAY,IAAA;CACb;AAED,wBAAgB,mCAAmC,CAAC,MAAM,EAAE,2BAA2B,GAAG,MAAM,CAe/F;AAED,MAAM,MAAM,4BAA4B,GAAG;IACzC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC,CAAC;AAEF,MAAM,MAAM,4BAA4B,GAAG;IACzC,cAAc,EAAE,CAAC,OAAO,EAAE,YAAY,KAAK,IAAI,CAAC;IAChD,WAAW,EAAE,CAAC,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,WAAW,CAAC;QAAE,OAAO,EAAE,WAAW,CAAA;KAAE,CAAC,KAAK,IAAI,CAAC;IAC1F,aAAa,EAAE,MAAM,OAAO,CAAC;CAC9B,CAAC;AAEF;;;;;GAKG;AACH,qBAAa,qBAAqB;IAgB9B,OAAO,CAAC,GAAG;IACX,OAAO,CAAC,gBAAgB;IACxB,OAAO,CAAC,aAAa;IACrB,OAAO,CAAC,YAAY,CAAC;IACrB,OAAO,CAAC,oBAAoB,CAAC;IAC7B,OAAO,CAAC,OAAO;IApBjB,OAAO,CAAC,SAAS,CAA0B;IAC3C,OAAO,CAAC,gBAAgB,CAA6C;IAErE,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,WAAW,CAAmC;IACtD,OAAO,CAAC,MAAM,CAA4C;WAE5C,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS;gBAQ3C,GAAG,EAAE,MAAM,EACX,gBAAgB,EAAE,4BAA4B,EAC9C,aAAa,EAAE,WAAW,EAC1B,YAAY,CAAC,GAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,aAAA,EACrC,oBAAoB,CAAC,GAAE,CAAC,MAAM,EAAE,2BAA2B,KAAK,IAAI,aAAA,EACpE,OAAO,GAAE,4BAAiC;IAMpD,OAAO,CAAC,SAAS;IASjB,OAAO,CAAC,0BAA0B;YA6FpB,eAAe;YAUf,+BAA+B;IAoBtC,IAAI;IAQJ,WAAW,CAAC,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,WAAW,CAAC;QAAE,OAAO,EAAE,WAAW,CAAA;KAAE,CAAC;CAKtF;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,WAAW,GAAG,IAAI,IAAI,WAAW,CAQvF;AAED,wBAAgB,MAAM,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,WAAW,GAAG,IAAI,IAAI,IAAI,CAQzE"}
+{"version":3,"file":"NetworkedDOMWebsocket.d.ts","sourceRoot":"","sources":["../src/NetworkedDOMWebsocket.ts"],"names":[],"mappings":"AAMA,OAAO,EACL,gBAAgB,EAChB,YAAY,EACZ,SAAS,EAGV,MAAM,qBAAqB,CAAC;AAQ7B,MAAM,MAAM,4BAA4B,GAAG,CAAC,GAAG,EAAE,MAAM,KAAK,SAAS,CAAC;AAEtE,oBAAY,2BAA2B;IACrC,UAAU,IAAA;IACV,cAAc,IAAA,CAAE,8EAA8E;IAC9F,SAAS,IAAA,CAAE,uEAAuE;IAClF,YAAY,IAAA;IACZ,YAAY,IAAA;CACb;AAED,wBAAgB,mCAAmC,CAAC,MAAM,EAAE,2BAA2B,GAAG,MAAM,CAe/F;AAED,MAAM,MAAM,4BAA4B,GAAG;IACzC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC,CAAC;AAEF,MAAM,MAAM,4BAA4B,GAAG;IACzC,cAAc,EAAE,CAAC,OAAO,EAAE,YAAY,KAAK,IAAI,CAAC;IAChD,WAAW,EAAE,CAAC,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,WAAW,KAAK,IAAI,CAAC;IACjE,aAAa,EAAE,MAAM,OAAO,CAAC;CAC9B,CAAC;AAEF;;;;;GAKG;AACH,qBAAa,qBAAqB;IAgB9B,OAAO,CAAC,GAAG;IACX,OAAO,CAAC,gBAAgB;IACxB,OAAO,CAAC,aAAa;IACrB,OAAO,CAAC,YAAY,CAAC;IACrB,OAAO,CAAC,oBAAoB,CAAC;IAC7B,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,GAAG,CAAC;IArBd,OAAO,CAAC,SAAS,CAA0B;IAC3C,OAAO,CAAC,gBAAgB,CAA6C;IAErE,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,WAAW,CAAmC;IACtD,OAAO,CAAC,MAAM,CAA4C;WAE5C,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS;gBAQ3C,GAAG,EAAE,MAAM,EACX,gBAAgB,EAAE,4BAA4B,EAC9C,aAAa,EAAE,YAAY,EAC3B,YAAY,CAAC,GAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,aAAA,EACrC,oBAAoB,CAAC,GAAE,CAAC,MAAM,EAAE,2BAA2B,KAAK,IAAI,aAAA,EACpE,OAAO,GAAE,4BAAiC,EAC1C,GAAG,CAAC,EAAE,gBAAgB,YAAA;IAMhC,OAAO,CAAC,SAAS;IASjB,OAAO,CAAC,0BAA0B;YA+FpB,eAAe;YAUf,+BAA+B;IAoBtC,IAAI;IAQJ,WAAW,CAAC,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,WAAW;CAK7D;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,OAAO,GAAG,IAAI,IAAI,YAAY,CAkBrF;AAED,wBAAgB,MAAM,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,OAAO,GAAG,IAAI,IAAI,SAAS,CAiB3E"}

package/build/NetworkedDOMWebsocketAdapterBase.d.ts

@@ -0,0 +1,52 @@
+import { IDocumentFactory, IElementLike, INodeLike } from "./DocumentInterface";
+import { NetworkedDOMWebsocketAdapter, NetworkedDOMWebsocketOptions } from "./NetworkedDOMWebsocket";
+/**
+ * Shared state and element management logic for both V01 and V02 websocket adapters.
+ *
+ * Subclasses handle protocol-specific concerns: message encoding/decoding, event
+ * format, hidden element placeholders (V02), and batch mode (V02).
+ */
+export declare abstract class NetworkedDOMWebsocketAdapterBase implements NetworkedDOMWebsocketAdapter {
+    protected readonly websocket: WebSocket;
+    protected readonly parentElement: IElementLike;
+    protected readonly connectedCallback: () => void;
+    protected readonly timeCallback?: ((time: number) => void) | undefined;
+    protected readonly options: NetworkedDOMWebsocketOptions;
+    protected idToElement: Map<number, INodeLike>;
+    protected elementToId: Map<INodeLike, number>;
+    protected currentRoot: INodeLike | null;
+    protected readonly docFactory: IDocumentFactory;
+    protected pendingPortalChildren: Map<IElementLike, INodeLike[]>;
+    protected elementFactoryOverride: Map<INodeLike, IDocumentFactory>;
+    constructor(websocket: WebSocket, parentElement: IElementLike, connectedCallback: () => void, timeCallback?: ((time: number) => void) | undefined, options?: NetworkedDOMWebsocketOptions, doc?: IDocumentFactory);
+    abstract receiveMessage(event: MessageEvent): void;
+    abstract handleEvent(element: IElementLike, event: CustomEvent): void;
+    clearContents(): boolean;
+    /**
+     * Creates a text node, registers it in the id maps, and returns it.
+     */
+    protected createTextNode(nodeId: number, text: string, factory: IDocumentFactory): INodeLike;
+    /**
+     * Inserts elements into the correct position within a parent, using
+     * previousElement/nextElement for positioning. Creates a DocumentFragment
+     * when inserting before a reference node.
+     */
+    protected insertElements(targetForChildren: IElementLike, elementsToAdd: INodeLike[], previousElement: INodeLike | null, nextElement: INodeLike | null, factory: IDocumentFactory): void;
+    /**
+     * Recursively removes element-to-id mappings for all descendants of a parent.
+     * V02 overrides this to also handle hidden placeholder elements.
+     */
+    protected removeChildElementIds(parent: INodeLike): void;
+    /**
+     * Called during removeChildElementIds when a child has no registered id.
+     * V01 logs an error. V02 overrides to check for placeholder elements.
+     */
+    protected handleUnregisteredChild(child: INodeLike): void;
+    /**
+     * Resets state and applies a snapshot element to the parent.
+     * Appending to the tree triggers MElement connectedCallbacks (which set up portals),
+     * then pending portal children are flushed.
+     */
+    protected resetAndApplySnapshot(element: INodeLike): void;
+}
+//# sourceMappingURL=NetworkedDOMWebsocketAdapterBase.d.ts.map

package/build/NetworkedDOMWebsocketAdapterBase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NetworkedDOMWebsocketAdapterBase.d.ts","sourceRoot":"","sources":["../src/NetworkedDOMWebsocketAdapterBase.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,SAAS,EAAiB,MAAM,qBAAqB,CAAC;AAE/F,OAAO,EAEL,4BAA4B,EAC5B,4BAA4B,EAC7B,MAAM,yBAAyB,CAAC;AAGjC;;;;;GAKG;AACH,8BAAsB,gCAAiC,YAAW,4BAA4B;IAS1F,SAAS,CAAC,QAAQ,CAAC,SAAS,EAAE,SAAS;IACvC,SAAS,CAAC,QAAQ,CAAC,aAAa,EAAE,YAAY;IAC9C,SAAS,CAAC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,IAAI;IAChD,SAAS,CAAC,QAAQ,CAAC,YAAY,CAAC,GAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI;IACxD,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,4BAA4B;IAZ1D,SAAS,CAAC,WAAW,yBAAgC;IACrD,SAAS,CAAC,WAAW,yBAAgC;IACrD,SAAS,CAAC,WAAW,EAAE,SAAS,GAAG,IAAI,CAAQ;IAC/C,SAAS,CAAC,QAAQ,CAAC,UAAU,EAAE,gBAAgB,CAAC;IAChD,SAAS,CAAC,qBAAqB,iCAAwC;IACvE,SAAS,CAAC,sBAAsB,mCAA0C;gBAGrD,SAAS,EAAE,SAAS,EACpB,aAAa,EAAE,YAAY,EAC3B,iBAAiB,EAAE,MAAM,IAAI,EAC7B,YAAY,CAAC,GAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,aAAA,EACrC,OAAO,GAAE,4BAAiC,EAC7D,GAAG,CAAC,EAAE,gBAAgB;IAWxB,QAAQ,CAAC,cAAc,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI;IAClD,QAAQ,CAAC,WAAW,CAAC,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,WAAW,GAAG,IAAI;IAE9D,aAAa,IAAI,OAAO;IAa/B;;OAEG;IACH,SAAS,CAAC,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,GAAG,SAAS;IAQ5F;;;;OAIG;IACH,SAAS,CAAC,cAAc,CACtB,iBAAiB,EAAE,YAAY,EAC/B,aAAa,EAAE,SAAS,EAAE,EAC1B,eAAe,EAAE,SAAS,GAAG,IAAI,EACjC,WAAW,EAAE,SAAS,GAAG,IAAI,EAC7B,OAAO,EAAE,gBAAgB,GACxB,IAAI;IAkBP;;;OAGG;IACH,SAAS,CAAC,qBAAqB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI;IAqBxD;;;OAGG;IACH,SAAS,CAAC,uBAAuB,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI;IAIzD;;;;OAIG;IACH,SAAS,CAAC,qBAAqB,CAAC,OAAO,EAAE,SAAS,GAAG,IAAI;CAqB1D"}

package/build/NetworkedDOMWebsocketV01Adapter.d.ts

@@ -1,23 +1,13 @@
-import { NetworkedDOMWebsocketAdapter, NetworkedDOMWebsocketOptions } from "./NetworkedDOMWebsocket";
-export declare class NetworkedDOMWebsocketV01Adapter implements NetworkedDOMWebsocketAdapter {
-    private websocket;
-    private parentElement;
-    private connectedCallback;
-    private timeCallback?;
-    private options;
-    private idToElement;
-    private elementToId;
-    private currentRoot;
-    constructor(websocket: WebSocket, parentElement: HTMLElement, connectedCallback: () => void, timeCallback?: ((time: number) => void) | undefined, options?: NetworkedDOMWebsocketOptions);
-    handleEvent(element: HTMLElement, event: CustomEvent<{
-        element: HTMLElement;
-    }>): void;
+import { IDocumentFactory, IElementLike } from "./DocumentInterface";
+import { NetworkedDOMWebsocketOptions } from "./NetworkedDOMWebsocket";
+import { NetworkedDOMWebsocketAdapterBase } from "./NetworkedDOMWebsocketAdapterBase";
+export declare class NetworkedDOMWebsocketV01Adapter extends NetworkedDOMWebsocketAdapterBase {
+    constructor(websocket: WebSocket, parentElement: IElementLike, connectedCallback: () => void, timeCallback?: (time: number) => void, options?: NetworkedDOMWebsocketOptions, doc?: IDocumentFactory);
+    handleEvent(element: IElementLike, event: CustomEvent): void;
     private send;
-    clearContents(): boolean;
     receiveMessage(event: MessageEvent): void;
     private handleTextChanged;
     private handleChildrenChanged;
-    private removeChildElementIds;
     private handleSnapshot;
     private handleAttributeChange;
     private handleNewElement;

package/build/NetworkedDOMWebsocketV01Adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"NetworkedDOMWebsocketV01Adapter.d.ts","sourceRoot":"","sources":["../src/NetworkedDOMWebsocketV01Adapter.ts"],"names":[],"mappings":"AAiBA,OAAO,EAGL,4BAA4B,EAC5B,4BAA4B,EAC7B,MAAM,yBAAyB,CAAC;AAEjC,qBAAa,+BAAgC,YAAW,4BAA4B;IAMhF,OAAO,CAAC,SAAS;IACjB,OAAO,CAAC,aAAa;IACrB,OAAO,CAAC,iBAAiB;IACzB,OAAO,CAAC,YAAY,CAAC;IACrB,OAAO,CAAC,OAAO;IATjB,OAAO,CAAC,WAAW,CAA2B;IAC9C,OAAO,CAAC,WAAW,CAA2B;IAC9C,OAAO,CAAC,WAAW,CAA4B;gBAGrC,SAAS,EAAE,SAAS,EACpB,aAAa,EAAE,WAAW,EAC1B,iBAAiB,EAAE,MAAM,IAAI,EAC7B,YAAY,CAAC,GAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,aAAA,EACrC,OAAO,GAAE,4BAAiC;IAK7C,WAAW,CAAC,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,WAAW,CAAC;QAAE,OAAO,EAAE,WAAW,CAAA;KAAE,CAAC;IAsBrF,OAAO,CAAC,IAAI;IAIL,aAAa,IAAI,OAAO;IAW/B,cAAc,CAAC,KAAK,EAAE,YAAY;IAoDlC,OAAO,CAAC,iBAAiB;IAiBzB,OAAO,CAAC,qBAAqB;IAiE7B,OAAO,CAAC,qBAAqB;IAmB7B,OAAO,CAAC,cAAc;IAuBtB,OAAO,CAAC,qBAAqB;IAsB7B,OAAO,CAAC,gBAAgB;CAoDzB"}
+{"version":3,"file":"NetworkedDOMWebsocketV01Adapter.d.ts","sourceRoot":"","sources":["../src/NetworkedDOMWebsocketV01Adapter.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAa,MAAM,qBAAqB,CAAC;AAOhF,OAAO,EAAyB,4BAA4B,EAAE,MAAM,yBAAyB,CAAC;AAC9F,OAAO,EAAE,gCAAgC,EAAE,MAAM,oCAAoC,CAAC;AAStF,qBAAa,+BAAgC,SAAQ,gCAAgC;gBAEjF,SAAS,EAAE,SAAS,EACpB,aAAa,EAAE,YAAY,EAC3B,iBAAiB,EAAE,MAAM,IAAI,EAC7B,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,EACrC,OAAO,GAAE,4BAAiC,EAC1C,GAAG,CAAC,EAAE,gBAAgB;IAKjB,WAAW,CAAC,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,WAAW;IAsB5D,OAAO,CAAC,IAAI;IAIZ,cAAc,CAAC,KAAK,EAAE,YAAY;IAoDlC,OAAO,CAAC,iBAAiB;IAiBzB,OAAO,CAAC,qBAAqB;IA6D7B,OAAO,CAAC,cAAc;IAQtB,OAAO,CAAC,qBAAqB;IAsB7B,OAAO,CAAC,gBAAgB;CAyDzB"}

package/build/NetworkedDOMWebsocketV02Adapter.d.ts

@@ -1,22 +1,14 @@
-import { NetworkedDOMWebsocketAdapter, NetworkedDOMWebsocketOptions } from "./NetworkedDOMWebsocket";
-export declare class NetworkedDOMWebsocketV02Adapter implements NetworkedDOMWebsocketAdapter {
-    private websocket;
-    private parentElement;
-    private connectedCallback;
-    private timeCallback?;
-    private options;
-    private idToElement;
-    private elementToId;
+import { IDocumentFactory, IElementLike, INodeLike } from "./DocumentInterface";
+import { NetworkedDOMWebsocketOptions } from "./NetworkedDOMWebsocket";
+import { NetworkedDOMWebsocketAdapterBase } from "./NetworkedDOMWebsocketAdapterBase";
+export declare class NetworkedDOMWebsocketV02Adapter extends NetworkedDOMWebsocketAdapterBase {
     private placeholderToId;
     private hiddenPlaceholderElements;
-    private currentRoot;
     private batchMode;
     private batchMessages;
     private readonly protocolSubversion;
-    constructor(websocket: WebSocket, parentElement: HTMLElement, connectedCallback: () => void, timeCallback?: ((time: number) => void) | undefined, options?: NetworkedDOMWebsocketOptions);
-    handleEvent(element: HTMLElement, event: CustomEvent<{
-        element: HTMLElement;
-    }>): void;
+    constructor(websocket: WebSocket, parentElement: IElementLike, connectedCallback: () => void, timeCallback?: (time: number) => void, options?: NetworkedDOMWebsocketOptions, doc?: IDocumentFactory);
+    handleEvent(element: IElementLike, event: CustomEvent): void;
     private send;
     clearContents(): boolean;
     receiveMessage(event: MessageEvent): void;
@@ -25,7 +17,7 @@ export declare class NetworkedDOMWebsocketV02Adapter implements NetworkedDOMWebs
     private handleChangeHiddenFrom;
     private handleChildrenAdded;
     private handleChildrenRemoved;
-    private removeChildElementIds;
+    protected handleUnregisteredChild(child: INodeLike): void;
     private handleSnapshot;
     private handleDocumentTime;
     private handleAttributeChange;

package/build/NetworkedDOMWebsocketV02Adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"NetworkedDOMWebsocketV02Adapter.d.ts","sourceRoot":"","sources":["../src/NetworkedDOMWebsocketV02Adapter.ts"],"names":[],"mappings":"AA4BA,OAAO,EAGL,4BAA4B,EAC5B,4BAA4B,EAC7B,MAAM,yBAAyB,CAAC;AAQjC,qBAAa,+BAAgC,YAAW,4BAA4B;IAiBhF,OAAO,CAAC,SAAS;IACjB,OAAO,CAAC,aAAa;IACrB,OAAO,CAAC,iBAAiB;IACzB,OAAO,CAAC,YAAY,CAAC;IACrB,OAAO,CAAC,OAAO;IApBjB,OAAO,CAAC,WAAW,CAA2B;IAC9C,OAAO,CAAC,WAAW,CAA2B;IAC9C,OAAO,CAAC,eAAe,CAA2B;IAClD,OAAO,CAAC,yBAAyB,CAM7B;IACJ,OAAO,CAAC,WAAW,CAA4B;IAC/C,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,aAAa,CAA2C;IAChE,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAwD;gBAGjF,SAAS,EAAE,SAAS,EACpB,aAAa,EAAE,WAAW,EAC1B,iBAAiB,EAAE,MAAM,IAAI,EAC7B,YAAY,CAAC,GAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,aAAA,EACrC,OAAO,GAAE,4BAAiC;IAa7C,WAAW,CAAC,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,WAAW,CAAC;QAAE,OAAO,EAAE,WAAW,CAAA;KAAE,CAAC;IAwBrF,OAAO,CAAC,IAAI;IAML,aAAa,IAAI,OAAO;IAWxB,cAAc,CAAC,KAAK,EAAE,YAAY;IA+BzC,OAAO,CAAC,YAAY;IA0CpB,OAAO,CAAC,iBAAiB;IAiBzB,OAAO,CAAC,sBAAsB;IAsC9B,OAAO,CAAC,mBAAmB;IAyD3B,OAAO,CAAC,qBAAqB;IAqD7B,OAAO,CAAC,qBAAqB;IAwC7B,OAAO,CAAC,cAAc;IAyBtB,OAAO,CAAC,kBAAkB;IAI1B,OAAO,CAAC,qBAAqB;IA6B7B,OAAO,CAAC,gBAAgB;IAkExB,OAAO,CAAC,UAAU;CAOnB"}
+{"version":3,"file":"NetworkedDOMWebsocketV02Adapter.d.ts","sourceRoot":"","sources":["../src/NetworkedDOMWebsocketV02Adapter.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAOhF,OAAO,EAAyB,4BAA4B,EAAE,MAAM,yBAAyB,CAAC;AAC9F,OAAO,EAAE,gCAAgC,EAAE,MAAM,oCAAoC,CAAC;AAetF,qBAAa,+BAAgC,SAAQ,gCAAgC;IACnF,OAAO,CAAC,eAAe,CAAgC;IACvD,OAAO,CAAC,yBAAyB,CAM7B;IACJ,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,aAAa,CAA2C;IAChE,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAwD;gBAGzF,SAAS,EAAE,SAAS,EACpB,aAAa,EAAE,YAAY,EAC3B,iBAAiB,EAAE,MAAM,IAAI,EAC7B,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,EACrC,OAAO,GAAE,4BAAiC,EAC1C,GAAG,CAAC,EAAE,gBAAgB;IAajB,WAAW,CAAC,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,WAAW;IAwB5D,OAAO,CAAC,IAAI;IAML,aAAa,IAAI,OAAO;IAQxB,cAAc,CAAC,KAAK,EAAE,YAAY;IA+BzC,OAAO,CAAC,YAAY;IA0CpB,OAAO,CAAC,iBAAiB;IAiBzB,OAAO,CAAC,sBAAsB;IAuC9B,OAAO,CAAC,mBAAmB;IAoD3B,OAAO,CAAC,qBAAqB;cAqDV,uBAAuB,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI;IAuBlE,OAAO,CAAC,cAAc;IAStB,OAAO,CAAC,kBAAkB;IAI1B,OAAO,CAAC,qBAAqB;IA6B7B,OAAO,CAAC,gBAAgB;IAuExB,OAAO,CAAC,UAAU;CAOnB"}

package/build/PortalUtils.d.ts

@@ -0,0 +1,31 @@
+import { IDocumentFactory, IElementLike, INodeLike } from "./DocumentInterface";
+/**
+ * Resolves the correct document factory for creating children of a given parent node.
+ *
+ * Resolution order:
+ * 1. If parent is a portal with its own factory, use that
+ * 2. If parent was created with an overridden factory (descendant of a portal), inherit it
+ * 3. Returns undefined if no override applies (caller should use default factory)
+ */
+export declare function resolveChildFactory(parentNode: INodeLike, elementFactoryOverride: Map<INodeLike, IDocumentFactory>): IDocumentFactory | undefined;
+/**
+ * After creating an element, checks if it is a portal that provides a different document factory.
+ * Returns the child factory and whether a portal factory is being used.
+ */
+export declare function resolvePortalChildFactory(element: IElementLike, currentFactory: IDocumentFactory): {
+    childFactory: IDocumentFactory;
+    usingPortalFactory: boolean;
+};
+/**
+ * Records a factory override for an element if it was created with a non-default factory.
+ */
+export declare function recordFactoryOverride(element: INodeLike, factory: IDocumentFactory, defaultFactory: IDocumentFactory, elementFactoryOverride: Map<INodeLike, IDocumentFactory>): void;
+/**
+ * Flushes pending portal children to their portal target elements.
+ */
+export declare function flushPendingPortalChildren(pendingPortalChildren: Map<IElementLike, INodeLike[]>): void;
+/**
+ * Buffers a child element for deferred attachment to a portal parent.
+ */
+export declare function bufferPortalChild(pendingPortalChildren: Map<IElementLike, INodeLike[]>, portalParent: IElementLike, child: INodeLike): void;
+//# sourceMappingURL=PortalUtils.d.ts.map

package/build/PortalUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PortalUtils.d.ts","sourceRoot":"","sources":["../src/PortalUtils.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,YAAY,EACZ,SAAS,EAIV,MAAM,qBAAqB,CAAC;AAG7B;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,SAAS,EACrB,sBAAsB,EAAE,GAAG,CAAC,SAAS,EAAE,gBAAgB,CAAC,GACvD,gBAAgB,GAAG,SAAS,CAQ9B;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,YAAY,EACrB,cAAc,EAAE,gBAAgB,GAC/B;IAAE,YAAY,EAAE,gBAAgB,CAAC;IAAC,kBAAkB,EAAE,OAAO,CAAA;CAAE,CAQjE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,SAAS,EAClB,OAAO,EAAE,gBAAgB,EACzB,cAAc,EAAE,gBAAgB,EAChC,sBAAsB,EAAE,GAAG,CAAC,SAAS,EAAE,gBAAgB,CAAC,GACvD,IAAI,CAIN;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,qBAAqB,EAAE,GAAG,CAAC,YAAY,EAAE,SAAS,EAAE,CAAC,GACpD,IAAI,CAQN;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,qBAAqB,EAAE,GAAG,CAAC,YAAY,EAAE,SAAS,EAAE,CAAC,EACrD,YAAY,EAAE,YAAY,EAC1B,KAAK,EAAE,SAAS,GACf,IAAI,CAIN"}

package/build/index.d.ts

@@ -1,3 +1,6 @@
+export * from "./DocumentInterface";
 export * from "./DOMSanitizer";
+export * from "./ElementUtils";
 export * from "./NetworkedDOMWebsocket";
+export * from "./PortalUtils";
 //# sourceMappingURL=index.d.ts.map

package/build/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,yBAAyB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,yBAAyB,CAAC;AACxC,cAAc,eAAe,CAAC"}