@a2ui/web_core 0.8.0 → 0.9.1-alpha.0

package/src/v0_9/basic_catalog/functions/basic_functions.js

@@ -0,0 +1,316 @@
+/*
+ * 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 { ExpressionParser } from '../expressions/expression_parser.js';
+import { computed } from '@preact/signals-core';
+import { createFunctionImplementation, isSignal, } from '../../catalog/types.js';
+import { format } from 'date-fns';
+import { AddApi, SubtractApi, MultiplyApi, DivideApi, EqualsApi, NotEqualsApi, GreaterThanApi, LessThanApi, AndApi, OrApi, NotApi, ContainsApi, StartsWithApi, EndsWithApi, RequiredApi, RegexApi, LengthApi, NumericApi, EmailApi, FormatStringApi, FormatNumberApi, FormatCurrencyApi, FormatDateApi, PluralizeApi, OpenUrlApi, } from './basic_functions_api.js';
+import { A2uiExpressionError } from '../../errors.js';
+// Arithmetic
+/**
+ * Implementation of the addition function.
+ * Adds two numbers 'a' and 'b'.
+ */
+export const AddImplementation = createFunctionImplementation(AddApi, args => args.a + args.b);
+/**
+ * Implementation of the subtraction function.
+ * Subtracts 'b' from 'a'.
+ */
+export const SubtractImplementation = createFunctionImplementation(SubtractApi, args => args.a - args.b);
+/**
+ * Implementation of the multiplication function.
+ * Multiplies 'a' and 'b'.
+ */
+export const MultiplyImplementation = createFunctionImplementation(MultiplyApi, args => args.a * args.b);
+/**
+ * Implementation of the division function.
+ * Divides 'a' by 'b'. Returns NaN if inputs are invalid, and Infinity if dividing by zero.
+ */
+export const DivideImplementation = createFunctionImplementation(DivideApi, args => {
+    const a = args.a;
+    const b = args.b;
+    if (a === undefined || a === null || b === undefined || b === null) {
+        return NaN;
+    }
+    const numA = Number(a);
+    const numB = Number(b);
+    if (Number.isNaN(numA) || Number.isNaN(numB)) {
+        return NaN;
+    }
+    if (numB === 0) {
+        return Infinity;
+    }
+    return numA / numB;
+});
+// Comparison
+/**
+ * Implementation of the equality comparison.
+ * Checks if 'a' is strictly equal to 'b'.
+ */
+export const EqualsImplementation = createFunctionImplementation(EqualsApi, args => args.a === args.b);
+/**
+ * Implementation of the inequality comparison.
+ * Checks if 'a' is not strictly equal to 'b'.
+ */
+export const NotEqualsImplementation = createFunctionImplementation(NotEqualsApi, args => args.a !== args.b);
+/**
+ * Implementation of the greater-than comparison.
+ * Checks if 'a' is greater than 'b'.
+ */
+export const GreaterThanImplementation = createFunctionImplementation(GreaterThanApi, args => args.a > args.b);
+/**
+ * Implementation of the less-than comparison.
+ * Checks if 'a' is less than 'b'.
+ */
+export const LessThanImplementation = createFunctionImplementation(LessThanApi, args => args.a < args.b);
+// Logical
+/**
+ * Implementation of the logical AND function.
+ * Returns true if all values in the array are truthy.
+ */
+export const AndImplementation = createFunctionImplementation(AndApi, args => {
+    return args.values.every((v) => !!v);
+});
+/**
+ * Implementation of the logical OR function.
+ * Returns true if at least one value in the array is truthy.
+ */
+export const OrImplementation = createFunctionImplementation(OrApi, args => {
+    return args.values.some((v) => !!v);
+});
+/**
+ * Implementation of the logical NOT function.
+ * Returns the negation of the value.
+ */
+export const NotImplementation = createFunctionImplementation(NotApi, args => !args.value);
+// String
+/**
+ * Implementation of the string contains function.
+ * Checks if 'string' contains 'substring'.
+ */
+export const ContainsImplementation = createFunctionImplementation(ContainsApi, args => args.string.includes(args.substring));
+/**
+ * Implementation of the string starts-with function.
+ * Checks if 'string' starts with 'prefix'.
+ */
+export const StartsWithImplementation = createFunctionImplementation(StartsWithApi, args => args.string.startsWith(args.prefix));
+/**
+ * Implementation of the string ends-with function.
+ * Checks if 'string' ends with 'suffix'.
+ */
+export const EndsWithImplementation = createFunctionImplementation(EndsWithApi, args => args.string.endsWith(args.suffix));
+// Validation
+/**
+ * Implementation of the required validation function.
+ * Checks if the value is not null, undefined, empty string, or empty array.
+ */
+export const RequiredImplementation = createFunctionImplementation(RequiredApi, args => {
+    const val = args.value;
+    if (val === null || val === undefined)
+        return false;
+    if (typeof val === 'string' && val === '')
+        return false;
+    if (Array.isArray(val) && val.length === 0)
+        return false;
+    return true;
+});
+/**
+ * Implementation of the regex validation function.
+ * Checks if the value matches the regular expression pattern.
+ * Throws A2uiExpressionError if the pattern is invalid.
+ */
+export const RegexImplementation = createFunctionImplementation(RegexApi, args => {
+    try {
+        return new RegExp(args.pattern).test(args.value);
+    }
+    catch (e) {
+        throw new A2uiExpressionError(`Invalid regex pattern: ${args.pattern}`, 'regex', e);
+    }
+});
+/**
+ * Implementation of the length validation function.
+ * Checks if the length of the string or array is within [min, max] range.
+ */
+export const LengthImplementation = createFunctionImplementation(LengthApi, args => {
+    const val = args.value;
+    let len = 0;
+    if (typeof val === 'string' || Array.isArray(val)) {
+        len = val.length;
+    }
+    if (args.min !== undefined && !isNaN(args.min) && len < args.min)
+        return false;
+    if (args.max !== undefined && !isNaN(args.max) && len > args.max)
+        return false;
+    return true;
+});
+/**
+ * Implementation of the numeric validation function.
+ * Checks if the value is a number and within [min, max] range.
+ */
+export const NumericImplementation = createFunctionImplementation(NumericApi, args => {
+    if (isNaN(args.value))
+        return false;
+    if (args.min !== undefined && !isNaN(args.min) && args.value < args.min)
+        return false;
+    if (args.max !== undefined && !isNaN(args.max) && args.value > args.max)
+        return false;
+    return true;
+});
+/**
+ * Implementation of the email validation function.
+ * Uses a simple regex to check if the value looks like an email address.
+ * Note: This is a basic check and not fully compliant with all email standards.
+ */
+export const EmailImplementation = createFunctionImplementation(EmailApi, args => {
+    // TODO(gspencergoog): Use a "real" email validation function, preferably
+    // from an existing package. This is woefully insufficient, real email
+    // validation can't be done with a regex.
+    return /^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}$/.test(args.value);
+});
+// Formatting
+/**
+ * Implementation of the string formatting function.
+ * Parses a template string and resolves any embedded expressions using the provided context.
+ * Returns a computed signal that updates when referenced signals change.
+ */
+export const FormatStringImplementation = createFunctionImplementation(FormatStringApi, (args, context) => {
+    const template = args.value;
+    const parser = new ExpressionParser();
+    const parts = parser.parse(template);
+    if (parts.length === 0)
+        return '';
+    const dynamicParts = parts.map(part => {
+        // If it's a literal string (or number/boolean/etc), keep it as is
+        if (typeof part !== 'object' || part === null || Array.isArray(part)) {
+            return part;
+        }
+        return context.resolveSignal(part);
+    });
+    return computed(() => {
+        return dynamicParts
+            .map(p => {
+            if (isSignal(p)) {
+                return p.value;
+            }
+            return p;
+        })
+            .join('');
+    });
+});
+/**
+ * Implementation of the number formatting function.
+ * Formats a number using Intl.NumberFormat with specified decimals and grouping.
+ */
+export const FormatNumberImplementation = createFunctionImplementation(FormatNumberApi, args => {
+    if (isNaN(args.value))
+        return '';
+    return new Intl.NumberFormat('en-US', {
+        minimumFractionDigits: args.decimals,
+        maximumFractionDigits: args.decimals,
+        useGrouping: args.grouping,
+    }).format(args.value);
+});
+/**
+ * Implementation of the currency formatting function.
+ * Formats a number as currency using Intl.NumberFormat.
+ * Falls back to toFixed if formatting fails.
+ */
+export const FormatCurrencyImplementation = createFunctionImplementation(FormatCurrencyApi, args => {
+    if (isNaN(args.value))
+        return '';
+    try {
+        return new Intl.NumberFormat('en-US', {
+            style: 'currency',
+            currency: args.currency,
+            minimumFractionDigits: args.decimals,
+            maximumFractionDigits: args.decimals,
+            useGrouping: args.grouping,
+        }).format(args.value);
+    }
+    catch {
+        return args.value.toFixed(args.decimals || 2);
+    }
+});
+/**
+ * Implementation of the date formatting function.
+ * Formats a date using date-fns or returns ISO string.
+ */
+export const FormatDateImplementation = createFunctionImplementation(FormatDateApi, args => {
+    if (!args.value)
+        return '';
+    const date = new Date(args.value);
+    if (isNaN(date.getTime()))
+        return '';
+    try {
+        if (args.format === 'ISO')
+            return date.toISOString();
+        return format(date, args.format);
+    }
+    catch (e) {
+        console.warn('Error formatting date:', e);
+        return date.toISOString();
+    }
+});
+/**
+ * Implementation of the pluralization function.
+ * Selects the appropriate plural form based on the value using Intl.PluralRules.
+ */
+export const PluralizeImplementation = createFunctionImplementation(PluralizeApi, args => {
+    const rule = new Intl.PluralRules('en-US').select(args.value);
+    return String(args[rule] ?? args.other ?? '');
+});
+// Actions
+/**
+ * Implementation of the open URL action.
+ * Opens the specified URL in a new window/tab.
+ */
+export const OpenUrlImplementation = createFunctionImplementation(OpenUrlApi, args => {
+    if (args.url && typeof window !== 'undefined' && window.open) {
+        window.open(args.url, '_blank');
+    }
+});
+/**
+ * Standard function implementations for the Basic Catalog.
+ * These functions cover arithmetic, comparison, logic, string manipulation, validation, and formatting.
+ */
+export const BASIC_FUNCTIONS = [
+    AddImplementation,
+    SubtractImplementation,
+    MultiplyImplementation,
+    DivideImplementation,
+    EqualsImplementation,
+    NotEqualsImplementation,
+    GreaterThanImplementation,
+    LessThanImplementation,
+    AndImplementation,
+    OrImplementation,
+    NotImplementation,
+    ContainsImplementation,
+    StartsWithImplementation,
+    EndsWithImplementation,
+    RequiredImplementation,
+    RegexImplementation,
+    LengthImplementation,
+    NumericImplementation,
+    EmailImplementation,
+    FormatStringImplementation,
+    FormatNumberImplementation,
+    FormatCurrencyImplementation,
+    FormatDateImplementation,
+    PluralizeImplementation,
+    OpenUrlImplementation,
+];
+//# sourceMappingURL=basic_functions.js.map

package/src/v0_9/basic_catalog/functions/basic_functions.js.map

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

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

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

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

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

package/src/v0_9/basic_catalog/functions/basic_functions.test.js

@@ -0,0 +1,301 @@
+/*
+ * 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 } from 'node:test';
+import * as assert from 'node:assert';
+import { effect } from '@preact/signals-core';
+import { BASIC_FUNCTIONS } from './basic_functions.js';
+import { DataModel } from '../../state/data-model.js';
+import { DataContext } from '../../rendering/data-context.js';
+import { A2uiExpressionError } from '../../errors.js';
+import { Catalog } from '../../catalog/types.js';
+const testCatalog = new Catalog('test', [], BASIC_FUNCTIONS);
+function invoke(name, args, context) {
+    return testCatalog.invoker(name, args, context);
+}
+const createTestDataContext = (model, path, functionInvoker = testCatalog.invoker) => {
+    const mockSurface = {
+        dataModel: model,
+        catalog: { invoker: functionInvoker },
+        dispatchError: () => { },
+    };
+    return new DataContext(mockSurface, path);
+};
+describe('BASIC_FUNCTIONS', () => {
+    const dataModel = new DataModel({ a: 10, b: 20 });
+    const context = createTestDataContext(dataModel, '/');
+    describe('Arithmetic', () => {
+        it('add', () => {
+            assert.strictEqual(invoke('add', { a: 1, b: 2 }, context), 3);
+            assert.strictEqual(invoke('add', { a: '1', b: '2' }, context), 3);
+            assert.throws(() => invoke('add', { a: 10, b: undefined }, context), A2uiExpressionError);
+            assert.throws(() => invoke('add', { a: 10 }, context), A2uiExpressionError);
+        });
+        it('subtract', () => {
+            assert.strictEqual(invoke('subtract', { a: 5, b: 3 }, context), 2);
+            assert.throws(() => invoke('subtract', { a: 10, b: undefined }, context), A2uiExpressionError);
+            assert.throws(() => invoke('subtract', { a: 10 }, context), A2uiExpressionError);
+        });
+        it('multiply', () => {
+            assert.strictEqual(invoke('multiply', { a: 4, b: 2 }, context), 8);
+            assert.throws(() => invoke('multiply', { a: 10, b: undefined }, context), A2uiExpressionError);
+            assert.throws(() => invoke('multiply', { a: 10 }, context), A2uiExpressionError);
+        });
+        it('divide', () => {
+            assert.strictEqual(invoke('divide', { a: 10, b: 2 }, context), 5);
+            assert.strictEqual(invoke('divide', { a: 10, b: 0 }, context), Infinity);
+            assert.throws(() => invoke('divide', { a: 10, b: undefined }, context), A2uiExpressionError);
+            assert.throws(() => invoke('divide', { a: undefined, b: 10 }, context), A2uiExpressionError);
+            assert.throws(() => invoke('divide', { a: undefined, b: undefined }, context), A2uiExpressionError);
+            assert.throws(() => invoke('divide', { a: 10, b: null }, context), A2uiExpressionError);
+            assert.throws(() => invoke('divide', { a: 10, b: 'invalid' }, context), A2uiExpressionError);
+            assert.strictEqual(invoke('divide', { a: 10, b: '2' }, context), 5);
+            assert.strictEqual(invoke('divide', { a: '10', b: '2' }, context), 5);
+        });
+    });
+    describe('Comparison', () => {
+        it('equals', () => {
+            assert.strictEqual(invoke('equals', { a: 1, b: 1 }, context), true);
+            assert.strictEqual(invoke('equals', { a: 1, b: 2 }, context), false);
+            assert.throws(() => invoke('equals', { a: 1 }, context), A2uiExpressionError);
+            assert.throws(() => invoke('equals', { b: 1 }, context), A2uiExpressionError);
+        });
+        it('not_equals', () => {
+            assert.strictEqual(invoke('not_equals', { a: 1, b: 2 }, context), true);
+            assert.throws(() => invoke('not_equals', { a: 1 }, context), A2uiExpressionError);
+            assert.throws(() => invoke('not_equals', { b: 1 }, context), A2uiExpressionError);
+        });
+        it('greater_than', () => {
+            assert.strictEqual(invoke('greater_than', { a: 5, b: 3 }, context), true);
+            assert.strictEqual(invoke('greater_than', { a: 3, b: 5 }, context), false);
+            assert.throws(() => invoke('greater_than', { a: 10, b: undefined }, context), A2uiExpressionError);
+            assert.throws(() => invoke('greater_than', { a: 10, b: null }, context), A2uiExpressionError);
+            assert.throws(() => invoke('greater_than', { a: 10, b: 'invalid' }, context), A2uiExpressionError);
+            assert.throws(() => invoke('greater_than', { a: 10 }, context), A2uiExpressionError);
+            assert.throws(() => invoke('greater_than', { b: 10 }, context), A2uiExpressionError);
+        });
+        it('less_than', () => {
+            assert.strictEqual(invoke('less_than', { a: 3, b: 5 }, context), true);
+            assert.throws(() => invoke('less_than', { a: 3, b: undefined }, context), A2uiExpressionError);
+            assert.throws(() => invoke('less_than', { a: 3, b: null }, context), A2uiExpressionError);
+            assert.throws(() => invoke('less_than', { a: 3, b: 'invalid' }, context), A2uiExpressionError);
+            assert.throws(() => invoke('less_than', { a: 3 }, context), A2uiExpressionError);
+            assert.throws(() => invoke('less_than', { b: 3 }, context), A2uiExpressionError);
+        });
+    });
+    describe('Logical', () => {
+        it('and', () => {
+            // Checks args['values'] array OR args['a'] && args['b'].
+            assert.strictEqual(invoke('and', { values: [true, true] }, context), true);
+            assert.strictEqual(invoke('and', { values: [true, false] }, context), false);
+            assert.throws(() => invoke('and', { values: [true] }, context), A2uiExpressionError);
+            assert.throws(() => invoke('and', {}, context), A2uiExpressionError);
+        });
+        it('or', () => {
+            assert.strictEqual(invoke('or', { values: [false, true] }, context), true);
+            assert.strictEqual(invoke('or', { values: [false, false] }, context), false);
+            assert.throws(() => invoke('or', { values: [true] }, context), A2uiExpressionError);
+            assert.throws(() => invoke('or', {}, context), A2uiExpressionError);
+        });
+        it('not', () => {
+            assert.strictEqual(invoke('not', { value: false }, context), true);
+            assert.strictEqual(invoke('not', { value: true }, context), false);
+            assert.throws(() => invoke('not', {}, context), A2uiExpressionError);
+        });
+    });
+    describe('String', () => {
+        it('contains', () => {
+            assert.strictEqual(invoke('contains', { string: 'hello world', substring: 'world' }, context), true);
+            assert.strictEqual(invoke('contains', { string: 'hello world', substring: 'foo' }, context), false);
+            assert.throws(() => invoke('contains', { string: 'hello' }, context), A2uiExpressionError);
+            assert.throws(() => invoke('contains', { substring: 'hello' }, context), A2uiExpressionError);
+        });
+        it('starts_with', () => {
+            assert.strictEqual(invoke('starts_with', { string: 'hello', prefix: 'he' }, context), true);
+            assert.throws(() => invoke('starts_with', { string: 'hello' }, context), A2uiExpressionError);
+            assert.throws(() => invoke('starts_with', { prefix: 'he' }, context), A2uiExpressionError);
+        });
+        it('ends_with', () => {
+            assert.strictEqual(invoke('ends_with', { string: 'hello', suffix: 'lo' }, context), true);
+            assert.throws(() => invoke('ends_with', { string: 'hello' }, context), A2uiExpressionError);
+            assert.throws(() => invoke('ends_with', { suffix: 'lo' }, context), A2uiExpressionError);
+        });
+    });
+    describe('Validation', () => {
+        it('required', () => {
+            assert.strictEqual(invoke('required', { value: 'a' }, context), true);
+            assert.strictEqual(invoke('required', { value: '' }, context), false);
+            assert.strictEqual(invoke('required', { value: null }, context), false);
+            assert.throws(() => invoke('required', {}, context), A2uiExpressionError);
+        });
+        it('length', () => {
+            assert.strictEqual(invoke('length', { value: 'abc', min: 2 }, context), true);
+            assert.strictEqual(invoke('length', { value: 'abc', max: 2 }, context), false);
+            assert.throws(() => invoke('length', {}, context), A2uiExpressionError);
+        });
+        it('numeric', () => {
+            assert.strictEqual(invoke('numeric', { value: 10, min: 5, max: 15 }, context), true);
+            assert.strictEqual(invoke('numeric', { value: 3, min: 5 }, context), false);
+            assert.throws(() => invoke('numeric', {}, context), A2uiExpressionError);
+        });
+        it('email', () => {
+            assert.strictEqual(invoke('email', { value: 'test@example.com' }, context), true);
+            assert.strictEqual(invoke('email', { value: 'test.name@example.com' }, context), true);
+            assert.strictEqual(invoke('email', { value: 'test+label@example.com' }, context), true);
+            assert.strictEqual(invoke('email', { value: 'test@example-domain.com' }, context), true);
+            assert.strictEqual(invoke('email', { value: 'invalid' }, context), false);
+            assert.strictEqual(invoke('email', { value: 'test@test' }, context), false);
+            assert.strictEqual(invoke('email', { value: 'test@test.c' }, context), false);
+            assert.strictEqual(invoke('email', { value: 'test@.com' }, context), false);
+            assert.throws(() => invoke('email', {}, context), A2uiExpressionError);
+        });
+        it('regex', () => {
+            assert.strictEqual(invoke('regex', { value: 'abc', pattern: '^[a-z]+$' }, context), true);
+            assert.strictEqual(invoke('regex', { value: '123', pattern: '^[a-z]+$' }, context), false);
+        });
+        it('regex handles invalid pattern', () => {
+            assert.throws(() => invoke('regex', { value: 'abc', pattern: '[' }, context), A2uiExpressionError);
+        });
+    });
+    describe('Formatting', () => {
+        it('formatString (static literal)', (_, done) => {
+            const result = invoke('formatString', { value: 'hello world' }, context);
+            let cleanup;
+            // Required to pass a reference to cleanup() into th effect(). Probably
+            // worth cleaning up at some point.
+            // eslint-disable-next-line prefer-const
+            cleanup = effect(() => {
+                const val = result.value;
+                if (val) {
+                    assert.strictEqual(val, 'hello world');
+                    if (cleanup)
+                        cleanup();
+                    done();
+                }
+            });
+        });
+        it('formatString (with data binding)', (_, done) => {
+            // Assuming dataModel has { "a": 10 } from setup
+            const result = invoke('formatString', { value: 'Value: ${a}' }, context);
+            let emitCount = 0;
+            let cleanup;
+            // Required to pass a reference to cleanup() into th effect(). Probably
+            // worth cleaning up at some point.
+            // eslint-disable-next-line prefer-const
+            cleanup = effect(() => {
+                const val = result.value;
+                try {
+                    if (emitCount === 0) {
+                        assert.strictEqual(val, 'Value: 10');
+                        emitCount++;
+                        // Trigger a change in the next tick to avoid uninitialized sub
+                        setTimeout(() => {
+                            dataModel.set('/a', 42);
+                        }, 0);
+                    }
+                    else if (emitCount === 1) {
+                        assert.strictEqual(val, 'Value: 42');
+                        emitCount++;
+                        if (cleanup)
+                            cleanup();
+                        done();
+                    }
+                }
+                catch (e) {
+                    if (cleanup)
+                        cleanup();
+                    done(e);
+                }
+            });
+        });
+        it('formatString (with function call)', (_, done) => {
+            // Need a functionInvoker for function calls
+            const ctxWithInvoker = createTestDataContext(dataModel, '/', (name, args) => {
+                if (name === 'add') {
+                    return Number(args['a']) + Number(args['b']);
+                }
+                return null;
+            });
+            const result = invoke('formatString', { value: 'Result: ${add(a: 5, b: 7)}' }, ctxWithInvoker);
+            let cleanup;
+            // Required to pass a reference to cleanup() into th effect(). Probably
+            // worth cleaning up at some point.
+            // eslint-disable-next-line prefer-const
+            cleanup = effect(() => {
+                const val = result.value;
+                if (val) {
+                    assert.strictEqual(val, 'Result: 12');
+                    if (cleanup)
+                        cleanup();
+                    done();
+                }
+            });
+        });
+        it('formatNumber', () => {
+            // Test basic output as Intl behavior varies by environment.
+            const result = invoke('formatNumber', { value: 1234.56, decimals: 1 }, context);
+            assert.ok(typeof result === 'string');
+            assert.ok(result.includes('1,234.6') ||
+                result.includes('1234.6') ||
+                result.includes('1 234,6'));
+        });
+        it('formatCurrency', () => {
+            const result = invoke('formatCurrency', { value: 1234.56, currency: 'USD' }, context);
+            assert.ok(typeof result === 'string');
+            assert.ok(result.includes('1,234.56') || result.includes('1234.56'));
+            assert.ok(result.includes('$') || result.includes('USD'));
+        });
+        it('formatDate', () => {
+            const result = invoke('formatDate', { value: '2025-01-01T12:00:00Z', format: 'yyyy-MM-dd' }, context);
+            assert.strictEqual(result, '2025-01-01');
+            const resultISO = invoke('formatDate', { value: '2025-01-01T12:00:00Z', format: 'ISO' }, context);
+            assert.strictEqual(resultISO, '2025-01-01T12:00:00.000Z');
+        });
+        it('formatDate handles invalid dates', () => {
+            const result = invoke('formatDate', { value: 'invalid-date', format: 'yyyy' }, context);
+            assert.strictEqual(result, '');
+        });
+        it('formatCurrency fallback on formatting error', () => {
+            const result = invoke('formatCurrency', { value: 1234.56, currency: 'INVALID-CURRENCY', decimals: 2 }, context);
+            // Fallbacks to toFixed
+            assert.strictEqual(result, '1234.56');
+        });
+        it('pluralize', () => {
+            assert.strictEqual(invoke('pluralize', { value: 1, one: 'apple', other: 'apples' }, context), 'apple');
+            assert.strictEqual(invoke('pluralize', { value: 2, one: 'apple', other: 'apples' }, context), 'apples');
+        });
+    });
+    describe('Actions', () => {
+        it('openUrl', () => {
+            // Set up mock window object
+            const originalWindow = global.window;
+            let openedUrl = '';
+            global.window = {
+                open: (url) => {
+                    openedUrl = url;
+                },
+            };
+            try {
+                invoke('openUrl', { url: 'https://google.com' }, context);
+                assert.strictEqual(openedUrl, 'https://google.com');
+                assert.throws(() => invoke('openUrl', {}, context), A2uiExpressionError);
+            }
+            finally {
+                global.window = originalWindow;
+            }
+        });
+    });
+});
+//# sourceMappingURL=basic_functions.test.js.map