smart-lifecycle 0.1.1

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

@@ -0,0 +1,169 @@
+/**
+ * Implements the responsibility of safely resolving {{template}} expressions to component property values.
+ */
+export class ExpressionResolver {
+    parser;
+    evaluator;
+    scopeCache = new Map();
+    /**
+     * 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, evaluator) {
+        if (!parser)
+            throw new Error("Parser is required");
+        if (!evaluator)
+            throw new Error("Evaluator is required");
+        this.parser = parser;
+        this.evaluator = evaluator;
+    }
+    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);
+            }
+        }
+        catch {
+            // Defensive: skip getter 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",
+        ]);
+        for (const prop of Object.getOwnPropertyNames(component)) {
+            this.tryAddSafeProperty(prop, component, safeProps, BLACKLIST);
+        }
+        while (current && current !== Object.prototype) {
+            for (const prop of Object.getOwnPropertyNames(current)) {
+                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.
+     *
+     * @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 parsed = this.parser.parse(expression);
+            const result = this.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;
+            }
+            catch {
+                // Defensive: skip getter 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]];
+            }
+            catch {
+                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) : "";
+        }
+        catch {
+            return "";
+        }
+    }
+    /**
+     * Clears the internal property whitelist cache.
+     */
+    clearCache() {
+        this.scopeCache.clear();
+    }
+}
+//# sourceMappingURL=expression-resolver.js.map

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

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

package/dist/rendering/bindings/property-extractor.d.ts

@@ -0,0 +1,36 @@
+import { IPropertyExtractor } from "./property-extractor.interface.js";
+import type { IExpressionParser } from "../expression-parser/interfaces.js";
+/**
+ * Implements the responsibility of extracting property dependencies from template expressions.
+ */
+export declare class PropertyExtractor implements IPropertyExtractor {
+    private readonly parser;
+    /**
+     * Initializes a new instance of PropertyExtractor.
+     *
+     * @param parser - Parser for extracting dependencies from complex expressions
+     * @throws Error if parser is null or undefined
+     */
+    constructor(parser: IExpressionParser);
+    /**
+     * Extracts property names from template bindings.
+     *
+     * @param template - Template string with {{bindings}}
+     * @returns Array of unique property names
+     * @throws Error if template is null or undefined
+     *
+     * @example
+     * ```typescript
+     * extract('Count: {{count}}')
+     * // → ['count']
+     *
+     * extract('{{user?.name}} - {{user?.email}}')
+     * // → ['user'] (deduplicated)
+     *
+     * extract('Result: {{x + y * 2}}')
+     * // → ['x', 'y']
+     * ```
+     */
+    extract(template: string): string[];
+}
+//# sourceMappingURL=property-extractor.d.ts.map

package/dist/rendering/bindings/property-extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"property-extractor.d.ts","sourceRoot":"","sources":["../../../src/rendering/bindings/property-extractor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AACvE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AAE5E;;GAEG;AACH,qBAAa,iBAAkB,YAAW,kBAAkB;IAC1D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoB;IAE3C;;;;;OAKG;gBACS,MAAM,EAAE,iBAAiB;IAMrC;;;;;;;;;;;;;;;;;;OAkBG;IACH,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE;CAkCpC"}

package/dist/rendering/bindings/property-extractor.interface.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Defines the responsibility of extracting property dependencies from template expressions.
+ */
+export interface IPropertyExtractor {
+    /**
+     * Extracts property names from template bindings.
+     *
+     * @param template - Template string with {{bindings}}
+     * @returns Array of unique property names
+     * @throws Error if template is null or undefined
+     *
+     * @example
+     * ```typescript
+     * extract('Count: {{count}}') // → ['count']
+     * extract('{{user?.name}} - {{user?.email}}') // → ['user']
+     * extract('{{x + y * 2}}') // → ['x', 'y']
+     * ```
+     */
+    extract(template: string): string[];
+}
+//# sourceMappingURL=property-extractor.interface.d.ts.map

package/dist/rendering/bindings/property-extractor.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"property-extractor.interface.d.ts","sourceRoot":"","sources":["../../../src/rendering/bindings/property-extractor.interface.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;;;;;;;;;;;OAaG;IACH,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;CACrC"}

package/dist/rendering/bindings/property-extractor.interface.js

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

package/dist/rendering/bindings/property-extractor.interface.js.map

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

package/dist/rendering/bindings/property-extractor.js

@@ -0,0 +1,69 @@
+/**
+ * Implements the responsibility of extracting property dependencies from template expressions.
+ */
+export class PropertyExtractor {
+    parser;
+    /**
+     * Initializes a new instance of PropertyExtractor.
+     *
+     * @param parser - Parser for extracting dependencies from complex expressions
+     * @throws Error if parser is null or undefined
+     */
+    constructor(parser) {
+        if (!parser)
+            throw new Error("Parser is required");
+        this.parser = parser;
+    }
+    /**
+     * Extracts property names from template bindings.
+     *
+     * @param template - Template string with {{bindings}}
+     * @returns Array of unique property names
+     * @throws Error if template is null or undefined
+     *
+     * @example
+     * ```typescript
+     * extract('Count: {{count}}')
+     * // → ['count']
+     *
+     * extract('{{user?.name}} - {{user?.email}}')
+     * // → ['user'] (deduplicated)
+     *
+     * extract('Result: {{x + y * 2}}')
+     * // → ['x', 'y']
+     * ```
+     */
+    extract(template) {
+        if (!template)
+            throw new Error("Template is required");
+        const regex = /\{\{([^}]+)\}\}/g;
+        const props = new Set();
+        let match;
+        while ((match = regex.exec(template)) !== null) {
+            const expr = match[1].trim();
+            const needsParsing = /[!+\-*/%<>=&|():?]/.test(expr) || expr.includes("(");
+            if (needsParsing) {
+                try {
+                    const parsed = this.parser.parse(expr);
+                    for (const dep of parsed.dependencies) {
+                        props.add(dep);
+                    }
+                }
+                catch {
+                    const rootProp = expr.split(/[.?]/)[0];
+                    if (rootProp) {
+                        props.add(rootProp);
+                    }
+                }
+            }
+            else {
+                const rootProp = expr.split(/[.?]/)[0];
+                if (rootProp) {
+                    props.add(rootProp);
+                }
+            }
+        }
+        return Array.from(props);
+    }
+}
+//# sourceMappingURL=property-extractor.js.map

package/dist/rendering/bindings/property-extractor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"property-extractor.js","sourceRoot":"","sources":["../../../src/rendering/bindings/property-extractor.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,MAAM,OAAO,iBAAiB;IACX,MAAM,CAAoB;IAE3C;;;;;OAKG;IACH,YAAY,MAAyB;QACnC,IAAI,CAAC,MAAM;YAAE,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC;QAEnD,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED;;;;;;;;;;;;;;;;;;OAkBG;IACH,OAAO,CAAC,QAAgB;QACtB,IAAI,CAAC,QAAQ;YAAE,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;QACvD,MAAM,KAAK,GAAG,kBAAkB,CAAC;QACjC,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;QAChC,IAAI,KAAK,CAAC;QAEV,OAAO,CAAC,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;YAC/C,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;YAE7B,MAAM,YAAY,GAChB,oBAAoB,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;YAExD,IAAI,YAAY,EAAE,CAAC;gBACjB,IAAI,CAAC;oBACH,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;oBACvC,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,YAAY,EAAE,CAAC;wBACtC,KAAK,CAAC,GAAG,CAAC,GAAa,CAAC,CAAC;oBAC3B,CAAC;gBACH,CAAC;gBAAC,MAAM,CAAC;oBACP,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;oBACvC,IAAI,QAAQ,EAAE,CAAC;wBACb,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;oBACtB,CAAC;gBACH,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;gBACvC,IAAI,QAAQ,EAAE,CAAC;oBACb,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;gBACtB,CAAC;YACH,CAAC;QACH,CAAC;QAED,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC3B,CAAC;CACF"}

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

@@ -0,0 +1,29 @@
+import { ValidationRules } from "../../types/interfaces.js";
+import { IRulesResolver } from "./rules-resolver.interface.js";
+/**
+ * Implements the responsibility of resolving validation rules into HTML attributes.
+ */
+export declare class RulesResolver implements IRulesResolver {
+    private static readonly RULES_REGEX;
+    /**
+     * Resolves all [[RULES.field]] bindings in a template string.
+     *
+     * @param template - Template string with [[RULES.field]] bindings
+     * @param rules - Rules registry from component.rules
+     * @param componentName - Component name for error reporting
+     * @returns Template with [[RULES.field]] replaced by HTML attributes
+     *
+     * @example
+     * ```typescript
+     * resolve(
+     *   `<input [[RULES.username]] type="text" />`,
+     *   { username: { required: true, minlength: 3 } },
+     *   'LoginForm'
+     * );
+     * // → `<input required minlength="3" type="text" />`
+     * ```
+     */
+    resolve(template: string, rules: ValidationRules, componentName?: string): string;
+    private convertRulesToAttributes;
+}
+//# sourceMappingURL=rules-resolver.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rules-resolver.d.ts","sourceRoot":"","sources":["../../../src/rendering/bindings/rules-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAE/D;;GAEG;AACH,qBAAa,aAAc,YAAW,cAAc;IAClD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,CACU;IAE7C;;;;;;;;;;;;;;;;;OAiBG;IACH,OAAO,CACL,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,eAAe,EACtB,aAAa,GAAE,MAAkB,GAChC,MAAM;IA0BT,OAAO,CAAC,wBAAwB;CA8BjC"}

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

@@ -0,0 +1,16 @@
+import { ValidationRules } from "../../types/interfaces.js";
+/**
+ * Defines the responsibility of resolving validation rules into HTML attributes.
+ */
+export interface IRulesResolver {
+    /**
+     * Resolves all [[RULES.field]] bindings in a template string.
+     *
+     * @param template - Template string with [[RULES.field]] bindings
+     * @param rules - Rules registry from component.rules
+     * @param componentName - Component name for error reporting
+     * @returns Template with [[RULES.field]] replaced by HTML attributes
+     */
+    resolve(template: string, rules: ValidationRules, componentName: string): string;
+}
+//# sourceMappingURL=rules-resolver.interface.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rules-resolver.interface.d.ts","sourceRoot":"","sources":["../../../src/rendering/bindings/rules-resolver.interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAE5D;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;;;;;;OAOG;IACH,OAAO,CACL,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,eAAe,EACtB,aAAa,EAAE,MAAM,GACpB,MAAM,CAAC;CACX"}

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

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

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

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

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

@@ -0,0 +1,69 @@
+/**
+ * Implements the responsibility of resolving validation rules into HTML attributes.
+ */
+export class RulesResolver {
+    static RULES_REGEX = /\[\[RULES\.([a-zA-Z_][a-zA-Z0-9_]*)\]\]/g;
+    /**
+     * Resolves all [[RULES.field]] bindings in a template string.
+     *
+     * @param template - Template string with [[RULES.field]] bindings
+     * @param rules - Rules registry from component.rules
+     * @param componentName - Component name for error reporting
+     * @returns Template with [[RULES.field]] replaced by HTML attributes
+     *
+     * @example
+     * ```typescript
+     * resolve(
+     *   `<input [[RULES.username]] type="text" />`,
+     *   { username: { required: true, minlength: 3 } },
+     *   'LoginForm'
+     * );
+     * // → `<input required minlength="3" type="text" />`
+     * ```
+     */
+    resolve(template, rules, componentName = "Unknown") {
+        return template.replace(RulesResolver.RULES_REGEX, (match, fieldName) => {
+            try {
+                const ruleSet = rules[fieldName];
+                if (!ruleSet) {
+                    console.warn(`[RulesResolver] Rule not found: "${fieldName}" in component "${componentName}". ` +
+                        `Available rules: ${Object.keys(rules).join(", ") || "none"}`);
+                    return match;
+                }
+                return this.convertRulesToAttributes(ruleSet);
+            }
+            catch (error) {
+                const errorMessage = error instanceof Error ? error.message : String(error);
+                console.error(`[RulesResolver] Error resolving rules for "${fieldName}" in component "${componentName}":`, errorMessage);
+                return match;
+            }
+        });
+    }
+    convertRulesToAttributes(rules) {
+        const attributes = [];
+        if (rules.required) {
+            attributes.push("required");
+        }
+        const quotedAttributes = [
+            "minlength",
+            "maxlength",
+            "pattern",
+            "min",
+            "max",
+            "step",
+            "accept",
+            "autocomplete",
+            "placeholder",
+            "title",
+        ];
+        for (const attr of quotedAttributes) {
+            const value = rules[attr];
+            if (value !== undefined && value !== null) {
+                const escapedValue = String(value).replace(/"/g, "&quot;");
+                attributes.push(`${attr}="${escapedValue}"`);
+            }
+        }
+        return attributes.join(" ");
+    }
+}
+//# sourceMappingURL=rules-resolver.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rules-resolver.js","sourceRoot":"","sources":["../../../src/rendering/bindings/rules-resolver.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,MAAM,OAAO,aAAa;IAChB,MAAM,CAAU,WAAW,GACjC,0CAA0C,CAAC;IAE7C;;;;;;;;;;;;;;;;;OAiBG;IACH,OAAO,CACL,QAAgB,EAChB,KAAsB,EACtB,gBAAwB,SAAS;QAEjC,OAAO,QAAQ,CAAC,OAAO,CAAC,aAAa,CAAC,WAAW,EAAE,CAAC,KAAK,EAAE,SAAS,EAAE,EAAE;YACtE,IAAI,CAAC;gBACH,MAAM,OAAO,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC;gBAEjC,IAAI,CAAC,OAAO,EAAE,CAAC;oBACb,OAAO,CAAC,IAAI,CACV,oCAAoC,SAAS,mBAAmB,aAAa,KAAK;wBAChF,oBAAoB,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,MAAM,EAAE,CAChE,CAAC;oBACF,OAAO,KAAK,CAAC;gBACf,CAAC;gBAED,OAAO,IAAI,CAAC,wBAAwB,CAAC,OAAO,CAAC,CAAC;YAChD,CAAC;YAAC,OAAO,KAAc,EAAE,CAAC;gBACxB,MAAM,YAAY,GAChB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBACzD,OAAO,CAAC,KAAK,CACX,8CAA8C,SAAS,mBAAmB,aAAa,IAAI,EAC3F,YAAY,CACb,CAAC;gBACF,OAAO,KAAK,CAAC;YACf,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,wBAAwB,CAAC,KAA8B;QAC7D,MAAM,UAAU,GAAa,EAAE,CAAC;QAEhC,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;YACnB,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC9B,CAAC;QAED,MAAM,gBAAgB,GAAG;YACvB,WAAW;YACX,WAAW;YACX,SAAS;YACT,KAAK;YACL,KAAK;YACL,MAAM;YACN,QAAQ;YACR,cAAc;YACd,aAAa;YACb,OAAO;SACR,CAAC;QAEF,KAAK,MAAM,IAAI,IAAI,gBAAgB,EAAE,CAAC;YACpC,MAAM,KAAK,GAAI,KAAiC,CAAC,IAAI,CAAC,CAAC;YACvD,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;gBAC1C,MAAM,YAAY,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;gBAC3D,UAAU,CAAC,IAAI,CAAC,GAAG,IAAI,KAAK,YAAY,GAAG,CAAC,CAAC;YAC/C,CAAC;QACH,CAAC;QAED,OAAO,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC9B,CAAC"}

package/dist/rendering/bindings/smart-input-store.d.ts

@@ -0,0 +1,11 @@
+import type { ISmartInputStore } from './smart-input-store.interface.js';
+/**
+ * Implements the responsibility of managing smart input element mappings using WeakMap.
+ *
+ * @description
+ * Provides a memory-efficient way to store mappings between DOM elements and their
+ * associated smart input identifiers. Uses WeakMap to allow garbage collection
+ * when elements are removed from the DOM.
+ */
+export declare const SmartInputStore: ISmartInputStore;
+//# sourceMappingURL=smart-input-store.d.ts.map

package/dist/rendering/bindings/smart-input-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"smart-input-store.d.ts","sourceRoot":"","sources":["../../../src/rendering/bindings/smart-input-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAIzE;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,EAAE,gBAuF7B,CAAC"}

package/dist/rendering/bindings/smart-input-store.interface.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Defines the responsibility of storing and retrieving smart input element mappings.
+ */
+export interface ISmartInputStore {
+    /**
+     * Stores a mapping between an element, input name, and unique ID.
+     *
+     * @param el - The element to store the mapping for
+     * @param name - The input name
+     * @param id - The unique identifier
+     * @throws Error if any parameter is null or undefined
+     *
+     * @example
+     * ```typescript
+     * store.set(element, 'username', 'input-123');
+     * ```
+     */
+    set(el: Element, name: string, id: string): void;
+    /**
+     * Retrieves the ID for a given element and input name.
+     *
+     * @param el - The element to retrieve the mapping for
+     * @param name - The input name
+     * @returns The stored ID, or undefined if not found
+     * @throws Error if parameters are null or undefined
+     *
+     * @example
+     * ```typescript
+     * const id = store.get(element, 'username');
+     * if (id) {
+     *   console.log(`Found ID: ${id}`);
+     * }
+     * ```
+     */
+    get(el: Element, name: string): string | undefined;
+    /**
+     * Removes the mapping for a given element and input name.
+     *
+     * @param el - The element to remove the mapping from
+     * @param name - The input name
+     * @throws Error if parameters are null or undefined
+     *
+     * @example
+     * ```typescript
+     * store.delete(element, 'username');
+     * ```
+     */
+    delete(el: Element, name: string): void;
+}
+/**
+ * Token for registering the SmartInputStore in the service provider.
+ */
+export declare const SmartInputStoreToken: "SmartInputStore";
+//# sourceMappingURL=smart-input-store.interface.d.ts.map

package/dist/rendering/bindings/smart-input-store.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"smart-input-store.interface.d.ts","sourceRoot":"","sources":["../../../src/rendering/bindings/smart-input-store.interface.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;;;;;;;;;;OAYG;IACH,GAAG,CAAC,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAEjD;;;;;;;;;;;;;;;OAeG;IACH,GAAG,CAAC,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IAEnD;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CACzC;AAED;;GAEG;AACH,eAAO,MAAM,oBAAoB,EAAG,iBAA0B,CAAC"}

package/dist/rendering/bindings/smart-input-store.interface.js

@@ -0,0 +1,5 @@
+/**
+ * Token for registering the SmartInputStore in the service provider.
+ */
+export const SmartInputStoreToken = 'SmartInputStore';
+//# sourceMappingURL=smart-input-store.interface.js.map

package/dist/rendering/bindings/smart-input-store.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"smart-input-store.interface.js","sourceRoot":"","sources":["../../../src/rendering/bindings/smart-input-store.interface.ts"],"names":[],"mappings":"AAoDA;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,iBAA0B,CAAC"}

package/dist/rendering/bindings/smart-input-store.js

@@ -0,0 +1,92 @@
+const store = new WeakMap();
+/**
+ * Implements the responsibility of managing smart input element mappings using WeakMap.
+ *
+ * @description
+ * Provides a memory-efficient way to store mappings between DOM elements and their
+ * associated smart input identifiers. Uses WeakMap to allow garbage collection
+ * when elements are removed from the DOM.
+ */
+export const SmartInputStore = {
+    /**
+     * Stores a mapping between an element, input name, and unique ID.
+     *
+     * @param el - The element to store the mapping for
+     * @param name - The input name
+     * @param id - The unique identifier
+     * @throws Error if any parameter is null or undefined
+     *
+     * @example
+     * ```typescript
+     * SmartInputStore.set(element, 'username', 'input-123');
+     * ```
+     */
+    set(el, name, id) {
+        if (!el) {
+            throw new Error('Element is required');
+        }
+        if (!name) {
+            throw new Error('Name is required');
+        }
+        if (!id) {
+            throw new Error('ID is required');
+        }
+        const entry = store.get(el) ?? new Map();
+        if (!store.has(el)) {
+            store.set(el, entry);
+        }
+        entry.set(name, id);
+    },
+    /**
+     * Retrieves the ID for a given element and input name.
+     *
+     * @param el - The element to retrieve the mapping for
+     * @param name - The input name
+     * @returns The stored ID, or undefined if not found
+     * @throws Error if parameters are null or undefined
+     *
+     * @example
+     * ```typescript
+     * const id = SmartInputStore.get(element, 'username');
+     * ```
+     */
+    get(el, name) {
+        if (!el) {
+            throw new Error('Element is required');
+        }
+        if (!name) {
+            throw new Error('Name is required');
+        }
+        const entry = store.get(el);
+        return entry?.get(name);
+    },
+    /**
+     * Removes the mapping for a given element and input name.
+     *
+     * @param el - The element to remove the mapping from
+     * @param name - The input name
+     * @throws Error if parameters are null or undefined
+     *
+     * @example
+     * ```typescript
+     * SmartInputStore.delete(element, 'username');
+     * ```
+     */
+    delete(el, name) {
+        if (!el) {
+            throw new Error('Element is required');
+        }
+        if (!name) {
+            throw new Error('Name is required');
+        }
+        const entry = store.get(el);
+        if (!entry) {
+            return;
+        }
+        entry.delete(name);
+        if (entry.size === 0) {
+            store.delete(el);
+        }
+    }
+};
+//# sourceMappingURL=smart-input-store.js.map

package/dist/rendering/bindings/smart-input-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"smart-input-store.js","sourceRoot":"","sources":["../../../src/rendering/bindings/smart-input-store.ts"],"names":[],"mappings":"AAEA,MAAM,KAAK,GAAG,IAAI,OAAO,EAAgC,CAAC;AAE1D;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,eAAe,GAAqB;IAC/C;;;;;;;;;;;;OAYG;IACH,GAAG,CAAC,EAAW,EAAE,IAAY,EAAE,EAAU;QACvC,IAAI,CAAC,EAAE,EAAE,CAAC;YACR,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC;QACzC,CAAC;QACD,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,IAAI,KAAK,CAAC,kBAAkB,CAAC,CAAC;QACtC,CAAC;QACD,IAAI,CAAC,EAAE,EAAE,CAAC;YACR,MAAM,IAAI,KAAK,CAAC,gBAAgB,CAAC,CAAC;QACpC,CAAC;QAED,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,IAAI,GAAG,EAAkB,CAAC;QACzD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;YACnB,KAAK,CAAC,GAAG,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;QACvB,CAAC;QACD,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IACtB,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,GAAG,CAAC,EAAW,EAAE,IAAY;QAC3B,IAAI,CAAC,EAAE,EAAE,CAAC;YACR,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC;QACzC,CAAC;QACD,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,IAAI,KAAK,CAAC,kBAAkB,CAAC,CAAC;QACtC,CAAC;QAED,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC5B,OAAO,KAAK,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,EAAW,EAAE,IAAY;QAC9B,IAAI,CAAC,EAAE,EAAE,CAAC;YACR,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC;QACzC,CAAC;QACD,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,IAAI,KAAK,CAAC,kBAAkB,CAAC,CAAC;QACtC,CAAC;QAED,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC5B,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO;QACT,CAAC;QAED,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACnB,IAAI,KAAK,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;YACrB,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACnB,CAAC;IACH,CAAC;CACF,CAAC"}