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

package/dist/tools.json

@@ -21,35 +21,71 @@
                 "type": "string",
                 "enum": [
                   "Accordion",
+                  "ActivityRings",
                   "Alert",
                   "AreaChart",
+                  "AspectRatio",
                   "Avatar",
                   "AvatarGroup",
                   "Badge",
                   "BarChart",
                   "Breadcrumbs",
                   "Button",
+                  "ButtonGroup",
+                  "Calendar",
                   "Card",
+                  "Checkbox",
+                  "Combobox",
                   "ComboChart",
+                  "CommandPalette",
                   "DescriptionList",
                   "DonutChart",
+                  "DotSeparator",
                   "Empty",
                   "Feed",
+                  "FunnelChart",
+                  "GanttChart",
                   "Grid",
+                  "Heatmap",
+                  "HeroCard",
+                  "HorizontalBarChart",
+                  "Icon",
+                  "Input",
+                  "InputCounter",
+                  "InputDate",
+                  "InputOTP",
+                  "InputTag",
+                  "Kbd",
                   "KPI",
                   "LineChart",
+                  "Link",
+                  "Masonry",
+                  "MenuItem",
+                  "Message",
                   "Metric",
                   "PageHeading",
+                  "Pagination",
                   "Pill",
                   "Progress",
+                  "RadarChart",
                   "Rating",
+                  "ScatterPlot",
+                  "ScrollArea",
                   "Section",
+                  "Select",
                   "Separator",
+                  "Skeleton",
+                  "Slider",
+                  "Spinner",
                   "Stack",
                   "StackedBarChart",
+                  "Switch",
                   "Table",
                   "Tag",
-                  "Timeline"
+                  "Textarea",
+                  "Timeline",
+                  "TimePicker",
+                  "Tree"
                 ]
               },
               "props": {
@@ -132,6 +168,59 @@
             }
           }
         },
+        "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.",
@@ -139,7 +228,7 @@
             "color": {
               "kind": "enum",
               "options": [
-                "neutral",
+                "mono",
                 "primary",
                 "success",
                 "warning",
@@ -252,15 +341,6 @@
                 "gradient"
               ]
             },
-            "barRadius": {
-              "kind": "number"
-            },
-            "cellRadius": {
-              "kind": "number"
-            },
-            "gap": {
-              "kind": "number"
-            },
             "curveType": {
               "kind": "enum",
               "options": [
@@ -281,6 +361,16 @@
             }
           }
         },
+        "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.",
@@ -300,7 +390,7 @@
                 "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",
@@ -373,16 +463,6 @@
               "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": [
@@ -426,7 +506,7 @@
             "color": {
               "kind": "enum",
               "options": [
-                "neutral",
+                "mono",
                 "primary",
                 "success",
                 "warning",
@@ -548,47 +628,6 @@
                 "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)"
@@ -634,7 +673,7 @@
             "color": {
               "kind": "enum",
               "options": [
-                "neutral",
+                "mono",
                 "primary",
                 "danger"
               ],
@@ -676,6 +715,14 @@
               "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"
@@ -710,6 +757,76 @@
             }
           }
         },
+        "ButtonGroup": {
+          "role": "container",
+          "description": "Groups adjacent Buttons with joined borders. Children are spec nodes (Button leaves).",
+          "props": {
+            "orientation": {
+              "kind": "enum",
+              "options": [
+                "horizontal",
+                "vertical"
+              ],
+              "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)"
+            },
+            "selectTodayByDefault": {
+              "kind": "boolean",
+              "description": "Auto-select today's date when calendar opens without a value (default: false)"
+            },
+            "size": {
+              "kind": "enum",
+              "options": [
+                "sm",
+                "md",
+                "lg"
+              ],
+              "description": "Size variant"
+            },
+            "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 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"
+            }
+          }
+        },
         "Card": {
           "role": "container",
           "description": "Bounded panel with optional header. Children are spec nodes.",
@@ -724,6 +841,123 @@
             }
           }
         },
+        "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"
+            }
+          }
+        },
+        "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": "Form field name"
+            },
+            "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).",
@@ -815,10 +1049,10 @@
             "barRadius": {
               "kind": "number"
             },
-            "dotRadius": {
+            "gap": {
               "kind": "number"
             },
-            "cellRadius": {
+            "dotRadius": {
               "kind": "number"
             },
             "radius": {
@@ -827,15 +1061,6 @@
             "strokeWidth": {
               "kind": "number"
             },
-            "gap": {
-              "kind": "number"
-            },
-            "fillOpacity": {
-              "kind": "number"
-            },
-            "showStroke": {
-              "kind": "boolean"
-            },
             "title": {
               "kind": "text",
               "description": "Card header title (the auto shell)"
@@ -846,25 +1071,74 @@
             }
           }
         },
-        "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"
-              ],
-              "description": "Layout variant: \"horizontal\" (default) or \"vertical\""
+            "commands": {
+              "kind": "shape",
+              "shape": "commandItems",
+              "required": true,
+              "description": "Array of commands or command groups"
             },
-            "padding": {
-              "kind": "enum",
-              "options": [
-                "default",
-                "flush"
-              ],
-              "description": "Edge padding behavior. `flush` (default) removes the item side padding so"
+            "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\""
+            },
+            "padding": {
+              "kind": "enum",
+              "options": [
+                "default",
+                "flush"
+              ],
+              "description": "Edge padding behavior. `flush` (default) removes the item side padding so"
             },
             "items": {
               "kind": "shape",
@@ -939,6 +1213,22 @@
             }
           }
         },
+        "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.",
@@ -980,6 +1270,214 @@
             }
           }
         },
+        "FunnelChart": {
+          "role": "leaf",
+          "description": "Conversion funnel chart (auto Card shell). Bind node.actions.stageClick to onStageClick (fires with the clicked stage's data).",
+          "props": {
+            "data": {
+              "kind": "shape",
+              "shape": "funnelStages",
+              "required": true,
+              "description": "Funnel stages data"
+            },
+            "height": {
+              "kind": "union",
+              "types": [
+                "number",
+                "string"
+              ],
+              "description": "Height of the chart"
+            },
+            "width": {
+              "kind": "union",
+              "types": [
+                "number",
+                "string"
+              ],
+              "description": "Width of the chart"
+            },
+            "showPercentages": {
+              "kind": "boolean",
+              "description": "Whether to show percentages"
+            },
+            "showValues": {
+              "kind": "boolean",
+              "description": "Whether to show values"
+            },
+            "showLabels": {
+              "kind": "boolean",
+              "description": "Whether to show stage labels (name)"
+            },
+            "showDropoff": {
+              "kind": "boolean",
+              "description": "Whether to show dropoff percentages between stages"
+            },
+            "showConversionRate": {
+              "kind": "boolean",
+              "description": "Whether to show conversion rates between stages"
+            },
+            "showSummary": {
+              "kind": "boolean",
+              "description": "Whether to show summary statistics"
+            },
+            "colors": {
+              "kind": "shape",
+              "shape": "colorList",
+              "description": "Custom colors"
+            },
+            "orientation": {
+              "kind": "enum",
+              "options": [
+                "horizontal",
+                "vertical"
+              ],
+              "description": "Orientation of the funnel"
+            },
+            "curved": {
+              "kind": "boolean",
+              "description": "Whether to curve segment edges (horizontal only)"
+            },
+            "useGradient": {
+              "kind": "boolean",
+              "description": "Whether to use gradient fills"
+            },
+            "fillOpacity": {
+              "kind": "number",
+              "description": "Fill opacity when gradients are disabled or for gradient stops"
+            },
+            "labelPosition": {
+              "kind": "enum",
+              "options": [
+                "top",
+                "bottom",
+                "inside",
+                "tooltip-only"
+              ],
+              "description": "Position of stage labels"
+            },
+            "summaryPosition": {
+              "kind": "enum",
+              "options": [
+                "none",
+                "top-right",
+                "top-left",
+                "bottom-right",
+                "bottom-left"
+              ],
+              "description": "Position of summary statistics box"
+            },
+            "animate": {
+              "kind": "boolean",
+              "description": "Whether to animate on mount"
+            },
+            "title": {
+              "kind": "text",
+              "description": "Card header title (the auto shell)"
+            },
+            "subtitle": {
+              "kind": "text",
+              "description": "Card header subtitle (the auto shell)"
+            }
+          }
+        },
+        "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",
+                "inside",
+                "auto",
+                "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.",
@@ -987,6 +1485,7 @@
             "as": {
               "kind": "enum",
               "options": [
+                "form",
                 "div",
                 "ul",
                 "ol",
@@ -995,7 +1494,6 @@
                 "header",
                 "footer",
                 "aside",
-                "form",
                 "fieldset"
               ],
               "default": "div",
@@ -1055,102 +1553,136 @@
             }
           }
         },
-        "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": {
-              "kind": "enum",
-              "options": [
-                "sm",
-                "md",
-                "lg"
-              ],
-              "default": "md",
-              "description": "Size variant."
+            "data": {
+              "kind": "shape",
+              "shape": "heatmapPoints",
+              "description": "Heatmap data array - optional when using ChartContainer context"
             },
             "color": {
               "kind": "enum",
               "options": [
-                "neutral",
                 "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": {
+              "description": "Semantic color for heatmap cells (primary, success, warning, danger)"
+            },
+            "variant": {
               "kind": "enum",
               "options": [
-                "primary",
-                "success",
-                "warning",
-                "danger"
-              ]
-            },
-            "dotRadius": {
-              "kind": "number"
+                "default",
+                "minimal",
+                "bordered"
+              ],
+              "description": "Chart variant"
             },
-            "radius": {
-              "kind": "number"
+            "height": {
+              "kind": "union",
+              "types": [
+                "number",
+                "string"
+              ]
             },
-            "strokeWidth": {
-              "kind": "number"
+            "width": {
+              "kind": "union",
+              "types": [
+                "number",
+                "string"
+              ]
             },
-            "curved": {
+            "enableKeyboardNavigation": {
               "kind": "boolean"
             },
-            "curveType": {
+            "title": {
+              "kind": "text",
+              "description": "Card header title (the auto shell)"
+            },
+            "subtitle": {
+              "kind": "text",
+              "description": "Card header subtitle (the auto shell)"
+            }
+          }
+        },
+        "HeroCard": {
+          "role": "container",
+          "description": "Gradient hero shell with an ambient blurred backdrop image. Children are spec nodes rendered above the backdrop.",
+          "props": {
+            "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": [
-                "linear",
-                "monotone"
-              ]
+                "overlay",
+                "multiply",
+                "soft-light",
+                "hard-light",
+                "screen",
+                "luminosity",
+                "normal"
+              ],
+              "default": "multiply",
+              "description": "Blend mode compositing the image over the gradient."
             },
-            "showDots": {
-              "kind": "boolean"
+            "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",
@@ -1203,6 +1735,15 @@
             "maxValue": {
               "kind": "number"
             },
+            "barRadius": {
+              "kind": "number"
+            },
+            "gap": {
+              "kind": "number"
+            },
+            "radius": {
+              "kind": "number"
+            },
             "title": {
               "kind": "text",
               "description": "Card header title (the auto shell)"
@@ -1213,41 +1754,79 @@
             }
           }
         },
-        "Metric": {
+        "Icon": {
           "role": "leaf",
-          "description": "Single business metric with optional icon and trend.",
+          "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": {
-            "value": {
+            "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"
               ],
-              "required": true,
-              "description": "The main value to display (number or formatted string)"
-            },
-            "label": {
-              "kind": "text",
-              "required": true,
-              "description": "Label describing the metric"
+              "description": "Named size preset or custom pixel value. Payment icons scale at 3:2 ratio; others are square."
             },
-            "subtitle": {
-              "kind": "text",
-              "description": "Optional subtitle or secondary text"
-            },
-            "trendValue": {
-              "kind": "text",
-              "description": "Trend value to display (e.g., \"+10.34%\", \"-5.2%\")"
-            },
-            "trendDirection": {
+            "colorMode": {
               "kind": "enum",
               "options": [
-                "up",
-                "down"
-              ],
-              "default": "up",
-              "description": "Trend direction - determines icon and color"
-            },
+                "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": [
@@ -1255,63 +1834,169 @@
                 "md",
                 "lg"
               ],
-              "default": "md",
-              "description": "Size variant"
+              "description": "The size of the input"
             },
-            "variant": {
+            "state": {
               "kind": "enum",
               "options": [
-                "filled",
-                "ghost"
+                "default",
+                "disabled",
+                "invalid"
               ],
-              "default": "filled",
-              "description": "Visual style variant"
+              "description": "The state of the input (default, disabled, invalid)"
             },
-            "color": {
+            "type": {
               "kind": "enum",
               "options": [
-                "neutral",
-                "primary",
-                "success",
-                "warning",
-                "danger"
+                "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"
               ],
-              "default": "primary",
-              "description": "Semantic color for icon and accents"
+              "description": "The type of input. In addition to standard HTML types,"
             },
-            "icon": {
+            "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": "Optional icon to display"
+              "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": "Form field name"
+            },
+            "min": {
+              "kind": "number",
+              "description": "Minimum value (type=\"number\")"
+            },
+            "max": {
+              "kind": "number",
+              "description": "Maximum value (type=\"number\")"
+            },
+            "step": {
+              "kind": "number",
+              "description": "Step value (type=\"number\")"
             }
           }
         },
-        "PageHeading": {
+        "InputCounter": {
           "role": "leaf",
-          "description": "Page header with title/subtitle (managed slot form — header only).",
+          "description": "Numeric stepper input. Bind node.actions.change to onChange (fires with the new number).",
           "props": {
-            "title": {
+            "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": "Heading title (serializable slot). Setting any slot-prop"
+              "description": "Field label rendered above the counter"
             },
-            "subtitle": {
+            "helperText": {
               "kind": "text",
-              "description": "Secondary line under the title (serializable slot)."
+              "description": "Helper text rendered below the counter"
             },
-            "separator": {
+            "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",
-              "default": true,
-              "description": "Show bottom separator."
+              "description": "Whether the counter is disabled"
+            },
+            "decimalPlaces": {
+              "kind": "number",
+              "description": "Number of decimal places to display (auto-detected from step if not specified)"
             }
           }
         },
-        "Pill": {
+        "InputDate": {
           "role": "leaf",
-          "description": "Filter/tag chip with optional selected state.",
+          "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": {
-            "children": {
-              "kind": "text",
-              "required": true,
-              "description": "Content to display inside the pill"
+            "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",
@@ -1320,81 +2005,255 @@
                 "md",
                 "lg"
               ],
-              "description": "Size of the pill"
+              "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 element to display at the start (before the content)"
+              "description": "Icon to display before the input (small decorative)"
             },
-            "selected": {
-              "kind": "boolean",
-              "description": "Whether the pill is selected (controlled state)"
+            "iconEnd": {
+              "kind": "icon",
+              "description": "Icon to display after the input (small decorative)"
             },
-            "readOnly": {
+            "placeholder": {
+              "kind": "string",
+              "description": "Placeholder text"
+            },
+            "disabled": {
               "kind": "boolean",
-              "default": false,
-              "description": "Whether the pill is read-only (non-interactive)"
+              "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"
             }
           }
         },
-        "Progress": {
+        "InputOTP": {
           "role": "leaf",
-          "description": "Progress bar (0–100).",
+          "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": {
-            "value": {
+            "length": {
               "kind": "number",
-              "description": "Progress value from 0 to 100."
+              "default": 6,
+              "description": "Number of OTP input fields"
             },
             "size": {
               "kind": "enum",
               "options": [
                 "sm",
                 "md",
-                "lg"
+                "lg",
+                "xl"
               ],
-              "default": "md",
-              "description": "The size of the progress bar"
+              "default": "lg",
+              "description": "Size of the OTP slots."
             },
-            "showLabel": {
-              "kind": "boolean",
-              "default": false,
-              "description": "Whether to show the percentage label"
+            "value": {
+              "kind": "string",
+              "description": "Current OTP value (controlled)"
             },
-            "labelPosition": {
+            "defaultValue": {
+              "kind": "string",
+              "description": "Default OTP value (uncontrolled)"
+            },
+            "charset": {
               "kind": "enum",
               "options": [
-                "top",
-                "bottom",
-                "right",
-                "inside"
+                "numeric",
+                "alphanumeric"
               ],
-              "default": "right",
-              "description": "Position of the label"
+              "default": "alphanumeric",
+              "description": "Which characters the code accepts. Drives the sanitizer (typed and pasted"
             },
-            "animated": {
+            "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": "Whether to animate value changes"
+              "description": "Auto-focus the first input on mount"
             }
           }
         },
-        "Rating": {
+        "InputTag": {
           "role": "leaf",
-          "description": "Read-only star rating display.",
+          "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": "Controlled rating value (0 to max)"
+              "description": "Maximum number of tags allowed"
             },
-            "defaultValue": {
+            "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\")"
+            }
+          }
+        },
+        "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",
-              "default": 0,
-              "description": "Default rating value for uncontrolled mode (0 to max)"
+              "description": "Percentage change value (e.g. 20, -5.3). Determines trend direction & color."
             },
-            "max": {
+            "trendLabel": {
+              "kind": "text",
+              "description": "Custom trend label override (default: auto-formats as \"+20%\" or \"-5.3%\")"
+            },
+            "progress": {
               "kind": "number",
-              "default": 5,
-              "description": "Maximum number of stars"
+              "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": {
               "kind": "enum",
@@ -1404,77 +2263,1022 @@
                 "lg"
               ],
               "default": "md",
-              "description": "The size of the rating stars"
+              "description": "Size variant."
             },
             "color": {
               "kind": "enum",
               "options": [
+                "mono",
                 "primary",
                 "success",
                 "warning",
                 "danger"
               ],
-              "default": "warning",
-              "description": "The semantic color of the filled stars"
+              "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"
+            },
+            "showGrid": {
+              "kind": "boolean"
+            },
+            "showXAxis": {
+              "kind": "boolean"
+            },
+            "showYAxis": {
+              "kind": "boolean"
+            },
+            "legend": {
+              "kind": "enum",
+              "options": [
+                "top",
+                "bottom",
+                "none"
+              ],
+              "description": "Always-visible legend position, rendered from `config`'s labels/colors."
+            },
+            "minValue": {
+              "kind": "number"
+            },
+            "maxValue": {
+              "kind": "number"
+            },
+            "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": {
+              "kind": "text",
+              "description": "Optional subtitle or secondary text"
+            },
+            "trendValue": {
+              "kind": "text",
+              "description": "Trend value to display (e.g., \"+10.34%\", \"-5.2%\")"
+            },
+            "trendDirection": {
+              "kind": "enum",
+              "options": [
+                "up",
+                "down"
+              ],
+              "default": "up",
+              "description": "Trend direction - determines icon and color"
+            },
+            "size": {
+              "kind": "enum",
+              "options": [
+                "sm",
+                "md",
+                "lg"
+              ],
+              "default": "md",
+              "description": "Size variant"
+            },
+            "variant": {
+              "kind": "enum",
+              "options": [
+                "filled",
+                "ghost"
+              ],
+              "default": "filled",
+              "description": "Visual style variant"
+            },
+            "color": {
+              "kind": "enum",
+              "options": [
+                "mono",
+                "primary",
+                "success",
+                "warning",
+                "danger"
+              ],
+              "default": "primary",
+              "description": "Semantic color for icon and accents"
+            },
+            "icon": {
+              "kind": "icon",
+              "description": "Optional icon to display"
+            }
+          }
+        },
+        "PageHeading": {
+          "role": "leaf",
+          "description": "Page header with title/subtitle (managed slot form — header only).",
+          "props": {
+            "title": {
+              "kind": "text",
+              "description": "Heading title (serializable slot). Setting any slot-prop"
+            },
+            "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"
+            },
+            "showFirstLast": {
+              "kind": "boolean",
+              "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"
+            }
+          }
+        },
+        "Pill": {
+          "role": "leaf",
+          "description": "Filter/tag chip with optional selected state.",
+          "props": {
+            "children": {
+              "kind": "text",
+              "required": true,
+              "description": "Content to display inside the pill"
+            },
+            "size": {
+              "kind": "enum",
+              "options": [
+                "sm",
+                "md",
+                "lg"
+              ],
+              "description": "Size of the pill"
+            },
+            "iconStart": {
+              "kind": "icon",
+              "description": "Icon element to display at the start (before the content)"
+            },
+            "selected": {
+              "kind": "boolean",
+              "description": "Whether the pill is selected (controlled state)"
+            },
+            "readOnly": {
+              "kind": "boolean",
+              "default": false,
+              "description": "Whether the pill is read-only (non-interactive)"
+            }
+          }
+        },
+        "Progress": {
+          "role": "leaf",
+          "description": "Progress bar (0–100).",
+          "props": {
+            "value": {
+              "kind": "number",
+              "description": "Progress value from 0 to 100."
+            },
+            "size": {
+              "kind": "enum",
+              "options": [
+                "sm",
+                "md",
+                "lg"
+              ],
+              "default": "md",
+              "description": "The size of the progress bar"
+            },
+            "showLabel": {
+              "kind": "boolean",
+              "default": false,
+              "description": "Whether to show the percentage label"
+            },
+            "labelPosition": {
+              "kind": "enum",
+              "options": [
+                "top",
+                "bottom",
+                "inside",
+                "right"
+              ],
+              "default": "right",
+              "description": "Position of the label"
+            },
+            "animated": {
+              "kind": "boolean",
+              "default": true,
+              "description": "Whether to animate value changes"
+            }
+          }
+        },
+        "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.",
+          "props": {
+            "value": {
+              "kind": "number",
+              "description": "Controlled rating value (0 to max)"
+            },
+            "defaultValue": {
+              "kind": "number",
+              "default": 0,
+              "description": "Default rating value for uncontrolled mode (0 to max)"
+            },
+            "max": {
+              "kind": "number",
+              "default": 5,
+              "description": "Maximum number of stars"
+            },
+            "size": {
+              "kind": "enum",
+              "options": [
+                "sm",
+                "md",
+                "lg"
+              ],
+              "default": "md",
+              "description": "The size of the rating stars"
+            },
+            "color": {
+              "kind": "enum",
+              "options": [
+                "primary",
+                "success",
+                "warning",
+                "danger"
+              ],
+              "default": "warning",
+              "description": "The semantic color of the filled stars"
+            },
+            "readOnly": {
+              "kind": "boolean",
+              "default": false,
+              "description": "Whether the rating is read-only (display only, no interaction)"
+            },
+            "disabled": {
+              "kind": "boolean",
+              "default": false,
+              "description": "Whether the rating is disabled"
+            },
+            "allowHalf": {
+              "kind": "boolean",
+              "default": false,
+              "description": "Enable half-step rating increments"
+            }
+          }
+        },
+        "ScatterPlot": {
+          "role": "leaf",
+          "description": "Scatter/bubble chart (auto Card shell).",
+          "props": {
+            "data": {
+              "kind": "shape",
+              "shape": "scatterPoints",
+              "required": true,
+              "description": "Data points"
+            },
+            "xLabel": {
+              "kind": "string",
+              "description": "X-axis label"
+            },
+            "yLabel": {
+              "kind": "string",
+              "description": "Y-axis label"
+            },
+            "dotRadius": {
+              "kind": "number",
+              "description": "Point size (if not using data.size)"
+            },
+            "colors": {
+              "kind": "shape",
+              "shape": "colorList",
+              "description": "Custom colors for categories (using CSS variables)"
+            },
+            "showTooltip": {
+              "kind": "boolean",
+              "description": "Enable tooltip on hover"
+            },
+            "showGrid": {
+              "kind": "boolean"
+            },
+            "showXAxis": {
+              "kind": "boolean"
+            },
+            "showYAxis": {
+              "kind": "boolean"
+            },
+            "legend": {
+              "kind": "enum",
+              "options": [
+                "top",
+                "bottom",
+                "none"
+              ],
+              "description": "Always-visible legend position, rendered from `config`'s labels/colors."
+            },
+            "minValue": {
+              "kind": "number"
+            },
+            "maxValue": {
+              "kind": "number"
+            },
+            "height": {
+              "kind": "union",
+              "types": [
+                "number",
+                "string"
+              ]
+            },
+            "width": {
+              "kind": "union",
+              "types": [
+                "number",
+                "string"
+              ]
+            },
+            "enableKeyboardNavigation": {
+              "kind": "boolean"
+            },
+            "title": {
+              "kind": "text",
+              "description": "Card header title (the auto shell)"
+            },
+            "subtitle": {
+              "kind": "text",
+              "description": "Card header subtitle (the auto shell)"
+            }
+          }
+        },
+        "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"
+            }
+          }
+        },
+        "Section": {
+          "role": "container",
+          "description": "Titled page region without card chrome. Children are spec nodes.",
+          "props": {
+            "title": {
+              "kind": "text",
+              "description": "Section heading."
+            },
+            "subtitle": {
+              "kind": "text",
+              "description": "Secondary line under the title."
+            },
+            "gap": {
+              "kind": "enum",
+              "options": [
+                0,
+                1,
+                2,
+                3,
+                4,
+                5,
+                6,
+                8,
+                10,
+                12
+              ],
+              "default": 4,
+              "description": "Spacing between the header and the body (Tailwind spacing scale → mt-N)."
+            }
+          }
+        },
+        "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": "Name for the select component"
+            },
+            "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)"
+            },
+            "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"
             },
-            "readOnly": {
+            "max": {
+              "kind": "number",
+              "description": "Maximum value for the slider"
+            },
+            "step": {
+              "kind": "number",
+              "description": "Step value for slider increments"
+            },
+            "showValue": {
               "kind": "boolean",
-              "default": false,
-              "description": "Whether the rating is read-only (display only, no interaction)"
+              "description": "Whether to show the current value"
             },
-            "disabled": {
+            "unit": {
+              "kind": "string",
+              "description": "Unit to display with the value (e.g., \"px\", \"%\", \"°\")"
+            },
+            "showMinMax": {
               "kind": "boolean",
-              "default": false,
-              "description": "Whether the rating is disabled"
+              "description": "Whether to show min/max labels"
             },
-            "allowHalf": {
+            "showTicks": {
               "kind": "boolean",
-              "default": false,
-              "description": "Enable half-step rating increments"
-            }
-          }
-        },
-        "Section": {
-          "role": "container",
-          "description": "Titled page region without card chrome. Children are spec nodes.",
-          "props": {
-            "title": {
-              "kind": "text",
-              "description": "Section heading."
+              "description": "Whether to show tick marks"
             },
-            "subtitle": {
-              "kind": "text",
-              "description": "Secondary line under the title."
+            "tickStep": {
+              "kind": "number",
+              "description": "Step for tick marks (defaults to step)"
             },
-            "gap": {
-              "kind": "enum",
-              "options": [
-                0,
-                1,
-                2,
-                3,
-                4,
-                5,
-                6,
-                8,
-                10,
-                12
-              ],
-              "default": 4,
-              "description": "Spacing between the header and the body (Tailwind spacing scale → mt-N)."
+            "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": "Name attribute for form submission"
+            },
+            "value": {
+              "kind": "number",
+              "description": "Current value (controlled)"
             }
           }
         },
-        "Separator": {
+        "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",
@@ -1482,7 +3286,20 @@
                 "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"
             }
           }
         },
@@ -1493,6 +3310,7 @@
             "as": {
               "kind": "enum",
               "options": [
+                "form",
                 "div",
                 "ul",
                 "ol",
@@ -1501,7 +3319,6 @@
                 "header",
                 "footer",
                 "aside",
-                "form",
                 "fieldset"
               ],
               "default": "div",
@@ -1566,9 +3383,6 @@
             "barRadius": {
               "kind": "number"
             },
-            "gap": {
-              "kind": "number"
-            },
             "categoryGap": {
               "kind": "number"
             },
@@ -1646,57 +3460,72 @@
                 "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": "HTML name attribute for the hidden input"
             },
-            "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"
             }
           }
         },
@@ -1718,8 +3547,8 @@
               "kind": "enum",
               "options": [
                 "default",
-                "striped",
                 "bordered",
+                "striped",
                 "compact"
               ],
               "description": "Visual variant for different table styles"
@@ -1831,6 +3660,70 @@
             }
           }
         },
+        "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": "Form field name"
+            }
+          }
+        },
         "Timeline": {
           "role": "leaf",
           "description": "Event timeline driven by a serializable items array.",
@@ -1838,16 +3731,125 @@
             "layout": {
               "kind": "enum",
               "options": [
-                "vertical",
-                "horizontal"
+                "horizontal",
+                "vertical"
               ],
               "default": "vertical",
               "description": "Layout orientation of the timeline"
             },
-            "items": {
+            "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": "Optional label text"
+            },
+            "helperText": {
+              "kind": "text",
+              "description": "Optional helper text"
+            },
+            "iconStart": {
+              "kind": "icon",
+              "description": "Icon to display at the start (left side)"
+            },
+            "iconEnd": {
+              "kind": "icon",
+              "description": "Icon to display at the end (right side)"
+            }
+          }
+        },
+        "Tree": {
+          "role": "leaf",
+          "description": "Hierarchical tree view driven by a serializable data array.",
+          "props": {
+            "data": {
               "kind": "shape",
-              "shape": "timelineItems",
-              "description": "Data-driven items. When provided, the timeline renders from this array and"
+              "shape": "treeData",
+              "required": true,
+              "description": "Tree data structure"
+            },
+            "selectable": {
+              "kind": "boolean",
+              "description": "Whether nodes can be selected"
+            },
+            "checkable": {
+              "kind": "boolean",
+              "description": "Whether to show checkboxes for multi-selection"
+            },
+            "expandable": {
+              "kind": "boolean",
+              "description": "Whether nodes can be expanded/collapsed"
+            },
+            "hierarchicalSelection": {
+              "kind": "boolean",
+              "default": "automatically enabled when checkable=true, false otherwise",
+              "description": "Enable hierarchical selection behavior"
             }
           }
         }
@@ -1967,7 +3969,7 @@
                     "success",
                     "warning",
                     "danger",
-                    "neutral",
+                    "mono",
                     "dark"
                   ]
                 }
@@ -2054,6 +4056,348 @@
               }
             }
           }
+        },
+        "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"
+              }
+            }
+          }
+        },
+        "scatterPoints": {
+          "description": "Array of points: { x, y } (numbers, required) plus optional size (number), label (string), category (string, for color grouping).",
+          "type": "array",
+          "items": {
+            "type": "object",
+            "required": [
+              "x",
+              "y"
+            ],
+            "properties": {
+              "x": {
+                "type": "number"
+              },
+              "y": {
+                "type": "number"
+              },
+              "size": {
+                "type": "number"
+              },
+              "label": {
+                "type": "string"
+              },
+              "category": {
+                "type": "string"
+              }
+            }
+          }
+        },
+        "funnelStages": {
+          "description": "Array of funnel stages: { name, value } (required) plus optional color (CSS string).",
+          "type": "array",
+          "items": {
+            "type": "object",
+            "required": [
+              "name",
+              "value"
+            ],
+            "properties": {
+              "name": {
+                "type": "string"
+              },
+              "value": {
+                "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"
+                  }
+                ]
+              }
+            }
+          }
         }
       },
       "examples": [