smart-lifecycle 0.1.1

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

@@ -0,0 +1,55 @@
+/**
+ * Implements the responsibility of evaluating binary expression AST nodes.
+ * Handles arithmetic, comparison, and logical operations between two operands.
+ */
+export class BinaryExpressionEvaluator {
+    operators = {
+        "+": (l, r) => l + r,
+        "-": (l, r) => l - r,
+        "*": (l, r) => l * r,
+        "/": (l, r) => l / r,
+        "%": (l, r) => l % r,
+        "===": (l, r) => l === r,
+        "!==": (l, r) => l !== r,
+        ">": (l, r) => l > r,
+        "<": (l, r) => l < r,
+        ">=": (l, r) => l >= r,
+        "<=": (l, r) => l <= r,
+        "&&": (l, r) => l && r,
+        "||": (l, r) => l || r,
+    };
+    /**
+     * 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, scope, evaluator) {
+        if (!node)
+            throw new Error("Node is required");
+        if (!scope)
+            throw new Error("Scope is required");
+        if (!evaluator)
+            throw new Error("Evaluator is required");
+        const binaryExpr = node;
+        const left = evaluator.evaluate(binaryExpr.left, scope);
+        const right = evaluator.evaluate(binaryExpr.right, scope);
+        const operation = this.operators[binaryExpr.operator];
+        if (!operation) {
+            throw new Error(`Unknown operator: ${binaryExpr.operator}`);
+        }
+        return operation(left, right);
+    }
+}
+//# sourceMappingURL=binary.evaluator.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"binary.evaluator.js","sourceRoot":"","sources":["../../../../src/rendering/expression-parser/evaluators/binary.evaluator.ts"],"names":[],"mappings":"AAIA;;;GAGG;AACH,MAAM,OAAO,yBAAyB;IACnB,SAAS,GAGtB;QACF,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAE,CAAY,GAAI,CAAY;QAC5C,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAE,CAAY,GAAI,CAAY;QAC5C,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAE,CAAY,GAAI,CAAY;QAC5C,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAE,CAAY,GAAI,CAAY;QAC5C,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAE,CAAY,GAAI,CAAY;QAC5C,KAAK,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC;QACxB,KAAK,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC;QACxB,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAE,CAAY,GAAI,CAAY;QAC5C,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAE,CAAY,GAAI,CAAY;QAC5C,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAE,CAAY,IAAK,CAAY;QAC9C,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAE,CAAY,IAAK,CAAY;QAC9C,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC;QACtB,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC;KACvB,CAAC;IAEF;;;;;;;;;;;;;;;;OAgBG;IACH,QAAQ,CACN,IAAa,EACb,KAA8B,EAC9B,SAAqB;QAErB,IAAI,CAAC,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,kBAAkB,CAAC,CAAC;QAC/C,IAAI,CAAC,KAAK;YAAE,MAAM,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC;QACjD,IAAI,CAAC,SAAS;YAAE,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;QAEzD,MAAM,UAAU,GAAG,IAA4B,CAAC;QAChD,MAAM,IAAI,GAAG,SAAS,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QACxD,MAAM,KAAK,GAAG,SAAS,CAAC,QAAQ,CAAC,UAAU,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QAE1D,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;QACtD,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,qBAAqB,UAAU,CAAC,QAAQ,EAAE,CAAC,CAAC;QAC9D,CAAC;QAED,OAAO,SAAS,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAChC,CAAC;CACF"}

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

@@ -0,0 +1,38 @@
+import type { ISafeMethodValidator } from "../safe-method-validator.interface.js";
+import type { ASTNode } from "../types.js";
+import type { IEvaluator } from "../interfaces.js";
+import type { INodeEvaluatorStrategy } from "./base.js";
+/**
+ * Implements the responsibility of evaluating call expression AST nodes.
+ * Handles method calls on objects with security validation to prevent unsafe operations.
+ */
+export declare class CallExpressionEvaluator implements INodeEvaluatorStrategy {
+    private readonly safeMethodValidator;
+    /**
+     * Creates a CallExpressionEvaluator instance.
+     *
+     * @param safeMethodValidator - Validator for safe method invocation in expressions
+     */
+    constructor(safeMethodValidator: ISafeMethodValidator);
+    /**
+     * Evaluates a call expression AST node by invoking a method on an object.
+     * Includes security checks to ensure only safe methods can be called.
+     *
+     * @param node - The call 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 the method call
+     * @throws Error if node, scope, or evaluator is null/undefined, if the method is not safe,
+     *         if the target is null/undefined, or if the property is not a function
+     *
+     * @example
+     * ```typescript
+     * const evaluator = new CallExpressionEvaluator(safeMethodValidator);
+     * const scope = { str: 'hello' };
+     * const result = evaluator.evaluate(callNode, scope, evaluator);
+     * // Returns result of calling safe method like str.toUpperCase()
+     * ```
+     */
+    evaluate(node: ASTNode, scope: Record<string, unknown>, evaluator: IEvaluator): unknown;
+}
+//# sourceMappingURL=call.evaluator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"call.evaluator.d.ts","sourceRoot":"","sources":["../../../../src/rendering/expression-parser/evaluators/call.evaluator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAClF,OAAO,KAAK,EAAE,OAAO,EAAsB,MAAM,aAAa,CAAC;AAC/D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAC;AAExD;;;GAGG;AACH,qBAAa,uBAAwB,YAAW,sBAAsB;IACpE,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAuB;IAE3D;;;;OAIG;gBACS,mBAAmB,EAAE,oBAAoB;IAMrD;;;;;;;;;;;;;;;;;;OAkBG;IACH,QAAQ,CACN,IAAI,EAAE,OAAO,EACb,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,SAAS,EAAE,UAAU,GACpB,OAAO;CAgCX"}

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

@@ -0,0 +1,62 @@
+/**
+ * Implements the responsibility of evaluating call expression AST nodes.
+ * Handles method calls on objects with security validation to prevent unsafe operations.
+ */
+export class CallExpressionEvaluator {
+    safeMethodValidator;
+    /**
+     * Creates a CallExpressionEvaluator instance.
+     *
+     * @param safeMethodValidator - Validator for safe method invocation in expressions
+     */
+    constructor(safeMethodValidator) {
+        if (!safeMethodValidator)
+            throw new Error("SafeMethodValidator is required");
+        this.safeMethodValidator = safeMethodValidator;
+    }
+    /**
+     * Evaluates a call expression AST node by invoking a method on an object.
+     * Includes security checks to ensure only safe methods can be called.
+     *
+     * @param node - The call 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 the method call
+     * @throws Error if node, scope, or evaluator is null/undefined, if the method is not safe,
+     *         if the target is null/undefined, or if the property is not a function
+     *
+     * @example
+     * ```typescript
+     * const evaluator = new CallExpressionEvaluator(safeMethodValidator);
+     * const scope = { str: 'hello' };
+     * const result = evaluator.evaluate(callNode, scope, evaluator);
+     * // Returns result of calling safe method like str.toUpperCase()
+     * ```
+     */
+    evaluate(node, scope, evaluator) {
+        if (!node)
+            throw new Error("Node is required");
+        if (!scope)
+            throw new Error("Scope is required");
+        if (!evaluator)
+            throw new Error("Evaluator is required");
+        const callExpr = node;
+        const obj = evaluator.evaluate(callExpr.callee.object, scope);
+        if (obj == null) {
+            throw new Error(`Cannot call method on null or undefined`);
+        }
+        const methodName = callExpr.callee.property.name;
+        if (!this.safeMethodValidator.isSafeMethod(obj, methodName)) {
+            const safeMethods = this.safeMethodValidator.getSafeMethodsForType(obj);
+            throw new Error(`Method "${methodName}" is not allowed for security reasons.\n` +
+                `Allowed methods: ${safeMethods.join(", ")}`);
+        }
+        const method = obj[methodName];
+        if (typeof method !== "function") {
+            throw new Error(`"${methodName}" is not a function`);
+        }
+        const args = callExpr.arguments.map((arg) => evaluator.evaluate(arg, scope));
+        return method.apply(obj, args);
+    }
+}
+//# sourceMappingURL=call.evaluator.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"call.evaluator.js","sourceRoot":"","sources":["../../../../src/rendering/expression-parser/evaluators/call.evaluator.ts"],"names":[],"mappings":"AAKA;;;GAGG;AACH,MAAM,OAAO,uBAAuB;IACjB,mBAAmB,CAAuB;IAE3D;;;;OAIG;IACH,YAAY,mBAAyC;QACnD,IAAI,CAAC,mBAAmB;YACtB,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;QACrD,IAAI,CAAC,mBAAmB,GAAG,mBAAmB,CAAC;IACjD,CAAC;IAED;;;;;;;;;;;;;;;;;;OAkBG;IACH,QAAQ,CACN,IAAa,EACb,KAA8B,EAC9B,SAAqB;QAErB,IAAI,CAAC,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,kBAAkB,CAAC,CAAC;QAC/C,IAAI,CAAC,KAAK;YAAE,MAAM,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC;QACjD,IAAI,CAAC,SAAS;YAAE,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;QAEzD,MAAM,QAAQ,GAAG,IAA0B,CAAC;QAC5C,MAAM,GAAG,GAAG,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QAE9D,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC;YAChB,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;QAC7D,CAAC;QAED,MAAM,UAAU,GAAG,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC;QAEjD,IAAI,CAAC,IAAI,CAAC,mBAAmB,CAAC,YAAY,CAAC,GAAG,EAAE,UAAU,CAAC,EAAE,CAAC;YAC5D,MAAM,WAAW,GAAG,IAAI,CAAC,mBAAmB,CAAC,qBAAqB,CAAC,GAAG,CAAC,CAAC;YACxE,MAAM,IAAI,KAAK,CACb,WAAW,UAAU,0CAA0C;gBAC7D,oBAAoB,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAC/C,CAAC;QACJ,CAAC;QAED,MAAM,MAAM,GAAI,GAA+B,CAAC,UAAU,CAAC,CAAC;QAC5D,IAAI,OAAO,MAAM,KAAK,UAAU,EAAE,CAAC;YACjC,MAAM,IAAI,KAAK,CAAC,IAAI,UAAU,qBAAqB,CAAC,CAAC;QACvD,CAAC;QAED,MAAM,IAAI,GAAG,QAAQ,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAC1C,SAAS,CAAC,QAAQ,CAAC,GAAG,EAAE,KAAK,CAAC,CAC/B,CAAC;QACF,OAAQ,MAA0C,CAAC,KAAK,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IACtE,CAAC;CACF"}

package/dist/rendering/expression-parser/evaluators/conditional.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 conditional (ternary) expression AST nodes.
+ * Handles the conditional operator (condition ? consequent : alternate) evaluation.
+ */
+export declare class ConditionalExpressionEvaluator implements INodeEvaluatorStrategy {
+    /**
+     * Evaluates a conditional expression AST node by testing the condition
+     * and returning either the consequent or alternate value.
+     *
+     * @param node - The conditional 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 the conditional expression (consequent if test is truthy, alternate otherwise)
+     * @throws Error if node, scope, or evaluator is null/undefined
+     *
+     * @example
+     * ```typescript
+     * const evaluator = new ConditionalExpressionEvaluator();
+     * const scope = { condition: true, a: 1, b: 2 };
+     * const result = evaluator.evaluate(conditionalNode, scope, evaluator);
+     * // Returns 1 for condition ? a : b when condition is true
+     * ```
+     */
+    evaluate(node: ASTNode, scope: Record<string, unknown>, evaluator: IEvaluator): unknown;
+}
+//# sourceMappingURL=conditional.evaluator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"conditional.evaluator.d.ts","sourceRoot":"","sources":["../../../../src/rendering/expression-parser/evaluators/conditional.evaluator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAA6B,MAAM,aAAa,CAAC;AACtE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAC;AAExD;;;GAGG;AACH,qBAAa,8BAA+B,YAAW,sBAAsB;IAC3E;;;;;;;;;;;;;;;;;OAiBG;IACH,QAAQ,CACN,IAAI,EAAE,OAAO,EACb,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,SAAS,EAAE,UAAU,GACpB,OAAO;CAWX"}

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

@@ -0,0 +1,38 @@
+/**
+ * Implements the responsibility of evaluating conditional (ternary) expression AST nodes.
+ * Handles the conditional operator (condition ? consequent : alternate) evaluation.
+ */
+export class ConditionalExpressionEvaluator {
+    /**
+     * Evaluates a conditional expression AST node by testing the condition
+     * and returning either the consequent or alternate value.
+     *
+     * @param node - The conditional 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 the conditional expression (consequent if test is truthy, alternate otherwise)
+     * @throws Error if node, scope, or evaluator is null/undefined
+     *
+     * @example
+     * ```typescript
+     * const evaluator = new ConditionalExpressionEvaluator();
+     * const scope = { condition: true, a: 1, b: 2 };
+     * const result = evaluator.evaluate(conditionalNode, scope, evaluator);
+     * // Returns 1 for condition ? a : b when condition is true
+     * ```
+     */
+    evaluate(node, scope, evaluator) {
+        if (!node)
+            throw new Error("Node is required");
+        if (!scope)
+            throw new Error("Scope is required");
+        if (!evaluator)
+            throw new Error("Evaluator is required");
+        const conditionalExpr = node;
+        const test = evaluator.evaluate(conditionalExpr.test, scope);
+        return test
+            ? evaluator.evaluate(conditionalExpr.consequent, scope)
+            : evaluator.evaluate(conditionalExpr.alternate, scope);
+    }
+}
+//# sourceMappingURL=conditional.evaluator.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"conditional.evaluator.js","sourceRoot":"","sources":["../../../../src/rendering/expression-parser/evaluators/conditional.evaluator.ts"],"names":[],"mappings":"AAIA;;;GAGG;AACH,MAAM,OAAO,8BAA8B;IACzC;;;;;;;;;;;;;;;;;OAiBG;IACH,QAAQ,CACN,IAAa,EACb,KAA8B,EAC9B,SAAqB;QAErB,IAAI,CAAC,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,kBAAkB,CAAC,CAAC;QAC/C,IAAI,CAAC,KAAK;YAAE,MAAM,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC;QACjD,IAAI,CAAC,SAAS;YAAE,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;QAEzD,MAAM,eAAe,GAAG,IAAiC,CAAC;QAC1D,MAAM,IAAI,GAAG,SAAS,CAAC,QAAQ,CAAC,eAAe,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAC7D,OAAO,IAAI;YACT,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,eAAe,CAAC,UAAU,EAAE,KAAK,CAAC;YACvD,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,eAAe,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;IAC3D,CAAC;CACF"}

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

@@ -0,0 +1,28 @@
+import type { ASTNode } from "../types.js";
+import type { IEvaluator } from "../interfaces.js";
+import type { INodeEvaluatorStrategy } from "./base.js";
+/**
+ * Implements the responsibility of evaluating identifier AST nodes.
+ * Resolves variable names by looking them up in the evaluation scope.
+ */
+export declare class IdentifierEvaluator implements INodeEvaluatorStrategy {
+    /**
+     * Evaluates an identifier AST node by resolving its name in the scope.
+     *
+     * @param node - The identifier AST node to evaluate
+     * @param scope - The evaluation scope containing variable bindings
+     * @param _evaluator - The main evaluator instance (not used for identifiers)
+     * @returns The value of the identifier from the scope
+     * @throws Error if node or scope is null/undefined
+     *
+     * @example
+     * ```typescript
+     * const evaluator = new IdentifierEvaluator();
+     * const scope = { x: 42 };
+     * const result = evaluator.evaluate(identifierNode, scope, evaluator);
+     * // Returns 42 for identifier 'x'
+     * ```
+     */
+    evaluate(node: ASTNode, scope: Record<string, unknown>, _evaluator: IEvaluator): unknown;
+}
+//# sourceMappingURL=identifier.evaluator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"identifier.evaluator.d.ts","sourceRoot":"","sources":["../../../../src/rendering/expression-parser/evaluators/identifier.evaluator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAkB,MAAM,aAAa,CAAC;AAC3D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAC;AAExD;;;GAGG;AACH,qBAAa,mBAAoB,YAAW,sBAAsB;IAChE;;;;;;;;;;;;;;;;OAgBG;IAEH,QAAQ,CACN,IAAI,EAAE,OAAO,EACb,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,UAAU,EAAE,UAAU,GACrB,OAAO;CAOX"}

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

@@ -0,0 +1,33 @@
+/**
+ * Implements the responsibility of evaluating identifier AST nodes.
+ * Resolves variable names by looking them up in the evaluation scope.
+ */
+export class IdentifierEvaluator {
+    /**
+     * Evaluates an identifier AST node by resolving its name in the scope.
+     *
+     * @param node - The identifier AST node to evaluate
+     * @param scope - The evaluation scope containing variable bindings
+     * @param _evaluator - The main evaluator instance (not used for identifiers)
+     * @returns The value of the identifier from the scope
+     * @throws Error if node or scope is null/undefined
+     *
+     * @example
+     * ```typescript
+     * const evaluator = new IdentifierEvaluator();
+     * const scope = { x: 42 };
+     * const result = evaluator.evaluate(identifierNode, scope, evaluator);
+     * // Returns 42 for identifier 'x'
+     * ```
+     */
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    evaluate(node, scope, _evaluator) {
+        if (!node)
+            throw new Error("Node is required");
+        if (!scope)
+            throw new Error("Scope is required");
+        const identifier = node;
+        return scope[identifier.name];
+    }
+}
+//# sourceMappingURL=identifier.evaluator.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"identifier.evaluator.js","sourceRoot":"","sources":["../../../../src/rendering/expression-parser/evaluators/identifier.evaluator.ts"],"names":[],"mappings":"AAIA;;;GAGG;AACH,MAAM,OAAO,mBAAmB;IAC9B;;;;;;;;;;;;;;;;OAgBG;IACH,6DAA6D;IAC7D,QAAQ,CACN,IAAa,EACb,KAA8B,EAC9B,UAAsB;QAEtB,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,MAAM,UAAU,GAAG,IAAsB,CAAC;QAC1C,OAAO,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IAChC,CAAC;CACF"}

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

@@ -0,0 +1,10 @@
+export type { INodeEvaluatorStrategy } from "./base.js";
+export { LiteralEvaluator } from "./literal.evaluator.js";
+export { IdentifierEvaluator } from "./identifier.evaluator.js";
+export { MemberExpressionEvaluator } from "./member.evaluator.js";
+export { CallExpressionEvaluator } from "./call.evaluator.js";
+export { BinaryExpressionEvaluator } from "./binary.evaluator.js";
+export { UnaryExpressionEvaluator } from "./unary.evaluator.js";
+export { ConditionalExpressionEvaluator } from "./conditional.evaluator.js";
+export { ASTEvaluator } from "./ast.evaluator.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/rendering/expression-parser/evaluators/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAC;AACxD,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;AAC5E,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC"}

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

@@ -0,0 +1,9 @@
+export { LiteralEvaluator } from "./literal.evaluator.js";
+export { IdentifierEvaluator } from "./identifier.evaluator.js";
+export { MemberExpressionEvaluator } from "./member.evaluator.js";
+export { CallExpressionEvaluator } from "./call.evaluator.js";
+export { BinaryExpressionEvaluator } from "./binary.evaluator.js";
+export { UnaryExpressionEvaluator } from "./unary.evaluator.js";
+export { ConditionalExpressionEvaluator } from "./conditional.evaluator.js";
+export { ASTEvaluator } from "./ast.evaluator.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/rendering/expression-parser/evaluators/index.ts"],"names":[],"mappings":"AACA,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;AAC5E,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC"}

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

@@ -0,0 +1,27 @@
+import type { ASTNode } from "../types.js";
+import type { IEvaluator } from "../interfaces.js";
+import type { INodeEvaluatorStrategy } from "./base.js";
+/**
+ * Implements the responsibility of evaluating literal AST nodes.
+ * Handles evaluation of primitive values like strings, numbers, booleans, etc.
+ */
+export declare class LiteralEvaluator implements INodeEvaluatorStrategy {
+    /**
+     * Evaluates a literal AST node by returning its primitive value.
+     *
+     * @param node - The literal AST node to evaluate
+     * @param _scope - The evaluation scope (not used for literals)
+     * @param _evaluator - The main evaluator instance (not used for literals)
+     * @returns The primitive value of the literal node
+     * @throws Error if node is null or undefined
+     *
+     * @example
+     * ```typescript
+     * const evaluator = new LiteralEvaluator();
+     * const result = evaluator.evaluate(literalNode, scope, evaluator);
+     * // Returns the primitive value (string, number, boolean, etc.)
+     * ```
+     */
+    evaluate(node: ASTNode, _scope: Record<string, unknown>, _evaluator: IEvaluator): unknown;
+}
+//# sourceMappingURL=literal.evaluator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"literal.evaluator.d.ts","sourceRoot":"","sources":["../../../../src/rendering/expression-parser/evaluators/literal.evaluator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAe,MAAM,aAAa,CAAC;AACxD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAC;AAExD;;;GAGG;AACH,qBAAa,gBAAiB,YAAW,sBAAsB;IAC7D;;;;;;;;;;;;;;;OAeG;IAEH,QAAQ,CACN,IAAI,EAAE,OAAO,EACb,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,UAAU,EAAE,UAAU,GACrB,OAAO;CAKX"}

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

@@ -0,0 +1,29 @@
+/**
+ * Implements the responsibility of evaluating literal AST nodes.
+ * Handles evaluation of primitive values like strings, numbers, booleans, etc.
+ */
+export class LiteralEvaluator {
+    /**
+     * Evaluates a literal AST node by returning its primitive value.
+     *
+     * @param node - The literal AST node to evaluate
+     * @param _scope - The evaluation scope (not used for literals)
+     * @param _evaluator - The main evaluator instance (not used for literals)
+     * @returns The primitive value of the literal node
+     * @throws Error if node is null or undefined
+     *
+     * @example
+     * ```typescript
+     * const evaluator = new LiteralEvaluator();
+     * const result = evaluator.evaluate(literalNode, scope, evaluator);
+     * // Returns the primitive value (string, number, boolean, etc.)
+     * ```
+     */
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    evaluate(node, _scope, _evaluator) {
+        if (!node)
+            throw new Error("Node is required");
+        return node.value;
+    }
+}
+//# sourceMappingURL=literal.evaluator.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"literal.evaluator.js","sourceRoot":"","sources":["../../../../src/rendering/expression-parser/evaluators/literal.evaluator.ts"],"names":[],"mappings":"AAIA;;;GAGG;AACH,MAAM,OAAO,gBAAgB;IAC3B;;;;;;;;;;;;;;;OAeG;IACH,6DAA6D;IAC7D,QAAQ,CACN,IAAa,EACb,MAA+B,EAC/B,UAAsB;QAEtB,IAAI,CAAC,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,kBAAkB,CAAC,CAAC;QAE/C,OAAQ,IAAoB,CAAC,KAAK,CAAC;IACrC,CAAC;CACF"}

package/dist/rendering/expression-parser/evaluators/member.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 member expression AST nodes.
+ * Handles property access on objects with support for optional chaining.
+ */
+export declare class MemberExpressionEvaluator implements INodeEvaluatorStrategy {
+    /**
+     * Evaluates a member expression AST node by accessing a property on an object.
+     * Supports optional chaining where accessing properties on null/undefined returns undefined.
+     *
+     * @param node - The member expression AST node to evaluate
+     * @param scope - The evaluation scope containing variable bindings
+     * @param evaluator - The main evaluator instance for recursive evaluation
+     * @returns The value of the accessed property, or undefined for optional chaining on null/undefined
+     * @throws Error if node, scope, or evaluator is null/undefined
+     *
+     * @example
+     * ```typescript
+     * const evaluator = new MemberExpressionEvaluator();
+     * const scope = { obj: { prop: 'value' } };
+     * const result = evaluator.evaluate(memberNode, scope, evaluator);
+     * // Returns 'value' for obj.prop
+     * ```
+     */
+    evaluate(node: ASTNode, scope: Record<string, unknown>, evaluator: IEvaluator): unknown;
+}
+//# sourceMappingURL=member.evaluator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"member.evaluator.d.ts","sourceRoot":"","sources":["../../../../src/rendering/expression-parser/evaluators/member.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;;;;;;;;;;;;;;;;;OAiBG;IACH,QAAQ,CACN,IAAI,EAAE,OAAO,EACb,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,SAAS,EAAE,UAAU,GACpB,OAAO;CAcX"}

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

@@ -0,0 +1,39 @@
+/**
+ * Implements the responsibility of evaluating member expression AST nodes.
+ * Handles property access on objects with support for optional chaining.
+ */
+export class MemberExpressionEvaluator {
+    /**
+     * Evaluates a member expression AST node by accessing a property on an object.
+     * Supports optional chaining where accessing properties on null/undefined returns undefined.
+     *
+     * @param node - The member expression AST node to evaluate
+     * @param scope - The evaluation scope containing variable bindings
+     * @param evaluator - The main evaluator instance for recursive evaluation
+     * @returns The value of the accessed property, or undefined for optional chaining on null/undefined
+     * @throws Error if node, scope, or evaluator is null/undefined
+     *
+     * @example
+     * ```typescript
+     * const evaluator = new MemberExpressionEvaluator();
+     * const scope = { obj: { prop: 'value' } };
+     * const result = evaluator.evaluate(memberNode, scope, evaluator);
+     * // Returns 'value' for obj.prop
+     * ```
+     */
+    evaluate(node, scope, evaluator) {
+        if (!node)
+            throw new Error("Node is required");
+        if (!scope)
+            throw new Error("Scope is required");
+        if (!evaluator)
+            throw new Error("Evaluator is required");
+        const memberExpr = node;
+        const obj = evaluator.evaluate(memberExpr.object, scope);
+        if (obj == null) {
+            return memberExpr.optional ? undefined : obj;
+        }
+        return obj[memberExpr.property.name];
+    }
+}
+//# sourceMappingURL=member.evaluator.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"member.evaluator.js","sourceRoot":"","sources":["../../../../src/rendering/expression-parser/evaluators/member.evaluator.ts"],"names":[],"mappings":"AAIA;;;GAGG;AACH,MAAM,OAAO,yBAAyB;IACpC;;;;;;;;;;;;;;;;;OAiBG;IACH,QAAQ,CACN,IAAa,EACb,KAA8B,EAC9B,SAAqB;QAErB,IAAI,CAAC,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,kBAAkB,CAAC,CAAC;QAC/C,IAAI,CAAC,KAAK;YAAE,MAAM,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC;QACjD,IAAI,CAAC,SAAS;YAAE,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;QAEzD,MAAM,UAAU,GAAG,IAA4B,CAAC;QAChD,MAAM,GAAG,GAAG,SAAS,CAAC,QAAQ,CAAC,UAAU,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QAEzD,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC;YAChB,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC;QAC/C,CAAC;QAED,OAAQ,GAA+B,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IACpE,CAAC;CACF"}

package/dist/rendering/expression-parser/evaluators/unary.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 unary expression AST nodes.
+ * Handles logical negation, numeric negation, and numeric coercion operations.
+ */
+export declare class UnaryExpressionEvaluator implements INodeEvaluatorStrategy {
+    private readonly operators;
+    /**
+     * Evaluates a unary expression AST node by applying the operator to its operand.
+     *
+     * @param node - The unary 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 unary operator to the operand
+     * @throws Error if node, scope, or evaluator is null/undefined, or if operator is unknown
+     *
+     * @example
+     * ```typescript
+     * const evaluator = new UnaryExpressionEvaluator();
+     * const scope = { x: 5 };
+     * const result = evaluator.evaluate(unaryNode, scope, evaluator);
+     * // Returns -5 for -x
+     * ```
+     */
+    evaluate(node: ASTNode, scope: Record<string, unknown>, evaluator: IEvaluator): unknown;
+}
+//# sourceMappingURL=unary.evaluator.d.ts.map

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

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

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

@@ -0,0 +1,44 @@
+/**
+ * Implements the responsibility of evaluating unary expression AST nodes.
+ * Handles logical negation, numeric negation, and numeric coercion operations.
+ */
+export class UnaryExpressionEvaluator {
+    operators = {
+        "!": (arg) => !arg,
+        "-": (arg) => -arg,
+        "+": (arg) => +arg,
+    };
+    /**
+     * Evaluates a unary expression AST node by applying the operator to its operand.
+     *
+     * @param node - The unary 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 unary operator to the operand
+     * @throws Error if node, scope, or evaluator is null/undefined, or if operator is unknown
+     *
+     * @example
+     * ```typescript
+     * const evaluator = new UnaryExpressionEvaluator();
+     * const scope = { x: 5 };
+     * const result = evaluator.evaluate(unaryNode, scope, evaluator);
+     * // Returns -5 for -x
+     * ```
+     */
+    evaluate(node, scope, evaluator) {
+        if (!node)
+            throw new Error("Node is required");
+        if (!scope)
+            throw new Error("Scope is required");
+        if (!evaluator)
+            throw new Error("Evaluator is required");
+        const unaryExpr = node;
+        const arg = evaluator.evaluate(unaryExpr.argument, scope);
+        const operation = this.operators[unaryExpr.operator];
+        if (!operation) {
+            throw new Error(`Unknown unary operator: ${unaryExpr.operator}`);
+        }
+        return operation(arg);
+    }
+}
+//# sourceMappingURL=unary.evaluator.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"unary.evaluator.js","sourceRoot":"","sources":["../../../../src/rendering/expression-parser/evaluators/unary.evaluator.ts"],"names":[],"mappings":"AAIA;;;GAGG;AACH,MAAM,OAAO,wBAAwB;IAClB,SAAS,GAA8C;QACtE,GAAG,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG;QAClB,GAAG,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,CAAE,GAAc;QAC9B,GAAG,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,CAAE,GAAc;KAC/B,CAAC;IAEF;;;;;;;;;;;;;;;;OAgBG;IACH,QAAQ,CACN,IAAa,EACb,KAA8B,EAC9B,SAAqB;QAErB,IAAI,CAAC,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,kBAAkB,CAAC,CAAC;QAC/C,IAAI,CAAC,KAAK;YAAE,MAAM,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC;QACjD,IAAI,CAAC,SAAS;YAAE,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;QAEzD,MAAM,SAAS,GAAG,IAA2B,CAAC;QAC9C,MAAM,GAAG,GAAG,SAAS,CAAC,QAAQ,CAAC,SAAS,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;QAE1D,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QACrD,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,2BAA2B,SAAS,CAAC,QAAQ,EAAE,CAAC,CAAC;QACnE,CAAC;QAED,OAAO,SAAS,CAAC,GAAG,CAAC,CAAC;IACxB,CAAC;CACF"}