@tangible/ui 0.0.1 → 0.0.3

package/tui-manifest.json

@@ -1,6 +1,6 @@
 {
-  "version": "0.0.1",
-  "generated": "2026-01-31T03:28:47.490Z",
+  "version": "0.0.3",
+  "generated": "2026-02-24T00:56:13.287Z",
   "components": {
     "Accordion": {
       "props": {
@@ -128,7 +128,21 @@
           "description": "Additional CSS class"
         }
       },
-      "cssTokens": [],
+      "cssTokens": [
+        "--tui-avatar-size",
+        "--tui-avatar-radius",
+        "--tui-avatar-bg",
+        "--tui-avatar-fg",
+        "--tui-avatar-border",
+        "--tui-avatar-indicator-bg",
+        "--tui-avatar-indicator-fg",
+        "--tui-avatar-overflow-bg",
+        "--tui-avatar-overflow-fg",
+        "--tui-avatar-group-overlap",
+        "--tui-avatar-group-gap",
+        "--tui-avatar-group-border-width",
+        "--tui-avatar-group-border-color"
+      ],
       "story": {
         "title": "Primitives/Avatar",
         "tags": [
@@ -270,7 +284,10 @@
         "--tui-button-radius",
         "--tui-button-bg-interact",
         "--tui-button-fg-interact",
-        "--tui-button-border-interact"
+        "--tui-button-border-interact",
+        "--tui-control-height-sm",
+        "--tui-control-height-md",
+        "--tui-control-height-lg"
       ],
       "story": {
         "title": "Primitives/Button",
@@ -354,7 +371,8 @@
         },
         "onClick": {
           "type": "MouseEventHandler<HTMLElement>",
-          "required": false
+          "required": false,
+          "description": "@deprecated Use Card.Link for interactive cards. onClick without Card.Link has no keyboard/screen-reader semantics."
         },
         "title": {
           "type": "string",
@@ -434,6 +452,61 @@
         "Notice"
       ]
     },
+    "Checkbox": {
+      "props": {
+        "disabled": {
+          "type": "boolean",
+          "required": false
+        },
+        "size": {
+          "type": "number",
+          "required": false
+        },
+        "className": {
+          "type": "string",
+          "required": false
+        },
+        "id": {
+          "type": "string",
+          "required": false
+        },
+        "style": {
+          "type": "CSSProperties",
+          "required": false
+        },
+        "title": {
+          "type": "string",
+          "required": false
+        },
+        "rel": {
+          "type": "string",
+          "required": false
+        },
+        "onClick": {
+          "type": "MouseEventHandler<HTMLInputElement>",
+          "required": false
+        },
+        "label": {
+          "type": "ReactNode",
+          "required": false
+        }
+      },
+      "cssTokens": [
+        "--tui-input-accent"
+      ],
+      "story": {
+        "title": "Forms/Checkbox",
+        "tags": [
+          "autodocs",
+          "lms"
+        ]
+      },
+      "subcomponents": null,
+      "description": null,
+      "gotchas": null,
+      "examples": null,
+      "related": null
+    },
     "Chip": {
       "props": {
         "as": {
@@ -496,6 +569,11 @@
           "type": "MouseEventHandler<HTMLElement>",
           "required": false
         },
+        "value": {
+          "type": "OptionValue",
+          "required": false,
+          "description": "When inside ChipGroup, identifies this chip for selection tracking"
+        },
         "id": {
           "type": "string",
           "required": false
@@ -517,7 +595,13 @@
           "required": false
         }
       },
-      "cssTokens": [],
+      "cssTokens": [
+        "--tui-chip-bg",
+        "--tui-chip-fg",
+        "--tui-chip-border",
+        "--tui-chip-icon",
+        "--tui-chip-radius"
+      ],
       "story": {
         "title": "Primitives/Chip",
         "tags": [
@@ -531,6 +615,52 @@
       "examples": null,
       "related": null
     },
+    "ChipGroup": {
+      "props": {
+        "disabled": {
+          "type": "boolean",
+          "required": false
+        },
+        "density": {
+          "type": "\"xs\" | \"sm\" | \"md\"",
+          "required": false,
+          "description": "Gap between chips. Default 'sm'."
+        },
+        "direction": {
+          "type": "\"inline\" | \"stack\"",
+          "required": false,
+          "description": "Layout direction. Default 'inline' (row wrap)."
+        },
+        "alignment": {
+          "type": "\"start\" | \"center\" | \"end\"",
+          "required": false,
+          "description": "Alignment along main axis."
+        },
+        "className": {
+          "type": "string",
+          "required": false
+        },
+        "onValueChange": {
+          "type": "((value: OptionValue) => void) | ((value: OptionValue[]) => void)",
+          "required": false
+        }
+      },
+      "cssTokens": [
+        "--tui-chip-group-gap"
+      ],
+      "story": {
+        "title": "Primitives/ChipGroup",
+        "tags": [
+          "autodocs",
+          "stable"
+        ]
+      },
+      "subcomponents": null,
+      "description": null,
+      "gotchas": null,
+      "examples": null,
+      "related": null
+    },
     "Chips": {
       "props": {
         "density": {
@@ -563,6 +693,89 @@
       "examples": null,
       "related": null
     },
+    "Combobox": {
+      "props": {
+        "size": {
+          "type": "\"sm\" | \"md\" | \"lg\"",
+          "required": false,
+          "defaultValue": "'md'",
+          "description": "Control size."
+        },
+        "value": {
+          "type": "OptionValue",
+          "required": false,
+          "description": "Controlled selected value."
+        },
+        "onValueChange": {
+          "type": "(value: OptionValue) => void",
+          "required": false,
+          "description": "Callback when selection changes.\nCalled with the option's value when user selects, or undefined when cleared.\nDoes NOT mutate inputValue — consumer should update inputValue in handler if desired."
+        },
+        "inputValue": {
+          "type": "string",
+          "required": false,
+          "description": "Controlled input value for search/filter."
+        },
+        "filterMode": {
+          "type": "\"always\" | \"when-searching\"",
+          "required": false,
+          "defaultValue": "'always'",
+          "description": "Controls filtering behavior.\n- 'always': Filter on inputValue at all times (default)\n- 'when-searching': Query is empty when not actively typing,\n  so consumers can show all options when user is browsing a selection"
+        },
+        "open": {
+          "type": "boolean",
+          "required": false,
+          "description": "Controlled open state."
+        },
+        "defaultOpen": {
+          "type": "boolean",
+          "required": false,
+          "defaultValue": "false",
+          "description": "Default open state for uncontrolled usage."
+        },
+        "disabled": {
+          "type": "boolean",
+          "required": false,
+          "defaultValue": "false",
+          "description": "Whether the combobox is disabled."
+        },
+        "openOnFocus": {
+          "type": "boolean",
+          "required": false,
+          "defaultValue": "true",
+          "description": "Whether to open the listbox when the input receives focus."
+        },
+        "inputClassName": {
+          "type": "string",
+          "required": false,
+          "description": "Class name applied directly to the `<input>` element.\nUse for utilities like `tui-input-reset` that must target the input itself."
+        }
+      },
+      "cssTokens": [
+        "--tui-combobox-input-bg",
+        "--tui-combobox-input-fg",
+        "--tui-combobox-input-border",
+        "--tui-combobox-input-border-focus",
+        "--tui-combobox-input-radius",
+        "--tui-combobox-content-bg",
+        "--tui-combobox-content-border",
+        "--tui-combobox-content-shadow",
+        "--tui-combobox-content-radius",
+        "--tui-combobox-option-bg-hover",
+        "--tui-combobox-option-bg-selected"
+      ],
+      "story": {
+        "title": "Forms/Combobox",
+        "tags": [
+          "lms"
+        ]
+      },
+      "subcomponents": null,
+      "description": null,
+      "gotchas": null,
+      "examples": null,
+      "related": null
+    },
     "ContentIndicator": {
       "props": {
         "icon": {
@@ -599,7 +812,11 @@
           "description": "Additional CSS class names."
         }
       },
-      "cssTokens": [],
+      "cssTokens": [
+        "--tui-content-indicator-bg",
+        "--tui-content-indicator-border",
+        "--tui-content-indicator-fg"
+      ],
       "story": {
         "title": "Primitives/ContentIndicator",
         "tags": [
@@ -628,7 +845,17 @@
           "description": "Default open state for uncontrolled usage."
         }
       },
-      "cssTokens": [],
+      "cssTokens": [
+        "--tui-dropdown-bg",
+        "--tui-dropdown-fg",
+        "--tui-dropdown-radius",
+        "--tui-dropdown-shadow",
+        "--tui-dropdown-border",
+        "--tui-dropdown-z",
+        "--tui-dropdown-min-width",
+        "--tui-dropdown-item-bg-hover",
+        "--tui-dropdown-item-bg-active"
+      ],
       "story": {
         "title": "Primitives/Dropdown",
         "tags": [
@@ -642,6 +869,53 @@
       "examples": null,
       "related": null
     },
+    "Field": {
+      "props": {
+        "error": {
+          "type": "boolean",
+          "required": false,
+          "description": "Whether the field has an error state"
+        },
+        "required": {
+          "type": "boolean",
+          "required": false,
+          "description": "Whether the field is required"
+        },
+        "disabled": {
+          "type": "boolean",
+          "required": false,
+          "description": "Whether the field is disabled"
+        },
+        "inline": {
+          "type": "boolean",
+          "required": false,
+          "description": "Inline layout: label and control on same row"
+        },
+        "className": {
+          "type": "string",
+          "required": false,
+          "description": "Additional class name for the field wrapper"
+        }
+      },
+      "cssTokens": [
+        "--tui-field-gap",
+        "--tui-field-label-fg",
+        "--tui-field-helper-fg",
+        "--tui-field-error-fg"
+      ],
+      "story": {
+        "title": "Forms/Field",
+        "tags": [
+          "stable",
+          "lms"
+        ]
+      },
+      "subcomponents": null,
+      "description": null,
+      "gotchas": null,
+      "examples": null,
+      "related": null
+    },
     "Icon": {
       "props": {
         "name": {
@@ -669,7 +943,14 @@
           "required": false
         }
       },
-      "cssTokens": [],
+      "cssTokens": [
+        "--tui-icon-size-xs",
+        "--tui-icon-size-sm",
+        "--tui-icon-size-md",
+        "--tui-icon-size-lg",
+        "--tui-icon-size-xl",
+        "--tui-icon-size-xxl"
+      ],
       "story": {
         "title": "Primitives/Icon",
         "tags": [
@@ -782,7 +1063,14 @@
           "required": false
         }
       },
-      "cssTokens": [],
+      "cssTokens": [
+        "--tui-icon-button-bg",
+        "--tui-icon-button-fg",
+        "--tui-icon-button-border",
+        "--tui-icon-button-radius",
+        "--tui-icon-button-bg-interact",
+        "--tui-icon-button-fg-interact"
+      ],
       "story": {
         "title": "Primitives/IconButton",
         "tags": [
@@ -833,7 +1121,7 @@
       "description": "Accessible dialog with focus trap, backdrop, and portal rendering",
       "gotchas": [
         {
-          "note": "Always provide labelledBy pointing to a heading id for accessibility"
+          "note": "Always provide aria-labelledby pointing to a heading id for accessibility"
         },
         {
           "note": "Body uses two-layer wrapper for scroll + :has() composition"
@@ -851,89 +1139,239 @@
       "examples": [
         {
           "name": "Basic",
-          "code": "<Modal isOpen={open} onClose={close} labelledBy=\"modal-title\">\n  <Modal.Head><h2 id=\"modal-title\">Title</h2></Modal.Head>\n  <Modal.Body>Content</Modal.Body>\n  <Modal.Foot><Button label=\"Close\" onClick={close} /></Modal.Foot>\n</Modal>"
+          "code": "<Modal open={open} onClose={close} aria-labelledby=\"modal-title\">\n  <Modal.Head><h2 id=\"modal-title\">Title</h2></Modal.Head>\n  <Modal.Body>Content</Modal.Body>\n  <Modal.Foot><Button label=\"Close\" onClick={close} /></Modal.Foot>\n</Modal>"
         },
         {
           "name": "With close button",
-          "code": "<Modal isOpen={open} onClose={close} showCloseButton labelledBy=\"title\">\n  <Modal.Head><h2 id=\"title\">Confirm</h2></Modal.Head>\n  <Modal.Body>Are you sure?</Modal.Body>\n</Modal>"
+          "code": "<Modal open={open} onClose={close} showCloseButton aria-labelledby=\"title\">\n  <Modal.Head><h2 id=\"title\">Confirm</h2></Modal.Head>\n  <Modal.Body>Are you sure?</Modal.Body>\n</Modal>"
         }
       ],
       "related": [
         "Notice"
       ]
     },
-    "Notice": {
+    "MoveHandle": {
       "props": {
-        "inline": {
-          "type": "boolean",
+        "mode": {
+          "type": "\"full\" | \"handle\"",
           "required": false,
-          "description": "Inline layout: icon/title on left, content center, actions right"
+          "defaultValue": "full",
+          "description": "Structural mode. 'full' (default) shows background panel with arrows/index. 'handle' shows only the bare drag icon button."
         },
-        "elevated": {
-          "type": "boolean",
+        "size": {
+          "type": "\"sm\" | \"md\"",
           "required": false,
-          "description": "Add box shadow"
+          "defaultValue": "md",
+          "description": "Component scale. sm = 32px, md = 40px. Ignored when mode is 'handle'."
         },
-        "interactive": {
-          "type": "boolean",
+        "index": {
+          "type": "number",
           "required": false,
-          "description": "Enable hover/focus visual states. If combined with onClick,\nadds role=\"button\" and keyboard handling (Enter/Space)."
+          "description": "Position index. When provided, shows number at rest, drag handle on hover."
         },
-        "disabled": {
+        "locked": {
           "type": "boolean",
           "required": false,
-          "description": "Disable interactions"
+          "defaultValue": "false",
+          "description": "When true, shows lock icon and disables all interaction."
         },
-        "stripe": {
+        "canMoveUp": {
           "type": "boolean",
           "required": false,
-          "description": "Show left accent stripe in theme color"
-        },
-        "className": {
-          "type": "string",
-          "required": false
-        },
-        "style": {
-          "type": "CSSProperties",
-          "required": false
-        },
-        "as": {
-          "type": "\"section\" | \"div\"",
-          "required": false
-        },
-        "theme": {
-          "type": "\"info\" | \"success\" | \"warning\" | \"danger\"",
-          "required": false,
-          "description": "Visual intent"
-        },
-        "announce": {
-          "type": "\"off\" | \"assertive\" | \"polite\"",
-          "required": false,
-          "description": "Controls screen-reader announcement behavior.\n- off: no live region\n- polite: role=status\n- assertive: role=alert"
-        },
-        "ariaLabel": {
-          "type": "string",
-          "required": false,
-          "description": "Accessible name when there is no visible title in Notice.Head.\nOnly use when Notice.Head has no title prop - if both exist, the visible title takes precedence."
+          "defaultValue": "true",
+          "description": "When false, disables the move-up button without hiding it. Default: true."
         },
-        "dismissible": {
+        "canMoveDown": {
           "type": "boolean",
           "required": false,
-          "description": "Renders a dismiss button"
-        },
-        "onDismiss": {
-          "type": "() => void",
-          "required": false
+          "defaultValue": "true",
+          "description": "When false, disables the move-down button without hiding it. Default: true."
         },
-        "exitAnimation": {
-          "type": "\"none\" | \"collapse\" | \"fade\"",
+        "labels": {
+          "type": "MoveHandleLabels",
           "required": false,
-          "description": "Exit animation to play when dismissed.\n- none: onDismiss called immediately (default)\n- collapse: fade + height collapse (for inline/block notices)\n- fade: fade out with slight scale (for overlays/toasts)"
+          "description": "Override internal button labels for i18n."
         },
-        "focusable": {
-          "type": "boolean",
+        "dragHandleProps": {
+          "type": "HTMLAttributes<HTMLButtonElement>",
           "required": false,
-          "description": "If true, the notice container will be focusable (tabIndex=-1).\nUseful for programmatic focus management in toast/notification systems.\nNot for keyboard navigation - use interactive + onClick for clickable notices."
+          "description": "Props to spread on the drag handle button (e.g., from dnd-kit useSortable)."
+        },
+        "className": {
+          "type": "string",
+          "required": false
+        }
+      },
+      "cssTokens": [
+        "--tui-move-handle-size",
+        "--tui-move-handle-icon-size"
+      ],
+      "story": {
+        "title": "Components/MoveHandle",
+        "tags": [
+          "autodocs",
+          "lms"
+        ]
+      },
+      "subcomponents": null,
+      "description": null,
+      "gotchas": null,
+      "examples": null,
+      "related": null
+    },
+    "MultiSelect": {
+      "props": {
+        "size": {
+          "type": "\"sm\" | \"md\" | \"lg\"",
+          "required": false,
+          "defaultValue": "'md'",
+          "description": "Control size."
+        },
+        "value": {
+          "type": "MultiSelectValue",
+          "required": false,
+          "description": "Controlled selected values."
+        },
+        "onValueChange": {
+          "type": "(value: MultiSelectValue) => void",
+          "required": false,
+          "description": "Callback when selection changes."
+        },
+        "open": {
+          "type": "boolean",
+          "required": false,
+          "description": "Controlled open state."
+        },
+        "defaultOpen": {
+          "type": "boolean",
+          "required": false,
+          "defaultValue": "false",
+          "description": "Default open state for uncontrolled usage."
+        },
+        "disabled": {
+          "type": "boolean",
+          "required": false,
+          "defaultValue": "false",
+          "description": "Whether the entire select is disabled."
+        },
+        "display": {
+          "type": "\"count\" | \"chips\"",
+          "required": false,
+          "defaultValue": "'count'",
+          "description": "Display mode for the trigger.\n- 'count': Shows \"N selected\"\n- 'chips': Shows visual chips for selected items"
+        },
+        "maxChips": {
+          "type": "number",
+          "required": false,
+          "defaultValue": "3",
+          "description": "Maximum number of chips to show before \"+N more\" badge.\nOnly applies when display='chips'."
+        },
+        "max": {
+          "type": "number",
+          "required": false,
+          "description": "Maximum number of selections allowed.\nWhen reached, unselected options become disabled."
+        },
+        "id": {
+          "type": "string",
+          "required": false,
+          "description": "Optional trigger ID override.\nUseful for Field integration via htmlFor."
+        }
+      },
+      "cssTokens": [
+        "--tui-multiselect-trigger-bg",
+        "--tui-multiselect-trigger-fg",
+        "--tui-multiselect-trigger-border",
+        "--tui-multiselect-trigger-border-focus",
+        "--tui-multiselect-trigger-radius",
+        "--tui-multiselect-content-bg",
+        "--tui-multiselect-content-border",
+        "--tui-multiselect-content-shadow",
+        "--tui-multiselect-content-radius",
+        "--tui-multiselect-option-bg-hover",
+        "--tui-multiselect-option-bg-selected",
+        "--tui-multiselect-chip-bg",
+        "--tui-multiselect-chip-fg"
+      ],
+      "story": {
+        "title": "Forms/MultiSelect",
+        "tags": [
+          "autodocs",
+          "lms"
+        ]
+      },
+      "subcomponents": null,
+      "description": null,
+      "gotchas": null,
+      "examples": null,
+      "related": null
+    },
+    "Notice": {
+      "props": {
+        "inline": {
+          "type": "boolean",
+          "required": false,
+          "description": "Inline layout: icon/title on left, content center, actions right"
+        },
+        "elevated": {
+          "type": "boolean",
+          "required": false,
+          "description": "Add box shadow"
+        },
+        "interactive": {
+          "type": "boolean",
+          "required": false,
+          "description": "Enable hover/focus visual states. If combined with onClick,\nadds role=\"button\" and keyboard handling (Enter/Space)."
+        },
+        "disabled": {
+          "type": "boolean",
+          "required": false,
+          "description": "Disable interactions"
+        },
+        "stripe": {
+          "type": "boolean",
+          "required": false,
+          "description": "Show left accent stripe in theme color"
+        },
+        "className": {
+          "type": "string",
+          "required": false
+        },
+        "style": {
+          "type": "CSSProperties",
+          "required": false
+        },
+        "as": {
+          "type": "\"section\" | \"div\"",
+          "required": false
+        },
+        "theme": {
+          "type": "\"info\" | \"success\" | \"warning\" | \"danger\"",
+          "required": false,
+          "description": "Visual intent"
+        },
+        "announce": {
+          "type": "\"off\" | \"assertive\" | \"polite\"",
+          "required": false,
+          "description": "Controls screen-reader announcement behavior.\n- off: no live region\n- polite: role=status\n- assertive: role=alert"
+        },
+        "dismissible": {
+          "type": "boolean",
+          "required": false,
+          "description": "Renders a dismiss button"
+        },
+        "onDismiss": {
+          "type": "() => void",
+          "required": false
+        },
+        "exitAnimation": {
+          "type": "\"none\" | \"collapse\" | \"fade\"",
+          "required": false,
+          "description": "Exit animation to play when dismissed.\n- none: onDismiss called immediately (default)\n- collapse: fade + height collapse (for inline/block notices)\n- fade: fade out with slight scale (for overlays/toasts)"
+        },
+        "focusable": {
+          "type": "boolean",
+          "required": false,
+          "description": "If true, the notice container will be focusable (tabIndex=-1).\nUseful for programmatic focus management in toast/notification systems.\nNot for keyboard navigation - use interactive + onClick for clickable notices."
         },
         "onClick": {
           "type": "MouseEventHandler<HTMLElement>",
@@ -1062,7 +1500,14 @@
           "description": "Inline styles"
         }
       },
-      "cssTokens": [],
+      "cssTokens": [
+        "--tui-overlap-stack-overlap",
+        "--tui-overlap-stack-overflow-bg",
+        "--tui-overlap-stack-overflow-fg",
+        "--tui-overlap-stack-item-radius",
+        "--tui-overlap-stack-border-width",
+        "--tui-overlap-stack-border-color"
+      ],
       "story": {
         "title": "Components/OverlapStack",
         "tags": [
@@ -1122,7 +1567,9 @@
           "description": "Additional class name"
         }
       },
-      "cssTokens": [],
+      "cssTokens": [
+        "--tui-pager-gap"
+      ],
       "story": {
         "title": "Primitives/Pager",
         "tags": [
@@ -1161,20 +1608,10 @@
           "defaultValue": "true",
           "description": "Whether to display labels.\nWhen false, hides all label content regardless of other props."
         },
-        "labelledBy": {
-          "type": "string",
-          "required": false,
-          "description": "ARIA: ID of an element that labels this progress bar.\nTakes precedence over `ariaLabel` and `defaultLabel`."
-        },
-        "ariaLabel": {
-          "type": "string",
-          "required": false,
-          "description": "ARIA: Accessible name for the progress bar.\nUse when no visible label exists. Takes precedence over `defaultLabel`."
-        },
         "defaultLabel": {
           "type": "string",
           "required": false,
-          "description": "Fallback accessible name, rendered as visually-hidden text.\nOnly used if neither `labelledBy` nor `ariaLabel` is provided."
+          "description": "Fallback accessible name, rendered as visually-hidden text.\nOnly used if neither `aria-labelledby` nor `aria-label` is provided."
         },
         "className": {
           "type": "string",
@@ -1227,7 +1664,17 @@
           "description": "Visual variant for circle mode.\n- `'ring'`: Hollow centre (default) — shows progress as a ring/donut\n- `'solid'`: Filled centre — shows as a solid filled circle\n\nOnly applies when `mode=\"circle\"`. Ignored in line mode."
         }
       },
-      "cssTokens": [],
+      "cssTokens": [
+        "--tui-progress-track",
+        "--tui-progress-fill",
+        "--tui-progress-label",
+        "--tui-progress-radius",
+        "--tui-progress-z1-fill",
+        "--tui-progress-z2-fill",
+        "--tui-progress-z3-fill",
+        "--tui-progress-z4-fill",
+        "--tui-progress-z5-fill"
+      ],
       "story": {
         "title": "Primitives/Progress",
         "tags": [
@@ -1241,12 +1688,44 @@
       "examples": null,
       "related": null
     },
+    "Radio": {
+      "props": {
+        "label": {
+          "type": "ReactNode",
+          "required": false
+        },
+        "disabled": {
+          "type": "boolean",
+          "required": false,
+          "defaultValue": "false"
+        },
+        "className": {
+          "type": "string",
+          "required": false
+        }
+      },
+      "cssTokens": [
+        "--tui-radio-accent"
+      ],
+      "story": {
+        "title": "Forms/RadioGroup",
+        "tags": [
+          "autodocs",
+          "lms"
+        ]
+      },
+      "subcomponents": null,
+      "description": null,
+      "gotchas": null,
+      "examples": null,
+      "related": null
+    },
     "Rating": {
       "props": {
         "value": {
           "type": "number",
           "required": false,
-          "description": "Controlled value (1..max). Use with onChange"
+          "description": "Controlled value (1..max). Use with onValueChange"
         },
         "max": {
           "type": "number",
@@ -1281,10 +1760,10 @@
           "defaultValue": "secondary",
           "description": "Theme feeds foreground color tokens"
         },
-        "onChange": {
+        "onValueChange": {
           "type": "(value: number) => void",
           "required": false,
-          "description": "Called on change (controlled or uncontrolled)"
+          "description": "Called when the value changes"
         },
         "allowClear": {
           "type": "boolean",
@@ -1299,14 +1778,13 @@
           "type": "string",
           "required": false,
           "description": "Gap override (e.g. '0.25rem') – otherwise uses density utilities"
-        },
-        "ariaLabel": {
-          "type": "string",
-          "required": false,
-          "description": "Accessible label for the rating group. Defaults to \"Rating: X of Y\""
         }
       },
-      "cssTokens": [],
+      "cssTokens": [
+        "--tui-rating-active",
+        "--tui-rating-inactive",
+        "--tui-rating-scale"
+      ],
       "story": {
         "title": "Primitives/Rating",
         "tags": [
@@ -1363,7 +1841,18 @@
           "description": "Additional classes"
         }
       },
-      "cssTokens": [],
+      "cssTokens": [
+        "--tui-segmented-gap",
+        "--tui-segmented-padding",
+        "--tui-segmented-radius",
+        "--tui-segmented-bg",
+        "--tui-segmented-border",
+        "--tui-segmented-item-padding",
+        "--tui-segmented-item-radius",
+        "--tui-segmented-item-fg",
+        "--tui-segmented-item-bg-active",
+        "--tui-segmented-item-fg-active"
+      ],
       "story": {
         "title": "Components/SegmentedControl",
         "tags": [
@@ -1377,6 +1866,97 @@
       "examples": null,
       "related": null
     },
+    "Select": {
+      "props": {
+        "size": {
+          "type": "\"sm\" | \"md\" | \"lg\"",
+          "required": false,
+          "defaultValue": "'md'",
+          "description": "Control size."
+        },
+        "value": {
+          "type": "OptionValue",
+          "required": false,
+          "description": "Controlled selected value."
+        },
+        "onValueChange": {
+          "type": "(value: OptionValue) => void",
+          "required": false,
+          "description": "Callback when selection changes.\nCalled with undefined when selection is cleared."
+        },
+        "open": {
+          "type": "boolean",
+          "required": false,
+          "description": "Controlled open state."
+        },
+        "defaultOpen": {
+          "type": "boolean",
+          "required": false,
+          "defaultValue": "false",
+          "description": "Default open state for uncontrolled usage."
+        },
+        "disabled": {
+          "type": "boolean",
+          "required": false,
+          "defaultValue": "false",
+          "description": "Whether the entire select is disabled."
+        },
+        "side": {
+          "type": "\"top\" | \"bottom\"",
+          "required": false,
+          "defaultValue": "'bottom'",
+          "description": "Preferred side of the trigger to place the listbox."
+        },
+        "align": {
+          "type": "\"start\" | \"center\" | \"end\"",
+          "required": false,
+          "defaultValue": "'start'",
+          "description": "Alignment along the side."
+        },
+        "sideOffset": {
+          "type": "number",
+          "required": false,
+          "defaultValue": "4",
+          "description": "Distance from the trigger in pixels."
+        },
+        "clearable": {
+          "type": "boolean",
+          "required": false,
+          "defaultValue": "false",
+          "description": "Whether the selection can be cleared with a clear button."
+        },
+        "id": {
+          "type": "string",
+          "required": false,
+          "description": "Optional trigger ID override.\nUseful for Field integration via htmlFor."
+        }
+      },
+      "cssTokens": [
+        "--tui-select-trigger-bg",
+        "--tui-select-trigger-fg",
+        "--tui-select-trigger-border",
+        "--tui-select-trigger-border-focus",
+        "--tui-select-trigger-radius",
+        "--tui-select-content-bg",
+        "--tui-select-content-border",
+        "--tui-select-content-shadow",
+        "--tui-select-content-radius",
+        "--tui-select-option-bg-hover",
+        "--tui-select-option-bg-selected"
+      ],
+      "story": {
+        "title": "Forms/Select",
+        "tags": [
+          "autodocs",
+          "lms"
+        ]
+      },
+      "subcomponents": null,
+      "description": null,
+      "gotchas": null,
+      "examples": null,
+      "related": null
+    },
     "Sidebar": {
       "props": {
         "position": {
@@ -1391,7 +1971,7 @@
           "defaultValue": "false",
           "description": "Enable drawer mode (mobile overlay).\nWhen true, sidebar renders via portal with backdrop and focus trap."
         },
-        "isOpen": {
+        "open": {
           "type": "boolean",
           "required": false,
           "description": "Drawer open state. Required when `drawer={true}`."
@@ -1401,11 +1981,6 @@
           "required": false,
           "description": "Callback to close the drawer.\nCalled when ESC is pressed or backdrop is clicked."
         },
-        "ariaLabel": {
-          "type": "string",
-          "required": false,
-          "description": "Accessible label for the aside landmark.\nTypically omit this if using `ariaLabel` on `Sidebar.Nav` instead."
-        },
         "children": {
           "type": "ReactNode",
           "required": true,
@@ -1417,7 +1992,13 @@
           "description": "Additional CSS class names."
         }
       },
-      "cssTokens": [],
+      "cssTokens": [
+        "--tui-sidebar-width",
+        "--tui-sidebar-bg",
+        "--tui-sidebar-border",
+        "--tui-sidebar-padding",
+        "--tui-sidebar-z"
+      ],
       "story": {
         "title": "Components/Sidebar",
         "tags": [
@@ -1490,16 +2071,6 @@
     },
     "StepList": {
       "props": {
-        "ariaLabel": {
-          "type": "string",
-          "required": false,
-          "description": "Accessible label for the navigation landmark.\nUse either `ariaLabel` or `ariaLabelledBy`, not both."
-        },
-        "ariaLabelledBy": {
-          "type": "string",
-          "required": false,
-          "description": "ID of a visible heading that labels the navigation.\nUse either `ariaLabel` or `ariaLabelledBy`, not both."
-        },
         "ariaCurrent": {
           "type": "\"step\" | \"page\"",
           "required": false,
@@ -1522,7 +2093,14 @@
           "description": "Additional CSS class names."
         }
       },
-      "cssTokens": [],
+      "cssTokens": [
+        "--tui-steplist-gap",
+        "--tui-steplist-padding",
+        "--tui-steplist-radius",
+        "--tui-steplist-current-bg",
+        "--tui-steplist-current-border",
+        "--tui-steplist-hover-bg"
+      ],
       "story": {
         "title": "Components/StepList",
         "tags": [
@@ -1537,6 +2115,63 @@
       "examples": null,
       "related": null
     },
+    "Switch": {
+      "props": {
+        "disabled": {
+          "type": "boolean",
+          "required": false
+        },
+        "className": {
+          "type": "string",
+          "required": false
+        },
+        "id": {
+          "type": "string",
+          "required": false
+        },
+        "style": {
+          "type": "CSSProperties",
+          "required": false
+        },
+        "title": {
+          "type": "string",
+          "required": false
+        },
+        "rel": {
+          "type": "string",
+          "required": false
+        },
+        "onClick": {
+          "type": "MouseEventHandler<HTMLButtonElement>",
+          "required": false
+        },
+        "size": {
+          "type": "\"sm\" | \"md\" | \"lg\"",
+          "required": false,
+          "defaultValue": "md"
+        },
+        "label": {
+          "type": "ReactNode",
+          "required": false
+        }
+      },
+      "cssTokens": [
+        "--tui-switch-accent",
+        "--tui-switch-track-off"
+      ],
+      "story": {
+        "title": "Forms/Switch",
+        "tags": [
+          "autodocs",
+          "lms"
+        ]
+      },
+      "subcomponents": null,
+      "description": null,
+      "gotchas": null,
+      "examples": null,
+      "related": null
+    },
     "Tabs": {
       "props": {
         "variant": {
@@ -1634,6 +2269,158 @@
         "SegmentedControl"
       ]
     },
+    "Textarea": {
+      "props": {
+        "disabled": {
+          "type": "boolean",
+          "required": false
+        },
+        "onChange": {
+          "type": "ChangeEventHandler<HTMLTextAreaElement>",
+          "required": false
+        },
+        "className": {
+          "type": "string",
+          "required": false,
+          "description": "Class name applied to the textarea element."
+        },
+        "id": {
+          "type": "string",
+          "required": false
+        },
+        "style": {
+          "type": "CSSProperties",
+          "required": false
+        },
+        "title": {
+          "type": "string",
+          "required": false
+        },
+        "role": {
+          "type": "AriaRole",
+          "required": false
+        },
+        "rel": {
+          "type": "string",
+          "required": false
+        },
+        "onClick": {
+          "type": "MouseEventHandler<HTMLTextAreaElement>",
+          "required": false
+        },
+        "size": {
+          "type": "\"sm\" | \"md\" | \"lg\"",
+          "required": false,
+          "defaultValue": "md",
+          "description": "Control size."
+        },
+        "resize": {
+          "type": "\"none\" | \"vertical\" | \"horizontal\" | \"both\"",
+          "required": false,
+          "defaultValue": "vertical",
+          "description": "Resize behaviour.\nIgnored when `autoResize` is true (resize is disabled to avoid conflict)."
+        },
+        "autoResize": {
+          "type": "boolean",
+          "required": false,
+          "defaultValue": "false",
+          "description": "Automatically grow height to fit content.\nDisables manual resize and scrollbar."
+        }
+      },
+      "cssTokens": [],
+      "story": {
+        "title": "Forms/Textarea",
+        "tags": [
+          "autodocs",
+          "stable",
+          "lms"
+        ]
+      },
+      "subcomponents": null,
+      "description": null,
+      "gotchas": null,
+      "examples": null,
+      "related": null
+    },
+    "TextInput": {
+      "props": {
+        "disabled": {
+          "type": "boolean",
+          "required": false
+        },
+        "onChange": {
+          "type": "ChangeEventHandler<HTMLInputElement>",
+          "required": false
+        },
+        "className": {
+          "type": "string",
+          "required": false,
+          "description": "Additional class name applied to the root wrapper element."
+        },
+        "id": {
+          "type": "string",
+          "required": false
+        },
+        "style": {
+          "type": "CSSProperties",
+          "required": false
+        },
+        "title": {
+          "type": "string",
+          "required": false
+        },
+        "role": {
+          "type": "AriaRole",
+          "required": false
+        },
+        "rel": {
+          "type": "string",
+          "required": false
+        },
+        "onClick": {
+          "type": "MouseEventHandler<HTMLInputElement>",
+          "required": false
+        },
+        "type": {
+          "type": "\"number\" | \"text\" | \"email\" | \"password\" | \"url\" | \"tel\" | \"search\"",
+          "required": false,
+          "defaultValue": "text",
+          "description": "Input type."
+        },
+        "size": {
+          "type": "\"sm\" | \"md\" | \"lg\"",
+          "required": false,
+          "defaultValue": "md",
+          "description": "Control size."
+        },
+        "suffix": {
+          "type": "ReactNode",
+          "required": false,
+          "description": "Content to render after the input (icon, button)."
+        },
+        "inputClassName": {
+          "type": "string",
+          "required": false,
+          "description": "Class name applied directly to the `<input>` element.\nUse for utilities like `tui-input-reset` that must target the input itself."
+        }
+      },
+      "cssTokens": [
+        "--tui-input-group-gap"
+      ],
+      "story": {
+        "title": "Forms/TextInput",
+        "tags": [
+          "autodocs",
+          "stable",
+          "lms"
+        ]
+      },
+      "subcomponents": null,
+      "description": null,
+      "gotchas": null,
+      "examples": null,
+      "related": null
+    },
     "Toolbar": {
       "props": {
         "orientation": {
@@ -1656,7 +2443,10 @@
           "description": "Inline styles for layout integration"
         }
       },
-      "cssTokens": [],
+      "cssTokens": [
+        "--tui-toolbar-gap",
+        "--tui-toolbar-padding"
+      ],
       "story": {
         "title": "Components/Toolbar",
         "tags": [
@@ -1689,7 +2479,12 @@
           "description": "Override provider's delay for this tooltip."
         }
       },
-      "cssTokens": [],
+      "cssTokens": [
+        "--tui-tooltip-bg",
+        "--tui-tooltip-fg",
+        "--tui-tooltip-radius",
+        "--tui-tooltip-z"
+      ],
       "story": {
         "title": "Primitives/Tooltip",
         "tags": [
@@ -1850,9 +2645,9 @@
       "lms": 7,
       "player": 24,
       "reaction": 36,
-      "system": 74
+      "system": 76
     },
-    "total": 153,
+    "total": 155,
     "manifest": "./icons/manifest.json"
   }
 }