@threadplane/a2ui 0.0.57 → 0.0.58

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@threadplane/a2ui",
-  "version": "0.0.57",
+  "version": "0.0.58",
   "license": "MIT",
   "repository": {
     "type": "git",

package/src/index.d.ts

@@ -1,8 +1,11 @@
-export type { A2uiTheme, DynamicString, DynamicNumber, DynamicBoolean, DynamicStringList, A2uiChildren, A2uiActionContextEntry, A2uiAction, A2uiComponent, A2uiComponentDef, A2uiText, A2uiImage, A2uiIcon, A2uiVideo, A2uiAudioPlayer, A2uiRow, A2uiColumn, A2uiList, A2uiCard, A2uiTabs, A2uiTabItem, A2uiDivider, A2uiModal, A2uiButton, A2uiCheckBox, A2uiTextField, A2uiDateTimeInput, A2uiMultipleChoice, A2uiSlider, A2uiSurfaceUpdate, A2uiDataModelEntry, A2uiDataModelUpdate, A2uiBeginRendering, A2uiDeleteSurface, A2uiMessage, A2uiSurface, A2uiClientDataModel, A2uiActionMessage, } from './lib/types.js';
+export { A2UI_WIRE_VERSION, A2UI_MIME_TYPE, A2UI_BASIC_CATALOG_ID } from './lib/types.js';
+export type { A2uiTheme, A2uiPathRef, A2uiFunctionCall, DynamicString, DynamicNumber, DynamicBoolean, DynamicStringList, DynamicValue, A2uiChildren, A2uiAction, A2uiEventAction, A2uiFunctionAction, A2uiCheck, A2uiComponent, A2uiComponentBase, A2uiCatalogComponent, A2uiCheckable, A2uiText, A2uiImage, A2uiIcon, A2uiVideo, A2uiAudioPlayer, A2uiRow, A2uiColumn, A2uiList, A2uiCard, A2uiTabs, A2uiDivider, A2uiModal, A2uiButton, A2uiCheckBox, A2uiTextField, A2uiDateTimeInput, A2uiChoicePicker, A2uiSlider, A2uiCreateSurface, A2uiUpdateComponents, A2uiUpdateDataModel, A2uiDeleteSurface, A2uiMessage, A2uiSurface, A2uiClientDataModel, A2uiClientCapabilities, A2uiActionMessage, A2uiErrorMessage, } from './lib/types.js';
 export { getByPointer, setByPointer, deleteByPointer } from './lib/pointer.js';
 export { createA2uiMessageParser } from './lib/parser.js';
 export type { A2uiMessageParser } from './lib/parser.js';
 export { resolveDynamic } from './lib/resolve.js';
 export type { A2uiScope } from './lib/resolve.js';
-export { isLiteralString, isLiteralNumber, isLiteralBoolean, isPathRef } from './lib/guards.js';
+export { createA2uiFunctionRegistry } from './lib/functions.js';
+export type { A2uiFunctionRegistry, A2uiFunctionImpl, A2uiFunctionContext } from './lib/functions.js';
+export { isPathRef, isFunctionCall } from './lib/guards.js';
 //# sourceMappingURL=index.d.ts.map

package/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../libs/a2ui/src/index.ts"],"names":[],"mappings":"AACA,YAAY,EACV,SAAS,EACT,aAAa,EAAE,aAAa,EAAE,cAAc,EAAE,iBAAiB,EAC/D,YAAY,EAAE,sBAAsB,EAAE,UAAU,EAChD,aAAa,EAAE,gBAAgB,EAC/B,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,eAAe,EACzD,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE,SAAS,EACtF,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,UAAU,EAC1F,iBAAiB,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,iBAAiB,EACjG,WAAW,EAAE,WAAW,EACxB,mBAAmB,EAAE,iBAAiB,GACvC,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAC/E,OAAO,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAC1D,YAAY,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,YAAY,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../libs/a2ui/src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAC1F,YAAY,EACV,SAAS,EACT,WAAW,EAAE,gBAAgB,EAC7B,aAAa,EAAE,aAAa,EAAE,cAAc,EAAE,iBAAiB,EAAE,YAAY,EAC7E,YAAY,EAAE,UAAU,EAAE,eAAe,EAAE,kBAAkB,EAAE,SAAS,EACxE,aAAa,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,aAAa,EACrE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,eAAe,EACzD,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,SAAS,EACzE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,UAAU,EACxF,iBAAiB,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,iBAAiB,EAC/E,WAAW,EAAE,WAAW,EACxB,mBAAmB,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,gBAAgB,GACjF,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAC/E,OAAO,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAC1D,YAAY,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,YAAY,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAC;AAChE,YAAY,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACtG,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC"}

package/src/index.js

@@ -1,4 +1,7 @@
+// SPDX-License-Identifier: MIT
+export { A2UI_WIRE_VERSION, A2UI_MIME_TYPE, A2UI_BASIC_CATALOG_ID } from './lib/types.js';
 export { getByPointer, setByPointer, deleteByPointer } from './lib/pointer.js';
 export { createA2uiMessageParser } from './lib/parser.js';
 export { resolveDynamic } from './lib/resolve.js';
-export { isLiteralString, isLiteralNumber, isLiteralBoolean, isPathRef } from './lib/guards.js';
+export { createA2uiFunctionRegistry } from './lib/functions.js';
+export { isPathRef, isFunctionCall } from './lib/guards.js';

package/src/lib/functions.d.ts

@@ -0,0 +1,29 @@
+/** Execution context handed to every function implementation. */
+export interface A2uiFunctionContext {
+    /** Resolve a (possibly dynamic) argument value — bare literal, `{ path }`
+     * binding, or nested `{ call }` — against the current data model/scope. */
+    resolveArg(value: unknown): unknown;
+    /** BCP 47 locale for Intl-based formatting; host default when undefined. */
+    locale?: string;
+}
+export type A2uiFunctionImpl = (args: Record<string, unknown>, ctx: A2uiFunctionContext) => unknown;
+export type A2uiFunctionRegistry = ReadonlyMap<string, A2uiFunctionImpl>;
+/** @internal Used by resolveDynamic to make nested `${fn(...)}` calls inside
+ * formatString dispatch through the same registry. */
+export declare function withActiveRegistry<T>(registry: A2uiFunctionRegistry, fn: () => T): T;
+/** @internal One-time warning helper shared with resolveDynamic. */
+export declare function warnUnknownA2uiFunction(name: string): void;
+/**
+ * Creates an A2UI client-side function registry containing the standard
+ * basic-catalog functions (`formatString`, `formatNumber`, `formatCurrency`,
+ * `formatDate`, `pluralize`, `and`, `or`, `not`), optionally extended or
+ * overridden with custom implementations.
+ *
+ * @example
+ * ```ts
+ * const registry = createA2uiFunctionRegistry();
+ * resolveDynamic({ call: 'formatCurrency', args: { value: 42, currency: 'USD' } }, {}, undefined, registry);
+ * ```
+ */
+export declare function createA2uiFunctionRegistry(overrides?: Record<string, A2uiFunctionImpl>): A2uiFunctionRegistry;
+//# sourceMappingURL=functions.d.ts.map

package/src/lib/functions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"functions.d.ts","sourceRoot":"","sources":["../../../../../libs/a2ui/src/lib/functions.ts"],"names":[],"mappings":"AAKA,iEAAiE;AACjE,MAAM,WAAW,mBAAmB;IAClC;+EAC2E;IAC3E,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC;IACpC,4EAA4E;IAC5E,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,gBAAgB,GAAG,CAC7B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,GAAG,EAAE,mBAAmB,KACrB,OAAO,CAAC;AAEb,MAAM,MAAM,oBAAoB,GAAG,WAAW,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;AAsWzE;sDACsD;AACtD,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,QAAQ,EAAE,oBAAoB,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAQpF;AAED,oEAAoE;AACpE,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAE1D;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,0BAA0B,CACxC,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,GAC3C,oBAAoB,CAMtB"}

package/src/lib/functions.js

@@ -0,0 +1,418 @@
+// SPDX-License-Identifier: MIT
+// A2UI v0.9 client-side functions (basic catalog `functions` map).
+// Arg shapes follow the official catalog schema at
+// https://a2ui.org/specification/v0_9/catalogs/basic/catalog.json.
+function toNumber(v) {
+    if (typeof v === 'number' && Number.isFinite(v))
+        return v;
+    if (typeof v === 'string' && v.trim() !== '') {
+        const n = Number(v);
+        if (Number.isFinite(n))
+            return n;
+    }
+    return undefined;
+}
+function toDate(v) {
+    if (v instanceof Date)
+        return Number.isNaN(v.getTime()) ? undefined : v;
+    if (typeof v === 'number' && Number.isFinite(v))
+        return new Date(v);
+    if (typeof v === 'string') {
+        const d = new Date(v);
+        return Number.isNaN(d.getTime()) ? undefined : d;
+    }
+    return undefined;
+}
+// --- formatDate: Unicode TR35 pattern subset ---
+const DATE_TOKENS = [
+    'yyyy', 'yy', 'MMMM', 'MMM', 'MM', 'M', 'dd', 'd', 'EEEE', 'E',
+    'HH', 'H', 'hh', 'h', 'mm', 'm', 'ss', 's', 'a',
+];
+function dateToken(token, d, locale) {
+    const pad = (n) => String(n).padStart(2, '0');
+    switch (token) {
+        case 'yyyy': return String(d.getFullYear());
+        case 'yy': return pad(d.getFullYear() % 100);
+        case 'MMMM': return new Intl.DateTimeFormat(locale ?? 'en-US', { month: 'long' }).format(d);
+        case 'MMM': return new Intl.DateTimeFormat(locale ?? 'en-US', { month: 'short' }).format(d);
+        case 'MM': return pad(d.getMonth() + 1);
+        case 'M': return String(d.getMonth() + 1);
+        case 'dd': return pad(d.getDate());
+        case 'd': return String(d.getDate());
+        case 'EEEE': return new Intl.DateTimeFormat(locale ?? 'en-US', { weekday: 'long' }).format(d);
+        case 'E': return new Intl.DateTimeFormat(locale ?? 'en-US', { weekday: 'short' }).format(d);
+        case 'HH': return pad(d.getHours());
+        case 'H': return String(d.getHours());
+        case 'hh': return pad(((d.getHours() + 11) % 12) + 1);
+        case 'h': return String(((d.getHours() + 11) % 12) + 1);
+        case 'mm': return pad(d.getMinutes());
+        case 'm': return String(d.getMinutes());
+        case 'ss': return pad(d.getSeconds());
+        case 's': return String(d.getSeconds());
+        case 'a': return d.getHours() < 12 ? 'AM' : 'PM';
+        default: return token;
+    }
+}
+function formatDatePattern(d, pattern, locale) {
+    let out = '';
+    let i = 0;
+    while (i < pattern.length) {
+        const token = DATE_TOKENS.find((t) => pattern.startsWith(t, i));
+        if (token) {
+            out += dateToken(token, d, locale);
+            i += token.length;
+        }
+        else {
+            out += pattern[i];
+            i += 1;
+        }
+    }
+    return out;
+}
+/** Find the `}` closing the `${` that starts at `start` (index of `$`),
+ * honoring nested `${...}` and single-quoted strings. Returns -1 if
+ * unterminated. */
+function findClosingBrace(s, start) {
+    let depth = 0;
+    let i = start;
+    let inQuote = false;
+    while (i < s.length) {
+        const c = s[i];
+        if (inQuote) {
+            if (c === "'")
+                inQuote = false;
+            i += 1;
+            continue;
+        }
+        if (c === "'") {
+            inQuote = true;
+            i += 1;
+            continue;
+        }
+        if (c === '$' && s[i + 1] === '{') {
+            depth += 1;
+            i += 2;
+            continue;
+        }
+        if (c === '}') {
+            depth -= 1;
+            if (depth === 0)
+                return i;
+        }
+        i += 1;
+    }
+    return -1;
+}
+/** Split a call's argument list on top-level commas (nesting + quote aware). */
+function splitArgs(s) {
+    const parts = [];
+    let depth = 0;
+    let inQuote = false;
+    let cur = '';
+    for (let i = 0; i < s.length; i++) {
+        const c = s[i];
+        if (inQuote) {
+            cur += c;
+            if (c === "'")
+                inQuote = false;
+            continue;
+        }
+        if (c === "'") {
+            inQuote = true;
+            cur += c;
+            continue;
+        }
+        if (c === '(' || c === '{')
+            depth += 1;
+        else if (c === ')' || c === '}')
+            depth -= 1;
+        else if (c === ',' && depth === 0) {
+            parts.push(cur);
+            cur = '';
+            continue;
+        }
+        cur += c;
+    }
+    if (cur.trim().length > 0)
+        parts.push(cur);
+    return parts;
+}
+const CALL_HEAD = /^([A-Za-z_][A-Za-z0-9_]*)\(/;
+/** Evaluate one expression (the text inside `${...}`). */
+function evalExpr(raw, env) {
+    const s = raw.trim();
+    if (s.length === 0)
+        return undefined;
+    // Quoted string
+    if (s.startsWith("'") && s.endsWith("'") && s.length >= 2) {
+        return s.slice(1, -1);
+    }
+    if (s === 'true')
+        return true;
+    if (s === 'false')
+        return false;
+    const asNumber = toNumber(s);
+    if (asNumber !== undefined && /^-?[\d.]+$/.test(s))
+        return asNumber;
+    // Nested `${...}` wrapper
+    if (s.startsWith('${') && s.endsWith('}')) {
+        return evalExpr(s.slice(2, -1), env);
+    }
+    // Function call with named args
+    const head = CALL_HEAD.exec(s);
+    if (head && s.endsWith(')')) {
+        const name = head[1];
+        const argsText = s.slice(head[0].length, -1);
+        const args = {};
+        for (const part of splitArgs(argsText)) {
+            const colon = topLevelColonIndex(part);
+            if (colon === -1)
+                continue;
+            const key = part.slice(0, colon).trim();
+            const valueText = part.slice(colon + 1).trim();
+            if (key)
+                args[key] = evalExpr(valueText, env);
+        }
+        const impl = env.registry.get(name);
+        if (!impl) {
+            warnUnknownFunction(name);
+            return undefined;
+        }
+        // Args are already evaluated to plain values here.
+        return impl(args, { ...env.ctx, resolveArg: (v) => v });
+    }
+    // JSON-pointer path (absolute or relative)
+    return env.resolvePath(s);
+}
+/** Index of the first top-level `:` (outside quotes/parens/braces). */
+function topLevelColonIndex(s) {
+    let depth = 0;
+    let inQuote = false;
+    for (let i = 0; i < s.length; i++) {
+        const c = s[i];
+        if (inQuote) {
+            if (c === "'")
+                inQuote = false;
+            continue;
+        }
+        if (c === "'")
+            inQuote = true;
+        else if (c === '(' || c === '{')
+            depth += 1;
+        else if (c === ')' || c === '}')
+            depth -= 1;
+        else if (c === ':' && depth === 0)
+            return i;
+    }
+    return -1;
+}
+function interpolate(template, env) {
+    let out = '';
+    let i = 0;
+    while (i < template.length) {
+        if (template[i] === '\\' && template.startsWith('${', i + 1)) {
+            out += '${';
+            i += 3;
+            continue;
+        }
+        if (template[i] === '$' && template[i + 1] === '{') {
+            const close = findClosingBrace(template, i);
+            if (close === -1) {
+                out += template.slice(i);
+                break;
+            }
+            const value = evalExpr(template.slice(i + 2, close), env);
+            out += value == null ? '' : String(value);
+            i = close + 1;
+            continue;
+        }
+        out += template[i];
+        i += 1;
+    }
+    return out;
+}
+// --- Standard function implementations ---
+const warnedFunctions = new Set();
+function warnUnknownFunction(name) {
+    if (warnedFunctions.has(name))
+        return;
+    warnedFunctions.add(name);
+    console.warn(`[a2ui] unknown client-side function "${name}" — resolving to undefined`);
+}
+function numberFormatOptions(args, ctx, extra) {
+    const options = { ...extra };
+    const decimals = toNumber(ctx.resolveArg(args['decimals']));
+    if (decimals !== undefined) {
+        options.minimumFractionDigits = decimals;
+        options.maximumFractionDigits = decimals;
+    }
+    const grouping = ctx.resolveArg(args['grouping']);
+    if (typeof grouping === 'boolean')
+        options.useGrouping = grouping;
+    return options;
+}
+const STANDARD_FUNCTIONS = {
+    formatString(args, ctx) {
+        const template = ctx.resolveArg(args['value']);
+        if (typeof template !== 'string')
+            return undefined;
+        const env = {
+            ctx,
+            registry: currentRegistry ?? new Map(),
+            resolvePath: (p) => ctx.resolveArg({ path: p }),
+        };
+        return interpolate(template, env);
+    },
+    formatNumber(args, ctx) {
+        const value = toNumber(ctx.resolveArg(args['value']));
+        if (value === undefined)
+            return undefined;
+        return new Intl.NumberFormat(ctx.locale, numberFormatOptions(args, ctx)).format(value);
+    },
+    formatCurrency(args, ctx) {
+        const value = toNumber(ctx.resolveArg(args['value']));
+        const currency = ctx.resolveArg(args['currency']);
+        if (value === undefined || typeof currency !== 'string' || currency.length === 0)
+            return undefined;
+        try {
+            return new Intl.NumberFormat(ctx.locale, numberFormatOptions(args, ctx, { style: 'currency', currency })).format(value);
+        }
+        catch {
+            return undefined;
+        }
+    },
+    formatDate(args, ctx) {
+        const date = toDate(ctx.resolveArg(args['value']));
+        const format = ctx.resolveArg(args['format']);
+        if (!date || typeof format !== 'string')
+            return undefined;
+        return formatDatePattern(date, format, ctx.locale);
+    },
+    pluralize(args, ctx) {
+        const value = toNumber(ctx.resolveArg(args['value']));
+        if (value === undefined)
+            return undefined;
+        const category = new Intl.PluralRules(ctx.locale).select(value);
+        const explicitZero = value === 0 && args['zero'] !== undefined ? 'zero' : undefined;
+        const pick = explicitZero ?? category;
+        const chosen = args[pick] !== undefined ? args[pick] : args['other'];
+        const resolved = ctx.resolveArg(chosen);
+        return resolved === undefined ? undefined : String(resolved);
+    },
+    and(args, ctx) {
+        const values = args['values'];
+        if (!Array.isArray(values))
+            return undefined;
+        return values.every((v) => ctx.resolveArg(v) === true);
+    },
+    or(args, ctx) {
+        const values = args['values'];
+        if (!Array.isArray(values))
+            return undefined;
+        return values.some((v) => ctx.resolveArg(v) === true);
+    },
+    not(args, ctx) {
+        return ctx.resolveArg(args['value']) !== true;
+    },
+    // --- Validators (check-rule conditions) ---
+    required(args, ctx) {
+        const value = ctx.resolveArg(args['value']);
+        if (value == null)
+            return false;
+        if (typeof value === 'string')
+            return value.length > 0;
+        if (Array.isArray(value))
+            return value.length > 0;
+        return true;
+    },
+    regex(args, ctx) {
+        const value = ctx.resolveArg(args['value']);
+        const pattern = ctx.resolveArg(args['pattern']);
+        if (typeof value !== 'string' || typeof pattern !== 'string')
+            return false;
+        try {
+            return new RegExp(pattern).test(value);
+        }
+        catch {
+            return false;
+        }
+    },
+    length(args, ctx) {
+        const value = ctx.resolveArg(args['value']);
+        if (typeof value !== 'string')
+            return false;
+        const min = toNumber(ctx.resolveArg(args['min']));
+        const max = toNumber(ctx.resolveArg(args['max']));
+        if (min !== undefined && value.length < min)
+            return false;
+        if (max !== undefined && value.length > max)
+            return false;
+        return true;
+    },
+    numeric(args, ctx) {
+        const value = toNumber(ctx.resolveArg(args['value']));
+        if (value === undefined)
+            return false;
+        const min = toNumber(ctx.resolveArg(args['min']));
+        const max = toNumber(ctx.resolveArg(args['max']));
+        if (min !== undefined && value < min)
+            return false;
+        if (max !== undefined && value > max)
+            return false;
+        return true;
+    },
+    email(args, ctx) {
+        const value = ctx.resolveArg(args['value']);
+        if (typeof value !== 'string')
+            return false;
+        // Linear-time shape check: local@domain.tld with a dotted domain.
+        const at = value.indexOf('@');
+        if (at <= 0 || at !== value.lastIndexOf('@') || at === value.length - 1)
+            return false;
+        const domain = value.slice(at + 1);
+        const dot = domain.lastIndexOf('.');
+        if (dot <= 0 || dot === domain.length - 1)
+            return false;
+        return !/\s/.test(value);
+    },
+};
+// formatString needs the registry that owns it to evaluate nested calls;
+// tracked per-invocation via resolveDynamic's wiring (see resolve.ts),
+// with a module fallback for direct registry use.
+let currentRegistry = null;
+/** @internal Used by resolveDynamic to make nested `${fn(...)}` calls inside
+ * formatString dispatch through the same registry. */
+export function withActiveRegistry(registry, fn) {
+    const prev = currentRegistry;
+    currentRegistry = registry;
+    try {
+        return fn();
+    }
+    finally {
+        currentRegistry = prev;
+    }
+}
+/** @internal One-time warning helper shared with resolveDynamic. */
+export function warnUnknownA2uiFunction(name) {
+    warnUnknownFunction(name);
+}
+/**
+ * Creates an A2UI client-side function registry containing the standard
+ * basic-catalog functions (`formatString`, `formatNumber`, `formatCurrency`,
+ * `formatDate`, `pluralize`, `and`, `or`, `not`), optionally extended or
+ * overridden with custom implementations.
+ *
+ * @example
+ * ```ts
+ * const registry = createA2uiFunctionRegistry();
+ * resolveDynamic({ call: 'formatCurrency', args: { value: 42, currency: 'USD' } }, {}, undefined, registry);
+ * ```
+ */
+export function createA2uiFunctionRegistry(overrides) {
+    const map = new Map(Object.entries(STANDARD_FUNCTIONS));
+    if (overrides) {
+        for (const [name, impl] of Object.entries(overrides))
+            map.set(name, impl);
+    }
+    return map;
+}

package/src/lib/guards.d.ts

@@ -2,16 +2,9 @@
 export declare function isPathRef(value: unknown): value is {
     path: string;
 };
-/** Returns true when `value` is an A2UI string literal wrapper. */
-export declare function isLiteralString(value: unknown): value is {
-    literalString: string;
-};
-/** Returns true when `value` is an A2UI number literal wrapper. */
-export declare function isLiteralNumber(value: unknown): value is {
-    literalNumber: number;
-};
-/** Returns true when `value` is an A2UI boolean literal wrapper. */
-export declare function isLiteralBoolean(value: unknown): value is {
-    literalBoolean: boolean;
+/** Returns true when `value` is an A2UI client-side function call. */
+export declare function isFunctionCall(value: unknown): value is {
+    call: string;
+    args?: Record<string, unknown>;
 };
 //# sourceMappingURL=guards.d.ts.map

package/src/lib/guards.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"guards.d.ts","sourceRoot":"","sources":["../../../../../libs/a2ui/src/lib/guards.ts"],"names":[],"mappings":"AAEA,mEAAmE;AACnE,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAGnE;AAED,mEAAmE;AACnE,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI;IAAE,aAAa,EAAE,MAAM,CAAA;CAAE,CAElF;AAED,mEAAmE;AACnE,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI;IAAE,aAAa,EAAE,MAAM,CAAA;CAAE,CAElF;AAED,oEAAoE;AACpE,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI;IAAE,cAAc,EAAE,OAAO,CAAA;CAAE,CAErF"}
+{"version":3,"file":"guards.d.ts","sourceRoot":"","sources":["../../../../../libs/a2ui/src/lib/guards.ts"],"names":[],"mappings":"AAEA,mEAAmE;AACnE,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAGnE;AAED,sEAAsE;AACtE,wBAAgB,cAAc,CAC5B,KAAK,EAAE,OAAO,GACb,KAAK,IAAI;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,CAG3D"}

package/src/lib/guards.js

@@ -4,15 +4,8 @@ export function isPathRef(value) {
     return typeof value === 'object' && value !== null
         && 'path' in value && typeof value.path === 'string';
 }
-/** Returns true when `value` is an A2UI string literal wrapper. */
-export function isLiteralString(value) {
-    return typeof value === 'object' && value !== null && 'literalString' in value;
-}
-/** Returns true when `value` is an A2UI number literal wrapper. */
-export function isLiteralNumber(value) {
-    return typeof value === 'object' && value !== null && 'literalNumber' in value;
-}
-/** Returns true when `value` is an A2UI boolean literal wrapper. */
-export function isLiteralBoolean(value) {
-    return typeof value === 'object' && value !== null && 'literalBoolean' in value;
+/** Returns true when `value` is an A2UI client-side function call. */
+export function isFunctionCall(value) {
+    return typeof value === 'object' && value !== null
+        && 'call' in value && typeof value.call === 'string';
 }

package/src/lib/parser.d.ts

@@ -1,19 +1,23 @@
-import type { A2uiMessage } from './types.js';
+import { type A2uiMessage } from './types.js';
 export interface A2uiMessageParser {
     /** Push a JSONL stream chunk and return every complete A2UI envelope parsed from it. */
     push(chunk: string): A2uiMessage[];
 }
 /**
- * Creates a stateful parser for newline-delimited A2UI message streams.
+ * Creates a stateful parser for newline-delimited A2UI v0.9 message streams.
  *
  * The parser buffers incomplete lines, skips malformed JSON, and returns only
- * recognized A2UI envelopes: `surfaceUpdate`, `dataModelUpdate`,
- * `beginRendering`, and `deleteSurface`.
+ * recognized A2UI envelopes: `createSurface`, `updateComponents`,
+ * `updateDataModel`, and `deleteSurface`. Unknown envelope keys (e.g. future
+ * v1.0 messages) are skipped rather than treated as errors. A missing
+ * `version` field defaults to `v0.9`.
  *
  * @example
  * ```ts
  * const parser = createA2uiMessageParser();
- * const messages = parser.push('{"beginRendering":{"surfaceId":"s1","root":"root"}}\n');
+ * const messages = parser.push(
+ *   '{"version":"v0.9","createSurface":{"surfaceId":"s1","catalogId":"basic"}}\n',
+ * );
  * ```
  */
 export declare function createA2uiMessageParser(): A2uiMessageParser;

package/src/lib/parser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../../../../libs/a2ui/src/lib/parser.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAI9C,MAAM,WAAW,iBAAiB;IAChC,wFAAwF;IACxF,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,EAAE,CAAC;CACpC;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,uBAAuB,IAAI,iBAAiB,CAsC3D"}
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../../../../libs/a2ui/src/lib/parser.ts"],"names":[],"mappings":"AACA,OAAO,EAAqB,KAAK,WAAW,EAAE,MAAM,YAAY,CAAC;AAIjE,MAAM,WAAW,iBAAiB;IAChC,wFAAwF;IACxF,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,EAAE,CAAC;CACpC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,uBAAuB,IAAI,iBAAiB,CAuC3D"}

package/src/lib/parser.js

@@ -1,15 +1,21 @@
-const ENVELOPE_KEYS = ['surfaceUpdate', 'dataModelUpdate', 'beginRendering', 'deleteSurface'];
+// SPDX-License-Identifier: MIT
+import { A2UI_WIRE_VERSION } from './types.js';
+const ENVELOPE_KEYS = ['createSurface', 'updateComponents', 'updateDataModel', 'deleteSurface'];
 /**
- * Creates a stateful parser for newline-delimited A2UI message streams.
+ * Creates a stateful parser for newline-delimited A2UI v0.9 message streams.
  *
  * The parser buffers incomplete lines, skips malformed JSON, and returns only
- * recognized A2UI envelopes: `surfaceUpdate`, `dataModelUpdate`,
- * `beginRendering`, and `deleteSurface`.
+ * recognized A2UI envelopes: `createSurface`, `updateComponents`,
+ * `updateDataModel`, and `deleteSurface`. Unknown envelope keys (e.g. future
+ * v1.0 messages) are skipped rather than treated as errors. A missing
+ * `version` field defaults to `v0.9`.
  *
  * @example
  * ```ts
  * const parser = createA2uiMessageParser();
- * const messages = parser.push('{"beginRendering":{"surfaceId":"s1","root":"root"}}\n');
+ * const messages = parser.push(
+ *   '{"version":"v0.9","createSurface":{"surfaceId":"s1","catalogId":"basic"}}\n',
+ * );
  * ```
  */
 export function createA2uiMessageParser() {
@@ -17,8 +23,9 @@ export function createA2uiMessageParser() {
     function parseEnvelope(json) {
         for (const key of ENVELOPE_KEYS) {
             if (key in json && typeof json[key] === 'object' && json[key] !== null) {
-                // A2uiMessage is a discriminated union of single-key envelope objects.
-                return { [key]: json[key] };
+                const version = typeof json['version'] === 'string' ? json['version'] : A2UI_WIRE_VERSION;
+                // A2uiMessage is a discriminated union of single-envelope-key objects.
+                return { version, [key]: json[key] };
             }
         }
         return null;

package/src/lib/pointer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pointer.d.ts","sourceRoot":"","sources":["../../../../../libs/a2ui/src/lib/pointer.ts"],"names":[],"mappings":"AAOA;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAQrF;AAED;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,OAAO,GACb,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAmBzB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,OAAO,EAAE,MAAM,GACd,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAkBzB"}
+{"version":3,"file":"pointer.d.ts","sourceRoot":"","sources":["../../../../../libs/a2ui/src/lib/pointer.ts"],"names":[],"mappings":"AAOA;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAQrF;AAED;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,OAAO,GACb,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAmBzB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,OAAO,EAAE,MAAM,GACd,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAwBzB"}

package/src/lib/pointer.js

@@ -76,6 +76,12 @@ export function deleteByPointer(model, pointer) {
     const parent = getByPointer(model, '/' + parentPath.join('/'));
     if (parent == null || typeof parent !== 'object')
         return model;
+    if (Array.isArray(parent)) {
+        // v0.9 rule: deleting an array index sets it to undefined, preserving length.
+        const parentCopy = [...parent];
+        parentCopy[Number(key)] = undefined;
+        return setByPointer(model, '/' + parentPath.join('/'), parentCopy);
+    }
     const parentCopy = { ...parent };
     delete parentCopy[key];
     return setByPointer(model, '/' + parentPath.join('/'), parentCopy);