gd-design-library 1.8.2 → 1.8.3

package/ai/a2ui/spec-schema.d.cts

@@ -0,0 +1,2220 @@
+import { A2UI_COMPONENT_TYPES, A2UI_BUTTON_VARIANTS } from './component-map.js';
+/**
+ * Full A2UI specification schema.
+ *
+ * Pass to Gemini as:
+ *   generationConfig: { responseMimeType: 'application/json', responseSchema: A2UI_SPEC_SCHEMA }
+ */
+export declare const A2UI_SPEC_SCHEMA: {
+    readonly type: "object";
+    readonly required: readonly ["version", "metadata", "ui"];
+    readonly properties: {
+        readonly version: {
+            readonly type: "string";
+            readonly pattern: "^\\d+\\.\\d+\\.\\d+$";
+            readonly description: "Semantic version of the UI specification";
+            readonly example: "1.0.0";
+        };
+        readonly metadata: {
+            readonly type: "object";
+            readonly required: readonly ["agentId", "agentName", "timestamp"];
+            readonly properties: {
+                readonly agentId: {
+                    readonly type: "string";
+                    readonly description: "Unique identifier for the agent";
+                };
+                readonly agentName: {
+                    readonly type: "string";
+                    readonly description: "Human-readable agent name";
+                };
+                readonly agentVersion: {
+                    readonly type: "string";
+                    readonly pattern: "^\\d+\\.\\d+\\.\\d+$";
+                };
+                readonly timestamp: {
+                    readonly type: "string";
+                    readonly format: "date-time";
+                    readonly description: "ISO 8601 timestamp of UI generation";
+                };
+                readonly sessionId: {
+                    readonly type: "string";
+                    readonly description: "Session identifier for conversation continuity";
+                };
+                readonly provider: {
+                    readonly type: "string";
+                    readonly description: "LLM provider or orchestration source for the generated spec, for example openai, anthropic, gemini, or local";
+                };
+                readonly scenario: {
+                    readonly type: "string";
+                    readonly description: "Scenario, use case, or workflow identifier associated with this spec";
+                };
+                readonly segment: {
+                    readonly type: "string";
+                    readonly description: "Optional orchestration segment or stage identifier when a flow is generated in multiple parts";
+                };
+                readonly isSimulated: {
+                    readonly type: "boolean";
+                    readonly description: "Demo-only flag indicating the spec was simulated or replayed instead of generated live";
+                };
+                readonly locale: {
+                    readonly type: "string";
+                    readonly default: "en-US";
+                    readonly pattern: "^[a-z]{2}-[A-Z]{2}$";
+                };
+                readonly theme: {
+                    readonly type: "string";
+                    readonly enum: readonly ["light", "dark", "auto"];
+                    readonly default: "auto";
+                };
+                readonly customData: {
+                    readonly type: "object";
+                    readonly description: "Agent-specific metadata";
+                };
+            };
+        };
+        readonly ui: {
+            readonly type: "object";
+            readonly required: readonly ["layout", "components"];
+            readonly properties: {
+                readonly layout: {
+                    readonly type: "object";
+                    readonly required: readonly ["type"];
+                    readonly properties: {
+                        readonly type: {
+                            readonly type: "string";
+                            readonly enum: readonly ["vertical", "horizontal", "grid", "flex", "stack", "split"];
+                            readonly description: "Layout type mapping to GD Design Library layout components";
+                        };
+                        readonly spacing: {
+                            readonly type: "string";
+                            readonly description: "Spacing between elements — must be a real CSS value (e.g. '16px', '1rem'). Never use token strings like 'xs', 'sm', 'md', 'lg', 'xl', 'none'.";
+                        };
+                        readonly gridColumns: {
+                            readonly type: "integer";
+                            readonly minimum: 1;
+                            readonly maximum: 12;
+                            readonly description: "Number of columns for grid layout";
+                        };
+                        readonly alignment: {
+                            readonly type: "string";
+                            readonly enum: readonly ["start", "center", "end", "stretch", "baseline"];
+                        };
+                        readonly justification: {
+                            readonly type: "string";
+                            readonly enum: readonly ["start", "center", "end", "space-between", "space-around", "space-evenly"];
+                        };
+                        readonly responsive: {
+                            readonly type: "object";
+                            readonly properties: {
+                                readonly mobile: {
+                                    readonly type: "object";
+                                    readonly properties: {
+                                        readonly type: {
+                                            readonly type: "string";
+                                        };
+                                        readonly gridColumns: {
+                                            readonly type: "integer";
+                                        };
+                                        readonly spacing: {
+                                            readonly type: "string";
+                                        };
+                                    };
+                                };
+                                readonly tablet: {
+                                    readonly type: "object";
+                                    readonly properties: {
+                                        readonly type: {
+                                            readonly type: "string";
+                                        };
+                                        readonly gridColumns: {
+                                            readonly type: "integer";
+                                        };
+                                        readonly spacing: {
+                                            readonly type: "string";
+                                        };
+                                    };
+                                };
+                                readonly desktop: {
+                                    readonly type: "object";
+                                    readonly properties: {
+                                        readonly type: {
+                                            readonly type: "string";
+                                        };
+                                        readonly gridColumns: {
+                                            readonly type: "integer";
+                                        };
+                                        readonly spacing: {
+                                            readonly type: "string";
+                                        };
+                                    };
+                                };
+                            };
+                        };
+                    };
+                };
+                readonly components: {
+                    readonly type: "array";
+                    readonly minItems: 1;
+                    readonly description: "Array of UI components to render.";
+                    readonly items: {
+                        readonly type: "object";
+                        readonly required: readonly ["id", "type"];
+                        readonly properties: {
+                            readonly id: {
+                                readonly type: "string";
+                                readonly description: "Unique component identifier";
+                            };
+                            readonly type: {
+                                readonly type: "string";
+                                readonly enum: string[];
+                                readonly description: "Component type — maps to gd-design-library (GridKit) React component. Source of truth: ./component-map.ts";
+                            };
+                            readonly label: {
+                                readonly type: "string";
+                                readonly description: "Component label or title";
+                            };
+                            readonly value: {
+                                readonly description: "Component value (any type)";
+                            };
+                            readonly initial: {
+                                readonly type: "number";
+                                readonly description: "Initial numeric value used by counter components.";
+                            };
+                            readonly caption: {
+                                readonly type: "string";
+                                readonly description: "Optional caption text for images. Only used by type \"image\".";
+                            };
+                            readonly placeholder: {
+                                readonly type: "string";
+                            };
+                            readonly helpText: {
+                                readonly type: "string";
+                                readonly description: "Helper text or description";
+                            };
+                            readonly ariaLabel: {
+                                readonly type: "string";
+                                readonly description: "Accessible label used when visible text alone is not sufficient.";
+                            };
+                            readonly content: {
+                                readonly type: "string";
+                                readonly description: "Tooltip text content. Only used by type \"tooltip\".";
+                            };
+                            readonly name: {
+                                readonly type: "string";
+                                readonly description: "Component-specific name. For avatar-user: user display name. For loader: animation type (\"circle\" or \"dots\"). For rating: radio group name. Prefer dedicated props where documented.";
+                            };
+                            readonly subtitle: {
+                                readonly type: "string";
+                                readonly description: "Secondary text line. Only used by type \"avatar-user\".";
+                            };
+                            readonly className: {
+                                readonly type: "string";
+                                readonly description: "Optional CSS class name forwarded to wrapper-style primitives such as box and wrapper.";
+                            };
+                            readonly tabIndex: {
+                                readonly type: "number";
+                                readonly description: "Keyboard tab order for focusable primitives such as box.";
+                            };
+                            readonly layout: {
+                                readonly type: "string";
+                                readonly enum: readonly ["horizontal", "vertical"];
+                                readonly description: "Carousel layout direction. Only used by type \"carousel\".";
+                            };
+                            readonly as: {
+                                readonly type: "string";
+                                readonly description: "Underlying HTML tag override (for example \"section\", \"article\", \"figure\", \"figcaption\", \"span\").";
+                            };
+                            readonly htmlFor: {
+                                readonly type: "string";
+                                readonly description: "Associated form control ID for label components. Only used by type \"label\".";
+                            };
+                            readonly captionAs: {
+                                readonly type: "string";
+                                readonly description: "HTML tag override for image captions. Only used by type \"image\".";
+                            };
+                            readonly WrapperView: {
+                                readonly type: "string";
+                                readonly description: "Underlying HTML tag for the optional portal wrapper. Only used by type \"portal\".";
+                            };
+                            readonly container: {
+                                readonly type: "string";
+                                readonly description: "CSS selector for an existing DOM node that should receive portal content. Only used by type \"portal\".";
+                            };
+                            readonly href: {
+                                readonly type: "string";
+                                readonly description: "Link destination URL. Top-level field for type \"link\".";
+                            };
+                            readonly target: {
+                                readonly type: "string";
+                                readonly enum: readonly ["_blank", "_self", "_parent", "_top"];
+                                readonly description: "Link browsing context. Top-level field for type \"link\".";
+                            };
+                            readonly rel: {
+                                readonly type: "string";
+                                readonly description: "Link relationship attribute. Top-level field for type \"link\".";
+                            };
+                            readonly buttonType: {
+                                readonly type: "string";
+                                readonly enum: readonly ["button", "submit", "reset"];
+                                readonly description: "HTML button type attribute. Only used by type \"button\".";
+                            };
+                            readonly placement: {
+                                readonly type: "string";
+                                readonly enum: readonly ["top", "bottom", "left", "right", "top-left", "top-center", "top-right", "bottom-left", "bottom-center", "bottom-right"];
+                                readonly description: "Component placement. Used by tooltip (\"top\" | \"bottom\" | \"left\" | \"right\"), menu corner placement, and snackbar overlay placement.";
+                            };
+                            readonly delay: {
+                                readonly type: "number";
+                                readonly description: "Tooltip open delay in milliseconds.";
+                            };
+                            readonly length: {
+                                readonly type: "string";
+                                readonly description: "Separator explicit length (for example \"40px\" or \"100%\"). Especially useful for vertical separators. Only used by type \"separator\".";
+                            };
+                            readonly required: {
+                                readonly type: "boolean";
+                                readonly default: false;
+                            };
+                            readonly disabled: {
+                                readonly type: "boolean";
+                                readonly default: false;
+                            };
+                            readonly readOnly: {
+                                readonly type: "boolean";
+                                readonly default: false;
+                            };
+                            readonly visible: {
+                                readonly type: "boolean";
+                                readonly default: true;
+                            };
+                            readonly isOpen: {
+                                readonly type: "boolean";
+                                readonly description: "Controlled open state for collapsible layout components such as chat-container.";
+                            };
+                            readonly bordered: {
+                                readonly type: "boolean";
+                                readonly description: "Whether the component renders with a bordered container. Used by type \"breadcrumbs\".";
+                            };
+                            readonly checked: {
+                                readonly type: "boolean";
+                                readonly description: "Checked/on state for checkbox and switch components.";
+                            };
+                            readonly indeterminate: {
+                                readonly type: "boolean";
+                                readonly description: "Mixed state for checkbox components.";
+                            };
+                            readonly allowMultipleExpand: {
+                                readonly type: "boolean";
+                                readonly description: "Whether accordion allows multiple items to stay expanded at once.";
+                            };
+                            readonly withoutSeparator: {
+                                readonly type: "boolean";
+                                readonly description: "Whether accordion items render without divider lines.";
+                            };
+                            readonly isInline: {
+                                readonly type: "boolean";
+                                readonly description: "Whether accordion headers render using inline layout.";
+                            };
+                            readonly defaultValue: {
+                                readonly description: "Initial uncontrolled value. Used by accordion, radio-group, and rating components. Type depends on the component.";
+                            };
+                            readonly max: {
+                                readonly type: "number";
+                                readonly description: "Maximum numeric value. Used by counter as the upper bound, by rating as the total item count, and by slider when modeled as a top-level prop.";
+                            };
+                            readonly min: {
+                                readonly type: "number";
+                                readonly description: "Minimum numeric value. Used by counter as the lower bound and by slider when modeled as a top-level prop.";
+                            };
+                            readonly variant: {
+                                readonly type: "string";
+                                readonly description: "Visual variant for the component. Button: primary|secondary|tertiary|outlined|text|inherit. Separator: solid|dashed|dotted. Card: vertical|horizontal. Badge: primary|secondary|tertiary|quaternary|quinary. Inline-notification: success|warning|error|info.";
+                            };
+                            readonly appearance: {
+                                readonly type: "string";
+                                readonly description: "Secondary visual appearance modifier. For badge: filled|filledLight|outline|outlineFilledLight.";
+                            };
+                            readonly size: {
+                                readonly type: "string";
+                                readonly enum: readonly ["xs", "sm", "md", "lg", "xl"];
+                                readonly default: "md";
+                            };
+                            readonly styleVariant: {
+                                readonly type: readonly ["string", "array"];
+                                readonly items: {
+                                    readonly type: "string";
+                                };
+                                readonly description: "Typography style modifiers. Use a string or array such as \"bold\" or [\"italic\", \"underline\"]. Only used by type \"typography\".";
+                            };
+                            readonly underline: {
+                                readonly type: "string";
+                                readonly enum: readonly ["default", "highlight", "none"];
+                                readonly description: "Link underline behavior. Top-level field for type \"link\".";
+                            };
+                            readonly labelSide: {
+                                readonly type: "string";
+                                readonly enum: readonly ["left", "right"];
+                                readonly description: "Switch label placement relative to the control. Only used by type \"switch\".";
+                            };
+                            readonly separator: {
+                                readonly type: "string";
+                                readonly description: "Breadcrumb text separator (for example \"/\" or \">\"). Also used by type \"attachment-file\" as the character between fileType and fileSize (defaults to \"·\").";
+                            };
+                            readonly separatorIcon: {
+                                readonly type: "string";
+                                readonly description: "Icon name used as the breadcrumb separator. Only used by type \"breadcrumbs\".";
+                            };
+                            readonly separatorAfterLastItem: {
+                                readonly type: "boolean";
+                                readonly description: "Whether breadcrumbs should render a separator after the last item.";
+                            };
+                            readonly rounded: {
+                                readonly type: "string";
+                                readonly enum: readonly ["none", "default", "round", "xs", "sm", "md", "lg", "xl"];
+                                readonly description: "Loader border radius for dots animation. Top-level field for type \"loader\".";
+                            };
+                            readonly withWrapper: {
+                                readonly type: "boolean";
+                                readonly description: "Whether a helper wrapper container should be rendered. Used by type \"loader\" and \"portal\".";
+                            };
+                            readonly wrapperVariant: {
+                                readonly type: "string";
+                                readonly enum: readonly ["inline", "section", "fullPage"];
+                                readonly description: "Wrapper preset used by the portal helper wrapper. Only used by type \"portal\".";
+                            };
+                            readonly blocksScroll: {
+                                readonly type: "boolean";
+                                readonly description: "Whether the portal should lock background document scrolling while mounted.";
+                            };
+                            readonly animationName: {
+                                readonly type: readonly ["string", "null"];
+                                readonly description: "Skeleton animation keyframe name. Accepts theme animation token names such as \"blinkKeyframes\", raw CSS animation names, or null to disable the built-in animation. Only used by type \"skeleton\".";
+                            };
+                            readonly animationProps: {
+                                readonly type: "string";
+                                readonly description: "Custom CSS animation shorthand forwarded to skeleton or loader when fine-grained animation control is needed.";
+                            };
+                            readonly color: {
+                                readonly type: "string";
+                                readonly description: "Top-level color prop. Prefer theme color token paths (e.g. \"text.secondary\", \"border.default\"). Palette-style aliases like \"brand.500\" and \"theme.palette.warning.main\" are also accepted. Use raw CSS/hex only when no theme token fits. Used by typography and separator.";
+                            };
+                            readonly icon: {
+                                readonly type: "string";
+                                readonly description: "Icon name from GD icon set. Used by the icon component, snackbar, accordion header expand icons, and avatar icon fallbacks. Also accepted as a legacy alias for iconStart on some leading-adornment components.";
+                            };
+                            readonly iconStart: {
+                                readonly type: "string";
+                                readonly description: "Leading icon name from GD icon set. Preferred field for components with a start icon or adornment such as badge, button, input, input-file, menu triggers, and select.";
+                            };
+                            readonly iconEnd: {
+                                readonly type: "string";
+                                readonly description: "Trailing icon name from GD icon set. Used by button, badge, input, input-file, and select.";
+                            };
+                            readonly fill: {
+                                readonly type: "string";
+                                readonly description: "Fill color for multi-path icons. Prefer theme color token paths (e.g. \"icon.error\", \"icon.primary\", \"icon.default\"). Use raw CSS/hex only when no theme token fits. Used by type \"icon\" and avatar icon fallbacks.";
+                            };
+                            readonly fillSvg: {
+                                readonly type: "string";
+                                readonly description: "Uniform fill color for the entire SVG. Prefer theme color token paths (same options as fill). Use raw CSS/hex only when no theme token fits. Overrides fill. Used by type \"icon\" and avatar icon fallbacks.";
+                            };
+                            readonly width: {
+                                readonly description: "Width. For icon: pixel number (e.g. 24). For layout components: CSS string (e.g. \"100%\", \"200px\").";
+                            };
+                            readonly height: {
+                                readonly description: "Height. For icon: pixel number (e.g. 24). For layout components: CSS string (e.g. \"100px\").";
+                            };
+                            readonly minHeight: {
+                                readonly type: readonly ["string", "number"];
+                                readonly description: "Minimum height constraint. Use CSS strings for layout components (for example \"120px\") or numbers for menu positioning logic.";
+                            };
+                            readonly count: {
+                                readonly type: "number";
+                                readonly description: "SliderDots total dot count. Only used by type \"slider-dots\".";
+                            };
+                            readonly activeIndex: {
+                                readonly type: readonly ["string", "number"];
+                                readonly description: "Active index or active option value. Used by slider-dots and select components.";
+                            };
+                            readonly step: {
+                                readonly type: "number";
+                                readonly description: "Slider step increment. Only used by type \"slider\".";
+                            };
+                            readonly lines: {
+                                readonly type: "number";
+                                readonly description: "Maximum number of lines before truncation. Only used by type \"truncate\".";
+                            };
+                            readonly objectFit: {
+                                readonly type: "string";
+                                readonly enum: readonly ["cover", "contain", "fill", "none", "scale-down"];
+                                readonly description: "Image object-fit behavior. Only used by type \"image\".";
+                            };
+                            readonly isBordered: {
+                                readonly type: "boolean";
+                            };
+                            readonly isHighlighted: {
+                                readonly type: "boolean";
+                            };
+                            readonly withShadowHover: {
+                                readonly type: "boolean";
+                            };
+                            readonly fullWidth: {
+                                readonly type: "boolean";
+                                readonly description: "Whether the internal button should stretch to the full container width. Used by button/input-file.";
+                            };
+                            readonly isIcon: {
+                                readonly type: "boolean";
+                                readonly description: "Whether the control should render as an icon-only button. Used by button/input-file.";
+                            };
+                            readonly showArrows: {
+                                readonly type: "boolean";
+                                readonly description: "Whether carousel navigation arrows are visible. Used by type \"carousel\" and \"content-carousel\".";
+                            };
+                            readonly showDots: {
+                                readonly type: "boolean";
+                                readonly description: "Whether carousel dot indicators are visible. Used by type \"carousel\" and \"content-carousel\".";
+                            };
+                            readonly thumbs: {
+                                readonly type: "string";
+                                readonly enum: readonly ["start", "end"];
+                                readonly description: "Thumbnail strip position. Only used by type \"carousel\".";
+                            };
+                            readonly isFocusable: {
+                                readonly type: "boolean";
+                                readonly description: "Whether the carousel root receives keyboard focus. Used by type \"carousel\" and \"content-carousel\".";
+                            };
+                            readonly visibleItems: {
+                                readonly type: "number";
+                                readonly description: "Number of items visible at once. Only used by type \"content-carousel\".";
+                            };
+                            readonly scrollStep: {
+                                readonly type: "number";
+                                readonly description: "Number of items to scroll per navigation action. Only used by type \"content-carousel\".";
+                            };
+                            readonly scrollAlignment: {
+                                readonly type: "string";
+                                readonly enum: readonly ["left", "centered"];
+                                readonly description: "Content carousel scroll alignment. Only used by type \"content-carousel\".";
+                            };
+                            readonly vertical: {
+                                readonly type: "string";
+                                readonly enum: readonly ["hidden", "visible", "auto"];
+                                readonly description: "Vertical scrollbar visibility. Only used by type \"scroll\".";
+                            };
+                            readonly horizontal: {
+                                readonly type: "string";
+                                readonly enum: readonly ["hidden", "visible", "auto"];
+                                readonly description: "Horizontal scrollbar visibility. Only used by type \"scroll\".";
+                            };
+                            readonly autoHide: {
+                                readonly type: "boolean";
+                                readonly description: "Whether visible scrollbars should fade out after scrolling stops. Only used by type \"scroll\".";
+                            };
+                            readonly showSidebarAsideControl: {
+                                readonly type: "boolean";
+                                readonly description: "Whether the chat sidebar shows its internal collapse/close control.";
+                            };
+                            readonly showSidebarHeaderControl: {
+                                readonly type: "boolean";
+                                readonly description: "Whether the main chat header shows the control that reopens the sidebar.";
+                            };
+                            readonly multiple: {
+                                readonly type: "boolean";
+                                readonly description: "Multi-value selection mode for select/input-file components.";
+                            };
+                            readonly searchable: {
+                                readonly type: "boolean";
+                                readonly description: "Whether the select shows a search field.";
+                            };
+                            readonly searchPlaceholder: {
+                                readonly type: "string";
+                                readonly description: "Placeholder text for the select search field.";
+                            };
+                            readonly autoOpen: {
+                                readonly type: "boolean";
+                                readonly description: "Whether the select dropdown opens automatically on render.";
+                            };
+                            readonly accept: {
+                                readonly type: "string";
+                                readonly description: "Accepted file MIME types or extensions for input-file.";
+                            };
+                            readonly capture: {
+                                readonly type: readonly ["boolean", "string"];
+                                readonly enum: readonly [true, false, "user", "environment"];
+                                readonly description: "Mobile capture mode for input-file.";
+                            };
+                            readonly inputFileButtonLabel: {
+                                readonly type: "string";
+                                readonly description: "Visible label for the drag-and-drop file picker button.";
+                            };
+                            readonly acceptedFileTypes: {
+                                readonly type: "array";
+                                readonly items: {
+                                    readonly type: "string";
+                                };
+                                readonly description: "Allowed MIME types for drag-and-drop file validation.";
+                            };
+                            readonly maxFileSize: {
+                                readonly type: "number";
+                                readonly description: "Maximum allowed file size in bytes for each dropped or selected file.";
+                            };
+                            readonly maxFiles: {
+                                readonly type: "number";
+                                readonly description: "Maximum total number of files allowed by drag-and-drop.";
+                            };
+                            readonly debounceCallbackTime: {
+                                readonly type: "number";
+                                readonly description: "Debounce delay in milliseconds for input change handlers.";
+                            };
+                            readonly ariaDescribedBy: {
+                                readonly type: "string";
+                                readonly description: "ID of helper/error text announced by screen readers.";
+                            };
+                            readonly resize: {
+                                readonly type: "string";
+                                readonly enum: readonly ["none", "both", "horizontal", "vertical"];
+                                readonly description: "Textarea resize mode. Only used by type \"textarea\".";
+                            };
+                            readonly dynamicHeightAdjustment: {
+                                readonly type: "boolean";
+                                readonly description: "Whether textarea height should auto-grow with content.";
+                            };
+                            readonly maxCharacters: {
+                                readonly type: "number";
+                                readonly description: "Maximum character count for textarea. Shows a counter in the UI.";
+                            };
+                            readonly maxLength: {
+                                readonly type: "number";
+                                readonly description: "Maximum character count for InputArea.";
+                            };
+                            readonly currentValue: {
+                                readonly type: "string";
+                                readonly description: "Current formatted price value without the currency symbol. Only used by type \"price\".";
+                            };
+                            readonly oldValue: {
+                                readonly type: "string";
+                                readonly description: "Optional previous price shown as the struck-through comparison value. Only used by type \"price\".";
+                            };
+                            readonly currencySymbol: {
+                                readonly type: "string";
+                                readonly description: "Currency symbol displayed by price components (for example \"$\", \"€\", or \"zł\").";
+                            };
+                            readonly currencySymbolPosition: {
+                                readonly type: "string";
+                                readonly enum: readonly ["before", "after"];
+                                readonly description: "Where the currency symbol should appear relative to the value. Only used by type \"price\".";
+                            };
+                            readonly gutter: {
+                                readonly type: readonly ["string", "number"];
+                                readonly description: "Gap between direct children for row, column, and card container components.";
+                            };
+                            readonly gap: {
+                                readonly type: "string";
+                                readonly description: "Top-level gap prop used by flex-container and as an alias for row/column gutter.";
+                            };
+                            readonly padding: {
+                                readonly type: "string";
+                                readonly description: "CSS inner padding for card and related layout containers.";
+                            };
+                            readonly align: {
+                                readonly type: "string";
+                                readonly enum: readonly ["start", "center", "end", "stretch"];
+                                readonly description: "Cross-axis alignment for row and column layout primitives.";
+                            };
+                            readonly justify: {
+                                readonly type: "string";
+                                readonly enum: readonly ["start", "center", "end", "space-between", "space-around"];
+                                readonly description: "Main-axis distribution for row and column layout primitives.";
+                            };
+                            readonly isWrap: {
+                                readonly type: "boolean";
+                                readonly description: "Whether row or column children are allowed to wrap.";
+                            };
+                            readonly flex: {
+                                readonly type: "string";
+                                readonly description: "CSS flex shorthand for row or column components when they are children of another flex container.";
+                            };
+                            readonly isReversed: {
+                                readonly type: "boolean";
+                                readonly description: "Whether row or column direction is visually reversed.";
+                            };
+                            readonly flexDirection: {
+                                readonly type: "string";
+                                readonly enum: readonly ["row", "column", "row-reverse", "column-reverse"];
+                                readonly description: "Top-level flex direction prop for flex-container.";
+                            };
+                            readonly alignItems: {
+                                readonly type: "string";
+                                readonly description: "Top-level align-items prop for flex-container or alias for row/column alignment.";
+                            };
+                            readonly justifyContent: {
+                                readonly type: "string";
+                                readonly description: "Top-level justify-content prop for flex-container or alias for row/column justification.";
+                            };
+                            readonly showPercentage: {
+                                readonly type: "boolean";
+                                readonly description: "Whether the progress bar should show a numeric percentage label.";
+                            };
+                            readonly fillColor: {
+                                readonly type: "string";
+                                readonly description: "Filled-track color for progress bars. Prefer theme token paths before raw CSS or hex colors.";
+                            };
+                            readonly closeOnSelect: {
+                                readonly type: "boolean";
+                                readonly description: "Whether a menu closes immediately after an option is selected.";
+                            };
+                            readonly offsetX: {
+                                readonly type: "number";
+                                readonly description: "Horizontal offset in pixels used by menu positioning.";
+                            };
+                            readonly offsetY: {
+                                readonly type: "number";
+                                readonly description: "Vertical offset in pixels used by menu positioning.";
+                            };
+                            readonly gridColumns: {
+                                readonly type: readonly ["number", "string"];
+                                readonly description: "Radio-group grid column count when variant is \"grid\".";
+                            };
+                            readonly gridRows: {
+                                readonly type: readonly ["number", "string"];
+                                readonly description: "Radio-group grid row count when variant is \"grid\".";
+                            };
+                            readonly gridColumnGutter: {
+                                readonly type: readonly ["number", "string"];
+                                readonly description: "Horizontal spacing between radio-group grid items.";
+                            };
+                            readonly gridRowGutter: {
+                                readonly type: readonly ["number", "string"];
+                                readonly description: "Vertical spacing between radio-group grid rows.";
+                            };
+                            readonly wrapItems: {
+                                readonly type: "boolean";
+                                readonly description: "Whether radio-group items should wrap in row or column layouts.";
+                            };
+                            readonly itemWidth: {
+                                readonly type: "string";
+                                readonly description: "Per-option width for radio-group visual tiles.";
+                            };
+                            readonly itemHeight: {
+                                readonly type: "string";
+                                readonly description: "Per-option height for radio-group visual tiles.";
+                            };
+                            readonly isIconsView: {
+                                readonly type: "boolean";
+                                readonly description: "Whether stepper indicators should render icons instead of step numbers.";
+                            };
+                            readonly duration: {
+                                readonly type: readonly ["number", "null"];
+                                readonly description: "Auto-dismiss duration in milliseconds. Only used by type \"snackbar\".";
+                            };
+                            readonly dismissOnClick: {
+                                readonly type: "boolean";
+                                readonly description: "Whether clicking the snackbar should dismiss it.";
+                            };
+                            readonly colored: {
+                                readonly type: "boolean";
+                                readonly description: "Whether the snackbar uses a filled background matching its variant.";
+                            };
+                            readonly isAnimated: {
+                                readonly type: "boolean";
+                                readonly description: "Whether the snackbar should animate in and out.";
+                            };
+                            readonly stickyHeader: {
+                                readonly type: "boolean";
+                                readonly description: "Whether the table header should remain visible while scrolling.";
+                            };
+                            readonly stickyFooter: {
+                                readonly type: "boolean";
+                                readonly description: "Whether the table footer should remain visible while scrolling.";
+                            };
+                            readonly stickyPagination: {
+                                readonly type: "boolean";
+                                readonly description: "Whether the table pagination row should remain visible while scrolling.";
+                            };
+                            readonly pagination: {
+                                readonly type: "boolean";
+                                readonly description: "Whether the table should render built-in pagination controls.";
+                            };
+                            readonly pageSize: {
+                                readonly type: "number";
+                                readonly description: "Initial number of rows per page when table pagination is enabled.";
+                            };
+                            readonly pageSizes: {
+                                readonly type: "array";
+                                readonly items: {
+                                    readonly type: "number";
+                                };
+                                readonly description: "Selectable page-size options for table pagination.";
+                            };
+                            readonly virtualized: {
+                                readonly type: "boolean";
+                                readonly description: "Whether the table should use virtualization for large row sets.";
+                            };
+                            readonly rowHeight: {
+                                readonly type: "number";
+                                readonly description: "Row height in pixels for virtualized tables.";
+                            };
+                            readonly minVisibleRange: {
+                                readonly type: "number";
+                                readonly description: "Minimum buffered visible range for virtualized tables.";
+                            };
+                            readonly options: {
+                                readonly type: "array";
+                                readonly description: "Options for select, radio, checkbox groups";
+                                readonly items: {
+                                    readonly type: "object";
+                                    readonly required: readonly ["value", "label"];
+                                    readonly properties: {
+                                        readonly value: {
+                                            readonly description: "Option value";
+                                        };
+                                        readonly label: {
+                                            readonly type: "string";
+                                            readonly description: "Display label";
+                                        };
+                                        readonly disabled: {
+                                            readonly type: "boolean";
+                                            readonly default: false;
+                                        };
+                                        readonly icon: {
+                                            readonly type: "string";
+                                        };
+                                    };
+                                };
+                            };
+                            readonly columns: {
+                                readonly type: "array";
+                                readonly description: "Column definitions for table component";
+                                readonly items: {
+                                    readonly type: "object";
+                                    readonly required: readonly ["key", "label"];
+                                    readonly properties: {
+                                        readonly key: {
+                                            readonly type: "string";
+                                            readonly description: "Column key/field name.";
+                                        };
+                                        readonly label: {
+                                            readonly type: "string";
+                                            readonly description: "Column header label.";
+                                        };
+                                        readonly width: {
+                                            readonly type: "string";
+                                            readonly description: "CSS column width (e.g. \"120px\", \"20%\").";
+                                        };
+                                        readonly sortable: {
+                                            readonly type: "boolean";
+                                            readonly default: false;
+                                        };
+                                        readonly filterable: {
+                                            readonly type: "boolean";
+                                            readonly default: false;
+                                        };
+                                        readonly align: {
+                                            readonly type: "string";
+                                            readonly enum: readonly ["left", "center", "right"];
+                                            readonly default: "left";
+                                        };
+                                        readonly formatter: {
+                                            readonly type: "string";
+                                            readonly enum: readonly ["text", "number", "currency", "date", "datetime", "boolean", "custom"];
+                                        };
+                                    };
+                                };
+                            };
+                            readonly rows: {
+                                readonly type: "array";
+                                readonly description: "Data rows for table or list component";
+                            };
+                            readonly data: {
+                                readonly type: "array";
+                                readonly description: "Alias for rows — accepted when LLM generates data instead of rows";
+                            };
+                            readonly errors: {
+                                readonly type: "array";
+                                readonly items: {
+                                    readonly type: "string";
+                                };
+                                readonly description: "Inline validation or upload error messages, used by drag-and-drop.";
+                            };
+                            readonly files: {
+                                readonly type: "array";
+                                readonly description: "Current file metadata for drag-and-drop controlled state.";
+                                readonly items: {
+                                    readonly type: "object";
+                                    readonly required: readonly ["name"];
+                                    readonly properties: {
+                                        readonly name: {
+                                            readonly type: "string";
+                                        };
+                                        readonly size: {
+                                            readonly type: "number";
+                                        };
+                                        readonly type: {
+                                            readonly type: "string";
+                                        };
+                                    };
+                                };
+                            };
+                            readonly children: {
+                                readonly type: "array";
+                                readonly description: "Nested child components (not recursively validated to avoid cascading errors)";
+                                readonly items: {
+                                    readonly type: "object";
+                                };
+                            };
+                            readonly dragOverContent: {
+                                readonly type: "array";
+                                readonly description: "Custom nested components shown while drag-and-drop is in its active hover state.";
+                                readonly items: {
+                                    readonly type: "object";
+                                };
+                            };
+                            readonly loadingOverlay: {
+                                readonly type: "array";
+                                readonly description: "Custom nested components shown while drag-and-drop isLoading is true.";
+                                readonly items: {
+                                    readonly type: "object";
+                                };
+                            };
+                            readonly dragOverChildren: {
+                                readonly type: "array";
+                                readonly description: "A2UI child components shown while drag-and-drop is in its hover state.";
+                                readonly items: {
+                                    readonly type: "object";
+                                };
+                            };
+                            readonly footer: {
+                                readonly type: "array";
+                                readonly description: "Footer components rendered in the modal footer bar (e.g. action buttons). Only used by type \"modal\".";
+                                readonly items: {
+                                    readonly type: "object";
+                                };
+                            };
+                            readonly actionChildren: {
+                                readonly type: "array";
+                                readonly description: "Nested child components rendered in a dedicated action area such as chat-bubble actions or header utilities.";
+                                readonly items: {
+                                    readonly type: "object";
+                                };
+                            };
+                            readonly logoChildren: {
+                                readonly type: "array";
+                                readonly description: "Header logo slot content. Only used by type \"header\".";
+                                readonly items: {
+                                    readonly type: "object";
+                                };
+                            };
+                            readonly menuChildren: {
+                                readonly type: "array";
+                                readonly description: "Header primary navigation slot content. Only used by type \"header\".";
+                                readonly items: {
+                                    readonly type: "object";
+                                };
+                            };
+                            readonly bannerChildren: {
+                                readonly type: "array";
+                                readonly description: "Header top banner content. Only used by type \"header\".";
+                                readonly items: {
+                                    readonly type: "object";
+                                };
+                            };
+                            readonly advChildren: {
+                                readonly type: "array";
+                                readonly description: "Header promo/supporting content shown below the mobile menu. Only used by type \"header\".";
+                                readonly items: {
+                                    readonly type: "object";
+                                };
+                            };
+                            readonly headerChildren: {
+                                readonly type: "array";
+                                readonly description: "Sidebar header slot content. Only used by type \"sidebar\".";
+                                readonly items: {
+                                    readonly type: "object";
+                                };
+                            };
+                            readonly footerChildren: {
+                                readonly type: "array";
+                                readonly description: "Sidebar footer slot content. Only used by type \"sidebar\".";
+                                readonly items: {
+                                    readonly type: "object";
+                                };
+                            };
+                            readonly headerContent: {
+                                readonly type: "array";
+                                readonly description: "Named slot content for the main chat header. Only used by type \"chat-container\".";
+                                readonly items: {
+                                    readonly type: "object";
+                                };
+                            };
+                            readonly sidebarContent: {
+                                readonly type: "array";
+                                readonly description: "Named slot content for the expanded chat sidebar. Only used by type \"chat-container\".";
+                                readonly items: {
+                                    readonly type: "object";
+                                };
+                            };
+                            readonly sidebarMinifiedContent: {
+                                readonly type: "array";
+                                readonly description: "Named slot content for the collapsed chat sidebar rail. Only used by type \"chat-container\".";
+                                readonly items: {
+                                    readonly type: "object";
+                                };
+                            };
+                            readonly sidebarHeaderContent: {
+                                readonly type: "array";
+                                readonly description: "Named slot content above the expanded chat sidebar. Only used by type \"chat-container\".";
+                                readonly items: {
+                                    readonly type: "object";
+                                };
+                            };
+                            readonly items: {
+                                readonly type: "array";
+                                readonly description: "Component-specific items collection. Used by sidebar for nested navigation items and by search-modal grouped sections.";
+                                readonly items: {
+                                    readonly type: "object";
+                                };
+                            };
+                            readonly images: {
+                                readonly type: "array";
+                                readonly description: "ImagePreview image items with src, optional alt text, and optional caption.";
+                                readonly items: {
+                                    readonly type: "object";
+                                    readonly required: readonly ["src"];
+                                    readonly properties: {
+                                        readonly src: {
+                                            readonly type: "string";
+                                        };
+                                        readonly alt: {
+                                            readonly type: "string";
+                                        };
+                                        readonly caption: {
+                                            readonly type: "string";
+                                        };
+                                    };
+                                };
+                            };
+                            readonly results: {
+                                readonly type: "array";
+                                readonly description: "SearchModal result items or grouped sections displayed for an active query.";
+                                readonly items: {
+                                    readonly type: "object";
+                                };
+                            };
+                            readonly historyResults: {
+                                readonly type: "array";
+                                readonly description: "SearchModal recent or grouped history items displayed before a query is typed.";
+                                readonly items: {
+                                    readonly type: "object";
+                                };
+                            };
+                            readonly popularItems: {
+                                readonly type: "object";
+                                readonly description: "Optional SearchModal section object with title and items[].";
+                            };
+                            readonly aiSuggestions: {
+                                readonly type: "object";
+                                readonly description: "Optional SearchModal AI suggestions section object with title and items[].";
+                            };
+                            readonly articles: {
+                                readonly type: "object";
+                                readonly description: "Optional SearchModal articles section object with title and items[].";
+                            };
+                            readonly src: {
+                                readonly type: "string";
+                                readonly description: "Image URL for image/avatar/carousel media.";
+                            };
+                            readonly alt: {
+                                readonly type: "string";
+                                readonly description: "Alternative text for image/avatar/carousel media.";
+                            };
+                            readonly sizeVariant: {
+                                readonly type: "string";
+                                readonly enum: readonly ["xs", "sm", "md", "lg", "xl"];
+                                readonly description: "Avatar size variant — alias for \"size\" on avatar components.";
+                            };
+                            readonly orientation: {
+                                readonly type: "string";
+                                readonly enum: readonly ["horizontal", "vertical"];
+                                readonly description: "Separator direction. Only used by type \"separator\".";
+                            };
+                            readonly labelPosition: {
+                                readonly type: "string";
+                                readonly enum: readonly ["start", "center", "end"];
+                                readonly description: "Separator label position. Only used by type \"separator\".";
+                            };
+                            readonly backgroundColor: {
+                                readonly type: "string";
+                                readonly description: "Avatar background color for initials fallback, or skeleton fill color. Prefer theme color token paths (e.g. \"bg.fill.secondary\", \"bg.fill.success.primary.default\") or palette-style aliases like \"brand.500\" and \"theme.palette.success.main\". Use raw CSS/hex only when no theme token fits.";
+                            };
+                            readonly withBadge: {
+                                readonly type: "boolean";
+                                readonly description: "Avatar: show status dot badge.";
+                            };
+                            readonly badgeColor: {
+                                readonly type: "string";
+                                readonly description: "Avatar badge dot color. Prefer theme color token paths (e.g. \"bg.fill.success.primary.default\"). Use raw CSS/hex only when no theme token fits. Only when withBadge is true.";
+                            };
+                            readonly labelColor: {
+                                readonly type: "string";
+                                readonly description: "Separator label text color. Prefer theme color token paths (e.g. \"text.caption\", \"text.warning\"). Palette-style aliases like \"brand.500\" and \"theme.palette.warning.main\" are also accepted. Use raw CSS/hex only when no theme token fits. Only used by type \"separator\".";
+                            };
+                            readonly showCloseButton: {
+                                readonly type: "boolean";
+                                readonly description: "Whether to show the × close button in the modal header. Only used by type \"modal\". Defaults to true.";
+                            };
+                            readonly closeOnEscape: {
+                                readonly type: "boolean";
+                                readonly description: "Whether pressing Escape closes the modal. Only used by type \"modal\".";
+                            };
+                            readonly closeOnClickOutside: {
+                                readonly type: "boolean";
+                                readonly description: "Whether clicking the backdrop closes the modal. Only used by type \"modal\".";
+                            };
+                            readonly isCustomView: {
+                                readonly type: "boolean";
+                                readonly description: "Whether the modal uses a fully custom layout without the default header/footer chrome. Only used by type \"modal\".";
+                            };
+                            readonly title: {
+                                readonly type: "string";
+                                readonly description: "Component-specific title text. Used by chart for accessible titles and by modal as an alternate heading field.";
+                            };
+                            readonly description: {
+                                readonly type: "string";
+                                readonly description: "Component-specific descriptive text, for example chart descriptions or drag-and-drop helper text.";
+                            };
+                            readonly status: {
+                                readonly type: "string";
+                                readonly enum: readonly ["pending", "fulfilled", "rejected"];
+                                readonly description: "Chat bubble generation status. Only used by type \"chat-bubble\".";
+                            };
+                            readonly bgColor: {
+                                readonly type: "string";
+                                readonly description: "Header background color override. Prefer theme color token paths (for example \"bg.surface\") before raw CSS/hex colors.";
+                            };
+                            readonly mobileMenuList: {
+                                readonly type: "array";
+                                readonly description: "Header mobile drawer menu items. Only used by type \"header\".";
+                                readonly items: {
+                                    readonly type: "object";
+                                    readonly required: readonly ["title"];
+                                    readonly properties: {
+                                        readonly id: {
+                                            readonly type: "string";
+                                        };
+                                        readonly title: {
+                                            readonly type: "string";
+                                        };
+                                        readonly path: {
+                                            readonly type: "string";
+                                        };
+                                        readonly icon: {
+                                            readonly type: "string";
+                                        };
+                                    };
+                                };
+                            };
+                            readonly emptyItemsResult: {
+                                readonly type: "string";
+                                readonly description: "Search empty-state message shown when no options match the current value.";
+                            };
+                            readonly carouselOptions: {
+                                readonly type: "object";
+                                readonly description: "Embla carousel options such as loop or align. Only used by type \"carousel\".";
+                            };
+                            readonly chartHeight: {
+                                readonly type: "number";
+                                readonly description: "Height of the chart canvas in pixels. Only used by type \"chart\".";
+                            };
+                            readonly xKey: {
+                                readonly type: "string";
+                                readonly description: "Data key used for the chart x-axis. Only used by type \"chart\".";
+                            };
+                            readonly series: {
+                                readonly type: "array";
+                                readonly description: "Chart series definitions for line, bar, and area charts.";
+                                readonly items: {
+                                    readonly type: "object";
+                                };
+                            };
+                            readonly pieConfig: {
+                                readonly type: "object";
+                                readonly description: "Pie or donut chart configuration.";
+                            };
+                            readonly colors: {
+                                readonly type: "array";
+                                readonly description: "Custom color palette for charts.";
+                                readonly items: {
+                                    readonly type: "string";
+                                };
+                            };
+                            readonly legend: {
+                                readonly type: "object";
+                                readonly description: "Chart legend configuration.";
+                            };
+                            readonly xAxis: {
+                                readonly type: "object";
+                                readonly description: "Chart x-axis configuration.";
+                            };
+                            readonly yAxis: {
+                                readonly type: "object";
+                                readonly description: "Chart y-axis configuration.";
+                            };
+                            readonly grid: {
+                                readonly type: "object";
+                                readonly description: "Chart grid configuration.";
+                            };
+                            readonly tooltip: {
+                                readonly type: "object";
+                                readonly description: "Chart tooltip configuration using JSON-safe fields only.";
+                            };
+                            readonly chartMargin: {
+                                readonly type: "object";
+                                readonly description: "Chart inner margin configuration.";
+                            };
+                            readonly animate: {
+                                readonly type: "boolean";
+                                readonly description: "Whether chart transitions are animated.";
+                            };
+                            readonly loading: {
+                                readonly type: "boolean";
+                                readonly description: "Whether the chart is in a loading state.";
+                            };
+                            readonly error: {
+                                readonly type: "boolean";
+                                readonly description: "Whether the chart is in an error state.";
+                            };
+                            readonly loadingText: {
+                                readonly type: "string";
+                                readonly description: "Default loading-state text for charts.";
+                            };
+                            readonly emptyText: {
+                                readonly type: "string";
+                                readonly description: "Default empty-state text for charts.";
+                            };
+                            readonly errorText: {
+                                readonly type: "string";
+                                readonly description: "Default error-state text for charts.";
+                            };
+                            readonly searchValue: {
+                                readonly type: "string";
+                                readonly description: "Current search query. Used by type \"search-modal\".";
+                            };
+                            readonly noHistoryResultsLabel: {
+                                readonly type: "string";
+                                readonly description: "SearchModal empty-state label shown before a query is typed.";
+                            };
+                            readonly noResultsLabel: {
+                                readonly type: "string";
+                                readonly description: "SearchModal empty-state label shown when a query returns no results.";
+                            };
+                            readonly newSearchCta: {
+                                readonly type: "string";
+                                readonly description: "SearchModal CTA label for starting a new search or chat.";
+                            };
+                            readonly loaderItemsCount: {
+                                readonly type: "number";
+                                readonly description: "Number of skeleton rows shown by SearchModal while loading.";
+                            };
+                            readonly showSearch: {
+                                readonly type: "boolean";
+                                readonly description: "Whether header renders its built-in search affordance.";
+                            };
+                            readonly showTopBanner: {
+                                readonly type: "boolean";
+                                readonly description: "Whether header renders its top banner area.";
+                            };
+                            readonly showCharacterCount: {
+                                readonly type: "boolean";
+                                readonly description: "Whether InputArea shows a live character counter.";
+                            };
+                            readonly showAttachmentButton: {
+                                readonly type: "boolean";
+                                readonly description: "Whether InputArea shows its attachment button.";
+                            };
+                            readonly showSendButton: {
+                                readonly type: "boolean";
+                                readonly description: "Whether InputArea shows its send button.";
+                            };
+                            readonly showSendButtonTooltip: {
+                                readonly type: "boolean";
+                                readonly description: "Whether to show a tooltip on hover of the InputArea send button.";
+                            };
+                            readonly sendButtonLabel: {
+                                readonly type: "string";
+                                readonly description: "Accessible label for the InputArea send button.";
+                            };
+                            readonly attachmentButtonLabel: {
+                                readonly type: "string";
+                                readonly description: "Tooltip and accessible label for the InputArea attachment button.";
+                            };
+                            readonly recordingState: {
+                                readonly type: "string";
+                                readonly enum: readonly ["idle", "recording", "processing"];
+                                readonly description: "Voice recording state for InputArea. \"idle\" shows normal input, \"recording\" shows cancel/confirm controls, \"processing\" disables confirm and shows a spinner.";
+                            };
+                            readonly recordButtonLabel: {
+                                readonly type: "string";
+                                readonly description: "Accessible label for the InputArea record button.";
+                            };
+                            readonly minRows: {
+                                readonly type: "number";
+                                readonly description: "Minimum visible textarea rows for InputArea.";
+                            };
+                            readonly maxRows: {
+                                readonly type: "number";
+                                readonly description: "Maximum visible textarea rows for InputArea before scrolling.";
+                            };
+                            readonly initialIndex: {
+                                readonly type: "number";
+                                readonly description: "Initial image index for ImagePreview.";
+                            };
+                            readonly showThumbnails: {
+                                readonly type: "boolean";
+                                readonly description: "Whether ImagePreview shows its thumbnail strip.";
+                            };
+                            readonly showCounter: {
+                                readonly type: "boolean";
+                                readonly description: "Whether ImagePreview shows the current/total counter.";
+                            };
+                            readonly thumbnailPosition: {
+                                readonly type: "string";
+                                readonly enum: readonly ["bottom", "left"];
+                                readonly description: "Thumbnail strip position for ImagePreview.";
+                            };
+                            readonly activeItemId: {
+                                readonly type: "string";
+                                readonly description: "Currently active sidebar item id.";
+                            };
+                            readonly collapsed: {
+                                readonly type: "boolean";
+                                readonly description: "Whether sidebar renders in collapsed mode.";
+                            };
+                            readonly collapsedWidth: {
+                                readonly type: "string";
+                                readonly description: "Collapsed sidebar width.";
+                            };
+                            readonly fileName: {
+                                readonly type: "string";
+                                readonly description: "Name of the attached file displayed in the AttachmentFile chip. Truncates with a tooltip on hover when long.";
+                            };
+                            readonly fileType: {
+                                readonly type: "string";
+                                readonly description: "File type label shown below the file name in AttachmentFile (e.g. \"PDF\", \"doc\"). Truncates with ellipsis when long.";
+                            };
+                            readonly fileSize: {
+                                readonly type: "string";
+                                readonly description: "File size label shown below the file name in AttachmentFile (e.g. \"1.2 MB\").";
+                            };
+                            readonly removeButtonLabel: {
+                                readonly type: "string";
+                                readonly description: "Accessible aria-label for the AttachmentFile remove button.";
+                                readonly default: "Remove file";
+                            };
+                            readonly isLoading: {
+                                readonly type: "boolean";
+                                readonly description: "Shows a spinner in place of the remove button while uploading. Only takes effect when actions[] is also provided.";
+                                readonly default: false;
+                            };
+                            readonly actions: {
+                                readonly type: "array";
+                                readonly items: {
+                                    readonly type: "string";
+                                };
+                                readonly description: "Action IDs from ui.actions to trigger when the remove button is clicked. The remove button is only rendered when this array is non-empty. Maps to onRemove in TSX.";
+                            };
+                            readonly validation: {
+                                readonly type: "array";
+                                readonly items: {
+                                    readonly type: "string";
+                                };
+                                readonly description: "Optional validation rule IDs associated with this component.";
+                            };
+                            readonly attributes: {
+                                readonly type: "object";
+                                readonly description: "Additional HTML/component attributes";
+                            };
+                            readonly styling: {
+                                readonly type: "object";
+                                readonly description: "CSS styling for the component. All values MUST be real CSS values (e.g. '16px', '1rem', '50%'). NEVER use design token strings like 'xs', 'sm', 'md', 'lg', 'xl', 'none'.";
+                                readonly properties: {
+                                    readonly margin: {
+                                        readonly type: readonly ["string", "number"];
+                                        readonly description: "CSS margin value (e.g. '8px 0', '1rem', '0 auto')";
+                                    };
+                                    readonly padding: {
+                                        readonly type: readonly ["string", "number"];
+                                        readonly description: "CSS padding value (e.g. '16px', '8px 16px', '1rem')";
+                                    };
+                                    readonly width: {
+                                        readonly type: readonly ["string", "number"];
+                                        readonly description: "CSS width value (e.g. '100%', '320px', 'auto')";
+                                    };
+                                    readonly height: {
+                                        readonly type: readonly ["string", "number"];
+                                        readonly description: "CSS height value (e.g. '48px', '100vh', 'auto')";
+                                    };
+                                    readonly maxWidth: {
+                                        readonly type: readonly ["string", "number"];
+                                        readonly description: "CSS max-width value";
+                                    };
+                                    readonly minWidth: {
+                                        readonly type: readonly ["string", "number"];
+                                        readonly description: "CSS min-width value";
+                                    };
+                                    readonly maxHeight: {
+                                        readonly type: readonly ["string", "number"];
+                                        readonly description: "CSS max-height value (e.g. '300px', '80vh')";
+                                    };
+                                    readonly minHeight: {
+                                        readonly type: readonly ["string", "number"];
+                                        readonly description: "CSS min-height value (e.g. '120px', '2rem')";
+                                    };
+                                    readonly color: {
+                                        readonly type: "string";
+                                        readonly description: "CSS color value";
+                                    };
+                                    readonly backgroundColor: {
+                                        readonly type: "string";
+                                        readonly description: "CSS background-color value";
+                                    };
+                                    readonly fontSize: {
+                                        readonly type: readonly ["string", "number"];
+                                        readonly description: "CSS font-size value (e.g. '14px', '1rem')";
+                                    };
+                                    readonly fontWeight: {
+                                        readonly type: readonly ["string", "number"];
+                                        readonly description: "CSS font-weight value";
+                                    };
+                                    readonly textAlign: {
+                                        readonly type: "string";
+                                        readonly description: "CSS text-align value (e.g. 'left', 'center', 'right', 'justify')";
+                                    };
+                                    readonly display: {
+                                        readonly type: "string";
+                                        readonly description: "CSS display value";
+                                    };
+                                    readonly flexDirection: {
+                                        readonly type: "string";
+                                        readonly description: "CSS flex-direction value (e.g. 'row', 'column', 'row-reverse', 'column-reverse')";
+                                    };
+                                    readonly alignItems: {
+                                        readonly type: "string";
+                                        readonly description: "CSS align-items value (e.g. 'flex-start', 'flex-end', 'center', 'baseline', 'stretch')";
+                                    };
+                                    readonly justifyContent: {
+                                        readonly type: "string";
+                                        readonly description: "CSS justify-content value (e.g. 'flex-start', 'flex-end', 'center', 'space-between', 'space-around', 'space-evenly')";
+                                    };
+                                    readonly gap: {
+                                        readonly type: readonly ["string", "number"];
+                                        readonly description: "CSS gap value (e.g. '8px', '1rem')";
+                                    };
+                                    readonly borderRadius: {
+                                        readonly type: readonly ["string", "number"];
+                                        readonly description: "CSS border-radius value";
+                                    };
+                                    readonly border: {
+                                        readonly type: "string";
+                                        readonly description: "CSS border shorthand";
+                                    };
+                                    readonly boxShadow: {
+                                        readonly type: "string";
+                                        readonly description: "CSS box-shadow value (e.g. '0 1px 3px rgba(0,0,0,0.1)')";
+                                    };
+                                    readonly cursor: {
+                                        readonly type: "string";
+                                        readonly description: "CSS cursor value (e.g. 'pointer', 'default')";
+                                    };
+                                    readonly flex: {
+                                        readonly type: readonly ["string", "number"];
+                                        readonly description: "CSS flex shorthand for the component itself inside a flex container (e.g. '1', '0 0 auto', '1 1 50%')";
+                                    };
+                                    readonly flexWrap: {
+                                        readonly type: "string";
+                                        readonly description: "CSS flex-wrap value (e.g. 'wrap', 'nowrap')";
+                                    };
+                                    readonly flexGrow: {
+                                        readonly type: readonly ["string", "number"];
+                                        readonly description: "CSS flex-grow value";
+                                    };
+                                    readonly flexShrink: {
+                                        readonly type: readonly ["string", "number"];
+                                        readonly description: "CSS flex-shrink value";
+                                    };
+                                    readonly flexBasis: {
+                                        readonly type: readonly ["string", "number"];
+                                        readonly description: "CSS flex-basis value";
+                                    };
+                                    readonly marginTop: {
+                                        readonly type: readonly ["string", "number"];
+                                        readonly description: "CSS margin-top value";
+                                    };
+                                    readonly marginBottom: {
+                                        readonly type: readonly ["string", "number"];
+                                        readonly description: "CSS margin-bottom value";
+                                    };
+                                    readonly marginLeft: {
+                                        readonly type: readonly ["string", "number"];
+                                        readonly description: "CSS margin-left value";
+                                    };
+                                    readonly marginRight: {
+                                        readonly type: readonly ["string", "number"];
+                                        readonly description: "CSS margin-right value";
+                                    };
+                                    readonly paddingTop: {
+                                        readonly type: readonly ["string", "number"];
+                                        readonly description: "CSS padding-top value";
+                                    };
+                                    readonly paddingBottom: {
+                                        readonly type: readonly ["string", "number"];
+                                        readonly description: "CSS padding-bottom value";
+                                    };
+                                    readonly paddingLeft: {
+                                        readonly type: readonly ["string", "number"];
+                                        readonly description: "CSS padding-left value";
+                                    };
+                                    readonly paddingRight: {
+                                        readonly type: readonly ["string", "number"];
+                                        readonly description: "CSS padding-right value";
+                                    };
+                                    readonly letterSpacing: {
+                                        readonly type: readonly ["string", "number"];
+                                        readonly description: "CSS letter-spacing value";
+                                    };
+                                    readonly lineHeight: {
+                                        readonly type: readonly ["string", "number"];
+                                        readonly description: "CSS line-height value";
+                                    };
+                                    readonly overflow: {
+                                        readonly type: "string";
+                                        readonly description: "CSS overflow value (e.g. 'hidden', 'auto', 'scroll', 'visible')";
+                                    };
+                                    readonly objectFit: {
+                                        readonly type: "string";
+                                        readonly description: "CSS object-fit value (e.g. 'cover', 'contain', 'fill', 'none', 'scale-down')";
+                                    };
+                                    readonly opacity: {
+                                        readonly type: readonly ["string", "number"];
+                                        readonly description: "CSS opacity value (0–1, e.g. 0.5 or \"0.5\")";
+                                    };
+                                    readonly position: {
+                                        readonly type: "string";
+                                        readonly description: "CSS position value (e.g. 'static', 'relative', 'absolute', 'fixed', 'sticky')";
+                                    };
+                                    readonly zIndex: {
+                                        readonly type: readonly ["string", "number"];
+                                        readonly description: "CSS z-index value";
+                                    };
+                                    readonly top: {
+                                        readonly type: readonly ["string", "number"];
+                                        readonly description: "CSS top offset";
+                                    };
+                                    readonly right: {
+                                        readonly type: readonly ["string", "number"];
+                                        readonly description: "CSS right offset";
+                                    };
+                                    readonly bottom: {
+                                        readonly type: readonly ["string", "number"];
+                                        readonly description: "CSS bottom offset";
+                                    };
+                                    readonly left: {
+                                        readonly type: readonly ["string", "number"];
+                                        readonly description: "CSS left offset";
+                                    };
+                                };
+                            };
+                        };
+                    };
+                };
+                readonly actions: {
+                    readonly type: "array";
+                    readonly description: "Available actions referenced by component actions[] arrays.";
+                    readonly items: {
+                        readonly type: "object";
+                        readonly required: readonly ["id", "type"];
+                        readonly properties: {
+                            readonly id: {
+                                readonly type: "string";
+                                readonly description: "Unique action ID.";
+                            };
+                            readonly type: {
+                                readonly type: "string";
+                                readonly description: "Custom action type string matching an A2UIActionDefinition type (e.g. \"add-to-cart\", \"action-view-all\").";
+                            };
+                            readonly label: {
+                                readonly type: "string";
+                                readonly description: "Action label for UI elements.";
+                            };
+                            readonly trigger: {
+                                readonly type: "string";
+                                readonly enum: readonly ["click", "change", "input", "blur", "focus", "submit", "load", "custom"];
+                                readonly default: "click";
+                            };
+                            readonly payload: {
+                                readonly type: "object";
+                                readonly description: "Data payload for the action.";
+                            };
+                            readonly endpoint: {
+                                readonly type: "string";
+                                readonly description: "API endpoint for api-call or agent-call types.";
+                            };
+                            readonly method: {
+                                readonly type: "string";
+                                readonly enum: readonly ["GET", "POST", "PUT", "PATCH", "DELETE"];
+                                readonly default: "POST";
+                            };
+                            readonly confirmation: {
+                                readonly type: "object";
+                                readonly properties: {
+                                    readonly required: {
+                                        readonly type: "boolean";
+                                        readonly default: false;
+                                    };
+                                    readonly message: {
+                                        readonly type: "string";
+                                    };
+                                    readonly confirmText: {
+                                        readonly type: "string";
+                                        readonly default: "Confirm";
+                                    };
+                                    readonly cancelText: {
+                                        readonly type: "string";
+                                        readonly default: "Cancel";
+                                    };
+                                };
+                            };
+                            readonly onSuccess: {
+                                readonly type: "object";
+                                readonly properties: {
+                                    readonly message: {
+                                        readonly type: "string";
+                                    };
+                                    readonly action: {
+                                        readonly type: "string";
+                                        readonly description: "ID of action to execute on success.";
+                                    };
+                                    readonly redirect: {
+                                        readonly type: "string";
+                                        readonly description: "URL to redirect to on success.";
+                                    };
+                                };
+                            };
+                            readonly onError: {
+                                readonly type: "object";
+                                readonly properties: {
+                                    readonly message: {
+                                        readonly type: "string";
+                                    };
+                                    readonly action: {
+                                        readonly type: "string";
+                                        readonly description: "ID of action to execute on error.";
+                                    };
+                                };
+                            };
+                            readonly loading: {
+                                readonly type: "boolean";
+                                readonly default: false;
+                                readonly description: "Show loading state during action execution.";
+                            };
+                            readonly debounce: {
+                                readonly type: "integer";
+                                readonly description: "Debounce delay in milliseconds.";
+                            };
+                            readonly throttle: {
+                                readonly type: "integer";
+                                readonly description: "Throttle delay in milliseconds.";
+                            };
+                        };
+                    };
+                };
+                readonly validations: {
+                    readonly type: "array";
+                    readonly description: "Form validation rules associated with components.";
+                    readonly items: {
+                        readonly type: "object";
+                        readonly required: readonly ["id", "componentId", "rules"];
+                        readonly properties: {
+                            readonly id: {
+                                readonly type: "string";
+                                readonly description: "Unique validation identifier.";
+                            };
+                            readonly componentId: {
+                                readonly type: "string";
+                                readonly description: "ID of the component to validate.";
+                            };
+                            readonly rules: {
+                                readonly type: "array";
+                                readonly items: {
+                                    readonly type: "object";
+                                    readonly required: readonly ["type"];
+                                    readonly properties: {
+                                        readonly type: {
+                                            readonly type: "string";
+                                            readonly enum: readonly ["required", "email", "url", "phone", "min-length", "max-length", "min-value", "max-value", "pattern", "custom"];
+                                        };
+                                        readonly value: {};
+                                        readonly message: {
+                                            readonly type: "string";
+                                            readonly description: "Error message to display.";
+                                        };
+                                        readonly customValidator: {
+                                            readonly type: "string";
+                                            readonly description: "Name of custom validation function.";
+                                        };
+                                    };
+                                };
+                            };
+                            readonly trigger: {
+                                readonly type: "string";
+                                readonly enum: readonly ["change", "blur", "submit"];
+                                readonly default: "blur";
+                            };
+                        };
+                    };
+                };
+            };
+        };
+        readonly state: {
+            readonly type: "object";
+            readonly description: "Current UI state for state management";
+            readonly properties: {
+                readonly formData: {
+                    readonly type: "object";
+                };
+                readonly errors: {
+                    readonly type: "object";
+                };
+                readonly loading: {
+                    readonly type: "boolean";
+                    readonly default: false;
+                };
+                readonly disabled: {
+                    readonly type: "boolean";
+                    readonly default: false;
+                };
+            };
+        };
+    };
+};
+/**
+ * Simplified schema for basic structural validation only.
+ * Use when you don't need full component type enforcement.
+ */
+export declare const A2UI_SPEC_SCHEMA_SIMPLE: {
+    readonly type: "object";
+    readonly required: readonly ["version", "metadata", "ui"];
+    readonly properties: {
+        readonly version: {
+            readonly type: "string";
+        };
+        readonly metadata: {
+            readonly type: "object";
+            readonly required: readonly ["agentId", "agentName", "timestamp"];
+        };
+        readonly ui: {
+            readonly type: "object";
+            readonly required: readonly ["components"];
+            readonly properties: {
+                readonly components: {
+                    readonly type: "array";
+                    readonly minItems: 1;
+                };
+                readonly actions: {
+                    readonly type: "array";
+                };
+            };
+        };
+    };
+};
+/**
+ * TypeScript types derived from the schema shape.
+ */
+export type A2UIVariant = (typeof A2UI_BUTTON_VARIANTS)[number] | 'success' | 'warning' | 'error' | 'info' | 'primary' | 'secondary' | 'vertical' | 'horizontal';
+export type A2UILayoutType = 'vertical' | 'horizontal' | 'grid' | 'flex' | 'stack' | 'split';
+export type A2UIAction = {
+    id: string;
+    type: string;
+    label?: string;
+    trigger?: 'click' | 'change' | 'input' | 'blur' | 'focus' | 'submit' | 'load' | 'custom';
+    payload?: Record<string, unknown>;
+    endpoint?: string;
+    method?: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
+    confirmation?: {
+        required?: boolean;
+        message?: string;
+        confirmText?: string;
+        cancelText?: string;
+    };
+    onSuccess?: {
+        message?: string;
+        action?: string;
+        redirect?: string;
+    };
+    onError?: {
+        message?: string;
+        action?: string;
+    };
+    loading?: boolean;
+    debounce?: number;
+    throttle?: number;
+};
+export type A2UIValidationRule = {
+    type: 'required' | 'email' | 'url' | 'phone' | 'min-length' | 'max-length' | 'min-value' | 'max-value' | 'pattern' | 'custom';
+    value?: unknown;
+    message?: string;
+    customValidator?: string;
+};
+export type A2UIValidation = {
+    id: string;
+    componentId: string;
+    rules: A2UIValidationRule[];
+    trigger?: 'change' | 'blur' | 'submit';
+};
+/**
+ * Defines an application action available to the LLM and the renderer.
+ *
+ * Pass an array of these to both `buildA2UISystemPrompt` and `renderA2UISpec`
+ * so the LLM knows which action types exist and the renderer can execute them.
+ */
+export type A2UIActionDefinition = {
+    /** Action type string used as `type` in A2UI JSON — must be unique across definitions */
+    type: string;
+    /** Human-readable description injected into the LLM system prompt */
+    description: string;
+    /** Runtime handler called when the action fires in the rendered UI */
+    handler?: (action: A2UIAction) => void;
+};
+export type A2UIStyling = {
+    margin?: string | number;
+    marginTop?: string | number;
+    marginBottom?: string | number;
+    marginLeft?: string | number;
+    marginRight?: string | number;
+    padding?: string | number;
+    paddingTop?: string | number;
+    paddingBottom?: string | number;
+    paddingLeft?: string | number;
+    paddingRight?: string | number;
+    width?: string | number;
+    height?: string | number;
+    maxWidth?: string | number;
+    minWidth?: string | number;
+    maxHeight?: string | number;
+    minHeight?: string | number;
+    color?: string;
+    backgroundColor?: string;
+    fontSize?: string | number;
+    fontWeight?: string | number;
+    letterSpacing?: string | number;
+    lineHeight?: string | number;
+    textAlign?: string;
+    display?: string;
+    flexDirection?: string;
+    flex?: string | number;
+    flexWrap?: string;
+    flexGrow?: string | number;
+    flexShrink?: string | number;
+    flexBasis?: string | number;
+    alignItems?: string;
+    justifyContent?: string;
+    gap?: string | number;
+    borderRadius?: string | number;
+    border?: string;
+    boxShadow?: string;
+    cursor?: string;
+    overflow?: string;
+    objectFit?: string;
+    opacity?: string | number;
+    position?: string;
+    zIndex?: string | number;
+    top?: string | number;
+    right?: string | number;
+    bottom?: string | number;
+    left?: string | number;
+    [key: string]: string | number | undefined;
+};
+export type A2UISearchModalItem = {
+    id?: string;
+    title: string;
+    description?: string;
+    icon?: string;
+    date?: number;
+    items?: A2UISearchModalItem[];
+};
+export type A2UISearchModalSection = {
+    title?: string;
+    items: A2UISearchModalItem[];
+};
+export type A2UIImagePreviewItem = {
+    src: string;
+    alt?: string;
+    caption?: string;
+};
+export type A2UISidebarItem = {
+    id: string;
+    label: string;
+    icon?: string;
+    href?: string;
+    disabled?: boolean;
+    children?: A2UISidebarItem[];
+};
+export type A2UIHeaderMenuItem = {
+    id?: string;
+    title: string;
+    path?: string;
+    icon?: string;
+};
+export type A2UIComponent = {
+    id: string;
+    type: (typeof A2UI_COMPONENT_TYPES)[number];
+    label?: string;
+    value?: unknown;
+    initial?: number;
+    caption?: string;
+    placeholder?: string;
+    helpText?: string;
+    ariaLabel?: string;
+    content?: string;
+    name?: string;
+    subtitle?: string;
+    className?: string;
+    tabIndex?: number;
+    layout?: 'horizontal' | 'vertical';
+    as?: string;
+    htmlFor?: string;
+    captionAs?: string;
+    href?: string;
+    target?: '_blank' | '_self' | '_parent' | '_top';
+    rel?: string;
+    buttonType?: 'button' | 'submit' | 'reset';
+    placement?: 'top' | 'bottom' | 'left' | 'right' | 'top-left' | 'top-center' | 'top-right' | 'bottom-left' | 'bottom-center' | 'bottom-right';
+    delay?: number;
+    length?: string;
+    required?: boolean;
+    disabled?: boolean;
+    readOnly?: boolean;
+    visible?: boolean;
+    isOpen?: boolean;
+    bordered?: boolean;
+    checked?: boolean;
+    indeterminate?: boolean;
+    allowMultipleExpand?: boolean;
+    withoutSeparator?: boolean;
+    isInline?: boolean;
+    defaultValue?: unknown;
+    variant?: string;
+    appearance?: string;
+    size?: 'xs' | 'sm' | 'md' | 'lg' | 'xl' | 'xxl';
+    styleVariant?: string | string[];
+    underline?: 'default' | 'highlight' | 'none';
+    labelSide?: 'left' | 'right';
+    separator?: string;
+    separatorIcon?: string;
+    separatorAfterLastItem?: boolean;
+    color?: string;
+    rounded?: 'none' | 'default' | 'round' | 'xs' | 'sm' | 'md' | 'lg' | 'xl';
+    animationName?: string | null;
+    animationProps?: string;
+    withWrapper?: boolean;
+    wrapperVariant?: 'inline' | 'section' | 'fullPage';
+    blocksScroll?: boolean;
+    icon?: string;
+    iconStart?: string;
+    iconEnd?: string;
+    fill?: string;
+    fillSvg?: string;
+    WrapperView?: string;
+    container?: string;
+    src?: string;
+    alt?: string;
+    sizeVariant?: 'xs' | 'sm' | 'md' | 'lg' | 'xl';
+    orientation?: 'horizontal' | 'vertical';
+    labelPosition?: 'start' | 'center' | 'end';
+    labelColor?: string;
+    backgroundColor?: string;
+    withBadge?: boolean;
+    badgeColor?: string;
+    width?: string | number;
+    height?: string | number;
+    minHeight?: string | number;
+    count?: number;
+    activeIndex?: string | number;
+    step?: number;
+    lines?: number;
+    objectFit?: string;
+    isBordered?: boolean;
+    isHighlighted?: boolean;
+    withShadowHover?: boolean;
+    fullWidth?: boolean;
+    isIcon?: boolean;
+    showArrows?: boolean;
+    showDots?: boolean;
+    thumbs?: 'start' | 'end';
+    isFocusable?: boolean;
+    visibleItems?: number;
+    scrollStep?: number;
+    scrollAlignment?: 'left' | 'centered';
+    vertical?: 'hidden' | 'visible' | 'auto';
+    horizontal?: 'hidden' | 'visible' | 'auto';
+    autoHide?: boolean;
+    showSidebarAsideControl?: boolean;
+    showSidebarHeaderControl?: boolean;
+    multiple?: boolean;
+    searchable?: boolean;
+    searchPlaceholder?: string;
+    autoOpen?: boolean;
+    accept?: string;
+    capture?: boolean | 'user' | 'environment';
+    inputFileButtonLabel?: string;
+    acceptedFileTypes?: string[];
+    maxFileSize?: number;
+    maxFiles?: number;
+    debounceCallbackTime?: number;
+    ariaDescribedBy?: string;
+    resize?: 'none' | 'both' | 'horizontal' | 'vertical';
+    dynamicHeightAdjustment?: boolean;
+    maxCharacters?: number;
+    maxLength?: number;
+    currentValue?: string;
+    oldValue?: string;
+    currencySymbol?: string;
+    currencySymbolPosition?: 'before' | 'after';
+    gutter?: string | number;
+    padding?: string;
+    showPercentage?: boolean;
+    fillColor?: string;
+    closeOnSelect?: boolean;
+    offsetX?: number;
+    offsetY?: number;
+    carouselOptions?: Record<string, unknown>;
+    options?: Array<{
+        value: unknown;
+        label: string;
+        disabled?: boolean;
+        icon?: string;
+        href?: string;
+        noticeCounter?: number | string;
+        hex?: string;
+        image?: string;
+        tooltip?: string;
+        validationStatus?: 'success' | 'error';
+    }>;
+    columns?: Array<{
+        key: string;
+        label: string;
+        sortable?: boolean;
+        width?: string;
+        filterable?: boolean;
+        align?: 'left' | 'center' | 'right';
+        formatter?: 'text' | 'number' | 'currency' | 'date' | 'datetime' | 'boolean' | 'custom';
+    }>;
+    rows?: Record<string, unknown>[];
+    errors?: string[];
+    files?: Array<{
+        name: string;
+        size?: number;
+        type?: string;
+    }>;
+    data?: Record<string, unknown>[];
+    children?: A2UIComponent[];
+    dragOverContent?: A2UIComponent[];
+    dragOverChildren?: A2UIComponent[];
+    loadingOverlay?: A2UIComponent[];
+    footer?: A2UIComponent[];
+    actionChildren?: A2UIComponent[];
+    logoChildren?: A2UIComponent[];
+    menuChildren?: A2UIComponent[];
+    bannerChildren?: A2UIComponent[];
+    advChildren?: A2UIComponent[];
+    headerChildren?: A2UIComponent[];
+    footerChildren?: A2UIComponent[];
+    headerContent?: A2UIComponent[];
+    sidebarContent?: A2UIComponent[];
+    sidebarMinifiedContent?: A2UIComponent[];
+    sidebarHeaderContent?: A2UIComponent[];
+    showCloseButton?: boolean;
+    closeOnEscape?: boolean;
+    closeOnClickOutside?: boolean;
+    isCustomView?: boolean;
+    actions?: string[];
+    validation?: string[];
+    attributes?: Record<string, unknown>;
+    styling?: A2UIStyling;
+    align?: string;
+    justify?: string;
+    isWrap?: boolean;
+    isReversed?: boolean;
+    gap?: string | number;
+    flex?: string;
+    flexDirection?: string;
+    alignItems?: string;
+    justifyContent?: string;
+    maxHeight?: string | number;
+    gridColumns?: number | string;
+    gridRows?: number | string;
+    gridColumnGutter?: number | string;
+    gridRowGutter?: number | string;
+    wrapItems?: boolean;
+    itemWidth?: string;
+    itemHeight?: string;
+    isIconsView?: boolean;
+    duration?: number | null;
+    dismissOnClick?: boolean;
+    colored?: boolean;
+    isAnimated?: boolean;
+    stickyHeader?: boolean;
+    stickyFooter?: boolean;
+    stickyPagination?: boolean;
+    pagination?: boolean;
+    pageSize?: number;
+    pageSizes?: number[];
+    virtualized?: boolean;
+    rowHeight?: number;
+    minVisibleRange?: number;
+    expandableRows?: boolean;
+    title?: string;
+    description?: string;
+    status?: 'pending' | 'fulfilled' | 'rejected';
+    bgColor?: string;
+    mobileMenuList?: A2UIHeaderMenuItem[];
+    emptyItemsResult?: string;
+    max?: number;
+    min?: number;
+    isLoading?: boolean;
+    loading?: boolean;
+    error?: boolean;
+    loadingText?: string;
+    emptyText?: string;
+    errorText?: string;
+    chartHeight?: number;
+    xKey?: string;
+    series?: Record<string, unknown>[];
+    pieConfig?: Record<string, unknown>;
+    colors?: string[];
+    legend?: Record<string, unknown>;
+    xAxis?: Record<string, unknown>;
+    yAxis?: Record<string, unknown>;
+    grid?: Record<string, unknown>;
+    tooltip?: Record<string, unknown>;
+    chartMargin?: {
+        top?: number;
+        right?: number;
+        bottom?: number;
+        left?: number;
+    };
+    animate?: boolean;
+    searchValue?: string;
+    noHistoryResultsLabel?: string;
+    noResultsLabel?: string;
+    newSearchCta?: string;
+    loaderItemsCount?: number;
+    results?: A2UISearchModalItem[];
+    historyResults?: A2UISearchModalItem[];
+    popularItems?: A2UISearchModalSection;
+    aiSuggestions?: A2UISearchModalSection;
+    articles?: A2UISearchModalSection;
+    showSearch?: boolean;
+    showTopBanner?: boolean;
+    showCharacterCount?: boolean;
+    showAttachmentButton?: boolean;
+    showSendButton?: boolean;
+    showSendButtonTooltip?: boolean;
+    sendButtonLabel?: string;
+    attachmentButtonLabel?: string;
+    recordingState?: 'idle' | 'recording' | 'processing';
+    recordButtonLabel?: string;
+    minRows?: number;
+    maxRows?: number;
+    images?: A2UIImagePreviewItem[];
+    initialIndex?: number;
+    showThumbnails?: boolean;
+    showCounter?: boolean;
+    thumbnailPosition?: 'bottom' | 'left';
+    items?: A2UISidebarItem[];
+    activeItemId?: string;
+    collapsed?: boolean;
+    collapsedWidth?: string;
+    cursor?: string;
+    role?: string;
+};
+export type A2UIMetadata = {
+    agentId: string;
+    agentName: string;
+    agentVersion?: string;
+    timestamp: string;
+    sessionId?: string;
+    provider?: string;
+    scenario?: string;
+    segment?: string;
+    isSimulated?: boolean;
+    locale?: string;
+    theme?: 'light' | 'dark' | 'auto';
+    customData?: Record<string, unknown>;
+    [key: string]: unknown;
+};
+export type A2UISpec = {
+    version: string;
+    metadata: A2UIMetadata;
+    ui: {
+        layout?: {
+            type?: A2UILayoutType;
+            spacing?: string;
+            gridColumns?: number;
+            alignment?: string;
+            justification?: string;
+            responsive?: {
+                mobile?: {
+                    type?: string;
+                    gridColumns?: number;
+                    spacing?: string;
+                };
+                tablet?: {
+                    type?: string;
+                    gridColumns?: number;
+                    spacing?: string;
+                };
+                desktop?: {
+                    type?: string;
+                    gridColumns?: number;
+                    spacing?: string;
+                };
+            };
+        };
+        components: A2UIComponent[];
+        actions?: A2UIAction[];
+        validations?: A2UIValidation[];
+    };
+    state?: {
+        formData?: Record<string, unknown>;
+        errors?: Record<string, unknown>;
+        loading?: boolean;
+        disabled?: boolean;
+    };
+};
+/**
+ * Metadata describing a custom component for use in the LLM system prompt.
+ *
+ * Pass an array of these as `customComponents` to `buildA2UISystemPrompt`.
+ * To wire runtime rendering, extend this with `A2UICustomComponentDefinition`.
+ */
+export type A2UICustomComponentMeta = {
+    /** Component type string used as `type` in A2UI JSON — must not clash with built-in types */
+    type: string;
+    /** Human-readable description injected into the LLM system prompt */
+    description: string;
+    /** Prop names mapped to type/description strings, formatted the same way as built-in props */
+    props?: Record<string, string>;
+    /** Additional usage notes appended below the component description in the prompt */
+    notes?: string[];
+    /** Category group shown in the component list (default: "Custom") */
+    category?: string;
+};
+/**
+ * Returns a copy of `A2UI_SPEC_SCHEMA` with `customTypes` appended to the allowed
+ * component `type` enum. The original schema is never mutated.
+ *
+ * Use this with AJV or Gemini `responseSchema` when your spec includes custom component types.
+ *
+ * Built-in types always take precedence — pass only the extra types you added.
+ */
+export declare function extendA2UISpecSchema(customTypes: string[]): object;