@flikk/ui 1.0.0-beta.30 → 1.0.0-beta.32

package/dist/components/generative/schema.generated.js

@@ -48,6 +48,59 @@ const GENERATIVE_SCHEMA = {
                 }
             }
         },
+        "ActivityRings": {
+            "role": "leaf",
+            "description": "Concentric circular progress rings (auto Card shell).",
+            "props": {
+                "rings": {
+                    "kind": "shape",
+                    "shape": "activityRings",
+                    "required": true,
+                    "description": "Array of rings (ordered from outer to inner)"
+                },
+                "centerLabel": {
+                    "kind": "text",
+                    "description": "Center label content (text or ReactNode)"
+                },
+                "centerSuffix": {
+                    "kind": "string",
+                    "description": "Optional suffix for center label (e.g., \"cal\", \"steps\")"
+                },
+                "size": {
+                    "kind": "union",
+                    "types": [
+                        "number",
+                        "string"
+                    ],
+                    "description": "Size of the chart (px or string with units)"
+                },
+                "strokeWidth": {
+                    "kind": "number",
+                    "description": "Ring stroke width (default: 12)"
+                },
+                "gap": {
+                    "kind": "number",
+                    "description": "Gap between rings (default: 8)"
+                },
+                "showAnimation": {
+                    "kind": "boolean",
+                    "description": "Whether to show animations (default: true)"
+                },
+                "colors": {
+                    "kind": "shape",
+                    "shape": "colorList",
+                    "description": "Custom color palette for rings. Colors are applied in order from outer to inner ring."
+                },
+                "title": {
+                    "kind": "text",
+                    "description": "Card header title (the auto shell)"
+                },
+                "subtitle": {
+                    "kind": "text",
+                    "description": "Card header subtitle (the auto shell)"
+                }
+            }
+        },
         "Alert": {
             "role": "leaf",
             "description": "Inline callout with semantic color.",
@@ -55,7 +108,7 @@ const GENERATIVE_SCHEMA = {
                 "color": {
                     "kind": "enum",
                     "options": [
-                        "neutral",
+                        "mono",
                         "primary",
                         "success",
                         "warning",
@@ -168,15 +221,6 @@ const GENERATIVE_SCHEMA = {
                         "gradient"
                     ]
                 },
-                "barRadius": {
-                    "kind": "number"
-                },
-                "cellRadius": {
-                    "kind": "number"
-                },
-                "gap": {
-                    "kind": "number"
-                },
                 "curveType": {
                     "kind": "enum",
                     "options": [
@@ -197,6 +241,16 @@ const GENERATIVE_SCHEMA = {
                 }
             }
         },
+        "AspectRatio": {
+            "role": "container",
+            "description": "Fixed-ratio box. Children are spec nodes.",
+            "props": {
+                "ratio": {
+                    "kind": "number",
+                    "description": "The desired ratio (width / height). e.g., 16/9, 4/3, 1"
+                }
+            }
+        },
         "Avatar": {
             "role": "leaf",
             "description": "User avatar with initials fallback.",
@@ -216,7 +270,7 @@ const GENERATIVE_SCHEMA = {
                         "string"
                     ],
                     "default": "md",
-                    "description": "The size of the avatar"
+                    "description": "The size of the avatar — a named rung (`\"md\"`) or an exact pixel size"
                 },
                 "status": {
                     "kind": "enum",
@@ -289,16 +343,6 @@ const GENERATIVE_SCHEMA = {
                     "default": "md",
                     "description": "Size for all avatars in the group"
                 },
-                "spacing": {
-                    "kind": "enum",
-                    "options": [
-                        "tight",
-                        "normal",
-                        "loose"
-                    ],
-                    "default": "normal",
-                    "description": "Amount of overlap between avatars (higher value = more overlap)"
-                },
                 "direction": {
                     "kind": "enum",
                     "options": [
@@ -336,13 +380,13 @@ const GENERATIVE_SCHEMA = {
                         "outline",
                         "soft"
                     ],
-                    "default": "filled",
-                    "description": "The visual style variant of the badge (filled, outline, soft)"
+                    "default": "soft",
+                    "description": "The visual style variant of the badge."
                 },
                 "color": {
                     "kind": "enum",
                     "options": [
-                        "neutral",
+                        "mono",
                         "primary",
                         "success",
                         "warning",
@@ -373,11 +417,6 @@ const GENERATIVE_SCHEMA = {
                 "iconStart": {
                     "kind": "icon",
                     "description": "Icon element at the start (before content)"
-                },
-                "disabled": {
-                    "kind": "boolean",
-                    "default": false,
-                    "description": "Whether the badge is disabled"
                 }
             }
         },
@@ -464,47 +503,6 @@ const GENERATIVE_SCHEMA = {
                         "gradient"
                     ]
                 },
-                "dotRadius": {
-                    "kind": "number"
-                },
-                "cellRadius": {
-                    "kind": "number"
-                },
-                "strokeWidth": {
-                    "kind": "number"
-                },
-                "curved": {
-                    "kind": "boolean"
-                },
-                "curveType": {
-                    "kind": "enum",
-                    "options": [
-                        "linear",
-                        "monotone",
-                        "step",
-                        "stepBefore",
-                        "stepAfter"
-                    ]
-                },
-                "showDots": {
-                    "kind": "boolean"
-                },
-                "fillOpacity": {
-                    "kind": "number"
-                },
-                "showStroke": {
-                    "kind": "boolean"
-                },
-                "stacked": {
-                    "kind": "boolean"
-                },
-                "orientation": {
-                    "kind": "enum",
-                    "options": [
-                        "vertical",
-                        "horizontal"
-                    ]
-                },
                 "title": {
                     "kind": "text",
                     "description": "Card header title (the auto shell)"
@@ -550,7 +548,7 @@ const GENERATIVE_SCHEMA = {
                 "color": {
                     "kind": "enum",
                     "options": [
-                        "neutral",
+                        "mono",
                         "primary",
                         "danger"
                     ],
@@ -592,37 +590,96 @@ const GENERATIVE_SCHEMA = {
                     "kind": "boolean",
                     "description": "Whether the button should be full width"
                 },
+                "iconStart": {
+                    "kind": "icon",
+                    "description": "Small decorative icon before the label, auto-sized to the button's `size`."
+                },
+                "iconEnd": {
+                    "kind": "icon",
+                    "description": "Small decorative icon after the label, auto-sized to the button's `size`. See `iconStart`."
+                },
                 "children": {
                     "kind": "text",
                     "description": "Button contents"
                 },
                 "enableRipple": {
                     "kind": "boolean",
-                    "description": "Whether to enable ripple effect on click"
+                    "default": true,
+                    "description": "Whether to show the press ripple."
                 },
-                "rippleEffect": {
+                "showReflection": {
+                    "kind": "boolean",
+                    "description": "Whether to show the glass reflection effect (default: true)"
+                }
+            }
+        },
+        "ButtonGroup": {
+            "role": "container",
+            "description": "Groups adjacent Buttons with joined borders. Children are spec nodes (Button leaves).",
+            "props": {
+                "orientation": {
                     "kind": "enum",
                     "options": [
-                        "default",
-                        "neon",
-                        "aurora",
-                        "particle",
-                        "glass",
-                        "echo"
+                        "horizontal",
+                        "vertical"
                     ],
-                    "description": "Type of ripple effect: 'default' | 'aurora' | 'particle' | 'glass' | 'neon' | 'echo'"
+                    "description": "The layout direction of the button group"
+                }
+            }
+        },
+        "Calendar": {
+            "role": "leaf",
+            "description": "Date picker grid (range mode not supported in generative specs). value/minDate/maxDate accept ISO date strings, coerced to Date internally. Bind node.actions.change to onChange (fires with the selected ISO date string).",
+            "props": {
+                "showToday": {
+                    "kind": "boolean",
+                    "description": "Whether to highlight today's date (default: true)"
                 },
-                "rippleClassName": {
-                    "kind": "string",
-                    "description": "Custom class name for ripple styling"
+                "selectTodayByDefault": {
+                    "kind": "boolean",
+                    "description": "Auto-select today's date when calendar opens without a value (default: false)"
                 },
-                "rippleScale": {
-                    "kind": "number",
-                    "description": "Scale multiplier for ripple expansion (default: 10)"
+                "size": {
+                    "kind": "enum",
+                    "options": [
+                        "sm",
+                        "md",
+                        "lg"
+                    ],
+                    "description": "Size variant"
                 },
-                "showReflection": {
+                "headerMode": {
+                    "kind": "enum",
+                    "options": [
+                        "dropdown",
+                        "static",
+                        "mixed"
+                    ],
+                    "description": "Header display mode - dropdown (default), static text, or mixed (default: 'dropdown')"
+                },
+                "enableMonthDropdown": {
                     "kind": "boolean",
-                    "description": "Whether to show the glass reflection effect (default: true)"
+                    "description": "Whether to enable month dropdown instead of navigation arrows (default: true)"
+                },
+                "enableYearDropdown": {
+                    "kind": "boolean",
+                    "description": "Whether to enable year dropdown instead of navigation arrows (default: true)"
+                },
+                "showOtherMonthDays": {
+                    "kind": "boolean",
+                    "description": "Whether to show days from adjacent months (default: true)"
+                },
+                "value": {
+                    "kind": "string",
+                    "description": "Selected date, ISO format (e.g. \"2024-01-01\")"
+                },
+                "minDate": {
+                    "kind": "string",
+                    "description": "Minimum selectable date, ISO format"
+                },
+                "maxDate": {
+                    "kind": "string",
+                    "description": "Maximum selectable date, ISO format"
                 }
             }
         },
@@ -640,6 +697,131 @@ const GENERATIVE_SCHEMA = {
                 }
             }
         },
+        "Checkbox": {
+            "role": "leaf",
+            "description": "Single checkbox. `value` is its HTML group-identity string, NOT the checked state. Bind node.actions.change to onChange — only the checked boolean (first argument) reaches the action, the value argument is dropped.",
+            "props": {
+                "value": {
+                    "kind": "string",
+                    "required": true
+                },
+                "indeterminate": {
+                    "kind": "boolean"
+                },
+                "label": {
+                    "kind": "text"
+                },
+                "description": {
+                    "kind": "text"
+                },
+                "state": {
+                    "kind": "enum",
+                    "options": [
+                        "default",
+                        "disabled",
+                        "invalid"
+                    ]
+                },
+                "size": {
+                    "kind": "enum",
+                    "options": [
+                        "sm",
+                        "md",
+                        "lg"
+                    ]
+                },
+                "checked": {
+                    "kind": "boolean",
+                    "description": "Whether the checkbox is checked"
+                },
+                "disabled": {
+                    "kind": "boolean",
+                    "description": "Whether the checkbox is disabled"
+                },
+                "required": {
+                    "kind": "boolean",
+                    "description": "Marks this field as required. A parent Form refuses to submit while it is empty, and lists it in the form's error summary."
+                },
+                "name": {
+                    "kind": "string",
+                    "description": "Field name. Required for this control's value to be included when a parent Form is submitted. Must match /^[A-Za-z_][A-Za-z0-9_-]*$/."
+                }
+            }
+        },
+        "Combobox": {
+            "role": "leaf",
+            "description": "Searchable single-select. Bind node.actions.change to onChange (fires with the selected option's value, or undefined when cleared).",
+            "props": {
+                "options": {
+                    "kind": "shape",
+                    "shape": "optionItems",
+                    "required": true,
+                    "description": "Array of options to display"
+                },
+                "placeholder": {
+                    "kind": "string",
+                    "description": "Placeholder text when no value is selected"
+                },
+                "label": {
+                    "kind": "text",
+                    "description": "Label text displayed above the input"
+                },
+                "helperText": {
+                    "kind": "text",
+                    "description": "Helper text displayed below the input"
+                },
+                "size": {
+                    "kind": "enum",
+                    "options": [
+                        "sm",
+                        "md",
+                        "lg"
+                    ],
+                    "description": "Size variant"
+                },
+                "state": {
+                    "kind": "enum",
+                    "options": [
+                        "default",
+                        "disabled",
+                        "invalid"
+                    ],
+                    "description": "State variant (controls styling)"
+                },
+                "clearable": {
+                    "kind": "boolean",
+                    "description": "Whether the clear button is shown (default: true)"
+                },
+                "iconStart": {
+                    "kind": "icon",
+                    "description": "Icon displayed at the start of the input"
+                },
+                "iconEnd": {
+                    "kind": "icon",
+                    "description": "Icon displayed at the end of the input"
+                },
+                "openOnFocus": {
+                    "kind": "boolean",
+                    "description": "Whether to open dropdown on focus (default: true)"
+                },
+                "emptyMessage": {
+                    "kind": "string",
+                    "description": "Message shown when no options match the filter"
+                },
+                "required": {
+                    "kind": "boolean",
+                    "description": "Whether the input is required"
+                },
+                "name": {
+                    "kind": "string",
+                    "description": "Field name. Required for this control's value to be included when a parent Form is submitted. Must match /^[A-Za-z_][A-Za-z0-9_-]*$/."
+                },
+                "value": {
+                    "kind": "string",
+                    "description": "Currently selected value (controlled)"
+                }
+            }
+        },
         "ComboChart": {
             "role": "leaf",
             "description": "Combined bar+line chart — per-series type via config[key].type (auto Card shell).",
@@ -731,10 +913,10 @@ const GENERATIVE_SCHEMA = {
                 "barRadius": {
                     "kind": "number"
                 },
-                "dotRadius": {
+                "gap": {
                     "kind": "number"
                 },
-                "cellRadius": {
+                "dotRadius": {
                     "kind": "number"
                 },
                 "radius": {
@@ -743,15 +925,6 @@ const GENERATIVE_SCHEMA = {
                 "strokeWidth": {
                     "kind": "number"
                 },
-                "gap": {
-                    "kind": "number"
-                },
-                "fillOpacity": {
-                    "kind": "number"
-                },
-                "showStroke": {
-                    "kind": "boolean"
-                },
                 "title": {
                     "kind": "text",
                     "description": "Card header title (the auto shell)"
@@ -762,15 +935,64 @@ const GENERATIVE_SCHEMA = {
                 }
             }
         },
-        "DescriptionList": {
+        "CommandPalette": {
             "role": "leaf",
-            "description": "Label/value pairs driven by a serializable items array.",
+            "description": "Searchable command list, rendered as a full-screen modal overlay (pair with node.actions.select/close).",
             "props": {
-                "variant": {
-                    "kind": "enum",
-                    "options": [
-                        "vertical",
-                        "horizontal"
+                "commands": {
+                    "kind": "shape",
+                    "shape": "commandItems",
+                    "required": true,
+                    "description": "Array of commands or command groups"
+                },
+                "placeholder": {
+                    "kind": "string",
+                    "description": "Placeholder text for search input"
+                },
+                "emptyMessage": {
+                    "kind": "string",
+                    "description": "Custom empty state message"
+                },
+                "maxHeight": {
+                    "kind": "union",
+                    "types": [
+                        "number",
+                        "string"
+                    ],
+                    "description": "Maximum height of the command list"
+                },
+                "grouped": {
+                    "kind": "boolean",
+                    "description": "Whether to group commands by category"
+                },
+                "elevation": {
+                    "kind": "union",
+                    "types": [
+                        "number",
+                        "string"
+                    ],
+                    "description": "Pin the surface elevation rung (overrides the automatic relative lift)."
+                },
+                "lift": {
+                    "kind": "boolean",
+                    "description": "`false` opts out of the relative lift — paints at the palette's base rung."
+                },
+                "isOpen": {
+                    "kind": "boolean",
+                    "description": "Always rendered open in a generative spec.",
+                    "default": true
+                }
+            }
+        },
+        "DescriptionList": {
+            "role": "leaf",
+            "description": "Label/value pairs driven by a serializable items array.",
+            "props": {
+                "variant": {
+                    "kind": "enum",
+                    "options": [
+                        "horizontal",
+                        "vertical"
                     ],
                     "description": "Layout variant: \"horizontal\" (default) or \"vertical\""
                 },
@@ -855,6 +1077,22 @@ const GENERATIVE_SCHEMA = {
                 }
             }
         },
+        "DotSeparator": {
+            "role": "leaf",
+            "description": "Small dot glyph used as an inline separator.",
+            "props": {
+                "size": {
+                    "kind": "enum",
+                    "options": [
+                        "sm",
+                        "md",
+                        "lg"
+                    ],
+                    "default": "md",
+                    "description": "The size of the dot (also scales its horizontal spacing)"
+                }
+            }
+        },
         "Empty": {
             "role": "leaf",
             "description": "Empty-state placeholder with icon, title and subtitle.",
@@ -896,6 +1134,128 @@ const GENERATIVE_SCHEMA = {
                 }
             }
         },
+        "Form": {
+            "role": "container",
+            "description": "A form that collects structured input from the user. Children with a `name` prop become fields; submitting delivers all field values at once in a single action. Use this whenever you need information from the user rather than free text.",
+            "props": {
+                "title": {
+                    "kind": "text",
+                    "description": "Heading for the form. Also becomes its accessible name."
+                },
+                "description": {
+                    "kind": "text",
+                    "description": "Optional helper text shown above the fields."
+                },
+                "submitLabel": {
+                    "kind": "string",
+                    "default": "Submit",
+                    "description": "Label for the submit button. A button is rendered automatically when the form's children do not include one."
+                },
+                "errorSummaryTitle": {
+                    "kind": "text",
+                    "default": "Please fix the following before continuing:",
+                    "description": "Heading for the error summary shown when submit is blocked because a required field is empty. Set it to match the spec's language."
+                }
+            }
+        },
+        "GanttChart": {
+            "role": "leaf",
+            "description": "Project timeline chart. startDate/endDate and task dates accept ISO date strings directly (the real prop type is Date | string). Custom columns are not supported (uses the built-in default columns). Bind node.actions.taskClick to onTaskClick.",
+            "props": {
+                "data": {
+                    "kind": "shape",
+                    "shape": "ganttTasks",
+                    "required": true
+                },
+                "groups": {
+                    "kind": "shape",
+                    "shape": "ganttGroups",
+                    "required": true
+                },
+                "todayMarker": {
+                    "kind": "boolean"
+                },
+                "scrollToToday": {
+                    "kind": "boolean"
+                },
+                "showTable": {
+                    "kind": "boolean"
+                },
+                "showDependencies": {
+                    "kind": "boolean"
+                },
+                "showTaskLabels": {
+                    "kind": "enum",
+                    "options": [
+                        "none",
+                        "auto",
+                        "inside",
+                        "outside"
+                    ]
+                },
+                "readonly": {
+                    "kind": "boolean"
+                },
+                "readonlyDates": {
+                    "kind": "boolean"
+                },
+                "readonlyProgress": {
+                    "kind": "boolean"
+                },
+                "zoom": {
+                    "kind": "enum",
+                    "options": [
+                        "day",
+                        "week",
+                        "quarter",
+                        "month",
+                        "year"
+                    ]
+                },
+                "defaultZoom": {
+                    "kind": "enum",
+                    "options": [
+                        "day",
+                        "week",
+                        "quarter",
+                        "month",
+                        "year"
+                    ]
+                },
+                "hideCompleted": {
+                    "kind": "boolean"
+                },
+                "defaultHideCompleted": {
+                    "kind": "boolean"
+                },
+                "tablePanelWidth": {
+                    "kind": "number"
+                },
+                "defaultTablePanelWidth": {
+                    "kind": "number"
+                },
+                "gridLines": {
+                    "kind": "enum",
+                    "options": [
+                        "none",
+                        "horizontal",
+                        "vertical",
+                        "both"
+                    ]
+                },
+                "rowHeight": {
+                    "kind": "number"
+                },
+                "startDate": {
+                    "kind": "string",
+                    "description": "Visible range start, ISO date format"
+                },
+                "endDate": {
+                    "kind": "string",
+                    "description": "Visible range end, ISO date format"
+                }
+            }
+        },
         "Grid": {
             "role": "container",
             "description": "Responsive CSS-grid container. Children are spec nodes.",
@@ -903,6 +1263,7 @@ const GENERATIVE_SCHEMA = {
                 "as": {
                     "kind": "enum",
                     "options": [
+                        "form",
                         "div",
                         "ul",
                         "ol",
@@ -911,7 +1272,6 @@ const GENERATIVE_SCHEMA = {
                         "header",
                         "footer",
                         "aside",
-                        "form",
                         "fieldset"
                     ],
                     "default": "div",
@@ -971,119 +1331,70 @@ const GENERATIVE_SCHEMA = {
                 }
             }
         },
-        "KPI": {
+        "Heatmap": {
             "role": "leaf",
-            "description": "KPI stat with trend and progress bar (auto Card shell).",
+            "description": "Calendar/matrix heatmap (auto Card shell). Bind node.actions.cellClick to onCellClick (fires with the clicked cell's data).",
             "props": {
-                "value": {
-                    "kind": "text",
-                    "required": true,
-                    "description": "The main metric value to display (e.g. \"$25.5M\", \"1,234\", \"89%\")"
-                },
-                "label": {
-                    "kind": "text",
-                    "description": "Label describing the metric (e.g. \"Fund raised\", \"Total Revenue\")"
-                },
-                "trend": {
-                    "kind": "number",
-                    "description": "Percentage change value (e.g. 20, -5.3). Determines trend direction & color."
-                },
-                "trendLabel": {
-                    "kind": "text",
-                    "description": "Custom trend label override (default: auto-formats as \"+20%\" or \"-5.3%\")"
-                },
-                "progress": {
-                    "kind": "number",
-                    "description": "Progress value from 0-100. Controls how many bars are filled."
-                },
-                "barCount": {
-                    "kind": "number",
-                    "default": 24,
-                    "description": "Total number of bars in the visualization."
-                },
-                "subtitle": {
-                    "kind": "text",
-                    "description": "Subtitle text below the bars (e.g. \"Compared to last month\")"
-                },
-                "icon": {
-                    "kind": "icon",
-                    "description": "Icon to display before the label."
-                },
-                "size": {
+                "legend": {
                     "kind": "enum",
                     "options": [
-                        "sm",
-                        "md",
-                        "lg"
+                        "top",
+                        "bottom",
+                        "none"
                     ],
-                    "default": "md",
-                    "description": "Size variant."
+                    "default": "bottom",
+                    "description": "Colour-ramp legend position — Heatmap draws its own gradient ramp, not per-series swatches from `config`. Always defaults to 'bottom' when omitted."
+                },
+                "data": {
+                    "kind": "shape",
+                    "shape": "heatmapPoints",
+                    "description": "Heatmap data array — optional when using ChartContainer context"
                 },
                 "color": {
                     "kind": "enum",
                     "options": [
-                        "neutral",
+                        "mono",
                         "primary",
                         "success",
                         "warning",
                         "danger"
                     ],
                     "default": "primary",
-                    "description": "Color for the filled bars and positive trend."
-                }
-            }
-        },
-        "LineChart": {
-            "role": "leaf",
-            "description": "Line chart (auto Card shell + shared-height container).",
-            "props": {
-                "color": {
-                    "kind": "enum",
-                    "options": [
-                        "primary",
-                        "success",
-                        "warning",
-                        "danger"
-                    ]
-                },
-                "dotRadius": {
-                    "kind": "number"
-                },
-                "radius": {
-                    "kind": "number"
-                },
-                "strokeWidth": {
-                    "kind": "number"
-                },
-                "curved": {
-                    "kind": "boolean"
+                    "description": "Semantic colour for heatmap cells"
                 },
-                "curveType": {
+                "variant": {
                     "kind": "enum",
                     "options": [
-                        "linear",
-                        "monotone"
-                    ]
-                },
-                "showDots": {
-                    "kind": "boolean"
-                },
-                "data": {
-                    "kind": "shape",
-                    "shape": "chartData",
-                    "required": true
+                        "default",
+                        "minimal"
+                    ],
+                    "default": "default",
+                    "description": "Visual variant"
                 },
-                "config": {
+                "legendLabels": {
                     "kind": "shape",
-                    "shape": "chartConfig",
-                    "required": true
+                    "shape": "heatmapLegendLabels",
+                    "default": "{ min: 'Low activity', max: 'High activity' }",
+                    "description": "Captions at each end of the colour ramp."
                 },
-                "width": {
+                "cellGap": {
                     "kind": "union",
                     "types": [
                         "number",
                         "string"
-                    ]
+                    ],
+                    "default": 6,
+                    "description": "Gap between cells"
+                },
+                "minOpacity": {
+                    "kind": "number",
+                    "default": 0.1,
+                    "description": "Opacity floor for zero/lowest-intensity cells"
+                },
+                "showTooltip": {
+                    "kind": "boolean",
+                    "default": true,
+                    "description": "Show the hover tooltip"
                 },
                 "height": {
                     "kind": "union",
@@ -1092,11 +1403,12 @@ const GENERATIVE_SCHEMA = {
                         "string"
                     ]
                 },
-                "enableKeyboardNavigation": {
-                    "kind": "boolean"
-                },
-                "showGrid": {
-                    "kind": "boolean"
+                "width": {
+                    "kind": "union",
+                    "types": [
+                        "number",
+                        "string"
+                    ]
                 },
                 "showXAxis": {
                     "kind": "boolean"
@@ -1104,15 +1416,6 @@ const GENERATIVE_SCHEMA = {
                 "showYAxis": {
                     "kind": "boolean"
                 },
-                "legend": {
-                    "kind": "enum",
-                    "options": [
-                        "top",
-                        "bottom",
-                        "none"
-                    ],
-                    "description": "Always-visible legend position, rendered from `config`'s labels/colors."
-                },
                 "minValue": {
                     "kind": "number"
                 },
@@ -1129,22 +1432,987 @@ const GENERATIVE_SCHEMA = {
                 }
             }
         },
-        "Metric": {
-            "role": "leaf",
-            "description": "Single business metric with optional icon and trend.",
+        "HeroCard": {
+            "role": "container",
+            "description": "Gradient hero shell with an ambient blurred backdrop image. Children are spec nodes rendered above the backdrop.",
             "props": {
-                "value": {
-                    "kind": "union",
-                    "types": [
-                        "number",
-                        "string"
-                    ],
-                    "required": true,
-                    "description": "The main value to display (number or formatted string)"
+                "image": {
+                    "kind": "string",
+                    "description": "Backdrop image src. Defaults to the bundled `/bg/3.webp`"
+                },
+                "imageBlur": {
+                    "kind": "number",
+                    "default": 24,
+                    "description": "Backdrop blur radius in px."
+                },
+                "imageScale": {
+                    "kind": "number",
+                    "default": 1.25,
+                    "description": "Backdrop scale factor — zooming the abstract blobs in/out reframes the texture."
+                },
+                "imageOpacity": {
+                    "kind": "number",
+                    "default": 0.5,
+                    "description": "Backdrop opacity, 0–1."
+                },
+                "imageBlend": {
+                    "kind": "enum",
+                    "options": [
+                        "overlay",
+                        "multiply",
+                        "soft-light",
+                        "hard-light",
+                        "screen",
+                        "luminosity",
+                        "normal"
+                    ],
+                    "default": "multiply",
+                    "description": "Blend mode compositing the image over the gradient."
+                },
+                "imagePosition": {
+                    "kind": "string",
+                    "default": "center",
+                    "description": "CSS `background-position` — e.g. `\"top right\"`, `\"30% 70%\"`."
+                },
+                "parallax": {
+                    "kind": "boolean",
+                    "default": false,
+                    "description": "On pointer hover, drift the backdrop image opposite the cursor (damped) for a"
+                },
+                "parallaxIntensity": {
+                    "kind": "number",
+                    "default": 32,
+                    "description": "Max backdrop travel in px (each direction) when `parallax` is on. Auto-clamped"
+                }
+            }
+        },
+        "HorizontalBarChart": {
+            "role": "leaf",
+            "description": "Horizontal bar chart — categories down the left, values extending right. Prefer over BarChart when category names are long or numerous, or when ranking items.",
+            "props": {
+                "categoryGap": {
+                    "kind": "number",
+                    "description": "Gap between category rows."
+                },
+                "categoryWidth": {
+                    "kind": "number",
+                    "default": 120,
+                    "description": "Width reserved for the category labels running down the left. Category names are"
+                },
+                "colors": {
+                    "kind": "shape",
+                    "shape": "colorList",
+                    "description": "Custom color palette for bar series, applied in order and cycled if there are more"
+                },
+                "showAnimation": {
+                    "kind": "boolean",
+                    "description": "Whether to play the staggered grow-from-left entrance on mount."
+                },
+                "data": {
+                    "kind": "shape",
+                    "shape": "chartData",
+                    "required": true
+                },
+                "config": {
+                    "kind": "shape",
+                    "shape": "chartConfig",
+                    "required": true
+                },
+                "width": {
+                    "kind": "union",
+                    "types": [
+                        "number",
+                        "string"
+                    ]
+                },
+                "height": {
+                    "kind": "union",
+                    "types": [
+                        "number",
+                        "string"
+                    ]
+                },
+                "enableKeyboardNavigation": {
+                    "kind": "boolean"
+                },
+                "showXAxis": {
+                    "kind": "boolean"
+                },
+                "showYAxis": {
+                    "kind": "boolean"
+                },
+                "minValue": {
+                    "kind": "number"
+                },
+                "maxValue": {
+                    "kind": "number"
+                },
+                "showGrid": {
+                    "kind": "boolean"
+                },
+                "legend": {
+                    "kind": "enum",
+                    "options": [
+                        "top",
+                        "bottom",
+                        "none"
+                    ],
+                    "description": "Always-visible legend position, rendered from `config`'s labels/colors."
+                },
+                "barRadius": {
+                    "kind": "number"
+                },
+                "gap": {
+                    "kind": "number"
+                },
+                "radius": {
+                    "kind": "number"
+                },
+                "title": {
+                    "kind": "text",
+                    "description": "Card header title (the auto shell)"
+                },
+                "subtitle": {
+                    "kind": "text",
+                    "description": "Card header subtitle (the auto shell)"
+                }
+            }
+        },
+        "Icon": {
+            "role": "leaf",
+            "description": "Brand/payment/file-type glyph. `icon` is a name from IconName (payment/social/filetype glyphs) — a DIFFERENT, separate namespace from the icon-slot names (iconStart/iconEnd etc.) used elsewhere in this schema.",
+            "props": {
+                "icon": {
+                    "kind": "enum",
+                    "options": [
+                        "visa",
+                        "mastercard",
+                        "amex",
+                        "applepay",
+                        "paypal",
+                        "github",
+                        "x",
+                        "linkedin",
+                        "instagram",
+                        "facebook",
+                        "youtube",
+                        "discord",
+                        "dribbble",
+                        "tiktok",
+                        "reddit",
+                        "twitch",
+                        "slack",
+                        "medium",
+                        "pinterest",
+                        "snapchat",
+                        "whatsapp",
+                        "telegram",
+                        "google",
+                        "apple",
+                        "pdf",
+                        "doc",
+                        "docx",
+                        "txt",
+                        "xls",
+                        "xlsx",
+                        "csv",
+                        "ppt",
+                        "mp3",
+                        "wav",
+                        "mp4",
+                        "mov",
+                        "jpg",
+                        "png",
+                        "svg",
+                        "gif",
+                        "zip",
+                        "rar"
+                    ],
+                    "required": true
+                },
+                "size": {
+                    "kind": "union",
+                    "types": [
+                        "number",
+                        "string"
+                    ],
+                    "description": "Named size preset or custom pixel value. Payment icons scale at 3:2 ratio; others are square."
+                },
+                "colorMode": {
+                    "kind": "enum",
+                    "options": [
+                        "color",
+                        "mono"
+                    ]
+                }
+            }
+        },
+        "Input": {
+            "role": "leaf",
+            "description": "Single-line text input. Bind node.actions.change to onValueChange (fires with the raw string value).",
+            "props": {
+                "size": {
+                    "kind": "enum",
+                    "options": [
+                        "sm",
+                        "md",
+                        "lg"
+                    ],
+                    "description": "The size of the input"
+                },
+                "state": {
+                    "kind": "enum",
+                    "options": [
+                        "default",
+                        "disabled",
+                        "invalid"
+                    ],
+                    "description": "The state of the input (default, disabled, invalid)"
+                },
+                "type": {
+                    "kind": "enum",
+                    "options": [
+                        "number",
+                        "hidden",
+                        "color",
+                        "week",
+                        "month",
+                        "text",
+                        "password",
+                        "email",
+                        "tel",
+                        "url",
+                        "search",
+                        "date",
+                        "time",
+                        "datetime-local",
+                        "file",
+                        "image",
+                        "range",
+                        "reset",
+                        "submit",
+                        "creditCard",
+                        "expiryDate",
+                        "phone",
+                        "ssn",
+                        "currency"
+                    ],
+                    "description": "The type of input. In addition to standard HTML types,"
+                },
+                "label": {
+                    "kind": "text",
+                    "description": "Optional label for the input — pass a string for default styling, or a ReactNode for full control"
+                },
+                "helperText": {
+                    "kind": "text",
+                    "description": "Optional helper text below the input — pass a string for default styling, or a ReactNode for full control"
+                },
+                "errorMessage": {
+                    "kind": "text",
+                    "description": "Error message shown instead of `helperText` when `state=\"invalid\"`."
+                },
+                "iconStart": {
+                    "kind": "icon",
+                    "description": "Icon to display before the input (small decorative)"
+                },
+                "iconEnd": {
+                    "kind": "icon",
+                    "description": "Icon to display after the input (small decorative)"
+                },
+                "required": {
+                    "kind": "boolean",
+                    "description": "Whether the input is required"
+                },
+                "placeholder": {
+                    "kind": "string",
+                    "description": "Placeholder text"
+                },
+                "value": {
+                    "kind": "string",
+                    "description": "Current value (controlled)"
+                },
+                "disabled": {
+                    "kind": "boolean",
+                    "description": "Whether the input is disabled"
+                },
+                "name": {
+                    "kind": "string",
+                    "description": "Field name. Required for this control's value to be included when a parent Form is submitted. Must match /^[A-Za-z_][A-Za-z0-9_-]*$/."
+                },
+                "min": {
+                    "kind": "number",
+                    "description": "Minimum value (type=\"number\")"
+                },
+                "max": {
+                    "kind": "number",
+                    "description": "Maximum value (type=\"number\")"
+                },
+                "step": {
+                    "kind": "number",
+                    "description": "Step value (type=\"number\")"
+                }
+            }
+        },
+        "InputCounter": {
+            "role": "leaf",
+            "description": "Numeric stepper input. Bind node.actions.change to onChange (fires with the new number).",
+            "props": {
+                "value": {
+                    "kind": "number",
+                    "required": true,
+                    "description": "Current counter value (controlled)"
+                },
+                "state": {
+                    "kind": "enum",
+                    "options": [
+                        "default",
+                        "disabled",
+                        "invalid"
+                    ],
+                    "description": "Validation/interaction state"
+                },
+                "label": {
+                    "kind": "text",
+                    "description": "Field label rendered above the counter"
+                },
+                "helperText": {
+                    "kind": "text",
+                    "description": "Helper text rendered below the counter"
+                },
+                "errorMessage": {
+                    "kind": "text",
+                    "description": "Error message shown instead of `helperText` when `state=\"invalid\"`."
+                },
+                "min": {
+                    "kind": "number",
+                    "description": "Minimum allowed value (optional)"
+                },
+                "max": {
+                    "kind": "number",
+                    "description": "Maximum allowed value (optional)"
+                },
+                "step": {
+                    "kind": "number",
+                    "description": "Increment/decrement step size (default: 1)"
+                },
+                "disabled": {
+                    "kind": "boolean",
+                    "description": "Whether the counter is disabled"
+                },
+                "decimalPlaces": {
+                    "kind": "number",
+                    "description": "Number of decimal places to display (auto-detected from step if not specified)"
+                },
+                "required": {
+                    "kind": "boolean",
+                    "description": "Marks this field as required. A parent Form refuses to submit while it is empty, and lists it in the form's error summary."
+                },
+                "name": {
+                    "kind": "string",
+                    "description": "Field name. Required for this control's value to be included when a parent Form is submitted. Must match /^[A-Za-z_][A-Za-z0-9_-]*$/."
+                }
+            }
+        },
+        "InputDate": {
+            "role": "leaf",
+            "description": "Masked date input. value/onChange deal in a formatted display string, not a Date object. minDate/maxDate accept ISO date strings (coerced to Date internally before render). Bind node.actions.change to onChange — do NOT bind onComplete, it passes a raw Date object.",
+            "props": {
+                "value": {
+                    "kind": "string",
+                    "description": "Current date value (formatted string like \"12/25/2024\" or ISO string)"
+                },
+                "dateFormat": {
+                    "kind": "enum",
+                    "options": [
+                        "MM/DD/YYYY",
+                        "DD/MM/YYYY",
+                        "YYYY/MM/DD"
+                    ],
+                    "description": "Date format for display and parsing (default: auto-detected from locale)"
+                },
+                "size": {
+                    "kind": "enum",
+                    "options": [
+                        "sm",
+                        "md",
+                        "lg"
+                    ],
+                    "description": "The size of the input"
+                },
+                "required": {
+                    "kind": "boolean",
+                    "description": "Whether the input is required"
+                },
+                "state": {
+                    "kind": "enum",
+                    "options": [
+                        "default",
+                        "disabled",
+                        "invalid"
+                    ],
+                    "description": "The state of the input (default, disabled, invalid)"
+                },
+                "label": {
+                    "kind": "text",
+                    "description": "Optional label for the input — pass a string for default styling, or a ReactNode for full control"
+                },
+                "helperText": {
+                    "kind": "text",
+                    "description": "Optional helper text below the input — pass a string for default styling, or a ReactNode for full control"
+                },
+                "errorMessage": {
+                    "kind": "text",
+                    "description": "Error message shown instead of `helperText` when `state=\"invalid\"`."
+                },
+                "iconStart": {
+                    "kind": "icon",
+                    "description": "Icon to display before the input (small decorative)"
+                },
+                "iconEnd": {
+                    "kind": "icon",
+                    "description": "Icon to display after the input (small decorative)"
+                },
+                "placeholder": {
+                    "kind": "string",
+                    "description": "Placeholder text"
+                },
+                "disabled": {
+                    "kind": "boolean",
+                    "description": "Whether the input is disabled"
+                },
+                "minDate": {
+                    "kind": "string",
+                    "description": "Minimum selectable date, ISO format (e.g. \"2024-01-01\")"
+                },
+                "maxDate": {
+                    "kind": "string",
+                    "description": "Maximum selectable date, ISO format"
+                },
+                "name": {
+                    "kind": "string",
+                    "description": "Field name. Required for this control's value to be included when a parent Form is submitted. Must match /^[A-Za-z_][A-Za-z0-9_-]*$/."
+                }
+            }
+        },
+        "InputOTP": {
+            "role": "leaf",
+            "description": "One-time-code input. Bind node.actions.complete to onComplete (fires once every digit is filled) and/or node.actions.change to onChange (fires every keystroke).",
+            "props": {
+                "length": {
+                    "kind": "number",
+                    "default": 6,
+                    "description": "Number of OTP input fields"
+                },
+                "size": {
+                    "kind": "enum",
+                    "options": [
+                        "sm",
+                        "md",
+                        "lg",
+                        "xl"
+                    ],
+                    "default": "lg",
+                    "description": "Size of the OTP slots."
+                },
+                "value": {
+                    "kind": "string",
+                    "description": "Current OTP value (controlled)"
+                },
+                "defaultValue": {
+                    "kind": "string",
+                    "description": "Default OTP value (uncontrolled)"
+                },
+                "charset": {
+                    "kind": "enum",
+                    "options": [
+                        "numeric",
+                        "alphanumeric"
+                    ],
+                    "default": "alphanumeric",
+                    "description": "Which characters the code accepts. Drives the sanitizer (typed and pasted"
+                },
+                "state": {
+                    "kind": "enum",
+                    "options": [
+                        "default",
+                        "disabled",
+                        "invalid"
+                    ],
+                    "default": "default",
+                    "description": "Visual and functional state of the OTP input group."
+                },
+                "label": {
+                    "kind": "text",
+                    "description": "Label for the OTP input group"
+                },
+                "helperText": {
+                    "kind": "text",
+                    "description": "Helper text below the inputs"
+                },
+                "errorMessage": {
+                    "kind": "text",
+                    "description": "Error message shown instead of `helperText` when `state=\"invalid\"`."
+                },
+                "autoFocus": {
+                    "kind": "boolean",
+                    "default": true,
+                    "description": "Auto-focus the first input on mount"
+                },
+                "required": {
+                    "kind": "boolean",
+                    "description": "Marks this field as required. A parent Form refuses to submit while it is empty, and lists it in the form's error summary."
+                },
+                "name": {
+                    "kind": "string",
+                    "description": "Field name. Required for this control's value to be included when a parent Form is submitted. Must match /^[A-Za-z_][A-Za-z0-9_-]*$/."
+                }
+            }
+        },
+        "InputTag": {
+            "role": "leaf",
+            "description": "Free-form tag/chip input. Bind node.actions.change to onChange (fires with the full array of tag strings).",
+            "props": {
+                "value": {
+                    "kind": "shape",
+                    "shape": "stringList",
+                    "description": "Controlled value - array of tag strings"
+                },
+                "maxTags": {
+                    "kind": "number",
+                    "description": "Maximum number of tags allowed"
+                },
+                "allowDuplicates": {
+                    "kind": "boolean",
+                    "description": "Whether to allow duplicate tags (default: false)"
+                },
+                "size": {
+                    "kind": "enum",
+                    "options": [
+                        "sm",
+                        "md"
+                    ],
+                    "description": "The size of the input and tags (sm or md only)"
+                },
+                "state": {
+                    "kind": "enum",
+                    "options": [
+                        "default",
+                        "disabled",
+                        "invalid"
+                    ],
+                    "description": "The state of the input"
+                },
+                "label": {
+                    "kind": "text",
+                    "description": "Label for the input"
+                },
+                "helperText": {
+                    "kind": "text",
+                    "description": "Helper text displayed below the tags"
+                },
+                "placeholder": {
+                    "kind": "string",
+                    "description": "Placeholder text for the input"
+                },
+                "disabled": {
+                    "kind": "boolean",
+                    "description": "Whether the input is disabled"
+                },
+                "suggestions": {
+                    "kind": "shape",
+                    "shape": "optionItems",
+                    "description": "Array of suggestions to show in dropdown. When provided, enables dropdown mode"
+                },
+                "creatable": {
+                    "kind": "boolean",
+                    "description": "Allow free-form tags not in suggestions (default: true)"
+                },
+                "openOnFocus": {
+                    "kind": "boolean",
+                    "description": "Open dropdown on focus when suggestions are provided (default: true)"
+                },
+                "emptyMessage": {
+                    "kind": "string",
+                    "description": "Message shown when no suggestions match (default: \"No suggestions\")"
+                },
+                "required": {
+                    "kind": "boolean",
+                    "description": "Marks this field as required. A parent Form refuses to submit while it is empty, and lists it in the form's error summary."
+                },
+                "name": {
+                    "kind": "string",
+                    "description": "Field name. Required for this control's value to be included when a parent Form is submitted. Must match /^[A-Za-z_][A-Za-z0-9_-]*$/."
+                }
+            }
+        },
+        "Kbd": {
+            "role": "leaf",
+            "description": "Keyboard key/shortcut display. Use either `keys` (named keys) or `children` (custom text), not both.",
+            "props": {
+                "keys": {
+                    "kind": "shape",
+                    "shape": "kbdKeys",
+                    "description": "Array of keyboard keys to display"
+                },
+                "children": {
+                    "kind": "text",
+                    "description": "Custom content to display instead of using keys prop"
+                },
+                "size": {
+                    "kind": "enum",
+                    "options": [
+                        "sm",
+                        "md"
+                    ],
+                    "default": "md",
+                    "description": "Size variant"
+                }
+            }
+        },
+        "KPI": {
+            "role": "leaf",
+            "description": "KPI stat with trend and progress bar (auto Card shell).",
+            "props": {
+                "value": {
+                    "kind": "text",
+                    "required": true,
+                    "description": "The main metric value to display (e.g. \"$25.5M\", \"1,234\", \"89%\")"
+                },
+                "label": {
+                    "kind": "text",
+                    "description": "Label describing the metric (e.g. \"Fund raised\", \"Total Revenue\")"
+                },
+                "trend": {
+                    "kind": "number",
+                    "description": "Percentage change value (e.g. 20, -5.3). Determines trend direction & color."
+                },
+                "trendLabel": {
+                    "kind": "text",
+                    "description": "Custom trend label override (default: auto-formats as \"+20%\" or \"-5.3%\")"
+                },
+                "progress": {
+                    "kind": "number",
+                    "description": "Progress value from 0-100. Controls how many bars are filled."
+                },
+                "barCount": {
+                    "kind": "number",
+                    "default": 24,
+                    "description": "Total number of bars in the visualization."
+                },
+                "subtitle": {
+                    "kind": "text",
+                    "description": "Subtitle text below the bars (e.g. \"Compared to last month\")"
+                },
+                "icon": {
+                    "kind": "icon",
+                    "description": "Icon to display before the label."
                 },
-                "label": {
+                "size": {
+                    "kind": "enum",
+                    "options": [
+                        "sm",
+                        "md",
+                        "lg"
+                    ],
+                    "default": "md",
+                    "description": "Size variant."
+                },
+                "color": {
+                    "kind": "enum",
+                    "options": [
+                        "mono",
+                        "primary",
+                        "success",
+                        "warning",
+                        "danger"
+                    ],
+                    "default": "primary",
+                    "description": "Color for the filled bars and positive trend."
+                }
+            }
+        },
+        "LineChart": {
+            "role": "leaf",
+            "description": "Line chart (auto Card shell + shared-height container).",
+            "props": {
+                "color": {
+                    "kind": "enum",
+                    "options": [
+                        "primary",
+                        "success",
+                        "warning",
+                        "danger"
+                    ]
+                },
+                "dotRadius": {
+                    "kind": "number"
+                },
+                "radius": {
+                    "kind": "number"
+                },
+                "strokeWidth": {
+                    "kind": "number"
+                },
+                "curved": {
+                    "kind": "boolean"
+                },
+                "curveType": {
+                    "kind": "enum",
+                    "options": [
+                        "linear",
+                        "monotone"
+                    ]
+                },
+                "showDots": {
+                    "kind": "boolean"
+                },
+                "data": {
+                    "kind": "shape",
+                    "shape": "chartData",
+                    "required": true
+                },
+                "config": {
+                    "kind": "shape",
+                    "shape": "chartConfig",
+                    "required": true
+                },
+                "width": {
+                    "kind": "union",
+                    "types": [
+                        "number",
+                        "string"
+                    ]
+                },
+                "height": {
+                    "kind": "union",
+                    "types": [
+                        "number",
+                        "string"
+                    ]
+                },
+                "enableKeyboardNavigation": {
+                    "kind": "boolean"
+                },
+                "showXAxis": {
+                    "kind": "boolean"
+                },
+                "showYAxis": {
+                    "kind": "boolean"
+                },
+                "minValue": {
+                    "kind": "number"
+                },
+                "maxValue": {
+                    "kind": "number"
+                },
+                "showGrid": {
+                    "kind": "boolean"
+                },
+                "legend": {
+                    "kind": "enum",
+                    "options": [
+                        "top",
+                        "bottom",
+                        "none"
+                    ],
+                    "description": "Always-visible legend position, rendered from `config`'s labels/colors."
+                },
+                "title": {
+                    "kind": "text",
+                    "description": "Card header title (the auto shell)"
+                },
+                "subtitle": {
+                    "kind": "text",
+                    "description": "Card header subtitle (the auto shell)"
+                }
+            }
+        },
+        "Link": {
+            "role": "leaf",
+            "description": "Hyperlink (pass href) or low-emphasis link-styled button (omit href, pair with node.actions.click).",
+            "props": {
+                "size": {
+                    "kind": "enum",
+                    "options": [
+                        "sm",
+                        "md",
+                        "inherit"
+                    ],
+                    "default": "inherit",
+                    "description": "The size of the link."
+                },
+                "color": {
+                    "kind": "enum",
+                    "options": [
+                        "mono",
+                        "primary",
+                        "success",
+                        "warning",
+                        "danger"
+                    ],
+                    "default": "primary",
+                    "description": "Semantic color."
+                },
+                "disabled": {
+                    "kind": "boolean",
+                    "description": "Whether the link is disabled."
+                },
+                "children": {
+                    "kind": "text",
+                    "description": "Link contents"
+                },
+                "href": {
+                    "kind": "string",
+                    "description": "The URL the hyperlink points to. When set, Link renders an `<a>`."
+                },
+                "target": {
+                    "kind": "string",
+                    "description": "Anchor target (only meaningful with `href`)."
+                },
+                "rel": {
+                    "kind": "string",
+                    "description": "Anchor rel (only meaningful with `href`)."
+                },
+                "type": {
+                    "kind": "enum",
+                    "options": [
+                        "reset",
+                        "submit",
+                        "button"
+                    ],
+                    "default": "button",
+                    "description": "Button type when rendered as a `<button>` (no `href`)."
+                }
+            }
+        },
+        "Masonry": {
+            "role": "container",
+            "description": "Masonry/waterfall grid layout (responsive per-breakpoint column config not supported in generative specs — use a static column count). Children are spec nodes.",
+            "props": {
+                "gap": {
+                    "kind": "number",
+                    "description": "Gap between items in pixels"
+                },
+                "minColumns": {
+                    "kind": "number",
+                    "description": "Minimum columns count"
+                },
+                "maxColumns": {
+                    "kind": "number",
+                    "description": "Maximum columns count"
+                },
+                "sequential": {
+                    "kind": "boolean",
+                    "description": "Enable sequential placement (items placed in order vs optimal placement)"
+                },
+                "loading": {
+                    "kind": "boolean",
+                    "description": "Loading state"
+                },
+                "columns": {
+                    "kind": "number",
+                    "description": "Static column count"
+                }
+            }
+        },
+        "MenuItem": {
+            "role": "leaf",
+            "description": "Single menu/list row. Bind node.actions.activate to onActivate.",
+            "props": {
+                "children": {
+                    "kind": "text",
+                    "required": true,
+                    "description": "Main label content"
+                },
+                "startContent": {
+                    "kind": "icon",
+                    "description": "Icon or element at the start (left side)"
+                },
+                "endContent": {
+                    "kind": "icon",
+                    "description": "Icon or element at the end (right side)"
+                },
+                "subtitle": {
+                    "kind": "text",
+                    "description": "Secondary text below the label"
+                },
+                "shortcut": {
+                    "kind": "text",
+                    "description": "Keyboard shortcut display"
+                },
+                "disabled": {
+                    "kind": "boolean",
+                    "description": "Whether the item is disabled"
+                },
+                "isDanger": {
+                    "kind": "boolean",
+                    "description": "Whether the item has danger/destructive styling"
+                },
+                "selected": {
+                    "kind": "boolean",
+                    "description": "Whether the item is in a selected state (drives selected styling)"
+                }
+            }
+        },
+        "Message": {
+            "role": "leaf",
+            "description": "Chat message bubble (streaming/attachments/reactions/reply-quote not supported in generative specs — those are live-interaction features, not static display).",
+            "props": {
+                "variant": {
+                    "kind": "enum",
+                    "options": [
+                        "sender",
+                        "receiver",
+                        "system"
+                    ],
+                    "default": "receiver",
+                    "description": "The variant of the message (Chat UI semantic naming)"
+                },
+                "content": {
                     "kind": "text",
+                    "description": "The message content (supports rich content, markdown, etc.)"
+                },
+                "showTimestamp": {
+                    "kind": "boolean",
+                    "default": true,
+                    "description": "Whether to show the timestamp"
+                },
+                "status": {
+                    "kind": "enum",
+                    "options": [
+                        "sending",
+                        "sent",
+                        "delivered",
+                        "read",
+                        "failed"
+                    ],
+                    "description": "Delivery status indicator (sending/sent/delivered/read/failed)"
+                },
+                "isGrouped": {
+                    "kind": "boolean",
+                    "description": "Whether this is a consecutive message from the same sender (hides avatar & name)"
+                },
+                "timestamp": {
+                    "kind": "string",
+                    "description": "Message timestamp, ISO format"
+                }
+            }
+        },
+        "Metric": {
+            "role": "leaf",
+            "description": "Single business metric with optional icon and trend.",
+            "props": {
+                "value": {
+                    "kind": "union",
+                    "types": [
+                        "number",
+                        "string"
+                    ],
                     "required": true,
+                    "description": "The main value to display (number or formatted string)"
+                },
+                "label": {
+                    "kind": "text",
                     "description": "Label describing the metric"
                 },
                 "subtitle": {
@@ -1186,7 +2454,7 @@ const GENERATIVE_SCHEMA = {
                 "color": {
                     "kind": "enum",
                     "options": [
-                        "neutral",
+                        "mono",
                         "primary",
                         "success",
                         "warning",
@@ -1209,14 +2477,50 @@ const GENERATIVE_SCHEMA = {
                     "kind": "text",
                     "description": "Heading title (serializable slot). Setting any slot-prop"
                 },
-                "subtitle": {
-                    "kind": "text",
-                    "description": "Secondary line under the title (serializable slot)."
+                "subtitle": {
+                    "kind": "text",
+                    "description": "Secondary line under the title (serializable slot)."
+                },
+                "separator": {
+                    "kind": "boolean",
+                    "default": true,
+                    "description": "Show bottom separator."
+                }
+            }
+        },
+        "Pagination": {
+            "role": "leaf",
+            "description": "Page navigator. Bind node.actions.pageChange to onPageChange (fires with the new page number).",
+            "props": {
+                "currentPage": {
+                    "kind": "number",
+                    "required": true,
+                    "description": "The current active page number (1-based)"
+                },
+                "totalPages": {
+                    "kind": "number",
+                    "required": true,
+                    "description": "The total number of pages"
+                },
+                "size": {
+                    "kind": "enum",
+                    "options": [
+                        "sm",
+                        "md"
+                    ],
+                    "description": "Size variant of pagination"
                 },
-                "separator": {
+                "showFirstLast": {
                     "kind": "boolean",
-                    "default": true,
-                    "description": "Show bottom separator."
+                    "description": "Whether to show first/last page buttons"
+                },
+                "showPrevNext": {
+                    "kind": "boolean",
+                    "description": "Whether to show previous/next buttons"
+                },
+                "siblingCount": {
+                    "kind": "number",
+                    "description": "Number of sibling pages to show around current page"
                 }
             }
         },
@@ -1259,7 +2563,21 @@ const GENERATIVE_SCHEMA = {
             "props": {
                 "value": {
                     "kind": "number",
-                    "description": "Progress value from 0 to 100."
+                    "description": "Progress value, from 0 to `max`."
+                },
+                "max": {
+                    "kind": "number",
+                    "default": 100,
+                    "description": "Upper bound of the range `value` is measured against."
+                },
+                "segments": {
+                    "kind": "number",
+                    "description": "Number of cells to render the bar as an LED-style segmented meter."
+                },
+                "segmentFade": {
+                    "kind": "boolean",
+                    "default": false,
+                    "description": "Fade the meter out across its last few lit cells (segmented form only)."
                 },
                 "size": {
                     "kind": "enum",
@@ -1281,8 +2599,8 @@ const GENERATIVE_SCHEMA = {
                     "options": [
                         "top",
                         "bottom",
-                        "right",
-                        "inside"
+                        "inside",
+                        "right"
                     ],
                     "default": "right",
                     "description": "Position of the label"
@@ -1294,6 +2612,82 @@ const GENERATIVE_SCHEMA = {
                 }
             }
         },
+        "RadarChart": {
+            "role": "leaf",
+            "description": "Radar/spider chart (auto Card shell).",
+            "props": {
+                "axes": {
+                    "kind": "shape",
+                    "shape": "stringList",
+                    "required": true,
+                    "description": "Array of axis/category labels displayed at each spoke endpoint"
+                },
+                "series": {
+                    "kind": "shape",
+                    "shape": "radarSeries",
+                    "required": true,
+                    "description": "Array of data series to plot as filled polygons"
+                },
+                "size": {
+                    "kind": "number",
+                    "default": 400,
+                    "description": "SVG size in pixels (width and height of the SVG viewBox)"
+                },
+                "gridLevels": {
+                    "kind": "number",
+                    "default": 5,
+                    "description": "Number of concentric grid rings drawn from center to outer edge"
+                },
+                "maxValue": {
+                    "kind": "number",
+                    "default": "undefined (auto)",
+                    "description": "Maximum data value used for scaling."
+                },
+                "showGrid": {
+                    "kind": "boolean",
+                    "default": true,
+                    "description": "Whether to render the concentric grid polygons"
+                },
+                "showLabels": {
+                    "kind": "boolean",
+                    "default": true,
+                    "description": "Whether to render axis labels at each spoke endpoint"
+                },
+                "showLegend": {
+                    "kind": "boolean",
+                    "default": true,
+                    "description": "Whether to render the legend below the chart"
+                },
+                "showAnimation": {
+                    "kind": "boolean",
+                    "default": true,
+                    "description": "Whether to animate on mount using Framer Motion"
+                },
+                "fillOpacity": {
+                    "kind": "number",
+                    "default": 0.25,
+                    "description": "Fill opacity for the data polygons (0 to 1)"
+                },
+                "strokeWidth": {
+                    "kind": "number",
+                    "default": 2,
+                    "description": "Stroke width for the data polygon outlines"
+                },
+                "showTooltip": {
+                    "kind": "boolean",
+                    "default": true,
+                    "description": "Whether to show a tooltip on hover over data points"
+                },
+                "title": {
+                    "kind": "text",
+                    "description": "Card header title (the auto shell)"
+                },
+                "subtitle": {
+                    "kind": "text",
+                    "description": "Card header subtitle (the auto shell)"
+                }
+            }
+        },
         "Rating": {
             "role": "leaf",
             "description": "Read-only star rating display.",
@@ -1347,6 +2741,80 @@ const GENERATIVE_SCHEMA = {
                     "kind": "boolean",
                     "default": false,
                     "description": "Enable half-step rating increments"
+                },
+                "required": {
+                    "kind": "boolean",
+                    "description": "Marks this field as required. A parent Form refuses to submit while it is empty, and lists it in the form's error summary."
+                },
+                "name": {
+                    "kind": "string",
+                    "description": "Field name. Required for this control's value to be included when a parent Form is submitted. Must match /^[A-Za-z_][A-Za-z0-9_-]*$/."
+                }
+            }
+        },
+        "ScrollArea": {
+            "role": "container",
+            "description": "Custom-scrollbar viewport. Children are spec nodes.",
+            "props": {
+                "type": {
+                    "kind": "enum",
+                    "options": [
+                        "none",
+                        "auto",
+                        "always",
+                        "scroll",
+                        "hover"
+                    ],
+                    "default": "hover",
+                    "description": "Scrollbar visibility behavior"
+                },
+                "size": {
+                    "kind": "enum",
+                    "options": [
+                        "default",
+                        "thin"
+                    ],
+                    "default": "default",
+                    "description": "Scrollbar size"
+                },
+                "orientation": {
+                    "kind": "enum",
+                    "options": [
+                        "horizontal",
+                        "vertical",
+                        "both"
+                    ],
+                    "default": "vertical",
+                    "description": "Scroll direction"
+                },
+                "snap": {
+                    "kind": "enum",
+                    "options": [
+                        "mandatory",
+                        "proximity"
+                    ],
+                    "default": "undefined (no snapping)",
+                    "description": "Enable scroll snapping. Sets scroll-snap-type on the viewport (axis derived from orientation)."
+                },
+                "snapAlign": {
+                    "kind": "enum",
+                    "options": [
+                        "start",
+                        "center",
+                        "end"
+                    ],
+                    "default": "start",
+                    "description": "Snap alignment applied to direct children via [&>*]:snap-*."
+                },
+                "dragToScroll": {
+                    "kind": "boolean",
+                    "default": false,
+                    "description": "Enable mouse drag-to-scroll panning (grab the content and drag, like touch)."
+                },
+                "smooth": {
+                    "kind": "boolean",
+                    "default": true,
+                    "description": "Enable smooth momentum-based scrolling"
                 }
             }
         },
@@ -1381,16 +2849,232 @@ const GENERATIVE_SCHEMA = {
                 }
             }
         },
-        "Separator": {
+        "Select": {
+            "role": "leaf",
+            "description": "Single-select dropdown (multi-select not supported in generative specs). Bind node.actions.change to onChange (fires with the selected option's value).",
+            "props": {
+                "name": {
+                    "kind": "string",
+                    "description": "Field name. Required for this control's value to be included when a parent Form is submitted. Must match /^[A-Za-z_][A-Za-z0-9_-]*$/."
+                },
+                "size": {
+                    "kind": "enum",
+                    "options": [
+                        "sm",
+                        "md",
+                        "lg"
+                    ],
+                    "description": "Size of the select component"
+                },
+                "state": {
+                    "kind": "enum",
+                    "options": [
+                        "default",
+                        "disabled",
+                        "invalid"
+                    ],
+                    "description": "Current state of the select component"
+                },
+                "placeholder": {
+                    "kind": "string",
+                    "description": "Placeholder text when no option is selected"
+                },
+                "disabled": {
+                    "kind": "boolean",
+                    "description": "Whether the select is disabled"
+                },
+                "required": {
+                    "kind": "boolean",
+                    "description": "Whether the select is required"
+                },
+                "options": {
+                    "kind": "shape",
+                    "shape": "optionItems",
+                    "required": true,
+                    "description": "Array of options to display"
+                },
+                "label": {
+                    "kind": "text",
+                    "description": "Label for the select — pass a string for default styling, or a ReactNode for full control"
+                },
+                "helperText": {
+                    "kind": "text",
+                    "description": "Helper text below the select — pass a string for default styling, or a ReactNode for full control"
+                },
+                "iconStart": {
+                    "kind": "icon",
+                    "description": "Left icon to display in the select button"
+                },
+                "iconEnd": {
+                    "kind": "icon",
+                    "description": "Right icon to display in the select button (default is chevron)"
+                },
+                "searchable": {
+                    "kind": "boolean",
+                    "description": "Whether the select is searchable"
+                },
+                "searchPlaceholder": {
+                    "kind": "string",
+                    "default": "Search...",
+                    "description": "Placeholder text for the search input shown when `searchable` is true."
+                },
+                "enableTypeahead": {
+                    "kind": "boolean",
+                    "description": "Whether to enable typeahead functionality (default: true)"
+                },
+                "aria-label": {
+                    "kind": "string",
+                    "description": "Accessible name for a Select with no visible `label` — e.g. a control sitting"
+                },
+                "value": {
+                    "kind": "string",
+                    "description": "Currently selected option's value (controlled)"
+                }
+            }
+        },
+        "Separator": {
+            "role": "leaf",
+            "description": "Horizontal or vertical divider.",
+            "props": {
+                "vertical": {
+                    "kind": "boolean",
+                    "default": false,
+                    "description": "Whether the separator is vertical (default is horizontal)"
+                },
+                "margin": {
+                    "kind": "enum",
+                    "options": [
+                        "sm",
+                        "md",
+                        "lg"
+                    ],
+                    "default": "md",
+                    "description": "The margin size for spacing"
+                }
+            }
+        },
+        "Skeleton": {
+            "role": "leaf",
+            "description": "Loading placeholder shape.",
+            "props": {
+                "variant": {
+                    "kind": "enum",
+                    "options": [
+                        "text",
+                        "circular",
+                        "rectangle"
+                    ],
+                    "default": "rectangle",
+                    "description": "The variant of the skeleton"
+                },
+                "width": {
+                    "kind": "union",
+                    "types": [
+                        "number",
+                        "string"
+                    ],
+                    "description": "Width of the skeleton"
+                },
+                "height": {
+                    "kind": "union",
+                    "types": [
+                        "number",
+                        "string"
+                    ],
+                    "description": "Height of the skeleton"
+                },
+                "lines": {
+                    "kind": "number",
+                    "default": 1,
+                    "description": "Number of skeleton lines to render (for text variant)"
+                },
+                "animate": {
+                    "kind": "boolean",
+                    "default": true,
+                    "description": "Whether to show pulse animation"
+                }
+            }
+        },
+        "Slider": {
+            "role": "leaf",
+            "description": "Single-thumb range slider (range/dual-thumb mode not supported in generative specs). Bind node.actions.change to onChange and/or node.actions.changeCommitted to onChangeCommitted (both fire with the new number).",
+            "props": {
+                "state": {
+                    "kind": "enum",
+                    "options": [
+                        "default",
+                        "disabled",
+                        "invalid"
+                    ],
+                    "description": "The state of the slider (default, disabled, invalid)"
+                },
+                "label": {
+                    "kind": "text",
+                    "description": "Optional label text for the slider"
+                },
+                "helperText": {
+                    "kind": "text",
+                    "description": "Optional helper text displayed below the slider"
+                },
+                "min": {
+                    "kind": "number",
+                    "description": "Minimum value for the slider"
+                },
+                "max": {
+                    "kind": "number",
+                    "description": "Maximum value for the slider"
+                },
+                "step": {
+                    "kind": "number",
+                    "description": "Step value for slider increments"
+                },
+                "showValue": {
+                    "kind": "boolean",
+                    "description": "Whether to show the current value"
+                },
+                "unit": {
+                    "kind": "string",
+                    "description": "Unit to display with the value (e.g., \"px\", \"%\", \"°\")"
+                },
+                "showMinMax": {
+                    "kind": "boolean",
+                    "description": "Whether to show min/max labels"
+                },
+                "showTicks": {
+                    "kind": "boolean",
+                    "description": "Whether to show tick marks"
+                },
+                "tickStep": {
+                    "kind": "number",
+                    "description": "Step for tick marks (defaults to step)"
+                },
+                "iconStart": {
+                    "kind": "icon",
+                    "description": "Icon to display at the start of the slider"
+                },
+                "iconEnd": {
+                    "kind": "icon",
+                    "description": "Icon to display at the end of the slider"
+                },
+                "required": {
+                    "kind": "boolean",
+                    "description": "Whether the slider is required"
+                },
+                "name": {
+                    "kind": "string",
+                    "description": "Field name. Required for this control's value to be included when a parent Form is submitted. Must match /^[A-Za-z_][A-Za-z0-9_-]*$/."
+                },
+                "value": {
+                    "kind": "number",
+                    "description": "Current value (controlled)"
+                }
+            }
+        },
+        "Spinner": {
             "role": "leaf",
-            "description": "Horizontal or vertical divider.",
+            "description": "Loading spinner.",
             "props": {
-                "vertical": {
-                    "kind": "boolean",
-                    "default": false,
-                    "description": "Whether the separator is vertical (default is horizontal)"
-                },
-                "margin": {
+                "size": {
                     "kind": "enum",
                     "options": [
                         "sm",
@@ -1398,7 +3082,20 @@ const GENERATIVE_SCHEMA = {
                         "lg"
                     ],
                     "default": "md",
-                    "description": "The margin size for spacing"
+                    "description": "The size of the spinner"
+                },
+                "color": {
+                    "kind": "enum",
+                    "options": [
+                        "mono",
+                        "primary",
+                        "success",
+                        "warning",
+                        "danger",
+                        "dark"
+                    ],
+                    "default": "primary",
+                    "description": "The color of the spinner"
                 }
             }
         },
@@ -1409,6 +3106,7 @@ const GENERATIVE_SCHEMA = {
                 "as": {
                     "kind": "enum",
                     "options": [
+                        "form",
                         "div",
                         "ul",
                         "ol",
@@ -1417,7 +3115,6 @@ const GENERATIVE_SCHEMA = {
                         "header",
                         "footer",
                         "aside",
-                        "form",
                         "fieldset"
                     ],
                     "default": "div",
@@ -1482,9 +3179,6 @@ const GENERATIVE_SCHEMA = {
                 "barRadius": {
                     "kind": "number"
                 },
-                "gap": {
-                    "kind": "number"
-                },
                 "categoryGap": {
                     "kind": "number"
                 },
@@ -1562,57 +3256,72 @@ const GENERATIVE_SCHEMA = {
                         "gradient"
                     ]
                 },
-                "dotRadius": {
-                    "kind": "number"
+                "title": {
+                    "kind": "text",
+                    "description": "Card header title (the auto shell)"
                 },
-                "cellRadius": {
-                    "kind": "number"
+                "subtitle": {
+                    "kind": "text",
+                    "description": "Card header subtitle (the auto shell)"
+                }
+            }
+        },
+        "Switch": {
+            "role": "leaf",
+            "description": "Toggle switch. `checked` is the on/off state; `value` is a separate HTML form-submission identity, not the checked state. Bind node.actions.change to onChange (fires with the new checked boolean).",
+            "props": {
+                "checked": {
+                    "kind": "boolean",
+                    "description": "Whether the switch is checked (controlled mode)"
                 },
-                "radius": {
-                    "kind": "number"
+                "defaultChecked": {
+                    "kind": "boolean",
+                    "description": "Initial checked state for uncontrolled mode"
                 },
-                "strokeWidth": {
-                    "kind": "number"
+                "label": {
+                    "kind": "text",
+                    "description": "Label for the switch — pass a string for default styling, or a ReactNode for full control"
                 },
-                "curved": {
-                    "kind": "boolean"
+                "description": {
+                    "kind": "text",
+                    "description": "Optional description — pass a string for default styling, or a ReactNode for full control"
                 },
-                "curveType": {
+                "state": {
                     "kind": "enum",
                     "options": [
-                        "linear",
-                        "monotone",
-                        "step",
-                        "stepBefore",
-                        "stepAfter"
-                    ]
-                },
-                "showDots": {
-                    "kind": "boolean"
-                },
-                "fillOpacity": {
-                    "kind": "number"
-                },
-                "showStroke": {
-                    "kind": "boolean"
+                        "default",
+                        "disabled"
+                    ],
+                    "description": "The state of the switch (default, disabled, invalid)"
                 },
-                "stacked": {
-                    "kind": "boolean"
+                "labelPosition": {
+                    "kind": "enum",
+                    "options": [
+                        "start",
+                        "end"
+                    ],
+                    "description": "Position of the label relative to the switch"
                 },
-                "orientation": {
+                "size": {
                     "kind": "enum",
                     "options": [
-                        "vertical",
-                        "horizontal"
-                    ]
+                        "sm",
+                        "md",
+                        "lg"
+                    ],
+                    "description": "Size of the switch track and thumb"
                 },
-                "title": {
-                    "kind": "text",
-                    "description": "Card header title (the auto shell)"
+                "name": {
+                    "kind": "string",
+                    "description": "Field name. Required for this control's value to be included when a parent Form is submitted. Must match /^[A-Za-z_][A-Za-z0-9_-]*$/."
                 },
-                "subtitle": {
-                    "kind": "text",
-                    "description": "Card header subtitle (the auto shell)"
+                "value": {
+                    "kind": "string",
+                    "description": "HTML value attribute for the hidden input"
+                },
+                "required": {
+                    "kind": "boolean",
+                    "description": "Whether the hidden input is required"
                 }
             }
         },
@@ -1701,69 +3410,250 @@ const GENERATIVE_SCHEMA = {
                     "kind": "text",
                     "description": "Optional accessible caption for the table, rendered as a visually-hidden <caption> element"
                 },
-                "title": {
+                "title": {
+                    "kind": "text",
+                    "description": "Card header title (the auto shell)"
+                },
+                "subtitle": {
+                    "kind": "text",
+                    "description": "Card header subtitle (the auto shell)"
+                },
+                "rowKey": {
+                    "kind": "string",
+                    "description": "Row field that uniquely identifies a row",
+                    "required": true
+                }
+            }
+        },
+        "Tag": {
+            "role": "leaf",
+            "description": "Compact label chip.",
+            "props": {
+                "children": {
+                    "kind": "text",
+                    "required": true,
+                    "description": "The content of the tag"
+                },
+                "size": {
+                    "kind": "enum",
+                    "options": [
+                        "sm",
+                        "md"
+                    ],
+                    "description": "The size of the tag"
+                },
+                "removable": {
+                    "kind": "boolean",
+                    "description": "Whether to show the remove button (default: true)"
+                },
+                "disabled": {
+                    "kind": "boolean",
+                    "description": "Whether the tag is disabled"
+                },
+                "animated": {
+                    "kind": "boolean",
+                    "description": "Whether to render with motion (layout + enter/exit animation). Default true."
+                }
+            }
+        },
+        "Textarea": {
+            "role": "leaf",
+            "description": "Multi-line text input. Bind node.actions.change to onValueChange (fires with the raw string value).",
+            "props": {
+                "size": {
+                    "kind": "enum",
+                    "options": [
+                        "sm",
+                        "md",
+                        "lg"
+                    ],
+                    "description": "The size of the textarea"
+                },
+                "state": {
+                    "kind": "enum",
+                    "options": [
+                        "default",
+                        "disabled",
+                        "invalid"
+                    ],
+                    "description": "The state of the textarea (default, disabled, invalid)"
+                },
+                "label": {
+                    "kind": "text",
+                    "description": "Optional label for the textarea — pass a string for default styling, or a ReactNode for full control"
+                },
+                "helperText": {
+                    "kind": "text",
+                    "description": "Optional helper text below the textarea — pass a string for default styling, or a ReactNode for full control"
+                },
+                "errorMessage": {
+                    "kind": "text",
+                    "description": "Error message shown instead of `helperText` when `state=\"invalid\"`."
+                },
+                "required": {
+                    "kind": "boolean",
+                    "description": "Whether the textarea is required"
+                },
+                "rows": {
+                    "kind": "number",
+                    "description": "Number of rows"
+                },
+                "cols": {
+                    "kind": "number",
+                    "description": "Number of columns"
+                },
+                "placeholder": {
+                    "kind": "string",
+                    "description": "Placeholder text"
+                },
+                "value": {
+                    "kind": "string",
+                    "description": "Current value (controlled)"
+                },
+                "disabled": {
+                    "kind": "boolean",
+                    "description": "Whether the textarea is disabled"
+                },
+                "name": {
+                    "kind": "string",
+                    "description": "Field name. Required for this control's value to be included when a parent Form is submitted. Must match /^[A-Za-z_][A-Za-z0-9_-]*$/."
+                }
+            }
+        },
+        "Timeline": {
+            "role": "leaf",
+            "description": "Event timeline driven by a serializable items array.",
+            "props": {
+                "layout": {
+                    "kind": "enum",
+                    "options": [
+                        "horizontal",
+                        "vertical"
+                    ],
+                    "default": "vertical",
+                    "description": "Layout orientation of the timeline"
+                },
+                "items": {
+                    "kind": "shape",
+                    "shape": "timelineItems",
+                    "description": "Data-driven items. When provided, the timeline renders from this array and"
+                }
+            }
+        },
+        "TimePicker": {
+            "role": "leaf",
+            "description": "Time-of-day picker. value/onChange deal in plain \"HH:mm\" strings, not Date objects. Bind node.actions.change to onChange.",
+            "props": {
+                "value": {
+                    "kind": "string",
+                    "description": "The selected time value in \"HH:mm\" format"
+                },
+                "defaultValue": {
+                    "kind": "string",
+                    "description": "Default time value for uncontrolled mode"
+                },
+                "format": {
+                    "kind": "enum",
+                    "options": [
+                        "12h",
+                        "24h"
+                    ],
+                    "description": "Display format: 12-hour or 24-hour"
+                },
+                "step": {
+                    "kind": "number",
+                    "description": "Step interval for minutes (1, 5, 10, 15, 30)"
+                },
+                "minTime": {
+                    "kind": "string",
+                    "description": "Minimum selectable time in \"HH:mm\" format"
+                },
+                "maxTime": {
+                    "kind": "string",
+                    "description": "Maximum selectable time in \"HH:mm\" format"
+                },
+                "disabled": {
+                    "kind": "boolean",
+                    "description": "Whether the component is disabled"
+                },
+                "placeholder": {
+                    "kind": "string",
+                    "description": "Placeholder text for the input"
+                },
+                "size": {
+                    "kind": "enum",
+                    "options": [
+                        "sm",
+                        "md",
+                        "lg"
+                    ],
+                    "description": "Size variant of the component"
+                },
+                "state": {
+                    "kind": "enum",
+                    "options": [
+                        "default",
+                        "disabled",
+                        "invalid"
+                    ],
+                    "description": "State variant of the component"
+                },
+                "clearable": {
+                    "kind": "boolean",
+                    "description": "Whether to show a clear button"
+                },
+                "label": {
                     "kind": "text",
-                    "description": "Card header title (the auto shell)"
+                    "description": "Optional label text"
                 },
-                "subtitle": {
+                "helperText": {
                     "kind": "text",
-                    "description": "Card header subtitle (the auto shell)"
+                    "description": "Optional helper text"
                 },
-                "rowKey": {
+                "iconStart": {
+                    "kind": "icon",
+                    "description": "Icon to display at the start (left side)"
+                },
+                "iconEnd": {
+                    "kind": "icon",
+                    "description": "Icon to display at the end (right side)"
+                },
+                "required": {
+                    "kind": "boolean",
+                    "description": "Marks this field as required. A parent Form refuses to submit while it is empty, and lists it in the form's error summary."
+                },
+                "name": {
                     "kind": "string",
-                    "description": "Row field that uniquely identifies a row",
-                    "required": true
+                    "description": "Field name. Required for this control's value to be included when a parent Form is submitted. Must match /^[A-Za-z_][A-Za-z0-9_-]*$/."
                 }
             }
         },
-        "Tag": {
+        "Tree": {
             "role": "leaf",
-            "description": "Compact label chip.",
+            "description": "Hierarchical tree view driven by a serializable data array.",
             "props": {
-                "children": {
-                    "kind": "text",
+                "data": {
+                    "kind": "shape",
+                    "shape": "treeData",
                     "required": true,
-                    "description": "The content of the tag"
-                },
-                "size": {
-                    "kind": "enum",
-                    "options": [
-                        "sm",
-                        "md"
-                    ],
-                    "description": "The size of the tag"
+                    "description": "Tree data structure"
                 },
-                "removable": {
+                "selectable": {
                     "kind": "boolean",
-                    "description": "Whether to show the remove button (default: true)"
+                    "description": "Whether nodes can be selected"
                 },
-                "disabled": {
+                "checkable": {
                     "kind": "boolean",
-                    "description": "Whether the tag is disabled"
+                    "description": "Whether to show checkboxes for multi-selection"
                 },
-                "animated": {
+                "expandable": {
                     "kind": "boolean",
-                    "description": "Whether to render with motion (layout + enter/exit animation). Default true."
-                }
-            }
-        },
-        "Timeline": {
-            "role": "leaf",
-            "description": "Event timeline driven by a serializable items array.",
-            "props": {
-                "layout": {
-                    "kind": "enum",
-                    "options": [
-                        "vertical",
-                        "horizontal"
-                    ],
-                    "default": "vertical",
-                    "description": "Layout orientation of the timeline"
+                    "description": "Whether nodes can be expanded/collapsed"
                 },
-                "items": {
-                    "kind": "shape",
-                    "shape": "timelineItems",
-                    "description": "Data-driven items. When provided, the timeline renders from this array and"
+                "hierarchicalSelection": {
+                    "kind": "boolean",
+                    "default": "automatically enabled when checkable=true, false otherwise",
+                    "description": "Enable hierarchical selection behavior"
                 }
             }
         }
@@ -1867,7 +3757,7 @@ const GENERATIVE_SCHEMA = {
                                 "success",
                                 "warning",
                                 "danger",
-                                "neutral",
+                                "mono",
                                 "dark"
                             ]
                         }
@@ -1954,6 +3844,310 @@ const GENERATIVE_SCHEMA = {
                     }
                 }
             }
+        },
+        "treeData": {
+            "description": "Recursive array of { id, label } (required strings) plus optional children (nested TreeNode[]), expanded/selected/disabled (booleans), and data (freeform passthrough object). Per-node icons are not supported.",
+            "type": "array",
+            "items": {
+                "type": "object",
+                "required": [
+                    "id",
+                    "label"
+                ],
+                "properties": {
+                    "id": {
+                        "type": "string"
+                    },
+                    "label": {
+                        "type": "string"
+                    },
+                    "children": {
+                        "type": "array"
+                    },
+                    "expanded": {
+                        "type": "boolean"
+                    },
+                    "selected": {
+                        "type": "boolean"
+                    },
+                    "disabled": {
+                        "type": "boolean"
+                    },
+                    "data": {
+                        "type": "object"
+                    }
+                }
+            }
+        },
+        "commandItems": {
+            "description": "Array of { id, label } (required strings) plus optional subtitle, shortcut (string), and group (string, for grouped display). Per-item icons (contentStart/contentEnd) are not supported.",
+            "type": "array",
+            "items": {
+                "type": "object",
+                "required": [
+                    "id",
+                    "label"
+                ],
+                "properties": {
+                    "id": {
+                        "type": "string"
+                    },
+                    "label": {
+                        "type": "string"
+                    },
+                    "subtitle": {
+                        "type": "string"
+                    },
+                    "shortcut": {
+                        "type": "string"
+                    },
+                    "group": {
+                        "type": "string"
+                    }
+                }
+            }
+        },
+        "optionItems": {
+            "description": "Array of { id, label, value } (all strings, required) plus optional disabled (boolean). Shared shape for Select/Combobox options and InputTag suggestions.",
+            "type": "array",
+            "items": {
+                "type": "object",
+                "required": [
+                    "id",
+                    "label",
+                    "value"
+                ],
+                "properties": {
+                    "id": {
+                        "type": "string"
+                    },
+                    "label": {
+                        "type": "string"
+                    },
+                    "value": {
+                        "type": "string"
+                    },
+                    "disabled": {
+                        "type": "boolean"
+                    }
+                }
+            }
+        },
+        "stringList": {
+            "description": "Array of plain strings.",
+            "type": "array",
+            "items": {
+                "type": "string"
+            }
+        },
+        "kbdKeys": {
+            "description": "Array of named keyboard keys.",
+            "type": "array",
+            "items": {
+                "enum": [
+                    "command",
+                    "shift",
+                    "ctrl",
+                    "option",
+                    "enter",
+                    "delete",
+                    "escape",
+                    "tab",
+                    "capslock",
+                    "up",
+                    "right",
+                    "down",
+                    "left",
+                    "pageup",
+                    "pagedown",
+                    "home",
+                    "end",
+                    "help",
+                    "space",
+                    "fn",
+                    "win",
+                    "alt"
+                ]
+            }
+        },
+        "ganttTasks": {
+            "description": "Array of task bars: { id, groupId, title, startDate, endDate, progress } all required (dates: ISO strings, progress: number 0-100), plus optional color (CSS string), completed (boolean), milestone (boolean), dependencies (array of task id strings).",
+            "type": "array",
+            "items": {
+                "type": "object",
+                "required": [
+                    "id",
+                    "groupId",
+                    "title",
+                    "startDate",
+                    "endDate",
+                    "progress"
+                ],
+                "properties": {
+                    "id": {
+                        "type": "string"
+                    },
+                    "groupId": {
+                        "type": "string"
+                    },
+                    "title": {
+                        "type": "string"
+                    },
+                    "startDate": {
+                        "type": "string"
+                    },
+                    "endDate": {
+                        "type": "string"
+                    },
+                    "progress": {
+                        "type": "number"
+                    },
+                    "color": {
+                        "type": "string"
+                    },
+                    "completed": {
+                        "type": "boolean"
+                    },
+                    "milestone": {
+                        "type": "boolean"
+                    },
+                    "dependencies": {
+                        "type": "array",
+                        "items": {
+                            "type": "string"
+                        }
+                    }
+                }
+            }
+        },
+        "ganttGroups": {
+            "description": "Array of task-row groupings: { id, title, color } (all required strings) plus optional order (number).",
+            "type": "array",
+            "items": {
+                "type": "object",
+                "required": [
+                    "id",
+                    "title",
+                    "color"
+                ],
+                "properties": {
+                    "id": {
+                        "type": "string"
+                    },
+                    "title": {
+                        "type": "string"
+                    },
+                    "color": {
+                        "type": "string"
+                    },
+                    "order": {
+                        "type": "number"
+                    }
+                }
+            }
+        },
+        "radarSeries": {
+            "description": "Array of data series: { label, data, color } all required — data is an array of numbers (one per axis, same length as the axes array), color is a CSS/hex color string.",
+            "type": "array",
+            "items": {
+                "type": "object",
+                "required": [
+                    "label",
+                    "data",
+                    "color"
+                ],
+                "properties": {
+                    "label": {
+                        "type": "string"
+                    },
+                    "data": {
+                        "type": "array",
+                        "items": {
+                            "type": "number"
+                        }
+                    },
+                    "color": {
+                        "type": "string"
+                    }
+                }
+            }
+        },
+        "activityRings": {
+            "description": "Array of rings, ordered outer to inner: { value } (number 0-100, required) plus optional label (string) and color (CSS/hex string).",
+            "type": "array",
+            "items": {
+                "type": "object",
+                "required": [
+                    "value"
+                ],
+                "properties": {
+                    "value": {
+                        "type": "number"
+                    },
+                    "label": {
+                        "type": "string"
+                    },
+                    "color": {
+                        "type": "string"
+                    }
+                }
+            }
+        },
+        "heatmapPoints": {
+            "description": "Array of cells: { x, y, value } all required — x/y are the axis categories (string or number), value is a number or null (renders as empty/muted).",
+            "type": "array",
+            "items": {
+                "type": "object",
+                "required": [
+                    "x",
+                    "y",
+                    "value"
+                ],
+                "properties": {
+                    "x": {
+                        "oneOf": [
+                            {
+                                "type": "string"
+                            },
+                            {
+                                "type": "number"
+                            }
+                        ]
+                    },
+                    "y": {
+                        "oneOf": [
+                            {
+                                "type": "string"
+                            },
+                            {
+                                "type": "number"
+                            }
+                        ]
+                    },
+                    "value": {
+                        "oneOf": [
+                            {
+                                "type": "number"
+                            },
+                            {
+                                "type": "null"
+                            }
+                        ]
+                    }
+                }
+            }
+        },
+        "heatmapLegendLabels": {
+            "description": "Captions at each end of the colour ramp, both optional: { min, max }.",
+            "type": "object",
+            "properties": {
+                "min": {
+                    "type": "string"
+                },
+                "max": {
+                    "type": "string"
+                }
+            }
         }
     },
     "examples": [