@a2ui/web_core 0.8.0 → 0.9.0

package/src/v0_9/basic_catalog/expressions/expression_parser.js

@@ -0,0 +1,294 @@
+/*
+ * Copyright 2025 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { A2uiExpressionError } from '../../errors.js';
+/**
+ * A parser for A2UI expressions, supporting string interpolation and functional calls.
+ *
+ * The parser converts strings with `${...}` placeholders into arrays of `DynamicValue`s.
+ * It supports literals (strings, numbers, booleans), path-based data bindings, and
+ * nested function calls with named arguments.
+ */
+export class ExpressionParser {
+    /** The maximum allowed recursion depth for nested expressions to prevent stack overflows. */
+    static { this.MAX_DEPTH = 10; }
+    /**
+     * Parses an input string into an array of DynamicValues.
+     * If the input contains no interpolation, it returns the raw string as a single literal.
+     */
+    parse(input, depth = 0) {
+        if (depth > ExpressionParser.MAX_DEPTH) {
+            throw new A2uiExpressionError('Max recursion depth reached in parse');
+        }
+        if (!input || !input.includes('${')) {
+            return [input];
+        }
+        const parts = [];
+        const scanner = new Scanner(input);
+        while (!scanner.isAtEnd()) {
+            if (scanner.matches('${')) {
+                scanner.advance(2);
+                const content = this.extractInterpolationContent(scanner);
+                const parsed = this.parseExpression(content, depth + 1);
+                if (parsed !== null) {
+                    parts.push(parsed);
+                }
+            }
+            else if (scanner.peek() === '\\' &&
+                scanner.peek(1) === '$' &&
+                scanner.peek(2) === '{') {
+                scanner.advance();
+                parts.push('${');
+                scanner.advance(2);
+            }
+            else {
+                const start = scanner.pos;
+                while (!scanner.isAtEnd()) {
+                    if (scanner.matches('${')) {
+                        break;
+                    }
+                    if (scanner.peek() === '\\' &&
+                        scanner.peek(1) === '$' &&
+                        scanner.peek(2) === '{') {
+                        break;
+                    }
+                    scanner.advance();
+                }
+                parts.push(scanner.input.substring(start, scanner.pos));
+            }
+        }
+        return parts.filter(p => p !== null && p !== '');
+    }
+    extractInterpolationContent(scanner) {
+        const start = scanner.pos;
+        let braceBalance = 1;
+        while (!scanner.isAtEnd() && braceBalance > 0) {
+            const char = scanner.advance();
+            if (char === '{') {
+                braceBalance++;
+            }
+            else if (char === '}') {
+                braceBalance--;
+            }
+            else if (char === "'" || char === '"') {
+                const quote = char;
+                while (!scanner.isAtEnd()) {
+                    const c = scanner.advance();
+                    if (c === '\\') {
+                        scanner.advance();
+                    }
+                    else if (c === quote) {
+                        break;
+                    }
+                }
+            }
+        }
+        if (braceBalance > 0) {
+            throw new A2uiExpressionError("Unclosed interpolation: missing '}'");
+        }
+        return scanner.input.substring(start, scanner.pos - 1);
+    }
+    /**
+     * Parses a single expression string into a DynamicValue.
+     *
+     * Unlike `parse()`, which handles mixed literal text and interpolations,
+     * this assumes the entire string is a single expression (e.g., as found inside `${...}`).
+     *
+     * @param expr The expression string to parse.
+     * @param depth The current recursion depth.
+     * @returns The resolved DynamicValue.
+     */
+    parseExpression(expr, depth = 0) {
+        expr = expr.trim();
+        if (!expr)
+            return '';
+        const scanner = new Scanner(expr);
+        const result = this.parseExpressionInternal(scanner, depth);
+        if (!scanner.isAtEnd()) {
+            throw new A2uiExpressionError(`Unexpected characters at end of expression: '${scanner.input.substring(scanner.pos)}'`);
+        }
+        return result;
+    }
+    parseExpressionInternal(scanner, depth) {
+        scanner.skipWhitespace();
+        if (scanner.isAtEnd())
+            return '';
+        // 0. Nested Interpolation (Block)
+        if (scanner.matches('${')) {
+            scanner.advance(2);
+            const content = this.extractInterpolationContent(scanner);
+            return this.parseExpression(content, depth + 1);
+        }
+        // 1. Literals
+        if (scanner.matchesString("'") || scanner.matchesString('"')) {
+            return this.parseStringLiteral(scanner);
+        }
+        if (this.isDigit(scanner.peek())) {
+            return this.parseNumberLiteral(scanner);
+        }
+        if (scanner.matchesKeyword('true'))
+            return true;
+        if (scanner.matchesKeyword('false'))
+            return false;
+        if (scanner.matchesKeyword('null'))
+            return '';
+        // 2. Identifiers (Function calls or Path starts)
+        const token = this.scanPathOrIdentifier(scanner);
+        scanner.skipWhitespace();
+        if (scanner.peek() === '(') {
+            return this.parseFunctionCall(token, scanner, depth);
+        }
+        else {
+            if (!token) {
+                return '';
+            }
+            return { path: token };
+        }
+    }
+    scanPathOrIdentifier(scanner) {
+        const start = scanner.pos;
+        while (!scanner.isAtEnd()) {
+            const c = scanner.peek();
+            if (this.isAlnum(c) || c === '/' || c === '.' || c === '_' || c === '-') {
+                scanner.advance();
+            }
+            else {
+                break;
+            }
+        }
+        return scanner.input.substring(start, scanner.pos);
+    }
+    parseFunctionCall(funcName, scanner, depth) {
+        scanner.match('(');
+        scanner.skipWhitespace();
+        const args = {};
+        while (!scanner.isAtEnd() && scanner.peek() !== ')') {
+            const argName = this.scanIdentifier(scanner);
+            scanner.skipWhitespace();
+            if (!scanner.match(':')) {
+                throw new A2uiExpressionError(`Expected ':' after argument name '${argName}' in function '${funcName}'`);
+            }
+            scanner.skipWhitespace();
+            args[argName] = this.parseExpressionInternal(scanner, depth);
+            scanner.skipWhitespace();
+            if (scanner.peek() === ',') {
+                scanner.advance();
+                scanner.skipWhitespace();
+            }
+        }
+        if (!scanner.match(')')) {
+            throw new A2uiExpressionError(`Expected ')' after function arguments for '${funcName}'`);
+        }
+        return { call: funcName, args, returnType: 'any' };
+    }
+    scanIdentifier(scanner) {
+        const start = scanner.pos;
+        while (!scanner.isAtEnd() &&
+            (this.isAlnum(scanner.peek()) || scanner.peek() === '_')) {
+            scanner.advance();
+        }
+        return scanner.input.substring(start, scanner.pos);
+    }
+    parseStringLiteral(scanner) {
+        const quote = scanner.advance();
+        let result = '';
+        while (!scanner.isAtEnd()) {
+            const c = scanner.advance();
+            if (c === '\\') {
+                const next = scanner.advance();
+                if (next === 'n')
+                    result += '\n';
+                else if (next === 't')
+                    result += '\t';
+                else if (next === 'r')
+                    result += '\r';
+                else
+                    result += next;
+            }
+            else if (c === quote) {
+                break;
+            }
+            else {
+                result += c;
+            }
+        }
+        return result;
+    }
+    parseNumberLiteral(scanner) {
+        const start = scanner.pos;
+        while (!scanner.isAtEnd() &&
+            (this.isDigit(scanner.peek()) || scanner.peek() === '.')) {
+            scanner.advance();
+        }
+        return Number(scanner.input.substring(start, scanner.pos));
+    }
+    isAlnum(c) {
+        return ((c >= 'a' && c <= 'z') || (c >= 'A' && c <= 'Z') || (c >= '0' && c <= '9'));
+    }
+    isDigit(c) {
+        return c >= '0' && c <= '9';
+    }
+}
+class Scanner {
+    constructor(input) {
+        this.input = input;
+        this.pos = 0;
+    }
+    isAtEnd() {
+        return this.pos >= this.input.length;
+    }
+    peek(offset = 0) {
+        if (this.pos + offset >= this.input.length)
+            return '\0';
+        return this.input[this.pos + offset];
+    }
+    advance(count = 1) {
+        const char = this.input.substring(this.pos, this.pos + count);
+        this.pos += count;
+        return char;
+    }
+    match(expected) {
+        if (this.peek() === expected) {
+            this.advance();
+            return true;
+        }
+        return false;
+    }
+    matches(expected) {
+        if (this.input.startsWith(expected, this.pos)) {
+            return true;
+        }
+        return false;
+    }
+    matchesString(expected) {
+        return this.peek() === expected;
+    }
+    matchesKeyword(keyword) {
+        if (this.input.startsWith(keyword, this.pos)) {
+            const next = this.peek(keyword.length);
+            if (!/[a-zA-Z0-9_]/.test(next)) {
+                this.advance(keyword.length);
+                return true;
+            }
+        }
+        return false;
+    }
+    skipWhitespace() {
+        while (!this.isAtEnd() && /\s/.test(this.peek())) {
+            this.advance();
+        }
+    }
+}
+//# sourceMappingURL=expression_parser.js.map

package/src/v0_9/basic_catalog/expressions/expression_parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"expression_parser.js","sourceRoot":"","sources":["../../../../../src/v0_9/basic_catalog/expressions/expression_parser.ts"],"names":[],"mappings":"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"}

package/src/v0_9/basic_catalog/expressions/expression_parser.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=expression_parser.test.d.ts.map

package/src/v0_9/basic_catalog/expressions/expression_parser.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"expression_parser.test.d.ts","sourceRoot":"","sources":["../../../../../src/v0_9/basic_catalog/expressions/expression_parser.test.ts"],"names":[],"mappings":""}

package/src/v0_9/basic_catalog/expressions/expression_parser.test.js

@@ -0,0 +1,126 @@
+/*
+ * Copyright 2025 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { describe, it, beforeEach } from 'node:test';
+import * as assert from 'node:assert';
+import { ExpressionParser } from './expression_parser.js';
+describe('ExpressionParser', () => {
+    let parser;
+    beforeEach(() => {
+        parser = new ExpressionParser();
+    });
+    it('parses literal strings unchanged', () => {
+        assert.deepStrictEqual(parser.parse('hello world'), ['hello world']);
+    });
+    it('parses simple interpolation', () => {
+        assert.deepStrictEqual(parser.parse('hello ${foo}'), [
+            'hello ',
+            { path: 'foo' },
+        ]);
+    });
+    it('parses number interpolation', () => {
+        assert.deepStrictEqual(parser.parse('number is ${num}'), [
+            'number is ',
+            { path: 'num' },
+        ]);
+    });
+    it('parses nested interpolation', () => {
+        // Nested interpolations don't evaluate immediately, they parse into paths of paths, but currently parser doesn't do deep AST for 'val is ${${nested}}' properly if it's not a function.
+        // Wait, the parser extracts content. Let's see what `val is ${${nested}}` parses to:
+        // It extracts `${nested}` and parses it. That evaluates to `{ path: "${nested}" }` or something.
+        // Actually, `parseExpression("${nested}")` will recursively call `parseExpression("nested")` and return `{ path: "nested" }`.
+        assert.deepStrictEqual(parser.parse('val is ${${nested}}'), [
+            'val is ',
+            { path: 'nested' },
+        ]);
+    });
+    it('handles escaped interpolation', () => {
+        assert.deepStrictEqual(parser.parse('escaped \\${foo}'), [
+            'escaped ',
+            '${',
+            'foo}',
+        ]);
+    });
+    it('parses function calls', () => {
+        assert.deepStrictEqual(parser.parse('sum is ${add(a: 10, b: 20)}'), [
+            'sum is ',
+            { call: 'add', args: { a: 10, b: 20 }, returnType: 'any' },
+        ]);
+    });
+    it('parses function calls with string literals', () => {
+        assert.deepStrictEqual(parser.parse('case is ${upper(text: "hello")}'), [
+            'case is ',
+            { call: 'upper', args: { text: 'hello' }, returnType: 'any' },
+        ]);
+    });
+    it('parses keywords', () => {
+        assert.deepStrictEqual(parser.parse('${true} ${false} ${null}'), [
+            true,
+            ' ',
+            false,
+            ' ',
+        ]);
+    });
+    it('returns error on max depth exceeded', () => {
+        assert.throws(() => {
+            parser.parse('depth', 11);
+        }, /Max recursion depth reached/);
+    });
+    it('handles deep recursion gracefully', () => {
+        assert.deepStrictEqual(parser.parse('${${"hello"}}'), ['hello']);
+    });
+    it('returns error on unclosed interpolation', () => {
+        assert.throws(() => {
+            parser.parse('hello ${world');
+        }, /Unclosed interpolation/);
+    });
+    it('returns error on invalid function syntax', () => {
+        // Missing closing parenthesis
+        assert.throws(() => {
+            parser.parse('${add(a: 1, b: 2}');
+        }, /Expected '\)'/);
+    });
+    it('returns error on unexpected characters at end', () => {
+        // Extra garbage after valid expression inside interpolation
+        assert.throws(() => {
+            parser.parse('${true false}');
+        }, /Unexpected characters/);
+    });
+    it('handles empty identifiers', () => {
+        assert.deepStrictEqual(parser.parse('${()}'), [
+            { call: '', args: {}, returnType: 'any' },
+        ]);
+        assert.deepStrictEqual(parser.parseExpression(''), '');
+        assert.deepStrictEqual(parser.parseExpression('()'), {
+            call: '',
+            args: {},
+            returnType: 'any',
+        });
+    });
+    it('handles string literals with escaped characters', () => {
+        assert.deepStrictEqual(parser.parseExpression("'line1\\nline2\\t\\r\\'\\\\x'"), "line1\nline2\t\r'\\x");
+    });
+    it('handles parsing paths with special characters', () => {
+        assert.deepStrictEqual(parser.parseExpression('my-path.with_underscores'), {
+            path: 'my-path.with_underscores',
+        });
+    });
+    it('returns error on missing colon in function args', () => {
+        assert.throws(() => {
+            parser.parseExpression('add(a 10, b: 20)');
+        }, /Expected ':'/);
+    });
+});
+//# sourceMappingURL=expression_parser.test.js.map

package/src/v0_9/basic_catalog/expressions/expression_parser.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"expression_parser.test.js","sourceRoot":"","sources":["../../../../../src/v0_9/basic_catalog/expressions/expression_parser.test.ts"],"names":[],"mappings":"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"}

package/src/v0_9/basic_catalog/functions/basic_functions.d.ts

@@ -0,0 +1,32 @@
+import { FunctionImplementation } from '../../catalog/types.js';
+export declare const AddImplementation: FunctionImplementation;
+export declare const SubtractImplementation: FunctionImplementation;
+export declare const MultiplyImplementation: FunctionImplementation;
+export declare const DivideImplementation: FunctionImplementation;
+export declare const EqualsImplementation: FunctionImplementation;
+export declare const NotEqualsImplementation: FunctionImplementation;
+export declare const GreaterThanImplementation: FunctionImplementation;
+export declare const LessThanImplementation: FunctionImplementation;
+export declare const AndImplementation: FunctionImplementation;
+export declare const OrImplementation: FunctionImplementation;
+export declare const NotImplementation: FunctionImplementation;
+export declare const ContainsImplementation: FunctionImplementation;
+export declare const StartsWithImplementation: FunctionImplementation;
+export declare const EndsWithImplementation: FunctionImplementation;
+export declare const RequiredImplementation: FunctionImplementation;
+export declare const RegexImplementation: FunctionImplementation;
+export declare const LengthImplementation: FunctionImplementation;
+export declare const NumericImplementation: FunctionImplementation;
+export declare const EmailImplementation: FunctionImplementation;
+export declare const FormatStringImplementation: FunctionImplementation;
+export declare const FormatNumberImplementation: FunctionImplementation;
+export declare const FormatCurrencyImplementation: FunctionImplementation;
+export declare const FormatDateImplementation: FunctionImplementation;
+export declare const PluralizeImplementation: FunctionImplementation;
+export declare const OpenUrlImplementation: FunctionImplementation;
+/**
+ * Standard function implementations for the Basic Catalog.
+ * These functions cover arithmetic, comparison, logic, string manipulation, validation, and formatting.
+ */
+export declare const BASIC_FUNCTIONS: FunctionImplementation[];
+//# sourceMappingURL=basic_functions.d.ts.map

package/src/v0_9/basic_catalog/functions/basic_functions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"basic_functions.d.ts","sourceRoot":"","sources":["../../../../../src/v0_9/basic_catalog/functions/basic_functions.ts"],"names":[],"mappings":"AAkBA,OAAO,EAEL,sBAAsB,EAEvB,MAAM,wBAAwB,CAAC;AAgChC,eAAO,MAAM,iBAAiB,wBAG7B,CAAC;AACF,eAAO,MAAM,sBAAsB,wBAGlC,CAAC;AACF,eAAO,MAAM,sBAAsB,wBAGlC,CAAC;AACF,eAAO,MAAM,oBAAoB,wBAkBhC,CAAC;AAGF,eAAO,MAAM,oBAAoB,wBAGhC,CAAC;AACF,eAAO,MAAM,uBAAuB,wBAGnC,CAAC;AACF,eAAO,MAAM,yBAAyB,wBAGrC,CAAC;AACF,eAAO,MAAM,sBAAsB,wBAGlC,CAAC;AAGF,eAAO,MAAM,iBAAiB,wBAE5B,CAAC;AACH,eAAO,MAAM,gBAAgB,wBAE3B,CAAC;AACH,eAAO,MAAM,iBAAiB,wBAG7B,CAAC;AAGF,eAAO,MAAM,sBAAsB,wBAGlC,CAAC;AACF,eAAO,MAAM,wBAAwB,wBAGpC,CAAC;AACF,eAAO,MAAM,sBAAsB,wBAGlC,CAAC;AAGF,eAAO,MAAM,sBAAsB,wBASlC,CAAC;AACF,eAAO,MAAM,mBAAmB,wBAa/B,CAAC;AACF,eAAO,MAAM,oBAAoB,wBAchC,CAAC;AACF,eAAO,MAAM,qBAAqB,wBAUjC,CAAC;AACF,eAAO,MAAM,mBAAmB,wBAQ/B,CAAC;AAGF,eAAO,MAAM,0BAA0B,wBA4BtC,CAAC;AACF,eAAO,MAAM,0BAA0B,wBAUtC,CAAC;AACF,eAAO,MAAM,4BAA4B,wBAgBxC,CAAC;AACF,eAAO,MAAM,wBAAwB,wBAepC,CAAC;AACF,eAAO,MAAM,uBAAuB,wBAMnC,CAAC;AAGF,eAAO,MAAM,qBAAqB,wBAOjC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAE,sBAAsB,EA0BnD,CAAC"}