smart-lifecycle 0.1.1

package/dist/registration/smart-element-factory.d.ts

@@ -0,0 +1,46 @@
+import { SmartComponent } from "../core/smart-component.js";
+import type { IRenderEngine } from "../rendering/index.js";
+import type { IServiceProvider } from "../providers/service-provider.interface.js";
+import type { InitializerFactory, LifecycleFactory } from "../core/component-metadata.js";
+import type { ISmartElementFactory } from "./smart-element-factory.interface.js";
+/**
+ * Defines the responsibility of configuring a smart element registration.
+ */
+export interface SmartElementOptions<_T extends SmartComponent = SmartComponent> {
+    /** Factory function that creates the component initializer */
+    initializer?: InitializerFactory;
+    /** Factory function that creates the lifecycle manager */
+    lifecycle?: LifecycleFactory;
+    /** Custom render engine instance (defaults to container-resolved IRenderEngine) */
+    renderEngine?: IRenderEngine;
+}
+/**
+ * Implements the responsibility of creating CustomElementConstructor classes for SmartComponents.
+ *
+ * @example
+ * ```typescript
+ * const factory = new SmartElementFactory(serviceProvider);
+ * const ElementClass = factory.create(CounterComponent);
+ * customElements.define('my-counter', ElementClass);
+ * ```
+ */
+export declare class SmartElementFactory implements ISmartElementFactory {
+    private readonly serviceProvider;
+    /**
+     * Initializes a new instance of SmartElementFactory.
+     *
+     * @param serviceProvider - Service provider for resolving dependencies
+     * @throws Error if serviceProvider is null or undefined
+     */
+    constructor(serviceProvider: IServiceProvider);
+    /**
+     * Creates a CustomElementConstructor class bound to the given SmartComponent.
+     *
+     * @param componentCtor - Constructor of the SmartComponent to wrap
+     * @param options - Optional configuration for the element
+     * @throws Error if componentCtor is null or undefined
+     * @returns A CustomElementConstructor ready to be passed to customElements.define
+     */
+    create<T extends SmartComponent>(componentCtor: new (...args: unknown[]) => T, options?: SmartElementOptions<T>): CustomElementConstructor;
+}
+//# sourceMappingURL=smart-element-factory.d.ts.map

package/dist/registration/smart-element-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"smart-element-factory.d.ts","sourceRoot":"","sources":["../../src/registration/smart-element-factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAE5D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4CAA4C,CAAC;AAEnF,OAAO,KAAK,EACV,kBAAkB,EAClB,gBAAgB,EACjB,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAC;AAEjF;;GAEG;AAEH,MAAM,WAAW,mBAAmB,CAClC,EAAE,SAAS,cAAc,GAAG,cAAc;IAE1C,8DAA8D;IAC9D,WAAW,CAAC,EAAE,kBAAkB,CAAC;IACjC,0DAA0D;IAC1D,SAAS,CAAC,EAAE,gBAAgB,CAAC;IAC7B,mFAAmF;IACnF,YAAY,CAAC,EAAE,aAAa,CAAC;CAC9B;AAED;;;;;;;;;GASG;AACH,qBAAa,mBAAoB,YAAW,oBAAoB;IAC9D,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAmB;IAEnD;;;;;OAKG;gBACS,eAAe,EAAE,gBAAgB;IAM7C;;;;;;;OAOG;IACH,MAAM,CAAC,CAAC,SAAS,cAAc,EAC7B,aAAa,EAAE,KAAK,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,EAC5C,OAAO,CAAC,EAAE,mBAAmB,CAAC,CAAC,CAAC,GAC/B,wBAAwB;CA8J5B"}

package/dist/registration/smart-element-factory.interface.d.ts

@@ -0,0 +1,17 @@
+import type { SmartComponent } from "../core/smart-component.js";
+import type { SmartElementOptions } from "./smart-element-factory.js";
+/**
+ * Defines the responsibility of creating CustomElementConstructor classes for SmartComponents.
+ */
+export interface ISmartElementFactory {
+    /**
+     * Creates a CustomElementConstructor class bound to the given SmartComponent.
+     *
+     * @param componentCtor - Constructor of the SmartComponent to wrap
+     * @param options - Optional configuration for the element
+     * @throws Error if componentCtor is null or undefined
+     * @returns A CustomElementConstructor ready to be passed to customElements.define
+     */
+    create<T extends SmartComponent>(componentCtor: new (...args: unknown[]) => T, options?: SmartElementOptions<T>): CustomElementConstructor;
+}
+//# sourceMappingURL=smart-element-factory.interface.d.ts.map

package/dist/registration/smart-element-factory.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"smart-element-factory.interface.d.ts","sourceRoot":"","sources":["../../src/registration/smart-element-factory.interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAEtE;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;;;;;OAOG;IACH,MAAM,CAAC,CAAC,SAAS,cAAc,EAC7B,aAAa,EAAE,KAAK,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,EAC5C,OAAO,CAAC,EAAE,mBAAmB,CAAC,CAAC,CAAC,GAC/B,wBAAwB,CAAC;CAC7B"}

package/dist/registration/smart-element-factory.interface.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=smart-element-factory.interface.js.map

package/dist/registration/smart-element-factory.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"smart-element-factory.interface.js","sourceRoot":"","sources":["../../src/registration/smart-element-factory.interface.ts"],"names":[],"mappings":""}

package/dist/registration/smart-element-factory.js

@@ -0,0 +1,146 @@
+/**
+ * Implements the responsibility of creating CustomElementConstructor classes for SmartComponents.
+ *
+ * @example
+ * ```typescript
+ * const factory = new SmartElementFactory(serviceProvider);
+ * const ElementClass = factory.create(CounterComponent);
+ * customElements.define('my-counter', ElementClass);
+ * ```
+ */
+export class SmartElementFactory {
+    serviceProvider;
+    /**
+     * Initializes a new instance of SmartElementFactory.
+     *
+     * @param serviceProvider - Service provider for resolving dependencies
+     * @throws Error if serviceProvider is null or undefined
+     */
+    constructor(serviceProvider) {
+        if (!serviceProvider)
+            throw new Error("Service provider is required");
+        this.serviceProvider = serviceProvider;
+    }
+    /**
+     * Creates a CustomElementConstructor class bound to the given SmartComponent.
+     *
+     * @param componentCtor - Constructor of the SmartComponent to wrap
+     * @param options - Optional configuration for the element
+     * @throws Error if componentCtor is null or undefined
+     * @returns A CustomElementConstructor ready to be passed to customElements.define
+     */
+    create(componentCtor, options) {
+        if (!componentCtor)
+            throw new Error("Component constructor is required");
+        const { renderEngine } = options ?? {};
+        const engine = renderEngine || this.serviceProvider.get("IRenderEngine");
+        const objectRegistry = this.serviceProvider.get("IObjectRegistry");
+        // Collect reactive props from both the instance (TC39 field form) and the
+        // prototype (TC39 accessor form and legacy/Babel decorator mode).
+        // Only accessors with BOTH get AND set are picked from the prototype
+        // to avoid capturing plain getters (which lack a setter) or methods.
+        const instance = new componentCtor();
+        const instanceProps = Object.keys(instance).filter((key) => !key.startsWith("_"));
+        const proto = Object.getPrototypeOf(instance);
+        const protoProps = proto
+            ? Object.entries(Object.getOwnPropertyDescriptors(proto))
+                .filter(([key, desc]) => !key.startsWith("_") &&
+                key !== "constructor" &&
+                typeof desc.get === "function" &&
+                typeof desc.set === "function")
+                .map(([key]) => key)
+            : [];
+        const observableProps = [...new Set([...instanceProps, ...protoProps])];
+        return class SmartElement extends HTMLElement {
+            component = null;
+            renderResult = null;
+            static get observedAttributes() {
+                return observableProps;
+            }
+            handleSmartAction = (event) => {
+                if (!this.component)
+                    return;
+                const originalTarget = event.composedPath()[0];
+                if (originalTarget === this)
+                    return;
+                const customEvent = event;
+                const detail = customEvent.detail;
+                const nameCandidate = detail?.name;
+                if (typeof nameCandidate !== "string" || nameCandidate.length === 0) {
+                    return;
+                }
+                const value = detail?.value;
+                const maybeGetViewActions = this.component.getViewActions;
+                if (typeof maybeGetViewActions === "function") {
+                    const actions = maybeGetViewActions.call(this.component);
+                    const candidate = actions?.[nameCandidate];
+                    if (typeof candidate === "function") {
+                        candidate.call(this.component, value, event);
+                        return;
+                    }
+                }
+                if (nameCandidate in this.component) {
+                    const candidate = this.component[nameCandidate];
+                    if (typeof candidate === "function") {
+                        candidate.call(this.component, value, event);
+                    }
+                }
+            };
+            async connectedCallback() {
+                if (this.component) {
+                    return;
+                }
+                this.component = new componentCtor();
+                const component = this.component;
+                Array.from(this.attributes).forEach((attr) => {
+                    const propName = attr.name;
+                    if (propName in component) {
+                        const fromRegistry = objectRegistry.get(attr.value);
+                        component[propName] =
+                            fromRegistry !== undefined ? fromRegistry : attr.value;
+                    }
+                });
+                const componentId = this.tagName.toLowerCase();
+                const targetRoot = this.attachShadow({ mode: "open" });
+                // Inherit the document-level data-theme so that Shadow DOM CSS rules
+                // (e.g. Pico CSS :host(:not([data-theme=dark]))) respect the current theme.
+                const docTheme = document.documentElement.getAttribute("data-theme");
+                if (docTheme) {
+                    this.setAttribute("data-theme", docTheme);
+                }
+                try {
+                    const result = await engine.render({
+                        componentId,
+                        component: this.component,
+                        targetRoot,
+                        hostElement: this,
+                    });
+                    this.renderResult = result;
+                }
+                catch (error) {
+                    this.component = null;
+                    throw error;
+                }
+                this.addEventListener("smart-action", this.handleSmartAction);
+            }
+            attributeChangedCallback(name, _oldValue, newValue) {
+                if (!this.component || newValue === null)
+                    return;
+                if (name in this.component) {
+                    const resolved = objectRegistry.get(newValue);
+                    this.component[name] =
+                        resolved !== undefined ? resolved : newValue;
+                }
+            }
+            disconnectedCallback() {
+                this.removeEventListener("smart-action", this.handleSmartAction);
+                if (this.renderResult) {
+                    this.renderResult.cleanup();
+                    this.renderResult = null;
+                }
+                this.component = null;
+            }
+        };
+    }
+}
+//# sourceMappingURL=smart-element-factory.js.map

package/dist/registration/smart-element-factory.js.map

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

package/dist/registration/smart-element-registrar.d.ts

@@ -0,0 +1,41 @@
+import type { SmartComponent } from "../core/smart-component.js";
+import type { IServiceRegistry } from "../providers/service-provider.interface.js";
+import type { SmartElementOptions } from "./smart-element-factory.js";
+import type { ISmartElementRegistrar } from "./smart-element-registrar.interface.js";
+import type { ISmartElementFactory } from "./smart-element-factory.interface.js";
+/**
+ * Implements the responsibility of registering SmartComponents as native custom elements.
+ *
+ * @example
+ * ```typescript
+ * const registrar = new SmartElementRegistrar(serviceRegistry, elementFactory);
+ * registrar.register('my-counter', CounterComponent);
+ * ```
+ */
+export declare class SmartElementRegistrar implements ISmartElementRegistrar {
+    private readonly elementFactory;
+    /**
+     * Initializes a new instance of SmartElementRegistrar.
+     *
+     * @param _serviceRegistry - Registry for resolving and registering services (reserved for future use)
+     * @param elementFactory - Factory for creating CustomElementConstructor classes
+     * @throws Error if serviceRegistry or elementFactory are null or undefined
+     */
+    constructor(_serviceRegistry: IServiceRegistry, elementFactory: ISmartElementFactory);
+    /**
+     * Registers a SmartComponent as a native custom element.
+     *
+     * @param tagName - HTML tag name for the element (e.g. 'my-component')
+     * @param componentCtor - Constructor of the SmartComponent to register
+     * @param options - Optional configuration: lifecycle, initializer, shadow DOM, render engine
+     * @throws Error if tagName or componentCtor are null or undefined
+     *
+     * @example
+     * ```typescript
+     * const registrar = new SmartElementRegistrar(serviceRegistry);
+     * registrar.register('my-counter', CounterComponent);
+     * ```
+     */
+    register<T extends SmartComponent>(tagName: string, componentCtor: new (...args: unknown[]) => T, options?: SmartElementOptions<T>): void;
+}
+//# sourceMappingURL=smart-element-registrar.d.ts.map

package/dist/registration/smart-element-registrar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"smart-element-registrar.d.ts","sourceRoot":"","sources":["../../src/registration/smart-element-registrar.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4CAA4C,CAAC;AACnF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACtE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,wCAAwC,CAAC;AACrF,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAC;AAEjF;;;;;;;;GAQG;AACH,qBAAa,qBAAsB,YAAW,sBAAsB;IAClE,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAuB;IAEtD;;;;;;OAMG;gBAED,gBAAgB,EAAE,gBAAgB,EAClC,cAAc,EAAE,oBAAoB;IAQtC;;;;;;;;;;;;;OAaG;IACH,QAAQ,CAAC,CAAC,SAAS,cAAc,EAC/B,OAAO,EAAE,MAAM,EACf,aAAa,EAAE,KAAK,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,EAC5C,OAAO,CAAC,EAAE,mBAAmB,CAAC,CAAC,CAAC,GAC/B,IAAI;CAoBR"}

package/dist/registration/smart-element-registrar.interface.d.ts

@@ -0,0 +1,17 @@
+import type { SmartComponent } from "../core/smart-component.js";
+import type { SmartElementOptions } from "./smart-element-factory.js";
+/**
+ * Defines the responsibility of registering SmartComponents as native custom elements.
+ */
+export interface ISmartElementRegistrar {
+    /**
+     * Registers a SmartComponent as a native custom element.
+     *
+     * @param tagName - HTML tag name for the element (e.g. 'my-component')
+     * @param componentCtor - Constructor of the SmartComponent to register
+     * @param options - Optional configuration: lifecycle, initializer, shadow DOM, render engine
+     * @throws Error if tagName or componentCtor are null or undefined
+     */
+    register<T extends SmartComponent>(tagName: string, componentCtor: new (...args: unknown[]) => T, options?: SmartElementOptions<T>): void;
+}
+//# sourceMappingURL=smart-element-registrar.interface.d.ts.map

package/dist/registration/smart-element-registrar.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"smart-element-registrar.interface.d.ts","sourceRoot":"","sources":["../../src/registration/smart-element-registrar.interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAEtE;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC;;;;;;;OAOG;IACH,QAAQ,CAAC,CAAC,SAAS,cAAc,EAC/B,OAAO,EAAE,MAAM,EACf,aAAa,EAAE,KAAK,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,EAC5C,OAAO,CAAC,EAAE,mBAAmB,CAAC,CAAC,CAAC,GAC/B,IAAI,CAAC;CACT"}

package/dist/registration/smart-element-registrar.interface.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=smart-element-registrar.interface.js.map

package/dist/registration/smart-element-registrar.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"smart-element-registrar.interface.js","sourceRoot":"","sources":["../../src/registration/smart-element-registrar.interface.ts"],"names":[],"mappings":""}

package/dist/registration/smart-element-registrar.js

@@ -0,0 +1,56 @@
+/**
+ * Implements the responsibility of registering SmartComponents as native custom elements.
+ *
+ * @example
+ * ```typescript
+ * const registrar = new SmartElementRegistrar(serviceRegistry, elementFactory);
+ * registrar.register('my-counter', CounterComponent);
+ * ```
+ */
+export class SmartElementRegistrar {
+    elementFactory;
+    /**
+     * Initializes a new instance of SmartElementRegistrar.
+     *
+     * @param _serviceRegistry - Registry for resolving and registering services (reserved for future use)
+     * @param elementFactory - Factory for creating CustomElementConstructor classes
+     * @throws Error if serviceRegistry or elementFactory are null or undefined
+     */
+    constructor(_serviceRegistry, elementFactory) {
+        if (!_serviceRegistry)
+            throw new Error("Service registry is required");
+        if (!elementFactory)
+            throw new Error("Element factory is required");
+        this.elementFactory = elementFactory;
+    }
+    /**
+     * Registers a SmartComponent as a native custom element.
+     *
+     * @param tagName - HTML tag name for the element (e.g. 'my-component')
+     * @param componentCtor - Constructor of the SmartComponent to register
+     * @param options - Optional configuration: lifecycle, initializer, shadow DOM, render engine
+     * @throws Error if tagName or componentCtor are null or undefined
+     *
+     * @example
+     * ```typescript
+     * const registrar = new SmartElementRegistrar(serviceRegistry);
+     * registrar.register('my-counter', CounterComponent);
+     * ```
+     */
+    register(tagName, componentCtor, options) {
+        if (!tagName)
+            throw new Error("Tag name is required");
+        if (!componentCtor)
+            throw new Error("Component constructor is required");
+        const normalizedTag = tagName.toLowerCase();
+        if (typeof customElements === "undefined") {
+            return;
+        }
+        if (customElements.get(normalizedTag)) {
+            return;
+        }
+        const SmartElementClass = this.elementFactory.create(componentCtor, options);
+        customElements.define(normalizedTag, SmartElementClass);
+    }
+}
+//# sourceMappingURL=smart-element-registrar.js.map

package/dist/registration/smart-element-registrar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"smart-element-registrar.js","sourceRoot":"","sources":["../../src/registration/smart-element-registrar.ts"],"names":[],"mappings":"AAMA;;;;;;;;GAQG;AACH,MAAM,OAAO,qBAAqB;IACf,cAAc,CAAuB;IAEtD;;;;;;OAMG;IACH,YACE,gBAAkC,EAClC,cAAoC;QAEpC,IAAI,CAAC,gBAAgB;YAAE,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;QACvE,IAAI,CAAC,cAAc;YAAE,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;QAEpE,IAAI,CAAC,cAAc,GAAG,cAAc,CAAC;IACvC,CAAC;IAED;;;;;;;;;;;;;OAaG;IACH,QAAQ,CACN,OAAe,EACf,aAA4C,EAC5C,OAAgC;QAEhC,IAAI,CAAC,OAAO;YAAE,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;QACtD,IAAI,CAAC,aAAa;YAAE,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;QAEzE,MAAM,aAAa,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;QAE5C,IAAI,OAAO,cAAc,KAAK,WAAW,EAAE,CAAC;YAC1C,OAAO;QACT,CAAC;QAED,IAAI,cAAc,CAAC,GAAG,CAAC,aAAa,CAAC,EAAE,CAAC;YACtC,OAAO;QACT,CAAC;QAED,MAAM,iBAAiB,GAAG,IAAI,CAAC,cAAc,CAAC,MAAM,CAClD,aAAa,EACb,OAAO,CACR,CAAC;QACF,cAAc,CAAC,MAAM,CAAC,aAAa,EAAE,iBAAiB,CAAC,CAAC;IAC1D,CAAC;CACF"}

package/dist/registration/smart-tags.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Registers a tag name as a smart component tag.
+ *
+ * @param tagName - HTML tag name to register (e.g. 'my-counter')
+ * @throws Error if tagName is null or undefined
+ */
+export declare function markSmartTag(tagName: string): void;
+/**
+ * Checks whether a tag name is registered as a smart component.
+ *
+ * @param tagName - HTML tag name to check
+ * @throws Error if tagName is null or undefined
+ * @returns true if the tag is a registered smart component
+ */
+export declare function isSmartTag(tagName: string): boolean;
+//# sourceMappingURL=smart-tags.d.ts.map

package/dist/registration/smart-tags.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"smart-tags.d.ts","sourceRoot":"","sources":["../../src/registration/smart-tags.ts"],"names":[],"mappings":"AAOA;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAIlD;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAInD"}

package/dist/registration/smart-tags.js

@@ -0,0 +1,30 @@
+/**
+ * Registry of known smart component tag names.
+ * Used by the template compiler to detect smart elements and route
+ * object values through SmartInputStore.
+ */
+const smartTags = new Set();
+/**
+ * Registers a tag name as a smart component tag.
+ *
+ * @param tagName - HTML tag name to register (e.g. 'my-counter')
+ * @throws Error if tagName is null or undefined
+ */
+export function markSmartTag(tagName) {
+    if (!tagName)
+        throw new Error('tagName is required');
+    smartTags.add(tagName.toLowerCase());
+}
+/**
+ * Checks whether a tag name is registered as a smart component.
+ *
+ * @param tagName - HTML tag name to check
+ * @throws Error if tagName is null or undefined
+ * @returns true if the tag is a registered smart component
+ */
+export function isSmartTag(tagName) {
+    if (!tagName)
+        throw new Error('tagName is required');
+    return smartTags.has(tagName.toLowerCase());
+}
+//# sourceMappingURL=smart-tags.js.map

package/dist/registration/smart-tags.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"smart-tags.js","sourceRoot":"","sources":["../../src/registration/smart-tags.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,SAAS,GAAG,IAAI,GAAG,EAAU,CAAC;AAEpC;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,OAAe;IAC1C,IAAI,CAAC,OAAO;QAAE,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC;IAErD,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;AACvC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,UAAU,CAAC,OAAe;IACxC,IAAI,CAAC,OAAO;QAAE,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC;IAErD,OAAO,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;AAC9C,CAAC"}

package/dist/rendering/bindings/binding-resolver.d.ts

@@ -0,0 +1,90 @@
+import { SmartComponent } from "../../core/smart-component.js";
+import { IExpressionResolver } from "./expression-resolver.interface.js";
+import { IPropertyExtractor } from "./property-extractor.interface.js";
+import { IManagedElementResolver } from "../managed-host/managed-element-resolver.interface.js";
+import { Unsubscribe } from "../../reactive/signal.js";
+import type { IDependencyTracker } from "../../reactive/dependency-tracker.interface.js";
+import type { IObjectRegistry } from "../../utils/object-registry.js";
+/**
+ * Defines the responsibility of managing reactive state bindings in DOM elements.
+ */
+export interface IBindingResolver {
+    /**
+     * Binds reactive state to a DOM element and its children.
+     *
+     * @param element - Root element to bind reactively
+     * @param component - Component instance providing state observables
+     * @param bindingTarget - Target for managing subscriptions (e.g., DomContext)
+     * @throws Error if element or component are null/undefined
+     */
+    bindElement(element: Element, component: SmartComponent, bindingTarget: {
+        addSubscription(subscription: Unsubscribe): void;
+    }): void;
+}
+/**
+ * Implements the responsibility of managing reactive state bindings and subscriptions.
+ */
+export declare class BindingResolver implements IBindingResolver {
+    private readonly expressionResolver;
+    private readonly propertyExtractor;
+    private readonly managedElementResolver;
+    private readonly dependencyTracker;
+    private readonly objectRegistry;
+    /**
+     * Creates a BindingResolver instance.
+     *
+     * @param expressionResolver - Resolver for {{expression}} evaluation
+     * @param propertyExtractor - Extractor for property dependencies from templates
+     * @param managedElementResolver - Resolver for managed element detection
+     * @param dependencyTracker - Tracker for reactive property access discovery
+     * @param objectRegistry - Registry for object reference management
+     */
+    constructor(expressionResolver: IExpressionResolver, propertyExtractor: IPropertyExtractor, managedElementResolver: IManagedElementResolver, dependencyTracker: IDependencyTracker, objectRegistry: IObjectRegistry);
+    /**
+     * Binds reactive state to a DOM element and its children.
+     *
+     * @param element - Element to compile (recursively processes children)
+     * @param component - Component instance for state binding
+     * @param bindingTarget - DOM context for subscription management
+     * @throws Error if element, component, or bindingTarget are null/undefined
+     */
+    bindElement(element: Element, component: SmartComponent, bindingTarget: {
+        addSubscription(subscription: Unsubscribe): void;
+    }): void;
+    /**
+     * Binds attribute value to component state.
+     *
+     * @param attr - Attribute to bind (e.g., class="{{status}}")
+     * @param component - Component instance for property access
+     * @param bindingTarget - DOM context for subscription management
+     */
+    private bindAttribute;
+    /**
+     * Binds text node to component state.
+     *
+     * @param node - Text node to bind (e.g., "Count: {{count}}")
+     * @param component - Component instance for property access
+     * @param bindingTarget - DOM context for subscription management
+     */
+    private bindTextNode;
+    /**
+     * Subscribes to a property's observable, with automatic computed-getter support.
+     *
+     * @description
+     * If the property is a plain getter (not a @Reactive accessor), discovers which
+     * @Reactive properties it reads and subscribes the update callback to those instead.
+     * This enables {{icon}} to update when this.mode changes, even though 'icon' is
+     * a plain getter that derives from the @Reactive 'mode' accessor.
+     *
+     * @param prop - Property name from the template expression
+     * @param component - Component instance
+     * @param bindingTarget - DOM context for subscription management
+     * @param updateCallback - Callback to invoke when the property value changes
+     */
+    private subscribeWithComputedSupport;
+    /**
+     * Walks the prototype chain to find a property descriptor.
+     */
+    private getPropertyDescriptor;
+}
+//# sourceMappingURL=binding-resolver.d.ts.map

package/dist/rendering/bindings/binding-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"binding-resolver.d.ts","sourceRoot":"","sources":["../../../src/rendering/bindings/binding-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AACvE,OAAO,EAAE,uBAAuB,EAAE,MAAM,uDAAuD,CAAC;AAEhG,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gDAAgD,CAAC;AACzF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAEtE;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;;;;;OAOG;IACH,WAAW,CACT,OAAO,EAAE,OAAO,EAChB,SAAS,EAAE,cAAc,EACzB,aAAa,EAAE;QAAE,eAAe,CAAC,YAAY,EAAE,WAAW,GAAG,IAAI,CAAA;KAAE,GAClE,IAAI,CAAC;CACT;AAwBD;;GAEG;AACH,qBAAa,eAAgB,YAAW,gBAAgB;IACtD,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAsB;IACzD,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAqB;IACvD,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAA0B;IACjE,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAqB;IACvD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAkB;IAEjD;;;;;;;;OAQG;gBAED,kBAAkB,EAAE,mBAAmB,EACvC,iBAAiB,EAAE,kBAAkB,EACrC,sBAAsB,EAAE,uBAAuB,EAC/C,iBAAiB,EAAE,kBAAkB,EACrC,cAAc,EAAE,eAAe;IAgBjC;;;;;;;OAOG;IACH,WAAW,CACT,OAAO,EAAE,OAAO,EAChB,SAAS,EAAE,cAAc,EACzB,aAAa,EAAE;QAAE,eAAe,CAAC,YAAY,EAAE,WAAW,GAAG,IAAI,CAAA;KAAE,GAClE,IAAI;IA8BP;;;;;;OAMG;IACH,OAAO,CAAC,aAAa;IAoFrB;;;;;;OAMG;IACH,OAAO,CAAC,YAAY;IA6BpB;;;;;;;;;;;;;OAaG;IACH,OAAO,CAAC,4BAA4B;IAgCpC;;OAEG;IACH,OAAO,CAAC,qBAAqB;CAc9B"}

package/dist/rendering/bindings/binding-resolver.interface.d.ts

@@ -0,0 +1,31 @@
+import { SmartComponent } from '../../core/smart-component.js';
+/**
+ * Defines the responsibility of managing reactive state bindings in DOM elements.
+ *
+ * @description
+ * Defines the contract for managing reactive state bindings in DOM elements,
+ * including attribute and text node bindings with subscription management.
+ */
+export interface IBindingResolver {
+    /**
+     * Binds reactive state to a DOM element and its children.
+     *
+     * @param element - Root element to bind reactively
+     * @param component - Component instance providing state observables
+     * @param bindingTarget - Target for managing subscriptions (e.g., DomContext)
+     * @throws Error if element or component are null/undefined
+     *
+     * @example
+     * ```typescript
+     * bindingResolver.bindElement(
+     *   element,
+     *   component,
+     *   domContext
+     * );
+     * ```
+     */
+    bindElement(element: Element, component: SmartComponent, bindingTarget: {
+        addSubscription(subscription: unknown): void;
+    }): void;
+}
+//# sourceMappingURL=binding-resolver.interface.d.ts.map

package/dist/rendering/bindings/binding-resolver.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"binding-resolver.interface.d.ts","sourceRoot":"","sources":["../../../src/rendering/bindings/binding-resolver.interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAE/D;;;;;;GAMG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;;;;;;;;;;;;;;OAgBG;IACH,WAAW,CACT,OAAO,EAAE,OAAO,EAChB,SAAS,EAAE,cAAc,EACzB,aAAa,EAAE;QAAE,eAAe,CAAC,YAAY,EAAE,OAAO,GAAG,IAAI,CAAA;KAAE,GAC9D,IAAI,CAAC;CACT"}

package/dist/rendering/bindings/binding-resolver.interface.js

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

package/dist/rendering/bindings/binding-resolver.interface.js.map

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