@lynx-js/genui 0.0.1-rc.0

package/a2ui/dist/store/MessageProcessor.js

@@ -0,0 +1,408 @@
+import { createResource } from './Resource.js';
+import { SignalStore } from './SignalStore.js';
+function isObject(value) {
+    return typeof value === 'object' && value !== null;
+}
+/**
+ * `null` / `undefined` / empty array / empty object → `false`.
+ * Used by `dispatch()` to decide whether a listener's response should
+ * win over later responses from other listeners.
+ */
+function isMeaningfulResponse(value) {
+    if (value === null || value === undefined)
+        return false;
+    if (Array.isArray(value))
+        return value.length > 0;
+    if (typeof value === 'object') {
+        return Object.keys(value).length > 0;
+    }
+    return true;
+}
+export class MessageProcessor {
+    surfaces;
+    eventListeners = new Set();
+    updateListeners = new Set();
+    constructor() {
+        this.surfaces = new Map();
+    }
+    onUpdate(callback) {
+        this.updateListeners.add(callback);
+        return () => {
+            this.updateListeners.delete(callback);
+        };
+    }
+    emitUpdate(data) {
+        for (const cb of this.updateListeners)
+            cb(data);
+    }
+    dispatch(message) {
+        return new Promise((resolve) => {
+            if (this.eventListeners.size === 0) {
+                resolve([]);
+                return;
+            }
+            // Each listener gets its own one-shot resolver so multiple
+            // subscribers don't race on the shared outer `resolve` (which
+            // would let whoever calls it first decide the dispatch result and
+            // silently drop responses from the rest). We resolve with the
+            // first non-empty response, falling back to an empty array if
+            // every listener yielded nothing.
+            const total = this.eventListeners.size;
+            let settled = 0;
+            let firstResponse;
+            let hasResponse = false;
+            const tryResolve = () => {
+                settled += 1;
+                if (settled >= total) {
+                    resolve(hasResponse ? firstResponse : []);
+                }
+            };
+            for (const cb of this.eventListeners) {
+                let called = false;
+                cb({
+                    message,
+                    resolve: (value) => {
+                        if (called)
+                            return;
+                        called = true;
+                        // Only treat the first **meaningful** response as the result.
+                        // Listeners that resolve `[]` / `null` / `{}` (the no-op
+                        // pattern from `<A2UI>`'s internal listener) shouldn't
+                        // shadow a real response from another subscriber.
+                        if (!hasResponse && isMeaningfulResponse(value)) {
+                            hasResponse = true;
+                            firstResponse = value;
+                        }
+                        tryResolve();
+                    },
+                });
+            }
+        });
+    }
+    onEvent(callback) {
+        this.eventListeners.add(callback);
+        return () => {
+            this.eventListeners.delete(callback);
+        };
+    }
+    getSurfaces() {
+        return this.surfaces;
+    }
+    clearSurfaces() {
+        this.surfaces.clear();
+    }
+    getOrCreateSurface(surfaceId) {
+        let surface = this.surfaces.get(surfaceId);
+        if (!surface) {
+            surface = {
+                surfaceId,
+                rootComponentId: null,
+                components: new Map(),
+                resources: new Map(),
+                store: new SignalStore(),
+            };
+            this.surfaces.set(surfaceId, surface);
+        }
+        else if (!surface.store) {
+            surface.store = new SignalStore();
+        }
+        return surface;
+    }
+    /**
+     * Resolve a JSON Pointer taking into account the current data context.
+     *
+     * - Absolute paths (starting with '/') are returned as-is.
+     * - Relative paths are resolved against the provided dataContextPath.
+     */
+    resolvePath(path, dataContextPath) {
+        if (!path)
+            return path;
+        if (path.startsWith('/')) {
+            return path;
+        }
+        const context = dataContextPath ?? '';
+        const cleanContext = context.endsWith('/') ? context.slice(0, -1) : context;
+        if (path.startsWith('./')) {
+            const rest = path.substring(2);
+            if (!cleanContext) {
+                return `/${rest}`;
+            }
+            return `${cleanContext}/${rest}`;
+        }
+        if (!cleanContext) {
+            return `/${path}`;
+        }
+        return `${cleanContext}/${path}`;
+    }
+    cloneComponentTree(originalId, newIdSuffix, dataContextPath, surface, updates) {
+        const original = surface.components.get(originalId);
+        if (!original)
+            return null;
+        const newId = `${originalId}${newIdSuffix}`;
+        const cloned = JSON.parse(JSON.stringify(original));
+        cloned['id'] = newId;
+        cloned.dataContextPath = dataContextPath;
+        surface.components.set(newId, cloned);
+        updates.push(cloned);
+        if (!surface.resources.has(newId)) {
+            surface.resources.set(newId, createResource(newId));
+        }
+        const anyCloned = cloned;
+        const clonedRefs = new Map();
+        const cloneReference = (childId) => {
+            if (clonedRefs.has(childId))
+                return clonedRefs.get(childId) ?? null;
+            const newChildId = this.cloneComponentTree(childId, newIdSuffix, dataContextPath, surface, updates);
+            clonedRefs.set(childId, newChildId);
+            return newChildId;
+        };
+        const cloneStringField = (field) => {
+            const childId = anyCloned[field];
+            if (typeof childId !== 'string')
+                return;
+            const newChildId = cloneReference(childId);
+            if (newChildId) {
+                anyCloned[field] = newChildId;
+            }
+        };
+        if (Array.isArray(anyCloned['children'])) {
+            const newChildren = [];
+            for (const childId of anyCloned['children']) {
+                if (typeof childId !== 'string')
+                    continue;
+                const newChildId = cloneReference(childId);
+                if (newChildId)
+                    newChildren.push(newChildId);
+            }
+            anyCloned['children'] = newChildren;
+        }
+        cloneStringField('child');
+        if (Array.isArray(anyCloned['tabs'])) {
+            anyCloned['tabs'] = anyCloned['tabs'].map((tab) => {
+                if (!tab || typeof tab !== 'object')
+                    return tab;
+                const tabObject = tab;
+                const childId = tabObject['child'];
+                if (typeof childId !== 'string')
+                    return tab;
+                const newChildId = cloneReference(childId);
+                if (!newChildId)
+                    return tab;
+                return { ...tabObject, child: newChildId };
+            });
+        }
+        cloneStringField('trigger');
+        cloneStringField('content');
+        cloneStringField('entryPointChild');
+        cloneStringField('contentChild');
+        return newId;
+    }
+    flattenValue(value, basePath, updates) {
+        const normalizedBase = basePath === '' ? '/' : basePath;
+        const push = (path, v) => {
+            updates.push({ path, value: v });
+        };
+        if (Array.isArray(value)) {
+            push(normalizedBase, value);
+            value.forEach((item, index) => {
+                const childPath = normalizedBase === '/'
+                    ? `/${index}`
+                    : `${normalizedBase}/${index}`;
+                if (isObject(item) || Array.isArray(item)) {
+                    push(childPath, item);
+                    this.flattenValue(item, childPath, updates);
+                }
+                else {
+                    updates.push({ path: childPath, value: String(item) });
+                }
+            });
+            return;
+        }
+        if (isObject(value)) {
+            push(normalizedBase, value);
+            for (const [key, v] of Object.entries(value)) {
+                const childPath = normalizedBase === '/'
+                    ? `/${key}`
+                    : `${normalizedBase}/${key}`;
+                if (isObject(v) || Array.isArray(v)) {
+                    push(childPath, v);
+                    this.flattenValue(v, childPath, updates);
+                }
+                else {
+                    updates.push({ path: childPath, value: String(v) });
+                }
+            }
+            return;
+        }
+        updates.push({ path: normalizedBase, value: String(value) });
+    }
+    processMessages(messages) {
+        for (const message of messages) {
+            if ('createSurface' in message && message.createSurface) {
+                const createSurface = message['createSurface'];
+                const surfaceId = createSurface['surfaceId'];
+                const surface = this.getOrCreateSurface(surfaceId);
+                const catId = createSurface['catalogId'];
+                if (catId !== undefined)
+                    surface.catalogId = catId;
+                const t = createSurface['theme'];
+                if (t !== undefined) {
+                    surface.theme = t;
+                }
+                const sData = createSurface['sendDataModel'];
+                if (sData !== undefined)
+                    surface.sendDataModel = sData;
+            }
+            if ('updateComponents' in message && message.updateComponents) {
+                const { surfaceId, components } = message.updateComponents;
+                const surface = this.getOrCreateSurface(surfaceId);
+                const updatesMap = new Map();
+                for (const item of components) {
+                    if (!item.id)
+                        continue;
+                    const existing = surface.components.get(item.id);
+                    const dataContextPath = existing?.dataContextPath;
+                    const instance = { ...item };
+                    if (dataContextPath !== undefined) {
+                        instance.dataContextPath = dataContextPath;
+                    }
+                    const anyInstance = instance;
+                    if (anyInstance['children']
+                        && !Array.isArray(anyInstance['children'])
+                        && typeof anyInstance['children'] === 'object'
+                        && anyInstance['children'] !== null
+                        && typeof anyInstance['children']['componentId'] === 'string'
+                        && typeof anyInstance['children']['path'] === 'string') {
+                        const templatePath = this.resolvePath(anyInstance['children']['path'], dataContextPath);
+                        instance.__template = {
+                            componentId: anyInstance['children']['componentId'],
+                            path: templatePath,
+                        };
+                    }
+                    surface.components.set(instance.id, instance);
+                    updatesMap.set(instance.id, instance);
+                    if (!surface.resources.has(instance.id)) {
+                        surface.resources.set(instance.id, createResource(instance.id));
+                    }
+                }
+                if (!surface.rootComponentId) {
+                    if (surface.components.has('root')) {
+                        surface.rootComponentId = 'root';
+                    }
+                    else if (updatesMap.size > 0) {
+                        surface.rootComponentId = updatesMap.keys().next().value ?? null;
+                    }
+                    if (surface.rootComponentId) {
+                        if (!surface.resources.has(surface.rootComponentId)) {
+                            surface.resources.set(surface.rootComponentId, createResource(surface.rootComponentId));
+                        }
+                        // Fall back to a surface-derived id so consumers that key
+                        // resources by `messageId` still get a non-empty key when the
+                        // protocol message lacks one (the v0.9 stream does not require
+                        // `messageId` on every message).
+                        const messageId = message.messageId
+                            ?? `surface:${surfaceId}`;
+                        this.emitUpdate({
+                            type: 'beginRendering',
+                            surfaceId,
+                            messageId,
+                        });
+                    }
+                }
+                const updates = Array.from(updatesMap.values());
+                if (updates.length > 0) {
+                    this.emitUpdate({
+                        type: 'surfaceUpdate',
+                        updates,
+                        surfaceId,
+                    });
+                }
+            }
+            if ('updateDataModel' in message && message.updateDataModel) {
+                const { surfaceId, path, value } = message.updateDataModel;
+                const surface = this.getOrCreateSurface(surfaceId);
+                const updates = [];
+                if (value !== undefined) {
+                    const basePath = path && path !== '' ? path : '/';
+                    this.flattenValue(value, basePath, updates);
+                }
+                else if (path) {
+                    updates.push({ path, value: '' });
+                }
+                if (updates.length > 0) {
+                    surface.store.updateBatch(updates);
+                }
+                const componentUpdates = [];
+                for (const component of surface.components.values()) {
+                    const anyComponent = component;
+                    const templateInfo = anyComponent['__template'];
+                    if (!templateInfo)
+                        continue;
+                    const dataSignal = surface.store.getSignal(templateInfo.path);
+                    const rawData = dataSignal.value;
+                    let data;
+                    if (typeof rawData === 'string') {
+                        try {
+                            data = rawData ? JSON.parse(rawData) : undefined;
+                        }
+                        catch {
+                            data = undefined;
+                        }
+                    }
+                    else {
+                        data = rawData;
+                    }
+                    const explicitChildren = [];
+                    const generatedUpdates = [];
+                    if (Array.isArray(data)) {
+                        data.forEach((_, index) => {
+                            const suffix = `:${index}`;
+                            const ctx = `${templateInfo.path}/${index}`;
+                            const newId = this.cloneComponentTree(templateInfo.componentId, suffix, ctx, surface, generatedUpdates);
+                            if (newId) {
+                                explicitChildren.push(newId);
+                            }
+                        });
+                    }
+                    else if (isObject(data)) {
+                        for (const key of Object.keys(data)) {
+                            const suffix = `:${key}`;
+                            const ctx = `${templateInfo.path}/${key}`;
+                            const newId = this.cloneComponentTree(templateInfo.componentId, suffix, ctx, surface, generatedUpdates);
+                            if (newId) {
+                                explicitChildren.push(newId);
+                            }
+                        }
+                    }
+                    anyComponent['children'] = explicitChildren;
+                    componentUpdates.push(component);
+                    componentUpdates.push(...generatedUpdates);
+                }
+                if (componentUpdates.length > 0) {
+                    this.emitUpdate({
+                        type: 'surfaceUpdate',
+                        updates: componentUpdates,
+                        surfaceId,
+                    });
+                }
+            }
+            if ('deleteSurface' in message && message.deleteSurface) {
+                const { surfaceId } = message.deleteSurface;
+                const surface = this.surfaces.get(surfaceId);
+                // Same fallback as the synthesized `beginRendering` event so
+                // consumers that key lifecycle state by `messageId` always see
+                // a non-empty key when the protocol message lacks one.
+                const messageId = message.messageId
+                    ?? `surface:${surfaceId}`;
+                this.emitUpdate({
+                    type: 'deleteSurface',
+                    surfaceId,
+                    targetId: surface?.rootComponentId ?? surfaceId,
+                    messageId,
+                });
+                this.surfaces.delete(surfaceId);
+            }
+        }
+    }
+}
+//# sourceMappingURL=MessageProcessor.js.map

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

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

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

@@ -0,0 +1,38 @@
+import type { ServerToClientMessage } from './types.js';
+/**
+ * A pure append-only buffer of raw protocol messages produced by the
+ * developer's IO module. The store knows nothing about the v0.9 protocol —
+ * it does not parse, process, or interpret messages. It only:
+ *
+ *  1. Stores them in arrival order.
+ *  2. Notifies subscribers when new ones land.
+ *  3. Hands the current snapshot back via `getSnapshot()` (referentially
+ *     stable between mutations — required by `useSyncExternalStore`).
+ *
+ * Protocol-aware processing — surfaces, signals, resources, action
+ * dispatch — is the responsibility of `<A2UI>` (the renderer component).
+ * Developers who don't want to learn the protocol should use `<A2UI>`;
+ * developers who do can run their own `MessageProcessor` against the
+ * snapshot directly.
+ */
+export interface MessageStore {
+    /** `useSyncExternalStore` subscribe contract. */
+    readonly subscribe: (cb: () => void) => () => void;
+    /** `useSyncExternalStore` getSnapshot contract — stable between pushes. */
+    readonly getSnapshot: () => readonly ServerToClientMessage[];
+    /**
+     * Append one or more raw messages to the buffer. Notifies subscribers
+     * once per call (batches a single array argument into a single notify).
+     */
+    push(message: ServerToClientMessage | readonly ServerToClientMessage[]): void;
+    /** Reset the buffer. Notifies subscribers. */
+    clear(): void;
+}
+export interface MessageStoreOptions {
+    /**
+     * Optional initial buffer contents. Useful when rehydrating a previous
+     * agent response or replaying a fixture stream.
+     */
+    initialMessages?: readonly ServerToClientMessage[];
+}
+export declare function createMessageStore(options?: MessageStoreOptions): MessageStore;

package/a2ui/dist/store/MessageStore.js

@@ -0,0 +1,37 @@
+export function createMessageStore(options = {}) {
+    let snapshot = options.initialMessages
+        ? Object.freeze([...options.initialMessages])
+        : Object.freeze([]);
+    const subscribers = new Set();
+    const notify = () => {
+        for (const cb of subscribers)
+            cb();
+    };
+    return {
+        subscribe(cb) {
+            subscribers.add(cb);
+            return () => {
+                subscribers.delete(cb);
+            };
+        },
+        getSnapshot() {
+            return snapshot;
+        },
+        push(message) {
+            const incoming = Array.isArray(message)
+                ? message
+                : [message];
+            if (incoming.length === 0)
+                return;
+            snapshot = Object.freeze([...snapshot, ...incoming]);
+            notify();
+        },
+        clear() {
+            if (snapshot.length === 0)
+                return;
+            snapshot = Object.freeze([]);
+            notify();
+        },
+    };
+}
+//# sourceMappingURL=MessageStore.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"MessageStore.js","sourceRoot":"","sources":["../../src/store/MessageStore.ts"],"names":[],"mappings":"AA6CA,MAAM,UAAU,kBAAkB,CAChC,UAA+B,EAAE;IAEjC,IAAI,QAAQ,GAAqC,OAAO,CAAC,eAAe;QACtE,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;QAC7C,CAAC,CAAC,MAAM,CAAC,MAAM,CAA0B,EAAE,CAAC,CAAC;IAC/C,MAAM,WAAW,GAAG,IAAI,GAAG,EAAc,CAAC;IAE1C,MAAM,MAAM,GAAG,GAAG,EAAE;QAClB,KAAK,MAAM,EAAE,IAAI,WAAW;YAAE,EAAE,EAAE,CAAC;IACrC,CAAC,CAAC;IAEF,OAAO;QACL,SAAS,CAAC,EAAE;YACV,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACpB,OAAO,GAAG,EAAE;gBACV,WAAW,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YACzB,CAAC,CAAC;QACJ,CAAC;QACD,WAAW;YACT,OAAO,QAAQ,CAAC;QAClB,CAAC;QACD,IAAI,CAAC,OAAO;YACV,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;gBACrC,CAAC,CAAE,OAAmC;gBACtC,CAAC,CAAC,CAAC,OAAgC,CAAC,CAAC;YACvC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO;YAClC,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,QAAQ,EAAE,GAAG,QAAQ,CAAC,CAAC,CAAC;YACrD,MAAM,EAAE,CAAC;QACX,CAAC;QACD,KAAK;YACH,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO;YAClC,QAAQ,GAAG,MAAM,CAAC,MAAM,CAA0B,EAAE,CAAC,CAAC;YACtD,MAAM,EAAE,CAAC;QACX,CAAC;KACF,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,45 @@
+export type ResourceStatus = 'pending' | 'success' | 'error';
+/**
+ * Immutable, transition-keyed snapshot returned by
+ * {@link Resource.getSnapshot}. The object reference changes on every
+ * `complete()` / `fail()` call so `useSyncExternalStore` re-renders even
+ * for `pending → error` transitions where `value` stays `undefined`.
+ */
+export interface ResourceSnapshot<T = unknown> {
+    status: ResourceStatus;
+    value: T | undefined;
+    error: unknown;
+}
+export interface Resource<T = unknown> {
+    id: string;
+    readonly completed: boolean;
+    readonly status: ResourceStatus;
+    readonly value: T | undefined;
+    readonly error: unknown;
+    /**
+     * @deprecated Read `value` / `status` directly. Retained for backwards
+     * compatibility; in the success state it returns the value, otherwise it
+     * returns undefined. It does not throw.
+     */
+    read: () => T | undefined;
+    complete: (result: T) => void;
+    fail: (err: unknown) => void;
+    /**
+     * @deprecated Use `subscribe`. Behaves identically.
+     */
+    onUpdate: (callback: (result: T) => void) => () => void;
+    /**
+     * Subscribe to state changes. The callback is invoked after every
+     * `complete()` or `fail()` (the same value may be re-published when the
+     * processor re-emits an update for the same id). Returns a disposer.
+     */
+    subscribe: (callback: () => void) => () => void;
+    /**
+     * Synchronous read of the current snapshot, suitable for
+     * `useSyncExternalStore`. The returned object reference changes on every
+     * transition.
+     */
+    getSnapshot: () => ResourceSnapshot<T>;
+    promise: Promise<T>;
+}
+export declare function createResource<T = unknown>(id: string): Resource<T>;

package/a2ui/dist/store/Resource.js

@@ -0,0 +1,80 @@
+export function createResource(id) {
+    let resolve;
+    let reject;
+    const promise = new Promise((res, rej) => {
+        resolve = res;
+        reject = rej;
+    });
+    // Swallow unhandled rejection — listeners may attach later.
+    promise.catch(() => {
+        /* deferred: callers attach via subscribe / onUpdate */
+    });
+    let status = 'pending';
+    let value;
+    let error;
+    // Snapshot object whose reference changes on every transition so that
+    // `useSyncExternalStore`'s `Object.is` bail-out doesn't miss
+    // `pending → error` (where `value` stays `undefined`).
+    let snapshot = { status, value, error };
+    const listeners = new Set();
+    const notify = () => {
+        snapshot = { status, value, error };
+        for (const fn of listeners)
+            fn();
+    };
+    return {
+        id,
+        promise,
+        get completed() {
+            return status === 'success';
+        },
+        get status() {
+            return status;
+        },
+        get value() {
+            return value;
+        },
+        get error() {
+            return error;
+        },
+        read: () => value,
+        complete: (res) => {
+            // `error` is terminal — refuse error → success transitions so
+            // observers don't see `{ status: 'success', error: <stale> }`.
+            if (status === 'error')
+                return;
+            const wasPending = status === 'pending';
+            value = res;
+            status = 'success';
+            if (wasPending)
+                resolve(res);
+            notify();
+        },
+        fail: (err) => {
+            if (status !== 'pending')
+                return;
+            error = err;
+            status = 'error';
+            reject(err);
+            notify();
+        },
+        onUpdate: (fn) => {
+            const wrapped = () => {
+                if (value !== undefined)
+                    fn(value);
+            };
+            listeners.add(wrapped);
+            return () => {
+                listeners.delete(wrapped);
+            };
+        },
+        subscribe: (fn) => {
+            listeners.add(fn);
+            return () => {
+                listeners.delete(fn);
+            };
+        },
+        getSnapshot: () => snapshot,
+    };
+}
+//# sourceMappingURL=Resource.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Resource.js","sourceRoot":"","sources":["../../src/store/Resource.ts"],"names":[],"mappings":"AAkDA,MAAM,UAAU,cAAc,CAAc,EAAU;IACpD,IAAI,OAA4B,CAAC;IACjC,IAAI,MAA+B,CAAC;IACpC,MAAM,OAAO,GAAG,IAAI,OAAO,CAAI,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE;QAC1C,OAAO,GAAG,GAAG,CAAC;QACd,MAAM,GAAG,GAAG,CAAC;IACf,CAAC,CAAC,CAAC;IACH,4DAA4D;IAC5D,OAAO,CAAC,KAAK,CAAC,GAAG,EAAE;QACjB,uDAAuD;IACzD,CAAC,CAAC,CAAC;IAEH,IAAI,MAAM,GAAmB,SAAS,CAAC;IACvC,IAAI,KAAoB,CAAC;IACzB,IAAI,KAAc,CAAC;IACnB,sEAAsE;IACtE,6DAA6D;IAC7D,uDAAuD;IACvD,IAAI,QAAQ,GAAwB,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;IAC7D,MAAM,SAAS,GAAG,IAAI,GAAG,EAAc,CAAC;IAExC,MAAM,MAAM,GAAG,GAAG,EAAE;QAClB,QAAQ,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;QACpC,KAAK,MAAM,EAAE,IAAI,SAAS;YAAE,EAAE,EAAE,CAAC;IACnC,CAAC,CAAC;IAEF,OAAO;QACL,EAAE;QACF,OAAO;QACP,IAAI,SAAS;YACX,OAAO,MAAM,KAAK,SAAS,CAAC;QAC9B,CAAC;QACD,IAAI,MAAM;YACR,OAAO,MAAM,CAAC;QAChB,CAAC;QACD,IAAI,KAAK;YACP,OAAO,KAAK,CAAC;QACf,CAAC;QACD,IAAI,KAAK;YACP,OAAO,KAAK,CAAC;QACf,CAAC;QACD,IAAI,EAAE,GAAG,EAAE,CAAC,KAAK;QACjB,QAAQ,EAAE,CAAC,GAAM,EAAE,EAAE;YACnB,8DAA8D;YAC9D,+DAA+D;YAC/D,IAAI,MAAM,KAAK,OAAO;gBAAE,OAAO;YAC/B,MAAM,UAAU,GAAG,MAAM,KAAK,SAAS,CAAC;YACxC,KAAK,GAAG,GAAG,CAAC;YACZ,MAAM,GAAG,SAAS,CAAC;YACnB,IAAI,UAAU;gBAAE,OAAO,CAAC,GAAG,CAAC,CAAC;YAC7B,MAAM,EAAE,CAAC;QACX,CAAC;QACD,IAAI,EAAE,CAAC,GAAY,EAAE,EAAE;YACrB,IAAI,MAAM,KAAK,SAAS;gBAAE,OAAO;YACjC,KAAK,GAAG,GAAG,CAAC;YACZ,MAAM,GAAG,OAAO,CAAC;YACjB,MAAM,CAAC,GAAG,CAAC,CAAC;YACZ,MAAM,EAAE,CAAC;QACX,CAAC;QACD,QAAQ,EAAE,CAAC,EAAqB,EAAE,EAAE;YAClC,MAAM,OAAO,GAAG,GAAG,EAAE;gBACnB,IAAI,KAAK,KAAK,SAAS;oBAAE,EAAE,CAAC,KAAK,CAAC,CAAC;YACrC,CAAC,CAAC;YACF,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YACvB,OAAO,GAAG,EAAE;gBACV,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YAC5B,CAAC,CAAC;QACJ,CAAC;QACD,SAAS,EAAE,CAAC,EAAc,EAAE,EAAE;YAC5B,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAClB,OAAO,GAAG,EAAE;gBACV,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YACvB,CAAC,CAAC;QACJ,CAAC;QACD,WAAW,EAAE,GAAG,EAAE,CAAC,QAAQ;KAC5B,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,10 @@
+import type { Signal } from '@preact/signals';
+export declare class SignalStore {
+    private signals;
+    getSignal(path: string, initialValue?: unknown): Signal<unknown>;
+    update(path: string, value: unknown): void;
+    updateBatch(updates: {
+        path: string;
+        value: unknown;
+    }[]): void;
+}