smart-lifecycle 0.1.1

package/dist/rendering/errors/error-render-options.interface.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Defines the responsibility of carrying error rendering options.
+ *
+ * @description
+ * Encapsulates optional data required by `ErrorRenderer` to display a custom
+ * error overlay, including an HTML template and static constants for
+ * preprocessing.
+ *
+ * @example
+ * ```typescript
+ * const options: ErrorRenderOptions = {
+ *   errorTemplate: '<div class="error">{{message}}</div>',
+ *   constants: { Styles: { ERROR: 'error' } }
+ * };
+ * ```
+ */
+export interface ErrorRenderOptions {
+    /**
+     * Optional HTML template used to render the error overlay. Supports
+     * `{{message}}` placeholder, which will be replaced by the final error message.
+     */
+    errorTemplate?: string;
+    /**
+     * Optional constants object used by the static binding resolver to preprocess
+     * template placeholders like `[[Styles.ERROR]]`.
+     */
+    constants?: Record<string, unknown>;
+}
+//# sourceMappingURL=error-render-options.interface.d.ts.map

package/dist/rendering/errors/error-render-options.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-render-options.interface.d.ts","sourceRoot":"","sources":["../../../src/rendering/errors/error-render-options.interface.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrC"}

package/dist/rendering/errors/error-render-options.interface.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=error-render-options.interface.js.map

package/dist/rendering/errors/error-render-options.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-render-options.interface.js","sourceRoot":"","sources":["../../../src/rendering/errors/error-render-options.interface.ts"],"names":[],"mappings":""}

package/dist/rendering/errors/error-renderer.d.ts

@@ -0,0 +1,71 @@
+import { IErrorRenderer } from './error-renderer.interface.js';
+import { IDomContext } from '../dom-context/dom-context.interface.js';
+import { IDomAdapter } from '../dom/dom-adapter.interface.js';
+import type { ErrorRenderOptions } from './error-render-options.interface.js';
+/**
+ * Implements the responsibility of rendering error states and overlays.
+ *
+ * @description
+ * Handles the rendering of error states when component rendering fails.
+ * Supports custom error templates from component metadata and provides
+ * a coherent fallback error overlay without hardcoded styles.
+ *
+ * @architecture
+ * Error Display Priority:
+ * 1. Custom error template: @SmartRender({ errorTemplate: '...' })
+ * 2. Fallback overlay: Simple HTML structure with message
+ */
+export declare class ErrorRenderer implements IErrorRenderer {
+    private readonly domAdapter;
+    /**
+     * Initializes a new instance of ErrorRenderer.
+     *
+     * @param domAdapter - Adapter for DOM element creation
+     * @throws Error if domAdapter is null or undefined
+     */
+    constructor(domAdapter: IDomAdapter);
+    /**
+     * Renders an error overlay in the DOM context
+     *
+     * @description
+     * Displays error message by either using custom error template from metadata
+     * or showing a simple fallback overlay. Preprocesses constants in custom templates.
+     *
+     * @param domContext - DOM context for managing the error display
+     * @param errorMessage - Error message to display
+     * @param componentId - Component identifier for custom error template lookup
+     *
+     * @example
+     * ```typescript
+     * // Custom error template with constants
+     * @SmartRender({
+     *   selector: 'my-component',
+     *   constants: { Styles: { ERROR: 'error-overlay' } },
+     *   errorTemplate: `<div class="[[Styles.ERROR]]">{{message}}</div>`
+     * })
+     *
+     * // Fallback: Simple structure without styles
+     * <div><div>⚠️</div><div>Error message</div></div>
+     * ```
+     */
+    render(domContext: IDomContext, errorMessage: string, options?: ErrorRenderOptions): Promise<void>;
+    private tryRenderCustomErrorTemplate;
+    private renderCustomErrorTemplate;
+    private renderDefaultErrorOverlay;
+    /**
+     * Safely replaces text placeholders in DOM tree to prevent XSS.
+     *
+     * @param element - Root element to search
+     * @param placeholder - Placeholder text to find
+     * @param value - Safe text value to insert
+     */
+    private replaceTextPlaceholder;
+    /**
+     * Recursively walks all text nodes in an element.
+     *
+     * @param node - Node to start walking from
+     * @param callback - Function to call for each text node
+     */
+    private walkTextNodes;
+}
+//# sourceMappingURL=error-renderer.d.ts.map

package/dist/rendering/errors/error-renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-renderer.d.ts","sourceRoot":"","sources":["../../../src/rendering/errors/error-renderer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAkB,MAAM,yCAAyC,CAAC;AACtF,OAAO,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAC9D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AAG9E;;;;;;;;;;;;GAYG;AACH,qBAAa,aAAc,YAAW,cAAc;IAOtC,OAAO,CAAC,QAAQ,CAAC,UAAU;IANvC;;;;;OAKG;gBAC0B,UAAU,EAAE,WAAW;IAGpD;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACG,MAAM,CACV,UAAU,EAAE,WAAW,EACvB,YAAY,EAAE,MAAM,EACpB,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,IAAI,CAAC;YAWF,4BAA4B;YAU5B,yBAAyB;IAyBvC,OAAO,CAAC,yBAAyB;IAkBjC;;;;;;OAMG;IACH,OAAO,CAAC,sBAAsB;IAQ9B;;;;;OAKG;IACH,OAAO,CAAC,aAAa;CAQtB"}

package/dist/rendering/errors/error-renderer.interface.d.ts

@@ -0,0 +1,29 @@
+import { IDomContext } from '../dom-context/dom-context.interface.js';
+import type { ErrorRenderOptions } from './error-render-options.interface.js';
+/**
+ * Defines the responsibility of rendering error states and overlays.
+ *
+ * @description
+ * Defines the contract for rendering error states when component rendering fails,
+ * including custom error templates and fallback overlays.
+ */
+export interface IErrorRenderer {
+    /**
+     * Renders an error overlay in the DOM context.
+     *
+     * @param domContext - DOM context for managing the error display
+     * @param errorMessage - Error message to display
+     * @param options - Optional custom template and constants to render error overlay
+     * @throws Error if domContext or errorMessage are null/undefined
+     *
+     * @example
+     * ```typescript
+     * await errorRenderer.render(domContext, 'Component failed to render', {
+     *   errorTemplate: '<div class="error">{{message}}</div>',
+     *   constants: { Styles: { ERROR: 'error' } }
+     * });
+     * ```
+     */
+    render(domContext: IDomContext, errorMessage: string, options?: ErrorRenderOptions): Promise<void>;
+}
+//# sourceMappingURL=error-renderer.interface.d.ts.map

package/dist/rendering/errors/error-renderer.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-renderer.interface.d.ts","sourceRoot":"","sources":["../../../src/rendering/errors/error-renderer.interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,yCAAyC,CAAC;AACtE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AAE9E;;;;;;GAMG;AACH,MAAM,WAAW,cAAc;IAC7B;;;;;;;;;;;;;;;OAeG;IACH,MAAM,CACJ,UAAU,EAAE,WAAW,EACvB,YAAY,EAAE,MAAM,EACpB,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,IAAI,CAAC,CAAC;CAClB"}

package/dist/rendering/errors/error-renderer.interface.js

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

package/dist/rendering/errors/error-renderer.interface.js.map

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

package/dist/rendering/errors/error-renderer.js

@@ -0,0 +1,127 @@
+import { DomContentType } from '../dom-context/dom-context.interface.js';
+import { NodeType } from '../dom/node-types.js';
+/**
+ * Implements the responsibility of rendering error states and overlays.
+ *
+ * @description
+ * Handles the rendering of error states when component rendering fails.
+ * Supports custom error templates from component metadata and provides
+ * a coherent fallback error overlay without hardcoded styles.
+ *
+ * @architecture
+ * Error Display Priority:
+ * 1. Custom error template: @SmartRender({ errorTemplate: '...' })
+ * 2. Fallback overlay: Simple HTML structure with message
+ */
+export class ErrorRenderer {
+    domAdapter;
+    /**
+     * Initializes a new instance of ErrorRenderer.
+     *
+     * @param domAdapter - Adapter for DOM element creation
+     * @throws Error if domAdapter is null or undefined
+     */
+    constructor(domAdapter) {
+        this.domAdapter = domAdapter;
+        if (!domAdapter)
+            throw new Error('Dom adapter is required');
+    }
+    /**
+     * Renders an error overlay in the DOM context
+     *
+     * @description
+     * Displays error message by either using custom error template from metadata
+     * or showing a simple fallback overlay. Preprocesses constants in custom templates.
+     *
+     * @param domContext - DOM context for managing the error display
+     * @param errorMessage - Error message to display
+     * @param componentId - Component identifier for custom error template lookup
+     *
+     * @example
+     * ```typescript
+     * // Custom error template with constants
+     * @SmartRender({
+     *   selector: 'my-component',
+     *   constants: { Styles: { ERROR: 'error-overlay' } },
+     *   errorTemplate: `<div class="[[Styles.ERROR]]">{{message}}</div>`
+     * })
+     *
+     * // Fallback: Simple structure without styles
+     * <div><div>⚠️</div><div>Error message</div></div>
+     * ```
+     */
+    async render(domContext, errorMessage, options) {
+        if (!domContext)
+            throw new Error('DOM context is required');
+        if (!errorMessage)
+            throw new Error('Error message is required');
+        if (await this.tryRenderCustomErrorTemplate(domContext, errorMessage, options)) {
+            return;
+        }
+        this.renderDefaultErrorOverlay(domContext, errorMessage);
+    }
+    async tryRenderCustomErrorTemplate(domContext, errorMessage, options) {
+        if (!options?.errorTemplate)
+            return false;
+        await this.renderCustomErrorTemplate(domContext, errorMessage, options.errorTemplate, options.constants);
+        return true;
+    }
+    async renderCustomErrorTemplate(domContext, errorMessage, errorTemplate, constants) {
+        let template = errorTemplate;
+        if (constants) {
+            const { StaticBindingResolver } = await import('../bindings/static-binding-resolver.js');
+            const resolver = new StaticBindingResolver();
+            template = resolver.resolve(template, constants);
+        }
+        const wrapper = this.domAdapter.createElement('div');
+        const placeholder = '__ERROR_MESSAGE_PLACEHOLDER__';
+        wrapper.innerHTML = template.replace(/\{\{\s*message\s*\}\}/g, placeholder);
+        // Replace placeholder with safe text content to prevent XSS
+        this.replaceTextPlaceholder(wrapper, placeholder, errorMessage);
+        wrapper.setAttribute('data-error', 'true');
+        domContext.setElement(wrapper, DomContentType.ERROR);
+    }
+    renderDefaultErrorOverlay(domContext, errorMessage) {
+        const overlay = this.domAdapter.createElement('div');
+        overlay.setAttribute('data-error', 'true');
+        const container = this.domAdapter.createElement('div');
+        const icon = this.domAdapter.createElement('div');
+        icon.textContent = '⚠️';
+        const message = this.domAdapter.createElement('div');
+        message.textContent = errorMessage;
+        container.appendChild(icon);
+        container.appendChild(message);
+        overlay.appendChild(container);
+        domContext.setElement(overlay, DomContentType.ERROR);
+    }
+    /**
+     * Safely replaces text placeholders in DOM tree to prevent XSS.
+     *
+     * @param element - Root element to search
+     * @param placeholder - Placeholder text to find
+     * @param value - Safe text value to insert
+     */
+    replaceTextPlaceholder(element, placeholder, value) {
+        this.walkTextNodes(element, (textNode) => {
+            if (textNode.textContent?.includes(placeholder)) {
+                textNode.textContent = textNode.textContent.replace(new RegExp(placeholder, 'g'), value);
+            }
+        });
+    }
+    /**
+     * Recursively walks all text nodes in an element.
+     *
+     * @param node - Node to start walking from
+     * @param callback - Function to call for each text node
+     */
+    walkTextNodes(node, callback) {
+        if (node.nodeType === NodeType.TEXT_NODE) {
+            callback(node);
+        }
+        else if (node.nodeType === NodeType.ELEMENT_NODE) {
+            const children = Array.from(node.childNodes);
+            children.forEach(child => this.walkTextNodes(child, callback));
+        }
+    }
+}
+//# sourceMappingURL=error-renderer.js.map

package/dist/rendering/errors/error-renderer.js.map

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

package/dist/rendering/expression-parser/dependency-extractor.d.ts

@@ -0,0 +1,36 @@
+import type { IDependencyExtractor } from './interfaces.js';
+import type { ASTNode } from './types.js';
+/**
+ * Implements the responsibility of extracting dependency names from AST nodes.
+ * Traverses the AST tree to identify all variables and properties that an expression
+ * depends on, following ISP by focusing solely on dependency analysis.
+ */
+export declare class DependencyExtractor implements IDependencyExtractor {
+    /**
+     * Extracts all dependency names referenced in the AST node.
+     * Recursively traverses the AST to collect unique dependency identifiers.
+     *
+     * @param node - The AST node to analyze for dependencies
+     * @returns Array of unique dependency names found in the expression
+     * @throws Error if node is null or undefined
+     *
+     * @example
+     * ```typescript
+     * const extractor = new DependencyExtractor();
+     * const ast = parseExpression('x + y.length');
+     * const deps = extractor.extract(ast);
+     * // Returns ['x', 'y']
+     * ```
+     */
+    extract(node: ASTNode): string[];
+    /**
+     * Recursively traverses the AST node to collect dependencies.
+     * Uses a Set to ensure uniqueness and avoid duplicates.
+     *
+     * @param node - The current AST node being traversed
+     * @param deps - The set to collect dependency names into
+     * @private
+     */
+    private traverse;
+}
+//# sourceMappingURL=dependency-extractor.d.ts.map

package/dist/rendering/expression-parser/dependency-extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dependency-extractor.d.ts","sourceRoot":"","sources":["../../../src/rendering/expression-parser/dependency-extractor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAC5D,OAAO,KAAK,EACV,OAAO,EAOR,MAAM,YAAY,CAAC;AAEpB;;;;GAIG;AACH,qBAAa,mBAAoB,YAAW,oBAAoB;IAC9D;;;;;;;;;;;;;;;OAeG;IACH,OAAO,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,EAAE;IAQhC;;;;;;;OAOG;IACH,OAAO,CAAC,QAAQ;CAiDjB"}

package/dist/rendering/expression-parser/dependency-extractor.js

@@ -0,0 +1,83 @@
+/**
+ * Implements the responsibility of extracting dependency names from AST nodes.
+ * Traverses the AST tree to identify all variables and properties that an expression
+ * depends on, following ISP by focusing solely on dependency analysis.
+ */
+export class DependencyExtractor {
+    /**
+     * Extracts all dependency names referenced in the AST node.
+     * Recursively traverses the AST to collect unique dependency identifiers.
+     *
+     * @param node - The AST node to analyze for dependencies
+     * @returns Array of unique dependency names found in the expression
+     * @throws Error if node is null or undefined
+     *
+     * @example
+     * ```typescript
+     * const extractor = new DependencyExtractor();
+     * const ast = parseExpression('x + y.length');
+     * const deps = extractor.extract(ast);
+     * // Returns ['x', 'y']
+     * ```
+     */
+    extract(node) {
+        if (!node)
+            throw new Error('AST node is required');
+        const deps = new Set();
+        this.traverse(node, deps);
+        return Array.from(deps);
+    }
+    /**
+     * Recursively traverses the AST node to collect dependencies.
+     * Uses a Set to ensure uniqueness and avoid duplicates.
+     *
+     * @param node - The current AST node being traversed
+     * @param deps - The set to collect dependency names into
+     * @private
+     */
+    traverse(node, deps) {
+        switch (node.type) {
+            case 'Identifier':
+                deps.add(node.name);
+                break;
+            case 'MemberExpression': {
+                const memberExpr = node;
+                if (memberExpr.object.type === 'Identifier') {
+                    deps.add(memberExpr.object.name);
+                }
+                else {
+                    this.traverse(memberExpr.object, deps);
+                }
+                break;
+            }
+            case 'CallExpression': {
+                const callExpr = node;
+                this.traverse(callExpr.callee, deps);
+                callExpr.arguments.forEach(arg => this.traverse(arg, deps));
+                break;
+            }
+            case 'BinaryExpression': {
+                const binaryExpr = node;
+                this.traverse(binaryExpr.left, deps);
+                this.traverse(binaryExpr.right, deps);
+                break;
+            }
+            case 'UnaryExpression': {
+                const unaryExpr = node;
+                this.traverse(unaryExpr.argument, deps);
+                break;
+            }
+            case 'ConditionalExpression': {
+                const conditionalExpr = node;
+                this.traverse(conditionalExpr.test, deps);
+                this.traverse(conditionalExpr.consequent, deps);
+                this.traverse(conditionalExpr.alternate, deps);
+                break;
+            }
+            case 'Literal':
+                // No dependencies for literal values
+                break;
+        }
+    }
+}
+//# sourceMappingURL=dependency-extractor.js.map

package/dist/rendering/expression-parser/dependency-extractor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dependency-extractor.js","sourceRoot":"","sources":["../../../src/rendering/expression-parser/dependency-extractor.ts"],"names":[],"mappings":"AAWA;;;;GAIG;AACH,MAAM,OAAO,mBAAmB;IAC9B;;;;;;;;;;;;;;;OAeG;IACH,OAAO,CAAC,IAAa;QACnB,IAAI,CAAC,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;QAEnD,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;QAC/B,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAC1B,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED;;;;;;;OAOG;IACK,QAAQ,CAAC,IAAa,EAAE,IAAiB;QAC/C,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;YAClB,KAAK,YAAY;gBACf,IAAI,CAAC,GAAG,CAAE,IAAuB,CAAC,IAAI,CAAC,CAAC;gBACxC,MAAM;YAER,KAAK,kBAAkB,CAAC,CAAC,CAAC;gBACxB,MAAM,UAAU,GAAG,IAA4B,CAAC;gBAChD,IAAI,UAAU,CAAC,MAAM,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;oBAC5C,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;gBACnC,CAAC;qBAAM,CAAC;oBACN,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;gBACzC,CAAC;gBACD,MAAM;YACR,CAAC;YAED,KAAK,gBAAgB,CAAC,CAAC,CAAC;gBACtB,MAAM,QAAQ,GAAG,IAA0B,CAAC;gBAC5C,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;gBACrC,QAAQ,CAAC,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC;gBAC5D,MAAM;YACR,CAAC;YAED,KAAK,kBAAkB,CAAC,CAAC,CAAC;gBACxB,MAAM,UAAU,GAAG,IAA4B,CAAC;gBAChD,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;gBACrC,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;gBACtC,MAAM;YACR,CAAC;YAED,KAAK,iBAAiB,CAAC,CAAC,CAAC;gBACvB,MAAM,SAAS,GAAG,IAA2B,CAAC;gBAC9C,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;gBACxC,MAAM;YACR,CAAC;YAED,KAAK,uBAAuB,CAAC,CAAC,CAAC;gBAC7B,MAAM,eAAe,GAAG,IAAiC,CAAC;gBAC1D,IAAI,CAAC,QAAQ,CAAC,eAAe,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;gBAC1C,IAAI,CAAC,QAAQ,CAAC,eAAe,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;gBAChD,IAAI,CAAC,QAAQ,CAAC,eAAe,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;gBAC/C,MAAM;YACR,CAAC;YAED,KAAK,SAAS;gBACZ,qCAAqC;gBACrC,MAAM;QACV,CAAC;IACH,CAAC;CACF"}

package/dist/rendering/expression-parser/evaluators/ast.evaluator.d.ts

@@ -0,0 +1,54 @@
+import type { IEvaluator } from "../interfaces.js";
+import type { ASTNode } from "../types.js";
+import type { INodeEvaluatorStrategy } from "./base.js";
+import type { ISafeMethodValidator } from "../safe-method-validator.interface.js";
+/**
+ * Implements the responsibility of evaluating Abstract Syntax Tree (AST) nodes
+ * using the Strategy pattern. This class serves as the main evaluator that
+ * delegates evaluation to specific strategies based on node type, enabling
+ * the Open/Closed Principle for extensibility.
+ */
+export declare class ASTEvaluator implements IEvaluator {
+    private static readonly MAX_EVAL_DEPTH;
+    private readonly strategies;
+    private evalDepth;
+    /**
+     * Initializes a new instance of ASTEvaluator with default strategies.
+     * Registers all built-in evaluators for common AST node types.
+     *
+     * @param safeMethodValidator - Validator for safe method invocation in call expressions
+     */
+    constructor(safeMethodValidator: ISafeMethodValidator);
+    /**
+     * Registers a new evaluation strategy for a specific AST node type.
+     * This method enables extension of the evaluator without modifying existing code.
+     *
+     * @param nodeType - The AST node type this strategy handles
+     * @param strategy - The strategy implementation for the node type
+     * @throws Error if nodeType or strategy is null or undefined
+     *
+     * @example
+     * ```typescript
+     * const evaluator = new ASTEvaluator();
+     * evaluator.registerStrategy('CustomNode', new CustomEvaluator());
+     * ```
+     */
+    registerStrategy(nodeType: string, strategy: INodeEvaluatorStrategy): void;
+    /**
+     * Evaluates an AST node within the provided scope.
+     * Delegates to the appropriate strategy based on the node type.
+     *
+     * @param node - The AST node to evaluate
+     * @param scope - The evaluation scope containing variable bindings
+     * @returns The evaluated result of the AST node
+     * @throws Error if node is null/undefined or no strategy exists for the node type
+     *
+     * @example
+     * ```typescript
+     * const evaluator = new ASTEvaluator();
+     * const result = evaluator.evaluate(astNode, { x: 42 });
+     * ```
+     */
+    evaluate(node: ASTNode, scope: Record<string, unknown>): unknown;
+}
+//# sourceMappingURL=ast.evaluator.d.ts.map

package/dist/rendering/expression-parser/evaluators/ast.evaluator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ast.evaluator.d.ts","sourceRoot":"","sources":["../../../../src/rendering/expression-parser/evaluators/ast.evaluator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAC;AACxD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AASlF;;;;;GAKG;AACH,qBAAa,YAAa,YAAW,UAAU;IAC7C,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,cAAc,CAAM;IAC5C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAkD;IAC7E,OAAO,CAAC,SAAS,CAAa;IAE9B;;;;;OAKG;gBACS,mBAAmB,EAAE,oBAAoB;IAoBrD;;;;;;;;;;;;;OAaG;IACH,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,sBAAsB,GAAG,IAAI;IAO1E;;;;;;;;;;;;;;OAcG;IACH,QAAQ,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO;CAoBjE"}

package/dist/rendering/expression-parser/evaluators/ast.evaluator.js

@@ -0,0 +1,92 @@
+import { LiteralEvaluator } from "./literal.evaluator.js";
+import { IdentifierEvaluator } from "./identifier.evaluator.js";
+import { MemberExpressionEvaluator } from "./member.evaluator.js";
+import { CallExpressionEvaluator } from "./call.evaluator.js";
+import { BinaryExpressionEvaluator } from "./binary.evaluator.js";
+import { UnaryExpressionEvaluator } from "./unary.evaluator.js";
+import { ConditionalExpressionEvaluator } from "./conditional.evaluator.js";
+/**
+ * Implements the responsibility of evaluating Abstract Syntax Tree (AST) nodes
+ * using the Strategy pattern. This class serves as the main evaluator that
+ * delegates evaluation to specific strategies based on node type, enabling
+ * the Open/Closed Principle for extensibility.
+ */
+export class ASTEvaluator {
+    static MAX_EVAL_DEPTH = 64;
+    strategies = new Map();
+    evalDepth = 0;
+    /**
+     * Initializes a new instance of ASTEvaluator with default strategies.
+     * Registers all built-in evaluators for common AST node types.
+     *
+     * @param safeMethodValidator - Validator for safe method invocation in call expressions
+     */
+    constructor(safeMethodValidator) {
+        if (!safeMethodValidator)
+            throw new Error("SafeMethodValidator is required");
+        // Register default strategies
+        this.registerStrategy("Literal", new LiteralEvaluator());
+        this.registerStrategy("Identifier", new IdentifierEvaluator());
+        this.registerStrategy("MemberExpression", new MemberExpressionEvaluator());
+        this.registerStrategy("CallExpression", new CallExpressionEvaluator(safeMethodValidator));
+        this.registerStrategy("BinaryExpression", new BinaryExpressionEvaluator());
+        this.registerStrategy("UnaryExpression", new UnaryExpressionEvaluator());
+        this.registerStrategy("ConditionalExpression", new ConditionalExpressionEvaluator());
+    }
+    /**
+     * Registers a new evaluation strategy for a specific AST node type.
+     * This method enables extension of the evaluator without modifying existing code.
+     *
+     * @param nodeType - The AST node type this strategy handles
+     * @param strategy - The strategy implementation for the node type
+     * @throws Error if nodeType or strategy is null or undefined
+     *
+     * @example
+     * ```typescript
+     * const evaluator = new ASTEvaluator();
+     * evaluator.registerStrategy('CustomNode', new CustomEvaluator());
+     * ```
+     */
+    registerStrategy(nodeType, strategy) {
+        if (!nodeType)
+            throw new Error("Node type is required");
+        if (!strategy)
+            throw new Error("Strategy is required");
+        this.strategies.set(nodeType, strategy);
+    }
+    /**
+     * Evaluates an AST node within the provided scope.
+     * Delegates to the appropriate strategy based on the node type.
+     *
+     * @param node - The AST node to evaluate
+     * @param scope - The evaluation scope containing variable bindings
+     * @returns The evaluated result of the AST node
+     * @throws Error if node is null/undefined or no strategy exists for the node type
+     *
+     * @example
+     * ```typescript
+     * const evaluator = new ASTEvaluator();
+     * const result = evaluator.evaluate(astNode, { x: 42 });
+     * ```
+     */
+    evaluate(node, scope) {
+        if (!node)
+            throw new Error("Node is required");
+        if (!scope)
+            throw new Error("Scope is required");
+        if (++this.evalDepth > ASTEvaluator.MAX_EVAL_DEPTH) {
+            throw new Error(`Expression evaluation depth exceeds maximum of ${ASTEvaluator.MAX_EVAL_DEPTH}`);
+        }
+        try {
+            const strategy = this.strategies.get(node.type);
+            if (!strategy) {
+                throw new Error(`Unknown node type: ${node.type}`);
+            }
+            return strategy.evaluate(node, scope, this);
+        }
+        finally {
+            this.evalDepth--;
+        }
+    }
+}
+//# sourceMappingURL=ast.evaluator.js.map

package/dist/rendering/expression-parser/evaluators/ast.evaluator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ast.evaluator.js","sourceRoot":"","sources":["../../../../src/rendering/expression-parser/evaluators/ast.evaluator.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AAClE,OAAO,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AAClE,OAAO,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AAChE,OAAO,EAAE,8BAA8B,EAAE,MAAM,4BAA4B,CAAC;AAE5E;;;;;GAKG;AACH,MAAM,OAAO,YAAY;IACf,MAAM,CAAU,cAAc,GAAG,EAAE,CAAC;IAC3B,UAAU,GAAwC,IAAI,GAAG,EAAE,CAAC;IACrE,SAAS,GAAW,CAAC,CAAC;IAE9B;;;;;OAKG;IACH,YAAY,mBAAyC;QACnD,IAAI,CAAC,mBAAmB;YACtB,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;QAErD,8BAA8B;QAC9B,IAAI,CAAC,gBAAgB,CAAC,SAAS,EAAE,IAAI,gBAAgB,EAAE,CAAC,CAAC;QACzD,IAAI,CAAC,gBAAgB,CAAC,YAAY,EAAE,IAAI,mBAAmB,EAAE,CAAC,CAAC;QAC/D,IAAI,CAAC,gBAAgB,CAAC,kBAAkB,EAAE,IAAI,yBAAyB,EAAE,CAAC,CAAC;QAC3E,IAAI,CAAC,gBAAgB,CACnB,gBAAgB,EAChB,IAAI,uBAAuB,CAAC,mBAAmB,CAAC,CACjD,CAAC;QACF,IAAI,CAAC,gBAAgB,CAAC,kBAAkB,EAAE,IAAI,yBAAyB,EAAE,CAAC,CAAC;QAC3E,IAAI,CAAC,gBAAgB,CAAC,iBAAiB,EAAE,IAAI,wBAAwB,EAAE,CAAC,CAAC;QACzE,IAAI,CAAC,gBAAgB,CACnB,uBAAuB,EACvB,IAAI,8BAA8B,EAAE,CACrC,CAAC;IACJ,CAAC;IAED;;;;;;;;;;;;;OAaG;IACH,gBAAgB,CAAC,QAAgB,EAAE,QAAgC;QACjE,IAAI,CAAC,QAAQ;YAAE,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;QACxD,IAAI,CAAC,QAAQ;YAAE,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;QAEvD,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAC1C,CAAC;IAED;;;;;;;;;;;;;;OAcG;IACH,QAAQ,CAAC,IAAa,EAAE,KAA8B;QACpD,IAAI,CAAC,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,kBAAkB,CAAC,CAAC;QAC/C,IAAI,CAAC,KAAK;YAAE,MAAM,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC;QAEjD,IAAI,EAAE,IAAI,CAAC,SAAS,GAAG,YAAY,CAAC,cAAc,EAAE,CAAC;YACnD,MAAM,IAAI,KAAK,CACb,kDAAkD,YAAY,CAAC,cAAc,EAAE,CAChF,CAAC;QACJ,CAAC;QAED,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAChD,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,MAAM,IAAI,KAAK,CAAC,sBAAsB,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;YACrD,CAAC;YACD,OAAO,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;QAC9C,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,SAAS,EAAE,CAAC;QACnB,CAAC;IACH,CAAC"}

package/dist/rendering/expression-parser/evaluators/base.d.ts

@@ -0,0 +1,20 @@
+import type { ASTNode } from "../types.js";
+import type { IEvaluator } from "../interfaces.js";
+/**
+ * Defines the responsibility of evaluating AST nodes using the Strategy pattern.
+ * This interface enables the Open/Closed Principle by allowing new node types
+ * to be evaluated without modifying existing code.
+ */
+export interface INodeEvaluatorStrategy {
+    /**
+     * Evaluates an AST node within a given scope.
+     *
+     * @param node - The AST node to evaluate
+     * @param scope - The evaluation scope containing variable bindings
+     * @param evaluator - The main evaluator instance for recursive evaluation
+     * @returns The evaluated result of the AST node
+     * @throws Error if the node cannot be evaluated
+     */
+    evaluate(node: ASTNode, scope: Record<string, unknown>, evaluator: IEvaluator): unknown;
+}
+//# sourceMappingURL=base.d.ts.map

package/dist/rendering/expression-parser/evaluators/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../../src/rendering/expression-parser/evaluators/base.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD;;;;GAIG;AACH,MAAM,WAAW,sBAAsB;IACrC;;;;;;;;OAQG;IACH,QAAQ,CACN,IAAI,EAAE,OAAO,EACb,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,SAAS,EAAE,UAAU,GACpB,OAAO,CAAC;CACZ"}

package/dist/rendering/expression-parser/evaluators/base.js

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

package/dist/rendering/expression-parser/evaluators/base.js.map

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

package/dist/rendering/expression-parser/evaluators/binary.evaluator.d.ts

@@ -0,0 +1,29 @@
+import type { ASTNode } from "../types.js";
+import type { IEvaluator } from "../interfaces.js";
+import type { INodeEvaluatorStrategy } from "./base.js";
+/**
+ * Implements the responsibility of evaluating binary expression AST nodes.
+ * Handles arithmetic, comparison, and logical operations between two operands.
+ */
+export declare class BinaryExpressionEvaluator implements INodeEvaluatorStrategy {
+    private readonly operators;
+    /**
+     * Evaluates a binary expression AST node by applying the operator to both operands.
+     *
+     * @param node - The binary expression AST node to evaluate
+     * @param scope - The evaluation scope containing variable bindings
+     * @param evaluator - The main evaluator instance for recursive evaluation
+     * @returns The result of applying the binary operator to the operands
+     * @throws Error if node, scope, or evaluator is null/undefined, or if operator is unknown
+     *
+     * @example
+     * ```typescript
+     * const evaluator = new BinaryExpressionEvaluator();
+     * const scope = { a: 5, b: 3 };
+     * const result = evaluator.evaluate(binaryNode, scope, evaluator);
+     * // Returns 8 for a + b
+     * ```
+     */
+    evaluate(node: ASTNode, scope: Record<string, unknown>, evaluator: IEvaluator): unknown;
+}
+//# sourceMappingURL=binary.evaluator.d.ts.map

package/dist/rendering/expression-parser/evaluators/binary.evaluator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"binary.evaluator.d.ts","sourceRoot":"","sources":["../../../../src/rendering/expression-parser/evaluators/binary.evaluator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAwB,MAAM,aAAa,CAAC;AACjE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAC;AAExD;;;GAGG;AACH,qBAAa,yBAA0B,YAAW,sBAAsB;IACtE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAiBxB;IAEF;;;;;;;;;;;;;;;;OAgBG;IACH,QAAQ,CACN,IAAI,EAAE,OAAO,EACb,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,SAAS,EAAE,UAAU,GACpB,OAAO;CAgBX"}