haze-ui 1.32.0 → 1.34.0

package/dist/mcp-docs.json

@@ -1,5 +1,5 @@
 {
-  "generatedAt": "2026-10-11T16:55:31.959Z",
+  "generatedAt": "2026-10-24T01:32:49.555Z",
   "components": {
     "Accordion": {
       "cssFamily": "accordion",
@@ -14,6 +14,24 @@
             "required": true,
             "description": "Header text shown in the summary"
           },
+          {
+            "name": "itemKey",
+            "type": "string",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "disabled",
+            "type": "boolean",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "index",
+            "type": "number",
+            "required": false,
+            "description": ""
+          },
           {
             "name": "className",
             "type": "string",
@@ -28,6 +46,18 @@
           }
         ],
         "AccordionProps": [
+          {
+            "name": "open",
+            "type": "ControlOrValue<string[]>",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "onOpenChange",
+            "type": "(keys: string[]) => void",
+            "required": false,
+            "description": ""
+          },
           {
             "name": "exclusive",
             "type": "boolean",
@@ -35,6 +65,12 @@
             "default": "false",
             "description": "Only one item open at a time (uses name attribute)"
           },
+          {
+            "name": "classNames",
+            "type": "AccordionClassNames",
+            "required": false,
+            "description": ""
+          },
           {
             "name": "className",
             "type": "string",
@@ -174,7 +210,7 @@
     },
     "Alert": {
       "cssFamily": "alert",
-      "importStatement": "import { Alert } from 'haze-ui';\nimport 'haze-ui/css/tokens.css';\nimport 'haze-ui/css/alert.css';",
+      "importStatement": "import { Alert, alertVariants } from 'haze-ui';\nimport 'haze-ui/css/tokens.css';\nimport 'haze-ui/css/alert.css';",
       "peerDeps": [],
       "description": "Inline status message box.",
       "props": {
@@ -193,11 +229,11 @@
             "description": "Called when the close button is clicked"
           },
           {
-            "name": "variant",
-            "type": "'info' | 'success' | 'warning' | 'danger'",
+            "name": "color",
+            "type": "'default' | 'primary' | 'success' | 'warning' | 'danger' | 'info'",
             "required": false,
             "default": "'info'",
-            "description": "Color variant"
+            "description": "Semantic status color"
           },
           {
             "name": "closable",
@@ -217,6 +253,12 @@
             "type": "ReactNode",
             "required": true,
             "description": "Alert content"
+          },
+          {
+            "name": "ref",
+            "type": "Ref<HTMLDivElement>",
+            "required": false,
+            "description": "Forwarded to the root div (data-slot='alert')"
           }
         ]
       }
@@ -508,6 +550,12 @@
             "type": "string",
             "required": false,
             "description": "Additional CSS class"
+          },
+          {
+            "name": "ref",
+            "type": "Ref<HTMLSpanElement>",
+            "required": false,
+            "description": "Forwarded to the root span (data-slot='avatar')"
           }
         ]
       }
@@ -523,13 +571,32 @@
             "name": "max",
             "type": "number",
             "required": false,
-            "description": ""
+            "description": "Maximum avatars rendered before the overflow chip"
           },
           {
             "name": "total",
             "type": "number",
             "required": false,
-            "description": ""
+            "description": "Overflow count shown instead of children count - max"
+          },
+          {
+            "name": "overflowLabel",
+            "type": "(count: number) => string",
+            "required": false,
+            "default": "(count) => `+${count}`",
+            "description": "Formats the \"+N\" overflow chip text; inlined default keeps the component RSC-safe (hook-free), locale-aware callers pass their own formatter"
+          },
+          {
+            "name": "className",
+            "type": "string",
+            "required": false,
+            "description": "Additional CSS class"
+          },
+          {
+            "name": "...rest",
+            "type": "ComponentPropsWithoutRef<'div'>",
+            "required": false,
+            "description": "Native div attributes forwarded to the group element"
           }
         ]
       }
@@ -572,11 +639,11 @@
       "props": {
         "BadgeProps": [
           {
-            "name": "variant",
-            "type": "'info' | 'success' | 'warning' | 'danger' | 'default'",
+            "name": "color",
+            "type": "'default' | 'primary' | 'success' | 'warning' | 'danger' | 'info'",
             "required": false,
             "default": "'default'",
-            "description": "Color variant"
+            "description": "Semantic status color"
           },
           {
             "name": "size",
@@ -602,13 +669,19 @@
             "type": "ReactNode",
             "required": true,
             "description": "Badge content"
+          },
+          {
+            "name": "ref",
+            "type": "Ref<HTMLSpanElement>",
+            "required": false,
+            "description": "Forwarded to the root span (data-slot='badge')"
           }
         ]
       }
     },
     "Banner": {
       "cssFamily": "banner",
-      "importStatement": "import { Banner } from 'haze-ui';\nimport 'haze-ui/css/tokens.css';\nimport 'haze-ui/css/banner.css';",
+      "importStatement": "import { Banner, bannerVariants } from 'haze-ui';\nimport 'haze-ui/css/tokens.css';\nimport 'haze-ui/css/banner.css';",
       "peerDeps": [],
       "description": "Dismissible top banner with info/success/warning/danger variants.",
       "props": {
@@ -626,11 +699,11 @@
             "description": "Close handler; shows close button when provided"
           },
           {
-            "name": "variant",
-            "type": "'info' | 'success' | 'warning' | 'danger'",
+            "name": "color",
+            "type": "'default' | 'primary' | 'success' | 'warning' | 'danger' | 'info'",
             "required": false,
             "default": "'info'",
-            "description": "Color variant"
+            "description": "Semantic status color"
           },
           {
             "name": "children",
@@ -643,6 +716,12 @@
             "type": "string",
             "required": false,
             "description": "Additional CSS class"
+          },
+          {
+            "name": "ref",
+            "type": "Ref<HTMLDivElement>",
+            "required": false,
+            "description": "Forwarded to the root div (data-slot='banner')"
           }
         ]
       }
@@ -713,24 +792,45 @@
       "peerDeps": [],
       "description": "Breadcrumb trail nav with configurable separator.",
       "props": {
-        "BreadcrumbItemProps": [
+        "BreadcrumbItemOwnProps": [
           {
             "name": "href",
             "type": "string",
             "required": false,
-            "description": "Link URL; omit for current page"
+            "description": ""
           },
           {
-            "name": "className",
+            "name": "children",
+            "type": "ReactNode",
+            "required": true,
+            "description": ""
+          }
+        ],
+        "BreadcrumbItemProps": [
+          {
+            "name": "href",
             "type": "string",
             "required": false,
-            "description": "Additional CSS class"
+            "description": "Link URL; omit for current page"
           },
           {
             "name": "children",
             "type": "ReactNode",
             "required": true,
             "description": "Item label"
+          },
+          {
+            "name": "as",
+            "type": "T",
+            "required": false,
+            "default": "omitted → href-driven ('a' | 'span')",
+            "description": "Render element. Omitted (default) keeps the href-driven duality: href renders an <a> wearing the link skin, no href renders a <span> wearing the current-page skin. An explicit `as` overrides the element and opts into the link skin — the router-Link shape whose navigation lives in `to` rather than `href` (href still lands when passed). The trail semantics (nav/ol, aria-current on the parent <li>) are unaffected."
+          },
+          {
+            "name": "className",
+            "type": "string",
+            "required": false,
+            "description": "Additional CSS class"
           }
         ],
         "BreadcrumbProps": [
@@ -752,6 +852,19 @@
             "type": "ReactNode",
             "required": true,
             "description": "BreadcrumbItem elements"
+          },
+          {
+            "name": "aria-label",
+            "type": "string",
+            "required": false,
+            "default": "'Breadcrumb'",
+            "description": "Accessible name for the nav landmark; inlined default keeps the component RSC-safe (hook-free), locale-aware callers pass their own label"
+          },
+          {
+            "name": "...rest",
+            "type": "ComponentPropsWithoutRef<'nav'>",
+            "required": false,
+            "description": "Native nav attributes forwarded to the root element"
           }
         ]
       }
@@ -786,6 +899,12 @@
             "type": "boolean | { icon?: ReactNode; text?: ReactNode; }",
             "required": false,
             "description": ""
+          },
+          {
+            "name": "ref",
+            "type": "Ref<HTMLAnchorElement>",
+            "required": false,
+            "description": ""
           }
         ],
         "ButtonOwnProps": [
@@ -870,6 +989,78 @@
         ]
       }
     },
+    "ButtonGroup": {
+      "cssFamily": "button-group",
+      "importStatement": "import { ButtonGroup, ButtonGroupSeparator, useButtonGroup } from 'haze-ui';\nimport 'haze-ui/css/tokens.css';\nimport 'haze-ui/css/button-group.css';",
+      "peerDeps": [],
+      "description": "Attached button bar: merged corners and seams, group-wide size/variant/disabled, separator sub-component.",
+      "props": {
+        "ButtonGroupProps": [
+          {
+            "name": "size",
+            "type": "'sm' | 'md' | 'lg'",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "variant",
+            "type": "'solid' | 'outline' | 'ghost'",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "orientation",
+            "type": "'vertical' | 'horizontal'",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "disabled",
+            "type": "boolean",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "classNames",
+            "type": "ButtonGroupClassNames",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "children",
+            "type": "ReactNode",
+            "required": true,
+            "description": ""
+          },
+          {
+            "name": "className",
+            "type": "string",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "ref",
+            "type": "Ref<HTMLDivElement>",
+            "required": false,
+            "description": ""
+          }
+        ],
+        "ButtonGroupSeparatorProps": [
+          {
+            "name": "children",
+            "type": "ReactNode",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "className",
+            "type": "string",
+            "required": false,
+            "description": ""
+          }
+        ]
+      }
+    },
     "Calendar": {
       "cssFamily": "calendar",
       "importStatement": "import { Calendar } from 'haze-ui';\nimport 'haze-ui/css/tokens.css';\nimport 'haze-ui/css/calendar.css';",
@@ -957,35 +1148,68 @@
             "type": "CalendarCellRender",
             "required": false,
             "description": "Appends custom content inside every picker cell (day numbers, month/quarter/year labels, drill-down grids) — receives the cell's civil date and the mode it renders in"
+          },
+          {
+            "name": "classNames",
+            "type": "CalendarClassNames",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "ref",
+            "type": "Ref<HTMLDivElement>",
+            "required": false,
+            "description": ""
           }
         ]
       }
     },
     "Card": {
       "cssFamily": "card",
-      "importStatement": "import { Card } from 'haze-ui';\nimport 'haze-ui/css/tokens.css';\nimport 'haze-ui/css/card.css';",
+      "importStatement": "import { Card, cardVariants } from 'haze-ui';\nimport 'haze-ui/css/tokens.css';\nimport 'haze-ui/css/card.css';",
       "peerDeps": [],
       "description": "Content card with `elevated`/`outlined`/`filled` variants.",
       "props": {
-        "CardProps": [
+        "CardOwnProps": [
           {
             "name": "variant",
             "type": "'elevated' | 'outlined' | 'filled'",
             "required": false,
-            "default": "'elevated'",
-            "description": "Visual style of the card"
+            "description": ""
           },
           {
-            "name": "className",
-            "type": "string",
+            "name": "children",
+            "type": "ReactNode",
+            "required": true,
+            "description": ""
+          }
+        ],
+        "CardProps": [
+          {
+            "name": "variant",
+            "type": "'elevated' | 'outlined' | 'filled'",
             "required": false,
-            "description": "Additional CSS class"
+            "default": "'elevated'",
+            "description": "Visual style of the card"
           },
           {
             "name": "children",
             "type": "ReactNode",
             "required": true,
             "description": "Card content"
+          },
+          {
+            "name": "as",
+            "type": "T",
+            "required": false,
+            "default": "'div'",
+            "description": "Render element: 'div' (default) keeps the plain container; 'a' renders the whole card as a native link — href/target/rel and every other anchor attribute flow through, and the anchor shape resets the UA underline/link-blue while restoring the div's block layout, so the card looks identical. Any component forwarding props to a DOM element (e.g. a router Link) works the same way. Never nest interactive elements inside a whole-card link (anchors/buttons don't nest) — keep secondary actions outside or use a stretched-link overlay."
+          },
+          {
+            "name": "className",
+            "type": "string",
+            "required": false,
+            "description": "Additional CSS class"
           }
         ]
       }
@@ -1042,6 +1266,12 @@
             "type": "ReactNode",
             "required": true,
             "description": "CarouselSlide elements"
+          },
+          {
+            "name": "ref",
+            "type": "Ref<CarouselHandle>",
+            "required": false,
+            "description": "Imperative handle: next()/prev() step with wrap-around, scrollTo(index) jumps (floored, clamped into the slide range) — writes go through the same control path as the arrows/dots"
           }
         ],
         "CarouselSlideProps": [
@@ -1127,6 +1357,12 @@
             "required": false,
             "description": ""
           },
+          {
+            "name": "classNames",
+            "type": "CascaderClassNames",
+            "required": false,
+            "description": ""
+          },
           {
             "name": "ref",
             "type": "Ref<HTMLButtonElement>",
@@ -1152,19 +1388,19 @@
           {
             "name": "data",
             "type": "T[]",
-            "required": true,
+            "required": false,
             "description": ""
           },
           {
             "name": "series",
-            "type": "ChartSeries[]",
-            "required": true,
+            "type": "ChartSeries[] | ChartWaffleSeries[]",
+            "required": false,
             "description": ""
           },
           {
             "name": "xKey",
             "type": "keyof T & string",
-            "required": true,
+            "required": false,
             "description": ""
           },
           {
@@ -1186,38 +1422,122 @@
             "description": ""
           },
           {
-            "name": "renderTooltip",
-            "type": "(payload: ChartTooltipPayload<T>) => ReactNode",
+            "name": "referenceLines",
+            "type": "Props[]",
             "required": false,
             "description": ""
           },
           {
-            "name": "showLegend",
-            "type": "boolean",
+            "name": "referenceAreas",
+            "type": "Props[]",
             "required": false,
             "description": ""
           },
           {
-            "name": "showGrid",
-            "type": "boolean",
+            "name": "referenceDots",
+            "type": "Props[]",
             "required": false,
             "description": ""
           },
           {
-            "name": "showTooltip",
-            "type": "boolean",
+            "name": "value",
+            "type": "number",
             "required": false,
             "description": ""
-          }
-        ]
-      }
-    },
-    "ChatContainer": {
-      "cssFamily": "chat-container",
-      "importStatement": "import { ChatContainer } from 'haze-ui';\nimport 'haze-ui/css/tokens.css';\nimport 'haze-ui/css/chat-container.css';",
-      "peerDeps": [],
-      "description": "Chat transcript scroll container with stick-to-bottom auto-scroll.",
-      "props": {
+          },
+          {
+            "name": "max",
+            "type": "number",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "thresholds",
+            "type": "ChartGaugeThreshold[]",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "label",
+            "type": "ReactNode",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "valueFormat",
+            "type": "(v: number) => string",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "columns",
+            "type": "number",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "renderTooltip",
+            "type": "(payload: ChartTooltipPayload<T>) => ReactNode",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "showLegend",
+            "type": "boolean",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "showGrid",
+            "type": "boolean",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "showTooltip",
+            "type": "boolean",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "fallbackTable",
+            "type": "boolean",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "loading",
+            "type": "ReactNode",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "empty",
+            "type": "ReactNode",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "classNames",
+            "type": "ChartClassNames",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "ref",
+            "type": "Ref<HTMLDivElement>",
+            "required": false,
+            "description": ""
+          }
+        ]
+      }
+    },
+    "ChatContainer": {
+      "cssFamily": "chat-container",
+      "importStatement": "import { ChatContainer } from 'haze-ui';\nimport 'haze-ui/css/tokens.css';\nimport 'haze-ui/css/chat-container.css';",
+      "peerDeps": [],
+      "description": "Chat transcript scroll container with stick-to-bottom auto-scroll.",
+      "props": {
         "ChatContainerProps": [
           {
             "name": "children",
@@ -1464,7 +1784,7 @@
     },
     "Chip": {
       "cssFamily": "chip",
-      "importStatement": "import { Chip } from 'haze-ui';\nimport 'haze-ui/css/tokens.css';\nimport 'haze-ui/css/chip.css';",
+      "importStatement": "import { Chip, chipVariants } from 'haze-ui';\nimport 'haze-ui/css/tokens.css';\nimport 'haze-ui/css/chip.css';",
       "peerDeps": [],
       "description": "Rounded status chip with optional icon and close button.",
       "props": {
@@ -1478,10 +1798,10 @@
           },
           {
             "name": "color",
-            "type": "'success' | 'warning' | 'danger' | 'default' | 'primary'",
+            "type": "'default' | 'primary' | 'success' | 'warning' | 'danger' | 'info'",
             "required": false,
             "default": "'default'",
-            "description": "Color scheme"
+            "description": "Semantic status color"
           },
           {
             "name": "icon",
@@ -1493,7 +1813,14 @@
             "name": "onClose",
             "type": "() => void",
             "required": false,
-            "description": "Close handler; shows close button when provided"
+            "description": "Called when remove button is clicked; providing it shows the button"
+          },
+          {
+            "name": "removeLabel",
+            "type": "string",
+            "required": false,
+            "default": "'Remove'",
+            "description": "Accessible label for the remove button; inlined default keeps the component RSC-safe (hook-free), locale-aware callers pass their own string"
           },
           {
             "name": "className",
@@ -1506,6 +1833,12 @@
             "type": "ReactNode",
             "required": true,
             "description": "Chip content"
+          },
+          {
+            "name": "ref",
+            "type": "Ref<HTMLSpanElement>",
+            "required": false,
+            "description": "Forwarded to the root span (data-slot='chip')"
           }
         ]
       }
@@ -1684,7 +2017,7 @@
           },
           {
             "name": "presets",
-            "type": "string[]",
+            "type": "ColorPickerPreset[]",
             "required": false,
             "description": ""
           },
@@ -1694,6 +2027,12 @@
             "required": false,
             "description": ""
           },
+          {
+            "name": "gradient",
+            "type": "boolean",
+            "required": false,
+            "description": ""
+          },
           {
             "name": "className",
             "type": "string",
@@ -1740,15 +2079,21 @@
           },
           {
             "name": "presets",
-            "type": "string[]",
+            "type": "ColorPickerPreset[]",
             "required": false,
-            "description": "Preset swatch row above the recent row; any parsable format"
+            "description": "Preset entries: plain color strings, labeled solid groups { label?, colors } and single gradients { label?, gradient } rendered as preview bars of the actual gradient. Clicking any entry applies it"
           },
           {
             "name": "recent",
             "type": "boolean",
             "required": false,
-            "description": "Tracks recently used colors (last 10, newest first) as internal state"
+            "description": "Tracks recently used colors (last 10, newest first) as internal state; gradient values never enter the list"
+          },
+          {
+            "name": "gradient",
+            "type": "boolean",
+            "required": false,
+            "description": "Adds the Solid/Gradient toggle and, for gradient values, an angle field plus a stop list. The mode is value-derived; switching modes applies the default of the target mode (no per-mode value memory): solid → linear-gradient(90deg, <color> 0%, #ffffff 100%), gradient → first stop's color"
           },
           {
             "name": "className",
@@ -1756,6 +2101,12 @@
             "required": false,
             "description": "Additional CSS class (the panel card)"
           },
+          {
+            "name": "name",
+            "type": "string",
+            "required": false,
+            "description": ""
+          },
           {
             "name": "aria-label",
             "type": "string",
@@ -1764,7 +2115,7 @@
           },
           {
             "name": "ref",
-            "type": "Ref<HTMLButtonElement | HTMLDivElement>",
+            "type": "Ref<HTMLDivElement | HTMLButtonElement>",
             "required": false,
             "description": ""
           }
@@ -1800,7 +2151,7 @@
         "ComboboxOptionProps": [
           {
             "name": "value",
-            "type": "string",
+            "type": "T",
             "required": true,
             "description": ""
           },
@@ -1816,6 +2167,12 @@
             "required": false,
             "description": ""
           },
+          {
+            "name": "disabled",
+            "type": "boolean",
+            "required": false,
+            "description": ""
+          },
           {
             "name": "id",
             "type": "string",
@@ -1842,7 +2199,7 @@
           },
           {
             "name": "onSelect",
-            "type": "(value: string) => void",
+            "type": "(value: T) => void",
             "required": false,
             "description": ""
           },
@@ -1862,7 +2219,7 @@
         "ComboboxProps": [
           {
             "name": "value",
-            "type": "ControlOrValue<string | string[]>",
+            "type": "ControlOrValue<T | T[]>",
             "required": false,
             "description": "Controlled value or control object"
           },
@@ -1874,9 +2231,15 @@
           },
           {
             "name": "options",
-            "type": "ComboboxOptionData[]",
-            "required": true,
-            "description": "List of options"
+            "type": "ComboboxOptionData<T>[]",
+            "required": false,
+            "description": "Data-driven option entries; optional when compound children supply the rows — options render first, children after. `disabled` rows stay visible but inert; `group` clusters consecutive options under a heading"
+          },
+          {
+            "name": "children",
+            "type": "ReactNode",
+            "required": false,
+            "description": "Compound <ComboboxOption> rows (optionally inside <ComboboxGroup> sections), flattening into the same option data as `options`"
           },
           {
             "name": "multiple",
@@ -1886,7 +2249,7 @@
           },
           {
             "name": "onValuesChange",
-            "type": "(value: string | string[]) => void",
+            "type": "(value: T | T[]) => void",
             "required": false,
             "description": ""
           },
@@ -2132,6 +2495,12 @@
             "required": false,
             "description": ""
           },
+          {
+            "name": "virtualized",
+            "type": "boolean | CommandListVirtualizedConfig",
+            "required": false,
+            "description": ""
+          },
           {
             "name": "className",
             "type": "string",
@@ -2186,6 +2555,12 @@
             "required": false,
             "description": "Component defaults keyed by exported component name (Button / ButtonLink / Toast / Tooltip / HoverCard); nested providers shallow-merge per section, inner wins, explicit props always beat config"
           },
+          {
+            "name": "density",
+            "type": "HazeDensity",
+            "required": false,
+            "description": ""
+          },
           {
             "name": "children",
             "type": "ReactNode",
@@ -2254,7 +2629,7 @@
           },
           {
             "name": "variant",
-            "type": "'danger' | 'default'",
+            "type": "'default' | 'danger'",
             "required": false,
             "default": "'default'",
             "description": "Confirm button style"
@@ -2363,11 +2738,23 @@
             "required": true,
             "description": "Trigger and Content elements"
           },
+          {
+            "name": "classNames",
+            "type": "ContextMenuClassNames",
+            "required": false,
+            "description": ""
+          },
           {
             "name": "className",
             "type": "string",
             "required": false,
             "description": "Additional CSS class"
+          },
+          {
+            "name": "ref",
+            "type": "Ref<HTMLDivElement>",
+            "required": false,
+            "description": ""
           }
         ],
         "ContextMenuSeparatorProps": [
@@ -2461,137 +2848,309 @@
         ]
       }
     },
-    "CountUp": {
-      "cssFamily": "count-up",
-      "importStatement": "import { CountUp } from 'haze-ui';\nimport 'haze-ui/css/tokens.css';\nimport 'haze-ui/css/count-up.css';",
+    "CopyButton": {
+      "cssFamily": "copy-button",
+      "importStatement": "import { CopyButton, Snippet, iconSizes } from 'haze-ui';\nimport 'haze-ui/css/tokens.css';\nimport 'haze-ui/css/copy-button.css';",
       "peerDeps": [],
-      "description": "Animated number ticker: rAF + ease-out interpolation toward `to`, honoring `prefers-reduced-motion` with an instant snap.",
+      "description": "Copy-to-clipboard button (Button skin, useClipboard plumbing, copied-state feedback with SR announcement) plus Snippet: the inline mono code chip with a docked copy button.",
       "props": {
-        "CountUpProps": [
+        "CopyButtonProps": [
           {
-            "name": "to",
-            "type": "number",
-            "required": true,
+            "name": "value",
+            "type": "string",
+            "required": false,
             "description": ""
           },
           {
-            "name": "from",
-            "type": "number",
+            "name": "getValue",
+            "type": "() => string",
             "required": false,
             "description": ""
           },
           {
-            "name": "duration",
+            "name": "copiedTimeout",
             "type": "number",
             "required": false,
             "description": ""
           },
           {
-            "name": "decimals",
-            "type": "number",
+            "name": "copyLabel",
+            "type": "string",
             "required": false,
             "description": ""
           },
           {
-            "name": "format",
-            "type": "(value: number) => string",
+            "name": "copiedLabel",
+            "type": "string",
             "required": false,
             "description": ""
           },
           {
-            "name": "autostart",
-            "type": "boolean",
+            "name": "classNames",
+            "type": "CopyButtonClassNames",
             "required": false,
             "description": ""
           },
           {
-            "name": "className",
-            "type": "string",
+            "name": "children",
+            "type": "ReactNode | ((copied: boolean) => ReactNode)",
             "required": false,
             "description": ""
-          }
-        ]
-      }
-    },
-    "DataTable": {
-      "cssFamily": "data-table",
-      "importStatement": "import { DataTable, dataTableToCsv, dataTableSum, dataTableAvg, dataTableCount } from 'haze-ui';\nimport 'haze-ui/css/tokens.css';\nimport 'haze-ui/css/data-table.css';",
-      "peerDeps": [],
-      "description": "Feature table on @tanstack/react-table with sorting, (manual) pagination, row selection and `dataTableToCsv` export.",
-      "props": {
-        "CellEditorProps": [
+          },
           {
-            "name": "kind",
-            "type": "'number' | 'text'",
-            "required": true,
+            "name": "as",
+            "type": "T",
+            "required": false,
             "description": ""
           },
           {
-            "name": "value",
-            "type": "unknown",
-            "required": true,
+            "name": "variant",
+            "type": "'solid' | 'outline' | 'ghost'",
+            "required": false,
             "description": ""
           },
           {
-            "name": "ariaLabel",
-            "type": "string",
-            "required": true,
+            "name": "size",
+            "type": "'sm' | 'md' | 'lg'",
+            "required": false,
             "description": ""
           },
           {
-            "name": "onSave",
-            "type": "(next: string | number | null) => void",
-            "required": true,
+            "name": "square",
+            "type": "boolean",
+            "required": false,
             "description": ""
           },
           {
-            "name": "onCancel",
-            "type": "() => void",
-            "required": true,
+            "name": "loading",
+            "type": "boolean | { icon?: ReactNode; text?: ReactNode; }",
+            "required": false,
             "description": ""
           }
         ],
-        "DataTableCellEditorProps": [
+        "SnippetProps": [
           {
             "name": "value",
-            "type": "unknown",
+            "type": "string",
             "required": true,
             "description": ""
           },
           {
-            "name": "row",
-            "type": "{ id: string; index: number; depth: number; original: unknown; getValue: (columnId: string) => unknown; }",
-            "required": true,
+            "name": "copiedTimeout",
+            "type": "number",
+            "required": false,
             "description": ""
           },
           {
-            "name": "column",
-            "type": "{ id: string; }",
-            "required": true,
+            "name": "copyLabel",
+            "type": "string",
+            "required": false,
             "description": ""
           },
           {
-            "name": "onSave",
-            "type": "(value: unknown) => void",
-            "required": true,
+            "name": "copiedLabel",
+            "type": "string",
+            "required": false,
             "description": ""
           },
           {
-            "name": "onCancel",
-            "type": "() => void",
-            "required": true,
-            "description": ""
-          }
-        ],
-        "DataTableProps": [
-          {
-            "name": "columns",
-            "type": "DataTableColumnDef<TData>[]",
-            "required": true,
+            "name": "classNames",
+            "type": "SnippetClassNames",
+            "required": false,
             "description": ""
           },
           {
-            "name": "data",
+            "name": "children",
+            "type": "ReactNode",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "className",
+            "type": "string",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "ref",
+            "type": "Ref<HTMLDivElement>",
+            "required": false,
+            "description": ""
+          }
+        ]
+      }
+    },
+    "CountUp": {
+      "cssFamily": "count-up",
+      "importStatement": "import { CountUp } from 'haze-ui';\nimport 'haze-ui/css/tokens.css';\nimport 'haze-ui/css/count-up.css';",
+      "peerDeps": [],
+      "description": "Animated number ticker: rAF + ease-out interpolation toward `to`, honoring `prefers-reduced-motion` with an instant snap.",
+      "props": {
+        "CountUpProps": [
+          {
+            "name": "to",
+            "type": "number",
+            "required": true,
+            "description": ""
+          },
+          {
+            "name": "from",
+            "type": "number",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "duration",
+            "type": "number",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "decimals",
+            "type": "number",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "format",
+            "type": "(value: number) => string",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "autostart",
+            "type": "boolean",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "className",
+            "type": "string",
+            "required": false,
+            "description": ""
+          }
+        ]
+      }
+    },
+    "Countdown": {
+      "cssFamily": "countdown",
+      "importStatement": "import { Countdown } from 'haze-ui';\nimport 'haze-ui/css/tokens.css';\nimport 'haze-ui/css/countdown.css';",
+      "peerDeps": [],
+      "description": "Deadline countdown: `value` timestamp or Date, setTimeout-chain ticks aligned to second boundaries (no interval drift), `onFinish` fires once, adaptive `1d hh:mm:ss` / `hh:mm:ss` default format with `format`/`render` escape hatches.",
+      "props": {
+        "CountdownProps": [
+          {
+            "name": "value",
+            "type": "number | Date",
+            "required": true,
+            "description": ""
+          },
+          {
+            "name": "onFinish",
+            "type": "() => void",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "format",
+            "type": "(parts: CountdownParts) => string",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "render",
+            "type": "(parts: CountdownParts) => ReactNode",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "className",
+            "type": "string",
+            "required": false,
+            "description": ""
+          }
+        ]
+      }
+    },
+    "DataTable": {
+      "cssFamily": "data-table",
+      "importStatement": "import { DataTable, dataTableToCsv, dataTableSum, dataTableAvg, dataTableCount } from 'haze-ui';\nimport 'haze-ui/css/tokens.css';\nimport 'haze-ui/css/data-table.css';",
+      "peerDeps": [],
+      "description": "Feature table on @tanstack/react-table with sorting, (manual) pagination, row selection and `dataTableToCsv` export.",
+      "props": {
+        "CellEditorProps": [
+          {
+            "name": "kind",
+            "type": "'number' | 'text'",
+            "required": true,
+            "description": ""
+          },
+          {
+            "name": "value",
+            "type": "unknown",
+            "required": true,
+            "description": ""
+          },
+          {
+            "name": "ariaLabel",
+            "type": "string",
+            "required": true,
+            "description": ""
+          },
+          {
+            "name": "onSave",
+            "type": "(next: string | number | null) => void",
+            "required": true,
+            "description": ""
+          },
+          {
+            "name": "onCancel",
+            "type": "() => void",
+            "required": true,
+            "description": ""
+          }
+        ],
+        "DataTableCellEditorProps": [
+          {
+            "name": "value",
+            "type": "unknown",
+            "required": true,
+            "description": ""
+          },
+          {
+            "name": "row",
+            "type": "{ id: string; index: number; depth: number; original: unknown; getValue: (columnId: string) => unknown; }",
+            "required": true,
+            "description": ""
+          },
+          {
+            "name": "column",
+            "type": "{ id: string; }",
+            "required": true,
+            "description": ""
+          },
+          {
+            "name": "onSave",
+            "type": "(value: unknown) => void",
+            "required": true,
+            "description": ""
+          },
+          {
+            "name": "onCancel",
+            "type": "() => void",
+            "required": true,
+            "description": ""
+          }
+        ],
+        "DataTableProps": [
+          {
+            "name": "columns",
+            "type": "DataTableColumnDef<TData>[]",
+            "required": true,
+            "description": ""
+          },
+          {
+            "name": "data",
             "type": "TData[]",
             "required": true,
             "description": ""
@@ -2707,13 +3266,13 @@
           },
           {
             "name": "getRowCanExpand",
-            "type": "(row: Row<{ rowPaginationFeature: TableFeature; paginatedRowModel: (table: Table<any, any>) => () => RowModel<any, any>; rowSelectionFeature: TableFeature; ... 11 more ...; columnMeta: DataTableColumnMeta; }, TData>) => boolean",
+            "type": "(row: Row<{ rowPaginationFeature: TableFeature; paginatedRowModel: (table: Table<any, any>) => () => RowModel<any, any>; rowSelectionFeature: TableFeature; ... 12 more ...; columnMeta: DataTableColumnMeta; }, TData>) => boolean",
             "required": false,
             "description": "Per-row switch for the expander column; defaults to expandable when only renderExpandedRow is given"
           },
           {
             "name": "renderExpandedRow",
-            "type": "(row: Row<{ rowPaginationFeature: TableFeature; paginatedRowModel: (table: Table<any, any>) => () => RowModel<any, any>; rowSelectionFeature: TableFeature; ... 11 more ...; columnMeta: DataTableColumnMeta; }, TData>) => ReactNode",
+            "type": "(row: Row<{ rowPaginationFeature: TableFeature; paginatedRowModel: (table: Table<any, any>) => () => RowModel<any, any>; rowSelectionFeature: TableFeature; ... 12 more ...; columnMeta: DataTableColumnMeta; }, TData>) => ReactNode",
             "required": false,
             "description": "Renders an expansion panel row spanning all visible columns"
           },
@@ -2743,9 +3302,21 @@
             "default": "false",
             "description": "Render a filter row under the header; per-column opt-in/out via meta.filterable"
           },
+          {
+            "name": "filters",
+            "type": "ControlOrValue<DataTableFiltersState>",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "onFiltersChange",
+            "type": "(filters: DataTableFiltersState) => void",
+            "required": false,
+            "description": ""
+          },
           {
             "name": "summary",
-            "type": "(rows: Row<{ rowPaginationFeature: TableFeature; paginatedRowModel: (table: Table<any, any>) => () => RowModel<any, any>; rowSelectionFeature: TableFeature; ... 11 more ...; columnMeta: DataTableColumnMeta; }, TData>[]) => DataTableSummary<...>[]",
+            "type": "(rows: Row<{ rowPaginationFeature: TableFeature; paginatedRowModel: (table: Table<any, any>) => () => RowModel<any, any>; rowSelectionFeature: TableFeature; ... 12 more ...; columnMeta: DataTableColumnMeta; }, TData>[]) => DataTableSummary<...>[]",
             "required": false,
             "description": ""
           },
@@ -2767,11 +3338,223 @@
             "required": false,
             "description": ""
           },
+          {
+            "name": "toolbar",
+            "type": "ReactNode",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "size",
+            "type": "'sm' | 'md' | 'lg'",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "columnReorderable",
+            "type": "boolean",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "onColumnOrderChange",
+            "type": "(order: ColumnOrderState) => void",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "onEndReached",
+            "type": "() => void",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "endReachedThreshold",
+            "type": "number",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "classNames",
+            "type": "DataTableClassNames",
+            "required": false,
+            "description": ""
+          },
           {
             "name": "className",
             "type": "string",
             "required": false,
             "description": ""
+          },
+          {
+            "name": "ref",
+            "type": "Ref<HTMLDivElement>",
+            "required": false,
+            "description": ""
+          }
+        ]
+      }
+    },
+    "DateField": {
+      "cssFamily": "date-field",
+      "importStatement": "import { DateField, DateFieldCore } from 'haze-ui';\nimport 'haze-ui/css/tokens.css';\nimport 'haze-ui/css/date-field.css';",
+      "peerDeps": [],
+      "description": "Segmented date input: year/month/day spinbuttons typed directly (`YYYY-MM-DD` value); `DateFieldCore` is the headless core.",
+      "props": {
+        "DateFieldCoreProps": [
+          {
+            "name": "value",
+            "type": "string",
+            "required": true,
+            "description": ""
+          },
+          {
+            "name": "onChange",
+            "type": "(value: string) => void",
+            "required": true,
+            "description": ""
+          },
+          {
+            "name": "locale",
+            "type": "string",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "disabled",
+            "type": "boolean",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "placeholder",
+            "type": "DatePlaceholder",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "labels",
+            "type": "DateLabels",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "className",
+            "type": "string",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "ref",
+            "type": "Ref<HTMLSpanElement>",
+            "required": false,
+            "description": ""
+          }
+        ],
+        "DateFieldProps": [
+          {
+            "name": "value",
+            "type": "ControlOrValue<string>",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "onChange",
+            "type": "(value: string) => void",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "locale",
+            "type": "string",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "disabled",
+            "type": "boolean",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "placeholder",
+            "type": "DatePlaceholder",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "labels",
+            "type": "DateLabels",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "className",
+            "type": "string",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "ref",
+            "type": "Ref<HTMLSpanElement>",
+            "required": false,
+            "description": ""
+          }
+        ],
+        "SegmentedFieldProps": [
+          {
+            "name": "segments",
+            "type": "SegmentSpec[]",
+            "required": true,
+            "description": ""
+          },
+          {
+            "name": "separators",
+            "type": "string[]",
+            "required": true,
+            "description": ""
+          },
+          {
+            "name": "values",
+            "type": "(number | null)[]",
+            "required": true,
+            "description": ""
+          },
+          {
+            "name": "value",
+            "type": "string",
+            "required": true,
+            "description": ""
+          },
+          {
+            "name": "serialize",
+            "type": "(values: (number | null)[]) => string | null",
+            "required": true,
+            "description": ""
+          },
+          {
+            "name": "onChange",
+            "type": "(value: string) => void",
+            "required": true,
+            "description": ""
+          },
+          {
+            "name": "disabled",
+            "type": "boolean",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "className",
+            "type": "string",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "ref",
+            "type": "Ref<HTMLSpanElement>",
+            "required": false,
+            "description": ""
           }
         ]
       }
@@ -3282,6 +4065,13 @@
             "required": false,
             "description": ""
           },
+          {
+            "name": "keepMounted",
+            "type": "boolean",
+            "required": false,
+            "default": "false",
+            "description": "Keep content mounted when closed: after the exit animation the panel carries hidden + inert (excluded from AT and tab order), so drafts and inner state survive reopen"
+          },
           {
             "name": "className",
             "type": "string",
@@ -3410,6 +4200,13 @@
             "default": "'right'",
             "description": "Edge to anchor the drawer"
           },
+          {
+            "name": "size",
+            "type": "'sm' | 'md' | 'lg'",
+            "required": false,
+            "default": "— (不传保持 320px)",
+            "description": "Panel size preset. left/right sets width: sm 360px / md 480px / lg 640px; top/bottom sets height: sm 240px / md 360px / lg 480px. Implemented as the --haze-drawer-width / --haze-drawer-height custom properties (set by the preset, consumed by the placement class) — override either with an inline style or CSS instead of a fixed pixel value."
+          },
           {
             "name": "onClose",
             "type": "() => void",
@@ -3434,6 +4231,13 @@
             "required": false,
             "description": ""
           },
+          {
+            "name": "keepMounted",
+            "type": "boolean",
+            "required": false,
+            "default": "false",
+            "description": "Keep content mounted when closed: after the exit animation the panel carries hidden + inert (excluded from AT and tab order), so drafts and inner state survive reopen"
+          },
           {
             "name": "children",
             "type": "ReactNode",
@@ -3616,6 +4420,12 @@
             "required": false,
             "description": ""
           },
+          {
+            "name": "classNames",
+            "type": "DropdownMenuClassNames",
+            "required": false,
+            "description": ""
+          },
           {
             "name": "children",
             "type": "ReactNode",
@@ -3882,6 +4692,52 @@
         ]
       }
     },
+    "ErrorBoundary": {
+      "cssFamily": "error-boundary",
+      "importStatement": "import { ErrorBoundary } from 'haze-ui';\nimport 'haze-ui/css/tokens.css';\nimport 'haze-ui/css/error-boundary.css';",
+      "peerDeps": [],
+      "description": "Render-error boundary: class component catching subtree throws, rendering a fallback (`fallback` node or render prop) with a reset callback; `resetKeys` shallow-change resets.",
+      "props": {
+        "ErrorBoundaryProps": [
+          {
+            "name": "children",
+            "type": "ReactNode",
+            "required": true,
+            "description": ""
+          },
+          {
+            "name": "fallback",
+            "type": "ReactNode | ((args: FallbackRenderArgs) => ReactNode)",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "onError",
+            "type": "(error: Error, info: ErrorInfo) => void",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "resetKeys",
+            "type": "readonly unknown[]",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "onResetKeysChange",
+            "type": "(prev: readonly unknown[] | undefined, next: readonly unknown[] | undefined) => void",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "className",
+            "type": "string",
+            "required": false,
+            "description": ""
+          }
+        ]
+      }
+    },
     "Fieldset": {
       "cssFamily": "fieldset",
       "importStatement": "import { Fieldset } from 'haze-ui';\nimport 'haze-ui/css/tokens.css';\nimport 'haze-ui/css/fieldset.css';",
@@ -4235,51 +5091,127 @@
             "description": "Columns to span once the grid container is at least 768px wide; only takes effect inside a responsive Grid, otherwise degrades to span"
           },
           {
-            "name": "className",
-            "type": "string",
+            "name": "className",
+            "type": "string",
+            "required": false,
+            "description": "Additional CSS class"
+          },
+          {
+            "name": "children",
+            "type": "ReactNode",
+            "required": true,
+            "description": "Grid item content"
+          }
+        ],
+        "GridProps": [
+          {
+            "name": "columns",
+            "type": "number",
+            "required": false,
+            "default": "12",
+            "description": "Number of grid columns"
+          },
+          {
+            "name": "gap",
+            "type": "number",
+            "required": false,
+            "default": "4",
+            "description": "Gap token index (--haze-space-N)"
+          },
+          {
+            "name": "responsive",
+            "type": "boolean",
+            "required": false,
+            "default": "false",
+            "description": "Enable a container-query context (container-type: inline-size) so GridItem sm/md/lg breakpoints respond to the grid's own width instead of the viewport"
+          },
+          {
+            "name": "className",
+            "type": "string",
+            "required": false,
+            "description": "Additional CSS class"
+          },
+          {
+            "name": "children",
+            "type": "ReactNode",
+            "required": true,
+            "description": "GridItem elements"
+          }
+        ]
+      }
+    },
+    "Heatmap": {
+      "cssFamily": "heatmap",
+      "importStatement": "import { Heatmap } from 'haze-ui';\nimport 'haze-ui/css/tokens.css';\nimport 'haze-ui/css/heatmap.css';",
+      "peerDeps": [],
+      "description": "GitHub-style activity calendar: week × weekday grid of squares, intensity-binned by value (levels prop), theme-aware color-mix scale, label props for all i18n.",
+      "props": {
+        "HeatmapProps": [
+          {
+            "name": "data",
+            "type": "HeatmapDatum[] | Record<string, number>",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "levels",
+            "type": "number",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "startDate",
+            "type": "string",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "endDate",
+            "type": "string",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "getLabel",
+            "type": "(datum: { date: string; value: number; }) => string",
             "required": false,
-            "description": "Additional CSS class"
+            "description": ""
           },
           {
-            "name": "children",
-            "type": "ReactNode",
-            "required": true,
-            "description": "Grid item content"
-          }
-        ],
-        "GridProps": [
+            "name": "getMonthLabel",
+            "type": "(month: number, year: number) => string",
+            "required": false,
+            "description": ""
+          },
           {
-            "name": "columns",
-            "type": "number",
+            "name": "getWeekdayLabel",
+            "type": "(weekday: number) => string",
             "required": false,
-            "default": "12",
-            "description": "Number of grid columns"
+            "description": ""
           },
           {
-            "name": "gap",
-            "type": "number",
+            "name": "summary",
+            "type": "string",
             "required": false,
-            "default": "4",
-            "description": "Gap token index (--haze-space-N)"
+            "description": ""
           },
           {
-            "name": "responsive",
-            "type": "boolean",
+            "name": "classNames",
+            "type": "HeatmapClassNames",
             "required": false,
-            "default": "false",
-            "description": "Enable a container-query context (container-type: inline-size) so GridItem sm/md/lg breakpoints respond to the grid's own width instead of the viewport"
+            "description": ""
           },
           {
             "name": "className",
             "type": "string",
             "required": false,
-            "description": "Additional CSS class"
+            "description": ""
           },
           {
-            "name": "children",
-            "type": "ReactNode",
-            "required": true,
-            "description": "GridItem elements"
+            "name": "ref",
+            "type": "Ref<HTMLDivElement>",
+            "required": false,
+            "description": ""
           }
         ]
       }
@@ -4311,7 +5243,7 @@
           },
           {
             "name": "color",
-            "type": "'success' | 'warning' | 'danger' | 'primary'",
+            "type": "'primary' | 'success' | 'warning' | 'danger'",
             "required": false,
             "description": ""
           }
@@ -4343,6 +5275,13 @@
             "required": false,
             "description": ""
           },
+          {
+            "name": "interactive",
+            "type": "boolean",
+            "required": false,
+            "default": "false",
+            "description": "PreviewTrigger semantics: focusable card content joins the Tab order (never trapped), focus may travel between trigger and card without closing it, Escape closes and returns focus to the trigger. Pointer grace defaults to 300ms in this mode; a focused card ignores pointer leaves."
+          },
           {
             "name": "placement",
             "type": "FloatingPlacement",
@@ -4413,10 +5352,36 @@
     },
     "Image": {
       "cssFamily": "image",
-      "importStatement": "import { Image } from 'haze-ui';\nimport 'haze-ui/css/tokens.css';\nimport 'haze-ui/css/image.css';",
+      "importStatement": "import { Image, ImagePreviewGroup } from 'haze-ui';\nimport 'haze-ui/css/tokens.css';\nimport 'haze-ui/css/image.css';",
       "peerDeps": [],
-      "description": "Image with fallback and `aspectRatio`/`objectFit` control.",
+      "description": "Image with fallback, `aspectRatio`/`objectFit` control and click-to-preview overlay; `ImagePreviewGroup` wraps child images in a shared gallery lightbox (arrows, counter, thumbnail strip).",
       "props": {
+        "ImagePreviewGroupProps": [
+          {
+            "name": "children",
+            "type": "ReactNode",
+            "required": true,
+            "description": ""
+          },
+          {
+            "name": "index",
+            "type": "ControlOrValue<number>",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "preview",
+            "type": "boolean | ImagePreviewConfig",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "showThumbnails",
+            "type": "boolean",
+            "required": false,
+            "description": ""
+          }
+        ],
         "ImagePreviewProps": [
           {
             "name": "src",
@@ -4447,6 +5412,24 @@
             "type": "boolean",
             "required": false,
             "description": ""
+          },
+          {
+            "name": "images",
+            "type": "readonly GalleryImage[]",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "index",
+            "type": "ControlOrValue<number>",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "showThumbnails",
+            "type": "boolean",
+            "required": false,
+            "description": ""
           }
         ],
         "ImageProps": [
@@ -4496,6 +5479,94 @@
         ]
       }
     },
+    "ImageCrop": {
+      "cssFamily": "image-crop",
+      "importStatement": "import { ImageCrop } from 'haze-ui';\nimport 'haze-ui/css/tokens.css';\nimport 'haze-ui/css/image-crop.css';",
+      "peerDeps": [],
+      "description": "Interactive image cropper pairing with Upload: controllable normalized CropRect value, aspect lock, circle avatar mask, pointer drag with corner handles, full keyboard operation (arrows move, Shift+arrows resize) and a getCroppedCanvas ref API.",
+      "props": {
+        "ImageCropProps": [
+          {
+            "name": "src",
+            "type": "string",
+            "required": true,
+            "description": ""
+          },
+          {
+            "name": "alt",
+            "type": "string",
+            "required": true,
+            "description": ""
+          },
+          {
+            "name": "value",
+            "type": "ControlOrValue<CropRect>",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "onChange",
+            "type": "(rect: CropRect) => void",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "aspect",
+            "type": "number",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "shape",
+            "type": "'circle' | 'rect'",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "cropLabel",
+            "type": "string",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "unsupportedLabel",
+            "type": "string",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "errorLabel",
+            "type": "string",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "disabled",
+            "type": "boolean",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "crossOrigin",
+            "type": "'anonymous' | 'use-credentials'",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "className",
+            "type": "string",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "ref",
+            "type": "Ref<ImageCropHandle>",
+            "required": false,
+            "description": ""
+          }
+        ]
+      }
+    },
     "Indicator": {
       "cssFamily": "indicator",
       "importStatement": "import { Indicator } from 'haze-ui';\nimport 'haze-ui/css/tokens.css';\nimport 'haze-ui/css/indicator.css';",
@@ -4517,7 +5588,7 @@
           },
           {
             "name": "color",
-            "type": "'success' | 'warning' | 'danger' | 'primary'",
+            "type": "'primary' | 'success' | 'warning' | 'danger'",
             "required": false,
             "description": ""
           },
@@ -4536,6 +5607,52 @@
         ]
       }
     },
+    "InlineCitation": {
+      "cssFamily": "inline-citation",
+      "importStatement": "import { InlineCitation } from 'haze-ui';\nimport 'haze-ui/css/tokens.css';\nimport 'haze-ui/css/inline-citation.css';",
+      "peerDeps": [],
+      "description": "Inline superscript citation marker that opens a floating source card with title, snippet and optional outbound link.",
+      "props": {
+        "InlineCitationProps": [
+          {
+            "name": "index",
+            "type": "number",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "href",
+            "type": "string",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "title",
+            "type": "ReactNode",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "snippet",
+            "type": "ReactNode",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "open",
+            "type": "ControlOrValue<boolean>",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "className",
+            "type": "string",
+            "required": false,
+            "description": ""
+          }
+        ]
+      }
+    },
     "InlineCompletion": {
       "cssFamily": "inline-completion",
       "importStatement": "import { InlineCompletion } from 'haze-ui';\nimport 'haze-ui/css/tokens.css';\nimport 'haze-ui/css/inline-completion.css';",
@@ -4731,41 +5848,101 @@
             "description": "Size of the input"
           },
           {
-            "name": "leftSection",
-            "type": "ReactNode",
+            "name": "leftSection",
+            "type": "ReactNode",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "rightSection",
+            "type": "ReactNode",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "ref",
+            "type": "Ref<HTMLInputElement>",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "disabled",
+            "type": "boolean",
+            "required": false,
+            "default": "false",
+            "description": "Disable the input"
+          },
+          {
+            "name": "className",
+            "type": "string",
+            "required": false,
+            "description": "Additional CSS class"
+          },
+          {
+            "name": "...rest",
+            "type": "InputHTMLAttributes",
+            "required": false,
+            "description": "All native input attributes"
+          }
+        ]
+      }
+    },
+    "InputGroup": {
+      "cssFamily": "input-group",
+      "importStatement": "import { InputGroup, InputGroupAddon, useInputGroup } from 'haze-ui';\nimport 'haze-ui/css/tokens.css';\nimport 'haze-ui/css/input-group.css';",
+      "peerDeps": [],
+      "description": "Field cluster: prefix/suffix addons (icon, text, button) merged with Input/Select into one attached control.",
+      "props": {
+        "InputGroupAddonProps": [
+          {
+            "name": "children",
+            "type": "ReactNode",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "size",
+            "type": "'sm' | 'md' | 'lg'",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "className",
+            "type": "string",
             "required": false,
             "description": ""
-          },
+          }
+        ],
+        "InputGroupProps": [
           {
-            "name": "rightSection",
-            "type": "ReactNode",
+            "name": "size",
+            "type": "'sm' | 'md' | 'lg'",
             "required": false,
             "description": ""
           },
           {
-            "name": "ref",
-            "type": "Ref<HTMLInputElement>",
+            "name": "classNames",
+            "type": "InputGroupClassNames",
             "required": false,
             "description": ""
           },
           {
-            "name": "disabled",
-            "type": "boolean",
-            "required": false,
-            "default": "false",
-            "description": "Disable the input"
+            "name": "children",
+            "type": "ReactNode",
+            "required": true,
+            "description": ""
           },
           {
             "name": "className",
             "type": "string",
             "required": false,
-            "description": "Additional CSS class"
+            "description": ""
           },
           {
-            "name": "...rest",
-            "type": "InputHTMLAttributes",
+            "name": "ref",
+            "type": "Ref<HTMLDivElement>",
             "required": false,
-            "description": "All native input attributes"
+            "description": ""
           }
         ]
       }
@@ -4822,6 +5999,12 @@
             "type": "'sm' | 'md'",
             "required": false,
             "description": ""
+          },
+          {
+            "name": "ref",
+            "type": "Ref<HTMLElement>",
+            "required": false,
+            "description": "Forwarded to the root kbd element (data-slot='kbd')"
           }
         ]
       }
@@ -5012,7 +6195,7 @@
         "MarkProps": [
           {
             "name": "color",
-            "type": "'success' | 'warning' | 'danger' | 'primary'",
+            "type": "'default' | 'primary' | 'success' | 'warning' | 'danger' | 'info'",
             "required": false,
             "description": ""
           }
@@ -5041,6 +6224,108 @@
         ]
       }
     },
+    "MaskedInput": {
+      "cssFamily": "masked-input",
+      "importStatement": "import { MaskedInput, MaskedInputCore, unmask, formatMask, parseMask, applyEdit } from 'haze-ui';\nimport 'haze-ui/css/tokens.css';\nimport 'haze-ui/css/masked-input.css';",
+      "peerDeps": [],
+      "description": "",
+      "props": {
+        "MaskedInputCoreProps": [
+          {
+            "name": "value",
+            "type": "string",
+            "required": true,
+            "description": ""
+          },
+          {
+            "name": "onChange",
+            "type": "(value: string) => void",
+            "required": true,
+            "description": ""
+          },
+          {
+            "name": "onNativeChange",
+            "type": "ChangeEventHandler<HTMLInputElement, HTMLInputElement> | undefined",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "mask",
+            "type": "string",
+            "required": true,
+            "description": ""
+          },
+          {
+            "name": "size",
+            "type": "'sm' | 'md' | 'lg'",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "leftSection",
+            "type": "ReactNode",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "rightSection",
+            "type": "ReactNode",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "className",
+            "type": "string",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "ref",
+            "type": "Ref<HTMLInputElement>",
+            "required": false,
+            "description": ""
+          }
+        ],
+        "MaskedInputProps": [
+          {
+            "name": "value",
+            "type": "ControlOrValue<string>",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "mask",
+            "type": "string",
+            "required": true,
+            "description": ""
+          },
+          {
+            "name": "size",
+            "type": "'sm' | 'md' | 'lg'",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "leftSection",
+            "type": "ReactNode",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "rightSection",
+            "type": "ReactNode",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "ref",
+            "type": "Ref<HTMLInputElement>",
+            "required": false,
+            "description": ""
+          }
+        ]
+      }
+    },
     "Masonry": {
       "cssFamily": "masonry",
       "importStatement": "import { Masonry } from 'haze-ui';\nimport 'haze-ui/css/tokens.css';\nimport 'haze-ui/css/masonry.css';",
@@ -5356,6 +6641,19 @@
             "required": false,
             "description": ""
           },
+          {
+            "name": "virtualized",
+            "type": "boolean",
+            "required": false,
+            "default": "false",
+            "description": "Opt-in: window the data-driven items list through VirtualList (fixed-height rows; requires the items data API; group entries fall back to the plain DOM path with a dev error). Arrows/Home/End/typeahead reach rows outside the mounted window by scrolling them in and focusing after the commit."
+          },
+          {
+            "name": "classNames",
+            "type": "MenuClassNames",
+            "required": false,
+            "description": ""
+          },
           {
             "name": "className",
             "type": "string",
@@ -5367,6 +6665,12 @@
             "type": "ReactNode",
             "required": false,
             "description": "MenuItem and MenuDivider elements"
+          },
+          {
+            "name": "ref",
+            "type": "Ref<HTMLDivElement>",
+            "required": false,
+            "description": ""
           }
         ],
         "MenuRadioGroupProps": [
@@ -5483,12 +6787,132 @@
             "type": "ReactNode",
             "required": true,
             "description": ""
-          }
-        ],
-        "MenuSubTriggerProps": [
+          }
+        ],
+        "MenuSubTriggerProps": [
+          {
+            "name": "disabled",
+            "type": "boolean",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "className",
+            "type": "string",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "children",
+            "type": "ReactNode",
+            "required": true,
+            "description": ""
+          }
+        ]
+      }
+    },
+    "Meter": {
+      "cssFamily": "meter",
+      "importStatement": "import { Meter, trackSizes } from 'haze-ui';\nimport 'haze-ui/css/tokens.css';\nimport 'haze-ui/css/meter.css';",
+      "peerDeps": [],
+      "description": "Read-only semantic gauge: value normalized over min/max, threshold bands recolor track and bar, visible label + aria-labelledby, showValue readout, three track sizes.",
+      "props": {
+        "MeterOwnProps": [
+          {
+            "name": "value",
+            "type": "number",
+            "required": true,
+            "description": ""
+          },
+          {
+            "name": "min",
+            "type": "number",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "max",
+            "type": "number",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "thresholds",
+            "type": "MeterThreshold[]",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "label",
+            "type": "ReactNode",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "showValue",
+            "type": "boolean",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "size",
+            "type": "'sm' | 'md' | 'lg'",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "classNames",
+            "type": "MeterClassNames",
+            "required": false,
+            "description": ""
+          }
+        ],
+        "MeterProps": [
+          {
+            "name": "value",
+            "type": "number",
+            "required": true,
+            "description": ""
+          },
+          {
+            "name": "min",
+            "type": "number",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "max",
+            "type": "number",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "thresholds",
+            "type": "MeterThreshold[]",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "label",
+            "type": "ReactNode",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "showValue",
+            "type": "boolean",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "size",
+            "type": "'sm' | 'md' | 'lg'",
+            "required": false,
+            "description": ""
+          },
           {
-            "name": "disabled",
-            "type": "boolean",
+            "name": "classNames",
+            "type": "MeterClassNames",
             "required": false,
             "description": ""
           },
@@ -5499,9 +6923,9 @@
             "description": ""
           },
           {
-            "name": "children",
-            "type": "ReactNode",
-            "required": true,
+            "name": "ref",
+            "type": "Ref<HTMLDivElement>",
+            "required": false,
             "description": ""
           }
         ]
@@ -5616,6 +7040,132 @@
         ]
       }
     },
+    "NavigationMenu": {
+      "cssFamily": "navigation-menu",
+      "importStatement": "import { NavigationMenu, NavigationMenuList, NavigationMenuItem, NavigationMenuTrigger, NavigationMenuContent } from 'haze-ui';\nimport 'haze-ui/css/tokens.css';\nimport 'haze-ui/css/navigation-menu.css';",
+      "peerDeps": [],
+      "description": "Hover mega-menu navigation bar: triggers open large content panels (link columns, card grids — any ReactNode) after an intent dwell with a pointer grace period; controllable `activeValue`, Escape closes, arrows traverse triggers.",
+      "props": {
+        "NavigationMenuContentProps": [
+          {
+            "name": "className",
+            "type": "string",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "children",
+            "type": "ReactNode",
+            "required": false,
+            "description": ""
+          }
+        ],
+        "NavigationMenuItemProps": [
+          {
+            "name": "value",
+            "type": "string",
+            "required": true,
+            "description": ""
+          },
+          {
+            "name": "className",
+            "type": "string",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "children",
+            "type": "ReactNode",
+            "required": false,
+            "description": ""
+          }
+        ],
+        "NavigationMenuListProps": [
+          {
+            "name": "className",
+            "type": "string",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "children",
+            "type": "ReactNode",
+            "required": false,
+            "description": ""
+          }
+        ],
+        "NavigationMenuProps": [
+          {
+            "name": "activeValue",
+            "type": "ControlOrValue<string | null>",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "onActiveValueChange",
+            "type": "(value: string | null) => void",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "intentDelay",
+            "type": "number",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "graceDelay",
+            "type": "number",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "stretchToTrigger",
+            "type": "boolean",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "classNames",
+            "type": "NavigationMenuClassNames",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "className",
+            "type": "string",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "ref",
+            "type": "Ref<HTMLElement>",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "children",
+            "type": "ReactNode",
+            "required": false,
+            "description": ""
+          }
+        ],
+        "NavigationMenuTriggerProps": [
+          {
+            "name": "className",
+            "type": "string",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "children",
+            "type": "ReactNode",
+            "required": false,
+            "description": ""
+          }
+        ]
+      }
+    },
     "NumberFormatter": {
       "cssFamily": "number-formatter",
       "importStatement": "import { NumberFormatter } from 'haze-ui';\nimport 'haze-ui/css/tokens.css';\nimport 'haze-ui/css/number-formatter.css';",
@@ -5658,7 +7208,7 @@
     },
     "NumberInput": {
       "cssFamily": "number-input",
-      "importStatement": "import { NumberInput, NumberInputCore } from 'haze-ui';\nimport 'haze-ui/css/tokens.css';\nimport 'haze-ui/css/number-input.css';",
+      "importStatement": "import { NumberInput, NumberInputCore, inputSizes, btnSizes } from 'haze-ui';\nimport 'haze-ui/css/tokens.css';\nimport 'haze-ui/css/number-input.css';",
       "peerDeps": [],
       "description": "Numeric input with `min`/`max`/`step`.",
       "props": {
@@ -5830,6 +7380,12 @@
             "required": false,
             "description": "Additional CSS class"
           },
+          {
+            "name": "name",
+            "type": "string",
+            "required": false,
+            "description": ""
+          },
           {
             "name": "ref",
             "type": "Ref<HTMLInputElement>",
@@ -5886,134 +7442,352 @@
             "description": "Renders a jump-to-page input that navigates on Enter (clamped to bounds). Ignored in simple mode."
           },
           {
-            "name": "showTotal",
-            "type": "(total: number, range: [number, number]) => ReactNode",
+            "name": "showTotal",
+            "type": "(total: number, range: [number, number]) => ReactNode",
+            "required": false,
+            "description": "Renders a summary of the total and the current page's item range"
+          },
+          {
+            "name": "simple",
+            "type": "boolean",
+            "required": false,
+            "default": "false",
+            "description": "Minimal mode: page input plus prev/next instead of the page list"
+          },
+          {
+            "name": "ellipsisJump",
+            "type": "boolean",
+            "required": false,
+            "default": "false",
+            "description": "Turns the ellipsis markers into buttons jumping ±5 pages (clamped)"
+          },
+          {
+            "name": "onPageChange",
+            "type": "(page: number, pageSize: number) => void",
+            "required": false,
+            "description": "Called for every page jump, ellipsis jump and page-size change"
+          },
+          {
+            "name": "size",
+            "type": "'sm' | 'md' | 'lg'",
+            "required": false,
+            "default": "'md'",
+            "description": "Size of pagination buttons"
+          },
+          {
+            "name": "className",
+            "type": "string",
+            "required": false,
+            "description": "Additional CSS class"
+          },
+          {
+            "name": "...rest",
+            "type": "NavHTMLAttributes",
+            "required": false,
+            "description": "All native nav attributes"
+          }
+        ]
+      }
+    },
+    "PasswordInput": {
+      "cssFamily": "password-input",
+      "importStatement": "import { PasswordInput, PasswordInputCore } from 'haze-ui';\nimport 'haze-ui/css/tokens.css';\nimport 'haze-ui/css/password-input.css';",
+      "peerDeps": [],
+      "description": "Text input with a visibility reveal toggle.",
+      "props": {
+        "PasswordInputCoreProps": [
+          {
+            "name": "value",
+            "type": "string",
+            "required": true,
+            "description": ""
+          },
+          {
+            "name": "onChange",
+            "type": "(value: string) => void",
+            "required": true,
+            "description": ""
+          },
+          {
+            "name": "placeholder",
+            "type": "string",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "disabled",
+            "type": "boolean",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "className",
+            "type": "string",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "ref",
+            "type": "Ref<HTMLInputElement>",
+            "required": false,
+            "description": ""
+          }
+        ],
+        "PasswordInputProps": [
+          {
+            "name": "value",
+            "type": "ControlOrValue<string>",
+            "required": false,
+            "description": "Controlled value"
+          },
+          {
+            "name": "onChange",
+            "type": "(value: string) => void",
+            "required": false,
+            "description": "Called when value changes"
+          },
+          {
+            "name": "placeholder",
+            "type": "string",
+            "required": false,
+            "description": "Input placeholder"
+          },
+          {
+            "name": "disabled",
+            "type": "boolean",
+            "required": false,
+            "default": "false",
+            "description": "Disable the input"
+          },
+          {
+            "name": "className",
+            "type": "string",
+            "required": false,
+            "description": "Additional CSS class"
+          },
+          {
+            "name": "ref",
+            "type": "Ref<HTMLInputElement>",
+            "required": false,
+            "description": ""
+          }
+        ]
+      }
+    },
+    "PhoneInput": {
+      "cssFamily": "phone-input",
+      "importStatement": "import { PhoneInput, isValidPhone } from 'haze-ui';\nimport 'haze-ui/css/tokens.css';\nimport 'haze-ui/css/phone-input.css';",
+      "peerDeps": [],
+      "description": "International phone input backed by libphonenumber-js: country select joined seamlessly to the number field, E.164-ish value, `isValidPhone()` pure helper.",
+      "props": {
+        "PhoneInputProps": [
+          {
+            "name": "value",
+            "type": "ControlOrValue<string>",
             "required": false,
-            "description": "Renders a summary of the total and the current page's item range"
+            "description": ""
           },
           {
-            "name": "simple",
-            "type": "boolean",
+            "name": "country",
+            "type": "ControlOrValue<CountryCode>",
             "required": false,
-            "default": "false",
-            "description": "Minimal mode: page input plus prev/next instead of the page list"
+            "description": ""
           },
           {
-            "name": "ellipsisJump",
-            "type": "boolean",
+            "name": "onCountryChange",
+            "type": "(country: CountryCode) => void",
             "required": false,
-            "default": "false",
-            "description": "Turns the ellipsis markers into buttons jumping ±5 pages (clamped)"
+            "description": ""
           },
           {
-            "name": "onPageChange",
-            "type": "(page: number, pageSize: number) => void",
+            "name": "onChange",
+            "type": "(value: string) => void",
             "required": false,
-            "description": "Called for every page jump, ellipsis jump and page-size change"
+            "description": ""
           },
           {
             "name": "size",
             "type": "'sm' | 'md' | 'lg'",
             "required": false,
-            "default": "'md'",
-            "description": "Size of pagination buttons"
+            "description": ""
           },
           {
             "name": "className",
             "type": "string",
             "required": false,
-            "description": "Additional CSS class"
+            "description": ""
           },
           {
-            "name": "...rest",
-            "type": "NavHTMLAttributes",
+            "name": "ref",
+            "type": "Ref<HTMLInputElement>",
             "required": false,
-            "description": "All native nav attributes"
+            "description": ""
           }
         ]
       }
     },
-    "PasswordInput": {
-      "cssFamily": "password-input",
-      "importStatement": "import { PasswordInput, PasswordInputCore } from 'haze-ui';\nimport 'haze-ui/css/tokens.css';\nimport 'haze-ui/css/password-input.css';",
+    "Plan": {
+      "cssFamily": "plan",
+      "importStatement": "import { Plan, PlanItem } from 'haze-ui';\nimport 'haze-ui/css/tokens.css';\nimport 'haze-ui/css/plan.css';",
       "peerDeps": [],
-      "description": "Text input with a visibility reveal toggle.",
+      "description": "Agent plan and progress display: `Plan` + `Plan.Item` step list whose statuses drive an auto progress bar and summary.",
       "props": {
-        "PasswordInputCoreProps": [
+        "PlanItemProps": [
           {
-            "name": "value",
-            "type": "string",
+            "name": "label",
+            "type": "ReactNode",
             "required": true,
             "description": ""
           },
           {
-            "name": "onChange",
-            "type": "(value: string) => void",
-            "required": true,
+            "name": "description",
+            "type": "ReactNode",
+            "required": false,
             "description": ""
           },
           {
-            "name": "placeholder",
+            "name": "status",
+            "type": "PlanStatus",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "className",
             "type": "string",
             "required": false,
             "description": ""
+          }
+        ],
+        "PlanProps": [
+          {
+            "name": "title",
+            "type": "ReactNode",
+            "required": false,
+            "description": ""
           },
           {
-            "name": "disabled",
-            "type": "boolean",
+            "name": "summary",
+            "type": "(done: number, total: number) => ReactNode",
             "required": false,
             "description": ""
           },
           {
-            "name": "className",
-            "type": "string",
+            "name": "children",
+            "type": "ReactNode",
             "required": false,
             "description": ""
           },
           {
-            "name": "ref",
-            "type": "Ref<HTMLInputElement>",
+            "name": "className",
+            "type": "string",
             "required": false,
             "description": ""
           }
-        ],
-        "PasswordInputProps": [
+        ]
+      }
+    },
+    "Popconfirm": {
+      "cssFamily": "popconfirm",
+      "importStatement": "import { Popconfirm } from 'haze-ui';\nimport 'haze-ui/css/tokens.css';\nimport 'haze-ui/css/popconfirm.css';",
+      "peerDeps": [],
+      "description": "Anchored confirmation bubble with confirm/cancel actions and async busy support.",
+      "props": {
+        "PopconfirmProps": [
           {
-            "name": "value",
-            "type": "ControlOrValue<string>",
+            "name": "title",
+            "type": "ReactNode",
             "required": false,
-            "description": "Controlled value"
+            "description": "Panel heading — the confirmation question"
           },
           {
-            "name": "onChange",
-            "type": "(value: string) => void",
+            "name": "description",
+            "type": "ReactNode",
             "required": false,
-            "description": "Called when value changes"
+            "description": "Secondary explanation under the title"
           },
           {
-            "name": "placeholder",
+            "name": "okText",
             "type": "string",
             "required": false,
-            "description": "Input placeholder"
+            "default": "confirmDialog.confirm locale",
+            "description": "OK button label override"
+          },
+          {
+            "name": "cancelText",
+            "type": "string",
+            "required": false,
+            "default": "confirmDialog.cancel locale",
+            "description": "Cancel button label override"
+          },
+          {
+            "name": "okVariant",
+            "type": "'primary' | 'danger'",
+            "required": false,
+            "default": "'primary'",
+            "description": "OK button tone; danger remaps the solid skin onto the danger token family"
+          },
+          {
+            "name": "icon",
+            "type": "ReactNode",
+            "required": false,
+            "description": "Decorative glyph beside the title"
+          },
+          {
+            "name": "onConfirm",
+            "type": "() => void | Promise<unknown>",
+            "required": false,
+            "description": "Fired on confirm; a returned promise busy's the OK button, closes on resolve, stays open on reject"
+          },
+          {
+            "name": "onCancel",
+            "type": "() => void | Promise<unknown>",
+            "required": false,
+            "description": "Fired on cancel (button, Escape); same async busy contract on the cancel button"
+          },
+          {
+            "name": "placement",
+            "type": "PopconfirmPlacement",
+            "required": false,
+            "default": "'top'",
+            "description": "Panel placement relative to the trigger (logical, same set as Popover minus 'point')"
+          },
+          {
+            "name": "open",
+            "type": "ControlOrValue<boolean>",
+            "required": false,
+            "default": "false",
+            "description": "Whether the panel is open (controlled or uncontrolled)"
           },
           {
             "name": "disabled",
             "type": "boolean",
             "required": false,
             "default": "false",
-            "description": "Disable the input"
+            "description": "Inert trigger: no pointer or keyboard open"
           },
           {
             "name": "className",
             "type": "string",
             "required": false,
-            "description": "Additional CSS class"
+            "description": "Additional CSS class on the floating panel"
+          },
+          {
+            "name": "children",
+            "type": "ReactNode",
+            "required": true,
+            "description": "Trigger content"
           },
           {
             "name": "ref",
-            "type": "Ref<HTMLInputElement>",
+            "type": "Ref<PopconfirmHandle>",
             "required": false,
-            "description": ""
+            "description": "Imperative handle: open() (respects disabled), close(), focusTrigger()"
+          },
+          {
+            "name": "...rest",
+            "type": "div props",
+            "required": false,
+            "description": "Native div attributes spread onto the floating panel"
           }
         ]
       }
@@ -6073,7 +7847,7 @@
     },
     "Progress": {
       "cssFamily": "progress",
-      "importStatement": "import { Progress } from 'haze-ui';\nimport 'haze-ui/css/tokens.css';\nimport 'haze-ui/css/progress.css';",
+      "importStatement": "import { Progress, barSizes, circleSizes } from 'haze-ui';\nimport 'haze-ui/css/tokens.css';\nimport 'haze-ui/css/progress.css';",
       "peerDeps": [],
       "description": "Progress bar or circle driven by a percentage `value`.",
       "props": {
@@ -6101,16 +7875,35 @@
           },
           {
             "name": "color",
-            "type": "'success' | 'warning' | 'danger' | 'primary'",
+            "type": "'default' | 'primary' | 'success' | 'warning' | 'danger' | 'info'",
             "required": false,
             "default": "'primary'",
-            "description": "Color variant"
+            "description": "Semantic status color"
           },
           {
             "name": "className",
             "type": "string",
             "required": false,
             "description": "Additional CSS class"
+          },
+          {
+            "name": "ref",
+            "type": "Ref<HTMLDivElement>",
+            "required": false,
+            "description": "Forwarded to the root element (data-slot='progress')"
+          },
+          {
+            "name": "aria-label",
+            "type": "string",
+            "required": false,
+            "default": "'Progress'",
+            "description": "Accessible name for the progressbar; inlined default keeps the component RSC-safe (hook-free), locale-aware callers pass their own label"
+          },
+          {
+            "name": "...rest",
+            "type": "ComponentPropsWithoutRef<'div'>",
+            "required": false,
+            "description": "Native div attributes forwarded to the progressbar element"
           }
         ]
       }
@@ -6199,6 +7992,87 @@
         ]
       }
     },
+    "PullToRefresh": {
+      "cssFamily": "pull-to-refresh",
+      "importStatement": "import { PullToRefresh } from 'haze-ui';\nimport 'haze-ui/css/tokens.css';\nimport 'haze-ui/css/pull-to-refresh.css';",
+      "peerDeps": [],
+      "description": "Mobile pull-to-refresh gesture wrapper: pointer/touch state machine (idle → pulling → ready → refreshing) with damped pull, scroll-edge canRefresh gate and a promise-gated spinner head.",
+      "props": {
+        "PullToRefreshProps": [
+          {
+            "name": "onRefresh",
+            "type": "() => void | Promise<unknown>",
+            "required": true,
+            "description": "Refresh action; a returned promise holds the refreshing phase (spinner) until it settles — fulfilled or rejected — then the head springs back"
+          },
+          {
+            "name": "children",
+            "type": "ReactNode",
+            "required": true,
+            "description": "Scrolling content; the gesture starts from anywhere inside it"
+          },
+          {
+            "name": "distance",
+            "type": "number",
+            "required": false,
+            "default": "64",
+            "description": "Pull distance (px) that arms the refresh; also sizes the head and the resting offset while refreshing (mirrors --haze-space-16)"
+          },
+          {
+            "name": "disabled",
+            "type": "boolean",
+            "required": false,
+            "default": "false",
+            "description": "Disables the gesture entirely (render output unchanged)"
+          },
+          {
+            "name": "canRefresh",
+            "type": "() => boolean",
+            "required": false,
+            "description": "Replaces the default scroll-edge gate (every ancestor between the touched element and the document root at scrollTop 0); evaluated once per pull as it crosses the slop"
+          },
+          {
+            "name": "indicator",
+            "type": "(info: PullToRefreshIndicatorInfo) => ReactNode",
+            "required": false,
+            "description": "Render prop for the head ({ phase, progress 0..1 }); default is a down arrow that flips when armed, a Spinner once refreshing, plus the status text props"
+          },
+          {
+            "name": "pullingText",
+            "type": "ReactNode",
+            "required": false,
+            "default": "'Pull to refresh'",
+            "description": "Status text while pulling below the threshold (default indicator)"
+          },
+          {
+            "name": "readyText",
+            "type": "ReactNode",
+            "required": false,
+            "default": "'Release to refresh'",
+            "description": "Status text once the pull passes the threshold (default indicator)"
+          },
+          {
+            "name": "refreshingText",
+            "type": "ReactNode",
+            "required": false,
+            "default": "'Refreshing…'",
+            "description": "Status text while the refresh promise is pending (default indicator)"
+          },
+          {
+            "name": "ref",
+            "type": "Ref<HTMLDivElement>",
+            "required": false,
+            "description": "Forwarded to the root container (data-slot='container')"
+          },
+          {
+            "name": "className",
+            "type": "string",
+            "required": false,
+            "description": "Additional CSS class"
+          }
+        ]
+      }
+    },
     "QRCode": {
       "cssFamily": "qr-code",
       "importStatement": "import { QRCode } from 'haze-ui';\nimport 'haze-ui/css/tokens.css';\nimport 'haze-ui/css/qr-code.css';",
@@ -6213,31 +8087,91 @@
             "description": ""
           },
           {
-            "name": "size",
-            "type": "number",
+            "name": "size",
+            "type": "number",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "level",
+            "type": "QRCodeLevel",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "bordered",
+            "type": "boolean",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "modulesColor",
+            "type": "string",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "bgColor",
+            "type": "string",
+            "required": false,
+            "description": ""
+          }
+        ]
+      }
+    },
+    "Queue": {
+      "cssFamily": "queue",
+      "importStatement": "import { Queue, QueueItem } from 'haze-ui';\nimport 'haze-ui/css/tokens.css';\nimport 'haze-ui/css/queue.css';",
+      "peerDeps": [],
+      "description": "Queue of pending agent actions or messages (`Queue` + `Queue.Item`) with queued/sending/failed status and optional per-item removal.",
+      "props": {
+        "QueueItemProps": [
+          {
+            "name": "title",
+            "type": "ReactNode",
+            "required": true,
+            "description": ""
+          },
+          {
+            "name": "description",
+            "type": "ReactNode",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "status",
+            "type": "QueueStatus",
             "required": false,
             "description": ""
           },
           {
-            "name": "level",
-            "type": "QRCodeLevel",
+            "name": "onRemove",
+            "type": "() => void",
             "required": false,
             "description": ""
           },
           {
-            "name": "bordered",
-            "type": "boolean",
+            "name": "removeLabel",
+            "type": "string",
             "required": false,
             "description": ""
           },
           {
-            "name": "modulesColor",
+            "name": "className",
             "type": "string",
             "required": false,
             "description": ""
+          }
+        ],
+        "QueueProps": [
+          {
+            "name": "children",
+            "type": "ReactNode",
+            "required": true,
+            "description": ""
           },
           {
-            "name": "bgColor",
+            "name": "className",
             "type": "string",
             "required": false,
             "description": ""
@@ -6426,6 +8360,12 @@
             "required": false,
             "description": "Additional CSS class"
           },
+          {
+            "name": "name",
+            "type": "string",
+            "required": false,
+            "description": ""
+          },
           {
             "name": "ref",
             "type": "Ref<HTMLSpanElement>",
@@ -6437,9 +8377,9 @@
     },
     "Resizable": {
       "cssFamily": "resizable",
-      "importStatement": "import { ResizableGroup, ResizablePanel, ResizableHandle, SplitterGroup, SplitterPanel, SplitterHandle } from 'haze-ui';\nimport 'haze-ui/css/tokens.css';\nimport 'haze-ui/css/resizable.css';",
+      "importStatement": "import { ResizableGroup, ResizablePanel, ResizableHandle } from 'haze-ui';\nimport 'haze-ui/css/tokens.css';\nimport 'haze-ui/css/resizable.css';",
       "peerDeps": [],
-      "description": "Split-pane group with draggable dividers, horizontal or vertical; also exported as `SplitterGroup`/`SplitterPanel`/`SplitterHandle` (AntD-style naming).",
+      "description": "Split-pane group with draggable dividers, horizontal or vertical; px sizing per panel with `onResizeCommit` for persistence.",
       "props": {
         "ResizableGroupProps": [
           {
@@ -6472,12 +8412,6 @@
             "type": "(sizes: Record<string, number>) => void",
             "required": false,
             "description": "Fires once when a drag or keyboard resize settles, mapping fixed-panel ids to their committed px sizes — the persistence hook (write it back into a store or Control)"
-          },
-          {
-            "name": "SplitterGroup · SplitterPanel · SplitterHandle",
-            "type": "aliases",
-            "required": false,
-            "description": "AntD migration entry: `import { SplitterGroup, SplitterPanel, SplitterHandle } from 'haze-ui'` maps 1:1 onto ResizableGroup / ResizablePanel / ResizableHandle (same props)"
           }
         ],
         "ResizableHandleProps": [
@@ -6595,11 +8529,193 @@
         ]
       }
     },
+    "RichTextEditor": {
+      "cssFamily": "rich-text-editor",
+      "importStatement": "import { RichTextEditor } from 'haze-ui';\nimport 'haze-ui/css/tokens.css';\nimport 'haze-ui/css/rich-text-editor.css';",
+      "peerDeps": [],
+      "description": "Tiptap-powered rich text editor with a built-in formatting toolbar and controllable HTML `value`.",
+      "props": {
+        "RichTextEditorProps": [
+          {
+            "name": "value",
+            "type": "ControlOrValue<string>",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "placeholder",
+            "type": "string",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "editable",
+            "type": "ControlOrValue<boolean>",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "toolbar",
+            "type": "ReactNode",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "extensions",
+            "type": "AnyExtension[]",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "editorKey",
+            "type": "string",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "name",
+            "type": "string",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "ref",
+            "type": "Ref<RichTextEditorHandle>",
+            "required": false,
+            "description": ""
+          }
+        ]
+      }
+    },
+    "Schedule": {
+      "cssFamily": "schedule",
+      "importStatement": "import { Schedule } from 'haze-ui';\nimport 'haze-ui/css/tokens.css';\nimport 'haze-ui/css/schedule.css';",
+      "peerDeps": [],
+      "description": "Calendar surface with day/week/month views, drag-and-keyboard rescheduling and a month grid with overflow chips.",
+      "props": {
+        "ScheduleProps": [
+          {
+            "name": "events",
+            "type": "ScheduleEvent[]",
+            "required": true,
+            "description": ""
+          },
+          {
+            "name": "view",
+            "type": "ControlOrValue<ScheduleView>",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "onViewChange",
+            "type": "(view: ScheduleView) => void",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "date",
+            "type": "ControlOrValue<Date>",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "onDateChange",
+            "type": "(date: Date) => void",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "slotMinutes",
+            "type": "number",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "businessHours",
+            "type": "ScheduleBusinessHours",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "nowIndicator",
+            "type": "boolean",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "onEventClick",
+            "type": "(event: ScheduleEvent) => void",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "onEventChange",
+            "type": "(change: ScheduleEventChange) => void",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "onDayClick",
+            "type": "(date: Date) => void",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "todayLabel",
+            "type": "string",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "prevLabel",
+            "type": "string",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "nextLabel",
+            "type": "string",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "viewLabels",
+            "type": "Partial<Record<ScheduleView, string>>",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "locale",
+            "type": "string",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "classNames",
+            "type": "ScheduleClassNames",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "className",
+            "type": "string",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "ref",
+            "type": "Ref<HTMLDivElement>",
+            "required": false,
+            "description": ""
+          }
+        ]
+      }
+    },
     "ScrollArea": {
       "cssFamily": "scroll-area",
-      "importStatement": "import { ScrollArea } from 'haze-ui';\nimport 'haze-ui/css/tokens.css';\nimport 'haze-ui/css/scroll-area.css';",
+      "importStatement": "import { ScrollArea, Scrollbar, ScrollThumb, ScrollViewport } from 'haze-ui';\nimport 'haze-ui/css/tokens.css';\nimport 'haze-ui/css/scroll-area.css';",
       "peerDeps": [],
-      "description": "Scrollable region with custom-styled thin scrollbars and `maxHeight`.",
+      "description": "Scrollable region with overlay scrollbar thumbs: `maxHeight` sugar or compound `ScrollViewport`/`Scrollbar`/`ScrollThumb` parts; `type` = `hover`/`always`/`scroll` visibility, keyboard-focusable viewport, RTL-mirrored thumbs.",
       "props": {
         "ScrollAreaProps": [
           {
@@ -6608,6 +8724,18 @@
             "required": false,
             "description": "Maximum height (px if number)"
           },
+          {
+            "name": "type",
+            "type": "ScrollbarMode",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "label",
+            "type": "string",
+            "required": false,
+            "description": ""
+          },
           {
             "name": "className",
             "type": "string",
@@ -6619,6 +8747,78 @@
             "type": "ReactNode",
             "required": true,
             "description": "Scrollable content"
+          },
+          {
+            "name": "ref",
+            "type": "Ref<HTMLDivElement>",
+            "required": false,
+            "description": ""
+          }
+        ],
+        "ScrollThumbProps": [
+          {
+            "name": "orientation",
+            "type": "Orientation",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "className",
+            "type": "string",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "ref",
+            "type": "Ref<HTMLDivElement>",
+            "required": false,
+            "description": ""
+          }
+        ],
+        "ScrollViewportProps": [
+          {
+            "name": "className",
+            "type": "string",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "children",
+            "type": "ReactNode",
+            "required": true,
+            "description": ""
+          },
+          {
+            "name": "ref",
+            "type": "Ref<HTMLDivElement>",
+            "required": false,
+            "description": ""
+          }
+        ],
+        "ScrollbarProps": [
+          {
+            "name": "orientation",
+            "type": "Orientation",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "className",
+            "type": "string",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "children",
+            "type": "ReactNode",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "ref",
+            "type": "Ref<HTMLDivElement>",
+            "required": false,
+            "description": ""
           }
         ]
       }
@@ -6694,10 +8894,16 @@
             "description": "Segment size"
           },
           {
-            "name": "className",
+            "name": "className",
+            "type": "string",
+            "required": false,
+            "description": "Additional CSS class"
+          },
+          {
+            "name": "name",
             "type": "string",
             "required": false,
-            "description": "Additional CSS class"
+            "description": ""
           },
           {
             "name": "ref",
@@ -6731,7 +8937,7 @@
         "OptionProps": [
           {
             "name": "value",
-            "type": "string",
+            "type": "string | number",
             "required": true,
             "description": ""
           },
@@ -6745,13 +8951,13 @@
         "SelectCoreProps": [
           {
             "name": "value",
-            "type": "string | string[]",
+            "type": "T | T[]",
             "required": true,
             "description": ""
           },
           {
             "name": "onChange",
-            "type": "(value: string | string[]) => void",
+            "type": "(value: T | T[]) => void",
             "required": true,
             "description": ""
           },
@@ -6773,6 +8979,18 @@
             "required": false,
             "description": ""
           },
+          {
+            "name": "tags",
+            "type": "boolean",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "maxCount",
+            "type": "number",
+            "required": false,
+            "description": ""
+          },
           {
             "name": "searchable",
             "type": "boolean",
@@ -6818,7 +9036,7 @@
           {
             "name": "children",
             "type": "ReactNode",
-            "required": true,
+            "required": false,
             "description": ""
           },
           {
@@ -6835,7 +9053,7 @@
           },
           {
             "name": "ref",
-            "type": "Ref<HTMLButtonElement | HTMLSelectElement>",
+            "type": "Ref<HTMLButtonElement | HTMLInputElement | HTMLSelectElement>",
             "required": false,
             "description": ""
           }
@@ -6843,19 +9061,19 @@
         "SelectFloatingProps": [
           {
             "name": "value",
-            "type": "string | string[]",
+            "type": "T | T[]",
             "required": true,
             "description": ""
           },
           {
             "name": "onChange",
-            "type": "(value: string | string[]) => void",
+            "type": "(value: T | T[]) => void",
             "required": true,
             "description": ""
           },
           {
             "name": "entries",
-            "type": "SelectEntryData[]",
+            "type": "SelectEntryData<T>[]",
             "required": true,
             "description": ""
           },
@@ -6865,6 +9083,12 @@
             "required": true,
             "description": ""
           },
+          {
+            "name": "tags",
+            "type": "boolean",
+            "required": false,
+            "description": ""
+          },
           {
             "name": "placeholder",
             "type": "string",
@@ -6913,6 +9137,12 @@
             "required": false,
             "description": ""
           },
+          {
+            "name": "maxCount",
+            "type": "number",
+            "required": false,
+            "description": ""
+          },
           {
             "name": "virtualized",
             "type": "boolean | SelectVirtualizedConfig",
@@ -6927,7 +9157,7 @@
           },
           {
             "name": "ref",
-            "type": "Ref<HTMLButtonElement>",
+            "type": "Ref<HTMLButtonElement | HTMLInputElement>",
             "required": false,
             "description": ""
           }
@@ -6935,7 +9165,7 @@
         "SelectProps": [
           {
             "name": "value",
-            "type": "ControlOrValue<string | string[]>",
+            "type": "ControlOrValue<T | T[]>",
             "required": false,
             "description": "Controlled value or control object"
           },
@@ -6945,6 +9175,18 @@
             "required": false,
             "description": ""
           },
+          {
+            "name": "tags",
+            "type": "boolean",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "maxCount",
+            "type": "number",
+            "required": false,
+            "description": ""
+          },
           {
             "name": "searchable",
             "type": "boolean",
@@ -6983,10 +9225,16 @@
           },
           {
             "name": "onValuesChange",
-            "type": "(value: string | string[]) => void",
+            "type": "(value: T | T[]) => void",
             "required": false,
             "description": ""
           },
+          {
+            "name": "options",
+            "type": "SelectOption<T>[]",
+            "required": false,
+            "description": "Data-driven option entries (Menu `items` shape): plain options and labelled groups rendered through the same components as children — identical behavior in every mode"
+          },
           {
             "name": "placeholder",
             "type": "string",
@@ -7008,15 +9256,21 @@
           },
           {
             "name": "ref",
-            "type": "Ref<HTMLButtonElement | HTMLSelectElement>",
+            "type": "Ref<HTMLButtonElement | HTMLInputElement | HTMLSelectElement>",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "name",
+            "type": "string",
             "required": false,
             "description": ""
           },
           {
             "name": "children",
             "type": "ReactNode",
-            "required": true,
-            "description": "<Option> elements"
+            "required": false,
+            "description": "Compound <Option>/<OptionGroup> children; composes after the data-driven `options` entries"
           },
           {
             "name": "disabled",
@@ -7511,8 +9765,8 @@
             "description": ""
           },
           {
-            "name": "tone",
-            "type": "'info' | 'success' | 'warning' | 'danger' | 'primary'",
+            "name": "color",
+            "type": "'default' | 'primary' | 'success' | 'warning' | 'danger' | 'info'",
             "required": false,
             "description": ""
           },
@@ -7544,6 +9798,84 @@
             "type": "string",
             "required": false,
             "description": "Additional CSS class"
+          },
+          {
+            "name": "ref",
+            "type": "Ref<HTMLSpanElement>",
+            "required": false,
+            "description": "Forwarded to the root span (data-slot='spinner')"
+          }
+        ]
+      }
+    },
+    "Splitter": {
+      "cssFamily": "splitter",
+      "importStatement": "import { Splitter, SplitterPane } from 'haze-ui';\nimport 'haze-ui/css/tokens.css';\nimport 'haze-ui/css/splitter.css';",
+      "peerDeps": [],
+      "description": "Multi-pane split layout with implicit draggable dividers (AntD Splitter semantics): `sizes` in percent of the pane area (`ControlOrValue` array), per-pane `min`/`max` clamps, opt-in `collapsible` panes with divider collapse/expand triggers, keyboard arrows and pointer drags.",
+      "props": {
+        "SplitterPaneProps": [
+          {
+            "name": "min",
+            "type": "number",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "max",
+            "type": "number",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "collapsible",
+            "type": "boolean",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "children",
+            "type": "ReactNode",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "className",
+            "type": "string",
+            "required": false,
+            "description": ""
+          }
+        ],
+        "SplitterProps": [
+          {
+            "name": "orientation",
+            "type": "'vertical' | 'horizontal'",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "sizes",
+            "type": "ControlOrValue<number[]>",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "onSizesChange",
+            "type": "(sizes: number[]) => void",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "children",
+            "type": "ReactNode",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "className",
+            "type": "string",
+            "required": false,
+            "description": ""
           }
         ]
       }
@@ -7731,7 +10063,7 @@
       "cssFamily": "step-timeline",
       "importStatement": "import { StepTimeline, StepTimelineItem } from 'haze-ui';\nimport 'haze-ui/css/tokens.css';\nimport 'haze-ui/css/step-timeline.css';",
       "peerDeps": [],
-      "description": "Vertical timeline of agent execution steps with per-step status.",
+      "description": "Vertical timeline of agent execution steps — per-step status (incl. `running`), timing, collapsible detail panels and nested sub-steps.",
       "props": {
         "StepTimelineItemProps": [
           {
@@ -7753,6 +10085,48 @@
             "default": "'pending'",
             "description": "Step status"
           },
+          {
+            "name": "time",
+            "type": "ReactNode",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "icon",
+            "type": "ReactNode",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "collapsible",
+            "type": "boolean",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "content",
+            "type": "ReactNode",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "open",
+            "type": "ControlOrValue<boolean>",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "onOpenChange",
+            "type": "(open: boolean) => void",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "children",
+            "type": "ReactNode",
+            "required": false,
+            "description": ""
+          },
           {
             "name": "className",
             "type": "string",
@@ -7934,7 +10308,7 @@
     },
     "Switch": {
       "cssFamily": "switch",
-      "importStatement": "import { Switch, SwitchCore } from 'haze-ui';\nimport 'haze-ui/css/tokens.css';\nimport 'haze-ui/css/switch.css';",
+      "importStatement": "import { Switch, SwitchCore, trackSizes, thumbSizes } from 'haze-ui';\nimport 'haze-ui/css/tokens.css';\nimport 'haze-ui/css/switch.css';",
       "peerDeps": [],
       "description": "Toggle switch (`role=\"switch\"`) with controllable `checked`.",
       "props": {
@@ -7990,6 +10364,12 @@
             "default": "'md'",
             "description": "Size of the switch"
           },
+          {
+            "name": "name",
+            "type": "string",
+            "required": false,
+            "description": ""
+          },
           {
             "name": "ref",
             "type": "Ref<HTMLButtonElement>",
@@ -8154,6 +10534,12 @@
             "default": "false",
             "description": "Add cell borders"
           },
+          {
+            "name": "classNames",
+            "type": "TableClassNames",
+            "required": false,
+            "description": ""
+          },
           {
             "name": "className",
             "type": "string",
@@ -8165,6 +10551,12 @@
             "type": "ReactNode",
             "required": true,
             "description": "TableHead and TableBody elements"
+          },
+          {
+            "name": "ref",
+            "type": "Ref<HTMLTableElement>",
+            "required": false,
+            "description": ""
           }
         ],
         "TableRowProps": [
@@ -8185,7 +10577,7 @@
     },
     "Tabs": {
       "cssFamily": "tabs",
-      "importStatement": "import { Tabs, TabList, Tab, TabPanel, SortableTabList } from 'haze-ui';\nimport 'haze-ui/css/tokens.css';\nimport 'haze-ui/css/tabs.css';",
+      "importStatement": "import { Tabs, TabList, Tab, TabPanel, SortableTabList, tabVariants, listVariants } from 'haze-ui';\nimport 'haze-ui/css/tokens.css';\nimport 'haze-ui/css/tabs.css';",
       "peerDeps": [],
       "description": "Tab panel switcher with controllable active tab (`TabList`, `Tab`, `TabPanel`).",
       "props": {
@@ -8286,6 +10678,12 @@
             "required": false,
             "description": "Overrides the status word appended to the accessible name (the i18n hook for SR users)"
           },
+          {
+            "name": "disabled",
+            "type": "boolean",
+            "required": false,
+            "description": ""
+          },
           {
             "name": "closable",
             "type": "boolean",
@@ -8325,6 +10723,36 @@
             "required": false,
             "description": "Active tab value"
           },
+          {
+            "name": "variant",
+            "type": "TabsVariant",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "items",
+            "type": "TabData[]",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "destroyInactiveTabPane",
+            "type": "boolean",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "lazy",
+            "type": "boolean",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "addable",
+            "type": "TabsAddable",
+            "required": false,
+            "description": ""
+          },
           {
             "name": "classNames",
             "type": "TabsClassNames",
@@ -8337,10 +10765,16 @@
             "required": false,
             "description": "Additional CSS class"
           },
+          {
+            "name": "ref",
+            "type": "Ref<HTMLDivElement>",
+            "required": false,
+            "description": ""
+          },
           {
             "name": "children",
             "type": "ReactNode",
-            "required": true,
+            "required": false,
             "description": "TabList and TabPanel elements"
           }
         ]
@@ -8348,17 +10782,55 @@
     },
     "Tag": {
       "cssFamily": "tag",
-      "importStatement": "import { Tag } from 'haze-ui';\nimport 'haze-ui/css/tokens.css';\nimport 'haze-ui/css/tag.css';",
+      "importStatement": "import { Tag, tagVariants, tagSizes } from 'haze-ui';\nimport 'haze-ui/css/tokens.css';\nimport 'haze-ui/css/tag.css';",
       "peerDeps": [],
       "description": "Compact status label with variant color and optional close button.",
       "props": {
+        "TagOwnProps": [
+          {
+            "name": "color",
+            "type": "'default' | 'primary' | 'success' | 'warning' | 'danger' | 'info'",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "size",
+            "type": "'sm' | 'md'",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "closable",
+            "type": "boolean",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "onClose",
+            "type": "() => void",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "removeLabel",
+            "type": "string",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "children",
+            "type": "ReactNode",
+            "required": true,
+            "description": ""
+          }
+        ],
         "TagProps": [
           {
-            "name": "variant",
-            "type": "'success' | 'warning' | 'danger' | 'default' | 'primary'",
+            "name": "color",
+            "type": "'default' | 'primary' | 'success' | 'warning' | 'danger' | 'info'",
             "required": false,
             "default": "'default'",
-            "description": "Color variant"
+            "description": "Semantic status color"
           },
           {
             "name": "size",
@@ -8381,16 +10853,36 @@
             "description": "Called when close button is clicked"
           },
           {
-            "name": "className",
+            "name": "removeLabel",
             "type": "string",
             "required": false,
-            "description": "Additional CSS class"
+            "default": "'Remove'",
+            "description": "Accessible label for the remove button; inlined default keeps the component RSC-safe (hook-free), locale-aware callers pass their own string"
           },
           {
             "name": "children",
             "type": "ReactNode",
             "required": true,
             "description": "Tag content"
+          },
+          {
+            "name": "as",
+            "type": "T",
+            "required": false,
+            "default": "'span'",
+            "description": "Render element: 'span' (default) keeps the static tag; 'a' renders a clickable tag link — href/target/rel and the rest of the anchor surface flow through, and the link shape resets the UA underline so the tag looks identical to the span form. Any component forwarding props to a DOM element (e.g. a router Link) works the same way. Don't combine an interactive `as` with `closable`: the remove button would nest inside a link (invalid HTML, SR/keyboard trap)."
+          },
+          {
+            "name": "ref",
+            "type": "Ref<T>",
+            "required": false,
+            "description": "Forwarded to the rendered root element (data-slot='tag'); with the default span it is a Ref<HTMLSpanElement>, with as='a' a Ref<HTMLAnchorElement>"
+          },
+          {
+            "name": "className",
+            "type": "string",
+            "required": false,
+            "description": "Additional CSS class"
           }
         ]
       }
@@ -8699,150 +11191,358 @@
             "description": "Maximum number of tags"
           },
           {
-            "name": "disabled",
+            "name": "disabled",
+            "type": "boolean",
+            "required": false,
+            "default": "false",
+            "description": "Disable the input"
+          },
+          {
+            "name": "className",
+            "type": "string",
+            "required": false,
+            "description": "Additional CSS class"
+          },
+          {
+            "name": "name",
+            "type": "string",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "id",
+            "type": "string",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "aria-invalid",
+            "type": "boolean",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "aria-describedby",
+            "type": "string",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "ref",
+            "type": "Ref<HTMLInputElement>",
+            "required": false,
+            "description": ""
+          }
+        ]
+      }
+    },
+    "Textarea": {
+      "cssFamily": "textarea",
+      "importStatement": "import { Textarea, TextareaCore } from 'haze-ui';\nimport 'haze-ui/css/tokens.css';\nimport 'haze-ui/css/textarea.css';",
+      "peerDeps": [],
+      "description": "Multiline text input.",
+      "props": {
+        "TextareaCoreProps": [
+          {
+            "name": "value",
+            "type": "string",
+            "required": true,
+            "description": ""
+          },
+          {
+            "name": "onChange",
+            "type": "(value: string) => void",
+            "required": true,
+            "description": ""
+          },
+          {
+            "name": "onNativeChange",
+            "type": "ChangeEventHandler<HTMLTextAreaElement, HTMLTextAreaElement> | undefined",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "size",
+            "type": "'sm' | 'md' | 'lg'",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "className",
+            "type": "string",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "ref",
+            "type": "Ref<HTMLTextAreaElement>",
+            "required": false,
+            "description": ""
+          }
+        ],
+        "TextareaProps": [
+          {
+            "name": "value",
+            "type": "ControlOrValue<string>",
+            "required": false,
+            "description": "Controlled value or control object"
+          },
+          {
+            "name": "size",
+            "type": "'sm' | 'md' | 'lg'",
+            "required": false,
+            "default": "'md'",
+            "description": "Size of the textarea"
+          },
+          {
+            "name": "ref",
+            "type": "Ref<HTMLTextAreaElement>",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "disabled",
+            "type": "boolean",
+            "required": false,
+            "default": "false",
+            "description": "Disable the textarea"
+          },
+          {
+            "name": "className",
+            "type": "string",
+            "required": false,
+            "description": "Additional CSS class"
+          },
+          {
+            "name": "...rest",
+            "type": "TextareaHTMLAttributes",
+            "required": false,
+            "description": "All native textarea attributes"
+          }
+        ]
+      }
+    },
+    "ThinkingIndicator": {
+      "cssFamily": "thinking-indicator",
+      "importStatement": "import { ThinkingIndicator } from 'haze-ui';\nimport 'haze-ui/css/tokens.css';\nimport 'haze-ui/css/thinking-indicator.css';",
+      "peerDeps": [],
+      "description": "Animated bouncing-dots indicator that the agent is processing.",
+      "props": {
+        "ThinkingIndicatorProps": [
+          {
+            "name": "text",
+            "type": "string",
+            "required": false,
+            "default": "'Thinking'",
+            "description": "Label text shown before the dots"
+          },
+          {
+            "name": "className",
+            "type": "string",
+            "required": false,
+            "description": "Additional CSS class"
+          }
+        ]
+      }
+    },
+    "TimeField": {
+      "cssFamily": "time-field",
+      "importStatement": "import { TimeField, TimeFieldCore } from 'haze-ui';\nimport 'haze-ui/css/tokens.css';\nimport 'haze-ui/css/time-field.css';",
+      "peerDeps": [],
+      "description": "",
+      "props": {
+        "TimeFieldCoreProps": [
+          {
+            "name": "value",
+            "type": "string",
+            "required": true,
+            "description": ""
+          },
+          {
+            "name": "onChange",
+            "type": "(value: string) => void",
+            "required": true,
+            "description": ""
+          },
+          {
+            "name": "format",
+            "type": "TimePickerFormat",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "use12Hours",
+            "type": "boolean",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "disabled",
+            "type": "boolean",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "placeholder",
+            "type": "TimePlaceholder",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "labels",
+            "type": "TimeLabels",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "className",
+            "type": "string",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "ref",
+            "type": "Ref<HTMLSpanElement>",
+            "required": false,
+            "description": ""
+          }
+        ],
+        "TimeFieldProps": [
+          {
+            "name": "value",
+            "type": "ControlOrValue<string>",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "onChange",
+            "type": "(value: string) => void",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "format",
+            "type": "TimePickerFormat",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "use12Hours",
             "type": "boolean",
             "required": false,
-            "default": "false",
-            "description": "Disable the input"
+            "description": ""
           },
           {
-            "name": "className",
-            "type": "string",
+            "name": "disabled",
+            "type": "boolean",
             "required": false,
-            "description": "Additional CSS class"
+            "description": ""
           },
           {
-            "name": "id",
-            "type": "string",
+            "name": "placeholder",
+            "type": "TimePlaceholder",
             "required": false,
             "description": ""
           },
           {
-            "name": "aria-invalid",
-            "type": "boolean",
+            "name": "labels",
+            "type": "TimeLabels",
             "required": false,
             "description": ""
           },
           {
-            "name": "aria-describedby",
+            "name": "className",
             "type": "string",
             "required": false,
             "description": ""
           },
           {
             "name": "ref",
-            "type": "Ref<HTMLInputElement>",
+            "type": "Ref<HTMLSpanElement>",
             "required": false,
             "description": ""
           }
         ]
       }
     },
-    "Textarea": {
-      "cssFamily": "textarea",
-      "importStatement": "import { Textarea, TextareaCore } from 'haze-ui';\nimport 'haze-ui/css/tokens.css';\nimport 'haze-ui/css/textarea.css';",
+    "TimeGrid": {
+      "cssFamily": "time-grid",
+      "importStatement": "import { TimeGrid } from 'haze-ui';\nimport 'haze-ui/css/tokens.css';\nimport 'haze-ui/css/time-grid.css';",
       "peerDeps": [],
-      "description": "Multiline text input.",
+      "description": "Single-select 'HH:mm' slot grid from a from/to window and minute step; radiogroup semantics with roving-tabindex arrow selection, controllable value, disabled slots.",
       "props": {
-        "TextareaCoreProps": [
+        "TimeGridProps": [
           {
             "name": "value",
-            "type": "string",
-            "required": true,
+            "type": "ControlOrValue<string>",
+            "required": false,
             "description": ""
           },
           {
             "name": "onChange",
             "type": "(value: string) => void",
-            "required": true,
-            "description": ""
-          },
-          {
-            "name": "onNativeChange",
-            "type": "ChangeEventHandler<HTMLTextAreaElement, HTMLTextAreaElement> | undefined",
             "required": false,
             "description": ""
           },
           {
-            "name": "size",
-            "type": "'sm' | 'md' | 'lg'",
+            "name": "from",
+            "type": "string",
             "required": false,
             "description": ""
           },
           {
-            "name": "className",
+            "name": "to",
             "type": "string",
             "required": false,
             "description": ""
           },
           {
-            "name": "ref",
-            "type": "Ref<HTMLTextAreaElement>",
+            "name": "step",
+            "type": "number",
             "required": false,
             "description": ""
-          }
-        ],
-        "TextareaProps": [
-          {
-            "name": "value",
-            "type": "ControlOrValue<string>",
-            "required": false,
-            "description": "Controlled value or control object"
           },
           {
-            "name": "size",
-            "type": "'sm' | 'md' | 'lg'",
+            "name": "disabledValues",
+            "type": "readonly string[]",
             "required": false,
-            "default": "'md'",
-            "description": "Size of the textarea"
+            "description": ""
           },
           {
-            "name": "ref",
-            "type": "Ref<HTMLTextAreaElement>",
+            "name": "columns",
+            "type": "number",
             "required": false,
             "description": ""
           },
           {
-            "name": "disabled",
-            "type": "boolean",
+            "name": "formatLabel",
+            "type": "(value: string) => string",
             "required": false,
-            "default": "false",
-            "description": "Disable the textarea"
+            "description": ""
           },
           {
-            "name": "className",
+            "name": "name",
             "type": "string",
             "required": false,
-            "description": "Additional CSS class"
+            "description": ""
           },
           {
-            "name": "...rest",
-            "type": "TextareaHTMLAttributes",
+            "name": "classNames",
+            "type": "TimeGridClassNames",
             "required": false,
-            "description": "All native textarea attributes"
-          }
-        ]
-      }
-    },
-    "ThinkingIndicator": {
-      "cssFamily": "thinking-indicator",
-      "importStatement": "import { ThinkingIndicator } from 'haze-ui';\nimport 'haze-ui/css/tokens.css';\nimport 'haze-ui/css/thinking-indicator.css';",
-      "peerDeps": [],
-      "description": "Animated bouncing-dots indicator that the agent is processing.",
-      "props": {
-        "ThinkingIndicatorProps": [
+            "description": ""
+          },
           {
-            "name": "text",
+            "name": "className",
             "type": "string",
             "required": false,
-            "default": "'Thinking'",
-            "description": "Label text shown before the dots"
+            "description": ""
           },
           {
-            "name": "className",
-            "type": "string",
+            "name": "ref",
+            "type": "Ref<HTMLButtonElement>",
             "required": false,
-            "description": "Additional CSS class"
+            "description": ""
           }
         ]
       }
@@ -9006,7 +11706,7 @@
           },
           {
             "name": "color",
-            "type": "'success' | 'warning' | 'danger' | 'default' | 'primary'",
+            "type": "'default' | 'primary' | 'success' | 'warning' | 'danger'",
             "required": false,
             "default": "'default'",
             "description": "Dot color"
@@ -9069,7 +11769,7 @@
         "ToastProps": [
           {
             "name": "variant",
-            "type": "'info' | 'success' | 'warning' | 'danger' | 'loading'",
+            "type": "'success' | 'warning' | 'danger' | 'info' | 'loading'",
             "required": false,
             "default": "'info'",
             "description": "Color variant; loading renders the spinner glyph (usually fired via toast.loading())"
@@ -9394,12 +12094,24 @@
             "required": false,
             "description": ""
           },
+          {
+            "name": "classNames",
+            "type": "TooltipClassNames",
+            "required": false,
+            "description": ""
+          },
           {
             "name": "className",
             "type": "string",
             "required": false,
             "description": "Additional CSS class"
           },
+          {
+            "name": "ref",
+            "type": "Ref<HTMLSpanElement>",
+            "required": false,
+            "description": ""
+          },
           {
             "name": "children",
             "type": "ReactNode",
@@ -9461,6 +12173,88 @@
         ]
       }
     },
+    "Trace": {
+      "cssFamily": "trace",
+      "importStatement": "import { Trace, TraceItem, TraceDetails } from 'haze-ui';\nimport 'haze-ui/css/tokens.css';\nimport 'haze-ui/css/trace.css';",
+      "peerDeps": [],
+      "description": "Line-by-line agent reasoning trace: `Trace` + `TraceItem` steps with pending/running/done/error status, custom icons, collapsible `details` and sr-only status announcements.",
+      "props": {
+        "TraceDetailsProps": [
+          {
+            "name": "children",
+            "type": "ReactNode",
+            "required": true,
+            "description": "Payload content — rendered as a monospace pre-wrap body"
+          },
+          {
+            "name": "className",
+            "type": "string",
+            "required": false,
+            "description": "Additional CSS class"
+          }
+        ],
+        "TraceItemProps": [
+          {
+            "name": "title",
+            "type": "ReactNode",
+            "required": true,
+            "description": "The step's headline — the line's visible text"
+          },
+          {
+            "name": "status",
+            "type": "TraceStatus",
+            "required": false,
+            "default": "'pending'",
+            "description": "Step status driving the marker color and the live-region announcements"
+          },
+          {
+            "name": "icon",
+            "type": "ComponentType",
+            "required": false,
+            "description": "Replaces the status glyph inside the marker (the marker keeps its status ring)"
+          },
+          {
+            "name": "details",
+            "type": "ReactNode",
+            "required": false,
+            "description": "Payload revealed by the line's disclosure toggle; omit for a plain line"
+          },
+          {
+            "name": "open",
+            "type": "ControlOrValue<boolean>",
+            "required": false,
+            "default": "false",
+            "description": "Controlled/uncontrolled expanded state of the details panel"
+          },
+          {
+            "name": "onOpenChange",
+            "type": "(open: boolean) => void",
+            "required": false,
+            "description": "Fires on every expand/collapse transition, whatever drove it"
+          },
+          {
+            "name": "className",
+            "type": "string",
+            "required": false,
+            "description": "Additional CSS class"
+          }
+        ],
+        "TraceProps": [
+          {
+            "name": "children",
+            "type": "ReactNode",
+            "required": true,
+            "description": "TraceItem steps composing the trace, one per line"
+          },
+          {
+            "name": "className",
+            "type": "string",
+            "required": false,
+            "description": "Additional CSS class"
+          }
+        ]
+      }
+    },
     "Transfer": {
       "cssFamily": "transfer",
       "importStatement": "import { Transfer, TransferCore } from 'haze-ui';\nimport 'haze-ui/css/tokens.css';\nimport 'haze-ui/css/transfer.css';",
@@ -9560,6 +12354,12 @@
             "required": false,
             "description": ""
           },
+          {
+            "name": "ref",
+            "type": "Ref<HTMLDivElement>",
+            "required": false,
+            "description": ""
+          },
           {
             "name": "className",
             "type": "string",
@@ -9834,6 +12634,12 @@
             "required": false,
             "description": "Controlled checked node keys"
           },
+          {
+            "name": "ref",
+            "type": "Ref<HTMLDivElement>",
+            "required": false,
+            "description": ""
+          },
           {
             "name": "className",
             "type": "string",
@@ -10180,12 +12986,24 @@
             "required": false,
             "description": ""
           },
+          {
+            "name": "paste",
+            "type": "boolean",
+            "required": false,
+            "description": ""
+          },
           {
             "name": "beforeUpload",
             "type": "(file: File) => boolean | Promise<boolean>",
             "required": false,
             "description": ""
           },
+          {
+            "name": "maxSize",
+            "type": "number",
+            "required": false,
+            "description": ""
+          },
           {
             "name": "maxCount",
             "type": "number",
@@ -10240,6 +13058,12 @@
             "required": false,
             "description": ""
           },
+          {
+            "name": "concurrency",
+            "type": "number",
+            "required": false,
+            "description": ""
+          },
           {
             "name": "showUploadList",
             "type": "boolean | { itemRender?: UploadListItemRender | undefined; }",
@@ -10276,6 +13100,12 @@
             "required": false,
             "description": ""
           },
+          {
+            "name": "classNames",
+            "type": "UploadClassNames",
+            "required": false,
+            "description": ""
+          },
           {
             "name": "className",
             "type": "string",
@@ -10343,6 +13173,18 @@
             "type": "(file: UploadValueItem) => void",
             "required": true,
             "description": ""
+          },
+          {
+            "name": "classNames",
+            "type": "Pick<UploadClassNames, 'progress' | 'list' | 'item'>",
+            "required": false,
+            "description": ""
+          },
+          {
+            "name": "ref",
+            "type": "Ref<HTMLUListElement>",
+            "required": false,
+            "description": ""
           }
         ],
         "UploadProps": [
@@ -10364,6 +13206,13 @@
             "required": false,
             "description": ""
           },
+          {
+            "name": "paste",
+            "type": "boolean",
+            "required": false,
+            "default": "false",
+            "description": "Paste-to-upload: focus the zone (role=button, in the tab order) and press Ctrl/Cmd+V — clipboard files run through the exact drop pipeline (accept, beforeUpload, maxSize, maxCount) and report like any pick; clipboard content without files passes through untouched. Works in droppable and click-only modes alike."
+          },
           {
             "name": "beforeUpload",
             "type": "(file: File) => boolean | Promise<boolean>",
@@ -10376,6 +13225,12 @@
             "required": false,
             "description": ""
           },
+          {
+            "name": "maxSize",
+            "type": "number",
+            "required": false,
+            "description": "Per-file size cap in bytes, applied after beforeUpload and before maxCount. An over-limit file still enters the list — as an error row carrying its size message (e.g. '2.50 MB exceeds the 1.00 MB limit') — but never uploads: auto mode, retry and the UploadHandle all refuse it, leaving remove as its only action. Rejected rows occupy maxCount slots like any entry. The cap gates intake only; a File arriving through value uploads normally. A non-positive or non-finite value disables the cap."
+          },
           {
             "name": "multiple",
             "type": "boolean",
@@ -10425,6 +13280,12 @@
             "required": false,
             "description": ""
           },
+          {
+            "name": "concurrency",
+            "type": "number",
+            "required": false,
+            "description": ""
+          },
           {
             "name": "showUploadList",
             "type": "boolean | { itemRender?: UploadListItemRender | undefined; }",
@@ -10469,6 +13330,12 @@
             "required": false,
             "description": "Fires with the freshly picked local Files only — the accumulated list (echo entries included) is the value channel"
           },
+          {
+            "name": "classNames",
+            "type": "UploadClassNames",
+            "required": false,
+            "description": ""
+          },
           {
             "name": "className",
             "type": "string",
@@ -11347,6 +14214,54 @@
       "type": "shadow",
       "light": "0 20px 25px rgba(0, 0, 0, 0.1)",
       "dark": "0 20px 25px rgba(0, 0, 0, 0.1)"
+    },
+    {
+      "name": "--haze-z-local-1",
+      "category": "z-index",
+      "label": "Z Local 1",
+      "type": "number",
+      "light": "1",
+      "dark": "1"
+    },
+    {
+      "name": "--haze-z-local-2",
+      "category": "z-index",
+      "label": "Z Local 2",
+      "type": "number",
+      "light": "2",
+      "dark": "2"
+    },
+    {
+      "name": "--haze-z-local-3",
+      "category": "z-index",
+      "label": "Z Local 3",
+      "type": "number",
+      "light": "3",
+      "dark": "3"
+    },
+    {
+      "name": "--haze-z-overlay",
+      "category": "z-index",
+      "label": "Z Overlay",
+      "type": "number",
+      "light": "100",
+      "dark": "100"
+    },
+    {
+      "name": "--haze-z-overlay-fallback",
+      "category": "z-index",
+      "label": "Z Overlay Fallback",
+      "type": "number",
+      "light": "1000",
+      "dark": "1000"
+    },
+    {
+      "name": "--haze-z-toast",
+      "category": "z-index",
+      "label": "Z Toast",
+      "type": "number",
+      "light": "9999",
+      "dark": "9999"
     }
   ]
 }