The Open Standard for Generative UI
{
"root": "Card",
"components": {
"Card": {
"signature": "Card(children: (TextContent | MarkDownRenderer | CardHeader | Callout | TextCallout | CodeBlock | Image | ImageBlock | ImageGallery | Separator | HorizontalBarChart | RadarChart | PieChart | RadialChart | SingleStackedBarChart | ScatterChart | AreaChart | BarChart | LineChart | Table | TagBlock | Form | Buttons | IconButton | Steps | InlineHeader | EntityList | EditableTable | SnippetCardBlock | OverviewCardBlock | ContextCardBlock | CompositeCardBlock | VisualCardBlock | ListBlock | FollowUpBlock | SectionBlock | Tabs | Carousel)[], sources?: {url?: string, title: string, sourceName: string}[])",
"description": "Vertical container for all content in a chat response. Children stack top to bottom automatically. Optional sources ([{ title, sourceName, url }]) render as a Sources strip at the bottom and back inline [n] citations in TextContent."
},
"CardHeader": {
"signature": "CardHeader(title?: string, subtitle?: string)",
"description": "Header with optional title and subtitle"
},
"TextContent": {
"signature": "TextContent(text: string, size?: \"small\" | \"default\" | \"large\" | \"small-heavy\" | \"large-heavy\")",
"description": "Text block. Supports markdown. Optional size: \"small\" | \"default\" | \"large\" | \"small-heavy\" | \"large-heavy\"."
},
"MarkDownRenderer": {
"signature": "MarkDownRenderer(textMarkdown: string, variant?: \"clear\" | \"card\" | \"sunk\")",
"description": "Renders markdown text with optional container variant"
},
"Callout": {
"signature": "Callout(variant: \"info\" | \"warning\" | \"error\" | \"success\" | \"neutral\", title: string, description: string, visible?: $binding<boolean>)",
"description": "Callout banner. Optional visible is a reactive $boolean — auto-dismisses after 3s by setting $visible to false."
},
"TextCallout": {
"signature": "TextCallout(variant?: \"neutral\" | \"info\" | \"warning\" | \"success\" | \"danger\", title?: string, description?: string)",
"description": "Text callout with variant, title, and description"
},
"Image": {
"signature": "Image(alt: string, src?: string)",
"description": "Image with alt text and optional URL"
},
"ImageBlock": {
"signature": "ImageBlock(src: string, alt?: string)",
"description": "Image block with loading state"
},
"ImageGallery": {
"signature": "ImageGallery(images: {src: string, alt?: string, details?: string}[])",
"description": "Gallery grid of images with modal preview"
},
"CodeBlock": {
"signature": "CodeBlock(language: string, codeString: string)",
"description": "Syntax-highlighted code block"
},
"Separator": {
"signature": "Separator(orientation?: \"horizontal\" | \"vertical\", decorative?: boolean)",
"description": "Visual divider between content sections"
},
"Table": {
"signature": "Table(columns: Col[])",
"description": "Data table — column-oriented. Each Col holds its own data array."
},
"Col": {
"signature": "Col(label: string, data: any, type?: \"string\" | \"number\" | \"action\")",
"description": "Column definition — holds label + data array"
},
"BarChart": {
"signature": "BarChart(labels: string[], series: Series[], variant?: \"grouped\" | \"stacked\", xLabel?: string, yLabel?: string, height?: number)",
"description": "Vertical bars; use for comparing values across categories with one or more series"
},
"LineChart": {
"signature": "LineChart(labels: string[], series: Series[], variant?: \"linear\" | \"natural\" | \"step\", xLabel?: string, yLabel?: string, height?: number)",
"description": "Lines over categories; use for trends and continuous data over time"
},
"AreaChart": {
"signature": "AreaChart(labels: string[], series: Series[], variant?: \"linear\" | \"natural\" | \"step\", xLabel?: string, yLabel?: string, height?: number)",
"description": "Filled area under lines; use for cumulative totals or volume trends over time"
},
"RadarChart": {
"signature": "RadarChart(labels: string[], series: Series[])",
"description": "Spider/web chart; use for comparing multiple variables across one or more entities"
},
"HorizontalBarChart": {
"signature": "HorizontalBarChart(labels: string[], series: Series[], variant?: \"grouped\" | \"stacked\", xLabel?: string, yLabel?: string)",
"description": "Horizontal bars; prefer when category labels are long or for ranked lists"
},
"Series": {
"signature": "Series(category: string, values: number[])",
"description": "One data series"
},
"PieChart": {
"signature": "PieChart(labels: string[], values: number[], variant?: \"pie\" | \"donut\", appearance?: \"circular\" | \"semiCircular\")",
"description": "Circular slices; use plucked arrays: PieChart(data.categories, data.values)"
},
"RadialChart": {
"signature": "RadialChart(labels: string[], values: number[])",
"description": "Radial bars; use plucked arrays: RadialChart(data.categories, data.values)"
},
"SingleStackedBarChart": {
"signature": "SingleStackedBarChart(labels: string[], values: number[])",
"description": "Single horizontal stacked bar; use plucked arrays: SingleStackedBarChart(data.categories, data.values)"
},
"Slice": {
"signature": "Slice(category: string, value: number)",
"description": "One slice with label and numeric value"
},
"ScatterChart": {
"signature": "ScatterChart(datasets: ScatterSeries[], xLabel?: string, yLabel?: string)",
"description": "X/Y scatter plot; use for correlations, distributions, and clustering"
},
"ScatterSeries": {
"signature": "ScatterSeries(name: string, points: Point[])",
"description": "Named dataset"
},
"Point": {
"signature": "Point(x: number, y: number, z?: number)",
"description": "Data point with numeric coordinates"
},
"Form": {
"signature": "Form(name: string, buttons: Buttons, fields?: FormControl[])",
"description": "Form container with fields and explicit action buttons"
},
"FormControl": {
"signature": "FormControl(label: string, input: Input | TextArea | Select | DatePicker | Slider | CheckBoxGroup | RadioGroup | Chips | OptionCards, hint?: string)",
"description": "Field with label, input component, and optional hint text"
},
"Label": {
"signature": "Label(text: string)",
"description": "Text label"
},
"Input": {
"signature": "Input(name: string, placeholder?: string, type?: \"text\" | \"email\" | \"password\" | \"number\" | \"url\", rules?: {required?: boolean, email?: boolean, url?: boolean, numeric?: boolean, min?: number, max?: number, minLength?: number, maxLength?: number, pattern?: string}, value?: $binding<string>)",
"description": ""
},
"TextArea": {
"signature": "TextArea(name: string, placeholder?: string, rows?: number, rules?: {required?: boolean, email?: boolean, url?: boolean, numeric?: boolean, min?: number, max?: number, minLength?: number, maxLength?: number, pattern?: string}, value?: $binding<string>)",
"description": ""
},
"Select": {
"signature": "Select(name: string, items: SelectItem[], placeholder?: string, rules?: {required?: boolean, email?: boolean, url?: boolean, numeric?: boolean, min?: number, max?: number, minLength?: number, maxLength?: number, pattern?: string}, value?: $binding<string>, size?: \"small\" | \"medium\" | \"large\")",
"description": ""
},
"SelectItem": {
"signature": "SelectItem(value: string, label: string)",
"description": "Option for Select"
},
"DatePicker": {
"signature": "DatePicker(name: string, mode?: \"single\" | \"range\", rules?: {required?: boolean, email?: boolean, url?: boolean, numeric?: boolean, min?: number, max?: number, minLength?: number, maxLength?: number, pattern?: string}, value?: $binding<any>)",
"description": ""
},
"Slider": {
"signature": "Slider(name: string, variant: \"continuous\" | \"discrete\", min: number, max: number, step?: number, defaultValue?: number[], label?: string, rules?: {required?: boolean, email?: boolean, url?: boolean, numeric?: boolean, min?: number, max?: number, minLength?: number, maxLength?: number, pattern?: string}, value?: $binding<number[]>)",
"description": "Numeric slider input; supports continuous and discrete (stepped) variants"
},
"CheckBoxGroup": {
"signature": "CheckBoxGroup(name: string, items: CheckBoxItem[], rules?: {required?: boolean, email?: boolean, url?: boolean, numeric?: boolean, min?: number, max?: number, minLength?: number, maxLength?: number, pattern?: string}, value?: $binding<Record<string, boolean>>)",
"description": ""
},
"CheckBoxItem": {
"signature": "CheckBoxItem(label: string, description: string, name: string, defaultChecked?: boolean)",
"description": ""
},
"RadioGroup": {
"signature": "RadioGroup(name: string, items: RadioItem[], defaultValue?: string, rules?: {required?: boolean, email?: boolean, url?: boolean, numeric?: boolean, min?: number, max?: number, minLength?: number, maxLength?: number, pattern?: string}, value?: $binding<string>)",
"description": ""
},
"RadioItem": {
"signature": "RadioItem(label: string, description: string, value: string)",
"description": ""
},
"SwitchGroup": {
"signature": "SwitchGroup(name: string, items: SwitchItem[], variant?: \"clear\" | \"card\" | \"sunk\", value?: $binding<Record<string, boolean>>)",
"description": "Group of switch toggles"
},
"SwitchItem": {
"signature": "SwitchItem(label?: string, description?: string, name: string, defaultChecked?: boolean)",
"description": "Individual switch toggle"
},
"Button": {
"signature": "Button(label: string, action?: ActionExpression, variant?: \"primary\" | \"secondary\" | \"tertiary\", type?: \"normal\" | \"destructive\", size?: \"extra-small\" | \"small\" | \"medium\" | \"large\")",
"description": "Clickable button"
},
"Buttons": {
"signature": "Buttons(buttons: Button[], direction?: \"row\" | \"column\")",
"description": "Group of Button components. direction: \"row\" (default) | \"column\"."
},
"ListBlock": {
"signature": "ListBlock(items: ListItem[], variant?: \"number\" | \"image\", size?: \"default\" | \"small\")",
"description": "A list of items with number or image indicators. Each item can optionally have an action. size small renders a compact list."
},
"ListItem": {
"signature": "ListItem(title: string, subtitle?: string, image?: {src: string, alt: string}, actionLabel?: string, action?: ActionExpression)",
"description": "Item in a ListBlock — displays a title with an optional subtitle and image. When action is provided, the item becomes clickable."
},
"FollowUpBlock": {
"signature": "FollowUpBlock(items: FollowUpItem[])",
"description": "List of clickable follow-up suggestions placed at the end of a response"
},
"FollowUpItem": {
"signature": "FollowUpItem(text: string)",
"description": "Clickable follow-up suggestion — when clicked, sends text as user message"
},
"SectionBlock": {
"signature": "SectionBlock(sections: SectionItem[], isFoldable?: boolean)",
"description": "Collapsible accordion sections. Auto-opens sections as they stream in. Use SectionItem for each section."
},
"SectionItem": {
"signature": "SectionItem(value: string, trigger: string, content: (TextContent | MarkDownRenderer | CardHeader | Callout | TextCallout | CodeBlock | Image | ImageBlock | ImageGallery | Separator | HorizontalBarChart | RadarChart | PieChart | RadialChart | SingleStackedBarChart | ScatterChart | AreaChart | BarChart | LineChart | Table | TagBlock | Form | Buttons | IconButton | Steps | InlineHeader | EntityList | EditableTable | SnippetCardBlock | OverviewCardBlock | ContextCardBlock | CompositeCardBlock | VisualCardBlock | ListBlock | FollowUpBlock | Tabs | Accordion)[])",
"description": "Section with a label and collapsible content — used inside SectionBlock"
},
"Tabs": {
"signature": "Tabs(items: TabItem[])",
"description": "Tabbed container"
},
"TabItem": {
"signature": "TabItem(value: string, trigger: string, content: (TextContent | MarkDownRenderer | CardHeader | Callout | TextCallout | CodeBlock | Image | ImageBlock | ImageGallery | Separator | HorizontalBarChart | RadarChart | PieChart | RadialChart | SingleStackedBarChart | ScatterChart | AreaChart | BarChart | LineChart | Table | TagBlock | Form | Buttons | IconButton | Steps | InlineHeader | EntityList | EditableTable | SnippetCardBlock | OverviewCardBlock | ContextCardBlock | CompositeCardBlock | VisualCardBlock | ListBlock | FollowUpBlock | Accordion)[])",
"description": "value is unique id, trigger is tab label, content is array of components"
},
"Accordion": {
"signature": "Accordion(items: AccordionItem[])",
"description": "Collapsible sections"
},
"AccordionItem": {
"signature": "AccordionItem(value: string, trigger: string, content: (TextContent | MarkDownRenderer | CardHeader | Callout | TextCallout | CodeBlock | Image | ImageBlock | ImageGallery | Separator | HorizontalBarChart | RadarChart | PieChart | RadialChart | SingleStackedBarChart | ScatterChart | AreaChart | BarChart | LineChart | Table | TagBlock | Form | Buttons | IconButton | Steps | InlineHeader | EntityList | EditableTable | SnippetCardBlock | OverviewCardBlock | ContextCardBlock | CompositeCardBlock | VisualCardBlock | ListBlock | FollowUpBlock)[])",
"description": "value is unique id, trigger is section title"
},
"Steps": {
"signature": "Steps(items: StepsItem[])",
"description": "Step-by-step guide"
},
"StepsItem": {
"signature": "StepsItem(title: string, details: string)",
"description": "title and details text for one step"
},
"Carousel": {
"signature": "Carousel(children: (TextContent | MarkDownRenderer | CardHeader | Callout | TextCallout | CodeBlock | Image | ImageBlock | ImageGallery | Separator | HorizontalBarChart | RadarChart | PieChart | RadialChart | SingleStackedBarChart | ScatterChart | AreaChart | BarChart | LineChart | Table | TagBlock | Form | Buttons | IconButton | Steps | InlineHeader | EntityList | EditableTable | SnippetCardBlock | OverviewCardBlock | ContextCardBlock | CompositeCardBlock | VisualCardBlock | ListBlock | FollowUpBlock)[][], variant?: \"card\" | \"sunk\")",
"description": "Horizontal scrollable carousel"
},
"TagBlock": {
"signature": "TagBlock(tags: string[], size?: \"sm\" | \"md\" | \"lg\")",
"description": "tags is an array of strings; optional size sm | md | lg"
},
"Tag": {
"signature": "Tag(text: string, icon?: Icon, size?: \"sm\" | \"md\" | \"lg\", variant?: \"neutral\" | \"info\" | \"success\" | \"warning\" | \"danger\")",
"description": "Styled tag/badge with optional Icon and variant"
},
"EntityList": {
"signature": "EntityList(rows?: {left: string, right: string, rightVariant?: \"text\" | \"number\"}[], size?: \"small\" | \"default\", header?: {left: string, right: string, rightVariant?: \"text\" | \"number\"}, footer?: {left: string, right: string, rightVariant?: \"text\" | \"number\"})",
"description": "Two-column key/value rows (left label, right value). size 'default' supports optional header and footer rows; rightVariant 'number' uses tabular numbers."
},
"InlineHeader": {
"signature": "InlineHeader(heading: string, description?: string)",
"description": "Compact section heading with an optional one-line description, for use inside cards."
},
"Icon": {
"signature": "Icon(name: string, category?: string)",
"description": "A lucide icon by kebab-case name (e.g. 'circle-check'). Optional category picks a topical fallback when the name doesn't resolve."
},
"IconButton": {
"signature": "IconButton(name: string, icon: Icon, action?: ActionExpression, variant?: \"primary\" | \"secondary\" | \"tertiary\", size?: \"extra-small\" | \"small\" | \"medium\" | \"large\", shape?: \"square\" | \"circle\")",
"description": "Icon-only button. name is the accessible label and the action label; icon is an Icon; action fires on click."
},
"EditableTable": {
"signature": "EditableTable(name?: string, columns?: {type: \"text\" | \"number\" | \"date-single\" | \"select\" | \"url\", key?: string, header?: string, width?: number, options?: {value: string, label: string}[]}[], data?: {id: string, values: (string | number)[]}[])",
"description": "Spreadsheet-like table whose cells the user can edit inline (text, number, url, date, select columns); edits are saved back as a form field"
},
"ChipItem": {
"signature": "ChipItem(value: string, label: string, icon?: Icon, disabled?: boolean)",
"description": "A single selectable chip inside a Chips group, with a value, label and optional icon."
},
"Chips": {
"signature": "Chips(name: string, type?: \"single\" | \"multiple\", items?: ChipItem[], rules?: {required?: boolean, email?: boolean, url?: boolean, numeric?: boolean, min?: number, max?: number, minLength?: number, maxLength?: number, pattern?: string}, defaultValue?: string | string[])",
"description": "A form field of compact selectable chips for choosing one or many short options; the selection is stored under `name`."
},
"OptionCard": {
"signature": "OptionCard(value: string, title: string, subtitle?: string, topContent?: Icon | Image, disabled?: boolean)",
"description": "A single selectable card inside an OptionCards group, with a value, title, optional subtitle and an optional Icon or Image on top."
},
"OptionCards": {
"signature": "OptionCards(name: string, type?: \"single\" | \"multiple\", items?: OptionCard[], rules?: {required?: boolean, email?: boolean, url?: boolean, numeric?: boolean, min?: number, max?: number, minLength?: number, maxLength?: number, pattern?: string}, defaultValue?: string | string[])",
"description": "A form field of selectable cards (title, optional subtitle, optional icon or image) laid out in a responsive grid for choosing one or many options; the selection is stored under `name`."
},
"Text": {
"signature": "Text(variant?: \"text\" | \"number\", value: string, subtext?: string, subtextVariant?: \"text\" | \"number\" | \"metric\", size?: \"xs\" | \"sm\" | \"md\" | \"lg\")",
"description": "Plain text line with optional subtext. variant 'number' uses tabular number styling; subtextVariant 'metric' colors a leading +/- subtext green/red."
},
"BoldText": {
"signature": "BoldText(variant?: \"text\" | \"number\", value: string, subtext?: string, subtextVariant?: \"text\" | \"number\" | \"metric\", size?: \"xs\" | \"sm\" | \"md\" | \"lg\")",
"description": "Emphasized (bold) text line with optional subtext. variant 'number' uses tabular number styling; subtextVariant 'metric' colors a leading +/- subtext green/red."
},
"IconText": {
"signature": "IconText(icon: Icon, iconVariant?: \"neutral\" | \"info\" | \"success\" | \"warning\" | \"danger\" | \"inverted\" | \"filled\" | \"soft\", iconSize?: \"xs\" | \"s\" | \"m\" | \"l\" | \"xl\" | \"sm\" | \"md\" | \"lg\", title: string, subtitle?: string, bold?: boolean, layout?: \"horizontal\" | \"vertical\")",
"description": "An icon badge with a title and optional subtitle, laid out horizontally or vertically. iconVariant sets the badge color."
},
"ImageText": {
"signature": "ImageText(src: string, alt?: string, title: string, subtitle?: string, bold?: boolean, layout?: \"horizontal\" | \"vertical\", imageSize?: number)",
"description": "A small square image (thumbnail/avatar) with a title and optional subtitle. src must be a real image URL."
},
"ImageTextLarge": {
"signature": "ImageTextLarge(src: string, alt?: string, title: string, subtitle?: string, bold?: boolean)",
"description": "A full-width banner image above a bold title and optional subtitle. src must be a real image URL."
},
"MetricIndicatorInline": {
"signature": "MetricIndicatorInline(value: string, subtext?: string, trend?: {direction: \"up\" | \"down\", value: number})",
"description": "Headline metric value with an optional +/- percentage trend and subtext, all on one line."
},
"MetricIndicatorWithStrikethrough": {
"signature": "MetricIndicatorWithStrikethrough(value: string, subtext?: string, previousValue?: string, trend?: {direction: \"up\" | \"down\", value: number})",
"description": "Headline metric value with an optional struck-through previousValue, a +/- percentage trend, and subtext below."
},
"SnippetCardItem": {
"signature": "SnippetCardItem(id?: string, lhs: IconText | ImageText, rhs?: Text | BoldText)",
"description": "One row-style snippet card: a label on the left (IconText or ImageText) and an optional value on the right (Text or BoldText)."
},
"SnippetCardBlock": {
"signature": "SnippetCardBlock(items: SnippetCardItem[], layout?: \"grid\", responsive?: boolean, action?: ActionExpression, gap?: number | string)",
"description": "A responsive grid of compact label/value cards (2 per row) for showing several short facts side by side; optionally clickable with a shared action."
},
"OverviewCardItem": {
"signature": "OverviewCardItem(id?: string, top: IconText | ImageText | Text, bottom?: MetricIndicatorInline)",
"description": "One overview card: a heading slot at the top (IconText, ImageText or Text) and an optional MetricIndicatorInline at the bottom."
},
"OverviewCardBlock": {
"signature": "OverviewCardBlock(items: OverviewCardItem[], layout?: \"grid\" | \"carousel\", responsive?: boolean, action?: ActionExpression, gap?: number | string)",
"description": "A grid or horizontal carousel of compact overview cards, each with a heading (icon/image/text) on top and an inline metric below; optionally clickable with a shared action."
},
"ContextCardItem": {
"signature": "ContextCardItem(id?: string, title: string | Tag, body?: string, bgColor?: \"gray\", bgImageSrc?: string, bgImageAlt?: string)",
"description": "A single card inside a ContextCardBlock: a title (plain string or Tag), an optional markdown body, and an optional gray tint or background image."
},
"ContextCardBlock": {
"signature": "ContextCardBlock(items: ContextCardItem[], layout?: \"grid\" | \"carousel\", responsive?: boolean, action?: ActionExpression, gap?: number | string)",
"description": "A grid or carousel of compact tinted context cards (title or tag plus a short bold body); an optional action makes every card clickable."
},
"CompositeCardItem": {
"signature": "CompositeCardItem(id?: string, header?: IconText | ImageText | ImageTextLarge | Text | Image, body?: (Text | BoldText | MetricIndicatorInline | IconText | Image | AreaChart | BarChart | LineChart | ListBlock | TagBlock | EntityList)[], footer?: {price?: BoldText | MetricIndicatorWithStrikethrough, button?: Button})",
"description": "A single card inside a CompositeCardBlock: an optional header (icon/image/text), a stack of body elements (text, metrics, charts, lists, tags), and an optional price/button footer."
},
"CompositeCardBlock": {
"signature": "CompositeCardBlock(items: CompositeCardItem[], layout?: \"grid\" | \"carousel\", responsive?: boolean, action?: ActionExpression, gap?: number | string)",
"description": "A two-per-row grid or carousel of rich cards, each with an optional header, stacked body content (text, metrics, charts, lists, tags) and a price/button footer; an optional action makes every card clickable."
},
"VisualCardItem": {
"signature": "VisualCardItem(body: BoldText, id?: string, bgImageSrc?: string, tag?: Tag, bgImageAlt?: string)",
"description": "A single photo-first card inside a VisualCardBlock: a BoldText body panel, an optional Tag, and a background image (bgImageSrc must be a real URL; bgImageAlt is its alt text)."
},
"VisualCardBlock": {
"signature": "VisualCardBlock(items: VisualCardItem[], layout?: \"grid\" | \"carousel\", responsive?: boolean, action?: ActionExpression, gap?: number | string)",
"description": "A grid or carousel of photo-first cards: a full-bleed background image with a tag on top and a bold text panel at the bottom; an optional action makes every card clickable."
}
},
"componentGroups": [
{
"name": "Content",
"components": [
"CardHeader",
"TextContent",
"MarkDownRenderer",
"Callout",
"TextCallout",
"Image",
"ImageBlock",
"ImageGallery",
"CodeBlock",
"Separator",
"InlineHeader"
],
"notes": [
"- InlineHeader is a compact heading + description pair for labelling a block inside the response (lighter than CardHeader).",
"- Pass sources on Card ([{ title, sourceName, url }]) when the answer relies on references, and cite them inline in TextContent as [1], [2] (1-based index into sources). A Sources strip renders at the bottom of the card."
]
},
{
"name": "Tables",
"components": [
"Table",
"Col",
"EditableTable"
],
"notes": [
"- EditableTable lets the user edit cells inline. Give it a unique name, columns of { type, key, header } with type one of text | number | date-single | select | url (select also needs options: [{ value, label }]).",
"- data is an array of { id, values } rows where values are ordered positionally to match columns. Edited data is submitted when the user clicks Save Changes."
]
},
{
"name": "Charts (2D)",
"components": [
"BarChart",
"LineChart",
"AreaChart",
"RadarChart",
"HorizontalBarChart",
"Series"
]
},
{
"name": "Charts (1D)",
"components": [
"PieChart",
"RadialChart",
"SingleStackedBarChart",
"Slice"
]
},
{
"name": "Charts (Scatter)",
"components": [
"ScatterChart",
"ScatterSeries",
"Point"
]
},
{
"name": "Forms",
"components": [
"Form",
"FormControl",
"Label",
"Input",
"TextArea",
"Select",
"SelectItem",
"DatePicker",
"Slider",
"CheckBoxGroup",
"CheckBoxItem",
"RadioGroup",
"RadioItem",
"SwitchGroup",
"SwitchItem",
"Chips",
"ChipItem",
"OptionCards",
"OptionCard"
],
"notes": [
"- Chips: compact single/multiple selection pills. Use ChipItem references for each option.",
"- OptionCards: larger selectable cards with title, subtitle and an optional Icon or Image on top. Use OptionCard references for each option.",
"- Define EACH FormControl as its own reference — do NOT inline all controls in one array.",
"- NEVER nest Form inside Form.",
"- Form requires explicit buttons. Always pass a Buttons(...) reference as the second Form argument: Form(name, buttons, fields).",
"- rules is an optional object: { required: true, email: true, min: 8, maxLength: 100 }",
"- The renderer shows error messages automatically — do NOT generate error text in the UI"
]
},
{
"name": "Buttons",
"components": [
"Button",
"Buttons",
"Icon",
"IconButton"
],
"notes": [
"- Icon renders a lucide icon by kebab-case name; it is also used as the icon of IconButton, IconText and OptionCard."
]
},
{
"name": "Lists & Follow-ups",
"components": [
"ListBlock",
"ListItem",
"FollowUpBlock",
"FollowUpItem"
],
"notes": [
"- Use ListBlock with ListItem references for numbered lists.",
"- Use FollowUpBlock with FollowUpItem references at the end of a response to suggest next actions.",
"- A ListItem is clickable ONLY when given an action (5th argument); without one it is plain text.",
"- Clicking a FollowUpItem, or a ListItem with a @ToAssistant action, sends text to the LLM as a user message.",
"- Example: list = ListBlock([item1, item2]) item1 = ListItem(\"Option A\", \"Details about A\", null, null, @ToAssistant(\"Option A\"))"
]
},
{
"name": "Sections",
"components": [
"SectionBlock",
"SectionItem"
],
"notes": [
"- SectionBlock renders collapsible accordion sections that auto-open as they stream.",
"- Each section needs a unique `value` id, a `trigger` label, and a `content` array.",
"- Example: sections = SectionBlock([s1, s2]) s1 = SectionItem(\"intro\", \"Introduction\", [content1])",
"- Set isFoldable=false to render sections as flat headers instead of accordion."
]
},
{
"name": "Layout",
"components": [
"Tabs",
"TabItem",
"Accordion",
"AccordionItem",
"Steps",
"StepsItem",
"Carousel"
],
"notes": [
"- Use Tabs to present alternative views — each TabItem has a value id, trigger label, and content array.",
"- Carousel takes an array of slides, where each slide is an array of content: carousel = Carousel([[t1, img1], [t2, img2]])",
"- IMPORTANT: Every slide in a Carousel must have the same structure — same component types in the same order.",
"- For image carousels use: [[title, image, description, tags], ...] — every slide must follow this exact pattern.",
"- Use real, publicly accessible image URLs (e.g. https://picsum.photos/seed/KEYWORD/800/500). Never hallucinate image URLs."
]
},
{
"name": "Data Display",
"components": [
"TagBlock",
"Tag",
"EntityList"
],
"notes": [
"- EntityList is a compact two-column list of { left, right } rows (e.g. name / value). size='default' also supports a header and footer row; size='small' does not."
]
},
{
"name": "Cards",
"components": [
"SnippetCardBlock",
"SnippetCardItem",
"OverviewCardBlock",
"OverviewCardItem",
"ContextCardBlock",
"ContextCardItem",
"CompositeCardBlock",
"CompositeCardItem",
"VisualCardBlock",
"VisualCardItem",
"Text",
"BoldText",
"IconText",
"ImageText",
"ImageTextLarge",
"MetricIndicatorInline",
"MetricIndicatorWithStrikethrough"
],
"notes": [
"- Card blocks lay out 2+ items in a responsive grid (or carousel where supported). Every item in a block must have the same structure.",
"- SnippetCardItem: small card with lhs (IconText | ImageText) and optional rhs (Text | BoldText) — good for key/value facts.",
"- OverviewCardItem: small card with top (IconText | ImageText | Text) and optional bottom MetricIndicatorInline — good for KPIs.",
"- ContextCardItem: medium card with a title (string or Tag), body text and optional background image — good for summaries.",
"- CompositeCardItem: rich card with header, body array (Text, BoldText, MetricIndicatorInline, IconText, Image, charts, ListBlock, TagBlock, EntityList) and footer (price + Button) — good for products/offers.",
"- VisualCardItem: image-first card with a BoldText body and optional Tag.",
"- Text / BoldText / IconText / ImageText / ImageTextLarge / MetricIndicator* are the inline building blocks used INSIDE card items; do not place them directly in the root Card."
]
}
],
"schema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"Card": {
"$ref": "#/$defs/Card"
},
"CardHeader": {
"$ref": "#/$defs/CardHeader"
},
"TextContent": {
"$ref": "#/$defs/TextContent"
},
"MarkDownRenderer": {
"$ref": "#/$defs/MarkDownRenderer"
},
"Callout": {
"$ref": "#/$defs/Callout"
},
"TextCallout": {
"$ref": "#/$defs/TextCallout"
},
"Image": {
"$ref": "#/$defs/Image"
},
"ImageBlock": {
"$ref": "#/$defs/ImageBlock"
},
"ImageGallery": {
"$ref": "#/$defs/ImageGallery"
},
"CodeBlock": {
"$ref": "#/$defs/CodeBlock"
},
"Separator": {
"$ref": "#/$defs/Separator"
},
"Table": {
"$ref": "#/$defs/Table"
},
"Col": {
"$ref": "#/$defs/Col"
},
"BarChart": {
"$ref": "#/$defs/BarChart"
},
"LineChart": {
"$ref": "#/$defs/LineChart"
},
"AreaChart": {
"$ref": "#/$defs/AreaChart"
},
"RadarChart": {
"$ref": "#/$defs/RadarChart"
},
"HorizontalBarChart": {
"$ref": "#/$defs/HorizontalBarChart"
},
"Series": {
"$ref": "#/$defs/Series"
},
"PieChart": {
"$ref": "#/$defs/PieChart"
},
"RadialChart": {
"$ref": "#/$defs/RadialChart"
},
"SingleStackedBarChart": {
"$ref": "#/$defs/SingleStackedBarChart"
},
"Slice": {
"$ref": "#/$defs/Slice"
},
"ScatterChart": {
"$ref": "#/$defs/ScatterChart"
},
"ScatterSeries": {
"$ref": "#/$defs/ScatterSeries"
},
"Point": {
"$ref": "#/$defs/Point"
},
"Form": {
"$ref": "#/$defs/Form"
},
"FormControl": {
"$ref": "#/$defs/FormControl"
},
"Label": {
"$ref": "#/$defs/Label"
},
"Input": {
"$ref": "#/$defs/Input"
},
"TextArea": {
"$ref": "#/$defs/TextArea"
},
"Select": {
"$ref": "#/$defs/Select"
},
"SelectItem": {
"$ref": "#/$defs/SelectItem"
},
"DatePicker": {
"$ref": "#/$defs/DatePicker"
},
"Slider": {
"$ref": "#/$defs/Slider"
},
"CheckBoxGroup": {
"$ref": "#/$defs/CheckBoxGroup"
},
"CheckBoxItem": {
"$ref": "#/$defs/CheckBoxItem"
},
"RadioGroup": {
"$ref": "#/$defs/RadioGroup"
},
"RadioItem": {
"$ref": "#/$defs/RadioItem"
},
"SwitchGroup": {
"$ref": "#/$defs/SwitchGroup"
},
"SwitchItem": {
"$ref": "#/$defs/SwitchItem"
},
"Button": {
"$ref": "#/$defs/Button"
},
"Buttons": {
"$ref": "#/$defs/Buttons"
},
"ListBlock": {
"$ref": "#/$defs/ListBlock"
},
"ListItem": {
"$ref": "#/$defs/ListItem"
},
"FollowUpBlock": {
"$ref": "#/$defs/FollowUpBlock"
},
"FollowUpItem": {
"$ref": "#/$defs/FollowUpItem"
},
"SectionBlock": {
"$ref": "#/$defs/SectionBlock"
},
"SectionItem": {
"$ref": "#/$defs/SectionItem"
},
"Tabs": {
"$ref": "#/$defs/Tabs"
},
"TabItem": {
"$ref": "#/$defs/TabItem"
},
"Accordion": {
"$ref": "#/$defs/Accordion"
},
"AccordionItem": {
"$ref": "#/$defs/AccordionItem"
},
"Steps": {
"$ref": "#/$defs/Steps"
},
"StepsItem": {
"$ref": "#/$defs/StepsItem"
},
"Carousel": {
"$ref": "#/$defs/Carousel"
},
"TagBlock": {
"$ref": "#/$defs/TagBlock"
},
"Tag": {
"$ref": "#/$defs/Tag"
},
"EntityList": {
"$ref": "#/$defs/EntityList"
},
"InlineHeader": {
"$ref": "#/$defs/InlineHeader"
},
"Icon": {
"$ref": "#/$defs/Icon"
},
"IconButton": {
"$ref": "#/$defs/IconButton"
},
"EditableTable": {
"$ref": "#/$defs/EditableTable"
},
"ChipItem": {
"$ref": "#/$defs/ChipItem"
},
"Chips": {
"$ref": "#/$defs/Chips"
},
"OptionCard": {
"$ref": "#/$defs/OptionCard"
},
"OptionCards": {
"$ref": "#/$defs/OptionCards"
},
"Text": {
"$ref": "#/$defs/Text"
},
"BoldText": {
"$ref": "#/$defs/BoldText"
},
"IconText": {
"$ref": "#/$defs/IconText"
},
"ImageText": {
"$ref": "#/$defs/ImageText"
},
"ImageTextLarge": {
"$ref": "#/$defs/ImageTextLarge"
},
"MetricIndicatorInline": {
"$ref": "#/$defs/MetricIndicatorInline"
},
"MetricIndicatorWithStrikethrough": {
"$ref": "#/$defs/MetricIndicatorWithStrikethrough"
},
"SnippetCardItem": {
"$ref": "#/$defs/SnippetCardItem"
},
"SnippetCardBlock": {
"$ref": "#/$defs/SnippetCardBlock"
},
"OverviewCardItem": {
"$ref": "#/$defs/OverviewCardItem"
},
"OverviewCardBlock": {
"$ref": "#/$defs/OverviewCardBlock"
},
"ContextCardItem": {
"$ref": "#/$defs/ContextCardItem"
},
"ContextCardBlock": {
"$ref": "#/$defs/ContextCardBlock"
},
"CompositeCardItem": {
"$ref": "#/$defs/CompositeCardItem"
},
"CompositeCardBlock": {
"$ref": "#/$defs/CompositeCardBlock"
},
"VisualCardItem": {
"$ref": "#/$defs/VisualCardItem"
},
"VisualCardBlock": {
"$ref": "#/$defs/VisualCardBlock"
}
},
"required": [
"Card",
"CardHeader",
"TextContent",
"MarkDownRenderer",
"Callout",
"TextCallout",
"Image",
"ImageBlock",
"ImageGallery",
"CodeBlock",
"Separator",
"Table",
"Col",
"BarChart",
"LineChart",
"AreaChart",
"RadarChart",
"HorizontalBarChart",
"Series",
"PieChart",
"RadialChart",
"SingleStackedBarChart",
"Slice",
"ScatterChart",
"ScatterSeries",
"Point",
"Form",
"FormControl",
"Label",
"Input",
"TextArea",
"Select",
"SelectItem",
"DatePicker",
"Slider",
"CheckBoxGroup",
"CheckBoxItem",
"RadioGroup",
"RadioItem",
"SwitchGroup",
"SwitchItem",
"Button",
"Buttons",
"ListBlock",
"ListItem",
"FollowUpBlock",
"FollowUpItem",
"SectionBlock",
"SectionItem",
"Tabs",
"TabItem",
"Accordion",
"AccordionItem",
"Steps",
"StepsItem",
"Carousel",
"TagBlock",
"Tag",
"EntityList",
"InlineHeader",
"Icon",
"IconButton",
"EditableTable",
"ChipItem",
"Chips",
"OptionCard",
"OptionCards",
"Text",
"BoldText",
"IconText",
"ImageText",
"ImageTextLarge",
"MetricIndicatorInline",
"MetricIndicatorWithStrikethrough",
"SnippetCardItem",
"SnippetCardBlock",
"OverviewCardItem",
"OverviewCardBlock",
"ContextCardItem",
"ContextCardBlock",
"CompositeCardItem",
"CompositeCardBlock",
"VisualCardItem",
"VisualCardBlock"
],
"additionalProperties": false,
"$defs": {
"Card": {
"type": "object",
"properties": {
"children": {
"type": "array",
"items": {
"anyOf": [
{
"$ref": "#/$defs/TextContent"
},
{
"$ref": "#/$defs/MarkDownRenderer"
},
{
"$ref": "#/$defs/CardHeader"
},
{
"$ref": "#/$defs/Callout"
},
{
"$ref": "#/$defs/TextCallout"
},
{
"$ref": "#/$defs/CodeBlock"
},
{
"$ref": "#/$defs/Image"
},
{
"$ref": "#/$defs/ImageBlock"
},
{
"$ref": "#/$defs/ImageGallery"
},
{
"$ref": "#/$defs/Separator"
},
{
"$ref": "#/$defs/HorizontalBarChart"
},
{
"$ref": "#/$defs/RadarChart"
},
{
"$ref": "#/$defs/PieChart"
},
{
"$ref": "#/$defs/RadialChart"
},
{
"$ref": "#/$defs/SingleStackedBarChart"
},
{
"$ref": "#/$defs/ScatterChart"
},
{
"$ref": "#/$defs/AreaChart"
},
{
"$ref": "#/$defs/BarChart"
},
{
"$ref": "#/$defs/LineChart"
},
{
"$ref": "#/$defs/Table"
},
{
"$ref": "#/$defs/TagBlock"
},
{
"$ref": "#/$defs/Form"
},
{
"$ref": "#/$defs/Buttons"
},
{
"$ref": "#/$defs/IconButton"
},
{
"$ref": "#/$defs/Steps"
},
{
"$ref": "#/$defs/InlineHeader"
},
{
"$ref": "#/$defs/EntityList"
},
{
"$ref": "#/$defs/EditableTable"
},
{
"$ref": "#/$defs/SnippetCardBlock"
},
{
"$ref": "#/$defs/OverviewCardBlock"
},
{
"$ref": "#/$defs/ContextCardBlock"
},
{
"$ref": "#/$defs/CompositeCardBlock"
},
{
"$ref": "#/$defs/VisualCardBlock"
},
{
"$ref": "#/$defs/ListBlock"
},
{
"$ref": "#/$defs/FollowUpBlock"
},
{
"$ref": "#/$defs/SectionBlock"
},
{
"$ref": "#/$defs/Tabs"
},
{
"$ref": "#/$defs/Carousel"
}
]
}
},
"sources": {
"type": "array",
"items": {
"type": "object",
"properties": {
"url": {
"type": "string"
},
"title": {
"type": "string"
},
"sourceName": {
"type": "string"
}
},
"required": [
"title",
"sourceName"
],
"additionalProperties": false
}
}
},
"required": [
"children"
],
"additionalProperties": false,
"description": "Vertical container for all content in a chat response. Children stack top to bottom automatically. Optional sources ([{ title, sourceName, url }]) render as a Sources strip at the bottom and back inline [n] citations in TextContent."
},
"TextContent": {
"type": "object",
"properties": {
"text": {
"type": "string"
},
"size": {
"type": "string",
"enum": [
"small",
"default",
"large",
"small-heavy",
"large-heavy"
]
}
},
"required": [
"text"
],
"additionalProperties": false,
"description": "Text block. Supports markdown. Optional size: \"small\" | \"default\" | \"large\" | \"small-heavy\" | \"large-heavy\"."
},
"MarkDownRenderer": {
"type": "object",
"properties": {
"textMarkdown": {
"type": "string"
},
"variant": {
"type": "string",
"enum": [
"clear",
"card",
"sunk"
]
}
},
"required": [
"textMarkdown"
],
"additionalProperties": false,
"description": "Renders markdown text with optional container variant"
},
"CardHeader": {
"type": "object",
"properties": {
"title": {
"type": "string"
},
"subtitle": {
"type": "string"
}
},
"additionalProperties": false,
"description": "Header with optional title and subtitle"
},
"Callout": {
"type": "object",
"properties": {
"variant": {
"type": "string",
"enum": [
"info",
"warning",
"error",
"success",
"neutral"
]
},
"title": {
"type": "string"
},
"description": {
"type": "string"
},
"visible": {
"type": "boolean"
}
},
"required": [
"variant",
"title",
"description"
],
"additionalProperties": false,
"description": "Callout banner. Optional visible is a reactive $boolean — auto-dismisses after 3s by setting $visible to false."
},
"TextCallout": {
"type": "object",
"properties": {
"variant": {
"type": "string",
"enum": [
"neutral",
"info",
"warning",
"success",
"danger"
]
},
"title": {
"type": "string"
},
"description": {
"type": "string"
}
},
"additionalProperties": false,
"description": "Text callout with variant, title, and description"
},
"CodeBlock": {
"type": "object",
"properties": {
"language": {
"type": "string"
},
"codeString": {
"type": "string"
}
},
"required": [
"language",
"codeString"
],
"additionalProperties": false,
"description": "Syntax-highlighted code block"
},
"Image": {
"type": "object",
"properties": {
"alt": {
"type": "string"
},
"src": {
"type": "string"
}
},
"required": [
"alt"
],
"additionalProperties": false,
"description": "Image with alt text and optional URL"
},
"ImageBlock": {
"type": "object",
"properties": {
"src": {
"type": "string"
},
"alt": {
"type": "string"
}
},
"required": [
"src"
],
"additionalProperties": false,
"description": "Image block with loading state"
},
"ImageGallery": {
"type": "object",
"properties": {
"images": {
"type": "array",
"items": {
"type": "object",
"properties": {
"src": {
"type": "string"
},
"alt": {
"type": "string"
},
"details": {
"type": "string"
}
},
"required": [
"src"
],
"additionalProperties": false
}
}
},
"required": [
"images"
],
"additionalProperties": false,
"description": "Gallery grid of images with modal preview"
},
"Separator": {
"type": "object",
"properties": {
"orientation": {
"type": "string",
"enum": [
"horizontal",
"vertical"
]
},
"decorative": {
"type": "boolean"
}
},
"additionalProperties": false,
"description": "Visual divider between content sections"
},
"HorizontalBarChart": {
"type": "object",
"properties": {
"labels": {
"type": "array",
"items": {
"type": "string"
}
},
"series": {
"type": "array",
"items": {
"$ref": "#/$defs/Series"
}
},
"variant": {
"type": "string",
"enum": [
"grouped",
"stacked"
]
},
"xLabel": {
"type": "string"
},
"yLabel": {
"type": "string"
}
},
"required": [
"labels",
"series"
],
"additionalProperties": false,
"description": "Horizontal bars; prefer when category labels are long or for ranked lists"
},
"Series": {
"type": "object",
"properties": {
"category": {
"type": "string"
},
"values": {
"type": "array",
"items": {
"type": "number"
}
}
},
"required": [
"category",
"values"
],
"additionalProperties": false,
"description": "One data series"
},
"RadarChart": {
"type": "object",
"properties": {
"labels": {
"type": "array",
"items": {
"type": "string"
}
},
"series": {
"type": "array",
"items": {
"$ref": "#/$defs/Series"
}
}
},
"required": [
"labels",
"series"
],
"additionalProperties": false,
"description": "Spider/web chart; use for comparing multiple variables across one or more entities"
},
"PieChart": {
"type": "object",
"properties": {
"labels": {
"type": "array",
"items": {
"type": "string"
}
},
"values": {
"type": "array",
"items": {
"type": "number"
}
},
"variant": {
"type": "string",
"enum": [
"pie",
"donut"
]
},
"appearance": {
"type": "string",
"enum": [
"circular",
"semiCircular"
]
}
},
"required": [
"labels",
"values"
],
"additionalProperties": false,
"description": "Circular slices; use plucked arrays: PieChart(data.categories, data.values)"
},
"RadialChart": {
"type": "object",
"properties": {
"labels": {
"type": "array",
"items": {
"type": "string"
}
},
"values": {
"type": "array",
"items": {
"type": "number"
}
}
},
"required": [
"labels",
"values"
],
"additionalProperties": false,
"description": "Radial bars; use plucked arrays: RadialChart(data.categories, data.values)"
},
"SingleStackedBarChart": {
"type": "object",
"properties": {
"labels": {
"type": "array",
"items": {
"type": "string"
}
},
"values": {
"type": "array",
"items": {
"type": "number"
}
}
},
"required": [
"labels",
"values"
],
"additionalProperties": false,
"description": "Single horizontal stacked bar; use plucked arrays: SingleStackedBarChart(data.categories, data.values)"
},
"ScatterChart": {
"type": "object",
"properties": {
"datasets": {
"type": "array",
"items": {
"$ref": "#/$defs/ScatterSeries"
}
},
"xLabel": {
"type": "string"
},
"yLabel": {
"type": "string"
}
},
"required": [
"datasets"
],
"additionalProperties": false,
"description": "X/Y scatter plot; use for correlations, distributions, and clustering"
},
"ScatterSeries": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"points": {
"type": "array",
"items": {
"$ref": "#/$defs/Point"
}
}
},
"required": [
"name",
"points"
],
"additionalProperties": false,
"description": "Named dataset"
},
"Point": {
"type": "object",
"properties": {
"x": {
"type": "number"
},
"y": {
"type": "number"
},
"z": {
"type": "number"
}
},
"required": [
"x",
"y"
],
"additionalProperties": false,
"description": "Data point with numeric coordinates"
},
"AreaChart": {
"type": "object",
"properties": {
"labels": {
"type": "array",
"items": {
"type": "string"
}
},
"series": {
"type": "array",
"items": {
"$ref": "#/$defs/Series"
}
},
"variant": {
"type": "string",
"enum": [
"linear",
"natural",
"step"
]
},
"xLabel": {
"type": "string"
},
"yLabel": {
"type": "string"
},
"height": {
"type": "number"
}
},
"required": [
"labels",
"series"
],
"additionalProperties": false,
"description": "Filled area under lines; use for cumulative totals or volume trends over time"
},
"BarChart": {
"type": "object",
"properties": {
"labels": {
"type": "array",
"items": {
"type": "string"
}
},
"series": {
"type": "array",
"items": {
"$ref": "#/$defs/Series"
}
},
"variant": {
"type": "string",
"enum": [
"grouped",
"stacked"
]
},
"xLabel": {
"type": "string"
},
"yLabel": {
"type": "string"
},
"height": {
"type": "number"
}
},
"required": [
"labels",
"series"
],
"additionalProperties": false,
"description": "Vertical bars; use for comparing values across categories with one or more series"
},
"LineChart": {
"type": "object",
"properties": {
"labels": {
"type": "array",
"items": {
"type": "string"
}
},
"series": {
"type": "array",
"items": {
"$ref": "#/$defs/Series"
}
},
"variant": {
"type": "string",
"enum": [
"linear",
"natural",
"step"
]
},
"xLabel": {
"type": "string"
},
"yLabel": {
"type": "string"
},
"height": {
"type": "number"
}
},
"required": [
"labels",
"series"
],
"additionalProperties": false,
"description": "Lines over categories; use for trends and continuous data over time"
},
"Table": {
"type": "object",
"properties": {
"columns": {
"type": "array",
"items": {
"$ref": "#/$defs/Col"
}
}
},
"required": [
"columns"
],
"additionalProperties": false,
"description": "Data table — column-oriented. Each Col holds its own data array."
},
"Col": {
"type": "object",
"properties": {
"label": {
"type": "string"
},
"data": {},
"type": {
"type": "string",
"enum": [
"string",
"number",
"action"
]
}
},
"required": [
"label",
"data"
],
"additionalProperties": false,
"description": "Column definition — holds label + data array"
},
"TagBlock": {
"type": "object",
"properties": {
"tags": {
"type": "array",
"items": {
"type": "string"
}
},
"size": {
"type": "string",
"enum": [
"sm",
"md",
"lg"
]
}
},
"required": [
"tags"
],
"additionalProperties": false,
"description": "tags is an array of strings; optional size sm | md | lg"
},
"Form": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"buttons": {
"$ref": "#/$defs/Buttons"
},
"fields": {
"default": [],
"type": "array",
"items": {
"$ref": "#/$defs/FormControl"
}
}
},
"required": [
"name",
"buttons",
"fields"
],
"additionalProperties": false,
"description": "Form container with fields and explicit action buttons"
},
"Buttons": {
"type": "object",
"properties": {
"buttons": {
"type": "array",
"items": {
"$ref": "#/$defs/Button"
}
},
"direction": {
"type": "string",
"enum": [
"row",
"column"
]
}
},
"required": [
"buttons"
],
"additionalProperties": false,
"description": "Group of Button components. direction: \"row\" (default) | \"column\"."
},
"Button": {
"type": "object",
"properties": {
"label": {
"type": "string"
},
"action": {
"$ref": "#/$defs/ActionExpression"
},
"variant": {
"type": "string",
"enum": [
"primary",
"secondary",
"tertiary"
]
},
"type": {
"type": "string",
"enum": [
"normal",
"destructive"
]
},
"size": {
"type": "string",
"enum": [
"extra-small",
"small",
"medium",
"large"
]
}
},
"required": [
"label"
],
"additionalProperties": false,
"description": "Clickable button"
},
"ActionExpression": {
"anyOf": [
{
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "open_url"
},
"url": {
"type": "string"
}
},
"required": [
"type",
"url"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "continue_conversation"
},
"context": {
"type": "string"
}
},
"required": [
"type"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"type": {
"type": "string"
},
"params": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"required": [
"type"
],
"additionalProperties": false
}
]
},
"FormControl": {
"type": "object",
"properties": {
"label": {
"type": "string"
},
"input": {
"anyOf": [
{
"$ref": "#/$defs/Input"
},
{
"$ref": "#/$defs/TextArea"
},
{
"$ref": "#/$defs/Select"
},
{
"$ref": "#/$defs/DatePicker"
},
{
"$ref": "#/$defs/Slider"
},
{
"$ref": "#/$defs/CheckBoxGroup"
},
{
"$ref": "#/$defs/RadioGroup"
},
{
"$ref": "#/$defs/Chips"
},
{
"$ref": "#/$defs/OptionCards"
}
]
},
"hint": {
"type": "string"
}
},
"required": [
"label",
"input"
],
"additionalProperties": false,
"description": "Field with label, input component, and optional hint text"
},
"Input": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"placeholder": {
"type": "string"
},
"type": {
"type": "string",
"enum": [
"text",
"email",
"password",
"number",
"url"
]
},
"rules": {
"type": "object",
"properties": {
"required": {
"type": "boolean"
},
"email": {
"type": "boolean"
},
"url": {
"type": "boolean"
},
"numeric": {
"type": "boolean"
},
"min": {
"type": "number"
},
"max": {
"type": "number"
},
"minLength": {
"type": "number"
},
"maxLength": {
"type": "number"
},
"pattern": {
"type": "string"
}
},
"additionalProperties": false
},
"value": {
"type": "string"
}
},
"required": [
"name"
],
"additionalProperties": false
},
"TextArea": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"placeholder": {
"type": "string"
},
"rows": {
"type": "number"
},
"rules": {
"type": "object",
"properties": {
"required": {
"type": "boolean"
},
"email": {
"type": "boolean"
},
"url": {
"type": "boolean"
},
"numeric": {
"type": "boolean"
},
"min": {
"type": "number"
},
"max": {
"type": "number"
},
"minLength": {
"type": "number"
},
"maxLength": {
"type": "number"
},
"pattern": {
"type": "string"
}
},
"additionalProperties": false
},
"value": {
"type": "string"
}
},
"required": [
"name"
],
"additionalProperties": false
},
"Select": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"items": {
"type": "array",
"items": {
"$ref": "#/$defs/SelectItem"
}
},
"placeholder": {
"type": "string"
},
"rules": {
"type": "object",
"properties": {
"required": {
"type": "boolean"
},
"email": {
"type": "boolean"
},
"url": {
"type": "boolean"
},
"numeric": {
"type": "boolean"
},
"min": {
"type": "number"
},
"max": {
"type": "number"
},
"minLength": {
"type": "number"
},
"maxLength": {
"type": "number"
},
"pattern": {
"type": "string"
}
},
"additionalProperties": false
},
"value": {
"type": "string"
},
"size": {
"type": "string",
"enum": [
"small",
"medium",
"large"
]
}
},
"required": [
"name",
"items"
],
"additionalProperties": false
},
"SelectItem": {
"type": "object",
"properties": {
"value": {
"type": "string"
},
"label": {
"type": "string"
}
},
"required": [
"value",
"label"
],
"additionalProperties": false,
"description": "Option for Select"
},
"DatePicker": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"mode": {
"type": "string",
"enum": [
"single",
"range"
]
},
"rules": {
"type": "object",
"properties": {
"required": {
"type": "boolean"
},
"email": {
"type": "boolean"
},
"url": {
"type": "boolean"
},
"numeric": {
"type": "boolean"
},
"min": {
"type": "number"
},
"max": {
"type": "number"
},
"minLength": {
"type": "number"
},
"maxLength": {
"type": "number"
},
"pattern": {
"type": "string"
}
},
"additionalProperties": false
},
"value": {}
},
"required": [
"name"
],
"additionalProperties": false
},
"Slider": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"variant": {
"type": "string",
"enum": [
"continuous",
"discrete"
]
},
"min": {
"type": "number"
},
"max": {
"type": "number"
},
"step": {
"type": "number"
},
"defaultValue": {
"type": "array",
"items": {
"type": "number"
}
},
"label": {
"type": "string"
},
"rules": {
"type": "object",
"properties": {
"required": {
"type": "boolean"
},
"email": {
"type": "boolean"
},
"url": {
"type": "boolean"
},
"numeric": {
"type": "boolean"
},
"min": {
"type": "number"
},
"max": {
"type": "number"
},
"minLength": {
"type": "number"
},
"maxLength": {
"type": "number"
},
"pattern": {
"type": "string"
}
},
"additionalProperties": false
},
"value": {
"type": "array",
"items": {
"type": "number"
}
}
},
"required": [
"name",
"variant",
"min",
"max"
],
"additionalProperties": false,
"description": "Numeric slider input; supports continuous and discrete (stepped) variants"
},
"CheckBoxGroup": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"items": {
"type": "array",
"items": {
"$ref": "#/$defs/CheckBoxItem"
}
},
"rules": {
"type": "object",
"properties": {
"required": {
"type": "boolean"
},
"email": {
"type": "boolean"
},
"url": {
"type": "boolean"
},
"numeric": {
"type": "boolean"
},
"min": {
"type": "number"
},
"max": {
"type": "number"
},
"minLength": {
"type": "number"
},
"maxLength": {
"type": "number"
},
"pattern": {
"type": "string"
}
},
"additionalProperties": false
},
"value": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": "boolean"
}
}
},
"required": [
"name",
"items"
],
"additionalProperties": false
},
"CheckBoxItem": {
"type": "object",
"properties": {
"label": {
"type": "string"
},
"description": {
"type": "string"
},
"name": {
"type": "string"
},
"defaultChecked": {
"type": "boolean"
}
},
"required": [
"label",
"description",
"name"
],
"additionalProperties": false
},
"RadioGroup": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"items": {
"type": "array",
"items": {
"$ref": "#/$defs/RadioItem"
}
},
"defaultValue": {
"type": "string"
},
"rules": {
"type": "object",
"properties": {
"required": {
"type": "boolean"
},
"email": {
"type": "boolean"
},
"url": {
"type": "boolean"
},
"numeric": {
"type": "boolean"
},
"min": {
"type": "number"
},
"max": {
"type": "number"
},
"minLength": {
"type": "number"
},
"maxLength": {
"type": "number"
},
"pattern": {
"type": "string"
}
},
"additionalProperties": false
},
"value": {
"type": "string"
}
},
"required": [
"name",
"items"
],
"additionalProperties": false
},
"RadioItem": {
"type": "object",
"properties": {
"label": {
"type": "string"
},
"description": {
"type": "string"
},
"value": {
"type": "string"
}
},
"required": [
"label",
"description",
"value"
],
"additionalProperties": false
},
"Chips": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"type": {
"default": "multiple",
"type": "string",
"enum": [
"single",
"multiple"
]
},
"items": {
"default": [],
"type": "array",
"items": {
"$ref": "#/$defs/ChipItem"
}
},
"rules": {
"type": "object",
"properties": {
"required": {
"type": "boolean"
},
"email": {
"type": "boolean"
},
"url": {
"type": "boolean"
},
"numeric": {
"type": "boolean"
},
"min": {
"type": "number"
},
"max": {
"type": "number"
},
"minLength": {
"type": "number"
},
"maxLength": {
"type": "number"
},
"pattern": {
"type": "string"
}
},
"additionalProperties": false
},
"defaultValue": {
"anyOf": [
{
"type": "string"
},
{
"type": "array",
"items": {
"type": "string"
}
}
]
}
},
"required": [
"name",
"type",
"items"
],
"additionalProperties": false,
"description": "A form field of compact selectable chips for choosing one or many short options; the selection is stored under `name`."
},
"ChipItem": {
"type": "object",
"properties": {
"value": {
"type": "string"
},
"label": {
"type": "string"
},
"icon": {
"$ref": "#/$defs/Icon"
},
"disabled": {
"type": "boolean"
}
},
"required": [
"value",
"label"
],
"additionalProperties": false,
"description": "A single selectable chip inside a Chips group, with a value, label and optional icon."
},
"Icon": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"category": {
"type": "string"
}
},
"required": [
"name"
],
"additionalProperties": false,
"description": "A lucide icon by kebab-case name (e.g. 'circle-check'). Optional category picks a topical fallback when the name doesn't resolve."
},
"OptionCards": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"type": {
"default": "single",
"type": "string",
"enum": [
"single",
"multiple"
]
},
"items": {
"default": [],
"type": "array",
"items": {
"$ref": "#/$defs/OptionCard"
}
},
"rules": {
"type": "object",
"properties": {
"required": {
"type": "boolean"
},
"email": {
"type": "boolean"
},
"url": {
"type": "boolean"
},
"numeric": {
"type": "boolean"
},
"min": {
"type": "number"
},
"max": {
"type": "number"
},
"minLength": {
"type": "number"
},
"maxLength": {
"type": "number"
},
"pattern": {
"type": "string"
}
},
"additionalProperties": false
},
"defaultValue": {
"anyOf": [
{
"type": "string"
},
{
"type": "array",
"items": {
"type": "string"
}
}
]
}
},
"required": [
"name",
"type",
"items"
],
"additionalProperties": false,
"description": "A form field of selectable cards (title, optional subtitle, optional icon or image) laid out in a responsive grid for choosing one or many options; the selection is stored under `name`."
},
"OptionCard": {
"type": "object",
"properties": {
"value": {
"type": "string"
},
"title": {
"type": "string"
},
"subtitle": {
"type": "string"
},
"topContent": {
"anyOf": [
{
"$ref": "#/$defs/Icon"
},
{
"$ref": "#/$defs/Image"
}
]
},
"disabled": {
"type": "boolean"
}
},
"required": [
"value",
"title"
],
"additionalProperties": false,
"description": "A single selectable card inside an OptionCards group, with a value, title, optional subtitle and an optional Icon or Image on top."
},
"IconButton": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"icon": {
"$ref": "#/$defs/Icon"
},
"action": {
"$ref": "#/$defs/ActionExpression"
},
"variant": {
"type": "string",
"enum": [
"primary",
"secondary",
"tertiary"
]
},
"size": {
"type": "string",
"enum": [
"extra-small",
"small",
"medium",
"large"
]
},
"shape": {
"type": "string",
"enum": [
"square",
"circle"
]
}
},
"required": [
"name",
"icon"
],
"additionalProperties": false,
"description": "Icon-only button. name is the accessible label and the action label; icon is an Icon; action fires on click."
},
"Steps": {
"type": "object",
"properties": {
"items": {
"type": "array",
"items": {
"$ref": "#/$defs/StepsItem"
}
}
},
"required": [
"items"
],
"additionalProperties": false,
"description": "Step-by-step guide"
},
"StepsItem": {
"type": "object",
"properties": {
"title": {
"type": "string"
},
"details": {
"type": "string"
}
},
"required": [
"title",
"details"
],
"additionalProperties": false,
"description": "title and details text for one step"
},
"InlineHeader": {
"type": "object",
"properties": {
"heading": {
"type": "string"
},
"description": {
"type": "string"
}
},
"required": [
"heading"
],
"additionalProperties": false,
"description": "Compact section heading with an optional one-line description, for use inside cards."
},
"EntityList": {
"type": "object",
"properties": {
"rows": {
"default": [],
"type": "array",
"items": {
"type": "object",
"properties": {
"left": {
"type": "string"
},
"right": {
"type": "string"
},
"rightVariant": {
"default": "text",
"type": "string",
"enum": [
"text",
"number"
]
}
},
"required": [
"left",
"right",
"rightVariant"
],
"additionalProperties": false
}
},
"size": {
"default": "default",
"type": "string",
"enum": [
"small",
"default"
]
},
"header": {
"type": "object",
"properties": {
"left": {
"type": "string"
},
"right": {
"type": "string"
},
"rightVariant": {
"default": "text",
"type": "string",
"enum": [
"text",
"number"
]
}
},
"required": [
"left",
"right",
"rightVariant"
],
"additionalProperties": false
},
"footer": {
"type": "object",
"properties": {
"left": {
"type": "string"
},
"right": {
"type": "string"
},
"rightVariant": {
"default": "text",
"type": "string",
"enum": [
"text",
"number"
]
}
},
"required": [
"left",
"right",
"rightVariant"
],
"additionalProperties": false
}
},
"required": [
"rows",
"size"
],
"additionalProperties": false,
"description": "Two-column key/value rows (left label, right value). size 'default' supports optional header and footer rows; rightVariant 'number' uses tabular numbers."
},
"EditableTable": {
"type": "object",
"properties": {
"name": {
"default": "",
"type": "string"
},
"columns": {
"default": [],
"type": "array",
"items": {
"type": "object",
"properties": {
"type": {
"type": "string",
"enum": [
"text",
"number",
"date-single",
"select",
"url"
]
},
"key": {
"default": "default",
"type": "string"
},
"header": {
"default": "",
"type": "string"
},
"width": {
"type": "number"
},
"options": {
"type": "array",
"items": {
"type": "object",
"properties": {
"value": {
"type": "string"
},
"label": {
"type": "string"
}
},
"required": [
"value",
"label"
],
"additionalProperties": false
}
}
},
"required": [
"type",
"key",
"header"
],
"additionalProperties": false
}
},
"data": {
"default": [],
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"values": {
"type": "array",
"items": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
}
]
}
}
},
"required": [
"id",
"values"
],
"additionalProperties": false
}
}
},
"required": [
"name",
"columns",
"data"
],
"additionalProperties": false,
"description": "Spreadsheet-like table whose cells the user can edit inline (text, number, url, date, select columns); edits are saved back as a form field"
},
"SnippetCardBlock": {
"type": "object",
"properties": {
"items": {
"minItems": 2,
"type": "array",
"items": {
"$ref": "#/$defs/SnippetCardItem"
}
},
"layout": {
"default": "grid",
"type": "string",
"enum": [
"grid"
]
},
"responsive": {
"default": true,
"type": "boolean"
},
"action": {
"$ref": "#/$defs/ActionExpression"
},
"gap": {
"anyOf": [
{
"type": "number"
},
{
"type": "string"
}
]
}
},
"required": [
"items",
"layout",
"responsive"
],
"additionalProperties": false,
"description": "A responsive grid of compact label/value cards (2 per row) for showing several short facts side by side; optionally clickable with a shared action."
},
"SnippetCardItem": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"lhs": {
"anyOf": [
{
"$ref": "#/$defs/IconText"
},
{
"$ref": "#/$defs/ImageText"
}
]
},
"rhs": {
"anyOf": [
{
"$ref": "#/$defs/Text"
},
{
"$ref": "#/$defs/BoldText"
}
]
}
},
"required": [
"lhs"
],
"additionalProperties": false,
"description": "One row-style snippet card: a label on the left (IconText or ImageText) and an optional value on the right (Text or BoldText)."
},
"IconText": {
"type": "object",
"properties": {
"icon": {
"$ref": "#/$defs/Icon"
},
"iconVariant": {
"default": "neutral",
"type": "string",
"enum": [
"neutral",
"info",
"success",
"warning",
"danger",
"inverted",
"filled",
"soft"
]
},
"iconSize": {
"default": "m",
"type": "string",
"enum": [
"xs",
"s",
"m",
"l",
"xl",
"sm",
"md",
"lg"
]
},
"title": {
"type": "string"
},
"subtitle": {
"type": "string"
},
"bold": {
"default": false,
"type": "boolean"
},
"layout": {
"default": "horizontal",
"type": "string",
"enum": [
"horizontal",
"vertical"
]
}
},
"required": [
"icon",
"iconVariant",
"iconSize",
"title",
"bold",
"layout"
],
"additionalProperties": false,
"description": "An icon badge with a title and optional subtitle, laid out horizontally or vertically. iconVariant sets the badge color."
},
"ImageText": {
"type": "object",
"properties": {
"src": {
"type": "string"
},
"alt": {
"type": "string"
},
"title": {
"type": "string"
},
"subtitle": {
"type": "string"
},
"bold": {
"default": false,
"type": "boolean"
},
"layout": {
"default": "horizontal",
"type": "string",
"enum": [
"horizontal",
"vertical"
]
},
"imageSize": {
"type": "number"
}
},
"required": [
"src",
"title",
"bold",
"layout"
],
"additionalProperties": false,
"description": "A small square image (thumbnail/avatar) with a title and optional subtitle. src must be a real image URL."
},
"Text": {
"type": "object",
"properties": {
"variant": {
"default": "text",
"type": "string",
"enum": [
"text",
"number"
]
},
"value": {
"type": "string"
},
"subtext": {
"type": "string"
},
"subtextVariant": {
"default": "text",
"type": "string",
"enum": [
"text",
"number",
"metric"
]
},
"size": {
"default": "sm",
"type": "string",
"enum": [
"xs",
"sm",
"md",
"lg"
]
}
},
"required": [
"variant",
"value",
"subtextVariant",
"size"
],
"additionalProperties": false,
"description": "Plain text line with optional subtext. variant 'number' uses tabular number styling; subtextVariant 'metric' colors a leading +/- subtext green/red."
},
"BoldText": {
"type": "object",
"properties": {
"variant": {
"default": "text",
"type": "string",
"enum": [
"text",
"number"
]
},
"value": {
"type": "string"
},
"subtext": {
"type": "string"
},
"subtextVariant": {
"default": "text",
"type": "string",
"enum": [
"text",
"number",
"metric"
]
},
"size": {
"default": "sm",
"type": "string",
"enum": [
"xs",
"sm",
"md",
"lg"
]
}
},
"required": [
"variant",
"value",
"subtextVariant",
"size"
],
"additionalProperties": false,
"description": "Emphasized (bold) text line with optional subtext. variant 'number' uses tabular number styling; subtextVariant 'metric' colors a leading +/- subtext green/red."
},
"OverviewCardBlock": {
"type": "object",
"properties": {
"items": {
"minItems": 2,
"type": "array",
"items": {
"$ref": "#/$defs/OverviewCardItem"
}
},
"layout": {
"default": "grid",
"type": "string",
"enum": [
"grid",
"carousel"
]
},
"responsive": {
"default": true,
"type": "boolean"
},
"action": {
"$ref": "#/$defs/ActionExpression"
},
"gap": {
"anyOf": [
{
"type": "number"
},
{
"type": "string"
}
]
}
},
"required": [
"items",
"layout",
"responsive"
],
"additionalProperties": false,
"description": "A grid or horizontal carousel of compact overview cards, each with a heading (icon/image/text) on top and an inline metric below; optionally clickable with a shared action."
},
"OverviewCardItem": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"top": {
"anyOf": [
{
"$ref": "#/$defs/IconText"
},
{
"$ref": "#/$defs/ImageText"
},
{
"$ref": "#/$defs/Text"
}
]
},
"bottom": {
"$ref": "#/$defs/MetricIndicatorInline"
}
},
"required": [
"top"
],
"additionalProperties": false,
"description": "One overview card: a heading slot at the top (IconText, ImageText or Text) and an optional MetricIndicatorInline at the bottom."
},
"MetricIndicatorInline": {
"type": "object",
"properties": {
"value": {
"type": "string"
},
"subtext": {
"type": "string"
},
"trend": {
"type": "object",
"properties": {
"direction": {
"type": "string",
"enum": [
"up",
"down"
]
},
"value": {
"type": "number"
}
},
"required": [
"direction",
"value"
],
"additionalProperties": false
}
},
"required": [
"value"
],
"additionalProperties": false,
"description": "Headline metric value with an optional +/- percentage trend and subtext, all on one line."
},
"ContextCardBlock": {
"type": "object",
"properties": {
"items": {
"minItems": 2,
"type": "array",
"items": {
"$ref": "#/$defs/ContextCardItem"
}
},
"layout": {
"default": "grid",
"type": "string",
"enum": [
"grid",
"carousel"
]
},
"responsive": {
"default": true,
"type": "boolean"
},
"action": {
"$ref": "#/$defs/ActionExpression"
},
"gap": {
"anyOf": [
{
"type": "number"
},
{
"type": "string"
}
]
}
},
"required": [
"items",
"layout",
"responsive"
],
"additionalProperties": false,
"description": "A grid or carousel of compact tinted context cards (title or tag plus a short bold body); an optional action makes every card clickable."
},
"ContextCardItem": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"title": {
"anyOf": [
{
"type": "string"
},
{
"$ref": "#/$defs/Tag"
}
]
},
"body": {
"type": "string"
},
"bgColor": {
"type": "string",
"enum": [
"gray"
]
},
"bgImageSrc": {
"type": "string"
},
"bgImageAlt": {
"type": "string"
}
},
"required": [
"title"
],
"additionalProperties": false,
"description": "A single card inside a ContextCardBlock: a title (plain string or Tag), an optional markdown body, and an optional gray tint or background image."
},
"Tag": {
"type": "object",
"properties": {
"text": {
"type": "string"
},
"icon": {
"$ref": "#/$defs/Icon"
},
"size": {
"type": "string",
"enum": [
"sm",
"md",
"lg"
]
},
"variant": {
"type": "string",
"enum": [
"neutral",
"info",
"success",
"warning",
"danger"
]
}
},
"required": [
"text"
],
"additionalProperties": false,
"description": "Styled tag/badge with optional Icon and variant"
},
"CompositeCardBlock": {
"type": "object",
"properties": {
"items": {
"minItems": 2,
"type": "array",
"items": {
"$ref": "#/$defs/CompositeCardItem"
}
},
"layout": {
"default": "grid",
"type": "string",
"enum": [
"grid",
"carousel"
]
},
"responsive": {
"default": true,
"type": "boolean"
},
"action": {
"$ref": "#/$defs/ActionExpression"
},
"gap": {
"anyOf": [
{
"type": "number"
},
{
"type": "string"
}
]
}
},
"required": [
"items",
"layout",
"responsive"
],
"additionalProperties": false,
"description": "A two-per-row grid or carousel of rich cards, each with an optional header, stacked body content (text, metrics, charts, lists, tags) and a price/button footer; an optional action makes every card clickable."
},
"CompositeCardItem": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"header": {
"anyOf": [
{
"$ref": "#/$defs/IconText"
},
{
"$ref": "#/$defs/ImageText"
},
{
"$ref": "#/$defs/ImageTextLarge"
},
{
"$ref": "#/$defs/Text"
},
{
"$ref": "#/$defs/Image"
}
]
},
"body": {
"default": [],
"type": "array",
"items": {
"anyOf": [
{
"$ref": "#/$defs/Text"
},
{
"$ref": "#/$defs/BoldText"
},
{
"$ref": "#/$defs/MetricIndicatorInline"
},
{
"$ref": "#/$defs/IconText"
},
{
"$ref": "#/$defs/Image"
},
{
"$ref": "#/$defs/AreaChart"
},
{
"$ref": "#/$defs/BarChart"
},
{
"$ref": "#/$defs/LineChart"
},
{
"$ref": "#/$defs/ListBlock"
},
{
"$ref": "#/$defs/TagBlock"
},
{
"$ref": "#/$defs/EntityList"
}
]
}
},
"footer": {
"type": "object",
"properties": {
"price": {
"anyOf": [
{
"$ref": "#/$defs/BoldText"
},
{
"$ref": "#/$defs/MetricIndicatorWithStrikethrough"
}
]
},
"button": {
"$ref": "#/$defs/Button"
}
},
"additionalProperties": false
}
},
"required": [
"body"
],
"additionalProperties": false,
"description": "A single card inside a CompositeCardBlock: an optional header (icon/image/text), a stack of body elements (text, metrics, charts, lists, tags), and an optional price/button footer."
},
"ImageTextLarge": {
"type": "object",
"properties": {
"src": {
"type": "string"
},
"alt": {
"type": "string"
},
"title": {
"type": "string"
},
"subtitle": {
"type": "string"
},
"bold": {
"default": false,
"type": "boolean"
}
},
"required": [
"src",
"title",
"bold"
],
"additionalProperties": false,
"description": "A full-width banner image above a bold title and optional subtitle. src must be a real image URL."
},
"ListBlock": {
"type": "object",
"properties": {
"items": {
"type": "array",
"items": {
"$ref": "#/$defs/ListItem"
}
},
"variant": {
"type": "string",
"enum": [
"number",
"image"
]
},
"size": {
"type": "string",
"enum": [
"default",
"small"
]
}
},
"required": [
"items"
],
"additionalProperties": false,
"description": "A list of items with number or image indicators. Each item can optionally have an action. size small renders a compact list."
},
"ListItem": {
"type": "object",
"properties": {
"title": {
"type": "string"
},
"subtitle": {
"type": "string"
},
"image": {
"type": "object",
"properties": {
"src": {
"type": "string"
},
"alt": {
"type": "string"
}
},
"required": [
"src",
"alt"
],
"additionalProperties": false
},
"actionLabel": {
"type": "string"
},
"action": {
"$ref": "#/$defs/ActionExpression"
}
},
"required": [
"title"
],
"additionalProperties": false,
"description": "Item in a ListBlock — displays a title with an optional subtitle and image. When action is provided, the item becomes clickable."
},
"MetricIndicatorWithStrikethrough": {
"type": "object",
"properties": {
"value": {
"type": "string"
},
"subtext": {
"type": "string"
},
"previousValue": {
"type": "string"
},
"trend": {
"type": "object",
"properties": {
"direction": {
"type": "string",
"enum": [
"up",
"down"
]
},
"value": {
"type": "number"
}
},
"required": [
"direction",
"value"
],
"additionalProperties": false
}
},
"required": [
"value"
],
"additionalProperties": false,
"description": "Headline metric value with an optional struck-through previousValue, a +/- percentage trend, and subtext below."
},
"VisualCardBlock": {
"type": "object",
"properties": {
"items": {
"minItems": 2,
"type": "array",
"items": {
"$ref": "#/$defs/VisualCardItem"
}
},
"layout": {
"default": "grid",
"type": "string",
"enum": [
"grid",
"carousel"
]
},
"responsive": {
"default": true,
"type": "boolean"
},
"action": {
"$ref": "#/$defs/ActionExpression"
},
"gap": {
"anyOf": [
{
"type": "number"
},
{
"type": "string"
}
]
}
},
"required": [
"items",
"layout",
"responsive"
],
"additionalProperties": false,
"description": "A grid or carousel of photo-first cards: a full-bleed background image with a tag on top and a bold text panel at the bottom; an optional action makes every card clickable."
},
"VisualCardItem": {
"type": "object",
"properties": {
"body": {
"$ref": "#/$defs/BoldText"
},
"id": {
"type": "string"
},
"bgImageSrc": {
"type": "string"
},
"tag": {
"$ref": "#/$defs/Tag"
},
"bgImageAlt": {
"type": "string"
}
},
"required": [
"body"
],
"additionalProperties": false,
"description": "A single photo-first card inside a VisualCardBlock: a BoldText body panel, an optional Tag, and a background image (bgImageSrc must be a real URL; bgImageAlt is its alt text)."
},
"FollowUpBlock": {
"type": "object",
"properties": {
"items": {
"type": "array",
"items": {
"$ref": "#/$defs/FollowUpItem"
}
}
},
"required": [
"items"
],
"additionalProperties": false,
"description": "List of clickable follow-up suggestions placed at the end of a response"
},
"FollowUpItem": {
"type": "object",
"properties": {
"text": {
"type": "string"
}
},
"required": [
"text"
],
"additionalProperties": false,
"description": "Clickable follow-up suggestion — when clicked, sends text as user message"
},
"SectionBlock": {
"type": "object",
"properties": {
"sections": {
"type": "array",
"items": {
"$ref": "#/$defs/SectionItem"
}
},
"isFoldable": {
"type": "boolean"
}
},
"required": [
"sections"
],
"additionalProperties": false,
"description": "Collapsible accordion sections. Auto-opens sections as they stream in. Use SectionItem for each section."
},
"SectionItem": {
"type": "object",
"properties": {
"value": {
"type": "string"
},
"trigger": {
"type": "string"
},
"content": {
"type": "array",
"items": {
"anyOf": [
{
"$ref": "#/$defs/TextContent"
},
{
"$ref": "#/$defs/MarkDownRenderer"
},
{
"$ref": "#/$defs/CardHeader"
},
{
"$ref": "#/$defs/Callout"
},
{
"$ref": "#/$defs/TextCallout"
},
{
"$ref": "#/$defs/CodeBlock"
},
{
"$ref": "#/$defs/Image"
},
{
"$ref": "#/$defs/ImageBlock"
},
{
"$ref": "#/$defs/ImageGallery"
},
{
"$ref": "#/$defs/Separator"
},
{
"$ref": "#/$defs/HorizontalBarChart"
},
{
"$ref": "#/$defs/RadarChart"
},
{
"$ref": "#/$defs/PieChart"
},
{
"$ref": "#/$defs/RadialChart"
},
{
"$ref": "#/$defs/SingleStackedBarChart"
},
{
"$ref": "#/$defs/ScatterChart"
},
{
"$ref": "#/$defs/AreaChart"
},
{
"$ref": "#/$defs/BarChart"
},
{
"$ref": "#/$defs/LineChart"
},
{
"$ref": "#/$defs/Table"
},
{
"$ref": "#/$defs/TagBlock"
},
{
"$ref": "#/$defs/Form"
},
{
"$ref": "#/$defs/Buttons"
},
{
"$ref": "#/$defs/IconButton"
},
{
"$ref": "#/$defs/Steps"
},
{
"$ref": "#/$defs/InlineHeader"
},
{
"$ref": "#/$defs/EntityList"
},
{
"$ref": "#/$defs/EditableTable"
},
{
"$ref": "#/$defs/SnippetCardBlock"
},
{
"$ref": "#/$defs/OverviewCardBlock"
},
{
"$ref": "#/$defs/ContextCardBlock"
},
{
"$ref": "#/$defs/CompositeCardBlock"
},
{
"$ref": "#/$defs/VisualCardBlock"
},
{
"$ref": "#/$defs/ListBlock"
},
{
"$ref": "#/$defs/FollowUpBlock"
},
{
"$ref": "#/$defs/Tabs"
},
{
"$ref": "#/$defs/Accordion"
}
]
}
}
},
"required": [
"value",
"trigger",
"content"
],
"additionalProperties": false,
"description": "Section with a label and collapsible content — used inside SectionBlock"
},
"Tabs": {
"type": "object",
"properties": {
"items": {
"type": "array",
"items": {
"$ref": "#/$defs/TabItem"
}
}
},
"required": [
"items"
],
"additionalProperties": false,
"description": "Tabbed container"
},
"TabItem": {
"type": "object",
"properties": {
"value": {
"type": "string"
},
"trigger": {
"type": "string"
},
"content": {
"type": "array",
"items": {
"anyOf": [
{
"$ref": "#/$defs/TextContent"
},
{
"$ref": "#/$defs/MarkDownRenderer"
},
{
"$ref": "#/$defs/CardHeader"
},
{
"$ref": "#/$defs/Callout"
},
{
"$ref": "#/$defs/TextCallout"
},
{
"$ref": "#/$defs/CodeBlock"
},
{
"$ref": "#/$defs/Image"
},
{
"$ref": "#/$defs/ImageBlock"
},
{
"$ref": "#/$defs/ImageGallery"
},
{
"$ref": "#/$defs/Separator"
},
{
"$ref": "#/$defs/HorizontalBarChart"
},
{
"$ref": "#/$defs/RadarChart"
},
{
"$ref": "#/$defs/PieChart"
},
{
"$ref": "#/$defs/RadialChart"
},
{
"$ref": "#/$defs/SingleStackedBarChart"
},
{
"$ref": "#/$defs/ScatterChart"
},
{
"$ref": "#/$defs/AreaChart"
},
{
"$ref": "#/$defs/BarChart"
},
{
"$ref": "#/$defs/LineChart"
},
{
"$ref": "#/$defs/Table"
},
{
"$ref": "#/$defs/TagBlock"
},
{
"$ref": "#/$defs/Form"
},
{
"$ref": "#/$defs/Buttons"
},
{
"$ref": "#/$defs/IconButton"
},
{
"$ref": "#/$defs/Steps"
},
{
"$ref": "#/$defs/InlineHeader"
},
{
"$ref": "#/$defs/EntityList"
},
{
"$ref": "#/$defs/EditableTable"
},
{
"$ref": "#/$defs/SnippetCardBlock"
},
{
"$ref": "#/$defs/OverviewCardBlock"
},
{
"$ref": "#/$defs/ContextCardBlock"
},
{
"$ref": "#/$defs/CompositeCardBlock"
},
{
"$ref": "#/$defs/VisualCardBlock"
},
{
"$ref": "#/$defs/ListBlock"
},
{
"$ref": "#/$defs/FollowUpBlock"
},
{
"$ref": "#/$defs/Accordion"
}
]
}
}
},
"required": [
"value",
"trigger",
"content"
],
"additionalProperties": false,
"description": "value is unique id, trigger is tab label, content is array of components"
},
"Accordion": {
"type": "object",
"properties": {
"items": {
"type": "array",
"items": {
"$ref": "#/$defs/AccordionItem"
}
}
},
"required": [
"items"
],
"additionalProperties": false,
"description": "Collapsible sections"
},
"AccordionItem": {
"type": "object",
"properties": {
"value": {
"type": "string"
},
"trigger": {
"type": "string"
},
"content": {
"type": "array",
"items": {
"anyOf": [
{
"$ref": "#/$defs/TextContent"
},
{
"$ref": "#/$defs/MarkDownRenderer"
},
{
"$ref": "#/$defs/CardHeader"
},
{
"$ref": "#/$defs/Callout"
},
{
"$ref": "#/$defs/TextCallout"
},
{
"$ref": "#/$defs/CodeBlock"
},
{
"$ref": "#/$defs/Image"
},
{
"$ref": "#/$defs/ImageBlock"
},
{
"$ref": "#/$defs/ImageGallery"
},
{
"$ref": "#/$defs/Separator"
},
{
"$ref": "#/$defs/HorizontalBarChart"
},
{
"$ref": "#/$defs/RadarChart"
},
{
"$ref": "#/$defs/PieChart"
},
{
"$ref": "#/$defs/RadialChart"
},
{
"$ref": "#/$defs/SingleStackedBarChart"
},
{
"$ref": "#/$defs/ScatterChart"
},
{
"$ref": "#/$defs/AreaChart"
},
{
"$ref": "#/$defs/BarChart"
},
{
"$ref": "#/$defs/LineChart"
},
{
"$ref": "#/$defs/Table"
},
{
"$ref": "#/$defs/TagBlock"
},
{
"$ref": "#/$defs/Form"
},
{
"$ref": "#/$defs/Buttons"
},
{
"$ref": "#/$defs/IconButton"
},
{
"$ref": "#/$defs/Steps"
},
{
"$ref": "#/$defs/InlineHeader"
},
{
"$ref": "#/$defs/EntityList"
},
{
"$ref": "#/$defs/EditableTable"
},
{
"$ref": "#/$defs/SnippetCardBlock"
},
{
"$ref": "#/$defs/OverviewCardBlock"
},
{
"$ref": "#/$defs/ContextCardBlock"
},
{
"$ref": "#/$defs/CompositeCardBlock"
},
{
"$ref": "#/$defs/VisualCardBlock"
},
{
"$ref": "#/$defs/ListBlock"
},
{
"$ref": "#/$defs/FollowUpBlock"
}
]
}
}
},
"required": [
"value",
"trigger",
"content"
],
"additionalProperties": false,
"description": "value is unique id, trigger is section title"
},
"Carousel": {
"type": "object",
"properties": {
"children": {
"type": "array",
"items": {
"type": "array",
"items": {
"anyOf": [
{
"$ref": "#/$defs/TextContent"
},
{
"$ref": "#/$defs/MarkDownRenderer"
},
{
"$ref": "#/$defs/CardHeader"
},
{
"$ref": "#/$defs/Callout"
},
{
"$ref": "#/$defs/TextCallout"
},
{
"$ref": "#/$defs/CodeBlock"
},
{
"$ref": "#/$defs/Image"
},
{
"$ref": "#/$defs/ImageBlock"
},
{
"$ref": "#/$defs/ImageGallery"
},
{
"$ref": "#/$defs/Separator"
},
{
"$ref": "#/$defs/HorizontalBarChart"
},
{
"$ref": "#/$defs/RadarChart"
},
{
"$ref": "#/$defs/PieChart"
},
{
"$ref": "#/$defs/RadialChart"
},
{
"$ref": "#/$defs/SingleStackedBarChart"
},
{
"$ref": "#/$defs/ScatterChart"
},
{
"$ref": "#/$defs/AreaChart"
},
{
"$ref": "#/$defs/BarChart"
},
{
"$ref": "#/$defs/LineChart"
},
{
"$ref": "#/$defs/Table"
},
{
"$ref": "#/$defs/TagBlock"
},
{
"$ref": "#/$defs/Form"
},
{
"$ref": "#/$defs/Buttons"
},
{
"$ref": "#/$defs/IconButton"
},
{
"$ref": "#/$defs/Steps"
},
{
"$ref": "#/$defs/InlineHeader"
},
{
"$ref": "#/$defs/EntityList"
},
{
"$ref": "#/$defs/EditableTable"
},
{
"$ref": "#/$defs/SnippetCardBlock"
},
{
"$ref": "#/$defs/OverviewCardBlock"
},
{
"$ref": "#/$defs/ContextCardBlock"
},
{
"$ref": "#/$defs/CompositeCardBlock"
},
{
"$ref": "#/$defs/VisualCardBlock"
},
{
"$ref": "#/$defs/ListBlock"
},
{
"$ref": "#/$defs/FollowUpBlock"
}
]
}
}
},
"variant": {
"type": "string",
"enum": [
"card",
"sunk"
]
}
},
"required": [
"children"
],
"additionalProperties": false,
"description": "Horizontal scrollable carousel"
},
"Slice": {
"type": "object",
"properties": {
"category": {
"type": "string"
},
"value": {
"type": "number"
}
},
"required": [
"category",
"value"
],
"additionalProperties": false,
"description": "One slice with label and numeric value"
},
"Label": {
"type": "object",
"properties": {
"text": {
"type": "string"
}
},
"required": [
"text"
],
"additionalProperties": false,
"description": "Text label"
},
"SwitchGroup": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"items": {
"type": "array",
"items": {
"$ref": "#/$defs/SwitchItem"
}
},
"variant": {
"type": "string",
"enum": [
"clear",
"card",
"sunk"
]
},
"value": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": "boolean"
}
}
},
"required": [
"name",
"items"
],
"additionalProperties": false,
"description": "Group of switch toggles"
},
"SwitchItem": {
"type": "object",
"properties": {
"label": {
"type": "string"
},
"description": {
"type": "string"
},
"name": {
"type": "string"
},
"defaultChecked": {
"type": "boolean"
}
},
"required": [
"name"
],
"additionalProperties": false,
"description": "Individual switch toggle"
}
}
},
"promptOptions": {
"examples": [
"Example 1 — Informational response (the shape for \"tell me about X\" / explainer asks):\n\nroot = Card([header, intro, highlights, statsHeader, statsCards, sectionsBlock, actionBtns], [src1, src2])\nheader = CardHeader(\"Paris\", \"The City of Light · France's Eternal Capital\")\nintro = TextContent(\"Paris is one of the world's most visited cities — a timeless blend of iconic landmarks, world-class cuisine, art, and romance [1]. In 2026 the city is buzzing with new energy: the **Grand Palais** has reopened after a €466M renovation, and you can now **swim in the Seine** for the first time in over a century [2].\")\nhighlights = ContextCardBlock([h1, h2, h3], \"grid\", true, @ToAssistant(\"Tell me more about this aspect of Paris\"))\nh1 = ContextCardItem(\"art-museums\", \"Art & Museums\", \"143 museums including the Louvre & newly reopened Grand Palais.\", \"gray\", \"https://cdn.britannica.com/03/121003-050-2544BD4E/Interior-Louvre-Museum-Paris.jpg\")\nh2 = ContextCardItem(\"gastronomy\", \"Gastronomy\", \"9,000+ restaurants, 130+ Michelin stars, and the world's best baguettes.\", \"gray\")\nh3 = ContextCardItem(\"fashion-capital\", \"Fashion Capital\", \"Home to Chanel, Dior, Louis Vuitton & Hermès — the global luxury hub.\", \"gray\", \"https://thumbs.dreamstime.com/z/dior-storefront-facade-chanel-store-lvmh-s-french-designer-modehouse-christian-adjacent-to-luxury-fashion-beauty-brand-327161553.jpg\")\nstatsHeader = InlineHeader(\"Paris by the Numbers\", \"Key visitor statistics\")\nstatsCards = OverviewCardBlock([ov1, ov2, ov3], \"grid\", true)\nov1 = OverviewCardItem(\"annual-visitors\", ov1top, ov1metric)\nov1top = IconText(ov1icon, \"neutral\", \"m\", \"Annual Visitors\", \"2024 arrivals\", false, \"vertical\")\nov1icon = Icon(\"users\", \"people\")\nov1metric = MetricIndicatorInline(\"48.7M\", \"tourists\", { direction: \"up\", value: 2.5 })\nov2 = OverviewCardItem(\"museums-monuments\", ov2top, ov2metric)\nov2top = IconText(ov2icon, \"neutral\", \"m\", \"Museums & Monuments\", \"Cultural sites\", false, \"vertical\")\nov2icon = Icon(\"landmark\", \"buildings\")\nov2metric = MetricIndicatorInline(\"2,370+\", \"across the city\")\nov3 = OverviewCardItem(\"tourism-revenue\", ov3top, ov3metric)\nov3top = IconText(ov3icon, \"neutral\", \"m\", \"Tourism Revenue\", \"2024 estimate\", false, \"vertical\")\nov3icon = Icon(\"circle-dollar-sign\", \"finance\")\nov3metric = MetricIndicatorInline(\"€23.4B\", \"generated\")\nsectionsBlock = SectionBlock([secLandmarks, secFood, secWhen], false)\nsecLandmarks = SectionItem(\"landmarks\", \"Iconic Landmarks\", [landmarksCarousel])\nlandmarksCarousel = VisualCardBlock([lm1, lm2, lm3, lm4], \"carousel\", true, @ToAssistant(\"Tell me more about this Paris landmark\"))\nlm1 = VisualCardItem(lm1body, \"eiffel-tower\", \"https://c8.alamy.com/comp/RYEB13/aerial-view-of-the-eiffel-tower-with-the-park-champ-de-mars-and-the-river-seine-paris-france-RYEB13.jpg\", lm1tag, \"Aerial view of the Eiffel Tower\")\nlm1body = BoldText(\"text\", \"Eiffel Tower\", \"Open daily 9am–midnight\")\nlm1tag = Tag(\"Must-See\", lm1tagIcon, \"sm\", \"info\")\nlm1tagIcon = Icon(\"star\", \"shapes\")\nlm2 = VisualCardItem(lm2body, \"the-louvre\", \"https://images.fineartamerica.com/images/artworkimages/mediumlarge/3/1-exterior-of-musee-du-louvre-museum-paris-france-bernard-jaubert.jpg\", lm2tag, \"Exterior of the Louvre museum\")\nlm2body = BoldText(\"text\", \"The Louvre\", \"World's largest art museum\")\nlm2tag = Tag(\"8.9M visits/yr\", lm2tagIcon, \"sm\", \"success\")\nlm2tagIcon = Icon(\"trending-up\", \"charts\")\nlm3 = VisualCardItem(lm3body, \"notre-dame\", \"https://cdn.britannica.com/29/255529-050-63A22A3C/notre-dame-de-paris-cathedral-paris-france.jpg\", lm3tag, \"Notre-Dame cathedral facade\")\nlm3body = BoldText(\"text\", \"Notre-Dame\", \"Fully restored cathedral\")\nlm3tag = Tag(\"Reopened 2024\", lm3tagIcon, \"sm\", \"warning\")\nlm3tagIcon = Icon(\"hammer\", \"tools\")\nlm4 = VisualCardItem(lm4body, \"versailles\", \"https://cdn.britannica.com/76/130076-050-31128A3D/Latona-Fountain-Balthazard-Marsy-Gaspard-Andre-Le.jpg\", lm4tag, \"Latona Fountain at Versailles\")\nlm4body = BoldText(\"text\", \"Palace of Versailles\", \"Royal gardens & grand halls\")\nlm4tag = Tag(\"Day Trip\", lm4tagIcon, \"sm\", \"neutral\")\nlm4tagIcon = Icon(\"train-front\", \"travel\")\nsecFood = SectionItem(\"food\", \"Food & Drink\", [foodCards])\nfoodCards = ContextCardBlock([f1, f2, f3], \"grid\", true, @ToAssistant(\"Tell me more about eating and drinking in Paris\"))\nf1 = ContextCardItem(\"bistros\", \"Bistros\", \"Classic French fare — try Les Arlots for confit beef cheeks.\", \"gray\", \"https://everydayparisian.com/wp-content/uploads/2023/01/IMG_0221-768x1024.webp\")\nf2 = ContextCardItem(\"fine-dining\", \"Fine Dining\", \"Septime leads a new wave of creative Michelin-starred cuisine.\", \"gray\", \"https://production-data.worldofmouth.app/images/72b2e6db-97ea-49c4-aa5d-3b7c8121c812.jpg\")\nf3 = ContextCardItem(\"bakeries\", \"Bakeries\", \"Shinya Pain for sourdough. Grand Prix-winning baguettes citywide.\", \"gray\", \"https://www.davidlebovitz.com/wp-content/uploads/2018/09/Le-petit-grain-paris-bakery-boulangerie-patisserie-pastry-shop-8-640x895.jpg\")\nsecWhen = SectionItem(\"when\", \"Best Time to Visit\", [whenTabs])\nwhenTabs = Tabs([tabSpring, tabSummer])\ntabSpring = TabItem(\"spring\", \"Spring\", [springList])\nspringList = ListBlock([sp1, sp2, sp3], \"number\")\nsp1 = ListItem(\"Cherry blossoms at Parc de Sceaux\", \"March – May\", null, null, @ToAssistant(\"Tell me about cherry blossom season in Paris\"))\nsp2 = ListItem(\"Picnics along the Seine & in city parks\", \"Warm, lively atmosphere\", null, null, @ToAssistant(\"Where are the best picnic spots in Paris?\"))\nsp3 = ListItem(\"Fewer crowds than summer\", \"Ideal for sightseeing\", null, null, @ToAssistant(\"How busy is Paris in spring?\"))\ntabSummer = TabItem(\"summer\", \"Summer\", [summerList])\nsummerList = ListBlock([su1, su2, su3], \"number\")\nsu1 = ListItem(\"Swim in the Seine — open July & August 2026\", \"First time in 102 years\", null, null, @ToAssistant(\"Tell me about swimming in the Seine\"))\nsu2 = ListItem(\"Open-air cinema at Parc de la Villette\", \"Free films under the stars\", null, null, @ToAssistant(\"Tell me about the open-air cinema at Parc de la Villette\"))\nsu3 = ListItem(\"Bastille Day celebrations on July 14\", \"Fireworks at the Eiffel Tower\", null, null, @ToAssistant(\"What happens in Paris on Bastille Day?\"))\nactionBtns = Buttons([btn1, btn2, btn3], \"row\")\nbtn1 = Button(\"Plan a Trip to Paris\", @ToAssistant(\"Help me plan a trip to Paris\"), \"primary\")\nbtn2 = Button(\"Best Hotels in Paris\", @ToAssistant(\"Show me the best hotels in Paris\"), \"secondary\")\nbtn3 = Button(\"Build a Paris Itinerary\", @ToAssistant(\"Build a 5-day Paris itinerary for me\"), \"secondary\")\nsrc1 = { title: \"Paris Travel Guide 2025\", sourceName: \"Travel and Tour World\", url: \"https://www.travelandtourworld.com/news/article/from-iconic-landmarks-to-hidden-gems-the-ultimate-paris-travel-guide-for-2025-you-need-to-read-now/\" }\nsrc2 = { title: \"Best Things to Do in Paris 2026\", sourceName: \"Time Out Paris\", url: \"http://www.timeout.fr/paris/en/for-tourists\" }",
"Example 2 — Data and analytics response (quantitative asks lead with KPIs and charts):\n\nroot = Card([pageHeader, kpiBlock, sections, deepDiveHeader, compositeCards, actionButtons])\npageHeader = CardHeader(\"Analytics Dashboard\", \"April 2026 · Business Performance Overview\")\nkpiBlock = SnippetCardBlock([kpi1, kpi2, kpi3, kpi4], \"grid\", true)\nkpi1 = SnippetCardItem(\"total-revenue\", kpi1lhs, kpi1rhs)\nkpi1lhs = IconText(kpi1icon, \"neutral\", \"m\", \"Total Revenue\", \"Month to date\", false, \"horizontal\")\nkpi1icon = Icon(\"circle-dollar-sign\", \"finance\")\nkpi1rhs = BoldText(\"number\", \"$284,500\", \"+12.4%\", \"metric\")\nkpi2 = SnippetCardItem(\"active-users\", kpi2lhs, kpi2rhs)\nkpi2lhs = IconText(kpi2icon, \"neutral\", \"m\", \"Active Users\", \"Monthly active users\", false, \"horizontal\")\nkpi2icon = Icon(\"users\", \"people\")\nkpi2rhs = BoldText(\"number\", \"47,320\", \"+6.8%\", \"metric\")\nkpi3 = SnippetCardItem(\"conversion-rate\", kpi3lhs, kpi3rhs)\nkpi3lhs = IconText(kpi3icon, \"neutral\", \"m\", \"Conversion Rate\", \"Avg. this month\", false, \"horizontal\")\nkpi3icon = Icon(\"trending-up\", \"charts\")\nkpi3rhs = BoldText(\"number\", \"5.7%\", \"+0.9%\", \"metric\")\nkpi4 = SnippetCardItem(\"churn-rate\", kpi4lhs, kpi4rhs)\nkpi4lhs = IconText(kpi4icon, \"neutral\", \"m\", \"Churn Rate\", \"Monthly customer churn\", false, \"horizontal\")\nkpi4icon = Icon(\"user-minus\", \"people\")\nkpi4rhs = BoldText(\"number\", \"2.1%\", \"-0.4%\", \"metric\")\nsections = SectionBlock([secUsers, secChannels], false)\nsecUsers = SectionItem(\"users\", \"User Activity\", [userTabs])\nuserTabs = Tabs([tabGrowth, tabRetention])\ntabGrowth = TabItem(\"growth\", \"User Growth\", [growthChart])\ngrowthChart = LineChart(months, [dauSeries, mauSeries], \"natural\", \"Month\", \"Users (k)\")\nmonths = [\"May\", \"Jun\", \"Jul\", \"Aug\", \"Sep\", \"Oct\", \"Nov\", \"Dec\", \"Jan\", \"Feb\", \"Mar\", \"Apr\"]\ndauSeries = Series(\"DAU\", [5.1, 5.4, 5.8, 6.2, 6.7, 7.1, 7.6, 8.0, 8.4, 8.9, 9.3, 9.8])\nmauSeries = Series(\"MAU\", [28.4, 30.1, 31.8, 33.5, 35.2, 37.1, 38.8, 40.4, 42.1, 43.9, 45.6, 47.3])\ntabRetention = TabItem(\"retention\", \"Cohort Retention\", [retentionChart])\nretentionChart = LineChart(cohortMonths, [cohortJan, cohortFeb, cohortMar], \"natural\", \"Month Since Signup\", \"Retention (%)\")\ncohortMonths = [\"Month 0\", \"Month 1\", \"Month 2\", \"Month 3\", \"Month 4\", \"Month 5\", \"Month 6\"]\ncohortJan = Series(\"Jan Cohort\", [100, 80, 70, 62, 56, 51, 47])\ncohortFeb = Series(\"Feb Cohort\", [100, 83, 73, 65, 59, 54, 50])\ncohortMar = Series(\"Mar Cohort\", [100, 86, 76, 68, 62, 0, 0])\nsecChannels = SectionItem(\"channels\", \"Acquisition Channels\", [channelTabs])\nchannelTabs = Tabs([tabChannelBar, tabChannelTable])\ntabChannelBar = TabItem(\"channel-bar\", \"Revenue by Channel\", [channelBarChart])\nchannelBarChart = HorizontalBarChart(channels, [channelSeries], \"grouped\", \"Revenue ($k)\", \"Channel\")\nchannels = [\"Organic Search\", \"Paid Ads\", \"Referral Program\", \"Partner Network\", \"Direct / Brand\", \"Email Campaigns\"]\nchannelSeries = Series(\"Revenue ($k)\", [82.4, 68.1, 54.6, 38.2, 26.8, 14.4])\ntabChannelTable = TabItem(\"channel-table\", \"Full Breakdown\", [channelTable])\nchannelTable = Table([colChannel, colLeads, colConv, colCac, colRevenue, colStatus])\ncolChannel = Col(\"Channel\", channels, \"string\")\ncolLeads = Col(\"Leads\", [4210, 3180, 2050, 1120, 1290, 820], \"number\")\ncolConv = Col(\"Conv. Rate\", [\"6.4%\", \"5.1%\", \"9.4%\", \"11.8%\", \"5.8%\", \"8.1%\"], \"string\")\ncolCac = Col(\"CAC ($)\", [188, 395, 132, 109, 218, 154], \"number\")\ncolRevenue = Col(\"Revenue ($k)\", [82.4, 68.1, 54.6, 38.2, 26.8, 14.4], \"number\")\ncolStatus = Col(\"Status\", [\"Scaling\", \"Optimizing\", \"Scaling\", \"Growing\", \"Stable\", \"Stable\"], \"string\")\ndeepDiveHeader = InlineHeader(\"Support Health & Marketing ROI\", \"Click a card to explore deeper insights\")\ncompositeCards = CompositeCardBlock([cardSupport, cardMarketing], \"grid\", true, @ToAssistant(\"Explore this deep-dive area in more detail\"))\ncardSupport = CompositeCardItem(\"support-health\", supportHeader, [supportMetric, supportChart, supportList])\nsupportHeader = IconText(supportIcon, \"neutral\", \"m\", \"Support Health\", \"Ticket volume & resolution trends\", false, \"horizontal\")\nsupportIcon = Icon(\"headphones\", \"communication\")\nsupportMetric = MetricIndicatorInline(\"94.2% CSAT\", \"Customer Satisfaction Score\", { direction: \"up\", value: 2.1 })\nsupportChart = BarChart([\"Jan\", \"Feb\", \"Mar\", \"Apr\"], [openSeries, resolvedSeries], \"grouped\", \"Month\", \"Tickets\")\nopenSeries = Series(\"Opened\", [341, 327, 308, 289])\nresolvedSeries = Series(\"Resolved\", [319, 318, 301, 283])\nsupportList = EntityList([sup1, sup2, sup3], \"small\")\nsup1 = { left: \"Avg. Resolution Time\", right: \"4h 12m\", rightVariant: \"text\" }\nsup2 = { left: \"First Contact Resolution\", right: \"78.4%\", rightVariant: \"number\" }\nsup3 = { left: \"Escalation Rate\", right: \"6.2%\", rightVariant: \"number\" }\ncardMarketing = CompositeCardItem(\"marketing-roi\", marketingHeader, [marketingMetric, marketingChart, marketingList])\nmarketingHeader = IconText(marketingIcon, \"neutral\", \"m\", \"Marketing ROI\", \"Spend vs. pipeline generated\", false, \"horizontal\")\nmarketingIcon = Icon(\"megaphone\", \"communication\")\nmarketingMetric = MetricIndicatorInline(\"3.8x Blended ROI\", \"Return on Ad Spend\", { direction: \"up\", value: 0.4 })\nmarketingChart = AreaChart([\"Jan\", \"Feb\", \"Mar\", \"Apr\"], [spendSeries, pipelineSeries], \"natural\", \"Month\", \"Value ($k)\")\nspendSeries = Series(\"Ad Spend\", [44.0, 46.8, 49.2, 51.6])\npipelineSeries = Series(\"Pipeline Generated\", [158.2, 171.5, 184.9, 196.1])\nmarketingList = EntityList([mkt1, mkt2, mkt3], \"small\")\nmkt1 = { left: \"Total Ad Spend (Apr)\", right: \"$51,600\", rightVariant: \"number\" }\nmkt2 = { left: \"Cost per Lead\", right: \"$48.20\", rightVariant: \"number\" }\nmkt3 = { left: \"Top Channel\", right: \"Organic Search\", rightVariant: \"text\" }\nactionButtons = Buttons([btnChannels, btnForecast], \"row\")\nbtnChannels = Button(\"Break Down by Channel\", @ToAssistant(\"Break down this month's revenue by acquisition channel\"), \"primary\")\nbtnForecast = Button(\"Forecast Next Quarter\", @ToAssistant(\"Forecast revenue and active users for next quarter\"), \"secondary\")",
"Example 3 — Form response (help-me-choose/plan asks: inspiration cards FIRST, then a compact form). The inspiration-card images below came from an image tool call — include such cards ONLY when you have real URLs; with no real URLs, start directly with the form:\n\nroot = Card([header, intro, inspoCards, form])\nheader = CardHeader(\"Plan Your Trip\", \"A few ideas to spark inspiration — then tell me your preferences\")\nintro = TextContent(\"Tap a style to jump straight in, or fill the quick form below for a tailored plan.\")\ninspoCards = VisualCardBlock([insp1, insp2], \"grid\", true, @ToAssistant(\"Plan me a trip in this style with destinations, itinerary, and costs\"))\ninsp1 = VisualCardItem(insp1body, \"inspo-beach\", \"https://www.travelandleisure.com/thmb/cuAB7XMQ6s_Gji-no956KNopT7M=/1500x0/filters:no_upscale():max_bytes(150000):strip_icc()/TAL-maldives-TROPVACAY0325-1b5047d5931d4850b47d082966f9f563.jpg\", insp1tag, \"Maldives overwater villas\")\ninsp1body = BoldText(\"text\", \"Tropical Beach Escape\", \"Overwater villas & snorkeling\")\ninsp1tag = Tag(\"Relaxation\", insp1icon, \"sm\", \"info\")\ninsp1icon = Icon(\"umbrella\", \"travel\")\ninsp2 = VisualCardItem(insp2body, \"inspo-mountain\", \"https://www.salkantaytrekmachu.com/img/adventure-travel-peru-032.jpg\", insp2tag, \"Trekking in the Peruvian Andes\")\ninsp2body = BoldText(\"text\", \"Mountain Adventure\", \"Trekking & epic views\")\ninsp2tag = Tag(\"Active\", insp2icon, \"sm\", \"warning\")\ninsp2icon = Icon(\"mountain\", \"nature\")\nform = Form(\"trip-planner\", formButtons, [fcDestination, fcDates, fcTravellers, fcTripType, fcBudget, fcStay, fcNotes])\nformButtons = Buttons([btnSubmit, btnSkip], \"row\")\nbtnSubmit = Button(\"Plan My Trip\", @ToAssistant(\"Help me plan a trip based on my form submission\"), \"primary\")\nbtnSkip = Button(\"Just Surprise Me\", @ToAssistant(\"Skip the form and surprise me with a destination and itinerary\"), \"secondary\")\nfcDestination = FormControl(\"Destination\", destinationInput, \"Leave blank if you'd like suggestions\")\ndestinationInput = Input(\"destination\", \"e.g. Tokyo, Japan — or leave blank\", \"text\")\nfcDates = FormControl(\"Travel Dates\", datesPicker, \"Select your start and end dates\")\ndatesPicker = DatePicker(\"travel-dates\", \"range\", { required: true })\nfcTravellers = FormControl(\"Number of Travellers\", travellersSelect, \"How many people are travelling?\")\ntravellersSelect = Select(\"num-travellers\", [tr1, tr2, tr3, tr4], \"Select number of travellers\", { required: true })\ntr1 = SelectItem(\"1\", \"1 — Solo\")\ntr2 = SelectItem(\"2\", \"2 — Couple\")\ntr3 = SelectItem(\"3-4\", \"3–4 People\")\ntr4 = SelectItem(\"5+\", \"5+ People\")\nfcTripType = FormControl(\"Trip Type\", tripTypeCards, \"What kind of trip are you planning?\")\ntripTypeCards = OptionCards(\"trip-type\", \"single\", [oc1, oc2, oc3, oc4], { required: true })\noc1 = OptionCard(\"adventure\", \"Adventure\", \"Hiking, trekking & outdoor activities\", oc1icon)\noc1icon = Icon(\"mountain\", \"nature\")\noc2 = OptionCard(\"beach\", \"Beach & Relaxation\", \"Sun, sand & leisure\", oc2icon)\noc2icon = Icon(\"waves\", \"nature\")\noc3 = OptionCard(\"cultural\", \"Cultural & Historical\", \"Museums, heritage & local experiences\", oc3icon)\noc3icon = Icon(\"landmark\", \"buildings\")\noc4 = OptionCard(\"city\", \"City Break\", \"Urban exploration & nightlife\", oc4icon)\noc4icon = Icon(\"building-2\", \"buildings\")\nfcBudget = FormControl(\"Estimated Budget (per person)\", budgetSlider, \"Drag to set your per-person budget in USD\")\nbudgetSlider = Slider(\"budget\", \"discrete\", 500, 10000, 500, [2500], \"Budget (USD)\")\nfcStay = FormControl(\"Accommodation Preference\", stayChips, \"Select all that apply\")\nstayChips = Chips(\"accommodation\", \"multiple\", [ch1, ch2, ch3, ch4], {}, [\"hotel\"])\nch1 = ChipItem(\"hotel\", \"Hotel\", ch1icon)\nch1icon = Icon(\"building\", \"buildings\")\nch2 = ChipItem(\"resort\", \"Resort\", ch2icon)\nch2icon = Icon(\"umbrella\", \"travel\")\nch3 = ChipItem(\"airbnb\", \"Vacation Rental\", ch3icon)\nch3icon = Icon(\"home\", \"home\")\nch4 = ChipItem(\"camping\", \"Camping / Glamping\", ch4icon)\nch4icon = Icon(\"tent\", \"nature\")\nfcNotes = FormControl(\"Special Requests or Notes\", notesArea, \"Any dietary needs, accessibility requirements, or specific interests?\")\nnotesArea = TextArea(\"special-requests\", \"e.g. vegetarian meals, wheelchair access, honeymoon surprise...\", 4)",
"Example 4 — Recommendations with images and links (same pattern for products, movies, restaurants, articles):\n\nroot = Card([header, intro, posters, linksHeader, trackCards], [src1, src2])\nheader = CardHeader(\"Retro-Energetic Indian Tracks\", \"New Hindi releases with 80s/90s dance DNA\")\nintro = TextContent(\"These recent tracks channel retro synths and 90s party percussion [1][2]. Tap a poster to explore a track, or use its button to watch the exact official video.\")\nposters = VisualCardBlock([v1, v2], \"grid\", true, @ToAssistant(\"Tell me more about this track and its retro influences\"))\nv1 = VisualCardItem(v1body, \"tamma\", \"https://i.ytimg.com/vi/PQHeOb0Q9oo/hq720.jpg\", v1tag, \"Tamma Tamma video poster\")\nv1body = BoldText(\"text\", \"Tamma Tamma\", \"Dhurandhar · Ranveer Singh\")\nv1tag = Tag(\"80s Electro-Disco\", v1icon, \"sm\", \"success\")\nv1icon = Icon(\"disc-3\", \"multimedia\")\nv2 = VisualCardItem(v2body, \"sajan\", \"https://i.ytimg.com/vi/mLz-qBiRnl8/hq720.jpg\", v2tag, \"Sajan Re video poster\")\nv2body = BoldText(\"text\", \"Sajan Re\", \"Nora Fatehi · Badshah\")\nv2tag = Tag(\"Synthwave Electro\", v2icon, \"sm\", \"info\")\nv2icon = Icon(\"music\", \"multimedia\")\nlinksHeader = InlineHeader(\"Watch the Exact Videos\", \"Each button opens that track's official video\")\ntrackCards = CompositeCardBlock([t1, t2], \"grid\", true)\nt1 = CompositeCardItem(\"t-tamma\", t1h, [t1body, t1tags], { button: t1btn })\nt1h = IconText(t1icon, \"neutral\", \"m\", \"Tamma Tamma\", \"Bappi Lahiri classic, electro-funk rework\", true, \"horizontal\")\nt1icon = Icon(\"disc-3\", \"multimedia\")\nt1body = Text(\"text\", \"Heavy analog synths and brass over a fast disco groove.\", \"Retro Electro-Disco\")\nt1tags = TagBlock([\"2026 Film Hit\", \"Peak Party\"])\nt1btn = Button(\"Watch on YouTube\", @OpenUrl(\"https://www.youtube.com/watch?v=PQHeOb0Q9oo\"), \"primary\")\nt2 = CompositeCardItem(\"t-sajan\", t2h, [t2body, t2tags], { button: t2btn })\nt2h = IconText(t2icon, \"neutral\", \"m\", \"Sajan Re\", \"Nora Fatehi · Badshah · Sanjoy\", true, \"horizontal\")\nt2icon = Icon(\"music\", \"multimedia\")\nt2body = Text(\"text\", \"Synthwave melody hooks over a modern club beat.\", \"Retro-Fusion Electro\")\nt2tags = TagBlock([\"Club Anthem\", \"Nora x Badshah\"])\nt2btn = Button(\"Watch on YouTube\", @OpenUrl(\"https://www.youtube.com/watch?v=COUSCnFazzc\"), \"primary\")\nsrc1 = { title: \"Tamma Tamma (Full Video) - Dhurandhar\", sourceName: \"YouTube (T-Series)\", url: \"https://www.youtube.com/watch?v=PQHeOb0Q9oo\" }\nsrc2 = { title: \"Sajan Re (Official Music Video)\", sourceName: \"YouTube (T-Series)\", url: \"https://www.youtube.com/watch?v=COUSCnFazzc\" }",
"Example 5 — Table with follow-ups:\n\nroot = Card([title, tbl, followUps])\ntitle = TextContent(\"Top Languages\", \"large-heavy\")\ntbl = Table([Col(\"Language\", langs), Col(\"Users (M)\", users), Col(\"Year\", years)])\nlangs = [\"Python\", \"JavaScript\", \"Java\"]\nusers = [15.7, 14.2, 12.1]\nyears = [1991, 1995, 1995]\nfollowUps = FollowUpBlock([fu1, fu2])\nfu1 = FollowUpItem(\"Tell me more about Python\")\nfu2 = FollowUpItem(\"Show me a JavaScript comparison\")"
],
"additionalRules": [
"When asked about data, generate realistic/plausible data",
"Every response is a single Card(children) — children stack vertically automatically. No layout params are needed on Card.",
"Card is the only layout container. Do NOT use Stack. Use Tabs to switch between sections, Carousel for horizontal scroll.",
"Use FollowUpBlock at the END of a Card to suggest what the user can do or ask next.",
"Use ListBlock when presenting a set of options or steps; give each ListItem an action (5th argument) to make it clickable — without one the item is plain text.",
"Use SectionBlock to group long responses into collapsible sections — good for reports, FAQs, and structured content.",
"Use SectionItem inside SectionBlock: each item needs a unique value id, a trigger (header label), and a content array.",
"Carousel takes an array of slides, where each slide is an array of content: carousel = Carousel([[t1, img1], [t2, img2]])",
"IMPORTANT: Every slide in a Carousel must use the same component structure in the same order — e.g. all slides: [title, image, description, tags].",
"For forms, define one FormControl reference per field so controls can stream progressively.",
"For forms, always provide the second Form argument with Buttons(...) actions: Form(name, buttons, fields).",
"Never nest Form inside Form.",
"CardHeader is the page-level heading — place it as the first child of Card; InlineHeader is a lighter subsection label for a block inside the response, and is redundant when the following component already has a heading.",
"Never use Callout or TextCallout to justify why you did what you did or for any meta-information.",
"Every image slot (Image, ImageBlock, ImageGallery, VisualCardItem/ContextCardItem bgImageSrc, ImageText, ImageTextLarge, ListItem image) requires a REAL URL from a tool result, the conversation, or the user — NEVER invent, guess, or template a URL.",
"If no image URL is in context, compose without image components — icons, gray ContextCardItems, and charts still make rich layouts.",
"Argument-order trap: Image takes alt FIRST, while ImageBlock, ImageText, and ImageTextLarge take src FIRST — alt text in a src slot ships a broken image.",
"Card blocks (SnippetCardBlock, OverviewCardBlock, ContextCardBlock, CompositeCardBlock, VisualCardBlock) need at least 2 items, all with the same structure; use layout \"grid\" for primary side-by-side comparison and \"carousel\" for secondary browsing.",
"The card-block action is BLOCK-LEVEL: one action shared by every card, with the clicked card's details attached automatically — keep the @ToAssistant message generic (e.g. \"Tell me more about this destination\"), and never use a block-level @OpenUrl since it would send every card to the same URL.",
"Card items have NO per-item action: to give each item its own external link, use CompositeCardItem with footer { button: Button(label, @OpenUrl(url)) } — never claim a card opens a link it cannot.",
"Text, BoldText, IconText, ImageText, ImageTextLarge and MetricIndicator* are inline building blocks used INSIDE card items — do not place them directly in the root Card.",
"EntityList size \"small\" is reserved for CompositeCardItem body content (no header/footer); use size \"default\" elsewhere.",
"Tag variant must be semantically correct (success=positive, danger=negative, warning=cautionary, info=informational, neutral=label); Tag takes an optional Icon second, so use Tag(text, icon, size, variant) when a variant is needed.",
"TagBlock takes plain strings — keep it to at most 3 tags.",
"ListBlock variant \"number\" is for ordered sequences and rankings, \"image\" for products/profiles with a real image; Steps is for ordered sequential processes only.",
"Use SectionBlock to divide a long response into independent, equally prominent topics; use Tabs when the items are alternative views of the same thing; set isFoldable=false unless a section has 4+ distinct blocks; never make SectionBlock the first Card child.",
"Accordion is for supplementary or FAQ content only — never primary information, 3-5 items max, and always the last component in its section or card.",
"Charts: LineChart/AreaChart variant \"natural\" for smooth trends and \"linear\" for precise point-to-point data; BarChart \"grouped\" for side-by-side comparison and \"stacked\" for part-to-whole; prefer HorizontalBarChart when category labels are long or numerous.",
"For large chart values, scale the data and put the unit in the axis label (e.g. yLabel \"Revenue ($k)\") instead of passing raw thousands or millions.",
"Quantitative asks get a chart (plus KPI cards where useful) in the FIRST response — do not answer numbers with prose or a table alone.",
"Table is column-oriented: each Col holds its own data array of plain strings or numbers (never components), and every column's array must have the same length.",
"Use EditableTable ONLY when the user or app explicitly asks for an editable table; default to Table for read-only data.",
"Every Form MUST have EXACTLY ONE submit Button with variant \"primary\" — that button validates the form; other buttons (secondary/tertiary escape hatches like \"Just Surprise Me\") skip validation, and there is never a reset button.",
"Prefer structured inputs (Select, Chips, OptionCards, DatePicker, Slider) over free-text Input, give every FormControl a clear label (and a hint where it prevents mistakes), and keep each field name unique within the response.",
"Validation rules ({ required: true, email: true, minLength: 8, ... }) are enforced with inline errors — use them for genuinely essential fields, but never require a free-text field where leaving it blank is meaningful.",
"Form inputs work ONLY inside a FormControl within a Form; for tappable suggestion choices OUTSIDE a form, use Buttons whose Button actions are @ToAssistant, never a bare OptionCards or Chips.",
"Only add Buttons for real actions: form submit, @OpenUrl with a URL from a tool or the user (never fabricated), or a @ToAssistant follow-up. Never add a button for an app action (open, download, export, edit) you cannot perform.",
"Every Button label must accurately describe what clicking it does; use \"primary\" for the main action and \"secondary\"/\"tertiary\" only for lower-emphasis supporting actions.",
"Icon: always include the category argument — it enables fallback matching when the exact lucide name is unavailable.",
"Pass sources on Card ONLY when the answer relies on real references you actually have, and cite them inline in TextContent as [1], [2] (1-based index into sources)."
]
}
}