/** * The Urbicon-native A2UI catalog registry — the single source of truth for * validation AND the Urbicon system prompt, exactly like the Basic registry but * carrying the FULL Urbicon vocabulary the Basic subset flattens away: real * intents (primary/secondary/success/warning/danger/neutral), a size axis, the * component-native `variant` axes, a structure layer (`Section`), a * plain-vs-markdown split (`Text` vs `RichText`) and labelled disclosure * (`Accordion`). * * HAND-curated (descriptions, childId conventions, prop whitelist) but the axis * VALUES it advertises are library truth: every prop that carries an `axis` is * coupled to `urbicon-axes.gen.ts` (generated from the docs-gen catalog) by a * blocks-internal drift test — curated `values ⊆ axis`, `default ===`, and every * `urbicon` reference exists. So the catalog can never offer a variant the real * component does not support. No Svelte imports: a server building the prompt has * no DOM. * * Curation rules (never in the catalog): snippets, callbacks (`on*`), * `class`/`unstyled`/`slotClasses`/`preset`/`mint`/`tier`, style booleans. * Snippet slots become `childId`s; composites become data props (Stepper steps * as a string list, Accordion items as `labeledChildren`); two-way state is a * `dynamic` prop the renderer writes back. Field errors travel on a single * `error?: string` (the renderer sets intent=danger) — NO per-field intent axis. */ import type { A2uiCatalogSpec } from '../a2ui-catalog.js'; import { type A2uiComponentSpec, type A2uiPropSpec } from '../a2ui-registry.js'; /** * Axes shared across many components, defined ONCE so the prompt can document * them a single time and each prop reference them (compression) instead of * repeating the full list. Per-prop `default`s still vary (a Button defaults to * neutral, a Badge to primary), so only the value SET is shared. */ export declare const SHARED_AXES: { /** The six semantic intents. Alert additionally offers `info` (its own axis). */ intent: readonly ["primary", "secondary", "success", "warning", "danger", "neutral"]; /** The curated size subset (the library also has 2xs/xs/xl/2xl — deliberately omitted). */ size: readonly ["sm", "md", "lg"]; }; /** A prop spec extended with Urbicon-specific drift/prompt anchors. */ export interface UrbiconPropSpec extends A2uiPropSpec { /** * The Urbicon variant-axis this prop maps to — the drift anchor into * `URBICON_AXES[component.urbicon][axis]`. Present only on style-axis props. */ axis?: string; /** * When set, the prop's values come from `SHARED_AXES` — a prompt hint so the * axis is documented once and referenced, not spelled out per component. */ sharedAxis?: 'intent' | 'size'; } /** A component spec extended with the source component + a prompt-grouping category. */ export interface UrbiconComponentSpec extends A2uiComponentSpec { props: Record; /** The Urbicon component this maps to (drift anchor into `URBICON_AXES`). Omitted for structural/composite entries. */ urbicon?: string; /** Prompt-grouping category (Layout / Text / Form / Status / Media). */ category: string; } /** The opaque catalog id this catalog advertises in `createSurface`. Custom catalogs are spec-sanctioned via `catalogId`. */ export declare const URBICON_A2UI_CATALOG_ID = "urbicon-ui/urbicon-catalog/v1"; /** Mapped `Icon.name` values: the Basic 16 plus 10 curated domain glyphs. */ export declare const URBICON_A2UI_ICON_NAMES: readonly string[]; /** Real Urbicon components deliberately not in the v1 catalog (error chip, not "unknown"). */ export declare const UNSUPPORTED_URBICON_A2UI_COMPONENTS: ReadonlySet; /** Props recognised anywhere but intentionally ignored (validation warning only, dropped before render). */ export declare const URBICON_A2UI_IGNORED_PROPS: ReadonlySet; export declare const URBICON_A2UI_REGISTRY: Readonly>; /** * The Urbicon catalog, spec half (Svelte-free — a server building the prompt can * import this). The Svelte wiring (`Node`, `createIcons`) is added in * `a2ui-urbicon-catalog.ts`. `flexContainers` and the layered check semantics * mirror the Basic catalog; the sole catalog-specific check nudges the agent * from plain `Text` toward `RichText` when it emits Markdown. */ export declare const urbiconA2uiCatalogSpec: A2uiCatalogSpec; /** The axis truth this registry couples to — re-exported for the drift test. */ export { URBICON_AXES } from './urbicon-axes.gen.js';