@urbicon-ui/blocks 6.40.4 → 6.43.0

package/dist/components/Chat/A2UIView/A2UINode.svelte

@@ -21,6 +21,7 @@
   import { checkImageUrl, checkLinkUrl } from '../markdown/url-policy.js';
   import type { A2uiActionEvent } from './a2ui.types';
   import { A2UI_REGISTRY, A2UI_SVG_PATH_RE } from './a2ui-registry';
+  import { dedupeOptions, splitDateTime } from './a2ui-node-common';
   import type { A2uiRenderContext, A2uiRenderNode } from './a2ui-render';
   import { bindingPointer, toInputString, toStringArray } from './a2ui-render';
 
@@ -246,7 +247,11 @@
         ).value;
       }
     }
+    // `sendDataModel` surfaces ship the whole model alongside the context, so a
+    // context the agent under-specified still tells it what the user entered.
+    const dataModel = context.actionDataModel?.();
     const payload: A2uiActionEvent = {
+      ...(dataModel === undefined ? {} : { dataModel }),
       name: event.name as string,
       surfaceId: context.surfaceId,
       sourceComponentId: instance.id,
@@ -306,27 +311,18 @@
     if (pointer) return toStringArray(resolved('value'));
     return localList ?? toStringArray(raw('value'));
   });
-  const choiceOptions = $derived.by(() => {
-    const options = raw('options');
-    if (!Array.isArray(options)) return [] as Array<{ value: string; label: string }>;
-    // Dedupe by value (first wins): the validator warns on duplicates, but the
-    // keyed `{#each}` below is on option.value — two equal keys throw Svelte's
-    // `each_key_duplicate` (a hard crash that would break the "never throw"
-    // contract for an untrusted payload).
-    const seen = new Set<string>();
-    const out: Array<{ value: string; label: string }> = [];
-    for (const option of options) {
-      if (option === null || typeof option !== 'object' || typeof option.value !== 'string')
-        continue;
-      if (seen.has(option.value)) continue;
-      seen.add(option.value);
-      out.push({
-        value: option.value,
-        label: text(context.resolve(option.label, node.scopePrefix).value)
-      });
-    }
-    return out;
-  });
+  // Dedupe by value (first wins): the validator warns on duplicates, but the
+  // keyed `{#each}` below is on option.value — two equal keys throw Svelte's
+  // `each_key_duplicate` (a hard crash that would break the "never throw"
+  // contract for an untrusted payload). Shared with the Urbicon dispatcher.
+  const choiceOptions = $derived(
+    // `options` may itself be a { path } binding — that is how an agent shows a
+    // list it fetched mid-conversation (free slots, search hits) without
+    // rewriting the component. Resolve it first, then the per-option labels.
+    dedupeOptions(resolved('options'), (label) =>
+      text(context.resolve(label, node.scopePrefix).value)
+    )
+  );
   const choiceLabel = $derived(text(resolved('label')));
   function writeChoice(next: string[]) {
     const pointer = valuePointer();
@@ -359,24 +355,6 @@
     return 'date';
   });
 
-  function normalizeTimePart(value: string): string {
-    const match = /^(\d{2}:\d{2}(?::\d{2})?)/.exec(value);
-    return match ? match[1] : '';
-  }
-  function splitDateTime(value: string): { date: string; time: string } {
-    const trimmed = value.trim();
-    if (trimmed === '') return { date: '', time: '' };
-    const tIndex = trimmed.indexOf('T');
-    if (tIndex !== -1) {
-      return {
-        date: trimmed.slice(0, tIndex),
-        time: normalizeTimePart(trimmed.slice(tIndex + 1))
-      };
-    }
-    if (trimmed.includes(':')) return { date: '', time: normalizeTimePart(trimmed) };
-    return { date: trimmed, time: '' };
-  }
-
   const dtParts = $derived(splitDateTime(textValue));
   const dtMinParts = $derived(splitDateTime(text(resolved('min'))));
   const dtMaxParts = $derived(splitDateTime(text(resolved('max'))));
@@ -638,11 +616,14 @@
     </RadioGroup>
   {/if}
 {:else if component === 'Slider'}
+  <!-- showValue is forced on: a generated surface has no other place to state
+       the current number, and the agent cannot ask for it (not a catalog prop). -->
   <Slider
     label={text(resolved('label')) || undefined}
     value={sliderValue}
     min={sliderMin}
     max={sliderMax}
+    showValue
     onValueChange={onSliderChange}
     style={weightStyle}
     aria-label={ariaLabel}

package/dist/components/Chat/A2UIView/A2UIView.svelte

@@ -2,26 +2,9 @@
   import { Alert } from '../../../primitives';
   import { untrack } from 'svelte';
   import { getBlocksConfig, resolveSlotClasses } from '../../../provider';
-  import { type IconComponent, resolveIcon } from '../../../icons';
-  import PlusIconDefault from '../../../icons/PlusIcon.svelte';
-  import ArrowLeftIconDefault from '../../../icons/ArrowLeftIcon.svelte';
-  import CheckIconDefault from '../../../icons/CheckIcon.svelte';
-  import CloseIconDefault from '../../../icons/CloseIcon.svelte';
-  import TrashIconDefault from '../../../icons/TrashIcon.svelte';
-  import EditIconDefault from '../../../icons/EditIcon.svelte';
-  import DangerCircleIconDefault from '../../../icons/DangerCircleIcon.svelte';
-  import HomeIconDefault from '../../../icons/HomeIcon.svelte';
-  import InfoCircleIconDefault from '../../../icons/InfoCircleIcon.svelte';
-  import MailIconDefault from '../../../icons/MailIcon.svelte';
-  import MenuIconDefault from '../../../icons/MenuIcon.svelte';
-  import SearchIconDefault from '../../../icons/SearchIcon.svelte';
-  import SendIconDefault from '../../../icons/SendIcon.svelte';
-  import SettingsIconDefault from '../../../icons/SettingsIcon.svelte';
-  import StarIconDefault from '../../../icons/StarIcon.svelte';
-  import WarningTriangleIconDefault from '../../../icons/WarningTriangleIcon.svelte';
-  import CircleHelpIconDefault from '../../../icons/CircleHelpIcon.svelte';
-  import A2UINode from './A2UINode.svelte';
   import type { A2uiValidationIssue } from './a2ui.types';
+  import { basicA2uiCatalog } from './a2ui-basic-catalog';
+  import type { A2uiCatalog } from './a2ui-catalog';
   import { deleteAtPointer, resolveDynamic, setAtPointer } from './a2ui-data';
   import {
     type A2uiProcessor,
@@ -43,6 +26,8 @@
     unsupportedLabel = 'Unsupported component',
     blockedImageLabel = 'Image blocked',
     pendingLabel = 'Loading UI',
+    catalogs: catalogsProp,
+    dataSchema: dataSchemaProp,
     class: className,
     unstyled: unstyledProp = false,
     slotClasses: slotClassesProp = {},
@@ -53,29 +38,30 @@
   const blocksConfig = getBlocksConfig();
   const unstyled = $derived(unstyledProp || blocksConfig?.unstyled || false);
 
-  // A2UI icon-enum name → resolved Urbicon icon. Resolved ONCE via direct
-  // imports (tree-shakeable — never getIcon()); an IconProvider override still
-  // wins, the direct import is the fallback. Built here (not per node) and
-  // threaded through the render context.
-  const icons: Readonly<Record<string, IconComponent>> = {
-    add: resolveIcon('plus', PlusIconDefault),
-    arrowBack: resolveIcon('arrowLeft', ArrowLeftIconDefault),
-    check: resolveIcon('check', CheckIconDefault),
-    close: resolveIcon('close', CloseIconDefault),
-    delete: resolveIcon('trash', TrashIconDefault),
-    edit: resolveIcon('edit', EditIconDefault),
-    error: resolveIcon('danger', DangerCircleIconDefault),
-    home: resolveIcon('home', HomeIconDefault),
-    info: resolveIcon('info', InfoCircleIconDefault),
-    mail: resolveIcon('mail', MailIconDefault),
-    menu: resolveIcon('menu', MenuIconDefault),
-    search: resolveIcon('search', SearchIconDefault),
-    send: resolveIcon('send', SendIconDefault),
-    settings: resolveIcon('settings', SettingsIconDefault),
-    star: resolveIcon('star', StarIconDefault),
-    warning: resolveIcon('warning', WarningTriangleIconDefault)
-  };
-  const fallbackIcon = resolveIcon('circleHelp', CircleHelpIconDefault);
+  // Effective catalogs: the Basic catalog is always available and FIRST (the
+  // default/fallback), consumer catalogs follow. Resolved ONCE at init —
+  // `createIcons()` reads the IconProvider context, so it must run during
+  // component init and cannot be reactive. Keep `catalogs` referentially stable.
+  // `untrack` captures the initial prop value without a reactive subscription
+  // (the init-only capture is deliberate — silences `state_referenced_locally`).
+  const catalogs: readonly A2uiCatalog[] = [
+    basicA2uiCatalog,
+    ...(untrack(() => catalogsProp) ?? [])
+  ];
+  const catalogById = new Map<string, A2uiCatalog>();
+  const iconsByCatalog = new Map<string, ReturnType<A2uiCatalog['createIcons']>>();
+  for (const catalog of catalogs) {
+    if (catalogById.has(catalog.catalogId)) continue;
+    catalogById.set(catalog.catalogId, catalog);
+    for (const alias of catalog.catalogIdAliases ?? []) {
+      if (!catalogById.has(alias)) catalogById.set(alias, catalog);
+    }
+    iconsByCatalog.set(catalog.catalogId, catalog.createIcons());
+  }
+  const defaultCatalog = catalogs[0];
+  const defaultIcons = iconsByCatalog.get(defaultCatalog.catalogId) ?? defaultCatalog.createIcons();
+  // Init-fixed like the catalogs (validation config, not reactive UI state).
+  const dataSchema = untrack(() => dataSchemaProp);
 
   // ── Processor (plain, non-reactive) + version counter ────────────────────
   // The processor mutates plain Maps in place (the streaming-markdown engine
@@ -83,7 +69,7 @@
   // render tree derives from it, so reading it is a real subscription (unlike a
   // `void messages` proxy read). `processor`/`consumed` are plain lets: their
   // reassignment must NOT itself trigger reactivity — the bump does.
-  let processor: A2uiProcessor = createA2uiProcessor();
+  let processor: A2uiProcessor = createA2uiProcessor({ catalogs, dataSchema });
   let consumed: unknown[] = [];
   let normalizeIssue = $state<A2uiValidationIssue | undefined>(undefined);
   let version = $state(0);
@@ -110,7 +96,7 @@
       const prefixMatches =
         envelopes.length >= consumed.length && consumed.every((env, i) => env === envelopes[i]);
       if (!prefixMatches) {
-        processor = createA2uiProcessor();
+        processor = createA2uiProcessor({ catalogs, dataSchema });
         consumed = [];
         generation++;
       }
@@ -195,6 +181,11 @@
         allIssues.push(graphIssue);
       }
       const root = buildRenderTree(surface);
+      // Resolve the surface's catalog to its Svelte wiring: which dispatcher
+      // renders it and which icon set it draws from. surface.catalog is one of
+      // `catalogs`, so both lookups always hit; the `??` are belt-and-braces.
+      const surfaceCatalog = catalogById.get(surface.catalog.catalogId) ?? defaultCatalog;
+      const surfaceIcons = iconsByCatalog.get(surfaceCatalog.catalogId) ?? defaultIcons;
       const context: A2uiRenderContext = {
         classes: currentClasses,
         urlPolicy,
@@ -202,11 +193,14 @@
         inline: false,
         surfaceId: surface.surfaceId,
         onAction,
+        // Read lazily: the click, not the render, decides what the agent sees.
+        actionDataModel: surface.sendDataModel ? () => surface.dataModel : undefined,
         resolve: (value, scope) => resolveDynamic(value, surface.dataModel, scope),
         write: (pointer, value) => writeBinding(surface.surfaceId, pointer, value),
         remove: (pointer) => removeBinding(surface.surfaceId, pointer),
-        icons,
-        fallbackIcon,
+        icons: surfaceIcons.icons,
+        fallbackIcon: surfaceIcons.fallbackIcon,
+        nodeComponent: surfaceCatalog.Node,
         labels: {
           unsupported: unsupportedLabel,
           blockedImage: blockedImageLabel,
@@ -241,12 +235,15 @@
 
 <!--
   The render tree recurses through this self-referencing snippet rather than a
-  self-import inside A2UINode: a snippet that renders A2UINode and passes ITSELF
-  down as `renderChild` gives clean recursion without the circular component-type
-  resolution that self-imports trip in svelte-check.
+  self-import inside the node dispatcher: a snippet that renders the dispatcher
+  and passes ITSELF down as `renderChild` gives clean recursion without the
+  circular component-type resolution that self-imports trip in svelte-check. The
+  dispatcher is the surface catalog's own node component (Basic → A2UINode; a
+  custom catalog → its own), read off the render context per surface.
 -->
 {#snippet renderNode(node: A2uiRenderNode, context: A2uiRenderContext)}
-  <A2UINode {node} {context} renderChild={renderNode} />
+  {@const Node = context.nodeComponent}
+  <Node {node} {context} renderChild={renderNode} />
 {/snippet}
 
 <!--

package/dist/components/Chat/A2UIView/a2ui-basic-catalog.d.ts

@@ -0,0 +1,17 @@
+/**
+ * The v0.9.1 `basic`-subset catalog, fully wired: the pure `basicA2uiCatalogSpec`
+ * plus its Svelte half — the `A2UINode` dispatcher and the `createIcons` factory.
+ *
+ * The icon map lives here (not at A2UIView module scope) so it is built ONCE per
+ * catalog and threaded through the render context, and so a custom catalog can
+ * ship its own icon set from its own module without dragging Basic's icons into
+ * every bundle. `createIcons` is a FACTORY, not a constant: `resolveIcon` reads
+ * the IconProvider context, so it must run during component initialisation —
+ * A2UIView calls `catalog.createIcons()` from its script top level.
+ *
+ * This module imports `.svelte` components, so — unlike `a2ui-catalog.ts` — it is
+ * NOT server-importable. Keep the Svelte-free spec in `a2ui-catalog.ts`.
+ */
+import { type A2uiCatalog } from './a2ui-catalog.js';
+/** The renderable Basic catalog: spec + `A2UINode` dispatcher + icon factory. */
+export declare const basicA2uiCatalog: A2uiCatalog;

package/dist/components/Chat/A2UIView/a2ui-basic-catalog.js

@@ -0,0 +1,69 @@
+/**
+ * The v0.9.1 `basic`-subset catalog, fully wired: the pure `basicA2uiCatalogSpec`
+ * plus its Svelte half — the `A2UINode` dispatcher and the `createIcons` factory.
+ *
+ * The icon map lives here (not at A2UIView module scope) so it is built ONCE per
+ * catalog and threaded through the render context, and so a custom catalog can
+ * ship its own icon set from its own module without dragging Basic's icons into
+ * every bundle. `createIcons` is a FACTORY, not a constant: `resolveIcon` reads
+ * the IconProvider context, so it must run during component initialisation —
+ * A2UIView calls `catalog.createIcons()` from its script top level.
+ *
+ * This module imports `.svelte` components, so — unlike `a2ui-catalog.ts` — it is
+ * NOT server-importable. Keep the Svelte-free spec in `a2ui-catalog.ts`.
+ */
+import { resolveIcon } from '../../../icons/index.js';
+import ArrowLeftIconDefault from '../../../icons/ArrowLeftIcon.svelte';
+import CheckIconDefault from '../../../icons/CheckIcon.svelte';
+import CircleHelpIconDefault from '../../../icons/CircleHelpIcon.svelte';
+import CloseIconDefault from '../../../icons/CloseIcon.svelte';
+import DangerCircleIconDefault from '../../../icons/DangerCircleIcon.svelte';
+import EditIconDefault from '../../../icons/EditIcon.svelte';
+import HomeIconDefault from '../../../icons/HomeIcon.svelte';
+import InfoCircleIconDefault from '../../../icons/InfoCircleIcon.svelte';
+import MailIconDefault from '../../../icons/MailIcon.svelte';
+import MenuIconDefault from '../../../icons/MenuIcon.svelte';
+import PlusIconDefault from '../../../icons/PlusIcon.svelte';
+import SearchIconDefault from '../../../icons/SearchIcon.svelte';
+import SendIconDefault from '../../../icons/SendIcon.svelte';
+import SettingsIconDefault from '../../../icons/SettingsIcon.svelte';
+import StarIconDefault from '../../../icons/StarIcon.svelte';
+import TrashIconDefault from '../../../icons/TrashIcon.svelte';
+import WarningTriangleIconDefault from '../../../icons/WarningTriangleIcon.svelte';
+import A2UINode from './A2UINode.svelte';
+import { basicA2uiCatalogSpec } from './a2ui-catalog.js';
+/**
+ * Build the Basic catalog's A2UI icon-enum name → resolved Urbicon icon map.
+ * Resolved via DIRECT imports (tree-shakeable — never `getIcon()`); an
+ * IconProvider override still wins, the direct import is the fallback. Must run
+ * during component init (`resolveIcon` reads context).
+ */
+function createBasicIcons() {
+    return {
+        icons: {
+            add: resolveIcon('plus', PlusIconDefault),
+            arrowBack: resolveIcon('arrowLeft', ArrowLeftIconDefault),
+            check: resolveIcon('check', CheckIconDefault),
+            close: resolveIcon('close', CloseIconDefault),
+            delete: resolveIcon('trash', TrashIconDefault),
+            edit: resolveIcon('edit', EditIconDefault),
+            error: resolveIcon('danger', DangerCircleIconDefault),
+            home: resolveIcon('home', HomeIconDefault),
+            info: resolveIcon('info', InfoCircleIconDefault),
+            mail: resolveIcon('mail', MailIconDefault),
+            menu: resolveIcon('menu', MenuIconDefault),
+            search: resolveIcon('search', SearchIconDefault),
+            send: resolveIcon('send', SendIconDefault),
+            settings: resolveIcon('settings', SettingsIconDefault),
+            star: resolveIcon('star', StarIconDefault),
+            warning: resolveIcon('warning', WarningTriangleIconDefault)
+        },
+        fallbackIcon: resolveIcon('circleHelp', CircleHelpIconDefault)
+    };
+}
+/** The renderable Basic catalog: spec + `A2UINode` dispatcher + icon factory. */
+export const basicA2uiCatalog = {
+    ...basicA2uiCatalogSpec,
+    Node: A2UINode,
+    createIcons: createBasicIcons
+};

package/dist/components/Chat/A2UIView/a2ui-catalog.d.ts

@@ -0,0 +1,95 @@
+/**
+ * Catalog abstraction for the A2UI engine. A *catalog* bundles everything the
+ * pure-TS engine (validate/render/prompt) needs to be catalog-agnostic: the
+ * component registry, the icon-name set, the unsupported/ignored lists, the
+ * flex-container set (which parents honour a child `weight`), and per-component
+ * post-validation checks. This is the seam that lets a second, Urbicon-native
+ * catalog (`urbicon/…`) sit alongside the v0.9.1 `basic` catalog without
+ * touching the engine.
+ *
+ * Two layers:
+ * - `A2uiCatalogSpec` — pure TS, Svelte-free, server-importable (a server
+ *   building the system prompt or validating a payload has no DOM). This is
+ *   what the engine threads.
+ * - `A2uiCatalog` — adds the Svelte wiring (`Node` dispatcher, `createIcons`
+ *   factory) via TYPE-ONLY imports, so importing this module still pulls no
+ *   Svelte runtime. The `.svelte`-bearing catalog VALUE is assembled in a
+ *   separate module (`a2ui-basic-catalog.ts`) so the pure spec stays isolated.
+ *
+ * The spec-level prop/component types live in `a2ui-registry.ts` (the Basic
+ * data); they are re-exported here so a downstream catalog imports one place.
+ */
+import type { Component } from 'svelte';
+import type { IconComponent } from '../../../icons/index.js';
+import { type A2uiValidationIssue } from './a2ui.types.js';
+import { type A2uiComponentSpec, type A2uiPropKind, type A2uiPropSpec } from './a2ui-registry.js';
+import type { A2uiNodeProps } from './a2ui-render.js';
+export type { A2uiComponentSpec, A2uiPropKind, A2uiPropSpec };
+/**
+ * Context passed to a per-component post-validation check. `props` is the
+ * already-validated (registry-declared, stored) prop map for the component;
+ * `base` is its payload path (`/messages/<i>/updateComponents/components/<j>`).
+ */
+export interface A2uiComponentCheckContext {
+    id: string;
+    props: ReadonlyMap<string, unknown>;
+    surfaceId: string;
+    base: string;
+}
+/**
+ * A per-component check the engine runs after generic prop validation, keyed by
+ * component name. Returns any extra issues (e.g. ChoicePicker chips-fallback,
+ * DateTimeInput missing-mode). Kept as catalog DATA rather than hardcoded
+ * branches so each catalog owns its own semantic warnings.
+ */
+export type A2uiComponentCheck = (ctx: A2uiComponentCheckContext) => A2uiValidationIssue[];
+/**
+ * The Svelte-free half of a catalog — everything the engine (validate / render
+ * graph / prompt) needs. Structurally satisfied by the richer `A2uiCatalog`.
+ */
+export interface A2uiCatalogSpec {
+    /** Catalog id advertised in `createSurface` and matched against incoming surfaces. */
+    catalogId: string;
+    /** Additional ids that resolve to this catalog (version/back-compat aliases). */
+    catalogIdAliases?: readonly string[];
+    /** Component name → spec (the single source of truth for validation AND the prompt). */
+    registry: Readonly<Record<string, A2uiComponentSpec>>;
+    /** Mapped `Icon.name` values; an unmapped name degrades to a fallback glyph. */
+    iconNames: readonly string[];
+    /** Real catalog components deliberately not rendered (error chip, not "unknown"). */
+    unsupportedComponents: ReadonlySet<string>;
+    /** Props recognised anywhere but dropped before render (validation warning only). */
+    ignoredProps: ReadonlySet<string>;
+    /** Component names whose DIRECT children may carry a `weight` (flex-grow). */
+    flexContainers: ReadonlySet<string>;
+    /** Optional per-component post-validation checks, keyed by component name. */
+    componentChecks?: Readonly<Record<string, A2uiComponentCheck>>;
+}
+/**
+ * A full, renderable catalog — the spec plus its Svelte wiring. `Node` is the
+ * recursive dispatcher A2UIView renders per surface; `createIcons` builds the
+ * icon map (must run during component init — `resolveIcon` reads the
+ * IconProvider context). The `Component`/`IconComponent` references are
+ * TYPE-ONLY, so this module stays runtime-Svelte-free.
+ */
+export interface A2uiCatalog extends A2uiCatalogSpec {
+    Node: Component<A2uiNodeProps>;
+    createIcons: () => {
+        icons: Readonly<Record<string, IconComponent>>;
+        fallbackIcon: IconComponent;
+    };
+}
+/**
+ * Resolve a `createSurface.catalogId` to a configured catalog: exact id match
+ * first, then an alias match. No prefix/semver matching (an id must round-trip
+ * unchanged). Returns `undefined` when nothing matches — the caller falls back
+ * to the default catalog.
+ */
+export declare function resolveCatalog<T extends A2uiCatalogSpec>(catalogs: readonly T[], catalogId: string): T | undefined;
+/**
+ * The v0.9.1 `basic`-subset catalog, spec half. The Basic-specific ChoicePicker
+ * and DateTimeInput warnings live here as `componentChecks` (previously
+ * hardcoded in the validator) so the engine carries no catalog-specific
+ * branches. Message strings are byte-identical to the pre-refactor validator.
+ */
+export declare const basicA2uiCatalogSpec: A2uiCatalogSpec;

package/dist/components/Chat/A2UIView/a2ui-catalog.js

@@ -0,0 +1,87 @@
+/**
+ * Catalog abstraction for the A2UI engine. A *catalog* bundles everything the
+ * pure-TS engine (validate/render/prompt) needs to be catalog-agnostic: the
+ * component registry, the icon-name set, the unsupported/ignored lists, the
+ * flex-container set (which parents honour a child `weight`), and per-component
+ * post-validation checks. This is the seam that lets a second, Urbicon-native
+ * catalog (`urbicon/…`) sit alongside the v0.9.1 `basic` catalog without
+ * touching the engine.
+ *
+ * Two layers:
+ * - `A2uiCatalogSpec` — pure TS, Svelte-free, server-importable (a server
+ *   building the system prompt or validating a payload has no DOM). This is
+ *   what the engine threads.
+ * - `A2uiCatalog` — adds the Svelte wiring (`Node` dispatcher, `createIcons`
+ *   factory) via TYPE-ONLY imports, so importing this module still pulls no
+ *   Svelte runtime. The `.svelte`-bearing catalog VALUE is assembled in a
+ *   separate module (`a2ui-basic-catalog.ts`) so the pure spec stays isolated.
+ *
+ * The spec-level prop/component types live in `a2ui-registry.ts` (the Basic
+ * data); they are re-exported here so a downstream catalog imports one place.
+ */
+import { A2UI_ISSUE_CODES } from './a2ui.types.js';
+import { A2UI_CATALOG_ID, A2UI_ICON_NAMES, A2UI_IGNORED_PROPS, A2UI_REGISTRY, UNSUPPORTED_A2UI_COMPONENTS } from './a2ui-registry.js';
+/**
+ * Resolve a `createSurface.catalogId` to a configured catalog: exact id match
+ * first, then an alias match. No prefix/semver matching (an id must round-trip
+ * unchanged). Returns `undefined` when nothing matches — the caller falls back
+ * to the default catalog.
+ */
+export function resolveCatalog(catalogs, catalogId) {
+    for (const catalog of catalogs) {
+        if (catalog.catalogId === catalogId)
+            return catalog;
+    }
+    for (const catalog of catalogs) {
+        if (catalog.catalogIdAliases?.includes(catalogId))
+            return catalog;
+    }
+    return undefined;
+}
+/**
+ * The v0.9.1 `basic`-subset catalog, spec half. The Basic-specific ChoicePicker
+ * and DateTimeInput warnings live here as `componentChecks` (previously
+ * hardcoded in the validator) so the engine carries no catalog-specific
+ * branches. Message strings are byte-identical to the pre-refactor validator.
+ */
+export const basicA2uiCatalogSpec = {
+    catalogId: A2UI_CATALOG_ID,
+    registry: A2UI_REGISTRY,
+    iconNames: A2UI_ICON_NAMES,
+    unsupportedComponents: UNSUPPORTED_A2UI_COMPONENTS,
+    ignoredProps: A2UI_IGNORED_PROPS,
+    flexContainers: new Set(['Row', 'Column']),
+    componentChecks: {
+        ChoicePicker: ({ id, props, surfaceId, base }) => {
+            if (props.get('displayStyle') === 'chips' || props.get('filterable') === true) {
+                return [
+                    {
+                        severity: 'warning',
+                        code: A2UI_ISSUE_CODES.CHOICEPICKER_FALLBACK,
+                        message: `ChoicePicker "${id}" chips/filterable are rendered with a fallback`,
+                        surfaceId,
+                        path: base
+                    }
+                ];
+            }
+            return [];
+        },
+        DateTimeInput: ({ id, props, surfaceId, base }) => {
+            // Both flags default to false in the spec — a DateTimeInput without either
+            // would have no input UI at all. We read tolerantly (render a date input)
+            // and report loudly so the agent fixes the payload.
+            if (props.get('enableDate') !== true && props.get('enableTime') !== true) {
+                return [
+                    {
+                        severity: 'warning',
+                        code: A2UI_ISSUE_CODES.DATETIME_NO_MODE,
+                        message: `DateTimeInput "${id}" sets neither enableDate nor enableTime; rendering a date input`,
+                        surfaceId,
+                        path: base
+                    }
+                ];
+            }
+            return [];
+        }
+    }
+};

package/dist/components/Chat/A2UIView/a2ui-node-common.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Pure helpers shared by the catalog node dispatchers (`A2UINode`,
+ * `urbicon/UrbiconA2UINode`). No Svelte — just the payload-shaping logic both
+ * renderers need identically. The reactive plumbing (the `$derived`/`$state`
+ * two-way-binding wiring) is deliberately NOT extracted: it is duplicated per
+ * dispatcher so each stays a self-contained, readable component.
+ *
+ * `dedupeOptions` is load-bearing for the "never throw" contract: EVERY
+ * payload-driven keyed `{#each}` over option values must dedupe first, or two
+ * equal keys throw Svelte's `each_key_duplicate` — a hard render crash on an
+ * untrusted payload. The validator only WARNS on duplicates; the renderer must
+ * drop them.
+ */
+/**
+ * Coerce an unknown resolved value to display text: strings pass through, finite
+ * numbers stringify, everything else (null/undefined/object/NaN) becomes `''`.
+ */
+export declare function coerceText(value: unknown): string;
+/**
+ * Normalise a raw options array into a deduped `{ value, label }` list (first
+ * occurrence of each value wins). `resolveLabel` turns a raw label value (a
+ * literal or a `{ path }` binding) into display text — the caller injects its
+ * data-binding resolver. Malformed options (non-object, non-string value) are
+ * skipped. Dedup is mandatory: the rendered list is keyed on `value`.
+ */
+export declare function dedupeOptions(rawOptions: unknown, resolveLabel: (rawLabel: unknown) => string): Array<{
+    value: string;
+    label: string;
+}>;
+/** Keep only the leading `HH:MM(:SS)?` of a time string; `''` if there is none. */
+export declare function normalizeTimePart(value: string): string;
+/**
+ * Split one ISO 8601 date/time literal into its date and time parts, timezone-
+ * naively (a trailing offset/`Z` is dropped, never re-attached — timezone
+ * semantics belong to the agent, not a UI renderer without timezone context).
+ */
+export declare function splitDateTime(value: string): {
+    date: string;
+    time: string;
+};

package/dist/components/Chat/A2UIView/a2ui-node-common.js

@@ -0,0 +1,72 @@
+/**
+ * Pure helpers shared by the catalog node dispatchers (`A2UINode`,
+ * `urbicon/UrbiconA2UINode`). No Svelte — just the payload-shaping logic both
+ * renderers need identically. The reactive plumbing (the `$derived`/`$state`
+ * two-way-binding wiring) is deliberately NOT extracted: it is duplicated per
+ * dispatcher so each stays a self-contained, readable component.
+ *
+ * `dedupeOptions` is load-bearing for the "never throw" contract: EVERY
+ * payload-driven keyed `{#each}` over option values must dedupe first, or two
+ * equal keys throw Svelte's `each_key_duplicate` — a hard render crash on an
+ * untrusted payload. The validator only WARNS on duplicates; the renderer must
+ * drop them.
+ */
+/**
+ * Coerce an unknown resolved value to display text: strings pass through, finite
+ * numbers stringify, everything else (null/undefined/object/NaN) becomes `''`.
+ */
+export function coerceText(value) {
+    if (typeof value === 'string')
+        return value;
+    if (typeof value === 'number' && Number.isFinite(value))
+        return String(value);
+    return '';
+}
+/**
+ * Normalise a raw options array into a deduped `{ value, label }` list (first
+ * occurrence of each value wins). `resolveLabel` turns a raw label value (a
+ * literal or a `{ path }` binding) into display text — the caller injects its
+ * data-binding resolver. Malformed options (non-object, non-string value) are
+ * skipped. Dedup is mandatory: the rendered list is keyed on `value`.
+ */
+export function dedupeOptions(rawOptions, resolveLabel) {
+    if (!Array.isArray(rawOptions))
+        return [];
+    const seen = new Set();
+    const out = [];
+    for (const option of rawOptions) {
+        if (option === null || typeof option !== 'object')
+            continue;
+        const value = option.value;
+        if (typeof value !== 'string' || seen.has(value))
+            continue;
+        seen.add(value);
+        out.push({ value, label: resolveLabel(option.label) });
+    }
+    return out;
+}
+/** Keep only the leading `HH:MM(:SS)?` of a time string; `''` if there is none. */
+export function normalizeTimePart(value) {
+    const match = /^(\d{2}:\d{2}(?::\d{2})?)/.exec(value);
+    return match ? match[1] : '';
+}
+/**
+ * Split one ISO 8601 date/time literal into its date and time parts, timezone-
+ * naively (a trailing offset/`Z` is dropped, never re-attached — timezone
+ * semantics belong to the agent, not a UI renderer without timezone context).
+ */
+export function splitDateTime(value) {
+    const trimmed = value.trim();
+    if (trimmed === '')
+        return { date: '', time: '' };
+    const tIndex = trimmed.indexOf('T');
+    if (tIndex !== -1) {
+        return {
+            date: trimmed.slice(0, tIndex),
+            time: normalizeTimePart(trimmed.slice(tIndex + 1))
+        };
+    }
+    if (trimmed.includes(':'))
+        return { date: '', time: normalizeTimePart(trimmed) };
+    return { date: trimmed, time: '' };
+}