smart-lifecycle 0.1.1

package/dist/rendering/dom-context/dom-context.d.ts

@@ -0,0 +1,168 @@
+import type { Unsubscribe } from "../../reactive/signal.js";
+import { IDomContext, DomContentType } from "./dom-context.interface.js";
+/**
+ * Implements the responsibility of managing DOM representation and subscriptions.
+ * Separates component logic from DOM manipulation.
+ *
+ * @description
+ * Pure View utility that manages:
+ * - DOM root element reference
+ * - Teardown callback lifecycle (composite pattern)
+ * - Query operations on rendered DOM
+ * - Unique context identification
+ *
+ * Component-agnostic - does not hold component references.
+ *
+ * @example
+ * ```typescript
+ * const domContext = new DomContext(document.body);
+ * console.log(domContext.contextId); // 'dom-ctx-1'
+ * domContext.setElement(compiledElement);
+ * domContext.addSubscription(eventSub);
+ * const button = domContext.query('.btn');
+ * ```
+ */
+export declare class DomContext implements IDomContext {
+    private targetRoot;
+    private static contextCounter;
+    readonly contextId: string;
+    private htmlElement;
+    private subscriptions;
+    private isRendered;
+    private contentType;
+    /**
+     * Initializes a new instance of DomContext.
+     *
+     * @param targetRoot - The target root where DOM will be attached
+     * @throws Error if targetRoot is null or undefined
+     *
+     * @example
+     * ```typescript
+     * const domContext = new DomContext(document.body);
+     * const shadowContext = new DomContext(element.shadowRoot!);
+     * ```
+     */
+    constructor(targetRoot: HTMLElement | ShadowRoot);
+    /**
+     * Gets the root HTML element.
+     *
+     * @returns The root HTML element or null if not yet set
+     *
+     * @example
+     * ```typescript
+     * const element = domContext.getElement();
+     * ```
+     */
+    getElement(): HTMLElement | null;
+    /**
+     * Gets the target root for rendering.
+     *
+     * @returns The target root (HTMLElement or ShadowRoot)
+     *
+     * @example
+     * ```typescript
+     * const root = domContext.getTargetRoot();
+     * ```
+     */
+    getTargetRoot(): HTMLElement | ShadowRoot;
+    /**
+     * Sets the compiled HTML element as the root.
+     *
+     * @param element - The HTML element to set as root
+     * @param contentType - The type of content being set
+     * @throws Error if element or contentType are null/undefined
+     *
+     * @example
+     * ```typescript
+     * domContext.setElement(compiledElement, DomContentType.COMPONENT);
+     * ```
+     */
+    setElement(element: HTMLElement, contentType: DomContentType): void;
+    /**
+     * Checks if the DOM has been rendered.
+     *
+     * @returns true if rendered, false otherwise
+     *
+     * @example
+     * ```typescript
+     * if (domContext.getIsRendered()) {
+     *   console.log('DOM is ready');
+     * }
+     * ```
+     */
+    getIsRendered(): boolean;
+    /**
+     * Queries a single element using CSS selector.
+     *
+     * @param selector - CSS selector string
+     * @returns The first matching element or null
+     * @throws Error if selector is null or undefined
+     *
+     * @example
+     * ```typescript
+     * const button = domContext.query('.submit-btn');
+     * const input = domContext.query('#email-input');
+     * ```
+     */
+    query(selector: string): HTMLElement | null;
+    /**
+     * Queries all elements matching CSS selector.
+     *
+     * @param selector - CSS selector string
+     * @returns NodeList of matching elements or empty list
+     * @throws Error if selector is null or undefined
+     *
+     * @example
+     * ```typescript
+     * const buttons = domContext.queryAll('.action-btn');
+     * buttons.forEach(btn => console.log(btn));
+     * ```
+     */
+    queryAll(selector: string): NodeListOf<Element>;
+    /**
+     * Adds a teardown callback to be managed by the context.
+     *
+     * @param subscription - The unsubscribe function to add
+     * @throws Error if subscription is null or undefined
+     *
+     * @example
+     * ```typescript
+     * const unsub = () => element.removeEventListener('click', handler);
+     * domContext.addSubscription(unsub);
+     * ```
+     */
+    addSubscription(subscription: Unsubscribe): void;
+    /**
+     * Clears all callbacks without destroying the context.
+     * Useful for re-render scenarios.
+     *
+     * @example
+     * ```typescript
+     * domContext.clearSubscriptions();
+     * // Re-initialize listeners
+     * ```
+     */
+    clearSubscriptions(): void;
+    /**
+     * Sets the current content type being displayed.
+     *
+     * @param contentType - The content type to set
+     * @throws Error if contentType is null or undefined
+     *
+     * @example
+     * ```typescript
+     * domContext.setContentType(DomContentType.ERROR);
+     * ```
+     */
+    getContentType(): DomContentType;
+    /**
+     * Destroys the DOM context, cleaning up callbacks and removing elements.
+     *
+     * @example
+     * ```typescript
+     * domContext.destroy();
+     * ```
+     */
+    destroy(): void;
+}
+//# sourceMappingURL=dom-context.d.ts.map

package/dist/rendering/dom-context/dom-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dom-context.d.ts","sourceRoot":"","sources":["../../../src/rendering/dom-context/dom-context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAEzE;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,UAAW,YAAW,WAAW;IAqBhC,OAAO,CAAC,UAAU;IApB9B,OAAO,CAAC,MAAM,CAAC,cAAc,CAAK;IAElC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,OAAO,CAAC,WAAW,CAA4B;IAC/C,OAAO,CAAC,aAAa,CAAqB;IAC1C,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,WAAW,CAAuB;IAE1C;;;;;;;;;;;OAWG;gBACiB,UAAU,EAAE,WAAW,GAAG,UAAU;IAKxD;;;;;;;;;OASG;IACH,UAAU,IAAI,WAAW,GAAG,IAAI;IAIhC;;;;;;;;;OASG;IACH,aAAa,IAAI,WAAW,GAAG,UAAU;IAIzC;;;;;;;;;;;OAWG;IACH,UAAU,CAAC,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,cAAc,GAAG,IAAI;IAUnE;;;;;;;;;;;OAWG;IACH,aAAa,IAAI,OAAO;IAIxB;;;;;;;;;;;;OAYG;IACH,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI;IAM3C;;;;;;;;;;;;OAYG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,UAAU,CAAC,OAAO,CAAC;IAQ/C;;;;;;;;;;;OAWG;IACH,eAAe,CAAC,YAAY,EAAE,WAAW,GAAG,IAAI;IAKhD;;;;;;;;;OASG;IACH,kBAAkB,IAAI,IAAI;IAW1B;;;;;;;;;;OAUG;IACH,cAAc,IAAI,cAAc;IAIhC;;;;;;;OAOG;IACH,OAAO,IAAI,IAAI;CAWhB"}

package/dist/rendering/dom-context/dom-context.interface.d.ts

@@ -0,0 +1,156 @@
+import type { Unsubscribe } from "../../reactive/signal.js";
+/**
+ * Defines the types of content that can be rendered in the DOM context.
+ * This enumeration tracks the current state of content being displayed,
+ * allowing the rendering system to understand what type of content is currently active.
+ */
+export declare enum DomContentType {
+    /** No content is currently being displayed (initial state) */
+    NONE = "none",
+    /** Loading skeleton is being displayed while component initializes */
+    SKELETON = "skeleton",
+    /** Error overlay is being displayed when rendering fails */
+    ERROR = "error",
+    /** Component content is being displayed (fully rendered component) */
+    COMPONENT = "component"
+}
+/**
+ * Defines the responsibility of managing DOM representation and subscriptions.
+ *
+ * @description
+ * Pure View utility for DOM manipulation and subscription lifecycle management.
+ * Component-agnostic - does not hold component references.
+ * Each context has a unique identifier for tracking component instances.
+ *
+ * @example
+ * ```typescript
+ * const domContext: IDomContext = new DomContext(targetRoot);
+ * console.log(domContext.contextId); // 'dom-ctx-1'
+ * domContext.setElement(compiledElement);
+ * domContext.addSubscription(subscription);
+ * const button = domContext.query('.submit-btn');
+ * ```
+ */
+export interface IDomContext {
+    /**
+     * Unique context identifier.
+     * Used for tracking component instances across multiple contexts.
+     *
+     * @example
+     * ```typescript
+     * const id = domContext.contextId; // 'dom-ctx-123'
+     * ```
+     */
+    readonly contextId: string;
+    /**
+     * Gets the root HTML element.
+     *
+     * @returns The root HTML element or null if not yet set
+     *
+     * @example
+     * ```typescript
+     * const element = domContext.getElement();
+     * ```
+     */
+    getElement(): HTMLElement | null;
+    /**
+     * Gets the target root for rendering.
+     *
+     * @returns The target root (HTMLElement or ShadowRoot)
+     *
+     * @example
+     * ```typescript
+     * const root = domContext.getTargetRoot();
+     * ```
+     */
+    getTargetRoot(): HTMLElement | ShadowRoot;
+    /**
+     * Sets the compiled HTML element as the root.
+     *
+     * @param element - The HTML element to set as root
+     * @param contentType - The type of content being set
+     * @throws Error if element or contentType are null/undefined
+     *
+     * @example
+     * ```typescript
+     * domContext.setElement(compiledElement, DomContentType.COMPONENT);
+     * ```
+     */
+    setElement(element: HTMLElement, contentType: DomContentType): void;
+    /**
+     * Checks if the DOM has been rendered.
+     *
+     * @returns true if rendered, false otherwise
+     *
+     * @example
+     * ```typescript
+     * if (domContext.getIsRendered()) {
+     *   console.log('DOM is ready');
+     * }
+     * ```
+     */
+    getIsRendered(): boolean;
+    /**
+     * Adds a teardown callback to be managed and cleaned up on destroy.
+     *
+     * @param subscription - The unsubscribe function to add
+     * @throws Error if subscription is null or undefined
+     *
+     * @example
+     * ```typescript
+     * const sub = observable.subscribe(value => console.log(value));
+     * domContext.addSubscription(sub);
+     * ```
+     */
+    addSubscription(subscription: Unsubscribe): void;
+    /**
+     * Queries a single element using CSS selector within the root element.
+     *
+     * @param selector - CSS selector string
+     * @returns The first matching element or null
+     * @throws Error if selector is null or undefined
+     *
+     * @example
+     * ```typescript
+     * const button = domContext.query('.submit-btn');
+     * ```
+     */
+    query(selector: string): HTMLElement | null;
+    /**
+     * Clears all subscriptions without destroying the context.
+     * Useful for re-render scenarios.
+     *
+     * @example
+     * ```typescript
+     * domContext.clearSubscriptions();
+     * // Re-initialize listeners after clearing
+     * ```
+     */
+    clearSubscriptions(): void;
+    /**
+     * Sets the current content type being displayed.
+     *
+     * @param contentType - The content type to set
+     * @throws Error if contentType is null or undefined
+     *
+     * @example
+     * ```typescript
+     * domContext.setContentType(DomContentType.ERROR);
+     * ```
+     */
+    getContentType(): DomContentType;
+    /**
+     * Destroys the DOM context, cleaning up callbacks and removing elements.
+     *
+     * @description
+     * Calls all managed cleanup functions, removes the HTML element from DOM,
+     * and resets internal state.
+     *
+     * @example
+     * ```typescript
+     * domContext.destroy();
+     * ```
+     */
+    destroy(): void;
+}
+//# sourceMappingURL=dom-context.interface.d.ts.map

package/dist/rendering/dom-context/dom-context.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dom-context.interface.d.ts","sourceRoot":"","sources":["../../../src/rendering/dom-context/dom-context.interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D;;;;GAIG;AACH,oBAAY,cAAc;IACxB,8DAA8D;IAC9D,IAAI,SAAS;IACb,sEAAsE;IACtE,QAAQ,aAAa;IACrB,4DAA4D;IAC5D,KAAK,UAAU;IACf,sEAAsE;IACtE,SAAS,cAAc;CACxB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,WAAW;IAC1B;;;;;;;;OAQG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAE3B;;;;;;;;;OASG;IACH,UAAU,IAAI,WAAW,GAAG,IAAI,CAAC;IAEjC;;;;;;;;;OASG;IACH,aAAa,IAAI,WAAW,GAAG,UAAU,CAAC;IAE1C;;;;;;;;;;;OAWG;IACH,UAAU,CAAC,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,cAAc,GAAG,IAAI,CAAC;IAEpE;;;;;;;;;;;OAWG;IACH,aAAa,IAAI,OAAO,CAAC;IAEzB;;;;;;;;;;;OAWG;IACH,eAAe,CAAC,YAAY,EAAE,WAAW,GAAG,IAAI,CAAC;IAEjD;;;;;;;;;;;OAWG;IACH,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAAC;IAE5C;;;;;;;;;OASG;IACH,kBAAkB,IAAI,IAAI,CAAC;IAE3B;;;;;;;;;;OAUG;IACH,cAAc,IAAI,cAAc,CAAC;IAEjC;;;;;;;;;;;OAWG;IACH,OAAO,IAAI,IAAI,CAAC;CACjB"}

package/dist/rendering/dom-context/dom-context.interface.js

@@ -0,0 +1,17 @@
+/**
+ * Defines the types of content that can be rendered in the DOM context.
+ * This enumeration tracks the current state of content being displayed,
+ * allowing the rendering system to understand what type of content is currently active.
+ */
+export var DomContentType;
+(function (DomContentType) {
+    /** No content is currently being displayed (initial state) */
+    DomContentType["NONE"] = "none";
+    /** Loading skeleton is being displayed while component initializes */
+    DomContentType["SKELETON"] = "skeleton";
+    /** Error overlay is being displayed when rendering fails */
+    DomContentType["ERROR"] = "error";
+    /** Component content is being displayed (fully rendered component) */
+    DomContentType["COMPONENT"] = "component";
+})(DomContentType || (DomContentType = {}));
+//# sourceMappingURL=dom-context.interface.js.map

package/dist/rendering/dom-context/dom-context.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dom-context.interface.js","sourceRoot":"","sources":["../../../src/rendering/dom-context/dom-context.interface.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,CAAN,IAAY,cASX;AATD,WAAY,cAAc;IACxB,8DAA8D;IAC9D,+BAAa,CAAA;IACb,sEAAsE;IACtE,uCAAqB,CAAA;IACrB,4DAA4D;IAC5D,iCAAe,CAAA;IACf,sEAAsE;IACtE,yCAAuB,CAAA;AACzB,CAAC,EATW,cAAc,KAAd,cAAc,QASzB"}

package/dist/rendering/dom-context/dom-context.js

@@ -0,0 +1,225 @@
+import { DomContentType } from "./dom-context.interface.js";
+/**
+ * Implements the responsibility of managing DOM representation and subscriptions.
+ * Separates component logic from DOM manipulation.
+ *
+ * @description
+ * Pure View utility that manages:
+ * - DOM root element reference
+ * - Teardown callback lifecycle (composite pattern)
+ * - Query operations on rendered DOM
+ * - Unique context identification
+ *
+ * Component-agnostic - does not hold component references.
+ *
+ * @example
+ * ```typescript
+ * const domContext = new DomContext(document.body);
+ * console.log(domContext.contextId); // 'dom-ctx-1'
+ * domContext.setElement(compiledElement);
+ * domContext.addSubscription(eventSub);
+ * const button = domContext.query('.btn');
+ * ```
+ */
+export class DomContext {
+    targetRoot;
+    static contextCounter = 0;
+    contextId;
+    htmlElement = null;
+    subscriptions = [];
+    isRendered = false;
+    contentType = DomContentType.NONE;
+    /**
+     * Initializes a new instance of DomContext.
+     *
+     * @param targetRoot - The target root where DOM will be attached
+     * @throws Error if targetRoot is null or undefined
+     *
+     * @example
+     * ```typescript
+     * const domContext = new DomContext(document.body);
+     * const shadowContext = new DomContext(element.shadowRoot!);
+     * ```
+     */
+    constructor(targetRoot) {
+        this.targetRoot = targetRoot;
+        if (!targetRoot)
+            throw new Error("Target root is required");
+        this.contextId = `dom-ctx-${++DomContext.contextCounter}`;
+    }
+    /**
+     * Gets the root HTML element.
+     *
+     * @returns The root HTML element or null if not yet set
+     *
+     * @example
+     * ```typescript
+     * const element = domContext.getElement();
+     * ```
+     */
+    getElement() {
+        return this.htmlElement;
+    }
+    /**
+     * Gets the target root for rendering.
+     *
+     * @returns The target root (HTMLElement or ShadowRoot)
+     *
+     * @example
+     * ```typescript
+     * const root = domContext.getTargetRoot();
+     * ```
+     */
+    getTargetRoot() {
+        return this.targetRoot;
+    }
+    /**
+     * Sets the compiled HTML element as the root.
+     *
+     * @param element - The HTML element to set as root
+     * @param contentType - The type of content being set
+     * @throws Error if element or contentType are null/undefined
+     *
+     * @example
+     * ```typescript
+     * domContext.setElement(compiledElement, DomContentType.COMPONENT);
+     * ```
+     */
+    setElement(element, contentType) {
+        if (!element)
+            throw new Error("Element is required");
+        if (!contentType)
+            throw new Error("Content type is required");
+        this.targetRoot.innerHTML = "";
+        this.targetRoot.appendChild(element);
+        this.htmlElement = element;
+        this.isRendered = true;
+        this.contentType = contentType;
+    }
+    /**
+     * Checks if the DOM has been rendered.
+     *
+     * @returns true if rendered, false otherwise
+     *
+     * @example
+     * ```typescript
+     * if (domContext.getIsRendered()) {
+     *   console.log('DOM is ready');
+     * }
+     * ```
+     */
+    getIsRendered() {
+        return this.isRendered;
+    }
+    /**
+     * Queries a single element using CSS selector.
+     *
+     * @param selector - CSS selector string
+     * @returns The first matching element or null
+     * @throws Error if selector is null or undefined
+     *
+     * @example
+     * ```typescript
+     * const button = domContext.query('.submit-btn');
+     * const input = domContext.query('#email-input');
+     * ```
+     */
+    query(selector) {
+        if (!selector)
+            throw new Error("Selector is required");
+        if (!this.htmlElement)
+            return null;
+        return this.htmlElement.querySelector(selector);
+    }
+    /**
+     * Queries all elements matching CSS selector.
+     *
+     * @param selector - CSS selector string
+     * @returns NodeList of matching elements or empty list
+     * @throws Error if selector is null or undefined
+     *
+     * @example
+     * ```typescript
+     * const buttons = domContext.queryAll('.action-btn');
+     * buttons.forEach(btn => console.log(btn));
+     * ```
+     */
+    queryAll(selector) {
+        if (!selector)
+            throw new Error("Selector is required");
+        if (!this.htmlElement) {
+            return document.querySelectorAll(":empty");
+        }
+        return this.htmlElement.querySelectorAll(selector);
+    }
+    /**
+     * Adds a teardown callback to be managed by the context.
+     *
+     * @param subscription - The unsubscribe function to add
+     * @throws Error if subscription is null or undefined
+     *
+     * @example
+     * ```typescript
+     * const unsub = () => element.removeEventListener('click', handler);
+     * domContext.addSubscription(unsub);
+     * ```
+     */
+    addSubscription(subscription) {
+        if (!subscription)
+            throw new Error("Subscription is required");
+        this.subscriptions.push(subscription);
+    }
+    /**
+     * Clears all callbacks without destroying the context.
+     * Useful for re-render scenarios.
+     *
+     * @example
+     * ```typescript
+     * domContext.clearSubscriptions();
+     * // Re-initialize listeners
+     * ```
+     */
+    clearSubscriptions() {
+        this.subscriptions.forEach((fn) => {
+            try {
+                fn();
+            }
+            catch {
+                /* no-op */
+            }
+        });
+        this.subscriptions = [];
+    }
+    /**
+     * Sets the current content type being displayed.
+     *
+     * @param contentType - The content type to set
+     * @throws Error if contentType is null or undefined
+     *
+     * @example
+     * ```typescript
+     * domContext.setContentType(DomContentType.ERROR);
+     * ```
+     */
+    getContentType() {
+        return this.contentType;
+    }
+    /**
+     * Destroys the DOM context, cleaning up callbacks and removing elements.
+     *
+     * @example
+     * ```typescript
+     * domContext.destroy();
+     * ```
+     */
+    destroy() {
+        this.clearSubscriptions();
+        if (this.htmlElement) {
+            this.htmlElement.remove();
+            this.htmlElement = null;
+        }
+        this.isRendered = false;
+        this.contentType = DomContentType.NONE;
+    }
+}
+//# sourceMappingURL=dom-context.js.map

package/dist/rendering/dom-context/dom-context.js.map

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

package/dist/rendering/dom-context/host-resolver.interface.d.ts

@@ -0,0 +1,47 @@
+import type { IDomContext } from "../dom-context/dom-context.interface.js";
+/**
+ * Defines the responsibility of resolving host elements for components.
+ *
+ * @description
+ * Abstracts the mechanism for locating the DOM host element associated
+ * with a component instance or DOM context. Enables lifecycle managers
+ * to access the host without direct coupling to DomContext.
+ *
+ * @example
+ * ```typescript
+ * const resolver: IHostResolver = new DomContextHostResolver();
+ * resolver.register(component, domContext);
+ *
+ * const host = resolver.resolve(component);
+ * host.appendChild(element);
+ * ```
+ */
+export interface IHostResolver {
+    /**
+     * Registers a component with its associated DOM context.
+     *
+     * @param component - Component instance
+     * @param domContext - Associated DOM context
+     */
+    register(component: object, domContext: IDomContext): void;
+    /**
+     * Resolves the host element for a component instance.
+     *
+     * @param component - Component instance
+     * @returns The host HTMLElement
+     * @throws Error if component is not registered
+     */
+    resolve(component: object): HTMLElement;
+    /**
+     * Unregisters a component from the resolver.
+     *
+     * @param component - Component instance to unregister
+     */
+    unregister(component: object): void;
+    /**
+     * Clears all registered components.
+     * Used for testing to ensure test isolation.
+     */
+    clear(): void;
+}
+//# sourceMappingURL=host-resolver.interface.d.ts.map

package/dist/rendering/dom-context/host-resolver.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-resolver.interface.d.ts","sourceRoot":"","sources":["../../../src/rendering/dom-context/host-resolver.interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yCAAyC,CAAC;AAE3E;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,aAAa;IAC5B;;;;;OAKG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,WAAW,GAAG,IAAI,CAAC;IAE3D;;;;;;OAMG;IACH,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,WAAW,CAAC;IAExC;;;;OAIG;IACH,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAEpC;;;OAGG;IACH,KAAK,IAAI,IAAI,CAAC;CACf"}

package/dist/rendering/dom-context/host-resolver.interface.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=host-resolver.interface.js.map

package/dist/rendering/dom-context/host-resolver.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-resolver.interface.js","sourceRoot":"","sources":["../../../src/rendering/dom-context/host-resolver.interface.ts"],"names":[],"mappings":""}

package/dist/rendering/dom-context/index.d.ts

@@ -0,0 +1,5 @@
+export { DomContext } from './dom-context.js';
+export type { IDomContext, DomContentType } from './dom-context.interface.js';
+export { DomContextFactory } from './dom-context-factory.js';
+export type { IDomContextFactory } from './dom-context-factory.interface.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/rendering/dom-context/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/rendering/dom-context/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC9E,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,YAAY,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC"}

package/dist/rendering/dom-context/index.js

@@ -0,0 +1,4 @@
+// DOM Context exports
+export { DomContext } from './dom-context.js';
+export { DomContextFactory } from './dom-context-factory.js';
+//# sourceMappingURL=index.js.map

package/dist/rendering/dom-context/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/rendering/dom-context/index.ts"],"names":[],"mappings":"AAAA,sBAAsB;AACtB,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC"}