@exponential-at/ui 0.0.0-stage → 0.1.0

package/dist/types/src/catalog.generated.d.ts

@@ -0,0 +1,829 @@
+import type { Style } from "./style.js";
+import type { DataBinding, FunctionCall } from "./types.js";
+export declare const CATALOG_ID = "https://ui.exponential.at/catalogs/core/v1";
+export declare const LITE_CATALOG_ID = "https://ui.exponential.at/catalogs/core-lite/v1";
+export declare const BASIC_CATALOG_ID = "https://a2ui.org/specification/v0_9/basic_catalog.json";
+export declare const BASIC_VERSION = "v0.9";
+export declare const CATALOG_VERSION = "1";
+export declare const UNKNOWN_COMPONENT_NAME = "Unknown";
+/** Every component in source order (the hidden placeholder included). */
+export declare const COMPONENT_NAMES: readonly ["Box", "Stack", "Grid", "Card", "Separator", "List", "Resizable", "ScrollArea", "Sidebar", "SplitView", "AppBar", "Page", "Toolbar", "Section", "Group", "Text", "Heading", "Markdown", "CodeBlock", "Kbd", "Label", "Image", "Icon", "Video", "AudioPlayer", "Avatar", "Carousel", "Tabs", "Segmented", "Accordion", "Collapsible", "Trace", "TraceItem", "Pagination", "Breadcrumb", "Stepper", "Dialog", "Drawer", "DockCard", "AlertDialog", "Popover", "Tooltip", "Menu", "Toast", "Badge", "Alert", "Chip", "EmptyState", "Progress", "Meter", "Ring", "Spinner", "Skeleton", "Table", "Chart", "Sparkline", "StatTile", "Button", "Link", "Toggle", "Form", "FieldGroup", "FormActions", "Input", "Textarea", "NumberField", "Checkbox", "Radio", "ChoiceTiles", "Switch", "Slider", "Rating", "Select", "SearchList", "ChipInput", "DatePicker", "DateRangePicker", "TimePicker", "FileUpload", "Composer", "Row", "TreeGuides", "Unknown"];
+export type ComponentName = (typeof COMPONENT_NAMES)[number];
+export declare const NATIVE_COMPONENTS: readonly ["Box", "List", "Resizable", "Text", "Markdown", "CodeBlock", "Image", "Icon", "Video", "AudioPlayer", "Avatar", "Carousel", "Tabs", "Segmented", "Accordion", "Dialog", "Drawer", "Popover", "Tooltip", "Menu", "Toast", "Ring", "Spinner", "Skeleton", "Table", "Chart", "Button", "Link", "Toggle", "Form", "Input", "Textarea", "NumberField", "Checkbox", "Radio", "ChoiceTiles", "Switch", "Slider", "Select", "SearchList", "ChipInput", "DatePicker", "DateRangePicker", "TimePicker", "FileUpload", "Composer", "TreeGuides", "Unknown"];
+export declare const MACRO_COMPONENTS: readonly ["Stack", "Grid", "Card", "Separator", "ScrollArea", "Sidebar", "SplitView", "AppBar", "Page", "Toolbar", "Section", "Group", "Heading", "Kbd", "Label", "Collapsible", "Trace", "TraceItem", "Pagination", "Breadcrumb", "Stepper", "DockCard", "AlertDialog", "Badge", "Alert", "Chip", "EmptyState", "Progress", "Meter", "Sparkline", "StatTile", "FieldGroup", "FormActions", "Rating", "Row"];
+/** The core-lite subset (no overlays, media or Chart). */
+export declare const LITE_COMPONENTS: readonly ["Box", "Stack", "Grid", "Card", "Separator", "List", "Resizable", "ScrollArea", "Sidebar", "SplitView", "AppBar", "Page", "Toolbar", "Section", "Group", "Text", "Heading", "Markdown", "CodeBlock", "Kbd", "Label", "Icon", "Avatar", "Tabs", "Segmented", "Collapsible", "Trace", "TraceItem", "Breadcrumb", "Stepper", "Badge", "Alert", "Chip", "EmptyState", "Progress", "Meter", "Ring", "Skeleton", "StatTile", "Button", "Link", "Form", "FieldGroup", "FormActions", "Input", "Textarea", "NumberField", "Checkbox", "Switch", "Rating", "Select", "SearchList", "ChipInput", "DatePicker", "DateRangePicker", "TimePicker", "FileUpload", "Composer", "Row"];
+export declare const COMPONENT_GROUPS: Record<ComponentName, string>;
+/** The specimen id each component has on ui.exponential.at. */
+export declare const SPECIMEN_IDS: Record<ComponentName, string>;
+export declare const ENUMS: {
+    readonly variant: readonly ["default", "secondary", "outline", "ghost", "destructive", "link"];
+    readonly size: readonly ["sm", "default", "lg", "icon"];
+    readonly tone: readonly ["neutral", "primary", "success", "warning", "danger", "info"];
+    readonly gap: readonly ["none", "xs", "sm", "md", "lg", "xl"];
+    readonly align: readonly ["start", "center", "end", "stretch"];
+    readonly justify: readonly ["start", "center", "end", "between", "around", "evenly"];
+    readonly textVariant: readonly ["body", "caption", "muted", "lead", "code", "label", "title"];
+    readonly headingLevel: readonly ["h1", "h2", "h3", "h4"];
+    readonly imageFit: readonly ["contain", "cover", "fill", "none", "scaleDown"];
+    readonly orientation: readonly ["horizontal", "vertical"];
+    readonly side: readonly ["top", "right", "bottom", "left"];
+    readonly inputType: readonly ["text", "email", "password", "number", "search", "url", "tel"];
+    readonly validateOn: readonly ["change", "blur", "submit"];
+    readonly alertType: readonly ["info", "success", "warning", "error"];
+    readonly controlSize: readonly ["sm", "default", "lg"];
+    readonly spinnerSize: readonly ["xs", "sm", "default", "lg"];
+    readonly tabClosable: readonly ["none", "hover", "always"];
+    readonly groupType: readonly ["single", "multiple"];
+    readonly rowChevron: readonly ["none", "right", "selector"];
+    readonly rowSurface: readonly ["flat", "card"];
+    readonly chipShape: readonly ["pill", "rect"];
+    readonly density: readonly ["default", "compact"];
+    readonly listDirection: readonly ["vertical", "horizontal"];
+    readonly chartKind: readonly ["bar", "stackedBar", "line", "area", "pie", "donut", "sparkline"];
+    readonly segmentedVariant: readonly ["segmented", "toggles", "outline", "bar"];
+    readonly liveTone: readonly ["live", "attention", "done", "unread", "idle", "muted"];
+    readonly menuItemKind: readonly ["item", "checkbox", "separator", "label", "submenu"];
+    readonly openOn: readonly ["press", "hover"];
+    readonly menuOpenOn: readonly ["press", "contextmenu"];
+    readonly live: readonly ["off", "polite", "assertive"];
+    readonly selectable: readonly ["none", "single", "multiple"];
+    readonly cellType: readonly ["text", "number", "date", "boolean", "badge", "slot", "currency", "percent", "relativeTime"];
+    readonly sortDirection: readonly ["asc", "desc"];
+    readonly imageLoading: readonly ["lazy", "eager"];
+    readonly scrollDirection: readonly ["vertical", "horizontal", "both"];
+    readonly collapseBelow: readonly ["never", "sm", "md", "lg", "xl"];
+    readonly codeLanguage: readonly ["plain", "json", "js", "ts", "tsx", "rust", "swift", "kotlin", "python", "bash", "html", "css", "sql", "yaml", "markdown", "ansi"];
+    readonly codeToken: readonly ["plain", "keyword", "string", "number", "comment", "punctuation", "operator", "type", "function", "property", "tag", "attribute", "success", "warning", "error"];
+    readonly codeBlockVariant: readonly ["default", "destructive"];
+    readonly codeBlockSize: readonly ["default", "sm"];
+    readonly traceStatus: readonly ["running", "error", "pending"];
+    readonly traceSize: readonly ["default", "sm"];
+};
+export type VariantValue = (typeof ENUMS)["variant"][number];
+export type SizeValue = (typeof ENUMS)["size"][number];
+export type ToneValue = (typeof ENUMS)["tone"][number];
+export type GapValue = (typeof ENUMS)["gap"][number];
+export type AlignValue = (typeof ENUMS)["align"][number];
+export type JustifyValue = (typeof ENUMS)["justify"][number];
+export type TextVariantValue = (typeof ENUMS)["textVariant"][number];
+export type HeadingLevelValue = (typeof ENUMS)["headingLevel"][number];
+export type ImageFitValue = (typeof ENUMS)["imageFit"][number];
+export type OrientationValue = (typeof ENUMS)["orientation"][number];
+export type SideValue = (typeof ENUMS)["side"][number];
+export type InputTypeValue = (typeof ENUMS)["inputType"][number];
+export type ValidateOnValue = (typeof ENUMS)["validateOn"][number];
+export type AlertTypeValue = (typeof ENUMS)["alertType"][number];
+export type ControlSizeValue = (typeof ENUMS)["controlSize"][number];
+export type SpinnerSizeValue = (typeof ENUMS)["spinnerSize"][number];
+export type TabClosableValue = (typeof ENUMS)["tabClosable"][number];
+export type GroupTypeValue = (typeof ENUMS)["groupType"][number];
+export type RowChevronValue = (typeof ENUMS)["rowChevron"][number];
+export type RowSurfaceValue = (typeof ENUMS)["rowSurface"][number];
+export type ChipShapeValue = (typeof ENUMS)["chipShape"][number];
+export type DensityValue = (typeof ENUMS)["density"][number];
+export type ListDirectionValue = (typeof ENUMS)["listDirection"][number];
+export type ChartKindValue = (typeof ENUMS)["chartKind"][number];
+export type SegmentedVariantValue = (typeof ENUMS)["segmentedVariant"][number];
+export type LiveToneValue = (typeof ENUMS)["liveTone"][number];
+export type MenuItemKindValue = (typeof ENUMS)["menuItemKind"][number];
+export type OpenOnValue = (typeof ENUMS)["openOn"][number];
+export type MenuOpenOnValue = (typeof ENUMS)["menuOpenOn"][number];
+export type LiveValue = (typeof ENUMS)["live"][number];
+export type SelectableValue = (typeof ENUMS)["selectable"][number];
+export type CellTypeValue = (typeof ENUMS)["cellType"][number];
+export type SortDirectionValue = (typeof ENUMS)["sortDirection"][number];
+export type ImageLoadingValue = (typeof ENUMS)["imageLoading"][number];
+export type ScrollDirectionValue = (typeof ENUMS)["scrollDirection"][number];
+export type CollapseBelowValue = (typeof ENUMS)["collapseBelow"][number];
+export type CodeLanguageValue = (typeof ENUMS)["codeLanguage"][number];
+export type CodeTokenValue = (typeof ENUMS)["codeToken"][number];
+export type CodeBlockVariantValue = (typeof ENUMS)["codeBlockVariant"][number];
+export type CodeBlockSizeValue = (typeof ENUMS)["codeBlockSize"][number];
+export type TraceStatusValue = (typeof ENUMS)["traceStatus"][number];
+export type TraceSizeValue = (typeof ENUMS)["traceSize"][number];
+/** Token NAMES by group (values come from a theme). */
+export declare const TOKEN_NAMES: {
+    readonly color: readonly ["background", "foreground", "card", "cardForeground", "popover", "popoverForeground", "primary", "primaryForeground", "secondary", "secondaryForeground", "muted", "mutedForeground", "accent", "accentForeground", "destructive", "destructiveForeground", "success", "successForeground", "warning", "warningForeground", "info", "infoForeground", "border", "input", "ring", "chart1", "chart2", "chart3", "chart4", "chart5", "chart6", "chart7", "chart8"];
+    readonly spacing: readonly ["none", "xxs", "xs", "sm", "md", "lg", "xl", "xl2", "xl3"];
+    readonly radius: readonly ["none", "sm", "md", "lg", "xl", "xl2", "xl3", "full"];
+    readonly "type.size": readonly ["xs", "sm", "base", "lg", "xl", "xl2", "xl3"];
+    readonly "type.lineHeight": readonly ["xs", "sm", "base", "lg", "xl", "xl2", "xl3"];
+    readonly "type.weight": readonly ["regular", "medium", "semibold", "bold"];
+    readonly "type.family": readonly ["sans", "mono"];
+    readonly control: readonly ["buttonSm", "buttonMd", "buttonLg", "buttonIcon", "input", "textarea", "row", "rowCompact", "pill", "badge", "chip", "toggle", "switch", "checkbox", "slider", "progress", "meter", "avatarSm", "avatarMd", "avatarLg", "iconSm", "iconMd", "iconLg", "hairline", "appBar", "tabBar", "toast"];
+    readonly shadow: readonly ["none", "sm", "md", "lg", "xl"];
+    readonly opacity: readonly ["primary", "secondary", "tertiary", "quaternary", "disabled"];
+    readonly border: readonly ["none", "hairline", "thick"];
+    readonly motion: readonly ["fast", "standard", "slow"];
+    readonly breakpoint: readonly ["sm", "md", "lg", "xl"];
+    readonly ease: readonly ["standard", "decelerate", "accelerate"];
+    readonly density: readonly ["compact", "comfortable"];
+    readonly blur: readonly ["sm", "md", "lg", "xl"];
+    readonly scale: readonly ["press", "popoverFrom"];
+};
+export type TokenGroup = keyof typeof TOKEN_NAMES;
+export declare const STYLE_KEY_NAMES: readonly ["display", "flexDirection", "flexWrap", "justifyContent", "alignItems", "alignContent", "alignSelf", "justifySelf", "flexGrow", "flexShrink", "flexBasis", "gap", "rowGap", "columnGap", "direction", "overflow", "overflowX", "overflowY", "width", "height", "minWidth", "minHeight", "maxWidth", "maxHeight", "aspectRatio", "position", "top", "right", "bottom", "left", "inset", "insetInlineStart", "insetInlineEnd", "insetBlockStart", "insetBlockEnd", "padding", "paddingTop", "paddingRight", "paddingBottom", "paddingLeft", "paddingHorizontal", "paddingVertical", "paddingInlineStart", "paddingInlineEnd", "margin", "marginTop", "marginRight", "marginBottom", "marginLeft", "marginHorizontal", "marginVertical", "marginInlineStart", "marginInlineEnd", "gridTemplateColumns", "gridTemplateRows", "gridTemplateAreas", "gridArea", "gridColumn", "gridRow", "backgroundColor", "backgroundGradient", "color", "borderWidth", "borderTopWidth", "borderRightWidth", "borderBottomWidth", "borderLeftWidth", "borderColor", "borderStyle", "borderRadius", "borderTopLeftRadius", "borderTopRightRadius", "borderBottomRightRadius", "borderBottomLeftRadius", "opacity", "boxShadow", "fontSize", "fontWeight", "lineHeight", "letterSpacing", "textAlign", "textDecoration", "textTransform", "fontStyle", "fontFamily", "transition", "transitionEasing", "transform", "visibility", "pointerEvents", "userSelect", "cursor", "backdropBlur", "animation", "animationDuration"];
+export declare const STYLE_STATE_NAMES: readonly [":hover", ":focus-visible", ":pressed"];
+/** The Icon prop's vocabulary: packages/icons/icons.json at generate time. */
+export declare const ICON_NAMES: readonly ["a-large-small", "action-chat", "action-create", "action-default", "action-repository", "action-run", "action-suggestion", "activity", "anchor", "app-editor-chat", "archive", "arrow-down", "arrow-down-left", "arrow-left", "arrow-left-right", "arrow-right", "arrow-up-right", "at-sign", "atom", "auth-passkey", "award", "ban", "bell", "bell-off", "bold", "book-open", "bookmark", "bot", "boxes", "braces", "brain", "briefcase", "brush-cleaning", "bug", "building", "building-2", "calculator", "calendar", "calendar-days", "camera", "car", "chart-line", "check", "chevron-down", "chevron-left", "chevron-right", "chevron-up", "chevrons-up-down", "circle", "circle-arrow-up", "circle-check", "circle-dashed", "circle-dot", "circle-minus", "circle-question-mark", "circle-slash", "circle-stop", "circle-user", "circle-x", "clipboard-list", "clock", "cloud", "code", "coding-assistant", "coding-command", "coding-compact", "coding-diff", "coding-ended", "coding-in-review", "coding-needs-input", "coding-plan", "coding-running", "coding-stop", "coding-subagent", "coding-tool", "coffee", "compass", "computer", "copy", "corner-down-right", "cpu", "credit-card", "crown", "database", "download", "droplet", "dumbbell", "editor-bold", "editor-clear-formatting", "editor-code", "editor-emoji", "editor-heading-1", "editor-heading-2", "editor-heading-3", "editor-image", "editor-issue-ref", "editor-italic", "editor-link", "editor-list", "editor-list-ordered", "editor-list-todo", "editor-mention", "editor-quote", "editor-strikethrough", "editor-text", "editor-text-format", "editor-unlink", "ellipsis", "ellipsis-vertical", "event-assignee-changed", "event-board-moved", "event-estimate-changed", "event-label-added", "event-label-removed", "event-priority-changed", "event-relation-added", "event-relation-removed", "event-status-changed", "event-title-changed", "external-link", "eye", "eye-off", "fast-forward", "file", "file-diff", "file-pen-line", "file-text", "fingerprint", "flag", "flame", "flask-conical", "fold-vertical", "folder", "folder-kanban", "folder-open", "gamepad-2", "gauge", "gem", "gift", "git-branch", "git-merge", "git-pull-request", "github", "globe", "graduation-cap", "guide-changes", "hammer", "hard-drive", "hash", "heading-1", "heading-2", "heading-3", "headphones", "heart", "heart-off", "history", "hourglass", "house", "image", "images", "inbox", "info", "italic", "key", "landmark", "laptop", "layers", "layers-2", "layout-grid", "leaf", "lightbulb", "link", "link-2", "list", "list-checks", "list-end", "list-ordered", "list-todo", "list-tree", "loader-circle", "lock", "lock-open", "log-in", "log-out", "mail", "map", "map-pin", "maximize-2", "media-fast-forward", "media-rewind", "media-skip-next", "media-skip-previous", "media-volume-down", "media-volume-mute", "media-volume-off", "media-volume-up", "megaphone", "menu", "message-circle", "message-square", "message-square-plus", "message-square-reply", "mic", "microscope", "minimize-2", "minus", "monitor", "monitor-off", "moon", "mountain", "move", "music", "nav-account", "nav-actions", "nav-admin", "nav-apps", "nav-boards", "nav-changelog", "nav-computer", "nav-create-issue", "nav-devices", "nav-drafts", "nav-files", "nav-getting-started", "nav-inbox", "nav-issues", "nav-my-issues", "nav-notifications", "nav-rail-collapse", "nav-rail-expand", "nav-report-bug", "nav-search", "nav-settings", "nav-sign-out", "nav-source-control", "nav-team-switcher", "nav-terminal", "nav-threads", "newspaper", "notification-agent-message", "notification-issue-assigned", "notification-issue-comment", "notification-issue-created", "notification-issue-mention", "notification-issue-status-changed", "notification-mark-read", "notification-mute", "notification-pr-merged", "notification-pr-opened", "notification-reporter-reply", "notification-session-blocked", "os-apple", "os-linux", "os-windows", "package", "paintbrush", "palette", "panel-left-close", "panel-left-open", "paperclip", "pause", "pen-tool", "pencil", "phone", "pin", "pin-off", "plane", "play", "plug", "plus", "pr-batch", "pr-closed", "pr-draft", "pr-merged", "pr-open", "pr-stack", "printer", "priority-high", "priority-low", "priority-medium", "priority-none", "priority-urgent", "progress-1-4", "progress-1-5", "progress-2-4", "progress-2-5", "progress-3-4", "progress-3-5", "progress-4-5", "puzzle", "quote", "refresh-cw", "relation-blocked-by", "relation-blocks", "relation-duplicate", "relation-parent", "relation-related", "relation-section", "relation-sub-issue", "remove-formatting", "repeat", "rewind", "rocket", "rotate-ccw", "run-pause", "run-resume", "sc-push", "scale", "search", "search-x", "send", "server", "session-shell", "session-tree", "settings", "settings-about", "settings-account", "settings-agents", "settings-api", "settings-billing", "settings-boards", "settings-general", "settings-import", "settings-issues", "settings-labels", "settings-licenses", "settings-local-repos", "settings-mcp", "settings-members", "settings-notifications", "settings-rate", "settings-repositories", "settings-servers", "settings-sessions", "settings-statuses", "settings-storage", "settings-sync", "settings-tools", "settings-widget", "share-2", "shield", "shield-check", "shield-question-mark", "shopping-bag", "shopping-cart", "signal-high", "signal-low", "signal-medium", "skip-back", "skip-forward", "sliders-horizontal", "smartphone", "smile", "sparkles", "square-kanban", "square-pen", "square-slash", "square-terminal", "star", "star-half", "star-off", "status-backlog", "status-cancelled", "status-done", "status-duplicate", "status-in-progress", "status-in-review", "status-todo", "stethoscope", "store", "strikethrough", "sun", "support-open", "support-resolved", "tag", "target", "terminal", "tool-script", "trace-background", "trace-chevron", "trace-completed", "trace-edit", "trace-failed", "trace-fetch", "trace-read", "trace-reasoning", "trace-search", "trace-subagent", "trace-task-done", "trace-task-pending", "trace-task-running", "trace-terminal", "trace-todo", "trace-tool", "trash-2", "tree-pine", "triangle-alert", "trigger-event", "trigger-schedule", "trophy", "truck", "type", "ui-add", "ui-agent-source", "ui-archive", "ui-arrow-down", "ui-arrow-right", "ui-assignee", "ui-attach", "ui-avatar-placeholder", "ui-back", "ui-branch", "ui-check", "ui-checklist", "ui-chevron-down", "ui-chevron-left", "ui-chevron-right", "ui-chevron-up", "ui-clean", "ui-clear", "ui-clock", "ui-close", "ui-cloud", "ui-copy", "ui-delete", "ui-delete-account", "ui-device", "ui-device-default", "ui-device-offline", "ui-dock-side", "ui-docs", "ui-download", "ui-due-date", "ui-edit", "ui-empty-search", "ui-error", "ui-estimate", "ui-external-link", "ui-favorite-off", "ui-file", "ui-float", "ui-folder", "ui-folder-open", "ui-fullscreen", "ui-fullscreen-exit", "ui-github", "ui-help", "ui-hide", "ui-history", "ui-icon-placeholder", "ui-indeterminate", "ui-info", "ui-invite", "ui-issue", "ui-link", "ui-loading", "ui-mail", "ui-mcp", "ui-member", "ui-menu", "ui-minus", "ui-more", "ui-more-vertical", "ui-offline", "ui-organization", "ui-owner", "ui-permission", "ui-pin", "ui-print", "ui-private", "ui-properties", "ui-queued", "ui-redock", "ui-refresh", "ui-remove-member", "ui-repeat", "ui-repository", "ui-selected", "ui-selector", "ui-send", "ui-server", "ui-share", "ui-sign-in", "ui-sign-out", "ui-staging", "ui-star-half", "ui-star-off", "ui-stop", "ui-submit", "ui-subscribe", "ui-success", "ui-swap", "ui-team", "ui-unassigned", "ui-undo", "ui-undock", "ui-unlock", "ui-unpin", "ui-unselected", "ui-unsubscribe", "ui-update", "ui-usage", "ui-warning", "ui-watch", "ui-widget", "undo-2", "unlink", "upload", "user", "user-minus", "user-plus", "user-x", "users", "video", "volume-1", "volume-2", "volume-off", "volume-x", "wallet", "wifi-off", "work-faces", "work-results", "workflow", "wrench", "x", "zap"];
+export declare const FUNCTION_NAMES: readonly ["required", "regex", "length", "numeric", "email", "formatString", "formatNumber", "formatCurrency", "formatDate", "pluralize", "openUrl", "and", "or", "not", "percent", "add", "sub", "eq", "lt", "clamp", "cond", "fallback", "concat", "coalesce", "text", "map", "len", "fill", "set", "formatPercent", "formatRelativeTime", "filter"];
+/** VAPP-108: the typed authoring surface (src/define.ts). A ~ prop also
+ *  takes a binding or a call, a ^ prop a per-breakpoint object. */
+export type Dynamic = DataBinding | FunctionCall;
+export type Responsive<T> = {
+    base: T;
+    sm?: T;
+    md?: T;
+    lg?: T;
+    xl?: T;
+};
+export type IconName = (typeof ICON_NAMES)[number];
+/** The shared shapes (catalog `defs`). */
+export interface Shapes {
+    option: {
+        label: string | Dynamic;
+        value: string;
+        icon?: IconName;
+        disabled?: boolean;
+        description?: string;
+        image?: string;
+    };
+    check: {
+        condition: boolean | Dynamic;
+        message: string;
+    };
+    tab: {
+        label: string | Dynamic;
+        value: string;
+        icon?: IconName;
+        count?: number;
+    };
+    menuItem: {
+        label?: string;
+        value?: string;
+        kind?: MenuItemKindValue;
+        icon?: IconName;
+        shortcut?: string;
+        checked?: boolean | Dynamic;
+        destructive?: boolean;
+        disabled?: boolean;
+        items?: Shapes["menuItem"][] | Dynamic;
+        searchable?: boolean;
+        placeholder?: string;
+    };
+    searchItem: {
+        label: string | Dynamic;
+        value: string;
+        icon?: IconName;
+        identifier?: string;
+        disabled?: boolean;
+    };
+    accordionItem: {
+        title: string | Dynamic;
+        value: string;
+        count?: number;
+    };
+    segment: {
+        value: number;
+        tone?: ToneValue;
+        label?: string;
+    };
+    series: {
+        name: string;
+        values: number[];
+        tone?: ToneValue;
+    };
+    pageItem: {
+        title?: string;
+    };
+    step: {
+        label: string;
+        description?: string;
+    };
+    column: {
+        key: string;
+        label: string;
+        type?: CellTypeValue;
+        slot?: string;
+        width?: number;
+        align?: "start" | "center" | "end";
+        sortable?: boolean;
+        currency?: string;
+        decimals?: number;
+    };
+    sort: {
+        key: string;
+        direction: SortDirectionValue;
+    };
+    panel: {
+        min?: number;
+        max?: number;
+        collapsible?: boolean;
+    };
+    file: {
+        name: string;
+        size?: number;
+        type?: string;
+        url?: string;
+    };
+}
+/** Every component's props, by name. */
+export interface ComponentProps {
+    Box: {
+        style?: Style;
+        pressable?: boolean;
+    };
+    Stack: {
+        direction?: OrientationValue | Responsive<OrientationValue> | Dynamic;
+        gap?: GapValue | Responsive<GapValue>;
+        align?: AlignValue | Responsive<AlignValue> | Dynamic;
+        justify?: JustifyValue | Responsive<JustifyValue> | Dynamic;
+        wrap?: boolean | Responsive<boolean>;
+        style?: Style;
+    };
+    Grid: {
+        columns?: number | Responsive<number>;
+        gap?: GapValue | Responsive<GapValue>;
+        style?: Style;
+    };
+    Card: {
+        title?: string;
+        description?: string;
+        padded?: boolean;
+        style?: Style;
+    };
+    Separator: {
+        orientation?: OrientationValue;
+    };
+    List: {
+        direction?: ListDirectionValue;
+        gap?: GapValue;
+        divided?: boolean;
+        sectionBy?: string;
+        stickyHeaders?: boolean;
+        style?: Style;
+    };
+    Resizable: {
+        direction?: OrientationValue | Responsive<OrientationValue>;
+        sizes?: number[] | Dynamic;
+        panels?: Shapes["panel"][];
+        handle?: boolean;
+        style?: Style;
+    };
+    ScrollArea: {
+        direction?: ScrollDirectionValue;
+        maxHeight?: number;
+        style?: Style;
+    };
+    Sidebar: {
+        side?: "left" | "right";
+        width?: number;
+        collapseBelow?: CollapseBelowValue;
+        collapsed?: boolean | Dynamic;
+    };
+    SplitView: {
+        open?: boolean | Dynamic;
+        width?: number;
+    };
+    AppBar: {
+        title: string | Dynamic;
+        subtitle?: string | Dynamic;
+        back?: boolean;
+    };
+    Page: {
+        title: string | Dynamic;
+        subtitle?: string | Dynamic;
+        back?: boolean;
+        padded?: boolean;
+    };
+    Toolbar: {
+        gap?: GapValue;
+    };
+    Section: {
+        title?: string | Dynamic;
+        caption?: string | Dynamic;
+        count?: number | Dynamic;
+        icon?: IconName;
+        collapsible?: boolean;
+        open?: boolean | Dynamic;
+        tint?: ToneValue;
+        tree?: boolean;
+        loading?: boolean | Dynamic;
+        style?: Style;
+    };
+    Group: {
+        title?: string;
+        footer?: string;
+    };
+    Text: {
+        text: string | Dynamic;
+        variant?: TextVariantValue;
+        align?: "start" | "center" | "end";
+        lines?: number;
+        tone?: ToneValue;
+        shimmer?: boolean;
+        live?: LiveValue;
+        style?: Style;
+    };
+    Heading: {
+        text: string | Dynamic;
+        level?: HeadingLevelValue;
+    };
+    Markdown: {
+        text: string | Dynamic;
+        lines?: number;
+        style?: Style;
+    };
+    CodeBlock: {
+        code: string | Dynamic;
+        language?: CodeLanguageValue;
+        title?: string;
+        lineNumbers?: boolean;
+        wrap?: boolean;
+        copyable?: boolean;
+        highlight?: number[];
+        maxLines?: number;
+        variant?: CodeBlockVariantValue | Dynamic;
+        size?: CodeBlockSizeValue;
+    };
+    Kbd: {
+        keys: string;
+    };
+    Label: {
+        text: string | Dynamic;
+        for?: string;
+        required?: boolean;
+    };
+    Image: {
+        src?: string | Dynamic;
+        alt: string | Dynamic;
+        fit?: ImageFitValue;
+        width?: number;
+        height?: number;
+        aspectRatio?: number;
+        fallback?: IconName;
+        loading?: ImageLoadingValue;
+        focalX?: number;
+        focalY?: number;
+        style?: Style;
+    };
+    Icon: {
+        name: IconName | Dynamic;
+        size?: ControlSizeValue;
+        tone?: ToneValue | Dynamic;
+        label?: string;
+    };
+    Video: {
+        src: string | Dynamic;
+        poster?: string;
+        durationMs?: number;
+        autoplay?: boolean;
+        aspectRatio?: number;
+        style?: Style;
+    };
+    AudioPlayer: {
+        src: string | Dynamic;
+        title?: string;
+        durationMs?: number;
+    };
+    Avatar: {
+        name: string | Dynamic;
+        src?: string | Dynamic;
+        size?: ControlSizeValue;
+        seed?: string;
+    };
+    Carousel: {
+        page?: number | Dynamic;
+        loop?: boolean;
+        indicators?: boolean;
+    };
+    Tabs: {
+        tabs: Shapes["tab"][];
+        value?: string | Dynamic;
+        fill?: boolean;
+        closable?: TabClosableValue;
+        addable?: boolean;
+    };
+    Segmented: {
+        items: Shapes["option"][];
+        type?: GroupTypeValue;
+        value?: string | Dynamic;
+        variant?: SegmentedVariantValue;
+        size?: ControlSizeValue;
+        fill?: boolean;
+    };
+    Accordion: {
+        items: Shapes["accordionItem"][];
+        type?: GroupTypeValue;
+        value?: string | Dynamic;
+    };
+    Collapsible: {
+        title: string;
+        open?: boolean | Dynamic;
+        count?: number;
+    };
+    Trace: {
+        size?: TraceSizeValue;
+    };
+    TraceItem: {
+        title: string | Dynamic;
+        icon?: IconName;
+        description?: string;
+        status?: TraceStatusValue;
+        size?: TraceSizeValue;
+        collapsible?: boolean;
+        open?: boolean | Dynamic;
+    };
+    Pagination: {
+        totalPages: number;
+        page?: number | Dynamic;
+    };
+    Breadcrumb: {
+        items: Shapes["option"][];
+    };
+    Stepper: {
+        steps: Shapes["step"][];
+        current?: number | Dynamic;
+        orientation?: OrientationValue;
+    };
+    Dialog: {
+        title?: string;
+        description?: string;
+        open?: boolean | Dynamic;
+        dismissible?: boolean;
+    };
+    Drawer: {
+        title?: string;
+        description?: string;
+        open?: boolean | Dynamic;
+        side?: SideValue | Responsive<SideValue>;
+        dismissible?: boolean;
+        dragToDismiss?: boolean;
+    };
+    DockCard: {
+        label: string | Dynamic;
+        title: string | Dynamic;
+        caption?: string | Dynamic;
+        meta?: string | Dynamic;
+        icon?: IconName;
+        tone?: ToneValue;
+        open?: boolean | Dynamic;
+    };
+    AlertDialog: {
+        title: string;
+        description?: string;
+        confirmLabel?: string;
+        cancelLabel?: string;
+        destructive?: boolean;
+        open?: boolean | Dynamic;
+    };
+    Popover: {
+        open?: boolean | Dynamic;
+        side?: SideValue;
+        openOn?: OpenOnValue;
+    };
+    Tooltip: {
+        content: string;
+        side?: SideValue;
+    };
+    Menu: {
+        label?: string;
+        icon?: IconName;
+        items: Shapes["menuItem"][];
+        openOn?: MenuOpenOnValue;
+    };
+    Toast: {
+        title: string | Dynamic;
+        description?: string | Dynamic;
+        type?: AlertTypeValue;
+        open?: boolean | Dynamic;
+        duration?: number;
+        actionLabel?: string;
+        dismissible?: boolean;
+    };
+    Badge: {
+        text: string | Dynamic;
+        variant?: VariantValue | Dynamic;
+        icon?: IconName;
+    };
+    Alert: {
+        title: string;
+        message?: string;
+        type?: AlertTypeValue;
+    };
+    Chip: {
+        label: string | Dynamic;
+        shape?: ChipShapeValue;
+        selected?: boolean;
+        tone?: ToneValue | Dynamic;
+        dot?: string;
+        icon?: IconName;
+        image?: string;
+        detail?: string;
+        removable?: boolean;
+        pressable?: boolean;
+    };
+    EmptyState: {
+        icon: IconName;
+        title: string;
+        description?: string;
+        actionLabel?: string;
+        size?: "page" | "list";
+    };
+    Progress: {
+        value: number | Dynamic;
+        max?: number;
+        label?: string;
+        tone?: ToneValue;
+    };
+    Meter: {
+        segments: Shapes["segment"][];
+        max?: number;
+        label?: string;
+        value?: string;
+    };
+    Ring: {
+        value: number | Dynamic;
+        size?: ControlSizeValue;
+        tone?: ToneValue;
+        label?: string;
+    };
+    Spinner: {
+        size?: SpinnerSizeValue;
+        label?: string;
+    };
+    Skeleton: {
+        width?: string;
+        height?: string;
+        rounded?: boolean;
+        rows?: number;
+        rowHeight?: number;
+        dot?: boolean;
+    };
+    Table: {
+        columns: Shapes["column"][];
+        rows: Record<string, unknown>[] | Dynamic;
+        rowKey?: string;
+        sort?: Shapes["sort"] | Dynamic;
+        selectable?: SelectableValue;
+        selected?: string[] | Dynamic;
+        caption?: string;
+        emptyText?: string;
+        striped?: boolean;
+        density?: DensityValue;
+        stickyHeader?: boolean;
+    };
+    Chart: {
+        kind: ChartKindValue;
+        categories?: string[] | Dynamic;
+        series: Shapes["series"][] | Dynamic;
+        title?: string;
+        height?: number;
+        xLabel?: string;
+        yLabel?: string;
+        min?: number;
+        max?: number;
+        showAxes?: boolean;
+        showGrid?: boolean;
+        showLegend?: boolean;
+        showValues?: boolean;
+    };
+    Sparkline: {
+        values: number[] | Dynamic;
+        tone?: ToneValue;
+        height?: number;
+    };
+    StatTile: {
+        label: string | Dynamic;
+        value: string | Dynamic;
+        delta?: string | Dynamic;
+        tone?: ToneValue | Dynamic;
+        trend?: number[] | Dynamic;
+    };
+    Button: {
+        label?: string | Dynamic;
+        icon?: IconName | Dynamic;
+        variant?: VariantValue;
+        size?: SizeValue;
+        disabled?: boolean | Dynamic;
+        loading?: boolean;
+        pendingLabel?: string;
+        submit?: boolean;
+    };
+    Link: {
+        label: string | Dynamic;
+        href?: string;
+        external?: boolean;
+    };
+    Toggle: {
+        label: string;
+        icon?: IconName;
+        pressed?: boolean | Dynamic;
+        variant?: "default" | "outline";
+        size?: ControlSizeValue;
+    };
+    Form: {
+        name: string;
+        disabled?: boolean | Dynamic;
+        busy?: boolean | Dynamic;
+        summary?: boolean;
+    };
+    FieldGroup: {
+        columns?: number;
+    };
+    FormActions: {
+        submit: string | Dynamic;
+        cancel?: boolean;
+        destructive?: boolean;
+    };
+    Input: {
+        label: string;
+        name: string;
+        type?: InputTypeValue;
+        placeholder?: string;
+        value?: string | Dynamic;
+        disabled?: boolean;
+        checks?: Shapes["check"][];
+        validateOn?: ValidateOnValue;
+    };
+    Textarea: {
+        label: string;
+        name: string;
+        placeholder?: string;
+        rows?: number;
+        autosize?: boolean;
+        maxRows?: number;
+        value?: string | Dynamic;
+        disabled?: boolean;
+        checks?: Shapes["check"][];
+        validateOn?: ValidateOnValue;
+    };
+    NumberField: {
+        label: string;
+        name: string;
+        value?: number | Dynamic;
+        min?: number;
+        max?: number;
+        step?: number;
+        precision?: number;
+        unit?: string;
+        placeholder?: string;
+        disabled?: boolean;
+        checks?: Shapes["check"][];
+        validateOn?: ValidateOnValue;
+    };
+    Checkbox: {
+        label: string | Dynamic;
+        name: string;
+        checked?: boolean | Dynamic;
+        disabled?: boolean;
+        checks?: Shapes["check"][];
+    };
+    Radio: {
+        label?: string;
+        name: string;
+        options: Shapes["option"][];
+        value?: string | Dynamic;
+        orientation?: OrientationValue;
+        checks?: Shapes["check"][];
+    };
+    ChoiceTiles: {
+        name: string;
+        options: Shapes["option"][];
+        type?: GroupTypeValue;
+        value?: string | Dynamic;
+        columns?: number;
+        disabled?: boolean;
+        checks?: Shapes["check"][];
+    };
+    Switch: {
+        label: string | Dynamic;
+        name: string;
+        checked?: boolean | Dynamic;
+        description?: string;
+        disabled?: boolean;
+    };
+    Slider: {
+        label?: string;
+        min?: number | Dynamic;
+        max: number | Dynamic;
+        step?: number;
+        value?: number | Dynamic;
+    };
+    Rating: {
+        value?: number | Dynamic;
+        max?: number;
+        readOnly?: boolean;
+        size?: ControlSizeValue;
+    };
+    Select: {
+        label?: string;
+        name: string;
+        options?: Shapes["option"][] | Dynamic;
+        source?: string;
+        placeholder?: string;
+        value?: string | Dynamic;
+        multiple?: boolean;
+        searchable?: boolean;
+        emptyText?: string;
+        disabled?: boolean;
+        checks?: Shapes["check"][];
+        validateOn?: ValidateOnValue;
+    };
+    SearchList: {
+        items: Shapes["searchItem"][] | Dynamic;
+        query?: string | Dynamic;
+        placeholder?: string;
+        value?: string | Dynamic;
+        emptyText?: string;
+        maxRows?: number;
+        showCount?: boolean;
+    };
+    ChipInput: {
+        label?: string;
+        name: string;
+        values?: string[] | Dynamic;
+        suggestions?: Shapes["option"][] | Dynamic;
+        placeholder?: string;
+        max?: number;
+        disabled?: boolean;
+        checks?: Shapes["check"][];
+    };
+    DatePicker: {
+        label?: string;
+        name: string;
+        value?: string | Dynamic;
+        min?: string;
+        max?: string;
+        placeholder?: string;
+        firstDayOfWeek?: number;
+    };
+    DateRangePicker: {
+        label?: string;
+        name: string;
+        start?: string | Dynamic;
+        end?: string | Dynamic;
+        min?: string;
+        max?: string;
+        placeholder?: string;
+        firstDayOfWeek?: number;
+    };
+    TimePicker: {
+        label?: string;
+        name: string;
+        value?: string | Dynamic;
+        min?: string;
+        max?: string;
+        step?: number;
+        placeholder?: string;
+        disabled?: boolean;
+    };
+    FileUpload: {
+        label?: string;
+        name: string;
+        accept?: string;
+        multiple?: boolean;
+        maxSize?: number;
+        files?: Shapes["file"][] | Dynamic;
+        hint?: string;
+        disabled?: boolean;
+    };
+    Composer: {
+        placeholder?: string;
+        value?: string | Dynamic;
+        submitLabel?: string;
+        attachments?: boolean;
+        busy?: boolean;
+    };
+    Row: {
+        title: string | Dynamic;
+        identifier?: string | Dynamic;
+        subtitle?: string | Dynamic;
+        meta?: string | Dynamic;
+        value?: string | Dynamic;
+        placeholder?: string;
+        icon?: IconName | Dynamic;
+        chevron?: RowChevronValue | Dynamic;
+        selected?: boolean | Dynamic;
+        density?: DensityValue;
+        surface?: RowSurfaceValue;
+        pressable?: boolean;
+        depth?: number;
+    };
+    TreeGuides: {
+        depth: number;
+        elbowAt?: number;
+        tee?: boolean;
+        passThrough?: number[];
+    };
+    Unknown: {
+        component: string;
+        catalogId?: string;
+    };
+}
+/** A2UI basic component → core component. */
+export declare const BASIC_COMPONENT_MAP: Record<string, string>;
+/** A2UI basic icon name → icons.json name (the placeholder where none exists). */
+export declare const BASIC_ICON_MAP: Record<string, string>;
+export declare const BASIC_PLACEHOLDER_ICON = "ui-icon-placeholder";