@lynx-js/genui 0.0.1-rc.0

package/a2ui/dist/store/SignalStore.js

@@ -0,0 +1,29 @@
+// Copyright 2026 The Lynx Authors. All rights reserved.
+// Licensed under the Apache License Version 2.0 that can be found in the
+// LICENSE file in the root directory of this source tree.
+import { batch, signal } from '@preact/signals';
+export class SignalStore {
+    signals = new Map();
+    getSignal(path, initialValue) {
+        let s = this.signals.get(path);
+        if (!s) {
+            s = signal(initialValue);
+            this.signals.set(path, s);
+        }
+        return s;
+    }
+    update(path, value) {
+        const s = this.getSignal(path);
+        if (s.value !== value) {
+            s.value = value;
+        }
+    }
+    updateBatch(updates) {
+        batch(() => {
+            for (const { path, value } of updates) {
+                this.update(path, value);
+            }
+        });
+    }
+}
+//# sourceMappingURL=SignalStore.js.map

package/a2ui/dist/store/SignalStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SignalStore.js","sourceRoot":"","sources":["../../src/store/SignalStore.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,yEAAyE;AACzE,0DAA0D;AAC1D,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAGhD,MAAM,OAAO,WAAW;IACd,OAAO,GAAG,IAAI,GAAG,EAA2B,CAAC;IAErD,SAAS,CAAC,IAAY,EAAE,YAAsB;QAC5C,IAAI,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC/B,IAAI,CAAC,CAAC,EAAE,CAAC;YACP,CAAC,GAAG,MAAM,CAAC,YAAY,CAAC,CAAC;YACzB,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;QAC5B,CAAC;QACD,OAAO,CAAC,CAAC;IACX,CAAC;IAED,MAAM,CAAC,IAAY,EAAE,KAAc;QACjC,MAAM,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QAC/B,IAAI,CAAC,CAAC,KAAK,KAAK,KAAK,EAAE,CAAC;YACtB,CAAC,CAAC,KAAK,GAAG,KAAK,CAAC;QAClB,CAAC;IACH,CAAC;IAED,WAAW,CAAC,OAA2C;QACrD,KAAK,CAAC,GAAG,EAAE;YACT,KAAK,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,OAAO,EAAE,CAAC;gBACtC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;YAC3B,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;CACF"}

package/a2ui/dist/store/index.d.ts

@@ -0,0 +1,14 @@
+export { createMessageStore } from './MessageStore.js';
+export type { MessageStore, MessageStoreOptions } from './MessageStore.js';
+export { MessageProcessor } from './MessageProcessor.js';
+export type { A2UIEvent } from './MessageProcessor.js';
+export { createResource } from './Resource.js';
+export type { Resource as RawResource, ResourceStatus } from './Resource.js';
+export { SignalStore } from './SignalStore.js';
+export { createFallbackMessagesFromPlainText, createTextCardMessages, normalizePayloadToMessages, prepareMessagesForProcessing, } from './payloadNormalizer.js';
+export type { A2UIClientEventMessage, ComponentInstance, GenericComponentProps, Resource, ResourceInfo, ServerToClientMessage, Surface, SurfaceId, UserActionPayload, } from './types.js';
+export { FunctionRegistry, functionRegistry } from './FunctionRegistry.js';
+export type { FunctionEntry, FunctionImpl } from './FunctionRegistry.js';
+export type { FunctionCallContext } from './FunctionRegistry.js';
+export { executeFunctionCall, isDataBinding, isFunctionCall, resolveDynamicValue, resolveFunctionArguments, } from './resolveFunctionCall.js';
+export type { ResolveFunctionOptions } from './resolveFunctionCall.js';

package/a2ui/dist/store/index.js

@@ -0,0 +1,15 @@
+// Copyright 2026 The Lynx Authors. All rights reserved.
+// Licensed under the Apache License Version 2.0 that can be found in the
+// LICENSE file in the root directory of this source tree.
+export { createMessageStore } from './MessageStore.js';
+export { MessageProcessor } from './MessageProcessor.js';
+export { createResource } from './Resource.js';
+export { SignalStore } from './SignalStore.js';
+export { createFallbackMessagesFromPlainText, createTextCardMessages, normalizePayloadToMessages, prepareMessagesForProcessing, } from './payloadNormalizer.js';
+export { FunctionRegistry, functionRegistry } from './FunctionRegistry.js';
+// `createFormController` + `FormController` are intentionally not exported.
+// `useChecks` uses them internally to keep the door open for a follow-up
+// `<Form>` component, but they aren't public API until that consumer
+// lands and validates the shape.
+export { executeFunctionCall, isDataBinding, isFunctionCall, resolveDynamicValue, resolveFunctionArguments, } from './resolveFunctionCall.js';
+//# sourceMappingURL=index.js.map

package/a2ui/dist/store/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/store/index.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,yEAAyE;AACzE,0DAA0D;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAEvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzD,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAE/C,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EACL,mCAAmC,EACnC,sBAAsB,EACtB,0BAA0B,EAC1B,4BAA4B,GAC7B,MAAM,wBAAwB,CAAC;AAYhC,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAG3E,4EAA4E;AAC5E,yEAAyE;AACzE,qEAAqE;AACrE,iCAAiC;AACjC,OAAO,EACL,mBAAmB,EACnB,aAAa,EACb,cAAc,EACd,mBAAmB,EACnB,wBAAwB,GACzB,MAAM,0BAA0B,CAAC"}

package/a2ui/dist/store/payloadNormalizer.d.ts

@@ -0,0 +1,27 @@
+import type { ServerToClientMessage } from './types.js';
+/**
+ * Build a single-Text fallback message stream from a plain string. Used by
+ * transports / `Session.ingest` callers that receive free-form text from
+ * the agent instead of structured protocol messages.
+ */
+export declare function createFallbackMessagesFromPlainText(text: string): ServerToClientMessage[];
+/**
+ * Build a Card-wrapped Text fallback message stream from a plain string.
+ * Used when the agent emits text payloads with `kind: 'text'`.
+ */
+export declare function createTextCardMessages(text: string): ServerToClientMessage[];
+/**
+ * Normalize an arbitrary payload (string, array, object) into a flat list of
+ * `ServerToClientMessage` records. Pass-through for already-structured
+ * messages; falls back to wrapping plain text in a Text/Card surface.
+ */
+export declare function normalizePayloadToMessages(payload: unknown): ServerToClientMessage[];
+/**
+ * Tag messages with the given messageId and report whether any of them
+ * carries a non-empty `updateComponents`. Also dedupes `createSurface`
+ * messages against the set of currently-active surfaces.
+ */
+export declare function prepareMessagesForProcessing(rawMessages: ServerToClientMessage[], messageId: string, activeSurfaceIds: Set<string>): {
+    messages: ServerToClientMessage[];
+    hasComponentUpdate: boolean;
+};

package/a2ui/dist/store/payloadNormalizer.js

@@ -0,0 +1,179 @@
+function randomId(prefix = '') {
+    return prefix + Date.now().toString(36)
+        + Math.random().toString(36).slice(2, 10);
+}
+/**
+ * Build a single-Text fallback message stream from a plain string. Used by
+ * transports / `Session.ingest` callers that receive free-form text from
+ * the agent instead of structured protocol messages.
+ */
+export function createFallbackMessagesFromPlainText(text) {
+    const surfaceId = 'default';
+    const rootId = 'root-text';
+    return [
+        {
+            createSurface: {
+                surfaceId,
+                catalogId: 'inline-text',
+            },
+        },
+        {
+            updateComponents: {
+                surfaceId,
+                components: [
+                    {
+                        id: rootId,
+                        component: 'Text',
+                        text,
+                    },
+                ],
+            },
+        },
+    ];
+}
+/**
+ * Build a Card-wrapped Text fallback message stream from a plain string.
+ * Used when the agent emits text payloads with `kind: 'text'`.
+ */
+export function createTextCardMessages(text) {
+    const surfaceId = randomId('text_surface_');
+    const rootId = 'root';
+    const textId = 'text';
+    return [
+        {
+            createSurface: {
+                surfaceId,
+                catalogId: 'inline-text',
+            },
+        },
+        {
+            updateComponents: {
+                surfaceId,
+                components: [
+                    {
+                        id: rootId,
+                        component: 'Card',
+                        child: textId,
+                    },
+                    {
+                        id: textId,
+                        component: 'Text',
+                        text,
+                        variant: 'body',
+                    },
+                ],
+            },
+        },
+    ];
+}
+/**
+ * Normalize an arbitrary payload (string, array, object) into a flat list of
+ * `ServerToClientMessage` records. Pass-through for already-structured
+ * messages; falls back to wrapping plain text in a Text/Card surface.
+ */
+export function normalizePayloadToMessages(payload) {
+    const messages = [];
+    const add = (value) => {
+        // Treat only `null` / `undefined` as no-ops — `0`, `false`, `''` are
+        // legitimate fallback payloads upstream callers may produce.
+        if (value === null || value === undefined)
+            return;
+        if (Array.isArray(value)) {
+            for (const item of value)
+                add(item);
+        }
+        else {
+            messages.push(value);
+        }
+    };
+    const handle = (value) => {
+        if (value === null || value === undefined)
+            return;
+        if (Array.isArray(value)) {
+            for (const item of value)
+                handle(item);
+            return;
+        }
+        if (typeof value === 'string') {
+            add(createFallbackMessagesFromPlainText(value));
+            return;
+        }
+        if (typeof value === 'number' || typeof value === 'boolean'
+            || typeof value === 'bigint') {
+            // Coerce non-string primitives so payloads like `0` or `false`
+            // surface as visible fallback messages instead of disappearing.
+            add(createFallbackMessagesFromPlainText(String(value)));
+            return;
+        }
+        if (typeof value === 'object') {
+            const v = value;
+            if (v['createSurface'] || v['updateComponents'] || v['updateDataModel']
+                || v['deleteSurface']) {
+                add(v);
+                return;
+            }
+            if ('kind' in v && 'data' in v) {
+                if (v['kind'] === 'data') {
+                    handle(v['data']);
+                }
+                else if (v['kind'] === 'text') {
+                    add(createTextCardMessages(typeof v['data'] === 'string' ? v['data'] : String(v['data'])));
+                }
+                return;
+            }
+            if (Array.isArray(v['messages'])) {
+                handle(v['messages']);
+                return;
+            }
+            // `JSON.stringify` throws on circular refs and `BigInt` values; fall
+            // back to a generic placeholder rather than letting the whole
+            // normalize call crash.
+            let serialized;
+            try {
+                serialized = JSON.stringify(v);
+            }
+            catch {
+                serialized = '[unserializable object]';
+            }
+            add(createFallbackMessagesFromPlainText(serialized));
+            return;
+        }
+    };
+    handle(payload);
+    return messages;
+}
+/**
+ * Tag messages with the given messageId and report whether any of them
+ * carries a non-empty `updateComponents`. Also dedupes `createSurface`
+ * messages against the set of currently-active surfaces.
+ */
+export function prepareMessagesForProcessing(rawMessages, messageId, activeSurfaceIds) {
+    let hasComponentUpdate = false;
+    const messages = rawMessages.filter((msg) => {
+        const deletedSurfaceId = msg
+            .deleteSurface?.surfaceId;
+        if (typeof deletedSurfaceId === 'string') {
+            activeSurfaceIds.delete(deletedSurfaceId);
+        }
+        const createdSurfaceId = msg
+            .createSurface?.surfaceId;
+        if (typeof createdSurfaceId === 'string') {
+            if (activeSurfaceIds.has(createdSurfaceId)) {
+                return false;
+            }
+            activeSurfaceIds.add(createdSurfaceId);
+        }
+        if ((msg
+            .updateComponents
+            && Array.isArray(msg
+                .updateComponents?.components)
+            && ((msg
+                .updateComponents?.components ?? []).length > 0))) {
+            hasComponentUpdate = true;
+        }
+        msg.messageId ??= messageId;
+        return true;
+    });
+    return { messages, hasComponentUpdate };
+}
+//# sourceMappingURL=payloadNormalizer.js.map

package/a2ui/dist/store/payloadNormalizer.js.map

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

package/a2ui/dist/store/resolveFunctionCall.d.ts

@@ -0,0 +1,18 @@
+import type * as v0_9 from '@a2ui/web_core/v0_9';
+import type { FunctionRegistry } from './FunctionRegistry.js';
+import type { MessageProcessor } from './MessageProcessor.js';
+import type { CatalogFunctionEntry } from '../catalog/defineCatalog.js';
+export declare function isDataBinding(value: unknown): value is v0_9.DataBinding;
+export declare function isFunctionCall(value: unknown): value is v0_9.FunctionCall;
+export declare function resolveDynamicValue(processor: MessageProcessor, value: unknown, surfaceId: string, dataContextPath?: string, options?: ResolveFunctionOptions): unknown;
+export declare function resolveFunctionArguments(processor: MessageProcessor, args: Record<string, unknown> | undefined, surfaceId: string, dataContextPath?: string, options?: ResolveFunctionOptions): Record<string, unknown>;
+export interface ResolveFunctionOptions {
+    functions?: readonly CatalogFunctionEntry[] | undefined;
+    registry?: FunctionRegistry | undefined;
+}
+/**
+ * Resolve arguments, look the function up in the registry, and invoke it.
+ * When no impl is registered, log once and return `undefined` so callers
+ * (checks, dynamic-property bindings) can degrade gracefully.
+ */
+export declare function executeFunctionCall(processor: MessageProcessor, fn: v0_9.FunctionCall, surfaceId: string, dataContextPath?: string, options?: ResolveFunctionOptions): unknown;

package/a2ui/dist/store/resolveFunctionCall.js

@@ -0,0 +1,131 @@
+import { computed, signal } from '@preact/signals';
+import { functionRegistry } from './FunctionRegistry.js';
+function isObject(value) {
+    return typeof value === 'object' && value !== null;
+}
+export function isDataBinding(value) {
+    return isObject(value) && 'path' in value;
+}
+export function isFunctionCall(value) {
+    return isObject(value) && 'call' in value;
+}
+function resolveFromStore(processor, path, surfaceId, dataContextPath) {
+    const surface = processor.getOrCreateSurface(surfaceId);
+    const store = surface.store;
+    const resolvedPath = processor.resolvePath(path, dataContextPath);
+    const signal = store.getSignal(resolvedPath);
+    const raw = signal.value;
+    if (raw === undefined || raw === null)
+        return raw;
+    if (typeof raw !== 'string')
+        return raw;
+    try {
+        return JSON.parse(raw);
+    }
+    catch {
+        return raw;
+    }
+}
+function setInStore(processor, path, value, surfaceId, dataContextPath) {
+    const surface = processor.getOrCreateSurface(surfaceId);
+    const resolvedPath = processor.resolvePath(path, dataContextPath);
+    surface.store.update(resolvedPath, value);
+}
+function signalFromStore(processor, path, surfaceId, dataContextPath) {
+    const surface = processor.getOrCreateSurface(surfaceId);
+    const resolvedPath = processor.resolvePath(path, dataContextPath);
+    return surface.store.getSignal(resolvedPath);
+}
+export function resolveDynamicValue(processor, value, surfaceId, dataContextPath, options = {}) {
+    if (typeof value === 'string' || typeof value === 'number'
+        || typeof value === 'boolean') {
+        return value;
+    }
+    if (Array.isArray(value)) {
+        return value.map(item => resolveDynamicValue(processor, item, surfaceId, dataContextPath, options));
+    }
+    if (isDataBinding(value)) {
+        return resolveFromStore(processor, value.path, surfaceId, dataContextPath);
+    }
+    if (isFunctionCall(value)) {
+        return executeFunctionCall(processor, value, surfaceId, dataContextPath, options);
+    }
+    return value;
+}
+function resolveSignal(processor, value, surfaceId, dataContextPath, options) {
+    if (isDataBinding(value)) {
+        return signalFromStore(processor, value.path, surfaceId, dataContextPath);
+    }
+    if (isFunctionCall(value)) {
+        return computed(() => executeFunctionCall(processor, value, surfaceId, dataContextPath, options));
+    }
+    if (Array.isArray(value)) {
+        return computed(() => value.map(item => resolveDynamicValue(processor, item, surfaceId, dataContextPath, options)));
+    }
+    return signal(value);
+}
+function createFunctionContext(processor, surfaceId, dataContextPath, options) {
+    return {
+        processor,
+        surfaceId,
+        ...(dataContextPath === undefined ? {} : { dataContextPath }),
+        resolveDynamicValue(value) {
+            return resolveDynamicValue(processor, value, surfaceId, dataContextPath, options);
+        },
+        resolveSignal(value) {
+            return resolveSignal(processor, value, surfaceId, dataContextPath, options);
+        },
+        set(path, value) {
+            setInStore(processor, path, value, surfaceId, dataContextPath);
+        },
+    };
+}
+export function resolveFunctionArguments(processor, args, surfaceId, dataContextPath, options = {}) {
+    const resolved = {};
+    if (!args)
+        return resolved;
+    for (const [key, raw] of Object.entries(args)) {
+        if (Array.isArray(raw) || isDataBinding(raw) || isFunctionCall(raw)) {
+            resolved[key] = resolveDynamicValue(processor, raw, surfaceId, dataContextPath, options);
+        }
+        else if (isObject(raw)) {
+            resolved[key] = { ...raw };
+        }
+        else {
+            resolved[key] = resolveDynamicValue(processor, raw, surfaceId, dataContextPath, options);
+        }
+    }
+    return resolved;
+}
+function resolveFunctionImpl(name, options) {
+    const scoped = options.functions?.find(entry => entry.name === name)?.impl;
+    if (scoped)
+        return scoped;
+    return (options.registry ?? functionRegistry).resolve(name);
+}
+const warnedUnknownFunctions = new Set();
+/**
+ * Resolve arguments, look the function up in the registry, and invoke it.
+ * When no impl is registered, log once and return `undefined` so callers
+ * (checks, dynamic-property bindings) can degrade gracefully.
+ */
+export function executeFunctionCall(processor, fn, surfaceId, dataContextPath, options = {}) {
+    const impl = resolveFunctionImpl(fn.call, options);
+    const resolvedArgs = resolveFunctionArguments(processor, fn.args, surfaceId, dataContextPath, options);
+    if (!impl) {
+        if (!warnedUnknownFunctions.has(fn.call)) {
+            warnedUnknownFunctions.add(fn.call);
+            console.warn(`[a2ui] No client implementation registered for function `
+                + `"${fn.call}". Returning undefined.`);
+        }
+        return undefined;
+    }
+    try {
+        return impl(resolvedArgs, createFunctionContext(processor, surfaceId, dataContextPath, options));
+    }
+    catch (error) {
+        console.warn(`[a2ui] Function "${fn.call}" threw while resolving. Returning undefined.`, error);
+        return undefined;
+    }
+}
+//# sourceMappingURL=resolveFunctionCall.js.map

package/a2ui/dist/store/resolveFunctionCall.js.map

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

package/a2ui/dist/store/types.d.ts

@@ -0,0 +1,68 @@
+import type * as v0_9 from '@a2ui/web_core/v0_9';
+import type { Resource as GenericResource } from './Resource.js';
+import type { SignalStore } from './SignalStore.js';
+export type SurfaceId = string;
+export type ComponentInstance = v0_9.AnyComponent & {
+    /**
+     * Absolute data context path for this component when created via a template.
+     * Used for resolving relative bindings inside the component tree.
+     */
+    dataContextPath?: string;
+    /**
+     * Internal metadata for templated containers so we can re-expand on
+     * data model updates.
+     */
+    __template?: {
+        componentId: v0_9.ComponentId;
+        path: string;
+    };
+};
+export interface Surface {
+    surfaceId: SurfaceId;
+    catalogId?: string;
+    theme?: Readonly<Record<string, unknown>>;
+    sendDataModel?: boolean | undefined;
+    /** id of the root component for this surface (must be 'root'). */
+    rootComponentId?: string | null;
+    components: Map<string, ComponentInstance>;
+    resources: Map<string, Resource>;
+    store: SignalStore;
+}
+export interface ResourceInfo {
+    /**
+     * Internal event type emitted by the processor.
+     */
+    type: 'beginRendering' | 'surfaceUpdate' | 'deleteSurface';
+    surfaceId: string;
+    surface: Surface;
+    component?: ComponentInstance;
+}
+export type Resource = GenericResource<ResourceInfo>;
+export type ServerToClientMessage = v0_9.A2uiMessage & {
+    /**
+     * Message id injected by the client.
+     */
+    messageId?: string;
+};
+export interface UserActionPayload {
+    name: string;
+    surfaceId: string;
+    sourceComponentId: string;
+    timestamp: string;
+    context: Record<string, unknown>;
+}
+export type A2UIClientEventMessage = string | {
+    text?: string;
+    sessionId?: string;
+} | {
+    userAction: UserActionPayload;
+    sessionId?: string;
+};
+export interface GenericComponentProps {
+    id?: string;
+    surface: Surface;
+    setValue?: (key: string, value: unknown) => void;
+    sendAction?: (action: Record<string, unknown>) => void;
+    dataContextPath?: string;
+    [key: string]: unknown;
+}

package/a2ui/dist/store/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/a2ui/dist/store/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/store/types.ts"],"names":[],"mappings":""}