smart-lifecycle 0.1.1

package/dist/components/smart-select/smart-select.lifecycle-manager.js

@@ -0,0 +1,144 @@
+/**
+ * Implements the responsibility of managing smart-select lifecycle and conditional branch rendering.
+ */
+import { SmartLifecycleManager } from '../../behaviors/lifecycle-manager.base.js';
+/**
+ * Implements the responsibility of managing smart-select lifecycle with multi-branch conditional rendering.
+ *
+ * @description
+ * Architecture note: smart-select is transparent to the parent binding resolver (no hostDisplay),
+ * so the parent component sets up reactive bindings on the ORIGINAL <on>/<otherwise> elements
+ * before smart-select's connectedCallback captures them via HostProjectionRegistry.setNodes().
+ *
+ * The template compiler's host projection then creates CLONES from the HTML string for the compiled
+ * template DOM. These clones have resolved (static) attribute values — no reactive bindings.
+ *
+ * This lifecycle manager:
+ * 1. Removes the static CLONES from the rendered host DOM (they would show all branches)
+ * 2. Reads the ORIGINAL elements from HostProjectionRegistry (which carry live parent-scope bindings)
+ * 3. Observes attribute changes on the originals via MutationObserver
+ * 4. Inserts the originals' childNodes (which also have parent-scope text bindings) into the host
+ */
+export class SmartSelectLifecycleManager extends SmartLifecycleManager {
+    hostResolver;
+    hostProjectionRegistry;
+    branches = [];
+    placeholder = null;
+    observer = null;
+    activeBranch = null;
+    /**
+     * Initializes a new instance of SmartSelectLifecycleManager.
+     *
+     * @param hostResolver - Resolver for obtaining host elements
+     * @param hostProjectionRegistry - Registry for host projection content
+     * @throws Error if hostResolver is null or undefined
+     * @throws Error if hostProjectionRegistry is null or undefined
+     */
+    constructor(hostResolver, hostProjectionRegistry) {
+        super();
+        this.hostResolver = hostResolver;
+        this.hostProjectionRegistry = hostProjectionRegistry;
+        if (!hostResolver) {
+            throw new Error('Host resolver is required');
+        }
+        if (!hostProjectionRegistry) {
+            throw new Error('Host projection registry is required');
+        }
+    }
+    onComponentReady(component) {
+        const host = this.hostResolver.resolve(component);
+        host.style.display = 'contents';
+        // Remove the entire compiled template DOM (the <div> wrapper with static clones).
+        // Smart-select's template is just <smart-host></smart-host>, so processHostProjection
+        // wraps the cloned children in a <div>. We discard it entirely because the lifecycle
+        // manager inserts original (reactively-bound) content directly into the host.
+        host.innerHTML = '';
+        // Use ORIGINAL elements from registry — these carry live parent-scope bindings
+        const originalElements = this.hostProjectionRegistry.getNodes(component) ?? [];
+        this.branches = [];
+        for (const el of originalElements) {
+            const tagName = el.tagName.toLowerCase();
+            if (tagName === 'on') {
+                this.branches.push({
+                    conditionElement: el,
+                    nodes: Array.from(el.childNodes),
+                    isDefault: false
+                });
+            }
+            else if (tagName === 'otherwise') {
+                this.branches.push({
+                    conditionElement: el,
+                    nodes: Array.from(el.childNodes),
+                    isDefault: true
+                });
+            }
+        }
+        this.placeholder = document.createComment('smart-select');
+        host.appendChild(this.placeholder);
+        const updateBranches = () => {
+            if (!this.placeholder?.parentNode)
+                return;
+            const matching = this.resolveBranch();
+            if (matching === this.activeBranch) {
+                return;
+            }
+            if (this.activeBranch) {
+                for (const node of this.activeBranch.nodes) {
+                    node.parentNode?.removeChild(node);
+                }
+            }
+            this.activeBranch = matching;
+            if (matching) {
+                for (const node of matching.nodes) {
+                    this.placeholder.parentNode.insertBefore(node, this.placeholder);
+                }
+            }
+        };
+        this.observer = new MutationObserver(updateBranches);
+        for (const branch of this.branches) {
+            if (!branch.isDefault) {
+                this.observer.observe(branch.conditionElement, {
+                    attributes: true,
+                    attributeFilter: ['condition']
+                });
+            }
+        }
+        updateBranches();
+    }
+    onComponentDestroy() {
+        if (this.observer) {
+            this.observer.disconnect();
+            this.observer = null;
+        }
+        if (this.activeBranch) {
+            for (const node of this.activeBranch.nodes) {
+                node.parentNode?.removeChild(node);
+            }
+            this.activeBranch = null;
+        }
+        this.branches = [];
+        this.placeholder = null;
+    }
+    /**
+     * Resolves which branch should be active.
+     * Evaluates `<on>` branches first in order; falls back to `<otherwise>` only
+     * when no `<on>` matches.
+     *
+     * @returns The matching branch, or null if none matches
+     */
+    resolveBranch() {
+        let defaultBranch = null;
+        for (const branch of this.branches) {
+            if (branch.isDefault) {
+                defaultBranch = branch;
+                continue;
+            }
+            const condition = branch.conditionElement.getAttribute('condition');
+            if (condition === 'true' || condition === '') {
+                return branch;
+            }
+        }
+        return defaultBranch;
+    }
+}
+//# sourceMappingURL=smart-select.lifecycle-manager.js.map

package/dist/components/smart-select/smart-select.lifecycle-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"smart-select.lifecycle-manager.js","sourceRoot":"","sources":["../../../src/components/smart-select/smart-select.lifecycle-manager.ts"],"names":[],"mappings":"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"}

package/dist/components/smart-select.d.ts

@@ -0,0 +1,3 @@
+export { SmartSelect } from './smart-select/smart-select.component.js';
+export { SmartSelectLifecycleManager } from './smart-select/smart-select.lifecycle-manager.js';
+//# sourceMappingURL=smart-select.d.ts.map

package/dist/components/smart-select.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"smart-select.d.ts","sourceRoot":"","sources":["../../src/components/smart-select.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,0CAA0C,CAAC;AACvE,OAAO,EAAE,2BAA2B,EAAE,MAAM,kDAAkD,CAAC"}

package/dist/components/smart-select.js

@@ -0,0 +1,3 @@
+export { SmartSelect } from './smart-select/smart-select.component.js';
+export { SmartSelectLifecycleManager } from './smart-select/smart-select.lifecycle-manager.js';
+//# sourceMappingURL=smart-select.js.map

package/dist/components/smart-select.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"smart-select.js","sourceRoot":"","sources":["../../src/components/smart-select.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,0CAA0C,CAAC;AACvE,OAAO,EAAE,2BAA2B,EAAE,MAAM,kDAAkD,CAAC"}

package/dist/core/component-instance-registry.d.ts

@@ -0,0 +1,102 @@
+import { SmartComponent } from "./smart-component.js";
+import { ComponentMetadata } from "./component-metadata.js";
+/**
+ * Defines the responsibility of storing component instance state.
+ *
+ * @template T - The SmartComponent type
+ *
+ * @description
+ * Tracks a single component instance in 1:1 relationship with its host element.
+ * Each custom element has its own component instance.
+ */
+export interface ComponentInstanceEntry<T extends SmartComponent = SmartComponent> {
+    /** The component instance */
+    instance: T;
+    /** Metadata for rendering */
+    metadata: ComponentMetadata;
+    /** Initialization promise (null if not async or completed) */
+    initPromise: Promise<boolean> | null;
+    /** DOM context ID for this instance */
+    contextId: string;
+}
+/**
+ * Defines the responsibility of managing component instance lifetimes.
+ *
+ * @description
+ * Maps contextIds to component instances (1:1 per host element).
+ * Injected into RenderEngine — one registry per engine instance.
+ */
+export interface IComponentInstanceRegistry {
+    /**
+     * Gets an existing instance for the context, or creates one via factory.
+     *
+     * @param contextId - Unique DOM context identifier
+     * @param factory - Factory function called only when no instance exists for the context
+     * @param metadata - Component metadata
+     * @returns Component instance entry
+     * @throws Error if any parameter is null or undefined
+     */
+    getOrCreate<T extends SmartComponent>(contextId: string, factory: () => T, metadata: ComponentMetadata): ComponentInstanceEntry<T>;
+    /**
+     * Destroys the instance for the given context and removes it from the registry.
+     *
+     * @param contextId - DOM context identifier
+     * @throws Error if contextId is null or undefined
+     */
+    release(contextId: string): void;
+}
+/**
+ * Implements the responsibility of managing component instances in 1:1 relationship with hosts.
+ *
+ * @description
+ * Each custom element host creates its own component instance.
+ * Registry tracks instances by contextId for lifecycle management.
+ *
+ * @example
+ * ```typescript
+ * const registry = new ComponentInstanceRegistry();
+ *
+ * const entry = registry.getOrCreate(
+ *   'context-1',
+ *   () => new UserBadge(),
+ *   metadata
+ * );
+ *
+ * registry.release('context-1');
+ * ```
+ */
+export declare class ComponentInstanceRegistry implements IComponentInstanceRegistry {
+    private readonly instances;
+    /**
+     * Gets an existing instance for the context, or creates one via factory.
+     *
+     * @param contextId - Unique DOM context identifier
+     * @param factory - Factory called only when no instance exists for this context
+     * @param metadata - Component metadata
+     * @returns Component instance entry
+     * @throws Error if any parameter is null or undefined
+     *
+     * @example
+     * ```typescript
+     * const entry = registry.getOrCreate(
+     *   'dom-ctx-1',
+     *   () => new Counter(),
+     *   metadata
+     * );
+     * ```
+     */
+    getOrCreate<T extends SmartComponent>(contextId: string, factory: () => T, metadata: ComponentMetadata): ComponentInstanceEntry<T>;
+    /**
+     * Destroys the instance for the given context and removes it from the registry.
+     *
+     * @param contextId - DOM context identifier
+     * @throws Error if contextId is null or undefined
+     *
+     * @example
+     * ```typescript
+     * registry.release('dom-ctx-1');
+     * ```
+     */
+    release(contextId: string): void;
+}
+//# sourceMappingURL=component-instance-registry.d.ts.map

package/dist/core/component-instance-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"component-instance-registry.d.ts","sourceRoot":"","sources":["../../src/core/component-instance-registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAE5D;;;;;;;;GAQG;AACH,MAAM,WAAW,sBAAsB,CACrC,CAAC,SAAS,cAAc,GAAG,cAAc;IAEzC,6BAA6B;IAC7B,QAAQ,EAAE,CAAC,CAAC;IAEZ,6BAA6B;IAC7B,QAAQ,EAAE,iBAAiB,CAAC;IAE5B,8DAA8D;IAC9D,WAAW,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC;IAErC,uCAAuC;IACvC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,0BAA0B;IACzC;;;;;;;;OAQG;IACH,WAAW,CAAC,CAAC,SAAS,cAAc,EAClC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,CAAC,EAChB,QAAQ,EAAE,iBAAiB,GAC1B,sBAAsB,CAAC,CAAC,CAAC,CAAC;IAE7B;;;;;OAKG;IACH,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAClC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,yBAA0B,YAAW,0BAA0B;IAC1E,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA6C;IAEvE;;;;;;;;;;;;;;;;;OAiBG;IACH,WAAW,CAAC,CAAC,SAAS,cAAc,EAClC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,CAAC,EAChB,QAAQ,EAAE,iBAAiB,GAC1B,sBAAsB,CAAC,CAAC,CAAC;IAqB5B;;;;;;;;;;OAUG;IACH,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;CAajC"}

package/dist/core/component-instance-registry.js

@@ -0,0 +1,85 @@
+/**
+ * Implements the responsibility of managing component instances in 1:1 relationship with hosts.
+ *
+ * @description
+ * Each custom element host creates its own component instance.
+ * Registry tracks instances by contextId for lifecycle management.
+ *
+ * @example
+ * ```typescript
+ * const registry = new ComponentInstanceRegistry();
+ *
+ * const entry = registry.getOrCreate(
+ *   'context-1',
+ *   () => new UserBadge(),
+ *   metadata
+ * );
+ *
+ * registry.release('context-1');
+ * ```
+ */
+export class ComponentInstanceRegistry {
+    instances = new Map();
+    /**
+     * Gets an existing instance for the context, or creates one via factory.
+     *
+     * @param contextId - Unique DOM context identifier
+     * @param factory - Factory called only when no instance exists for this context
+     * @param metadata - Component metadata
+     * @returns Component instance entry
+     * @throws Error if any parameter is null or undefined
+     *
+     * @example
+     * ```typescript
+     * const entry = registry.getOrCreate(
+     *   'dom-ctx-1',
+     *   () => new Counter(),
+     *   metadata
+     * );
+     * ```
+     */
+    getOrCreate(contextId, factory, metadata) {
+        if (!contextId)
+            throw new Error("ContextId is required");
+        if (!factory)
+            throw new Error("Factory is required");
+        if (!metadata)
+            throw new Error("Metadata is required");
+        const existing = this.instances.get(contextId);
+        if (existing) {
+            return existing;
+        }
+        const entry = {
+            instance: factory(),
+            metadata,
+            initPromise: null,
+            contextId,
+        };
+        this.instances.set(contextId, entry);
+        return entry;
+    }
+    /**
+     * Destroys the instance for the given context and removes it from the registry.
+     *
+     * @param contextId - DOM context identifier
+     * @throws Error if contextId is null or undefined
+     *
+     * @example
+     * ```typescript
+     * registry.release('dom-ctx-1');
+     * ```
+     */
+    release(contextId) {
+        if (!contextId)
+            throw new Error("ContextId is required");
+        const entry = this.instances.get(contextId);
+        if (!entry) {
+            return;
+        }
+        if (entry.instance.onDestroy) {
+            entry.instance.onDestroy();
+        }
+        this.instances.delete(contextId);
+    }
+}
+//# sourceMappingURL=component-instance-registry.js.map

package/dist/core/component-instance-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"component-instance-registry.js","sourceRoot":"","sources":["../../src/core/component-instance-registry.ts"],"names":[],"mappings":"AA4DA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,OAAO,yBAAyB;IACnB,SAAS,GAAG,IAAI,GAAG,EAAkC,CAAC;IAEvE;;;;;;;;;;;;;;;;;OAiBG;IACH,WAAW,CACT,SAAiB,EACjB,OAAgB,EAChB,QAA2B;QAE3B,IAAI,CAAC,SAAS;YAAE,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;QACzD,IAAI,CAAC,OAAO;YAAE,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC;QACrD,IAAI,CAAC,QAAQ;YAAE,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;QAEvD,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC/C,IAAI,QAAQ,EAAE,CAAC;YACb,OAAO,QAAqC,CAAC;QAC/C,CAAC;QAED,MAAM,KAAK,GAA8B;YACvC,QAAQ,EAAE,OAAO,EAAE;YACnB,QAAQ;YACR,WAAW,EAAE,IAAI;YACjB,SAAS;SACV,CAAC;QAEF,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,SAAS,EAAE,KAA+B,CAAC,CAAC;QAC/D,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;;;;;;;;;OAUG;IACH,OAAO,CAAC,SAAiB;QACvB,IAAI,CAAC,SAAS;YAAE,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;QAEzD,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC5C,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO;QACT,CAAC;QAED,IAAI,KAAK,CAAC,QAAQ,CAAC,SAAS,EAAE,CAAC;YAC7B,KAAK,CAAC,QAAQ,CAAC,SAAS,EAAE,CAAC;QAC7B,CAAC;QACD,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACnC,CAAC;CACF"}

package/dist/core/component-metadata-registry.d.ts

@@ -0,0 +1,100 @@
+import { ComponentMetadata } from "./component-metadata.js";
+import type { IComponentMetadataRegistry } from "./component-metadata-registry.interface.js";
+/**
+ * Exports ComponentMetadata for use in test files and components
+ */
+export type { ComponentMetadata };
+/**
+ * Implements the responsibility of storing and retrieving component metadata.
+ *
+ * @description
+ * Instanciable registry for component metadata indexed by selector (tag name).
+ * Registered in the service container under `'IComponentMetadataRegistry'` by `bootstrapFramework`.
+ *
+ * @example
+ * ```typescript
+ * // Register metadata
+ * const registry = new ComponentMetadataRegistry();
+ * registry.register('my-counter', {
+ *   selector: 'my-counter',
+ *   template: '<div>{{count}}</div>'
+ * });
+ *
+ * // Retrieve metadata
+ * const metadata = registry.get('my-counter');
+ *
+ * // Check existence
+ * if (registry.has('my-counter')) {
+ *   // ...
+ * }
+ *
+ * // Clear for testing
+ * registry.clear();
+ * ```
+ */
+export declare class ComponentMetadataRegistry implements IComponentMetadataRegistry {
+    private readonly metadata;
+    /**
+     * Registers component metadata in the registry.
+     *
+     * @param componentId - Component selector (tag name)
+     * @param metadata - Component metadata
+     * @throws Error if componentId or metadata is null or undefined
+     * @throws Error if componentId is already registered
+     *
+     * @example
+     * ```typescript
+     * registry.register('my-counter', {
+     *   selector: 'my-counter',
+     *   template: '<div>Count: {{count}}</div>'
+     * });
+     * ```
+     */
+    register(componentId: string, metadata: ComponentMetadata): void;
+    /**
+     * Retrieves component metadata from the registry.
+     *
+     * @param componentId - Component selector (tag name)
+     * @returns Component metadata or undefined if not found
+     * @throws Error if componentId is null or undefined
+     *
+     * @example
+     * ```typescript
+     * const metadata = registry.get('my-counter');
+     * if (metadata) {
+     *   console.log(metadata.template);
+     * }
+     * ```
+     */
+    get(componentId: string): ComponentMetadata | undefined;
+    /**
+     * Checks if component metadata exists in the registry.
+     *
+     * @param componentId - Component selector (tag name)
+     * @returns true if metadata exists, false otherwise
+     * @throws Error if componentId is null or undefined
+     *
+     * @example
+     * ```typescript
+     * if (registry.has('my-counter')) {
+     *   // Component is registered
+     * }
+     * ```
+     */
+    has(componentId: string): boolean;
+    /**
+     * Clears all registered metadata.
+     *
+     * @description
+     * Used for testing to ensure test isolation.
+     *
+     * @example
+     * ```typescript
+     * afterEach(() => {
+     *   registry.clear();
+     * });
+     * ```
+     */
+    clear(): void;
+}
+//# sourceMappingURL=component-metadata-registry.d.ts.map

package/dist/core/component-metadata-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"component-metadata-registry.d.ts","sourceRoot":"","sources":["../../src/core/component-metadata-registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,4CAA4C,CAAC;AAE7F;;GAEG;AACH,YAAY,EAAE,iBAAiB,EAAE,CAAC;AAElC;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,qBAAa,yBAA0B,YAAW,0BAA0B;IAC1E,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAwC;IAEjE;;;;;;;;;;;;;;;OAeG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,iBAAiB,GAAG,IAAI;IAWhE;;;;;;;;;;;;;;OAcG;IACH,GAAG,CAAC,WAAW,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS;IAKvD;;;;;;;;;;;;;OAaG;IACH,GAAG,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO;IAKjC;;;;;;;;;;;;OAYG;IACH,KAAK,IAAI,IAAI;CAGd"}

package/dist/core/component-metadata-registry.interface.d.ts

@@ -0,0 +1,44 @@
+import type { ComponentMetadata } from "./component-metadata.js";
+/**
+ * Defines the responsibility of storing and retrieving component metadata.
+ *
+ * @description
+ * Single contract for the metadata registry — both decorators (write) and the render
+ * engine (read) depend on this interface. One token, one instance, no divergence.
+ * Registered in the service container under `'IComponentMetadataRegistry'`.
+ *
+ * @example
+ * ```typescript
+ * const registry = Services.get<IComponentMetadataRegistry>('IComponentMetadataRegistry');
+ * registry.register('my-counter', { selector: 'my-counter', template: '<div>{{count}}</div>' });
+ * const metadata = registry.get('my-counter');
+ * ```
+ */
+export interface IComponentMetadataRegistry {
+    /**
+     * Registers component metadata in the registry.
+     *
+     * @param componentId - Component selector (tag name)
+     * @param metadata - Component metadata to store
+     * @throws Error if componentId or metadata is null or undefined
+     * @throws Error if componentId is already registered
+     */
+    register(componentId: string, metadata: ComponentMetadata): void;
+    /**
+     * Retrieves component metadata by selector.
+     *
+     * @param componentId - Component selector (tag name)
+     * @returns Component metadata or undefined if not found
+     * @throws Error if componentId is null or undefined
+     */
+    get(componentId: string): ComponentMetadata | undefined;
+    /**
+     * Checks if component metadata exists.
+     *
+     * @param componentId - Component selector (tag name)
+     * @returns true if metadata exists, false otherwise
+     * @throws Error if componentId is null or undefined
+     */
+    has(componentId: string): boolean;
+}
+//# sourceMappingURL=component-metadata-registry.interface.d.ts.map

package/dist/core/component-metadata-registry.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"component-metadata-registry.interface.d.ts","sourceRoot":"","sources":["../../src/core/component-metadata-registry.interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAEjE;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,0BAA0B;IACzC;;;;;;;OAOG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAEjE;;;;;;OAMG;IACH,GAAG,CAAC,WAAW,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS,CAAC;IAExD;;;;;;OAMG;IACH,GAAG,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC;CACnC"}

package/dist/core/component-metadata-registry.interface.js

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

package/dist/core/component-metadata-registry.interface.js.map

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

package/dist/core/component-metadata-registry.js

@@ -0,0 +1,113 @@
+/**
+ * Implements the responsibility of storing and retrieving component metadata.
+ *
+ * @description
+ * Instanciable registry for component metadata indexed by selector (tag name).
+ * Registered in the service container under `'IComponentMetadataRegistry'` by `bootstrapFramework`.
+ *
+ * @example
+ * ```typescript
+ * // Register metadata
+ * const registry = new ComponentMetadataRegistry();
+ * registry.register('my-counter', {
+ *   selector: 'my-counter',
+ *   template: '<div>{{count}}</div>'
+ * });
+ *
+ * // Retrieve metadata
+ * const metadata = registry.get('my-counter');
+ *
+ * // Check existence
+ * if (registry.has('my-counter')) {
+ *   // ...
+ * }
+ *
+ * // Clear for testing
+ * registry.clear();
+ * ```
+ */
+export class ComponentMetadataRegistry {
+    metadata = new Map();
+    /**
+     * Registers component metadata in the registry.
+     *
+     * @param componentId - Component selector (tag name)
+     * @param metadata - Component metadata
+     * @throws Error if componentId or metadata is null or undefined
+     * @throws Error if componentId is already registered
+     *
+     * @example
+     * ```typescript
+     * registry.register('my-counter', {
+     *   selector: 'my-counter',
+     *   template: '<div>Count: {{count}}</div>'
+     * });
+     * ```
+     */
+    register(componentId, metadata) {
+        if (!componentId)
+            throw new Error("ComponentId is required");
+        if (!metadata)
+            throw new Error("Metadata is required");
+        if (this.metadata.has(componentId)) {
+            throw new Error(`Component ${componentId} is already registered`);
+        }
+        this.metadata.set(componentId, metadata);
+    }
+    /**
+     * Retrieves component metadata from the registry.
+     *
+     * @param componentId - Component selector (tag name)
+     * @returns Component metadata or undefined if not found
+     * @throws Error if componentId is null or undefined
+     *
+     * @example
+     * ```typescript
+     * const metadata = registry.get('my-counter');
+     * if (metadata) {
+     *   console.log(metadata.template);
+     * }
+     * ```
+     */
+    get(componentId) {
+        if (!componentId)
+            throw new Error("ComponentId is required");
+        return this.metadata.get(componentId);
+    }
+    /**
+     * Checks if component metadata exists in the registry.
+     *
+     * @param componentId - Component selector (tag name)
+     * @returns true if metadata exists, false otherwise
+     * @throws Error if componentId is null or undefined
+     *
+     * @example
+     * ```typescript
+     * if (registry.has('my-counter')) {
+     *   // Component is registered
+     * }
+     * ```
+     */
+    has(componentId) {
+        if (!componentId)
+            throw new Error("ComponentId is required");
+        return this.metadata.has(componentId);
+    }
+    /**
+     * Clears all registered metadata.
+     *
+     * @description
+     * Used for testing to ensure test isolation.
+     *
+     * @example
+     * ```typescript
+     * afterEach(() => {
+     *   registry.clear();
+     * });
+     * ```
+     */
+    clear() {
+        this.metadata.clear();
+    }
+}
+//# sourceMappingURL=component-metadata-registry.js.map

package/dist/core/component-metadata-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"component-metadata-registry.js","sourceRoot":"","sources":["../../src/core/component-metadata-registry.ts"],"names":[],"mappings":"AAQA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,OAAO,yBAAyB;IACnB,QAAQ,GAAG,IAAI,GAAG,EAA6B,CAAC;IAEjE;;;;;;;;;;;;;;;OAeG;IACH,QAAQ,CAAC,WAAmB,EAAE,QAA2B;QACvD,IAAI,CAAC,WAAW;YAAE,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;QAC7D,IAAI,CAAC,QAAQ;YAAE,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;QAEvD,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC;YACnC,MAAM,IAAI,KAAK,CAAC,aAAa,WAAW,wBAAwB,CAAC,CAAC;QACpE,CAAC;QAED,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;IAC3C,CAAC;IAED;;;;;;;;;;;;;;OAcG;IACH,GAAG,CAAC,WAAmB;QACrB,IAAI,CAAC,WAAW;YAAE,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;QAC7D,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IACxC,CAAC;IAED;;;;;;;;;;;;;OAaG;IACH,GAAG,CAAC,WAAmB;QACrB,IAAI,CAAC,WAAW;YAAE,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;QAC7D,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IACxC,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,KAAK;QACH,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC;CACF"}