Skip to content

The Open Standard for Generative UI

71.1 KB
Raw Blame
{
  "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 | Steps | ListBlock | FollowUpBlock | SectionBlock | Tabs | Carousel)[])",
      "description": "Vertical container for all content in a chat response. Children stack top to bottom automatically."
    },
    "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)",
      "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)",
      "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)",
      "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, 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\")",
      "description": "A list of items with number or image indicators. Each item can optionally have an action."
    },
    "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 | Steps | ListBlock | FollowUpBlock)[])",
      "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 | Steps)[])",
      "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 | Steps)[])",
      "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 | Steps)[][], variant?: \"card\" | \"sunk\")",
      "description": "Horizontal scrollable carousel"
    },
    "TagBlock": {
      "signature": "TagBlock(tags: string[])",
      "description": "tags is an array of strings"
    },
    "Tag": {
      "signature": "Tag(text: string, icon?: string, size?: \"sm\" | \"md\" | \"lg\", variant?: \"neutral\" | \"info\" | \"success\" | \"warning\" | \"danger\")",
      "description": "Styled tag/badge with optional icon and variant"
    }
  },
  "componentGroups": [
    {
      "name": "Content",
      "components": [
        "CardHeader",
        "TextContent",
        "MarkDownRenderer",
        "Callout",
        "TextCallout",
        "Image",
        "ImageBlock",
        "ImageGallery",
        "CodeBlock",
        "Separator"
      ]
    },
    {
      "name": "Tables",
      "components": [
        "Table",
        "Col"
      ]
    },
    {
      "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"
      ],
      "notes": [
        "- 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"
      ]
    },
    {
      "name": "Buttons",
      "components": [
        "Button",
        "Buttons"
      ]
    },
    {
      "name": "Lists & Follow-ups",
      "components": [
        "ListBlock",
        "ListItem",
        "FollowUpBlock",
        "FollowUpItem"
      ],
      "notes": [
        "- 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\")"
      ]
    },
    {
      "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"
      ]
    }
  ],
  "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"
      }
    },
    "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"
    ],
    "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/ListBlock"
                },
                {
                  "$ref": "#/$defs/FollowUpBlock"
                },
                {
                  "$ref": "#/$defs/SectionBlock"
                },
                {
                  "$ref": "#/$defs/Tabs"
                },
                {
                  "$ref": "#/$defs/Carousel"
                }
              ]
            }
          }
        },
        "required": [
          "children"
        ],
        "additionalProperties": false,
        "description": "Vertical container for all content in a chat response. Children stack top to bottom automatically."
      },
      "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"
      },
      "ListBlock": {
        "type": "object",
        "properties": {
          "items": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/ListItem"
            }
          },
          "variant": {
            "type": "string",
            "enum": [
              "number",
              "image"
            ]
          }
        },
        "required": [
          "items"
        ],
        "additionalProperties": false,
        "description": "A list of items with number or image indicators. Each item can optionally have an action."
      },
      "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": {}
        },
        "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."
      },
      "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/Steps"
                },
                {
                  "$ref": "#/$defs/ListBlock"
                },
                {
                  "$ref": "#/$defs/FollowUpBlock"
                }
              ]
            }
          }
        },
        "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/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"
      },
      "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"
      }
    }
  }
}