The Open Standard for Generative UI
Update docs to latest lang-core API (#1222)
ABbda5ef58dcc0
diff --git a/docs/app/api/chat/route.ts b/docs/app/api/chat/route.tsindex b70b0e80c..3006e3365 100644--- a/docs/app/api/chat/route.ts+++ b/docs/app/api/chat/route.ts@@ -1,13 +1,19 @@+import { generateSystemPrompt, type LibrarySpec } from "@openuidev/lang-core";+import { openuiChatPromptOptions } from "@openuidev/react-ui/genui-lib/prompt-options";import { readFileSync } from "fs";import { NextRequest } from "next/server";import OpenAI from "openai";import type { ChatCompletionMessageParam } from "openai/resources/chat/completions.mjs";import { join } from "path";-const openUiSystemPrompt = readFileSync(- join(process.cwd(), "generated/chat-system-prompt.txt"),- "utf-8",-);+const librarySpec = JSON.parse(+ readFileSync(join(process.cwd(), "generated/chat-library.spec.json"), "utf-8"),+) as LibrarySpec;++const openUiSystemPrompt = generateSystemPrompt({+ library: librarySpec,+ promptOptions: openuiChatPromptOptions,+});const markdownSystemPrompt = `You are a helpful assistant. Respond using clear, well-structured GitHub-Flavored Markdown.diff --git a/docs/app/api/demo/github/stream/route.ts b/docs/app/api/demo/github/stream/route.tsindex e5f96bd52..80887472a 100644--- a/docs/app/api/demo/github/stream/route.ts+++ b/docs/app/api/demo/github/stream/route.ts@@ -3,7 +3,7 @@ import {isDemoCreditsExhaustedError,} from "@/lib/demo-credits";import { BASE_URL } from "@/lib/source";-import { generatePrompt, type PromptSpec } from "@openuidev/lang-core";+import { generateSystemPrompt, type LibrarySpec } from "@openuidev/lang-core";import { readFileSync } from "fs";import { type NextRequest } from "next/server";import { join } from "path";@@ -15,25 +15,27 @@ import {} from "../../../../demo/github/github/prompt-config";import { GITHUB_TOOL_SPECS } from "../../../../demo/github/github/types";-// ── Component spec from generated JSON ────────────────────────────────────+// ── Library spec from `openui generate --spec` ────────────────────────────-const componentSpec = JSON.parse(- readFileSync(join(process.cwd(), "generated/playground-component-spec.json"), "utf-8"),-) as PromptSpec;+const librarySpec = JSON.parse(+ readFileSync(join(process.cwd(), "generated/playground-library.spec.json"), "utf-8"),+) as LibrarySpec;// ── GitHub system prompt ──────────────────────────────────────────────────function buildGitHubPrompt(): string {- return generatePrompt({- ...componentSpec,- tools: GITHUB_TOOL_SPECS,- toolExamples: GITHUB_TOOL_EXAMPLES,- additionalRules: GITHUB_ADDITIONAL_RULES,- preamble: GITHUB_PREAMBLE,- editMode: true,- inlineMode: true,- toolCalls: true,- bindings: true,+ return generateSystemPrompt({+ library: librarySpec,+ promptOptions: {+ tools: GITHUB_TOOL_SPECS,+ toolExamples: GITHUB_TOOL_EXAMPLES,+ additionalRules: GITHUB_ADDITIONAL_RULES,+ preamble: GITHUB_PREAMBLE,+ editMode: true,+ inlineMode: true,+ toolCalls: true,+ bindings: true,+ },});}diff --git a/docs/app/api/playground/stream/route.ts b/docs/app/api/playground/stream/route.tsindex a5e931a44..17eb450d5 100644--- a/docs/app/api/playground/stream/route.ts+++ b/docs/app/api/playground/stream/route.ts@@ -3,14 +3,20 @@ import {isDemoCreditsExhaustedError,} from "@/lib/demo-credits";import { BASE_URL } from "@/lib/source";+import { generateSystemPrompt, type LibrarySpec } from "@openuidev/lang-core";+import { openuiExamples } from "@openuidev/react-ui/genui-lib/prompt-options";import { readFileSync } from "fs";import { type NextRequest } from "next/server";import { join } from "path";-const systemPrompt = readFileSync(- join(process.cwd(), "generated/playground-system-prompt.txt"),- "utf-8",-);+const librarySpec = JSON.parse(+ readFileSync(join(process.cwd(), "generated/playground-library.spec.json"), "utf-8"),+) as LibrarySpec;++const systemPrompt = generateSystemPrompt({+ library: librarySpec,+ promptOptions: { examples: openuiExamples },+});const conversationLog: Array<{ role: string; content: string }> = [];diff --git a/docs/generated/chat-library.spec.json b/docs/generated/chat-library.spec.jsonnew file mode 100644index 000000000..94fd48a37--- /dev/null+++ b/docs/generated/chat-library.spec.json@@ -0,0 +1,4758 @@+{+ "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 continue_conversation action, sends text to the LLM as a user message.",+ "- Example: list = ListBlock([item1, item2]) item1 = ListItem(\"Option A\", \"Details about A\", null, null, { type: \"continue_conversation\", context: \"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": {+ "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+ }+ ]+ },+ "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"+ },+ "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": {+ "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+ }+ ]+ },+ "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": {+ "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+ }+ ]+ },+ "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": {+ "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+ }+ ]+ },+ "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": {+ "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+ }+ ]+ },+ "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": {+ "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+ }+ ]+ },+ "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": {+ "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+ }+ ]+ }+ },+ "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": {+ "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+ }+ ]+ },+ "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"+ }+ }+ }+}diff --git a/docs/generated/chat-system-prompt.txt b/docs/generated/chat-system-prompt.txtdeleted file mode 100644index dfca18958..000000000--- a/docs/generated/chat-system-prompt.txt+++ /dev/null@@ -1,223 +0,0 @@-You are an AI assistant that responds using openui-lang, a declarative UI language. Your ENTIRE response must be valid openui-lang code — no markdown, no explanations, just openui-lang.--## Syntax Rules--1. Each statement is on its own line: `identifier = Expression`-2. `root` is the entry point — every program must define `root = Card(...)`-3. Expressions are: strings ("..."), numbers, booleans (true/false), null, arrays ([...]), objects ({...}), or component calls TypeName(arg1, arg2, ...)-4. Use references for readability: define `name = ...` on one line, then use `name` later-5. EVERY variable (except root) MUST be referenced by at least one other variable. Unreferenced variables are silently dropped and will NOT render. Always include defined variables in their parent's children/items array.-6. Arguments are POSITIONAL (order matters, not names). Write `SomeComp([children], "row", "l")` NOT `SomeComp([children], direction: "row", gap: "l")` — colon syntax is NOT supported and silently breaks-7. Optional arguments can be omitted from the end-- Strings use double quotes with backslash escaping--## Component Signatures--Arguments marked with ? are optional. Sub-components can be inline or referenced; prefer references for better streaming.-Props typed `ActionExpression` accept an Action([@steps...]) expression. See the Action section for available steps (@ToAssistant, @OpenUrl).-Props marked `$binding<type>` accept a `$variable` reference for two-way binding.--### Content-CardHeader(title?: string, subtitle?: string) — Header with optional title and subtitle-TextContent(text: string, size?: "small" | "default" | "large" | "small-heavy" | "large-heavy") — Text block. Supports markdown. Optional size: "small" | "default" | "large" | "small-heavy" | "large-heavy".-MarkDownRenderer(textMarkdown: string, variant?: "clear" | "card" | "sunk") — Renders markdown text with optional container variant-Callout(variant: "info" | "warning" | "error" | "success" | "neutral", title: string, description: string, visible?: $binding<boolean>) — Callout banner. Optional visible is a reactive $boolean — auto-dismisses after 3s by setting $visible to false.-TextCallout(variant?: "neutral" | "info" | "warning" | "success" | "danger", title?: string, description?: string) — Text callout with variant, title, and description-Image(alt: string, src?: string) — Image with alt text and optional URL-ImageBlock(src: string, alt?: string) — Image block with loading state-ImageGallery(images: {src: string, alt?: string, details?: string}[]) — Gallery grid of images with modal preview-CodeBlock(language: string, codeString: string) — Syntax-highlighted code block-Separator(orientation?: "horizontal" | "vertical", decorative?: boolean) — Visual divider between content sections--### Tables-Table(columns: Col[]) — Data table — column-oriented. Each Col holds its own data array.-Col(label: string, data: any, type?: "string" | "number" | "action") — Column definition — holds label + data array--### Charts (2D)-BarChart(labels: string[], series: Series[], variant?: "grouped" | "stacked", xLabel?: string, yLabel?: string) — Vertical bars; use for comparing values across categories with one or more series-LineChart(labels: string[], series: Series[], variant?: "linear" | "natural" | "step", xLabel?: string, yLabel?: string) — Lines over categories; use for trends and continuous data over time-AreaChart(labels: string[], series: Series[], variant?: "linear" | "natural" | "step", xLabel?: string, yLabel?: string) — Filled area under lines; use for cumulative totals or volume trends over time-RadarChart(labels: string[], series: Series[]) — Spider/web chart; use for comparing multiple variables across one or more entities-HorizontalBarChart(labels: string[], series: Series[], variant?: "grouped" | "stacked", xLabel?: string, yLabel?: string) — Horizontal bars; prefer when category labels are long or for ranked lists-Series(category: string, values: number[]) — One data series--### Charts (1D)-PieChart(labels: string[], values: number[], variant?: "pie" | "donut", appearance?: "circular" | "semiCircular") — Circular slices; use plucked arrays: PieChart(data.categories, data.values)-RadialChart(labels: string[], values: number[]) — Radial bars; use plucked arrays: RadialChart(data.categories, data.values)-SingleStackedBarChart(labels: string[], values: number[]) — Single horizontal stacked bar; use plucked arrays: SingleStackedBarChart(data.categories, data.values)-Slice(category: string, value: number) — One slice with label and numeric value--### Charts (Scatter)-ScatterChart(datasets: ScatterSeries[], xLabel?: string, yLabel?: string) — X/Y scatter plot; use for correlations, distributions, and clustering-ScatterSeries(name: string, points: Point[]) — Named dataset-Point(x: number, y: number, z?: number) — Data point with numeric coordinates--### Forms-Form(name: string, buttons: Buttons, fields?: FormControl[]) — Form container with fields and explicit action buttons-FormControl(label: string, input: Input | TextArea | Select | DatePicker | Slider | CheckBoxGroup | RadioGroup, hint?: string) — Field with label, input component, and optional hint text-Label(text: string) — Text label-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>)-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>)-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")-SelectItem(value: string, label: string) — Option for Select-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>)-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[]>) — Numeric slider input; supports continuous and discrete (stepped) variants-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>>)-CheckBoxItem(label: string, description: string, name: string, defaultChecked?: boolean)-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>)-RadioItem(label: string, description: string, value: string)-SwitchGroup(name: string, items: SwitchItem[], variant?: "clear" | "card" | "sunk", value?: $binding<Record<string, boolean>>) — Group of switch toggles-SwitchItem(label?: string, description?: string, name: string, defaultChecked?: boolean) — Individual switch toggle-- 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 third Form argument.-- 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--### Buttons-Button(label: string, action?: ActionExpression, variant?: "primary" | "secondary" | "tertiary", type?: "normal" | "destructive", size?: "extra-small" | "small" | "medium" | "large") — Clickable button-Buttons(buttons: Button[], direction?: "row" | "column") — Group of Button components. direction: "row" (default) | "column".--### Lists & Follow-ups-ListBlock(items: ListItem[], variant?: "number" | "image") — A list of items with number or image indicators. Each item can optionally have an action.-ListItem(title: string, subtitle?: string, image?: {src: string, alt: string}, actionLabel?: string, action?: ActionExpression) — Item in a ListBlock — displays a title with an optional subtitle and image. When action is provided, the item becomes clickable.-FollowUpBlock(items: FollowUpItem[]) — List of clickable follow-up suggestions placed at the end of a response-FollowUpItem(text: string) — Clickable follow-up suggestion — when clicked, sends text as user message-- Use ListBlock with ListItem references for numbered, clickable lists.-- Use FollowUpBlock with FollowUpItem references at the end of a response to suggest next actions.-- Clicking a ListItem or FollowUpItem sends its text to the LLM as a user message.-- Example: list = ListBlock([item1, item2]) item1 = ListItem("Option A", "Details about A")--### Sections-SectionBlock(sections: SectionItem[], isFoldable?: boolean) — Collapsible accordion sections. Auto-opens sections as they stream in. Use SectionItem for each section.-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 | Steps | ListBlock | FollowUpBlock)[]) — Section with a label and collapsible content — used inside SectionBlock-- 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.--### Layout-Tabs(items: TabItem[]) — Tabbed container-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 | Steps)[]) — value is unique id, trigger is tab label, content is array of components-Accordion(items: AccordionItem[]) — Collapsible sections-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 | Steps)[]) — value is unique id, trigger is section title-Steps(items: StepsItem[]) — Step-by-step guide-StepsItem(title: string, details: string) — title and details text for one step-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 | Steps)[][], variant?: "card" | "sunk") — Horizontal scrollable carousel-- 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.--### Data Display-TagBlock(tags: string[]) — tags is an array of strings-Tag(text: string, icon?: string, size?: "sm" | "md" | "lg", variant?: "neutral" | "info" | "success" | "warning" | "danger") — Styled tag/badge with optional icon and variant--### Other-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 | Steps | ListBlock | FollowUpBlock | SectionBlock | Tabs | Carousel)[]) — Vertical container for all content in a chat response. Children stack top to bottom automatically.--## Action — Button Behavior--Action([@steps...]) wires button clicks to operations. Steps are @-prefixed built-in actions. Steps execute in order.-Buttons without an explicit Action prop automatically send their label to the assistant (equivalent to Action([@ToAssistant(label)])).--Available steps:-- @ToAssistant("message") — Send a message to the assistant (for conversational buttons like "Tell me more", "Explain this")-- @OpenUrl("https://...") — Navigate to a URL--Example — simple nav:-```-viewBtn = Button("View", Action([@OpenUrl("https://example.com")]))-```--- Action can be assigned to a variable or inlined: Button("Go", onSubmit) and Button("Go", Action([...])) both work--## Hoisting & Streaming (CRITICAL)--openui-lang supports hoisting: a reference can be used BEFORE it is defined. The parser resolves all references after the full input is parsed.--During streaming, the output is re-parsed on every chunk. Undefined references are temporarily unresolved and appear once their definitions stream in. This creates a progressive top-down reveal — structure first, then data fills in.--**Recommended statement order for optimal streaming:**-1. `root = Card(...)` — UI shell appears immediately-2. Component definitions — fill in as they stream-3. Data values — leaf content last--Always write the root = Card(...) statement first so the UI shell appears immediately, even before child data has streamed in.--## Examples--Example 1 — Table with follow-ups:--root = Card([title, tbl, followUps])-title = TextContent("Top Languages", "large-heavy")-tbl = Table([Col("Language", langs), Col("Users (M)", users), Col("Year", years)])-langs = ["Python", "JavaScript", "Java"]-users = [15.7, 14.2, 12.1]-years = [1991, 1995, 1995]-followUps = FollowUpBlock([fu1, fu2])-fu1 = FollowUpItem("Tell me more about Python")-fu2 = FollowUpItem("Show me a JavaScript comparison")--Example 2 — Clickable list:--root = Card([title, list])-title = TextContent("Choose a topic", "large-heavy")-list = ListBlock([item1, item2, item3])-item1 = ListItem("Getting started", "New to the platform? Start here.")-item2 = ListItem("Advanced features", "Deep dives into powerful capabilities.")-item3 = ListItem("Troubleshooting", "Common issues and how to fix them.")--Example 3 — Image carousel with consistent slides + follow-ups:--root = Card([header, carousel, followups])-header = CardHeader("Featured Destinations", "Discover highlights and best time to visit")-carousel = Carousel([[t1, img1, d1, tags1], [t2, img2, d2, tags2], [t3, img3, d3, tags3]], "card")-t1 = TextContent("Paris, France", "large-heavy")-img1 = ImageBlock("https://picsum.photos/seed/paris/800/500", "Eiffel Tower at night")-d1 = TextContent("City of light — best Apr–Jun and Sep–Oct.", "default")-tags1 = TagBlock(["Landmark", "City Break", "Culture"])-t2 = TextContent("Kyoto, Japan", "large-heavy")-img2 = ImageBlock("https://picsum.photos/seed/kyoto/800/500", "Bamboo grove in Arashiyama")-d2 = TextContent("Temples and bamboo groves — best Mar–Apr and Nov.", "default")-tags2 = TagBlock(["Temples", "Autumn", "Culture"])-t3 = TextContent("Machu Picchu, Peru", "large-heavy")-img3 = ImageBlock("https://picsum.photos/seed/machupicchu/800/500", "Inca citadel in the clouds")-d3 = TextContent("High-altitude Inca citadel — best May–Sep.", "default")-tags3 = TagBlock(["Andes", "Hike", "UNESCO"])-followups = FollowUpBlock([fu1, fu2])-fu1 = FollowUpItem("Show me only beach destinations")-fu2 = FollowUpItem("Turn this into a comparison table")--Example 4 — Form with validation:--root = Card([title, form])-title = TextContent("Contact Us", "large-heavy")-form = Form("contact", btns, [nameField, emailField, msgField])-nameField = FormControl("Name", Input("name", "Your name", "text", { required: true, minLength: 2 }))-emailField = FormControl("Email", Input("email", "[email protected]", "email", { required: true, email: true }))-msgField = FormControl("Message", TextArea("message", "Tell us more...", 4, { required: true, minLength: 10 }))-btns = Buttons([Button("Submit", Action([@ToAssistant("Submit")]), "primary")])--## Important Rules-- Choose components that best represent the content (tables for comparisons, charts for trends, forms for input, etc.)--## Final Verification-Before finishing, walk your output and verify:-1. root = Card(...) is the FIRST line (for optimal streaming).-2. Every referenced name is defined. Every defined name (other than root) is reachable from root.--- 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 the user can click to select.-- 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 image carousels, always use real accessible URLs like https://picsum.photos/seed/KEYWORD/800/500. Never hallucinate or invent image URLs.-- 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.diff --git a/docs/generated/playground-component-spec.json b/docs/generated/playground-component-spec.jsondeleted file mode 100644index 4c0a02ca4..000000000--- a/docs/generated/playground-component-spec.json+++ /dev/null@@ -1,2236 +0,0 @@-{- "$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"- },- "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"- },- "Stack": {- "$ref": "#/$defs/Stack"- },- "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"- },- "Separator": {- "$ref": "#/$defs/Separator"- },- "TagBlock": {- "$ref": "#/$defs/TagBlock"- },- "Tag": {- "$ref": "#/$defs/Tag"- },- "Modal": {- "$ref": "#/$defs/Modal"- }- },- "required": [- "Card",- "CardHeader",- "TextContent",- "MarkDownRenderer",- "Callout",- "TextCallout",- "Image",- "ImageBlock",- "ImageGallery",- "CodeBlock",- "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",- "Stack",- "Tabs",- "TabItem",- "Accordion",- "AccordionItem",- "Steps",- "StepsItem",- "Carousel",- "Separator",- "TagBlock",- "Tag",- "Modal"- ],- "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/Steps"- },- {- "$ref": "#/$defs/Tabs"- },- {- "$ref": "#/$defs/Carousel"- },- {- "$ref": "#/$defs/Stack"- }- ]- }- },- "variant": {- "type": "string",- "enum": [- "card",- "sunk",- "clear"- ]- },- "direction": {- "type": "string",- "enum": [- "row",- "column"- ]- },- "gap": {- "type": "string",- "enum": [- "none",- "xs",- "s",- "m",- "l",- "xl",- "2xl"- ]- },- "align": {- "type": "string",- "enum": [- "start",- "center",- "end",- "stretch",- "baseline"- ]- },- "justify": {- "type": "string",- "enum": [- "start",- "center",- "end",- "between",- "around",- "evenly"- ]- },- "wrap": {- "type": "boolean"- }- },- "required": [- "children"- ],- "additionalProperties": false,- "description": "Styled container. variant: \"card\" (default, elevated) | \"sunk\" (recessed) | \"clear\" (transparent). Always full width. Accepts all Stack flex params (default: direction \"column\"). Cards flex to share space in row/wrap layouts."- },- "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"- }- },- "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"- }- },- "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"- }- },- "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"- }- }- },- "required": [- "tags"- ],- "additionalProperties": false,- "description": "tags is an array of strings"- },- "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": {},- "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"- },- "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"- }- ]- },- "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- },- "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"- },- "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/Steps"- }- ]- }- }- },- "required": [- "value",- "trigger",- "content"- ],- "additionalProperties": false,- "description": "value is unique id, trigger is tab label, content is array of components"- },- "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/Steps"- }- ]- }- }- },- "variant": {- "type": "string",- "enum": [- "card",- "sunk"- ]- }- },- "required": [- "children"- ],- "additionalProperties": false,- "description": "Horizontal scrollable carousel"- },- "Stack": {- "type": "object",- "properties": {- "children": {- "type": "array",- "items": {}- },- "direction": {- "type": "string",- "enum": [- "row",- "column"- ]- },- "gap": {- "type": "string",- "enum": [- "none",- "xs",- "s",- "m",- "l",- "xl",- "2xl"- ]- },- "align": {- "type": "string",- "enum": [- "start",- "center",- "end",- "stretch",- "baseline"- ]- },- "justify": {- "type": "string",- "enum": [- "start",- "center",- "end",- "between",- "around",- "evenly"- ]- },- "wrap": {- "type": "boolean"- }- },- "required": [- "children"- ],- "additionalProperties": false,- "description": "Flex container. direction: \"row\"|\"column\" (default \"column\"). gap: \"none\"|\"xs\"|\"s\"|\"m\"|\"l\"|\"xl\"|\"2xl\" (default \"m\"). align: \"start\"|\"center\"|\"end\"|\"stretch\"|\"baseline\". justify: \"start\"|\"center\"|\"end\"|\"between\"|\"around\"|\"evenly\"."- },- "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"- },- "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/Steps"- }- ]- }- }- },- "required": [- "value",- "trigger",- "content"- ],- "additionalProperties": false,- "description": "value is unique id, trigger is section title"- },- "Tag": {- "type": "object",- "properties": {- "text": {- "type": "string"- },- "icon": {- "type": "string"- },- "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"- },- "Modal": {- "type": "object",- "properties": {- "title": {- "type": "string"- },- "open": {- "type": "boolean"- },- "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/Steps"- }- ]- }- },- "size": {- "type": "string",- "enum": [- "sm",- "md",- "lg"- ]- }- },- "required": [- "title",- "children"- ],- "additionalProperties": false,- "description": "Modal dialog. open is a reactive $boolean binding — set to true to open, X/Escape/backdrop auto-closes. Put Form with buttons inside children."- }- }-}diff --git a/docs/generated/playground-library.spec.json b/docs/generated/playground-library.spec.jsonnew file mode 100644index 000000000..9c5160c6b--- /dev/null+++ b/docs/generated/playground-library.spec.json@@ -0,0 +1,4752 @@+{+ "root": "Stack",+ "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 | Tabs | Carousel | Stack)[], variant?: \"card\" | \"sunk\" | \"clear\", direction?: \"row\" | \"column\", gap?: \"none\" | \"xs\" | \"s\" | \"m\" | \"l\" | \"xl\" | \"2xl\", align?: \"start\" | \"center\" | \"end\" | \"stretch\" | \"baseline\", justify?: \"start\" | \"center\" | \"end\" | \"between\" | \"around\" | \"evenly\", wrap?: boolean)",+ "description": "Styled container. variant: \"card\" (default, elevated) | \"sunk\" (recessed) | \"clear\" (transparent). Always full width. Accepts all Stack flex params (default: direction \"column\"). Cards flex to share space in row/wrap layouts."+ },+ "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"+ },+ "InlineHeader": {+ "signature": "InlineHeader(heading: string, description?: string)",+ "description": "Compact section heading with an optional one-line description, for use inside cards."+ },+ "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"+ },+ "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"+ },+ "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"+ },+ "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`."+ },+ "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\"."+ },+ "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."+ },+ "Stack": {+ "signature": "Stack(children: any[], direction?: \"row\" | \"column\", gap?: \"none\" | \"xs\" | \"s\" | \"m\" | \"l\" | \"xl\" | \"2xl\", align?: \"start\" | \"center\" | \"end\" | \"stretch\" | \"baseline\", justify?: \"start\" | \"center\" | \"end\" | \"between\" | \"around\" | \"evenly\", wrap?: boolean)",+ "description": "Flex container. direction: \"row\"|\"column\" (default \"column\"). gap: \"none\"|\"xs\"|\"s\"|\"m\"|\"l\"|\"xl\"|\"2xl\" (default \"m\"). align: \"start\"|\"center\"|\"end\"|\"stretch\"|\"baseline\". justify: \"start\"|\"center\"|\"end\"|\"between\"|\"around\"|\"evenly\"."+ },+ "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)[])",+ "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)[])",+ "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)[][], variant?: \"card\" | \"sunk\")",+ "description": "Horizontal scrollable carousel"+ },+ "Separator": {+ "signature": "Separator(orientation?: \"horizontal\" | \"vertical\", decorative?: boolean)",+ "description": "Visual divider between content sections"+ },+ "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"+ },+ "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."+ },+ "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."+ },+ "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."+ },+ "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."+ },+ "Modal": {+ "signature": "Modal(title: string, open?: $binding<boolean>, 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)[], size?: \"sm\" | \"md\" | \"lg\")",+ "description": "Modal dialog. open is a reactive $boolean binding — set to true to open, X/Escape/backdrop auto-closes. Put Form with buttons inside children."+ }+ },+ "componentGroups": [+ {+ "name": "Layout",+ "components": [+ "Stack",+ "Tabs",+ "TabItem",+ "Accordion",+ "AccordionItem",+ "Steps",+ "StepsItem",+ "Carousel",+ "Separator",+ "Modal"+ ],+ "notes": [+ "- For grid-like layouts, use Stack with direction \"row\" and wrap set to true.",+ "- Prefer justify \"start\" (or omit justify) with wrap=true for stable columns instead of uneven gutters.",+ "- Use nested Stacks when you need explicit rows/sections.",+ "- Show/hide sections: $editId != \"\" ? Card([editForm]) : null",+ "- Modal: Modal(\"Title\", $showModal, [content]) — $showModal is boolean, X/Escape auto-closes. Put Form with its own buttons inside children.",+ "- Use Tabs for alternative views (chart types, data sections) — no $variable needed",+ "- Shared filter across Tabs: same $days binding in Query args works across all TabItems"+ ]+ },+ {+ "name": "Content",+ "components": [+ "Card",+ "CardHeader",+ "TextContent",+ "MarkDownRenderer",+ "Callout",+ "TextCallout",+ "Image",+ "ImageBlock",+ "ImageGallery",+ "CodeBlock",+ "InlineHeader"+ ],+ "notes": [+ "- InlineHeader is a compact heading + description pair for labelling a block (lighter than CardHeader).",+ "- Use Cards to group related KPIs or sections. Stack with direction \"row\" for side-by-side layouts.",+ "- Success toast: Callout(\"success\", \"Saved\", \"Done.\", $showSuccess) — use @Set($showSuccess, true) in save action, auto-dismisses after 3s. For errors: result.status == \"error\" ? Callout(\"error\", \"Failed\", result.error) : null",+ "- KPI card: Card([TextContent(\"Label\", \"small\"), TextContent(\"\" + @Count(@Filter(data.rows, \"field\", \"==\", \"value\")), \"large-heavy\")])"+ ]+ },+ {+ "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.",+ "- Table is COLUMN-oriented: Table([Col(\"Label\", dataArray), Col(\"Count\", countArray, \"number\")]). Use array pluck for data: data.rows.fieldName",+ "- Col data can be component arrays for styled cells: Col(\"Status\", @Each(data.rows, \"item\", Tag(item.status, null, \"sm\", item.status == \"open\" ? \"success\" : \"danger\")))",+ "- Row actions: Col(\"Actions\", @Each(data.rows, \"t\", Button(\"Edit\", Action([@Set($showEdit, true), @Set($editId, t.id)]))))",+ "- Sortable: sorted = @Sort(data.rows, $sortField, \"desc\"). Bind $sortField to Select. Use sorted.fieldName for Col data",+ "- Searchable: filtered = @Filter(data.rows, \"title\", \"contains\", $search). Bind $search to Input",+ "- Chain sort + filter: filtered = @Filter(...) then sorted = @Sort(filtered, ...) — use sorted for both Table and Charts",+ "- Empty state: @Count(data.rows) > 0 ? Table([...]) : TextContent(\"No data yet\")"+ ]+ },+ {+ "name": "Charts (2D)",+ "components": [+ "BarChart",+ "LineChart",+ "AreaChart",+ "RadarChart",+ "HorizontalBarChart",+ "Series"+ ],+ "notes": [+ "- Charts accept column arrays: LineChart(labels, [Series(\"Name\", values)]). Use array pluck: LineChart(data.rows.day, [Series(\"Views\", data.rows.views)])",+ "- Use Cards to wrap charts with CardHeader for titled sections",+ "- Chart + Table from same source: use @Sort or @Filter result for both LineChart and Table Col data",+ "- Multiple chart views: use Tabs — Tabs([TabItem(\"line\", \"Line\", [LineChart(...)]), TabItem(\"bar\", \"Bar\", [BarChart(...)])])"+ ]+ },+ {+ "name": "Charts (1D)",+ "components": [+ "PieChart",+ "RadialChart",+ "SingleStackedBarChart",+ "Slice"+ ],+ "notes": [+ "- PieChart and BarChart need NUMBERS, not objects. For list data, use @Count(@Filter(...)) to aggregate:",+ "- PieChart from list: `PieChart([\"Low\", \"Med\", \"High\"], [@Count(@Filter(data.rows, \"priority\", \"==\", \"low\")), @Count(@Filter(data.rows, \"priority\", \"==\", \"medium\")), @Count(@Filter(data.rows, \"priority\", \"==\", \"high\"))], \"donut\")`",+ "- KPI from count: `TextContent(\"\" + @Count(@Filter(data.rows, \"status\", \"==\", \"open\")), \"large-heavy\")`"+ ]+ },+ {+ "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.",+ "- For Form fields, define EACH FormControl as its own reference — do NOT inline all controls in one array. This allows progressive field-by-field streaming.",+ "- NEVER nest Form inside Form — each Form should be a standalone container.",+ "- Form requires explicit buttons. Always pass a Buttons(...) reference as the third Form argument.",+ "- rules is an optional object: {required: true, email: true, minLength: 8, maxLength: 100}",+ "- Available rules: required, email, min, max, minLength, maxLength, pattern, url, numeric",+ "- The renderer shows error messages automatically — do NOT generate error text in the UI",+ "- Conditional fields: $country == \"US\" ? stateField : $country == \"UK\" ? postcodeField : addressField",+ "- Edit form in Modal: Modal(\"Edit\", $showEdit, [Form(\"edit\", Buttons([saveBtn, cancelBtn]), [fields...])]). Save button should include @Set($showEdit, false) to close modal."+ ]+ },+ {+ "name": "Buttons",+ "components": [+ "Button",+ "Buttons",+ "IconButton"+ ],+ "notes": [+ "- Icon renders a lucide icon by kebab-case name; it is also used as the icon of IconButton, IconText and OptionCard.",+ "- Toggle in @Each: @Each(rows, \"t\", Button(t.status == \"open\" ? \"Close\" : \"Reopen\", Action([...])))"+ ]+ },+ {+ "name": "Data Display",+ "components": [+ "TagBlock",+ "Tag",+ "Icon",+ "EntityList",+ "ListBlock",+ "ListItem"+ ],+ "notes": [+ "- Color-mapped Tag: Tag(value, null, \"sm\", value == \"high\" ? \"danger\" : value == \"medium\" ? \"warning\" : \"neutral\")",+ "- 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.",+ "- ListBlock is a numbered or image list of ListItem references. An action on ListItem is optional."+ ]+ },+ {+ "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"+ },+ "InlineHeader": {+ "$ref": "#/$defs/InlineHeader"+ },+ "Table": {+ "$ref": "#/$defs/Table"+ },+ "Col": {+ "$ref": "#/$defs/Col"+ },+ "EditableTable": {+ "$ref": "#/$defs/EditableTable"+ },+ "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"+ },+ "ChipItem": {+ "$ref": "#/$defs/ChipItem"+ },+ "Chips": {+ "$ref": "#/$defs/Chips"+ },+ "OptionCard": {+ "$ref": "#/$defs/OptionCard"+ },+ "OptionCards": {+ "$ref": "#/$defs/OptionCards"+ },+ "Button": {+ "$ref": "#/$defs/Button"+ },+ "Buttons": {+ "$ref": "#/$defs/Buttons"+ },+ "IconButton": {+ "$ref": "#/$defs/IconButton"+ },+ "Stack": {+ "$ref": "#/$defs/Stack"+ },+ "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"+ },+ "Separator": {+ "$ref": "#/$defs/Separator"+ },+ "TagBlock": {+ "$ref": "#/$defs/TagBlock"+ },+ "Tag": {+ "$ref": "#/$defs/Tag"+ },+ "Icon": {+ "$ref": "#/$defs/Icon"+ },+ "EntityList": {+ "$ref": "#/$defs/EntityList"+ },+ "ListBlock": {+ "$ref": "#/$defs/ListBlock"+ },+ "ListItem": {+ "$ref": "#/$defs/ListItem"+ },+ "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"+ },+ "Modal": {+ "$ref": "#/$defs/Modal"+ }+ },+ "required": [+ "Card",+ "CardHeader",+ "TextContent",+ "MarkDownRenderer",+ "Callout",+ "TextCallout",+ "Image",+ "ImageBlock",+ "ImageGallery",+ "CodeBlock",+ "InlineHeader",+ "Table",+ "Col",+ "EditableTable",+ "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",+ "ChipItem",+ "Chips",+ "OptionCard",+ "OptionCards",+ "Button",+ "Buttons",+ "IconButton",+ "Stack",+ "Tabs",+ "TabItem",+ "Accordion",+ "AccordionItem",+ "Steps",+ "StepsItem",+ "Carousel",+ "Separator",+ "TagBlock",+ "Tag",+ "Icon",+ "EntityList",+ "ListBlock",+ "ListItem",+ "Text",+ "BoldText",+ "IconText",+ "ImageText",+ "ImageTextLarge",+ "MetricIndicatorInline",+ "MetricIndicatorWithStrikethrough",+ "SnippetCardItem",+ "SnippetCardBlock",+ "OverviewCardItem",+ "OverviewCardBlock",+ "ContextCardItem",+ "ContextCardBlock",+ "CompositeCardItem",+ "CompositeCardBlock",+ "VisualCardItem",+ "VisualCardBlock",+ "Modal"+ ],+ "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/Tabs"+ },+ {+ "$ref": "#/$defs/Carousel"+ },+ {+ "$ref": "#/$defs/Stack"+ }+ ]+ }+ },+ "variant": {+ "type": "string",+ "enum": [+ "card",+ "sunk",+ "clear"+ ]+ },+ "direction": {+ "type": "string",+ "enum": [+ "row",+ "column"+ ]+ },+ "gap": {+ "type": "string",+ "enum": [+ "none",+ "xs",+ "s",+ "m",+ "l",+ "xl",+ "2xl"+ ]+ },+ "align": {+ "type": "string",+ "enum": [+ "start",+ "center",+ "end",+ "stretch",+ "baseline"+ ]+ },+ "justify": {+ "type": "string",+ "enum": [+ "start",+ "center",+ "end",+ "between",+ "around",+ "evenly"+ ]+ },+ "wrap": {+ "type": "boolean"+ }+ },+ "required": [+ "children"+ ],+ "additionalProperties": false,+ "description": "Styled container. variant: \"card\" (default, elevated) | \"sunk\" (recessed) | \"clear\" (transparent). Always full width. Accepts all Stack flex params (default: direction \"column\"). Cards flex to share space in row/wrap layouts."+ },+ "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": {+ "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+ }+ ]+ },+ "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"+ },+ "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": {+ "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+ }+ ]+ },+ "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": {+ "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+ }+ ]+ },+ "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": {+ "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+ }+ ]+ },+ "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": {+ "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+ }+ ]+ },+ "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": {+ "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+ }+ ]+ },+ "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": {+ "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+ }+ ]+ }+ },+ "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": {+ "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+ }+ ]+ },+ "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)."+ },+ "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"+ }+ ]+ }+ }+ },+ "required": [+ "value",+ "trigger",+ "content"+ ],+ "additionalProperties": false,+ "description": "value is unique id, trigger is tab label, content is array of components"+ },+ "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"+ }+ ]+ }+ }+ },+ "variant": {+ "type": "string",+ "enum": [+ "card",+ "sunk"+ ]+ }+ },+ "required": [+ "children"+ ],+ "additionalProperties": false,+ "description": "Horizontal scrollable carousel"+ },+ "Stack": {+ "type": "object",+ "properties": {+ "children": {+ "type": "array",+ "items": {}+ },+ "direction": {+ "type": "string",+ "enum": [+ "row",+ "column"+ ]+ },+ "gap": {+ "type": "string",+ "enum": [+ "none",+ "xs",+ "s",+ "m",+ "l",+ "xl",+ "2xl"+ ]+ },+ "align": {+ "type": "string",+ "enum": [+ "start",+ "center",+ "end",+ "stretch",+ "baseline"+ ]+ },+ "justify": {+ "type": "string",+ "enum": [+ "start",+ "center",+ "end",+ "between",+ "around",+ "evenly"+ ]+ },+ "wrap": {+ "type": "boolean"+ }+ },+ "required": [+ "children"+ ],+ "additionalProperties": false,+ "description": "Flex container. direction: \"row\"|\"column\" (default \"column\"). gap: \"none\"|\"xs\"|\"s\"|\"m\"|\"l\"|\"xl\"|\"2xl\" (default \"m\"). align: \"start\"|\"center\"|\"end\"|\"stretch\"|\"baseline\". justify: \"start\"|\"center\"|\"end\"|\"between\"|\"around\"|\"evenly\"."+ },+ "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"+ },+ "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"+ }+ ]+ }+ }+ },+ "required": [+ "value",+ "trigger",+ "content"+ ],+ "additionalProperties": false,+ "description": "value is unique id, trigger is section title"+ },+ "Modal": {+ "type": "object",+ "properties": {+ "title": {+ "type": "string"+ },+ "open": {+ "type": "boolean"+ },+ "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"+ }+ ]+ }+ },+ "size": {+ "type": "string",+ "enum": [+ "sm",+ "md",+ "lg"+ ]+ }+ },+ "required": [+ "title",+ "children"+ ],+ "additionalProperties": false,+ "description": "Modal dialog. open is a reactive $boolean binding — set to true to open, X/Escape/backdrop auto-closes. Put Form with buttons inside children."+ }+ }+ }+}diff --git a/docs/generated/playground-system-prompt.txt b/docs/generated/playground-system-prompt.txtdeleted file mode 100644index 9f4fba843..000000000--- a/docs/generated/playground-system-prompt.txt+++ /dev/null@@ -1,203 +0,0 @@-You are an AI assistant that responds using openui-lang, a declarative UI language. Your ENTIRE response must be valid openui-lang code — no markdown, no explanations, just openui-lang.--## Syntax Rules--1. Each statement is on its own line: `identifier = Expression`-2. `root` is the entry point — every program must define `root = Stack(...)`-3. Expressions are: strings ("..."), numbers, booleans (true/false), null, arrays ([...]), objects ({...}), or component calls TypeName(arg1, arg2, ...)-4. Use references for readability: define `name = ...` on one line, then use `name` later-5. EVERY variable (except root) MUST be referenced by at least one other variable. Unreferenced variables are silently dropped and will NOT render. Always include defined variables in their parent's children/items array.-6. Arguments are POSITIONAL (order matters, not names). Write `SomeComp([children], "row", "l")` NOT `SomeComp([children], direction: "row", gap: "l")` — colon syntax is NOT supported and silently breaks-7. Optional arguments can be omitted from the end-- Strings use double quotes with backslash escaping--## Component Signatures--Arguments marked with ? are optional. Sub-components can be inline or referenced; prefer references for better streaming.-Props typed `ActionExpression` accept an Action([@steps...]) expression. See the Action section for available steps (@ToAssistant, @OpenUrl).-Props marked `$binding<type>` accept a `$variable` reference for two-way binding.--### Layout-Stack(children: any[], direction?: "row" | "column", gap?: "none" | "xs" | "s" | "m" | "l" | "xl" | "2xl", align?: "start" | "center" | "end" | "stretch" | "baseline", justify?: "start" | "center" | "end" | "between" | "around" | "evenly", wrap?: boolean) — Flex container. direction: "row"|"column" (default "column"). gap: "none"|"xs"|"s"|"m"|"l"|"xl"|"2xl" (default "m"). align: "start"|"center"|"end"|"stretch"|"baseline". justify: "start"|"center"|"end"|"between"|"around"|"evenly".-Tabs(items: TabItem[]) — Tabbed container-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 | Steps)[]) — value is unique id, trigger is tab label, content is array of components-Accordion(items: AccordionItem[]) — Collapsible sections-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 | Steps)[]) — value is unique id, trigger is section title-Steps(items: StepsItem[]) — Step-by-step guide-StepsItem(title: string, details: string) — title and details text for one step-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 | Steps)[][], variant?: "card" | "sunk") — Horizontal scrollable carousel-Separator(orientation?: "horizontal" | "vertical", decorative?: boolean) — Visual divider between content sections-Modal(title: string, open?: $binding<boolean>, children: (TextContent | MarkDownRenderer | CardHeader | Callout | TextCallout | CodeBlock | Image | ImageBlock | ImageGallery | Separator | HorizontalBarChart | RadarChart | PieChart | RadialChart | SingleStackedBarChart | ScatterChart | AreaChart | BarChart | LineChart | Table | TagBlock | Form | Buttons | Steps)[], size?: "sm" | "md" | "lg") — Modal dialog. open is a reactive $boolean binding — set to true to open, X/Escape/backdrop auto-closes. Put Form with buttons inside children.-- For grid-like layouts, use Stack with direction "row" and wrap set to true.-- Prefer justify "start" (or omit justify) with wrap=true for stable columns instead of uneven gutters.-- Use nested Stacks when you need explicit rows/sections.-- Show/hide sections: $editId != "" ? Card([editForm]) : null-- Modal: Modal("Title", $showModal, [content]) — $showModal is boolean, X/Escape auto-closes. Put Form with its own buttons inside children.-- Use Tabs for alternative views (chart types, data sections) — no $variable needed-- Shared filter across Tabs: same $days binding in Query args works across all TabItems--### Content-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 | Steps | Tabs | Carousel | Stack)[], variant?: "card" | "sunk" | "clear", direction?: "row" | "column", gap?: "none" | "xs" | "s" | "m" | "l" | "xl" | "2xl", align?: "start" | "center" | "end" | "stretch" | "baseline", justify?: "start" | "center" | "end" | "between" | "around" | "evenly", wrap?: boolean) — Styled container. variant: "card" (default, elevated) | "sunk" (recessed) | "clear" (transparent). Always full width. Accepts all Stack flex params (default: direction "column"). Cards flex to share space in row/wrap layouts.-CardHeader(title?: string, subtitle?: string) — Header with optional title and subtitle-TextContent(text: string, size?: "small" | "default" | "large" | "small-heavy" | "large-heavy") — Text block. Supports markdown. Optional size: "small" | "default" | "large" | "small-heavy" | "large-heavy".-MarkDownRenderer(textMarkdown: string, variant?: "clear" | "card" | "sunk") — Renders markdown text with optional container variant-Callout(variant: "info" | "warning" | "error" | "success" | "neutral", title: string, description: string, visible?: $binding<boolean>) — Callout banner. Optional visible is a reactive $boolean — auto-dismisses after 3s by setting $visible to false.-TextCallout(variant?: "neutral" | "info" | "warning" | "success" | "danger", title?: string, description?: string) — Text callout with variant, title, and description-Image(alt: string, src?: string) — Image with alt text and optional URL-ImageBlock(src: string, alt?: string) — Image block with loading state-ImageGallery(images: {src: string, alt?: string, details?: string}[]) — Gallery grid of images with modal preview-CodeBlock(language: string, codeString: string) — Syntax-highlighted code block-- Use Cards to group related KPIs or sections. Stack with direction "row" for side-by-side layouts.-- Success toast: Callout("success", "Saved", "Done.", $showSuccess) — use @Set($showSuccess, true) in save action, auto-dismisses after 3s. For errors: result.status == "error" ? Callout("error", "Failed", result.error) : null-- KPI card: Card([TextContent("Label", "small"), TextContent("" + @Count(@Filter(data.rows, "field", "==", "value")), "large-heavy")])--### Tables-Table(columns: Col[]) — Data table — column-oriented. Each Col holds its own data array.-Col(label: string, data: any, type?: "string" | "number" | "action") — Column definition — holds label + data array-- Table is COLUMN-oriented: Table([Col("Label", dataArray), Col("Count", countArray, "number")]). Use array pluck for data: data.rows.fieldName-- Col data can be component arrays for styled cells: Col("Status", @Each(data.rows, "item", Tag(item.status, null, "sm", item.status == "open" ? "success" : "danger")))-- Row actions: Col("Actions", @Each(data.rows, "t", Button("Edit", Action([@Set($showEdit, true), @Set($editId, t.id)]))))-- Sortable: sorted = @Sort(data.rows, $sortField, "desc"). Bind $sortField to Select. Use sorted.fieldName for Col data-- Searchable: filtered = @Filter(data.rows, "title", "contains", $search). Bind $search to Input-- Chain sort + filter: filtered = @Filter(...) then sorted = @Sort(filtered, ...) — use sorted for both Table and Charts-- Empty state: @Count(data.rows) > 0 ? Table([...]) : TextContent("No data yet")--### Charts (2D)-BarChart(labels: string[], series: Series[], variant?: "grouped" | "stacked", xLabel?: string, yLabel?: string) — Vertical bars; use for comparing values across categories with one or more series-LineChart(labels: string[], series: Series[], variant?: "linear" | "natural" | "step", xLabel?: string, yLabel?: string) — Lines over categories; use for trends and continuous data over time-AreaChart(labels: string[], series: Series[], variant?: "linear" | "natural" | "step", xLabel?: string, yLabel?: string) — Filled area under lines; use for cumulative totals or volume trends over time-RadarChart(labels: string[], series: Series[]) — Spider/web chart; use for comparing multiple variables across one or more entities-HorizontalBarChart(labels: string[], series: Series[], variant?: "grouped" | "stacked", xLabel?: string, yLabel?: string) — Horizontal bars; prefer when category labels are long or for ranked lists-Series(category: string, values: number[]) — One data series-- Charts accept column arrays: LineChart(labels, [Series("Name", values)]). Use array pluck: LineChart(data.rows.day, [Series("Views", data.rows.views)])-- Use Cards to wrap charts with CardHeader for titled sections-- Chart + Table from same source: use @Sort or @Filter result for both LineChart and Table Col data-- Multiple chart views: use Tabs — Tabs([TabItem("line", "Line", [LineChart(...)]), TabItem("bar", "Bar", [BarChart(...)])])--### Charts (1D)-PieChart(labels: string[], values: number[], variant?: "pie" | "donut", appearance?: "circular" | "semiCircular") — Circular slices; use plucked arrays: PieChart(data.categories, data.values)-RadialChart(labels: string[], values: number[]) — Radial bars; use plucked arrays: RadialChart(data.categories, data.values)-SingleStackedBarChart(labels: string[], values: number[]) — Single horizontal stacked bar; use plucked arrays: SingleStackedBarChart(data.categories, data.values)-Slice(category: string, value: number) — One slice with label and numeric value-- PieChart and BarChart need NUMBERS, not objects. For list data, use @Count(@Filter(...)) to aggregate:-- PieChart from list: `PieChart(["Low", "Med", "High"], [@Count(@Filter(data.rows, "priority", "==", "low")), @Count(@Filter(data.rows, "priority", "==", "medium")), @Count(@Filter(data.rows, "priority", "==", "high"))], "donut")`-- KPI from count: `TextContent("" + @Count(@Filter(data.rows, "status", "==", "open")), "large-heavy")`--### Charts (Scatter)-ScatterChart(datasets: ScatterSeries[], xLabel?: string, yLabel?: string) — X/Y scatter plot; use for correlations, distributions, and clustering-ScatterSeries(name: string, points: Point[]) — Named dataset-Point(x: number, y: number, z?: number) — Data point with numeric coordinates--### Forms-Form(name: string, buttons: Buttons, fields?: FormControl[]) — Form container with fields and explicit action buttons-FormControl(label: string, input: Input | TextArea | Select | DatePicker | Slider | CheckBoxGroup | RadioGroup, hint?: string) — Field with label, input component, and optional hint text-Label(text: string) — Text label-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>)-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>)-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")-SelectItem(value: string, label: string) — Option for Select-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>)-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[]>) — Numeric slider input; supports continuous and discrete (stepped) variants-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>>)-CheckBoxItem(label: string, description: string, name: string, defaultChecked?: boolean)-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>)-RadioItem(label: string, description: string, value: string)-SwitchGroup(name: string, items: SwitchItem[], variant?: "clear" | "card" | "sunk", value?: $binding<Record<string, boolean>>) — Group of switch toggles-SwitchItem(label?: string, description?: string, name: string, defaultChecked?: boolean) — Individual switch toggle-- For Form fields, define EACH FormControl as its own reference — do NOT inline all controls in one array. This allows progressive field-by-field streaming.-- NEVER nest Form inside Form — each Form should be a standalone container.-- Form requires explicit buttons. Always pass a Buttons(...) reference as the third Form argument.-- rules is an optional object: {required: true, email: true, minLength: 8, maxLength: 100}-- Available rules: required, email, min, max, minLength, maxLength, pattern, url, numeric-- The renderer shows error messages automatically — do NOT generate error text in the UI-- Conditional fields: $country == "US" ? stateField : $country == "UK" ? postcodeField : addressField-- Edit form in Modal: Modal("Edit", $showEdit, [Form("edit", Buttons([saveBtn, cancelBtn]), [fields...])]). Save button should include @Set($showEdit, false) to close modal.--### Buttons-Button(label: string, action?: ActionExpression, variant?: "primary" | "secondary" | "tertiary", type?: "normal" | "destructive", size?: "extra-small" | "small" | "medium" | "large") — Clickable button-Buttons(buttons: Button[], direction?: "row" | "column") — Group of Button components. direction: "row" (default) | "column".-- Toggle in @Each: @Each(rows, "t", Button(t.status == "open" ? "Close" : "Reopen", Action([...])))--### Data Display-TagBlock(tags: string[]) — tags is an array of strings-Tag(text: string, icon?: string, size?: "sm" | "md" | "lg", variant?: "neutral" | "info" | "success" | "warning" | "danger") — Styled tag/badge with optional icon and variant-- Color-mapped Tag: Tag(value, null, "sm", value == "high" ? "danger" : value == "medium" ? "warning" : "neutral")--## Action — Button Behavior--Action([@steps...]) wires button clicks to operations. Steps are @-prefixed built-in actions. Steps execute in order.-Buttons without an explicit Action prop automatically send their label to the assistant (equivalent to Action([@ToAssistant(label)])).--Available steps:-- @ToAssistant("message") — Send a message to the assistant (for conversational buttons like "Tell me more", "Explain this")-- @OpenUrl("https://...") — Navigate to a URL--Example — simple nav:-```-viewBtn = Button("View", Action([@OpenUrl("https://example.com")]))-```--- Action can be assigned to a variable or inlined: Button("Go", onSubmit) and Button("Go", Action([...])) both work--## Hoisting & Streaming (CRITICAL)--openui-lang supports hoisting: a reference can be used BEFORE it is defined. The parser resolves all references after the full input is parsed.--During streaming, the output is re-parsed on every chunk. Undefined references are temporarily unresolved and appear once their definitions stream in. This creates a progressive top-down reveal — structure first, then data fills in.--**Recommended statement order for optimal streaming:**-1. `root = Stack(...)` — UI shell appears immediately-2. Component definitions — fill in as they stream-3. Data values — leaf content last--Always write the root = Stack(...) statement first so the UI shell appears immediately, even before child data has streamed in.--## Examples--Example 1 — Table (column-oriented):--root = Stack([title, tbl])-title = TextContent("Top Languages", "large-heavy")-tbl = Table([Col("Language", langs), Col("Users (M)", users), Col("Year", years)])-langs = ["Python", "JavaScript", "Java", "TypeScript", "Go"]-users = [15.7, 14.2, 12.1, 8.5, 5.2]-years = [1991, 1995, 1995, 2012, 2009]--Example 2 — Bar chart:--root = Stack([title, chart])-title = TextContent("Q4 Revenue", "large-heavy")-chart = BarChart(labels, [s1, s2], "grouped")-labels = ["Oct", "Nov", "Dec"]-s1 = Series("Product A", [120, 150, 180])-s2 = Series("Product B", [90, 110, 140])--Example 3 — Form with validation:--root = Stack([title, form])-title = TextContent("Contact Us", "large-heavy")-form = Form("contact", btns, [nameField, emailField, countryField, msgField])-nameField = FormControl("Name", Input("name", "Your name", "text", { required: true, minLength: 2 }))-emailField = FormControl("Email", Input("email", "[email protected]", "email", { required: true, email: true }))-countryField = FormControl("Country", Select("country", countryOpts, "Select...", { required: true }))-msgField = FormControl("Message", TextArea("message", "Tell us more...", 4, { required: true, minLength: 10 }))-countryOpts = [SelectItem("us", "United States"), SelectItem("uk", "United Kingdom"), SelectItem("de", "Germany")]-btns = Buttons([Button("Submit", Action([@ToAssistant("Submit")]), "primary"), Button("Cancel", Action([@ToAssistant("Cancel")]), "secondary")])--Example 4 — Tabs with mixed content:--root = Stack([title, tabs])-title = TextContent("React vs Vue", "large-heavy")-tabs = Tabs([tabReact, tabVue])-tabReact = TabItem("react", "React", reactContent)-tabVue = TabItem("vue", "Vue", vueContent)-reactContent = [TextContent("React is a library by Meta for building UIs."), Callout("info", "Note", "React uses JSX syntax.")]-vueContent = [TextContent("Vue is a progressive framework by Evan You."), Callout("success", "Tip", "Vue has a gentle learning curve.")]--## Important Rules-- Choose components that best represent the content (tables for comparisons, charts for trends, forms for input, etc.)--## Final Verification-Before finishing, walk your output and verify:-1. root = Stack(...) is the FIRST line (for optimal streaming).-2. Every referenced name is defined. Every defined name (other than root) is reachable from root.diff --git a/docs/package.json b/docs/package.jsonindex 167fd687f..044bc98b9 100644--- a/docs/package.json+++ b/docs/package.json@@ -3,7 +3,7 @@"version": "0.0.0","private": true,"scripts": {- "generate:prompts": "pnpm --filter @openuidev/cli build && pnpm exec openui generate lib/chat-library.ts --out generated/chat-system-prompt.txt && pnpm exec openui generate lib/playground-library.ts --out generated/playground-system-prompt.txt && pnpm exec openui generate lib/playground-library.ts --json-schema --out generated/playground-component-spec.json",+ "generate:prompts": "pnpm --filter @openuidev/cli build && pnpm exec openui generate lib/chat-library.ts --spec --out generated/chat-library.spec.json && pnpm exec openui generate lib/playground-library.ts --spec --out generated/playground-library.spec.json","fetch:tweets": "node scripts/fetch-static-tweets.mjs","build": "next build --no-mangling","dev": "pnpm generate:prompts && next dev",