smart-lifecycle 0.1.1

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

@@ -0,0 +1,232 @@
+import { NodeType } from "../dom/node-types.js";
+/**
+ * Defines the set of HTML boolean attributes whose presence (not value) determines state.
+ * For these attributes, the binding resolver toggles attribute presence
+ * and syncs the corresponding DOM property instead of setting a string value.
+ */
+const BOOLEAN_ATTRIBUTES = new Set([
+    "checked",
+    "disabled",
+    "selected",
+    "readonly",
+    "required",
+    "hidden",
+    "multiple",
+    "open",
+    "autofocus",
+    "autoplay",
+    "controls",
+    "loop",
+    "muted",
+    "novalidate",
+]);
+/**
+ * Implements the responsibility of managing reactive state bindings and subscriptions.
+ */
+export class BindingResolver {
+    expressionResolver;
+    propertyExtractor;
+    managedElementResolver;
+    dependencyTracker;
+    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, propertyExtractor, managedElementResolver, dependencyTracker, objectRegistry) {
+        if (!expressionResolver)
+            throw new Error("ExpressionResolver is required");
+        if (!propertyExtractor)
+            throw new Error("PropertyExtractor is required");
+        if (!managedElementResolver)
+            throw new Error("ManagedElementResolver is required");
+        if (!dependencyTracker)
+            throw new Error("DependencyTracker is required");
+        if (!objectRegistry)
+            throw new Error("ObjectRegistry is required");
+        this.expressionResolver = expressionResolver;
+        this.propertyExtractor = propertyExtractor;
+        this.managedElementResolver = managedElementResolver;
+        this.dependencyTracker = dependencyTracker;
+        this.objectRegistry = objectRegistry;
+    }
+    /**
+     * 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, component, bindingTarget) {
+        if (!element)
+            throw new Error("Element is required");
+        if (!component)
+            throw new Error("Component is required");
+        if (!bindingTarget)
+            throw new Error("Binding target is required");
+        for (const attr of Array.from(element.attributes)) {
+            if (attr.value && attr.value.includes("{{")) {
+                this.bindAttribute(attr, component, bindingTarget);
+            }
+        }
+        if (this.managedElementResolver.isManagedElement(element)) {
+            return;
+        }
+        for (const child of Array.from(element.children)) {
+            this.bindElement(child, component, bindingTarget);
+        }
+        for (const node of Array.from(element.childNodes)) {
+            if (node.nodeType === NodeType.TEXT_NODE &&
+                node.textContent &&
+                node.textContent.includes("{{")) {
+                this.bindTextNode(node, component, bindingTarget);
+            }
+        }
+    }
+    /**
+     * 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
+     */
+    bindAttribute(attr, component, bindingTarget) {
+        const originalValue = attr.value;
+        const attrName = attr.name;
+        const ownerElement = attr.ownerElement;
+        const usedProps = this.propertyExtractor.extract(originalValue);
+        if (usedProps.length === 0)
+            return;
+        if (!ownerElement)
+            return;
+        const isBooleanAttr = BOOLEAN_ATTRIBUTES.has(attrName);
+        const updateAttr = () => {
+            const isSimpleBinding = /^\{\{\s*[\w$.]+\s*\}\}$/.test(originalValue);
+            if (isSimpleBinding && usedProps.length === 1) {
+                // Extract full dotted path from the expression (not just root property from usedProps)
+                // e.g. "{{$item.items}}" → fullPath = "$item.items", parts = ["$item", "items"]
+                const exprMatch = /^\{\{\s*([\w$.]+)\s*\}\}$/.exec(originalValue);
+                const fullPath = exprMatch ? exprMatch[1] : usedProps[0];
+                let value = component;
+                const parts = fullPath.split(".");
+                let valid = true;
+                for (const part of parts) {
+                    if (value === null || value === undefined) {
+                        valid = false;
+                        break;
+                    }
+                    value = value[part];
+                }
+                if (valid &&
+                    value !== null &&
+                    value !== undefined &&
+                    (Array.isArray(value) || typeof value === "object")) {
+                    const objectId = this.objectRegistry.set(value);
+                    ownerElement.setAttribute(attrName, objectId);
+                    return;
+                }
+            }
+            const resolved = this.expressionResolver.resolve(originalValue, component);
+            if (isBooleanAttr) {
+                const isTruthy = resolved !== "" &&
+                    resolved !== "false" &&
+                    resolved !== "null" &&
+                    resolved !== "undefined";
+                if (isTruthy) {
+                    ownerElement.setAttribute(attrName, "");
+                }
+                else {
+                    ownerElement.removeAttribute(attrName);
+                }
+                if (attrName in ownerElement) {
+                    ownerElement[attrName] =
+                        isTruthy;
+                }
+            }
+            else {
+                ownerElement.setAttribute(attrName, resolved);
+            }
+        };
+        updateAttr();
+        for (const prop of usedProps) {
+            this.subscribeWithComputedSupport(prop, component, bindingTarget, updateAttr);
+        }
+    }
+    /**
+     * 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
+     */
+    bindTextNode(node, component, bindingTarget) {
+        const originalText = node.textContent || "";
+        const usedProps = this.propertyExtractor.extract(originalText);
+        if (usedProps.length === 0)
+            return;
+        const updateText = () => {
+            node.textContent = this.expressionResolver.resolve(originalText, component);
+        };
+        updateText();
+        for (const prop of usedProps) {
+            this.subscribeWithComputedSupport(prop, component, bindingTarget, updateText);
+        }
+    }
+    /**
+     * 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
+     */
+    subscribeWithComputedSupport(prop, component, bindingTarget, updateCallback) {
+        const descriptor = this.getPropertyDescriptor(component, prop);
+        const isPlainGetter = descriptor !== undefined &&
+            typeof descriptor.get === "function" &&
+            descriptor.set === undefined;
+        if (isPlainGetter) {
+            const reactiveDeps = this.dependencyTracker.discoverDependencies(() => {
+                void component[prop];
+            });
+            if (reactiveDeps.length > 0) {
+                for (const dep of reactiveDeps) {
+                    const depObs = component.getPropertyObservable(dep);
+                    const unsubscribe = depObs.subscribe(updateCallback);
+                    bindingTarget.addSubscription(unsubscribe);
+                }
+                return;
+            }
+        }
+        const propertyObs = component.getPropertyObservable(prop);
+        const unsubscribe = propertyObs.subscribe(updateCallback);
+        bindingTarget.addSubscription(unsubscribe);
+    }
+    /**
+     * Walks the prototype chain to find a property descriptor.
+     */
+    getPropertyDescriptor(obj, prop) {
+        let current = obj;
+        while (current) {
+            const descriptor = Object.getOwnPropertyDescriptor(current, prop);
+            if (descriptor) {
+                return descriptor;
+            }
+            current = Object.getPrototypeOf(current);
+        }
+        return undefined;
+    }
+}
+//# sourceMappingURL=binding-resolver.js.map

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

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

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

@@ -0,0 +1,55 @@
+import { SmartComponent } from "../../core/smart-component.js";
+import { IExpressionResolver } from "./expresion-resolver.interface.js";
+import { ExpressionParserFactory } from "../expression-parser/index.js";
+/**
+ * Implements the responsibility of safely resolving {{template}} expressions to component property values.
+ *
+ * Enforces whitelist-based access control to prevent exposure of internal/private properties.
+ * Caches property whitelists per component constructor for performance optimization.
+ */
+export declare class ExpressionResolver implements IExpressionResolver {
+    private readonly parserFactory;
+    private readonly scopeCache;
+    /**
+     * Initializes the expression resolver with an optional parser factory.
+     *
+     * @param parserFactory - Parser factory for evaluating complex expressions. If not provided, uses default factory.
+     * @throws Error if parser factory initialization fails
+     */
+    constructor(parserFactory?: ExpressionParserFactory);
+    private tryAddSafeProperty;
+    private getSafeProperties;
+    /**
+     * Resolves {{bindings}} in a string using component properties.
+     *
+     * Replaces all {{propertyName}} expressions with component property values.
+     * Only exposes whitelisted properties to prevent access to internal data.
+     * Supports simple properties, dot notation, and complex expressions.
+     *
+     * @param template - String with {{bindings}} to resolve
+     * @param component - Component instance providing property values
+     * @returns Resolved string with all expressions replaced by their values
+     * @throws Error if template or component is not provided
+     *
+     * @example
+     * ```typescript
+     * component.count = 42;
+     * resolver.resolve('Count: {{count}}', component); // "Count: 42"
+     * resolver.resolve('Result: {{count + 1}}', component); // "Result: 43"
+     * ```
+     */
+    resolve(template: string, component: SmartComponent): string;
+    private resolveExpression;
+    private requiresParsing;
+    private resolveParsedExpression;
+    private buildScopeFromSafeProps;
+    private resolveNestedProperty;
+    private resolveDirectProperty;
+    /**
+     * Clears the internal property whitelist cache.
+     *
+     * Call this when component prototypes change or after structural updates.
+     */
+    clearCache(): void;
+}
+//# sourceMappingURL=expresion-resolver.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"expresion-resolver.d.ts","sourceRoot":"","sources":["../../../src/rendering/bindings/expresion-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AACxE,OAAO,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AAExE;;;;;GAKG;AACH,qBAAa,kBAAmB,YAAW,mBAAmB;IAC5D,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA0B;IACxD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAkC;IAE7D;;;;;OAKG;gBACS,aAAa,CAAC,EAAE,uBAAuB;IASnD,OAAO,CAAC,kBAAkB;IAe1B,OAAO,CAAC,iBAAiB;IAwBzB;;;;;;;;;;;;;;;;;;OAkBG;IACH,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,cAAc,GAAG,MAAM;IAY5D,OAAO,CAAC,iBAAiB;IAYzB,OAAO,CAAC,eAAe;IAIvB,OAAO,CAAC,uBAAuB;IAe/B,OAAO,CAAC,uBAAuB;IAgB/B,OAAO,CAAC,qBAAqB;IA2B7B,OAAO,CAAC,qBAAqB;IAc7B;;;;OAIG;IACH,UAAU,IAAI,IAAI;CAGnB"}

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

@@ -0,0 +1,25 @@
+import { SmartComponent } from "../../core/smart-component";
+/**
+ * Defines the responsibility of resolving template expressions using component properties.
+ */
+export interface IExpressionResolver {
+    /**
+     * Resolves a binding expression to its current value.
+     *
+     * @param expression - Template expression with {{bindings}}
+     * @param component - Component instance for property access
+     * @returns Resolved string value
+     * @throws Error if expression or component are null/undefined
+     *
+     * @example
+     * ```typescript
+     * const result = expressionResolver.resolve(
+     *   'Hello {{name}}!',
+     *   component
+     * );
+     * // Returns: "Hello World!" if component.name = "World"
+     * ```
+     */
+    resolve(expression: string, component: SmartComponent): string;
+}
+//# sourceMappingURL=expresion-resolver.interface.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"expresion-resolver.interface.d.ts","sourceRoot":"","sources":["../../../src/rendering/bindings/expresion-resolver.interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAE5D;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;;;;;;;;;;;;;;OAgBG;IACH,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,cAAc,GAAG,MAAM,CAAC;CAChE"}

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

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

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

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

package/dist/rendering/bindings/expresion-resolver.js

@@ -0,0 +1,175 @@
+import { ExpressionParserFactory } from "../expression-parser/index.js";
+/**
+ * Implements the responsibility of safely resolving {{template}} expressions to component property values.
+ *
+ * Enforces whitelist-based access control to prevent exposure of internal/private properties.
+ * Caches property whitelists per component constructor for performance optimization.
+ */
+export class ExpressionResolver {
+    parserFactory;
+    scopeCache = new Map();
+    /**
+     * Initializes the expression resolver with an optional parser factory.
+     *
+     * @param parserFactory - Parser factory for evaluating complex expressions. If not provided, uses default factory.
+     * @throws Error if parser factory initialization fails
+     */
+    constructor(parserFactory) {
+        try {
+            this.parserFactory = parserFactory || new ExpressionParserFactory();
+        }
+        catch (error) {
+            const errorMsg = error instanceof Error ? error.message : String(error);
+            throw new Error(`[ExpressionResolver] Failed to initialize parser factory: ${errorMsg}`);
+        }
+    }
+    tryAddSafeProperty(prop, component, safeProps, blacklist) {
+        if (prop.startsWith('_'))
+            return;
+        if (blacklist.has(prop))
+            return;
+        try {
+            const value = component[prop];
+            if (typeof value !== 'function') {
+                safeProps.add(prop);
+            }
+            // eslint-disable-next-line @typescript-eslint/no-unused-vars
+        }
+        catch (_e) {
+            // Skip properties that throw on access
+        }
+    }
+    getSafeProperties(component) {
+        if (!component) {
+            throw new Error('[ExpressionResolver] Component is required for property whitelisting');
+        }
+        const constructorName = component.constructor.name;
+        if (this.scopeCache.has(constructorName)) {
+            return this.scopeCache.get(constructorName);
+        }
+        const safeProps = new Set();
+        let current = Object.getPrototypeOf(component);
+        const BLACKLIST = new Set(['constructor', 'onDestroy', 'onInit', 'onRenderComplete']);
+        Object.getOwnPropertyNames(component).forEach(prop => this.tryAddSafeProperty(prop, component, safeProps, BLACKLIST));
+        while (current && current !== Object.prototype) {
+            Object.getOwnPropertyNames(current).forEach(prop => this.tryAddSafeProperty(prop, component, safeProps, BLACKLIST));
+            current = Object.getPrototypeOf(current);
+        }
+        this.scopeCache.set(constructorName, safeProps);
+        return safeProps;
+    }
+    /**
+     * Resolves {{bindings}} in a string using component properties.
+     *
+     * Replaces all {{propertyName}} expressions with component property values.
+     * Only exposes whitelisted properties to prevent access to internal data.
+     * Supports simple properties, dot notation, and complex expressions.
+     *
+     * @param template - String with {{bindings}} to resolve
+     * @param component - Component instance providing property values
+     * @returns Resolved string with all expressions replaced by their values
+     * @throws Error if template or component is not provided
+     *
+     * @example
+     * ```typescript
+     * component.count = 42;
+     * resolver.resolve('Count: {{count}}', component); // "Count: 42"
+     * resolver.resolve('Result: {{count + 1}}', component); // "Result: 43"
+     * ```
+     */
+    resolve(template, component) {
+        if (!template) {
+            throw new Error('[ExpressionResolver] Template is required');
+        }
+        if (!component) {
+            throw new Error('[ExpressionResolver] Component is required');
+        }
+        const safeProps = this.getSafeProperties(component);
+        return template.replace(/\{\{([^}]+)\}\}/g, (_, expr) => this.resolveExpression(expr.trim(), component, safeProps));
+    }
+    resolveExpression(expression, component, safeProps) {
+        if (this.requiresParsing(expression)) {
+            return this.resolveParsedExpression(expression, component, safeProps);
+        }
+        if (expression.includes('.')) {
+            return this.resolveNestedProperty(expression, component, safeProps);
+        }
+        return this.resolveDirectProperty(expression, component, safeProps);
+    }
+    requiresParsing(expression) {
+        return /[!+\-*/%<>=&|()?]/.test(expression) || expression.includes('(');
+    }
+    resolveParsedExpression(expression, component, safeProps) {
+        try {
+            const scope = this.buildScopeFromSafeProps(component, safeProps);
+            const service = this.parserFactory.createParserService();
+            const evaluator = this.parserFactory.createEvaluator();
+            const parsed = service.parse(expression);
+            const result = evaluator.evaluate(parsed.ast, scope);
+            return result !== null && result !== undefined ? String(result) : '';
+        }
+        catch (error) {
+            const errorMsg = error instanceof Error ? error.message : String(error);
+            console.warn(`[ExpressionResolver] Expression evaluation error: ${errorMsg} in "${expression}"`);
+            return '';
+        }
+    }
+    buildScopeFromSafeProps(component, safeProps) {
+        const scope = {};
+        for (const prop of safeProps) {
+            try {
+                const value = component[prop];
+                scope[prop] = value;
+                // eslint-disable-next-line @typescript-eslint/no-unused-vars
+            }
+            catch (_e) {
+                // Skip properties that throw on access
+            }
+        }
+        return scope;
+    }
+    resolveNestedProperty(expression, component, safeProps) {
+        const parts = expression.split('.');
+        const rootProp = parts[0];
+        if (!safeProps.has(rootProp)) {
+            console.warn(`[ExpressionResolver] Accessing non-whitelisted property "${rootProp}" in expression "${expression}"`);
+            return '';
+        }
+        let current = component[rootProp];
+        for (let i = 1; i < parts.length; i++) {
+            if (current === null || current === undefined) {
+                return '';
+            }
+            try {
+                current = current[parts[i]];
+                // eslint-disable-next-line @typescript-eslint/no-unused-vars
+            }
+            catch (_e) {
+                return '';
+            }
+        }
+        return current !== undefined && current !== null ? String(current) : '';
+    }
+    resolveDirectProperty(expression, component, safeProps) {
+        if (!safeProps.has(expression)) {
+            return '';
+        }
+        try {
+            const value = component[expression];
+            return value !== null && value !== undefined ? String(value) : '';
+            // eslint-disable-next-line @typescript-eslint/no-unused-vars
+        }
+        catch (_e) {
+            return '';
+        }
+    }
+    /**
+     * Clears the internal property whitelist cache.
+     *
+     * Call this when component prototypes change or after structural updates.
+     */
+    clearCache() {
+        this.scopeCache.clear();
+    }
+}
+//# sourceMappingURL=expresion-resolver.js.map

package/dist/rendering/bindings/expresion-resolver.js.map

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

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

@@ -0,0 +1,48 @@
+import { SmartComponent } from "../../core/smart-component.js";
+import { IExpressionResolver } from "./expression-resolver.interface.js";
+import type { IExpressionParser, IEvaluator } from "../expression-parser/interfaces.js";
+/**
+ * Implements the responsibility of safely resolving {{template}} expressions to component property values.
+ */
+export declare class ExpressionResolver implements IExpressionResolver {
+    private readonly parser;
+    private readonly evaluator;
+    private readonly scopeCache;
+    /**
+     * Initializes the expression resolver with a parser and evaluator.
+     *
+     * @param parser - Parser for complex expression analysis
+     * @param evaluator - Evaluator for executing parsed AST expressions
+     * @throws Error if parser or evaluator is null or undefined
+     */
+    constructor(parser: IExpressionParser, evaluator: IEvaluator);
+    private tryAddSafeProperty;
+    private getSafeProperties;
+    /**
+     * Resolves {{bindings}} in a string using component properties.
+     *
+     * @param template - String with {{bindings}} to resolve
+     * @param component - Component instance providing property values
+     * @returns Resolved string with all expressions replaced by their values
+     * @throws Error if template or component is not provided
+     *
+     * @example
+     * ```typescript
+     * component.count = 42;
+     * resolver.resolve('Count: {{count}}', component); // "Count: 42"
+     * resolver.resolve('Result: {{count + 1}}', component); // "Result: 43"
+     * ```
+     */
+    resolve(template: string, component: SmartComponent): string;
+    private resolveExpression;
+    private requiresParsing;
+    private resolveParsedExpression;
+    private buildScopeFromSafeProps;
+    private resolveNestedProperty;
+    private resolveDirectProperty;
+    /**
+     * Clears the internal property whitelist cache.
+     */
+    clearCache(): void;
+}
+//# sourceMappingURL=expression-resolver.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"expression-resolver.d.ts","sourceRoot":"","sources":["../../../src/rendering/bindings/expression-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,KAAK,EACV,iBAAiB,EACjB,UAAU,EACX,MAAM,oCAAoC,CAAC;AAE5C;;GAEG;AACH,qBAAa,kBAAmB,YAAW,mBAAmB;IAC5D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoB;IAC3C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAa;IACvC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAkC;IAE7D;;;;;;OAMG;gBACS,MAAM,EAAE,iBAAiB,EAAE,SAAS,EAAE,UAAU;IAQ5D,OAAO,CAAC,kBAAkB;IAmB1B,OAAO,CAAC,iBAAiB;IAmCzB;;;;;;;;;;;;;;OAcG;IACH,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,cAAc,GAAG,MAAM;IAc5D,OAAO,CAAC,iBAAiB;IAgBzB,OAAO,CAAC,eAAe;IAIvB,OAAO,CAAC,uBAAuB;IAmB/B,OAAO,CAAC,uBAAuB;IAkB/B,OAAO,CAAC,qBAAqB;IAkC7B,OAAO,CAAC,qBAAqB;IAmB7B;;OAEG;IACH,UAAU,IAAI,IAAI;CAGnB"}

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

@@ -0,0 +1,25 @@
+import { SmartComponent } from "../../core/smart-component.js";
+/**
+ * Defines the responsibility of resolving template expressions using component properties.
+ */
+export interface IExpressionResolver {
+    /**
+     * Resolves a binding expression to its current value.
+     *
+     * @param expression - Template expression with {{bindings}}
+     * @param component - Component instance for property access
+     * @returns Resolved string value
+     * @throws Error if expression or component are null/undefined
+     *
+     * @example
+     * ```typescript
+     * const result = expressionResolver.resolve(
+     *   'Hello {{name}}!',
+     *   component
+     * );
+     * // Returns: "Hello World!" if component.name = "World"
+     * ```
+     */
+    resolve(expression: string, component: SmartComponent): string;
+}
+//# sourceMappingURL=expression-resolver.interface.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"expression-resolver.interface.d.ts","sourceRoot":"","sources":["../../../src/rendering/bindings/expression-resolver.interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAE/D;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;;;;;;;;;;;;;;OAgBG;IACH,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,cAAc,GAAG,MAAM,CAAC;CAChE"}

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

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

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

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