@a2ui-sdk/utils 0.0.0

package/dist/0.9/index.d.ts

@@ -0,0 +1 @@
+export { interpolate } from './interpolation/index.js';

package/dist/0.9/index.js

@@ -0,0 +1 @@
+export { interpolate } from './interpolation/index.js';

package/dist/0.9/interpolation/evaluator.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Evaluator for interpolation AST nodes.
+ *
+ * Traverses the AST and resolves values from the data model,
+ * producing the final interpolated string.
+ */
+import type { ASTNode, EvaluationContext } from './types.js';
+/**
+ * Evaluates an AST node and returns the result as a string.
+ *
+ * @param ast - The AST node to evaluate
+ * @param context - The evaluation context with data model and functions
+ * @returns The evaluated string result
+ */
+export declare function evaluate(ast: ASTNode, context: EvaluationContext): string;

package/dist/0.9/interpolation/evaluator.js

@@ -0,0 +1,95 @@
+/**
+ * Evaluator for interpolation AST nodes.
+ *
+ * Traverses the AST and resolves values from the data model,
+ * producing the final interpolated string.
+ */
+import { getValueByPath, resolvePath } from '../pathUtils.js';
+/**
+ * Evaluates an AST node and returns the result as a string.
+ *
+ * @param ast - The AST node to evaluate
+ * @param context - The evaluation context with data model and functions
+ * @returns The evaluated string result
+ */
+export function evaluate(ast, context) {
+    const value = evaluateNode(ast, context);
+    return stringifyValue(value);
+}
+/**
+ * Evaluates an AST node and returns the raw value.
+ */
+function evaluateNode(node, context) {
+    switch (node.type) {
+        case 'literal':
+            return node.value;
+        case 'path':
+            return evaluatePath(node.path, node.absolute, context);
+        case 'functionCall':
+            return evaluateFunctionCall(node.name, node.args, context);
+        case 'interpolatedString':
+            return evaluateInterpolatedString(node, context);
+        default:
+            return '';
+    }
+}
+/**
+ * Evaluates a path and resolves it against the data model.
+ * Note: JSON Pointer escape sequences (~0, ~1) are decoded by getValueByPath
+ * via parseJsonPointer in pathUtils.ts.
+ */
+function evaluatePath(path, absolute, context) {
+    // Resolve relative paths
+    let resolvedPath;
+    if (absolute) {
+        resolvedPath = path;
+    }
+    else {
+        resolvedPath = resolvePath(path, context.basePath);
+    }
+    return getValueByPath(context.dataModel, resolvedPath);
+}
+/**
+ * Evaluates a function call with its arguments.
+ */
+function evaluateFunctionCall(name, args, context) {
+    // Look up function in custom registry
+    const fn = context.functions?.[name];
+    if (!fn) {
+        console.warn(`[A2UI] Unknown function: ${name}`);
+        return '';
+    }
+    // Evaluate all arguments
+    const evaluatedArgs = args.map((arg) => evaluateNode(arg, context));
+    // Call the function
+    try {
+        return fn(...evaluatedArgs);
+    }
+    catch (error) {
+        console.warn(`[A2UI] Function error in ${name}:`, error);
+        return '';
+    }
+}
+/**
+ * Evaluates an interpolated string by concatenating all parts.
+ */
+function evaluateInterpolatedString(node, context) {
+    return node.parts
+        .map((part) => stringifyValue(evaluateNode(part, context)))
+        .join('');
+}
+/**
+ * Converts a value to string for output.
+ */
+function stringifyValue(value) {
+    if (value === undefined || value === null) {
+        return '';
+    }
+    if (typeof value === 'string') {
+        return value;
+    }
+    if (typeof value === 'object') {
+        return JSON.stringify(value);
+    }
+    return String(value);
+}

package/dist/0.9/interpolation/evaluator.test.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Tests for the evaluator.
+ */
+export {};