Skip to content

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.ts
index 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.ts
index 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.ts
index 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.json
new file mode 100644
index 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.txt
deleted file mode 100644
index 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.json
deleted file mode 100644
index 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.json
new file mode 100644
index 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.txt
deleted file mode 100644
index 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.json
index 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",