smart-lifecycle 0.1.1

package/dist/rendering/expression-parser/types.d.ts

@@ -0,0 +1,234 @@
+/**
+ * Defines the token types used in expression parsing.
+ * Each token type represents a distinct lexical element in the expression language.
+ */
+export declare enum TokenType {
+    IDENTIFIER = "IDENTIFIER",
+    NUMBER = "NUMBER",
+    STRING = "STRING",
+    DOT = "DOT",
+    LPAREN = "LPAREN",
+    RPAREN = "RPAREN",
+    COMMA = "COMMA",
+    PLUS = "PLUS",
+    MINUS = "MINUS",
+    MULTIPLY = "MULTIPLY",
+    DIVIDE = "DIVIDE",
+    MODULO = "MODULO",
+    NOT = "NOT",
+    EQUAL = "EQUAL",
+    NOT_EQUAL = "NOT_EQUAL",
+    GT = "GT",
+    LT = "LT",
+    GTE = "GTE",
+    LTE = "LTE",
+    AND = "AND",
+    OR = "OR",
+    OPTIONAL_CHAIN = "OPTIONAL_CHAIN",
+    QUESTION = "QUESTION",
+    COLON = "COLON",
+    EOF = "EOF"
+}
+/**
+ * Defines the structure of a lexical token produced by the tokenizer.
+ * Tokens represent the smallest meaningful units of the expression language.
+ *
+ * @example
+ * ```typescript
+ * const token: Token = {
+ *   type: TokenType.IDENTIFIER,
+ *   value: 'myVar',
+ *   position: 0
+ * };
+ * ```
+ */
+export interface Token {
+    /** The type of token this represents */
+    type: TokenType;
+    /** The raw string value of the token */
+    value: string;
+    /** The position in the original expression where this token starts */
+    position: number;
+}
+/**
+ * Defines the union type for all possible AST node types.
+ * This represents the complete set of nodes that can appear in a parsed expression tree.
+ */
+export type ASTNode = LiteralNode | IdentifierNode | MemberExpressionNode | CallExpressionNode | BinaryExpressionNode | UnaryExpressionNode | ConditionalExpressionNode;
+/**
+ * Defines the structure of a literal AST node.
+ * Literal nodes represent primitive values like strings, numbers, or booleans.
+ *
+ * @example
+ * ```typescript
+ * const literal: LiteralNode = {
+ *   type: 'Literal',
+ *   value: 42
+ * };
+ * ```
+ */
+export interface LiteralNode {
+    /** Discriminant for type narrowing */
+    type: "Literal";
+    /** The primitive value of this literal */
+    value: string | number | boolean | null;
+}
+/**
+ * Defines the structure of an identifier AST node.
+ * Identifier nodes represent variable or property names in expressions.
+ *
+ * @example
+ * ```typescript
+ * const identifier: IdentifierNode = {
+ *   type: 'Identifier',
+ *   name: 'myVar'
+ * };
+ * ```
+ */
+export interface IdentifierNode {
+    /** Discriminant for type narrowing */
+    type: "Identifier";
+    /** The name of the identifier */
+    name: string;
+}
+/**
+ * Defines the structure of a member expression AST node.
+ * Member expressions represent property access on objects (e.g., obj.prop).
+ *
+ * @example
+ * ```typescript
+ * const member: MemberExpressionNode = {
+ *   type: 'MemberExpression',
+ *   object: { type: 'Identifier', name: 'obj' },
+ *   property: { type: 'Identifier', name: 'prop' },
+ *   optional: false
+ * };
+ * ```
+ */
+export interface MemberExpressionNode {
+    /** Discriminant for type narrowing */
+    type: "MemberExpression";
+    /** The object being accessed */
+    object: ASTNode;
+    /** The property being accessed */
+    property: IdentifierNode;
+    /** Indicates whether this uses the ?. chaining operator */
+    optional: boolean;
+}
+/**
+ * Defines the structure of a call expression AST node.
+ * Call expressions represent method or function invocations.
+ *
+ * @example
+ * ```typescript
+ * const call: CallExpressionNode = {
+ *   type: 'CallExpression',
+ *   callee: {
+ *     type: 'MemberExpression',
+ *     object: { type: 'Identifier', name: 'obj' },
+ *     property: { type: 'Identifier', name: 'method' },
+ *     optional: false
+ *   },
+ *   arguments: [{ type: 'Literal', value: 'arg' }]
+ * };
+ * ```
+ */
+export interface CallExpressionNode {
+    /** Discriminant for type narrowing */
+    type: "CallExpression";
+    /** The expression being called (must be a member expression) */
+    callee: MemberExpressionNode;
+    /** The arguments passed to the call */
+    arguments: ASTNode[];
+}
+/**
+ * Defines the structure of a binary expression AST node.
+ * Binary expressions represent operations between two operands.
+ *
+ * @example
+ * ```typescript
+ * const binary: BinaryExpressionNode = {
+ *   type: 'BinaryExpression',
+ *   operator: '+',
+ *   left: { type: 'Literal', value: 1 },
+ *   right: { type: 'Literal', value: 2 }
+ * };
+ * ```
+ */
+export interface BinaryExpressionNode {
+    /** Discriminant for type narrowing */
+    type: "BinaryExpression";
+    /** The operator being applied */
+    operator: string;
+    /** The left operand */
+    left: ASTNode;
+    /** The right operand */
+    right: ASTNode;
+}
+/**
+ * Defines the structure of a unary expression AST node.
+ * Unary expressions represent operations on a single operand.
+ *
+ * @example
+ * ```typescript
+ * const unary: UnaryExpressionNode = {
+ *   type: 'UnaryExpression',
+ *   operator: '!',
+ *   argument: { type: 'Literal', value: true }
+ * };
+ * ```
+ */
+export interface UnaryExpressionNode {
+    /** Discriminant for type narrowing */
+    type: "UnaryExpression";
+    /** The operator being applied */
+    operator: string;
+    /** The operand */
+    argument: ASTNode;
+}
+/**
+ * Defines the structure of a conditional expression AST node.
+ * Conditional expressions represent ternary operations (condition ? consequent : alternate).
+ *
+ * @example
+ * ```typescript
+ * const conditional: ConditionalExpressionNode = {
+ *   type: 'ConditionalExpression',
+ *   test: { type: 'Literal', value: true },
+ *   consequent: { type: 'Literal', value: 'yes' },
+ *   alternate: { type: 'Literal', value: 'no' }
+ * };
+ * ```
+ */
+export interface ConditionalExpressionNode {
+    /** Discriminant for type narrowing */
+    type: "ConditionalExpression";
+    /** The condition to test */
+    test: ASTNode;
+    /** The expression to evaluate if condition is truthy */
+    consequent: ASTNode;
+    /** The expression to evaluate if condition is falsy */
+    alternate: ASTNode;
+}
+/**
+ * Defines the structure of a parsed expression result.
+ * Contains the AST, extracted dependencies, and original expression for caching purposes.
+ *
+ * @example
+ * ```typescript
+ * const parsed: ParsedExpression = {
+ *   ast: { type: 'Literal', value: 42 },
+ *   dependencies: [],
+ *   originalExpression: '42'
+ * };
+ * ```
+ */
+export interface ParsedExpression {
+    /** The root AST node of the parsed expression */
+    ast: ASTNode;
+    /** Array of dependency names extracted from the expression */
+    dependencies: string[];
+    /** The original expression string that was parsed */
+    originalExpression: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/rendering/expression-parser/types.d.ts.map

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

package/dist/rendering/expression-parser/types.js

@@ -0,0 +1,33 @@
+/**
+ * Defines the token types used in expression parsing.
+ * Each token type represents a distinct lexical element in the expression language.
+ */
+export var TokenType;
+(function (TokenType) {
+    TokenType["IDENTIFIER"] = "IDENTIFIER";
+    TokenType["NUMBER"] = "NUMBER";
+    TokenType["STRING"] = "STRING";
+    TokenType["DOT"] = "DOT";
+    TokenType["LPAREN"] = "LPAREN";
+    TokenType["RPAREN"] = "RPAREN";
+    TokenType["COMMA"] = "COMMA";
+    TokenType["PLUS"] = "PLUS";
+    TokenType["MINUS"] = "MINUS";
+    TokenType["MULTIPLY"] = "MULTIPLY";
+    TokenType["DIVIDE"] = "DIVIDE";
+    TokenType["MODULO"] = "MODULO";
+    TokenType["NOT"] = "NOT";
+    TokenType["EQUAL"] = "EQUAL";
+    TokenType["NOT_EQUAL"] = "NOT_EQUAL";
+    TokenType["GT"] = "GT";
+    TokenType["LT"] = "LT";
+    TokenType["GTE"] = "GTE";
+    TokenType["LTE"] = "LTE";
+    TokenType["AND"] = "AND";
+    TokenType["OR"] = "OR";
+    TokenType["OPTIONAL_CHAIN"] = "OPTIONAL_CHAIN";
+    TokenType["QUESTION"] = "QUESTION";
+    TokenType["COLON"] = "COLON";
+    TokenType["EOF"] = "EOF";
+})(TokenType || (TokenType = {}));
+//# sourceMappingURL=types.js.map

package/dist/rendering/expression-parser/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/rendering/expression-parser/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAN,IAAY,SA0BX;AA1BD,WAAY,SAAS;IACnB,sCAAyB,CAAA;IACzB,8BAAiB,CAAA;IACjB,8BAAiB,CAAA;IACjB,wBAAW,CAAA;IACX,8BAAiB,CAAA;IACjB,8BAAiB,CAAA;IACjB,4BAAe,CAAA;IACf,0BAAa,CAAA;IACb,4BAAe,CAAA;IACf,kCAAqB,CAAA;IACrB,8BAAiB,CAAA;IACjB,8BAAiB,CAAA;IACjB,wBAAW,CAAA;IACX,4BAAe,CAAA;IACf,oCAAuB,CAAA;IACvB,sBAAS,CAAA;IACT,sBAAS,CAAA;IACT,wBAAW,CAAA;IACX,wBAAW,CAAA;IACX,wBAAW,CAAA;IACX,sBAAS,CAAA;IACT,8CAAiC,CAAA;IACjC,kCAAqB,CAAA;IACrB,4BAAe,CAAA;IACf,wBAAW,CAAA;AACb,CAAC,EA1BW,SAAS,KAAT,SAAS,QA0BpB"}

package/dist/rendering/host-projection/host-projection-registry.interface.d.ts

@@ -0,0 +1,54 @@
+import type { SmartComponent } from '../../core/smart-component.js';
+/**
+ * Defines the responsibility of managing host projection content for component instances.
+ */
+export interface IHostProjectionRegistry {
+    /**
+     * Associates host projection content with a component instance.
+     *
+     * @param component - Component instance to store content for
+     * @param content - HTML string representing host projection content
+     * @throws Error if component is null or undefined
+     */
+    set(component: SmartComponent, content: string): void;
+    /**
+     * Retrieves host projection content for a component instance.
+     *
+     * @param component - Component instance to retrieve content for
+     * @returns Host projection content HTML string, or undefined if not set
+     * @throws Error if component is null or undefined
+     */
+    get(component: SmartComponent): string | undefined;
+    /**
+     * Checks if host projection content exists for a component instance.
+     *
+     * @param component - Component instance to check
+     * @returns true if host projection content is stored, false otherwise
+     * @throws Error if component is null or undefined
+     */
+    has(component: SmartComponent): boolean;
+    /**
+     * Removes host projection content for a component instance.
+     *
+     * @param component - Component instance to clear content for
+     * @throws Error if component is null or undefined
+     */
+    clear(component: SmartComponent): void;
+    /**
+     * Stores the live child Element references captured before rendering.
+     *
+     * @param component - Component instance
+     * @param nodes - Array of child Element nodes to preserve
+     * @throws Error if component is null or undefined
+     */
+    setNodes(component: SmartComponent, nodes: Element[]): void;
+    /**
+     * Retrieves the live child Element references stored before rendering.
+     *
+     * @param component - Component instance
+     * @returns Stored Element array, or undefined if not set
+     * @throws Error if component is null or undefined
+     */
+    getNodes(component: SmartComponent): Element[] | undefined;
+}
+//# sourceMappingURL=host-projection-registry.interface.d.ts.map

package/dist/rendering/host-projection/host-projection-registry.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-projection-registry.interface.d.ts","sourceRoot":"","sources":["../../../src/rendering/host-projection/host-projection-registry.interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAEpE;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC;;;;;;OAMG;IACH,GAAG,CAAC,SAAS,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAEtD;;;;;;OAMG;IACH,GAAG,CAAC,SAAS,EAAE,cAAc,GAAG,MAAM,GAAG,SAAS,CAAC;IAEnD;;;;;;OAMG;IACH,GAAG,CAAC,SAAS,EAAE,cAAc,GAAG,OAAO,CAAC;IAExC;;;;;OAKG;IACH,KAAK,CAAC,SAAS,EAAE,cAAc,GAAG,IAAI,CAAC;IAEvC;;;;;;OAMG;IACH,QAAQ,CAAC,SAAS,EAAE,cAAc,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAE5D;;;;;;OAMG;IACH,QAAQ,CAAC,SAAS,EAAE,cAAc,GAAG,OAAO,EAAE,GAAG,SAAS,CAAC;CAC5D"}

package/dist/rendering/host-projection/host-projection-registry.interface.js

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

package/dist/rendering/host-projection/host-projection-registry.interface.js.map

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

package/dist/rendering/host-projection/host-projection.registry.d.ts

@@ -0,0 +1,67 @@
+import { SmartComponent } from '../../core/smart-component.js';
+import type { IHostProjectionRegistry } from './host-projection-registry.interface.js';
+/**
+ * Implements the responsibility of managing host projection content for component instances.
+ *
+ * Uses WeakMap for automatic memory cleanup when component instances are garbage collected.
+ *
+ * @example
+ * ```typescript
+ * const registry = new HostProjectionRegistry();
+ * registry.set(component, '<div>Host content</div>');
+ * const content = registry.get(component);
+ * registry.clear(component);
+ * ```
+ */
+export declare class HostProjectionRegistry implements IHostProjectionRegistry {
+    private readonly registry;
+    private readonly nodeRegistry;
+    /**
+     * Associates host projection content with a component instance.
+     *
+     * @param component - Component instance to store content for
+     * @param content - HTML string representing host projection content
+     * @throws Error if component is null or undefined
+     */
+    set(component: SmartComponent, content: string): void;
+    /**
+     * Retrieves host projection content for a component instance.
+     *
+     * @param component - Component instance to retrieve content for
+     * @returns Host projection content HTML string, or undefined if not set
+     * @throws Error if component is null or undefined
+     */
+    get(component: SmartComponent): string | undefined;
+    /**
+     * Checks if host projection content exists for a component instance.
+     *
+     * @param component - Component instance to check
+     * @returns true if host projection content is stored, false otherwise
+     * @throws Error if component is null or undefined
+     */
+    has(component: SmartComponent): boolean;
+    /**
+     * Removes host projection content for a component instance.
+     *
+     * @param component - Component instance to clear content for
+     * @throws Error if component is null or undefined
+     */
+    clear(component: SmartComponent): void;
+    /**
+     * Stores the live child Element references captured before rendering clears the host's innerHTML.
+     *
+     * @param component - Component instance
+     * @param nodes - Array of child Element nodes to preserve
+     * @throws Error if component is null or undefined
+     */
+    setNodes(component: SmartComponent, nodes: Element[]): void;
+    /**
+     * Retrieves the live child Element references stored before rendering.
+     *
+     * @param component - Component instance
+     * @returns Stored Element array, or undefined if not set
+     * @throws Error if component is null or undefined
+     */
+    getNodes(component: SmartComponent): Element[] | undefined;
+}
+//# sourceMappingURL=host-projection.registry.d.ts.map

package/dist/rendering/host-projection/host-projection.registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-projection.registry.d.ts","sourceRoot":"","sources":["../../../src/rendering/host-projection/host-projection.registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,yCAAyC,CAAC;AAEvF;;;;;;;;;;;;GAYG;AACH,qBAAa,sBAAuB,YAAW,uBAAuB;IACpE,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAyC;IAClE,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA4C;IAEzE;;;;;;OAMG;IACH,GAAG,CAAC,SAAS,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAOrD;;;;;;OAMG;IACH,GAAG,CAAC,SAAS,EAAE,cAAc,GAAG,MAAM,GAAG,SAAS;IAOlD;;;;;;OAMG;IACH,GAAG,CAAC,SAAS,EAAE,cAAc,GAAG,OAAO;IAOvC;;;;;OAKG;IACH,KAAK,CAAC,SAAS,EAAE,cAAc,GAAG,IAAI;IAQtC;;;;;;OAMG;IACH,QAAQ,CAAC,SAAS,EAAE,cAAc,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,IAAI;IAO3D;;;;;;OAMG;IACH,QAAQ,CAAC,SAAS,EAAE,cAAc,GAAG,OAAO,EAAE,GAAG,SAAS;CAM3D"}

package/dist/rendering/host-projection/host-projection.registry.js

@@ -0,0 +1,96 @@
+/**
+ * Implements the responsibility of managing host projection content for component instances.
+ *
+ * Uses WeakMap for automatic memory cleanup when component instances are garbage collected.
+ *
+ * @example
+ * ```typescript
+ * const registry = new HostProjectionRegistry();
+ * registry.set(component, '<div>Host content</div>');
+ * const content = registry.get(component);
+ * registry.clear(component);
+ * ```
+ */
+export class HostProjectionRegistry {
+    registry = new WeakMap();
+    nodeRegistry = new WeakMap();
+    /**
+     * Associates host projection content with a component instance.
+     *
+     * @param component - Component instance to store content for
+     * @param content - HTML string representing host projection content
+     * @throws Error if component is null or undefined
+     */
+    set(component, content) {
+        if (!component) {
+            throw new Error('Component is required');
+        }
+        this.registry.set(component, content);
+    }
+    /**
+     * Retrieves host projection content for a component instance.
+     *
+     * @param component - Component instance to retrieve content for
+     * @returns Host projection content HTML string, or undefined if not set
+     * @throws Error if component is null or undefined
+     */
+    get(component) {
+        if (!component) {
+            throw new Error('Component is required');
+        }
+        return this.registry.get(component);
+    }
+    /**
+     * Checks if host projection content exists for a component instance.
+     *
+     * @param component - Component instance to check
+     * @returns true if host projection content is stored, false otherwise
+     * @throws Error if component is null or undefined
+     */
+    has(component) {
+        if (!component) {
+            throw new Error('Component is required');
+        }
+        return this.registry.has(component);
+    }
+    /**
+     * Removes host projection content for a component instance.
+     *
+     * @param component - Component instance to clear content for
+     * @throws Error if component is null or undefined
+     */
+    clear(component) {
+        if (!component) {
+            throw new Error('Component is required');
+        }
+        this.registry.delete(component);
+        this.nodeRegistry.delete(component);
+    }
+    /**
+     * Stores the live child Element references captured before rendering clears the host's innerHTML.
+     *
+     * @param component - Component instance
+     * @param nodes - Array of child Element nodes to preserve
+     * @throws Error if component is null or undefined
+     */
+    setNodes(component, nodes) {
+        if (!component) {
+            throw new Error('Component is required');
+        }
+        this.nodeRegistry.set(component, nodes);
+    }
+    /**
+     * Retrieves the live child Element references stored before rendering.
+     *
+     * @param component - Component instance
+     * @returns Stored Element array, or undefined if not set
+     * @throws Error if component is null or undefined
+     */
+    getNodes(component) {
+        if (!component) {
+            throw new Error('Component is required');
+        }
+        return this.nodeRegistry.get(component);
+    }
+}
+//# sourceMappingURL=host-projection.registry.js.map

package/dist/rendering/host-projection/host-projection.registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-projection.registry.js","sourceRoot":"","sources":["../../../src/rendering/host-projection/host-projection.registry.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,sBAAsB;IAChB,QAAQ,GAAG,IAAI,OAAO,EAA0B,CAAC;IACjD,YAAY,GAAG,IAAI,OAAO,EAA6B,CAAC;IAEzE;;;;;;OAMG;IACH,GAAG,CAAC,SAAyB,EAAE,OAAe;QAC5C,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;QAC3C,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IACxC,CAAC;IAED;;;;;;OAMG;IACH,GAAG,CAAC,SAAyB;QAC3B,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;QAC3C,CAAC;QACD,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACtC,CAAC;IAED;;;;;;OAMG;IACH,GAAG,CAAC,SAAyB;QAC3B,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;QAC3C,CAAC;QACD,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACtC,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,SAAyB;QAC7B,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;QAC3C,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAChC,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACtC,CAAC;IAED;;;;;;OAMG;IACH,QAAQ,CAAC,SAAyB,EAAE,KAAgB;QAClD,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;QAC3C,CAAC;QACD,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;IAC1C,CAAC;IAED;;;;;;OAMG;IACH,QAAQ,CAAC,SAAyB;QAChC,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;QAC3C,CAAC;QACD,OAAO,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IAC1C,CAAC;CACF"}

package/dist/rendering/host-projection/index.d.ts

@@ -0,0 +1,3 @@
+export { HostProjectionRegistry } from './host-projection.registry.js';
+export type { IHostProjectionRegistry } from './host-projection-registry.interface.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/rendering/host-projection/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/rendering/host-projection/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AACvE,YAAY,EAAE,uBAAuB,EAAE,MAAM,yCAAyC,CAAC"}

package/dist/rendering/host-projection/index.js

@@ -0,0 +1,2 @@
+export { HostProjectionRegistry } from './host-projection.registry.js';
+//# sourceMappingURL=index.js.map

package/dist/rendering/host-projection/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/rendering/host-projection/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC"}

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

@@ -0,0 +1,55 @@
+import type { IDomContext } from '../dom-context/dom-context.interface.js';
+import type { IHostResolver } from './host-resolver.interface.js';
+/**
+ * Implements the responsibility of resolving host elements via DomContext.
+ *
+ * @description
+ * Maps component instances to their DomContext and resolves the host element
+ * by calling domContext.getElement(). Uses WeakMap for automatic cleanup.
+ *
+ * @example
+ * ```typescript
+ * const resolver = new DomContextHostResolver();
+ *
+ * // Register during render
+ * resolver.register(component, domContext);
+ *
+ * // Resolve in lifecycle manager
+ * const host = resolver.resolve(component);
+ * host.innerHTML = '';
+ *
+ * // Cleanup
+ * resolver.unregister(component);
+ * ```
+ */
+export declare class DomContextHostResolver implements IHostResolver {
+    private contextMap;
+    /**
+     * Registers a component with its DOM context.
+     *
+     * @param component - Component instance
+     * @param domContext - Associated DOM context
+     * @throws Error if component or domContext is null/undefined
+     */
+    register(component: object, domContext: IDomContext): void;
+    /**
+     * Resolves the host element for a component.
+     *
+     * @param component - Component instance
+     * @returns The host HTMLElement from associated DomContext
+     * @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.
+     * Primarily for testing to ensure test isolation.
+     */
+    clear(): void;
+}
+//# sourceMappingURL=dom-context-host-resolver.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dom-context-host-resolver.d.ts","sourceRoot":"","sources":["../../../src/rendering/host-resolver/dom-context-host-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yCAAyC,CAAC;AAC3E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAElE;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,sBAAuB,YAAW,aAAa;IAC1D,OAAO,CAAC,UAAU,CAAsC;IAExD;;;;;;OAMG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,WAAW,GAAG,IAAI;IAU1D;;;;;;OAMG;IACH,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,WAAW;IA2BvC;;;;OAIG;IACH,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAOnC;;;OAGG;IACH,KAAK,IAAI,IAAI;CAId"}