wimui 0.70.0 → 0.72.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (271) hide show
  1. package/dist/components/_internal/useAnnounce.cjs +1 -1
  2. package/dist/components/_internal/useAnnounce.d.ts +22 -0
  3. package/dist/components/_internal/useAnnounce.js +36 -19
  4. package/dist/components/ai/CodeDiffViewer/CodeDiffViewer.cjs +2 -2
  5. package/dist/components/ai/CodeDiffViewer/CodeDiffViewer.js +106 -105
  6. package/dist/components/ai/StreamingText/StreamingText.cjs +1 -1
  7. package/dist/components/ai/StreamingText/StreamingText.d.ts +1 -1
  8. package/dist/components/ai/StreamingText/StreamingText.js +37 -23
  9. package/dist/components/data-display/DataGrid/DataGrid.cjs +1 -1
  10. package/dist/components/data-display/DataGrid/DataGrid.js +41 -40
  11. package/dist/components/data-display/InfiniteScroll/InfiniteScroll.cjs +1 -1
  12. package/dist/components/data-display/InfiniteScroll/InfiniteScroll.d.ts +1 -1
  13. package/dist/components/data-display/InfiniteScroll/InfiniteScroll.js +37 -26
  14. package/dist/components/data-display/List/List.cjs +1 -1
  15. package/dist/components/data-display/List/List.d.ts +5 -1
  16. package/dist/components/data-display/List/List.js +3 -3
  17. package/dist/components/feedback/Spinner/Spinner.cjs +1 -1
  18. package/dist/components/feedback/Spinner/Spinner.js +53 -43
  19. package/dist/components/form/Combobox/Combobox.cjs +1 -1
  20. package/dist/components/form/Combobox/Combobox.js +48 -47
  21. package/dist/components/form/Transfer/Transfer.cjs +1 -1
  22. package/dist/components/form/Transfer/Transfer.js +0 -1
  23. package/dist/components/media/Gallery/Gallery.cjs +1 -1
  24. package/dist/components/media/Gallery/Gallery.js +111 -110
  25. package/dist/components/media/Lightbox/Lightbox.cjs +1 -1
  26. package/dist/components/media/Lightbox/Lightbox.d.ts +2 -1
  27. package/dist/components/media/Lightbox/Lightbox.js +3 -3
  28. package/dist/hooks/useBreakpoint.d.ts +1 -0
  29. package/dist/i18n/generated/data-display.cjs +1 -1
  30. package/dist/i18n/generated/data-display.d.ts +1 -1
  31. package/dist/i18n/generated/data-display.js +6 -3
  32. package/dist/index.cjs +1 -1
  33. package/dist/index.js +18 -18
  34. package/dist/llms/AIResponseFeedback.md +26 -0
  35. package/dist/llms/Accordion.md +47 -0
  36. package/dist/llms/Affix.md +25 -0
  37. package/dist/llms/AgentStatus.md +25 -0
  38. package/dist/llms/Alert.md +28 -0
  39. package/dist/llms/Anchor.md +30 -0
  40. package/dist/llms/AppShell.md +52 -0
  41. package/dist/llms/AreaChart.md +27 -0
  42. package/dist/llms/ArtifactsOverlay.md +27 -0
  43. package/dist/llms/AspectRatio.md +22 -0
  44. package/dist/llms/Audio.md +44 -0
  45. package/dist/llms/Autosave.md +23 -0
  46. package/dist/llms/Avatar.md +27 -0
  47. package/dist/llms/AvatarGroup.md +28 -0
  48. package/dist/llms/BackTop.md +32 -0
  49. package/dist/llms/Badge.md +28 -0
  50. package/dist/llms/Banner.md +28 -0
  51. package/dist/llms/BarChart.md +26 -0
  52. package/dist/llms/Barcode.md +26 -0
  53. package/dist/llms/BentoGrid.md +25 -0
  54. package/dist/llms/Blockquote.md +26 -0
  55. package/dist/llms/BottomSheet.md +26 -0
  56. package/dist/llms/Box.md +44 -0
  57. package/dist/llms/BoxPlot.md +25 -0
  58. package/dist/llms/Breadcrumb.md +31 -0
  59. package/dist/llms/Button.md +33 -0
  60. package/dist/llms/ButtonGroup.md +27 -0
  61. package/dist/llms/Calendar.md +34 -0
  62. package/dist/llms/CalendarHeatmap.md +33 -0
  63. package/dist/llms/CandlestickChart.md +25 -0
  64. package/dist/llms/Canvas.md +13 -0
  65. package/dist/llms/Card.md +41 -0
  66. package/dist/llms/Carousel.md +33 -0
  67. package/dist/llms/Cascader.md +40 -0
  68. package/dist/llms/Center.md +40 -0
  69. package/dist/llms/Charts.md +13 -0
  70. package/dist/llms/ChatUI.md +17 -0
  71. package/dist/llms/Checkbox.md +24 -0
  72. package/dist/llms/CheckboxGroup.md +32 -0
  73. package/dist/llms/Chip.md +36 -0
  74. package/dist/llms/Code.md +25 -0
  75. package/dist/llms/CodeBlock.md +27 -0
  76. package/dist/llms/CodeDiffViewer.md +30 -0
  77. package/dist/llms/ColorInput.md +48 -0
  78. package/dist/llms/ColorPicker.md +46 -0
  79. package/dist/llms/Combobox.md +37 -0
  80. package/dist/llms/CommandPalette.md +25 -0
  81. package/dist/llms/Comment.md +35 -0
  82. package/dist/llms/Container.md +45 -0
  83. package/dist/llms/ContextMenu.md +25 -0
  84. package/dist/llms/ContrastChecker.md +13 -0
  85. package/dist/llms/Controls.md +13 -0
  86. package/dist/llms/CopyButton.md +26 -0
  87. package/dist/llms/Countdown.md +31 -0
  88. package/dist/llms/CounterTextarea.md +32 -0
  89. package/dist/llms/CreditCardInput.md +42 -0
  90. package/dist/llms/Dashboard.md +31 -0
  91. package/dist/llms/DataGrid.md +43 -0
  92. package/dist/llms/DatePicker.md +39 -0
  93. package/dist/llms/DateRangePicker.md +30 -0
  94. package/dist/llms/DescriptionList.md +26 -0
  95. package/dist/llms/Dialog.md +57 -0
  96. package/dist/llms/Divider.md +24 -0
  97. package/dist/llms/Drawer.md +29 -0
  98. package/dist/llms/Dropdown.md +50 -0
  99. package/dist/llms/Dropzone.md +36 -0
  100. package/dist/llms/EmptyState.md +23 -0
  101. package/dist/llms/ErrorBoundary.md +25 -0
  102. package/dist/llms/FAQSection.md +24 -0
  103. package/dist/llms/FieldError.md +19 -0
  104. package/dist/llms/FieldTemplate.md +30 -0
  105. package/dist/llms/Fieldset.md +24 -0
  106. package/dist/llms/FileUpload.md +40 -0
  107. package/dist/llms/Flex.md +23 -0
  108. package/dist/llms/FloatButton.md +36 -0
  109. package/dist/llms/FocusTrap.md +20 -0
  110. package/dist/llms/Footer.md +32 -0
  111. package/dist/llms/FunnelChart.md +24 -0
  112. package/dist/llms/Gallery.md +30 -0
  113. package/dist/llms/GanttChart.md +29 -0
  114. package/dist/llms/GaugeChart.md +30 -0
  115. package/dist/llms/Grid.md +30 -0
  116. package/dist/llms/Group.md +22 -0
  117. package/dist/llms/HamburgerMenu.md +30 -0
  118. package/dist/llms/Header.md +30 -0
  119. package/dist/llms/Heatmap.md +25 -0
  120. package/dist/llms/Highlight.md +26 -0
  121. package/dist/llms/HoverCard.md +26 -0
  122. package/dist/llms/Icon.md +25 -0
  123. package/dist/llms/IconButton.md +30 -0
  124. package/dist/llms/Image.md +46 -0
  125. package/dist/llms/ImageCompare.md +35 -0
  126. package/dist/llms/ImageCropper.md +34 -0
  127. package/dist/llms/Indicator.md +28 -0
  128. package/dist/llms/InfiniteScroll.md +28 -0
  129. package/dist/llms/InlineEdit.md +32 -0
  130. package/dist/llms/Input.md +46 -0
  131. package/dist/llms/InputBase.md +39 -0
  132. package/dist/llms/InputGroup.md +23 -0
  133. package/dist/llms/InputMask.md +44 -0
  134. package/dist/llms/InteractiveArea.md +32 -0
  135. package/dist/llms/InteractiveGraph.md +28 -0
  136. package/dist/llms/JsonDiffViewer.md +24 -0
  137. package/dist/llms/JsonViewer.md +26 -0
  138. package/dist/llms/Kanban.md +25 -0
  139. package/dist/llms/Kbd.md +23 -0
  140. package/dist/llms/KeyboardShortcuts.md +25 -0
  141. package/dist/llms/Label.md +27 -0
  142. package/dist/llms/Leaderboard.md +24 -0
  143. package/dist/llms/Legend.md +27 -0
  144. package/dist/llms/Lightbox.md +47 -0
  145. package/dist/llms/LineChart.md +26 -0
  146. package/dist/llms/Link.md +28 -0
  147. package/dist/llms/LinkButton.md +23 -0
  148. package/dist/llms/List.md +35 -0
  149. package/dist/llms/Loader.md +23 -0
  150. package/dist/llms/LoadingOverlay.md +30 -0
  151. package/dist/llms/Markdown.md +24 -0
  152. package/dist/llms/MarkdownRenderer.md +24 -0
  153. package/dist/llms/Marquee.md +27 -0
  154. package/dist/llms/Masonry.md +18 -0
  155. package/dist/llms/Mentions.md +24 -0
  156. package/dist/llms/Menu.md +30 -0
  157. package/dist/llms/Menubar.md +50 -0
  158. package/dist/llms/Meta.md +13 -0
  159. package/dist/llms/ModelSelector.md +31 -0
  160. package/dist/llms/MultiSelect.md +38 -0
  161. package/dist/llms/Navbar.md +58 -0
  162. package/dist/llms/NodeGraph.md +38 -0
  163. package/dist/llms/Notification.md +30 -0
  164. package/dist/llms/NumberInput.md +23 -0
  165. package/dist/llms/OtpInput.md +33 -0
  166. package/dist/llms/OverflowList.md +31 -0
  167. package/dist/llms/Pagination.md +39 -0
  168. package/dist/llms/PasswordInput.md +39 -0
  169. package/dist/llms/PasswordStrength.md +34 -0
  170. package/dist/llms/PhoneInput.md +35 -0
  171. package/dist/llms/PieChart.md +23 -0
  172. package/dist/llms/PivotTable.md +41 -0
  173. package/dist/llms/PlatformIcons.md +13 -0
  174. package/dist/llms/Popconfirm.md +30 -0
  175. package/dist/llms/Popover.md +27 -0
  176. package/dist/llms/Portal.md +18 -0
  177. package/dist/llms/Presence.md +26 -0
  178. package/dist/llms/Progress.md +29 -0
  179. package/dist/llms/ProgressRing.md +27 -0
  180. package/dist/llms/PromptInput.md +37 -0
  181. package/dist/llms/PullToRefresh.md +26 -0
  182. package/dist/llms/QRCode.md +30 -0
  183. package/dist/llms/QueryBuilder.md +31 -0
  184. package/dist/llms/RadarChart.md +24 -0
  185. package/dist/llms/Radio.md +23 -0
  186. package/dist/llms/RadioGroup.md +32 -0
  187. package/dist/llms/RangeCalendar.md +26 -0
  188. package/dist/llms/RangeSlider.md +39 -0
  189. package/dist/llms/Rating.md +37 -0
  190. package/dist/llms/Reaction.md +26 -0
  191. package/dist/llms/RefTable.md +13 -0
  192. package/dist/llms/RelativeTime.md +24 -0
  193. package/dist/llms/Result.md +29 -0
  194. package/dist/llms/RichTextEditor.md +59 -0
  195. package/dist/llms/SankeyChart.md +26 -0
  196. package/dist/llms/ScatterChart.md +26 -0
  197. package/dist/llms/ScheduleView.md +35 -0
  198. package/dist/llms/ScrollArea.md +24 -0
  199. package/dist/llms/ScrollProgress.md +22 -0
  200. package/dist/llms/SearchInput.md +44 -0
  201. package/dist/llms/SegmentedControl.md +40 -0
  202. package/dist/llms/Select.md +44 -0
  203. package/dist/llms/SelectionBar.md +28 -0
  204. package/dist/llms/Sidebar.md +47 -0
  205. package/dist/llms/SignaturePad.md +36 -0
  206. package/dist/llms/SimpleGrid.md +24 -0
  207. package/dist/llms/Skeleton.md +26 -0
  208. package/dist/llms/Slider.md +36 -0
  209. package/dist/llms/SmartSearchInput.md +35 -0
  210. package/dist/llms/Snackbar.md +30 -0
  211. package/dist/llms/SortableList.md +33 -0
  212. package/dist/llms/SourceCitation.md +28 -0
  213. package/dist/llms/SourceCode.md +13 -0
  214. package/dist/llms/Span.md +29 -0
  215. package/dist/llms/Sparkline.md +27 -0
  216. package/dist/llms/SpeedDial.md +28 -0
  217. package/dist/llms/Spinner.md +26 -0
  218. package/dist/llms/SplitButton.md +29 -0
  219. package/dist/llms/Splitter.md +37 -0
  220. package/dist/llms/Spoiler.md +26 -0
  221. package/dist/llms/Stack.md +48 -0
  222. package/dist/llms/Stats.md +44 -0
  223. package/dist/llms/Stepper.md +32 -0
  224. package/dist/llms/StreamingText.md +24 -0
  225. package/dist/llms/SwipeAction.md +28 -0
  226. package/dist/llms/SwipeableList.md +21 -0
  227. package/dist/llms/Switch.md +27 -0
  228. package/dist/llms/SwitchGroup.md +31 -0
  229. package/dist/llms/T.md +13 -0
  230. package/dist/llms/TabBar.md +33 -0
  231. package/dist/llms/TabNavigation.md +30 -0
  232. package/dist/llms/Table.md +73 -0
  233. package/dist/llms/Tabs.md +40 -0
  234. package/dist/llms/Tag.md +30 -0
  235. package/dist/llms/TagInput.md +37 -0
  236. package/dist/llms/Terminal.md +29 -0
  237. package/dist/llms/Text.md +31 -0
  238. package/dist/llms/Textarea.md +30 -0
  239. package/dist/llms/ThemeToggle.md +31 -0
  240. package/dist/llms/ThoughtProcess.md +27 -0
  241. package/dist/llms/ThreadList.md +27 -0
  242. package/dist/llms/TimePicker.md +41 -0
  243. package/dist/llms/Timeline.md +24 -0
  244. package/dist/llms/Title.md +27 -0
  245. package/dist/llms/Toast.md +32 -0
  246. package/dist/llms/ToggleGroup.md +39 -0
  247. package/dist/llms/Toolbar.md +35 -0
  248. package/dist/llms/Tooltip.md +29 -0
  249. package/dist/llms/Tour.md +24 -0
  250. package/dist/llms/Transfer.md +35 -0
  251. package/dist/llms/Transition.md +34 -0
  252. package/dist/llms/TreeDiagram.md +33 -0
  253. package/dist/llms/TreeSelect.md +43 -0
  254. package/dist/llms/TreeView.md +50 -0
  255. package/dist/llms/Treemap.md +27 -0
  256. package/dist/llms/UsageMeter.md +31 -0
  257. package/dist/llms/Video.md +46 -0
  258. package/dist/llms/VirtualList.md +31 -0
  259. package/dist/llms/VisuallyHidden.md +19 -0
  260. package/dist/llms/VoiceVisualizer.md +30 -0
  261. package/dist/llms/WaterfallChart.md +25 -0
  262. package/dist/llms/Watermark.md +27 -0
  263. package/dist/llms/colorSwatch.md +13 -0
  264. package/dist/llms-full.txt +114 -111
  265. package/dist/llms.txt +4 -2
  266. package/dist/locales/en/data-display.json +3 -0
  267. package/dist/locales/ja/data-display.json +3 -0
  268. package/dist/locales/pt/data-display.json +3 -0
  269. package/dist/styles.css +1 -1
  270. package/dist/wimui.umd.js +5 -5
  271. package/package.json +10 -3
@@ -4,7 +4,7 @@
4
4
 
5
5
  ## What this is
6
6
 
7
- **wimui** v0.70.0 — a React 19 component library: 230 documented components across 10 categories, with design tokens, dark mode, i18n (en/ja/pt-BR) and WAI-ARIA compliant a11y. Peer deps: react ^19, react-dom ^19 (plus optional peers for specific components — see package.json).
7
+ **wimui** v0.72.0 — a React 19 component library: 230 documented components across 10 categories, with design tokens, dark mode, i18n (en/ja/pt-BR) and WAI-ARIA compliant a11y. Peer deps: react ^19, react-dom ^19 (plus optional peers for specific components — see package.json).
8
8
 
9
9
  ## Install & required setup
10
10
 
@@ -786,7 +786,7 @@ number of pixels. Prefer the token so the gap follows the theme.
786
786
  - `actions: ReactNode` — Action elements (buttons, etc.)
787
787
  - `variant: "dashed" | "solid" | "none"` = "dashed" — Border variant
788
788
  - `bgVariant: "default" | "transparent" | "muted"` = "default" — Background variant
789
- - `size: Extract<ComponentSize, "sm" | "md" | "lg">` = "md" — Size variation
789
+ - `size: "sm" | "md" | "lg"` = "md" — Size variation
790
790
  - `align: "start" | "center"` = "center" — Horizontal alignment of the icon, text and actions. Centred content only reads
791
791
  as deliberate when the area is the one thing in its region — a drop target or a
792
792
  whole result page. Inside a card, a table or a column of prose, use `"start"`
@@ -915,7 +915,7 @@ number of pixels. Prefer the token so the gap follows the theme.
915
915
  - `position: React.CSSProperties["position"]` — Position
916
916
  - **Toolbar** — Action strip for IconButton, ToggleGroup, and related controls with toolbar keyboard navigation. (aka Action Bar)
917
917
  - `asChild: boolean` = false — If true, the component will be rendered as its child, merging its props onto that child.
918
- - `size: ComponentSizeBasic` = "md" — Visual density for padding and gap.
918
+ - `size: "lg" | "md" | "sm"` = "md" — Visual density for padding and gap.
919
919
  @default "md"
920
920
  - `orientation: "horizontal" | "vertical"` = "horizontal" — Layout axis of the toolbar.
921
921
  @default "horizontal"
@@ -968,9 +968,9 @@ children. Defaults to the built-in "Show hidden tools (n)" (en / ja / pt).
968
968
  - `asChild: boolean` = false — If true, the button will be rendered as its child, merging its props onto that child.
969
969
  Useful for using the button styles with Link components (e.g. from React Router or Next.js).
970
970
  - `backgroundColor: T | (string & {})` — Overrides the button background color with a design token. Usually the `variant` prop is enough; use this prop only as a last resort.
971
- - `size: Extract<ComponentSize, "sm" | "md" | "lg">` = "md" — Size of the button
971
+ - `size: "sm" | "md" | "lg"` = "md" — Size of the button
972
972
  - `variant: "solid" | "outline" | "ghost"` = "outline" — Visual style variant of the button
973
- - `intent: ButtonIntent` = "default" — Design intent of the button (visual / semantic state). Unrelated to the ARIA role attribute.
973
+ - `intent: "default" | "danger" | "success"` = "default" — Design intent of the button (visual / semantic state). Unrelated to the ARIA role attribute.
974
974
  - `icon: React.ComponentProps<typeof Icon>["name"] | React.ReactNode` — Icon name or custom icon element. An icon-only button (no children) needs `aria-label` or `aria-labelledby`: the icon name is not used as the accessible name.
975
975
  - `iconPosition: "left" | "right"` = "left" — Position of the icon relative to the label
976
976
  - `loading: boolean` = false — Whether to show a loading indicator and disable interaction
@@ -1004,7 +1004,7 @@ Useful for using the button styles with Link components (e.g. from React Router
1004
1004
  - `separator: string` = " / " — Custom separator for the display value
1005
1005
  - `allowClear: boolean` = false — Whether to show a clear button when a value is selected
1006
1006
  - `aria-label: string` — Accessible label for the trigger when no visible label is provided
1007
- - `width: FieldWidth | string | number` — Fixed width of the field (width token, CSS value, or number in px)
1007
+ - `width: ("xs" | "sm" | "md" | "lg" | "xl") | string | number` — Fixed width of the field (width token, CSS value, or number in px)
1008
1008
  - `fullWidth: boolean` = false — Whether to take full width of parent
1009
1009
  - **Checkbox** — Multiple choice
1010
1010
  - `asChild: boolean` = false — Whether to render as a child element.
@@ -1028,7 +1028,7 @@ of a checkbox group. Use with `description` when the options need explaining.
1028
1028
  - `required: boolean` — Whether to show the required indicator
1029
1029
  - `disabled: boolean` — Whether the whole group is disabled
1030
1030
  - **ColorInput** — Input with color preview (aka Color Well, Color Field)
1031
- - `intent: FieldIntent` = "default" — Semantic intent of the field (e.g. error state)
1031
+ - `intent: "default" | "danger"` = "default" — Semantic intent of the field (e.g. error state)
1032
1032
  - `variant: "outline" | "ghost"` = "outline" — Visual style variant of the field
1033
1033
  - `fullWidth: boolean` = false — Whether to take full width of parent
1034
1034
  - `leftIcon: React.ComponentProps<typeof Icon>["name"]` — Icon name to display on the left side
@@ -1041,7 +1041,7 @@ of a checkbox group. Use with `description` when the options need explaining.
1041
1041
  - `showPasswordToggle: boolean` = true — Whether to show the visibility toggle when type is "password"
1042
1042
  - `rightIconClassName: string` — Additional class name for the right icon
1043
1043
  - `rightIconRotated: boolean` — Whether to rotate the right icon 180 degrees (e.g. for an open state)
1044
- - `width: FieldWidth | string | number` — Fixed width of the field (width token, CSS value, or number in px)
1044
+ - `width: ("xs" | "sm" | "md" | "lg" | "xl") | string | number` — Fixed width of the field (width token, CSS value, or number in px)
1045
1045
  - `label: React.ReactNode` — Field label
1046
1046
  - `error: string` — Error message
1047
1047
  - `required: boolean` — Whether to show the required indicator
@@ -1060,7 +1060,7 @@ so the unit does not have to be repeated in the label.
1060
1060
  - `styles: { root?: string; inner?: string; icon?: string; icons?: string; iconItem?: string; iconButton?: string; }` — Custom styles for internal parts
1061
1061
  - `asChild: boolean` = false — Whether to render as a child element.
1062
1062
  - **ColorPicker** — Color selection picker
1063
- - `intent: FieldIntent` = "default" — Semantic intent of the field (e.g. error state)
1063
+ - `intent: "default" | "danger"` = "default" — Semantic intent of the field (e.g. error state)
1064
1064
  - `variant: "outline" | "ghost"` = "outline" — Visual style variant of the field
1065
1065
  - `fullWidth: boolean` = false — Whether to take full width of parent
1066
1066
  - `leftIcon: React.ComponentProps<typeof Icon>["name"]` — Icon name to display on the left side
@@ -1073,7 +1073,7 @@ so the unit does not have to be repeated in the label.
1073
1073
  - `showPasswordToggle: boolean` = true — Whether to show the visibility toggle when type is "password"
1074
1074
  - `rightIconClassName: string` — Additional class name for the right icon
1075
1075
  - `rightIconRotated: boolean` — Whether to rotate the right icon 180 degrees (e.g. for an open state)
1076
- - `width: FieldWidth | string | number` — Fixed width of the field (width token, CSS value, or number in px)
1076
+ - `width: ("xs" | "sm" | "md" | "lg" | "xl") | string | number` — Fixed width of the field (width token, CSS value, or number in px)
1077
1077
  - `label: React.ReactNode` — Field label
1078
1078
  - `error: string` — Error message
1079
1079
  - `required: boolean` — Whether to show the required indicator
@@ -1109,7 +1109,7 @@ so the unit does not have to be repeated in the label.
1109
1109
  - `labels: { noResults?: React.ReactNode; }` = {} — Labels for internationalization
1110
1110
  - **CopyButton** — Copy to clipboard
1111
1111
  - `value: string` (required) — Text copied to the clipboard
1112
- - `size: Extract<ComponentSize, "sm" | "md" | "lg">` = "md" — Size of the button
1112
+ - `size: "sm" | "md" | "lg"` = "md" — Size of the button
1113
1113
  - `className: string` — Additional class names
1114
1114
  - `aria-label: string` — Accessible label for the button
1115
1115
  - `aria-labelledby: string` — ID of the element that labels the button. Takes precedence over `aria-label`.
@@ -1120,7 +1120,7 @@ so the unit does not have to be repeated in the label.
1120
1120
  - `children: React.ReactNode` — Trigger content when `asChild` is true
1121
1121
  - **CounterTextarea** — Textarea with character count display
1122
1122
  - `asChild: boolean` — If true, the textarea element will be rendered as its child, merging its props onto that child.
1123
- - `intent: FieldIntent` — Semantic intent of the field (e.g. error state)
1123
+ - `intent: "default" | "danger"` — Semantic intent of the field (e.g. error state)
1124
1124
  - `variant: "outline" | "ghost"` — Visual style variant of the field
1125
1125
  - `fullWidth: boolean` = false — Whether to take full width of parent
1126
1126
  - `fieldSizing: "fixed" | "content"` — Sizing behavior: "fixed" keeps the height, "content" grows with the text
@@ -1128,7 +1128,7 @@ so the unit does not have to be repeated in the label.
1128
1128
  - `error: string` — Error message
1129
1129
  - `required: boolean` — Whether to show the required indicator
1130
1130
  - `layout: "vertical" | "horizontal"` — Layout direction of label and field
1131
- - `width: FieldWidth | string | number` — Fixed width of the field (width token, CSS value, or number in px)
1131
+ - `width: ("xs" | "sm" | "md" | "lg" | "xl") | string | number` — Fixed width of the field (width token, CSS value, or number in px)
1132
1132
  - `showCount: boolean` = true — Whether to show the character count.
1133
1133
  @default true
1134
1134
  - `counterPosition: "bottom" | "overlay"` = "bottom" — Position of the counter.
@@ -1136,9 +1136,9 @@ so the unit does not have to be repeated in the label.
1136
1136
  "overlay" shows it inside the textarea (bottom-right).
1137
1137
  @default "bottom"
1138
1138
  - **CreditCardInput** — Payment card input with brand detection
1139
- - `onBrandChange: (brand: CreditCardBrand) => void` — Callback when the card brand is detected.
1139
+ - `onBrandChange: (brand: ("visa" | "mastercard" | "amex" | "discover" | "jcb" | "diners" | "generic")) => void` — Callback when the card brand is detected.
1140
1140
  - `asChild: boolean` = false — Whether to render as a child component.
1141
- - `intent: FieldIntent` = "default" — Semantic intent of the field (e.g. error state)
1141
+ - `intent: "default" | "danger"` = "default" — Semantic intent of the field (e.g. error state)
1142
1142
  - `variant: "outline" | "ghost"` = "outline" — Visual style variant of the field
1143
1143
  - `fullWidth: boolean` = false — Whether to take full width of parent
1144
1144
  - `leftIcon: React.ComponentProps<typeof Icon>["name"]` — Icon name to display on the left side
@@ -1150,7 +1150,7 @@ so the unit does not have to be repeated in the label.
1150
1150
  - `showPasswordToggle: boolean` = true — Whether to show the visibility toggle when type is "password"
1151
1151
  - `rightIconClassName: string` — Additional class name for the right icon
1152
1152
  - `rightIconRotated: boolean` — Whether to rotate the right icon 180 degrees (e.g. for an open state)
1153
- - `width: FieldWidth | string | number` — Fixed width of the field (width token, CSS value, or number in px)
1153
+ - `width: ("xs" | "sm" | "md" | "lg" | "xl") | string | number` — Fixed width of the field (width token, CSS value, or number in px)
1154
1154
  - `label: React.ReactNode` — Field label
1155
1155
  - `error: string` — Error message
1156
1156
  - `required: boolean` — Whether to show the required indicator
@@ -1168,7 +1168,7 @@ Use it when the field already does the same thing from the keyboard.
1168
1168
  so the unit does not have to be repeated in the label.
1169
1169
  - `styles: { root?: string; inner?: string; icon?: string; icons?: string; iconItem?: string; iconButton?: string; }` — Custom styles for internal parts
1170
1170
  - **DatePicker** — Date selection
1171
- - `intent: FieldIntent` = "default" — Semantic intent of the field (e.g. error state)
1171
+ - `intent: "default" | "danger"` = "default" — Semantic intent of the field (e.g. error state)
1172
1172
  - `variant: "outline" | "ghost"` = "outline" — Visual style variant of the field
1173
1173
  - `fullWidth: boolean` = false — Whether to take full width of parent
1174
1174
  - `value: Date | null` — Selected date value (`null` = cleared; omit/`undefined` = uncontrolled)
@@ -1185,7 +1185,7 @@ so the unit does not have to be repeated in the label.
1185
1185
  - `required: boolean` — Whether to show the required indicator
1186
1186
  - `layout: "vertical" | "horizontal"` — Layout direction of label and field
1187
1187
  - `labels: { placeholder?: string; }` — Labels for manual translation
1188
- - `width: FieldWidth | string | number` — Fixed width of the field (width token, CSS value, or number in px)
1188
+ - `width: ("xs" | "sm" | "md" | "lg" | "xl") | string | number` — Fixed width of the field (width token, CSS value, or number in px)
1189
1189
  - `asChild: boolean` = false — Whether to render as a child element.
1190
1190
  - **DateRangePicker** — Date range selection
1191
1191
  - `startProps: React.ComponentProps<typeof DatePicker>` — Props passed to the start-date DatePicker
@@ -1263,7 +1263,7 @@ it undefined to let the field track its own selection.
1263
1263
  - `className: string` — Additional class names
1264
1264
  - `iconName: React.ComponentProps<typeof Icon>["name"]` — Icon name shown on the button
1265
1265
  - `iconPosition: "left" | "right"` — Position of the icon relative to the button label
1266
- - `size: Extract<ComponentSize, "sm" | "md" | "lg">` = "md" — Size of the button
1266
+ - `size: "sm" | "md" | "lg"` = "md" — Size of the button
1267
1267
  - `error: string` — Error message
1268
1268
  - `required: boolean` — Whether to show the required indicator
1269
1269
  - `layout: "vertical" | "horizontal"` = "vertical" — Layout direction of label and field
@@ -1279,9 +1279,9 @@ it undefined to let the field track its own selection.
1279
1279
  `primary` は variant 未指定とまったく同じ規則に落ちる重複、
1280
1280
  `default` は**既定の見た目ではなく枠線のある outline** で名前が逆、
1281
1281
  SCSS には誰も付けない `.default_intent` が「temporary name」のまま残っていた。
1282
- - `intent: ButtonIntent` = "default" — Intent of the button (semantic meaning)
1282
+ - `intent: "default" | "danger" | "success"` = "default" — Intent of the button (semantic meaning)
1283
1283
  - `shape: "circle" | "square"` = "circle" — Shape of the button
1284
- - `size: Extract<ComponentSize, "sm" | "md" | "lg">` = "md" — Size of the button
1284
+ - `size: "sm" | "md" | "lg"` = "md" — Size of the button
1285
1285
  - `label: React.ReactNode` — Label text for extended FAB
1286
1286
  - `shrink: boolean` = false — Whether to shrink the extended FAB (hide label)
1287
1287
  - `position: "bottom-right" | "bottom-left" | "bottom-center" | "top-right" | "top-left" | "inline"` = "bottom-right" — Position of the button
@@ -1297,9 +1297,9 @@ text to take a name from, and the icon name is not used as one.
1297
1297
  - `iconName: React.ComponentProps<typeof Icon>["name"]` (required) — Icon name to display
1298
1298
  - `aria-label: string` (required) — Accessible label for the icon-only button
1299
1299
  - `backgroundColor: T | (string & {})` — Overrides the button background color with a design token. Usually the `variant` prop is enough; use this prop only as a last resort.
1300
- - `size: Extract<ComponentSize, "sm" | "md" | "lg">` = "md" — Size of the button
1300
+ - `size: "sm" | "md" | "lg"` = "md" — Size of the button
1301
1301
  - `variant: "solid" | "outline" | "ghost"` = "outline" — Visual style variant of the button
1302
- - `intent: ButtonIntent` = "default" — Design intent of the button (visual / semantic state). Unrelated to the ARIA role attribute.
1302
+ - `intent: "default" | "danger" | "success"` = "default" — Design intent of the button (visual / semantic state). Unrelated to the ARIA role attribute.
1303
1303
  - `icon: React.ComponentProps<typeof Icon>["name"] | React.ReactNode` — Icon name or custom icon element. An icon-only button (no children) needs `aria-label` or `aria-labelledby`: the icon name is not used as the accessible name.
1304
1304
  - `loading: boolean` = false — Whether to show a loading indicator and disable interaction
1305
1305
  - `justify: "start" | "center" | "end" | "between"` = "center" — Horizontal alignment of the button content
@@ -1342,7 +1342,7 @@ the server must send matching CORS headers or the image will not load at all.
1342
1342
  - `fullWidth: boolean` = false — Whether to take full width of parent
1343
1343
  - `label: React.ReactNode` — Accessible label for the text and edit button
1344
1344
  - **Input** — Single-line input fields for text, numbers, or emails
1345
- - `intent: FieldIntent` = "default" — Semantic intent of the field (e.g. error state)
1345
+ - `intent: "default" | "danger"` = "default" — Semantic intent of the field (e.g. error state)
1346
1346
  - `variant: "outline" | "ghost"` = "outline" — Visual style variant of the field
1347
1347
  - `fullWidth: boolean` = false — Whether to take full width of parent
1348
1348
  - `leftIcon: React.ComponentProps<typeof Icon>["name"]` — Icon name to display on the left side
@@ -1355,7 +1355,7 @@ the server must send matching CORS headers or the image will not load at all.
1355
1355
  - `showPasswordToggle: boolean` = true — Whether to show the visibility toggle when type is "password"
1356
1356
  - `rightIconClassName: string` — Additional class name for the right icon
1357
1357
  - `rightIconRotated: boolean` — Whether to rotate the right icon 180 degrees (e.g. for an open state)
1358
- - `width: FieldWidth | string | number` — Fixed width of the field (width token, CSS value, or number in px)
1358
+ - `width: ("xs" | "sm" | "md" | "lg" | "xl") | string | number` — Fixed width of the field (width token, CSS value, or number in px)
1359
1359
  - `label: React.ReactNode` — Field label
1360
1360
  - `error: string` — Error message
1361
1361
  - `required: boolean` — Whether to show the required indicator
@@ -1375,10 +1375,10 @@ so the unit does not have to be repeated in the label.
1375
1375
  - `asChild: boolean` = false — Whether to render as a child element.
1376
1376
  - **InputBase** — Standardizes the visual container, icon slots (Prefix/Suffix), and clear button behavior for text-based inputs.
1377
1377
  - `children: React.ReactNode` (required) — Inner form control element(s) wrapped by the shell
1378
- - `intent: FieldIntent | WimIntent` = "default" — Semantic intent of the field (e.g. error state)
1378
+ - `intent: ("default" | "danger") | ("primary" | "success" | "warning" | "danger" | "info" | "neutral" | "default")` = "default" — Semantic intent of the field (e.g. error state)
1379
1379
  - `variant: "outline" | "ghost"` = "outline" — Visual style variant of the field
1380
1380
  - `fullWidth: boolean` = false — Whether to take full width of parent
1381
- - `width: FieldWidth | string | number` — Fixed width of the field (width token, CSS value, or number in px)
1381
+ - `width: ("xs" | "sm" | "md" | "lg" | "xl") | string | number` — Fixed width of the field (width token, CSS value, or number in px)
1382
1382
  - `className: string` — Additional class names
1383
1383
  - `disabled: boolean` — Whether the field is disabled
1384
1384
  - `leftIcon: React.ComponentProps<typeof Icon>["name"]` — Icon name to display on the left side
@@ -1402,7 +1402,7 @@ make room rather than running underneath it.
1402
1402
  - **InputMask** — Formatted inputs
1403
1403
  - `mask: string` (required) — Mask pattern ('9': digit, 'a': letter, '*': alphanumeric; other characters are shown as-is)
1404
1404
  - `maskChar: string` = "_" — Placeholder character for unfilled mask positions
1405
- - `intent: FieldIntent` = "default" — Semantic intent of the field (e.g. error state)
1405
+ - `intent: "default" | "danger"` = "default" — Semantic intent of the field (e.g. error state)
1406
1406
  - `variant: "outline" | "ghost"` = "outline" — Visual style variant of the field
1407
1407
  - `fullWidth: boolean` = false — Whether to take full width of parent
1408
1408
  - `leftIcon: React.ComponentProps<typeof Icon>["name"]` — Icon name to display on the left side
@@ -1415,7 +1415,7 @@ make room rather than running underneath it.
1415
1415
  - `showPasswordToggle: boolean` = true — Whether to show the visibility toggle when type is "password"
1416
1416
  - `rightIconClassName: string` — Additional class name for the right icon
1417
1417
  - `rightIconRotated: boolean` — Whether to rotate the right icon 180 degrees (e.g. for an open state)
1418
- - `width: FieldWidth | string | number` — Fixed width of the field (width token, CSS value, or number in px)
1418
+ - `width: ("xs" | "sm" | "md" | "lg" | "xl") | string | number` — Fixed width of the field (width token, CSS value, or number in px)
1419
1419
  - `label: React.ReactNode` — Field label
1420
1420
  - `error: string` — Error message
1421
1421
  - `required: boolean` — Whether to show the required indicator
@@ -1435,9 +1435,9 @@ so the unit does not have to be repeated in the label.
1435
1435
  - `asChild: boolean` = false — Whether to render as a child element.
1436
1436
  - **LinkButton** — Anchor styled as button
1437
1437
  - `iconPosition: "left" | "right"` = "left" — Position of the icon relative to the label
1438
- - `size: Extract<ComponentSize, "sm" | "md" | "lg">` = "md" — Size of the button
1438
+ - `size: "sm" | "md" | "lg"` = "md" — Size of the button
1439
1439
  - `variant: "solid" | "outline" | "ghost"` = "outline" — Visual style variant of the button
1440
- - `intent: ButtonIntent` = "default" — Design intent of the button (visual / semantic state). Unrelated to the ARIA role attribute.
1440
+ - `intent: "default" | "danger" | "success"` = "default" — Design intent of the button (visual / semantic state). Unrelated to the ARIA role attribute.
1441
1441
  - `justify: "start" | "center" | "end" | "between"` = "center" — Horizontal alignment of the button content
1442
1442
  - `fullWidth: boolean` = false — Whether the button should take up the full width of its container
1443
1443
  - **Mentions** — @ / # suggestions
@@ -1462,7 +1462,7 @@ so the unit does not have to be repeated in the label.
1462
1462
  - `aria-label: string` — Accessible label for the trigger when no visible label is provided
1463
1463
  - `aria-labelledby: string` — ID of the element that labels the field
1464
1464
  - `aria-describedby: string` — ID of the element that describes the field
1465
- - `width: FieldWidth | string | number` — Fixed width of the field (width token, CSS value, or number in px)
1465
+ - `width: ("xs" | "sm" | "md" | "lg" | "xl") | string | number` — Fixed width of the field (width token, CSS value, or number in px)
1466
1466
  - `fullWidth: boolean` = false — Whether to take full width of parent
1467
1467
  - **NumberInput** — Input with step adjustments (aka Spin Button, Numeric Stepper)
1468
1468
  - `mode: "number" | "text"` = "number" — 'number': uses the native type="number" (e.g. quantity steppers)
@@ -1485,7 +1485,7 @@ box and receives a **1-based** position — the first box is `1`, not `0`.
1485
1485
  - `asChild: boolean` = false — Whether to render as a child element.
1486
1486
  - `fullWidth: boolean` = false — Whether to take full width of parent
1487
1487
  - **PasswordInput** — Password with toggle
1488
- - `intent: FieldIntent` = "default" — Semantic intent of the field (e.g. error state)
1488
+ - `intent: "default" | "danger"` = "default" — Semantic intent of the field (e.g. error state)
1489
1489
  - `variant: "outline" | "ghost"` = "outline" — Visual style variant of the field
1490
1490
  - `fullWidth: boolean` = false — Whether to take full width of parent
1491
1491
  - `leftIcon: React.ComponentProps<typeof Icon>["name"]` — Icon name to display on the left side
@@ -1495,7 +1495,7 @@ box and receives a **1-based** position — the first box is `1`, not `0`.
1495
1495
  - `allowClear: boolean` = false — Whether to show a clear button when value is present
1496
1496
  - `rightIconClassName: string` — Additional class name for the right icon
1497
1497
  - `rightIconRotated: boolean` — Whether to rotate the right icon 180 degrees (e.g. for an open state)
1498
- - `width: FieldWidth | string | number` — Fixed width of the field (width token, CSS value, or number in px)
1498
+ - `width: ("xs" | "sm" | "md" | "lg" | "xl") | string | number` — Fixed width of the field (width token, CSS value, or number in px)
1499
1499
  - `label: React.ReactNode` — Field label
1500
1500
  - `error: string` — Error message
1501
1501
  - `required: boolean` — Whether to show the required indicator
@@ -1518,7 +1518,7 @@ so the unit does not have to be repeated in the label.
1518
1518
  - `score: 0 | 1 | 2 | 3 | 4` — Strength score (the default calculation is used when omitted)
1519
1519
  0: very weak, 1: weak, 2: fair, 3: strong, 4: very strong
1520
1520
  - `showLabel: boolean` = true — Whether to show the strength label
1521
- - `calculateLevel: (password: string) => PasswordStrengthLevel` = (password: string): PasswordStrengthLevel => {
1521
+ - `calculateLevel: (password: string) => (0 | 1 | 2 | 3 | 4)` = (password: string): PasswordStrengthLevel => {
1522
1522
  if (!password) return 0;
1523
1523
  let score = 0;
1524
1524
  if (password.length >= 8) score++;
@@ -1602,7 +1602,7 @@ of a radio group. Use with `description` when the options need explaining.
1602
1602
  - `allowHalf: boolean` = false — Whether to allow half stars
1603
1603
  - `disabled: boolean` = false — Whether the rating is disabled
1604
1604
  - `readOnly: boolean` = false — Read-only flag (display only; unlike disabled it is not grayed out)
1605
- - `size: Extract<ComponentSize, "sm" | "md" | "lg">` = "md" — Size of the stars
1605
+ - `size: "sm" | "md" | "lg"` = "md" — Size of the stars
1606
1606
  - `onChange: (value: number) => void` — Callback when the value changes
1607
1607
  - `className: string` — Additional class names
1608
1608
  - `label: React.ReactNode` — Accessible label
@@ -1621,10 +1621,10 @@ allows, whichever format is used.
1621
1621
  editor is created; changing it later does not convert the content.
1622
1622
  - `placeholder: string` — Placeholder shown when the editor is empty
1623
1623
  - `disabled: boolean` — Whether the editor is disabled
1624
- - `intent: FieldIntent` = "default" — Semantic intent of the field (e.g. error state)
1624
+ - `intent: "default" | "danger"` = "default" — Semantic intent of the field (e.g. error state)
1625
1625
  - `variant: "outline" | "ghost"` = "outline" — Visual style variant of the field
1626
1626
  - `fullWidth: boolean` = false — Whether to take full width of parent
1627
- - `width: FieldWidth | string | number` — Fixed width of the field (width token, CSS value, or number in px)
1627
+ - `width: ("xs" | "sm" | "md" | "lg" | "xl") | string | number` — Fixed width of the field (width token, CSS value, or number in px)
1628
1628
  - `minHeight: number | string` = 200 — Minimum height of the editing area
1629
1629
  - `label: React.ReactNode` — Field label
1630
1630
  - `error: string` — Error message
@@ -1632,7 +1632,7 @@ editor is created; changing it later does not convert the content.
1632
1632
  - `layout: "vertical" | "horizontal"` — Layout direction of label and field
1633
1633
  - `className: string` — Additional class names
1634
1634
  - `id: string` — Unique ID for the component
1635
- - `toolbar: RichTextEditorToolbarItem[]` = [
1635
+ - `toolbar: ("bold" | "italic" | "underline" | "strikethrough" | "h1" | "h2" | "h3" | "ul" | "ol" | "link" | "unlink" | "image" | "removeFormat" | "separator")[]` = [
1636
1636
  "bold",
1637
1637
  "italic",
1638
1638
  "underline",
@@ -1656,7 +1656,7 @@ editor is created; changing it later does not convert the content.
1656
1656
  - `onImageUpload: (file: File) => Promise<string>` — Uploads an image file and resolves to its URL (http, https or relative). When given, the image dialog offers a file picker
1657
1657
  and image files pasted or dropped into the editor are uploaded and inserted. The editor stores only the URL it gets back.
1658
1658
  - **SearchInput** — Search with clear button (aka Search Field, Search Bar)
1659
- - `intent: FieldIntent` = "default" — Semantic intent of the field (e.g. error state)
1659
+ - `intent: "default" | "danger"` = "default" — Semantic intent of the field (e.g. error state)
1660
1660
  - `variant: "outline" | "ghost"` = "outline" — Visual style variant of the field
1661
1661
  - `fullWidth: boolean` = false — Whether to take full width of parent
1662
1662
  - `leftIcon: React.ComponentProps<typeof Icon>["name"]` — Icon name to display on the left side
@@ -1669,7 +1669,7 @@ and image files pasted or dropped into the editor are uploaded and inserted. The
1669
1669
  - `showPasswordToggle: boolean` = true — Whether to show the visibility toggle when type is "password"
1670
1670
  - `rightIconClassName: string` — Additional class name for the right icon
1671
1671
  - `rightIconRotated: boolean` — Whether to rotate the right icon 180 degrees (e.g. for an open state)
1672
- - `width: FieldWidth | string | number` — Fixed width of the field (width token, CSS value, or number in px)
1672
+ - `width: ("xs" | "sm" | "md" | "lg" | "xl") | string | number` — Fixed width of the field (width token, CSS value, or number in px)
1673
1673
  - `label: React.ReactNode` — Field label
1674
1674
  - `error: string` — Error message
1675
1675
  - `required: boolean` — Whether to show the required indicator
@@ -1691,7 +1691,7 @@ so the unit does not have to be repeated in the label.
1691
1691
  - `options: Option[]` (required) — List of segment options
1692
1692
  - `value: string` (required) — Selected value
1693
1693
  - `onChange: (value: string) => void` (required) — Callback when the selected value changes
1694
- - `size: Extract<ComponentSize, "sm" | "md" | "lg">` = "md" — Size of the control
1694
+ - `size: "sm" | "md" | "lg"` = "md" — Size of the control
1695
1695
  - `fullWidth: boolean` = false — Whether to take full width of parent
1696
1696
  - `className: string` — Additional class names
1697
1697
  - `label: string` — Accessible label
@@ -1721,12 +1721,12 @@ so the unit does not have to be repeated in the label.
1721
1721
  - `allowClear: boolean` = false — Whether to show a clear button when a value is selected
1722
1722
  - `fullWidth: boolean` = false — Whether to take full width of parent
1723
1723
  - `id: string` — Unique ID for the component
1724
- - `intent: FieldIntent` = "default" — Semantic intent of the field (e.g. error state)
1724
+ - `intent: "default" | "danger"` = "default" — Semantic intent of the field (e.g. error state)
1725
1725
  - `error: string` — Error message
1726
1726
  - `required: boolean` — Whether to show the required indicator
1727
1727
  - `layout: "vertical" | "horizontal"` — Layout direction of label and field
1728
1728
  - `noOptionsFoundLabel: string` — Label shown when no options match the search
1729
- - `width: FieldWidth | string | number` — Fixed width of the field (width token, CSS value, or number in px)
1729
+ - `width: ("xs" | "sm" | "md" | "lg" | "xl") | string | number` — Fixed width of the field (width token, CSS value, or number in px)
1730
1730
  - `asChild: boolean` = false — Whether to render as a child element.
1731
1731
  - `styles: { root?: string; trigger?: string; value?: string; dropdown?: string; list?: string; option?: string; search?: string; searchInput?: string; groupLabel?: string; separator?: string; empty?: string; inputBase?: React.ComponentProps<typeof InputBase>["styles"]; }` — Custom styles for internal parts
1732
1732
  - **SignaturePad** — Handwritten signature input
@@ -1764,10 +1764,10 @@ so the unit does not have to be repeated in the label.
1764
1764
  - `asChild: boolean` = false — Whether to render as a child element.
1765
1765
  - `styles: { root?: string; labelWrapper?: string; label?: string; content?: string; error?: string; }` — Custom styles for internal parts
1766
1766
  - **SmartSearchInput** — Smart search input enabling both traditional search and AI prompting.
1767
- - `intent: FieldIntent` = "default" — Semantic intent of the field (e.g. error state)
1767
+ - `intent: "default" | "danger"` = "default" — Semantic intent of the field (e.g. error state)
1768
1768
  - `variant: "outline" | "ghost"` = "outline" — Visual style variant of the field
1769
1769
  - `fullWidth: boolean` = false — Whether to take full width of parent
1770
- - `width: FieldWidth | string | number` — Fixed width of the field (width token, CSS value, or number in px)
1770
+ - `width: ("xs" | "sm" | "md" | "lg" | "xl") | string | number` — Fixed width of the field (width token, CSS value, or number in px)
1771
1771
  - `label: React.ReactNode` — Field label
1772
1772
  - `error: string` — Error message
1773
1773
  - `required: boolean` — Whether to show the required indicator
@@ -1785,14 +1785,14 @@ so the unit does not have to be repeated in the label.
1785
1785
  - `actions: SplitButtonAction[]` (required) — Secondary actions listed behind the toggle.
1786
1786
  - `variant: "solid" | "outline" | "ghost"` = "solid" — Visual style, applied to both halves so they read as one control.
1787
1787
  - `intent: "default" | "danger" | "success"` = "default" — Intent (semantic color), applied to both halves.
1788
- - `size: Extract<ComponentSize, "sm" | "md" | "lg">` = "md" — Size of both halves.
1788
+ - `size: "sm" | "md" | "lg"` = "md" — Size of both halves.
1789
1789
  - `disabled: boolean` = false — Disable the whole control.
1790
1790
  - `loading: boolean` = false — Show a loading state on the main action.
1791
1791
  - `toggleLabel: string` (required) — Accessible name for the toggle half. The main half is named by its own text,
1792
1792
  but the toggle only shows a chevron, so it needs one of its own.
1793
1793
  - **Switch** — A binary switch for instantly toggling settings between on and off states (aka Toggle, Toggle Switch)
1794
1794
  - `asChild: boolean` = false — If true, the component will be rendered as its child, merging its props onto that child.
1795
- - `size: Extract<ComponentSize, "sm" | "md" | "lg">` = "md" — Size of the switch
1795
+ - `size: "sm" | "md" | "lg"` = "md" — Size of the switch
1796
1796
  - `className: string` — Additional class names
1797
1797
  - `children: React.ReactNode` — Label content rendered next to the switch
1798
1798
  - `error: boolean` = false — Whether to display as an error state (aria-invalid is applied)
@@ -1814,10 +1814,10 @@ but the toggle only shows a chevron, so it needs one of its own.
1814
1814
  - `onChange: (tags: string[]) => void` — Callback when the tags change
1815
1815
  - `placeholder: string` — Placeholder for the input
1816
1816
  - `disabled: boolean` = false — Whether the input is disabled
1817
- - `intent: FieldIntent` = "default" — Semantic intent of the field (e.g. error state)
1817
+ - `intent: "default" | "danger"` = "default" — Semantic intent of the field (e.g. error state)
1818
1818
  - `variant: "outline" | "ghost"` = "outline" — Visual style variant of the field
1819
1819
  - `fullWidth: boolean` = false — Whether to take full width of parent
1820
- - `width: FieldWidth | string | number` — Fixed width of the field (width token, CSS value, or number in px)
1820
+ - `width: ("xs" | "sm" | "md" | "lg" | "xl") | string | number` — Fixed width of the field (width token, CSS value, or number in px)
1821
1821
  - `label: React.ReactNode` — Field label
1822
1822
  - `error: string` — Error message
1823
1823
  - `required: boolean` — Whether to show the required indicator
@@ -1826,7 +1826,7 @@ but the toggle only shows a chevron, so it needs one of its own.
1826
1826
  - `maxTags: number` — Maximum number of tags that can be entered
1827
1827
  - **Textarea** — Multi-line input fields for longer text entries like descriptions or comments
1828
1828
  - `asChild: boolean` = false — If true, the textarea element will be rendered as its child, merging its props onto that child.
1829
- - `intent: FieldIntent` = "default" — Semantic intent of the field (e.g. error state)
1829
+ - `intent: "default" | "danger"` = "default" — Semantic intent of the field (e.g. error state)
1830
1830
  - `variant: "outline" | "ghost"` = "outline" — Visual style variant of the field
1831
1831
  - `fullWidth: boolean` = false — Whether to take full width of parent
1832
1832
  - `fieldSizing: "fixed" | "content"` = "fixed" — Sizing behavior: "fixed" keeps the height, "content" grows with the text
@@ -1834,21 +1834,21 @@ but the toggle only shows a chevron, so it needs one of its own.
1834
1834
  - `error: string` — Error message
1835
1835
  - `required: boolean` — Whether to show the required indicator
1836
1836
  - `layout: "vertical" | "horizontal"` — Layout direction of label and field
1837
- - `width: FieldWidth | string | number` — Fixed width of the field (width token, CSS value, or number in px)
1837
+ - `width: ("xs" | "sm" | "md" | "lg" | "xl") | string | number` — Fixed width of the field (width token, CSS value, or number in px)
1838
1838
  - **ThemeToggle** — Light / dark / system theme switcher
1839
1839
  - `value: "light" | "dark" | "system"` — Selected mode (controlled)
1840
1840
  - `defaultValue: "light" | "dark" | "system"` = "system" — Initially selected mode (uncontrolled)
1841
- - `onChange: (mode: ThemeMode) => void` — Callback when the mode changes
1842
- - `modes: ThemeMode[]` = ["light", "dark"] — Modes to offer, in cycle order
1841
+ - `onChange: (mode: ("light" | "dark" | "system")) => void` — Callback when the mode changes
1842
+ - `modes: ("light" | "dark" | "system")[]` = ["light", "dark"] — Modes to offer, in cycle order
1843
1843
  - `variant: "icon" | "segmented"` = "icon" — "icon" cycles modes on a single button; "segmented" shows one button per mode
1844
- - `size: Extract<ComponentSize, "sm" | "md" | "lg">` = "md" — Size of the control
1844
+ - `size: "sm" | "md" | "lg"` = "md" — Size of the control
1845
1845
  - `storageKey: string | null` = "wim-theme" — localStorage key used to persist the choice; pass null to disable persistence
1846
1846
  - `applyToDocument: boolean` = true — Whether to apply the selected mode to the document root as `data-theme`
1847
1847
  - `labels: { /** Label for the light mode */ light?: string; /** Label for the dark mode */ dark?: string; /** Label for the system (auto) mode */ system?: string; /** Accessible label / group label for the control */ toggle?: string; }` — Labels for internationalization
1848
1848
  - `className: string` — Additional class names
1849
1849
  - `asChild: boolean` = false — Whether to render as a child element.
1850
1850
  - **TimePicker** — Time selection
1851
- - `intent: FieldIntent` = "default" — Semantic intent of the field (e.g. error state)
1851
+ - `intent: "default" | "danger"` = "default" — Semantic intent of the field (e.g. error state)
1852
1852
  - `variant: "outline" | "ghost"` = "outline" — Visual style variant of the field
1853
1853
  - `fullWidth: boolean` = false — Whether to take full width of parent
1854
1854
  - `allowClear: boolean` = true — Whether to show a clear button when value is present
@@ -1860,7 +1860,7 @@ but the toggle only shows a chevron, so it needs one of its own.
1860
1860
  - `showPasswordToggle: boolean` = true — Whether to show the visibility toggle when type is "password"
1861
1861
  - `rightIconClassName: string` — Additional class name for the right icon
1862
1862
  - `rightIconRotated: boolean` — Whether to rotate the right icon 180 degrees (e.g. for an open state)
1863
- - `width: FieldWidth | string | number` — Fixed width of the field (width token, CSS value, or number in px)
1863
+ - `width: ("xs" | "sm" | "md" | "lg" | "xl") | string | number` — Fixed width of the field (width token, CSS value, or number in px)
1864
1864
  - `label: React.ReactNode` — Field label
1865
1865
  - `error: string` — Error message
1866
1866
  - `required: boolean` — Whether to show the required indicator
@@ -1884,7 +1884,7 @@ so the unit does not have to be repeated in the label.
1884
1884
  - `defaultValue: string | string[]` — Initially selected value(s) (uncontrolled)
1885
1885
  - `onChange: (value: string | string[]) => void` — Callback when the selection changes
1886
1886
  - `selectionMode: "single" | "multiple"` = "single" — Whether one or multiple options can be selected
1887
- - `size: Extract<ComponentSize, "sm" | "md" | "lg">` = "md" — Size of the toggle buttons
1887
+ - `size: "sm" | "md" | "lg"` = "md" — Size of the toggle buttons
1888
1888
  - `fullWidth: boolean` = false — Whether to take full width of parent
1889
1889
  - `className: string` — Additional class names
1890
1890
  - `disabled: boolean` = false — Whether the group is disabled
@@ -1938,7 +1938,7 @@ so the unit does not have to be repeated in the label.
1938
1938
  - `aria-label: string` — Accessible label for the trigger when no visible label is provided
1939
1939
  - `aria-labelledby: string` — ID of the element that labels the field
1940
1940
  - `aria-describedby: string` — ID of the element that describes the field
1941
- - `width: FieldWidth | string | number` — Fixed width of the field (width token, CSS value, or number in px)
1941
+ - `width: ("xs" | "sm" | "md" | "lg" | "xl") | string | number` — Fixed width of the field (width token, CSS value, or number in px)
1942
1942
  - `fullWidth: boolean` = false — Whether to take full width of parent
1943
1943
 
1944
1944
  ### feedback — `import { … } from "wimui/feedback"`
@@ -1955,7 +1955,7 @@ section of the page.
1955
1955
 
1956
1956
  @default "div"
1957
1957
  - `description: React.ReactNode` — Description text of the alert
1958
- - `intent: FeedbackIntent` = "default" — Intent (semantic state) of the alert
1958
+ - `intent: "default" | "info" | "success" | "warning" | "danger"` = "default" — Intent (semantic state) of the alert
1959
1959
  @default "default"
1960
1960
  - `icon: React.ReactNode` — Custom icon. When omitted, a default icon matching the intent is displayed.
1961
1961
  - `onClose: () => void` — Called when the close button is clicked. Providing it shows the close button.
@@ -1968,7 +1968,7 @@ section of the page.
1968
1968
  - **Banner** — Top prominent messages
1969
1969
  - `title: React.ReactNode` — Title of the banner
1970
1970
  - `description: React.ReactNode` — Description text of the banner
1971
- - `intent: FeedbackIntent` = "default" — Intent (semantic state) of the banner
1971
+ - `intent: "default" | "info" | "success" | "warning" | "danger"` = "default" — Intent (semantic state) of the banner
1972
1972
  @default "default"
1973
1973
  - `icon: boolean | React.ReactNode` = true — Whether to show the icon, or a custom icon element
1974
1974
  @default true
@@ -1987,7 +1987,7 @@ When a function is passed, it is called as (error, errorInfo, reset) => ReactNod
1987
1987
  - `children: React.ReactNode` — Element the indicator dot is attached to. If omitted, only the dot is rendered.
1988
1988
  - `color: T | (string & {})` = "primary" — Color of the dot. Accepts a design token color name or any CSS color value.
1989
1989
  @default "primary"
1990
- - `size: Extract<ComponentSize, "sm" | "md" | "lg">` = "md" — Size of the dot.
1990
+ - `size: "sm" | "md" | "lg"` = "md" — Size of the dot.
1991
1991
  @default "md"
1992
1992
  - `position: "top-right" | "top-left" | "bottom-right" | "bottom-left"` = "top-right" — Corner of the children the dot is placed at.
1993
1993
  @default "top-right"
@@ -2000,7 +2000,7 @@ When a function is passed, it is called as (error, errorInfo, reset) => ReactNod
2000
2000
  - **Loader** — Animated indicators to show that data is loading or processing
2001
2001
  - `variant: "bars" | "dots" | "pulse"` = "bars" — Animation style of the loader.
2002
2002
  @default "bars"
2003
- - `size: Extract<ComponentSize, "sm" | "md" | "lg" | "xl">` = "md" — Size of the loader.
2003
+ - `size: "sm" | "md" | "lg" | "xl"` = "md" — Size of the loader.
2004
2004
  @default "md"
2005
2005
  - `color: "currentColor" | WimColor` = "primary" — Color of the loader. Accepts a design token color name or "currentColor".
2006
2006
  @default "primary"
@@ -2039,7 +2039,7 @@ origin while the card it was meant to cover was 1248x75.
2039
2039
  - `title: ReactNode` (required) — The title of notification
2040
2040
  - `description: ReactNode` — The description of notification
2041
2041
  - `icon: ReactNode` — The icon of notification
2042
- - `intent: FeedbackIntent` = "default" — The intent of notification
2042
+ - `intent: "default" | "info" | "success" | "warning" | "danger"` = "default" — The intent of notification
2043
2043
  @default "default"
2044
2044
  - `onClose: (id?: string) => void` — Callback when notification is closed
2045
2045
  - `closable: boolean` = true — Whether to show close button
@@ -2052,9 +2052,9 @@ origin while the card it was meant to cover was 1248x75.
2052
2052
  @default 0
2053
2053
  - `max: number` = 100 — Maximum value of the progress bar.
2054
2054
  @default 100
2055
- - `intent: IndicatorIntent` = "primary" — Intent (semantic color) of the bar.
2055
+ - `intent: "primary" | "success" | "warning" | "danger" | "info" | "neutral"` = "primary" — Intent (semantic color) of the bar.
2056
2056
  @default "primary"
2057
- - `size: Extract<ComponentSize, "sm" | "md" | "lg">` = "md" — Size of the bar.
2057
+ - `size: "sm" | "md" | "lg"` = "md" — Size of the bar.
2058
2058
  @default "md"
2059
2059
  - `label: string` — Text label displayed above the bar. Also used as the accessible name unless
2060
2060
  `aria-label` / `aria-labelledby` is given.
@@ -2071,9 +2071,9 @@ type therefore requires one of `label` / `aria-label` / `aria-labelledby`.
2071
2071
  @default 0
2072
2072
  - `max: number` = 100 — Maximum value of the progress ring.
2073
2073
  @default 100
2074
- - `intent: IndicatorIntent` = "primary" — Intent (semantic color) of the ring.
2074
+ - `intent: "primary" | "success" | "warning" | "danger" | "info" | "neutral"` = "primary" — Intent (semantic color) of the ring.
2075
2075
  @default "primary"
2076
- - `size: Extract<ComponentSize, "sm" | "md" | "lg">` = "md" — Size of the ring.
2076
+ - `size: "sm" | "md" | "lg"` = "md" — Size of the ring.
2077
2077
  @default "md"
2078
2078
  - `label: string` — Text label displayed below the ring. Also used as the accessible name unless
2079
2079
  `aria-label` / `aria-labelledby` is given.
@@ -2086,7 +2086,7 @@ type therefore requires one of `label` / `aria-label` / `aria-labelledby`.
2086
2086
  - `indeterminate: boolean` = false — If true, shows an indeterminate animation instead of a value.
2087
2087
  @default false
2088
2088
  - **Result** — Task status indicator
2089
- - `intent: Extract< WimIntent, "default" | "success" | "danger" | "info" | "warning" >` = "default" — Semantic intent — determines the icon and color. `default` draws no icon unless `icon` is passed.
2089
+ - `intent: "default" | "success" | "danger" | "info" | "warning"` = "default" — Semantic intent — determines the icon and color. `default` draws no icon unless `icon` is passed.
2090
2090
  @default "default"
2091
2091
  - `status: "404" | "403" | "500"` — HTTP error status — adds a status-specific CSS class and shows a neutral icon.
2092
2092
  Use for error pages (404, 403, 500).
@@ -2104,7 +2104,7 @@ follows the theme and never needs a hand-mixed colour.
2104
2104
  - `className: string` — Custom class name
2105
2105
  - `children: ReactNode` — The children
2106
2106
  - **ScrollProgress** — Reading progress indicator
2107
- - `intent: IndicatorIntent` = "primary" — 意味の軸。兄弟の `Progress` / `ProgressRing` と同じ語彙にそろえてある。
2107
+ - `intent: "primary" | "success" | "warning" | "danger" | "info" | "neutral"` = "primary" — 意味の軸。兄弟の `Progress` / `ProgressRing` と同じ語彙にそろえてある。
2108
2108
 
2109
2109
  以前は `color` という名前で、値も独自(`secondary` を含む)だった。
2110
2110
  塗っているものは `Progress.intent` と構造まで同一だったので、prop 名だけが
@@ -2127,7 +2127,7 @@ follows the theme and never needs a hand-mixed colour.
2127
2127
  - `message: string` (required) — Message displayed in the snackbar
2128
2128
  - `open: boolean` = false — Whether the snackbar is shown
2129
2129
  @default false
2130
- - `intent: FeedbackIntent` = "default" — Intent (semantic state)
2130
+ - `intent: "default" | "info" | "success" | "warning" | "danger"` = "default" — Intent (semantic state)
2131
2131
  @default "default"
2132
2132
  - `position: "top-left" | "top-center" | "top-right" | "bottom-left" | "bottom-center" | "bottom-right"` = "bottom-center" — Position on the screen
2133
2133
  @default "bottom-center"
@@ -2140,7 +2140,7 @@ follows the theme and never needs a hand-mixed colour.
2140
2140
  - `onClose: () => void` — Called when the snackbar is closed
2141
2141
  - `className: string` — Additional CSS class name
2142
2142
  - **Spinner** — A rotating icon indicating background activity or data fetching (aka Activity Indicator)
2143
- - `size: Extract<ComponentSize, "sm" | "md" | "lg" | "xl">` = "md" — Size of the spinner.
2143
+ - `size: "sm" | "md" | "lg" | "xl"` = "md" — Size of the spinner.
2144
2144
  @default "md"
2145
2145
  - `color: "currentColor" | WimColor` = "primary" — Color of the spinner. Accepts a design token color name or "currentColor".
2146
2146
  @default "primary"
@@ -2151,7 +2151,7 @@ follows the theme and never needs a hand-mixed colour.
2151
2151
  - `id: string` — Identifier of the toast, passed to onClose. Used by ToastProvider to manage a stack.
2152
2152
  - `title: string` — Title of the toast.
2153
2153
  - `description: string` — Description text displayed below the title.
2154
- - `intent: FeedbackIntent` = "default" — Intent (semantic state) of the toast.
2154
+ - `intent: "default" | "info" | "success" | "warning" | "danger"` = "default" — Intent (semantic state) of the toast.
2155
2155
  @default "default"
2156
2156
  - `duration: number` = 3000 — Time in milliseconds before the toast closes automatically. Set 0 to disable auto-close.
2157
2157
  @default 3000
@@ -2200,7 +2200,7 @@ follows the theme and never needs a hand-mixed colour.
2200
2200
  - **Breadcrumb** — Location trace (aka Path Bar, Path Control)
2201
2201
  - `items: BreadcrumbItem[]` (required) — Items to display, from the root to the current page.
2202
2202
  - `separator: React.ReactNode` — Separator displayed between items. Defaults to a chevron icon.
2203
- - `size: Extract<ComponentSize, "sm" | "md" | "lg">` = "md" — Size of the breadcrumb.
2203
+ - `size: "sm" | "md" | "lg"` = "md" — Size of the breadcrumb.
2204
2204
  @default "md"
2205
2205
  - `overflow: "wrap" | "collapse"` = "wrap" — What happens when the items do not fit on one line. `"wrap"` moves them onto more lines;
2206
2206
  `"collapse"` keeps the first item and the current page and folds the levels in between
@@ -2224,7 +2224,7 @@ into a "…" button that lists them.
2224
2224
  - `onOpenChange: (open: boolean) => void` — Called with the next open state: the opposite of `open` when the button is pressed, and
2225
2225
  false when Escape is pressed while the menu is open. Escape also moves focus back to the
2226
2226
  button. Without this callback the button cannot close on Escape, because `open` is controlled.
2227
- - `size: Extract<ComponentSize, "sm" | "md" | "lg">` = "md" — Size of the hamburger menu
2227
+ - `size: "sm" | "md" | "lg"` = "md" — Size of the hamburger menu
2228
2228
  - `color: string` — Color of the bars
2229
2229
  - `visibleBelow: "xs" | "sm" | "md" | "lg" | "xl"` — Show only below the given breakpoint (e.g. "md" matches Sidebar's mobile drawer range)
2230
2230
  - `className: string` — Custom class name
@@ -2240,13 +2240,13 @@ button. Without this callback the button cannot close on Escape, because `open`
2240
2240
  (既定 `div`)と同じ形。
2241
2241
  - `separator: string` = "+" — Separator displayed between keys
2242
2242
  @default "+"
2243
- - `size: Extract<ComponentSize, "sm" | "md" | "lg">` = "md" — Size of the list
2243
+ - `size: "sm" | "md" | "lg"` = "md" — Size of the list
2244
2244
  @default "md"
2245
2245
  - **Link** — Hyperlinks
2246
2246
  - `asChild: boolean` = false — If true, the link will be rendered as its child, merging its props onto that child.
2247
2247
  Useful for using the link styles with Link components from React Router or Next.js.
2248
2248
  - `label: React.ReactNode` — Link text or element. Alternative to children.
2249
- - `size: Extract<ComponentSize, "sm" | "md" | "lg">` = "md" — Font size of the link.
2249
+ - `size: "sm" | "md" | "lg"` = "md" — Font size of the link.
2250
2250
  @default "md"
2251
2251
  - `priority: "primary" | "secondary" | "tertiary"` = "primary" — Visual emphasis of the link.
2252
2252
  @default "primary"
@@ -2328,7 +2328,7 @@ scans stay green while the bar hangs outside its parent.
2328
2328
  - **TabNavigation** — Tab-based navigation
2329
2329
  - `variant: "underline" | "pill" | "contained"` = "underline" — Visual style of the tabs
2330
2330
  - `align: "start" | "center" | "end" | "justify"` = "start" — Alignment of the tabs
2331
- - `size: Extract<ComponentSize, "sm" | "md" | "lg">` = "md" — Size of the tabs
2331
+ - `size: "sm" | "md" | "lg"` = "md" — Size of the tabs
2332
2332
  - **Tabs** — A container to organize related content into switchable view panels
2333
2333
  - `asChild: boolean` = false — If true, the tabs root will be rendered as its child, merging its props onto that child.
2334
2334
  - `defaultValue: string` — Value of the tab selected initially, for uncontrolled usage.
@@ -2354,13 +2354,13 @@ scans stay green while the bar hangs outside its parent.
2354
2354
  - `alt: string` = "" — Alternative text for the image
2355
2355
  - `initials: string` — Initials shown as a fallback when no image is available
2356
2356
  - `icon: React.ReactNode` — Icon shown as a fallback when no image or initials are available
2357
- - `size: Extract<ComponentSize, "sm" | "md" | "lg">` = "md" — Size of the avatar
2357
+ - `size: "sm" | "md" | "lg"` = "md" — Size of the avatar
2358
2358
  - `shape: "circle" | "rounded"` = "circle" — Shape of the avatar
2359
- - `intent: IndicatorIntent` — Intent (semantic color) applied to the avatar
2359
+ - `intent: "primary" | "success" | "warning" | "danger" | "info" | "neutral"` — Intent (semantic color) applied to the avatar
2360
2360
  - **AvatarGroup** — Stacked avatars (aka Face Pile)
2361
2361
  - `children: React.ReactNode` (required) — Avatar elements to group
2362
2362
  - `max: number` — Maximum number of avatars to show before collapsing into a count. Ignored with `overflow="collapse"`.
2363
- - `size: Extract<ComponentSize, "sm" | "md" | "lg">` = "md" — Size applied to the avatars
2363
+ - `size: "sm" | "md" | "lg"` = "md" — Size applied to the avatars
2364
2364
  - `total: number` — Total number of avatars (used to compute the overflow count). Ignored with `overflow="collapse"`.
2365
2365
  - `overflow: "count" | "collapse"` = "count" — How the avatars that do not fit are handled. `"count"` cuts them by `max` / `total` and shows
2366
2366
  "+N" as text; `"collapse"` shows as many as fit the width and turns "+N" into a button that
@@ -2372,9 +2372,9 @@ lists the hidden people by name.
2372
2372
  - `children: React.ReactNode` — Content to display
2373
2373
  - `content: React.ReactNode` — Content to display (alternative to children)
2374
2374
  - `icon: React.ReactNode` — Icon
2375
- - `intent: IndicatorIntent` — Intent (semantic state)
2375
+ - `intent: "primary" | "success" | "warning" | "danger" | "info" | "neutral"` — Intent (semantic state)
2376
2376
  - `variant: "solid" | "outline" | "subtle"` — Visual style variant
2377
- - `size: Extract<ComponentSize, "sm" | "md" | "lg">` — Size
2377
+ - `size: "sm" | "md" | "lg"` — Size
2378
2378
  - `interactive: boolean` = false — Whether to enable the interactive state
2379
2379
  - **Barcode** — Draws a scannable Code 128 or EAN-13 barcode.
2380
2380
  - `value: string` (required) — Value to encode. For `ean13`, 12 digits (the check digit is calculated) or
@@ -2462,9 +2462,9 @@ Cannot be combined with `onDelete` (T99).
2462
2462
  - `icon: React.ReactNode` — Icon
2463
2463
  - `selected: boolean` = false — Whether the chip is selected
2464
2464
  - `disabled: boolean` = false — Whether the chip is disabled
2465
- - `intent: IndicatorIntent` = "neutral" — Intent (semantic state)
2465
+ - `intent: "primary" | "success" | "warning" | "danger" | "info" | "neutral"` = "neutral" — Intent (semantic state)
2466
2466
  - `variant: "solid" | "outline" | "subtle"` = "solid" — Visual style variant
2467
- - `size: Extract<ComponentSize, "sm" | "md" | "lg">` = "md" — Size
2467
+ - `size: "sm" | "md" | "lg"` = "md" — Size
2468
2468
  - `deleteAriaLabel: string` — Accessible label for the delete button
2469
2469
  - `className: string` — Additional class names
2470
2470
  - **Comment** — Shows one comment in a discussion, with its actions and nested replies.
@@ -2499,7 +2499,7 @@ that instant (useful for snapshots and tests).
2499
2499
  - `variant: "digital" | "units"` = "digital" — "digital" renders a compact colon-separated clock (04:12:33);
2500
2500
  "units" renders one labeled segment per unit (days / hours / min / sec).
2501
2501
  @default "digital"
2502
- - `size: Extract<ComponentSize, "sm" | "md" | "lg">` = "md" — Size of the numbers and labels.
2502
+ - `size: "sm" | "md" | "lg"` = "md" — Size of the numbers and labels.
2503
2503
  @default "md"
2504
2504
  - `locale: string` — BCP 47 locale override for unit labels (e.g. "en", "ja", "pt-BR").
2505
2505
  @default current i18next language
@@ -2546,7 +2546,7 @@ drops secondary text below the AA contrast floor.
2546
2546
  - `children: React.ReactNode` (required) — DescriptionListItem elements
2547
2547
  - `className: string` — Additional class names
2548
2548
  - `layout: "horizontal" | "vertical" | "compact"` = "horizontal" — Layout of terms and descriptions
2549
- - `size: Extract<ComponentSize, "sm" | "md" | "lg">` = "md" — Size of the text
2549
+ - `size: "sm" | "md" | "lg"` = "md" — Size of the text
2550
2550
  - `border: boolean` = false — Whether to show borders (alias of bordered)
2551
2551
  - `bordered: boolean` = false — Whether to show borders
2552
2552
  - **EmptyState** — Missing data placeholder (aka Blank Slate, Zero State)
@@ -2573,7 +2573,7 @@ in; use `"center"` only when the empty state is the only thing in its region.
2573
2573
  - `hasMore: boolean` = false — Whether there is more data to load.
2574
2574
  - `loading: boolean` = false — Whether data is currently loading.
2575
2575
  - `onLoadMore: () => void` (required) — Callback to load the next batch of data.
2576
- - `loader: React.ReactNode` — Element shown while loading.
2576
+ - `loader: React.ReactNode` — Element shown while loading. Defaults to a spinner with a localized "Loading more…" text. Its text is announced to screen readers when loading starts.
2577
2577
  - `threshold: number` = 250 — Scroll threshold (px). onLoadMore is called when the scroll position gets this close to the bottom.
2578
2578
  - `className: string` — Additional class names.
2579
2579
  - `container: React.RefObject<HTMLElement | null>` — Target whose scroll events are observed (defaults to window).
@@ -2598,11 +2598,11 @@ in; use `"center"` only when the empty state is the only thing in its region.
2598
2598
  - **Leaderboard** — Display a ranked list of entries with scores. Medal colors for the top three are opt-in.
2599
2599
  - `entries: LeaderboardEntry[]` (required) — List of ranking entries
2600
2600
  - `unit: string` — Label for the score unit
2601
- - `size: Extract<ComponentSize, "sm" | "md" | "lg">` = "md" — Size
2601
+ - `size: "sm" | "md" | "lg"` = "md" — Size
2602
2602
  - `showMedals: boolean` = false — Whether to paint the rank badges of the top three in gold, silver and bronze (off by default: the number and the order already say the rank)
2603
2603
  - **List** — Structurally organized items in bullet points or numbered formats
2604
2604
  - `asChild: boolean` = false — Whether to render as a child element.
2605
- - `size: Extract<ComponentSize, "sm" | "md" | "lg">` = "md" — Size of the list items
2605
+ - `size: "sm" | "md" | "lg"` = "md" — Size of the list items
2606
2606
  - `spacing: "tight" | "normal" | "loose"` = "normal" — Spacing between items
2607
2607
  - `bordered: boolean` = false — Whether to show borders between items
2608
2608
  - `fullWidth: boolean` = false — Whether to take full width of parent
@@ -2678,7 +2678,7 @@ with empty spacer rows. Use it for tables with hundreds of rows, together with
2678
2678
  - `showLabel: boolean` = false — Whether the label is shown next to the dot. The label is always exposed to
2679
2679
  assistive technology; this only controls whether it is also visible.
2680
2680
  @default false
2681
- - `size: Extract<ComponentSize, "sm" | "md" | "lg">` = "md" — Size of the dot.
2681
+ - `size: "sm" | "md" | "lg"` = "md" — Size of the dot.
2682
2682
  @default "md"
2683
2683
  - `position: "top-right" | "top-left" | "bottom-right" | "bottom-left"` = "bottom-right" — Corner the dot is placed at. Only applies when `children` is given.
2684
2684
  @default "bottom-right"
@@ -2718,7 +2718,7 @@ renders inline, next to whatever follows it.
2718
2718
  - `onReact: (emoji: string, active: boolean) => void` — Callback when a reaction is added or removed
2719
2719
  - `showAddButton: boolean` = false — Whether to show the add button
2720
2720
  - `onAdd: () => void` — Callback when the add button is clicked
2721
- - `size: Extract<ComponentSize, "sm" | "md" | "lg">` = "md" — Size
2721
+ - `size: "sm" | "md" | "lg"` = "md" — Size
2722
2722
  - `disabled: boolean` = false — Whether the component is disabled
2723
2723
  - **RelativeTime** — Display a timestamp as a localized relative phrase ("3 minutes ago", "yesterday") that updates automatically as time passes.
2724
2724
  - `date: Date | string | number` (required) — The date to display, as a Date object, ISO 8601 string, or epoch milliseconds.
@@ -2817,9 +2817,9 @@ Cannot be combined with `onDelete` — the delete control is a second element, a
2817
2817
  `asChild` requires a single React element child (T99).
2818
2818
  - `children: React.ReactNode` — Content to display
2819
2819
  - `content: React.ReactNode` — Content to display (alternative to children)
2820
- - `intent: IndicatorIntent` — Intent (semantic state)
2820
+ - `intent: "primary" | "success" | "warning" | "danger" | "info" | "neutral"` — Intent (semantic state)
2821
2821
  - `variant: "solid" | "outline" | "subtle"` — Visual style variant
2822
- - `size: Extract<ComponentSize, "sm" | "md" | "lg">` — Size
2822
+ - `size: "sm" | "md" | "lg"` — Size
2823
2823
  - `icon: React.ReactNode` — Icon
2824
2824
  - `onDelete: (e: React.MouseEvent<HTMLButtonElement>) => void` — Delete event. When provided, a × button is shown. Incompatible with `asChild`.
2825
2825
  - `disabled: boolean` — Whether the tag is disabled
@@ -2957,7 +2957,7 @@ dismissed by an outside click or Escape.
2957
2957
  - `onCancel: () => void` — Callback when the user clicks the cancel button
2958
2958
  - `okText: ReactNode` = "OK" — Text of the confirm button
2959
2959
  - `cancelText: ReactNode` = "Cancel" — Text of the cancel button
2960
- - `okType: ButtonIntent` = "default" — Color role of the confirm button
2960
+ - `okType: "default" | "danger" | "success"` = "default" — Color role of the confirm button
2961
2961
  - `children: ReactNode` (required) — The target element which the Popconfirm will be attached to
2962
2962
  - `icon: ReactNode` — Customize the icon
2963
2963
  - `disabled: boolean` = false — Whether to show the popconfirm
@@ -2967,7 +2967,7 @@ dismissed by an outside click or Escape.
2967
2967
  - `defaultOpen: boolean` = false — If true, the popover component will manage its own open state.
2968
2968
  - `open: boolean` — If provided, controls the open state.
2969
2969
  - `onOpenChange: (open: boolean) => void` — Callback when open state changes.
2970
- - `placement: Placement` = "bottom-start" — Preferred placement of the popover.
2970
+ - `placement: "bottom" | "bottom-end" | "bottom-start" | "left" | "left-end" | "left-start" | "right" | "right-end" | "right-start" | "top" | "top-end" | "top-start"` = "bottom-start" — Preferred placement of the popover.
2971
2971
  - `variant: "default" | "glass"` = "default" — The variant of the popover content.
2972
2972
  - **Portal** — Out-of-hierarchy render
2973
2973
  - `children: React.ReactNode` (required) — The content to be rendered in the portal
@@ -2978,14 +2978,14 @@ dismissed by an outside click or Escape.
2978
2978
  - `delay: number` = 200 — Delay before showing the tooltip in ms.
2979
2979
  - `open: boolean` — If provided, controls the open state.
2980
2980
  - `onOpenChange: (open: boolean) => void` — Callback when open state changes.
2981
- - `placement: Placement` = "top" — Preferred placement of the tooltip.
2981
+ - `placement: "bottom" | "bottom-end" | "bottom-start" | "left" | "left-end" | "left-start" | "right" | "right-end" | "right-start" | "top" | "top-end" | "top-start"` = "top" — Preferred placement of the tooltip.
2982
2982
  - `variant: "default" | "glass"` = "default" — The variant of the tooltip content.
2983
2983
 
2984
2984
  ### typography — `import { … } from "wimui/typography"`
2985
2985
 
2986
2986
  - **Blockquote** — Visually separates external quotes or text to be emphasized.
2987
2987
  - `asChild: boolean` = false — If true, the blockquote will be rendered as its child, merging its props onto that child.
2988
- - `size: Extract<ComponentSize, "sm" | "md" | "lg">` = "md" — Font size of the quote.
2988
+ - `size: "sm" | "md" | "lg"` = "md" — Font size of the quote.
2989
2989
  @default "md"
2990
2990
  - `color: T | (string & {})` — Text color. Accepts a design token color name or any CSS color value.
2991
2991
  - `content: React.ReactNode` — Quoted content. Alternative to children.
@@ -3008,7 +3008,7 @@ dismissed by an outside click or Escape.
3008
3008
  - `asChild: boolean` = false — If true, the component will be rendered as its child.
3009
3009
  - **Kbd** — Keyboard shortcuts
3010
3010
  - `asChild: boolean` = false — If true, the Kbd will be rendered as its child, merging its props onto that child.
3011
- - `size: Extract<ComponentSize, "sm" | "md" | "lg">` = "md" — Size of the key cap.
3011
+ - `size: "sm" | "md" | "lg"` = "md" — Size of the key cap.
3012
3012
  @default "md"
3013
3013
  - `children: React.ReactNode` — Key label(s) to display.
3014
3014
  - **Label** — Descriptive text for input fields, including required/optional marks
@@ -3039,10 +3039,10 @@ Defaults to the localized `form.optional` string.
3039
3039
  - `asChild: boolean` = false — If true, the Legend will be rendered as its child, merging its props onto that child.
3040
3040
  - **Span** — Lightweight wrapper for inline text or short labels with icon support
3041
3041
  - `asChild: boolean` = false — If true, the span will be rendered as its child, merging its props onto that child.
3042
- - `size: Extract<ComponentSize, "xs" | "sm" | "md" | "lg" | "xl">` = "md" — Font size of the text.
3042
+ - `size: "xs" | "sm" | "md" | "lg" | "xl"` = "md" — Font size of the text.
3043
3043
  @default "md"
3044
3044
  - `color: T | (string & {})` — Text color. Accepts a design token color name or any CSS color value.
3045
- - `weight: WimFontWeightKey` = "normal" — Font weight.
3045
+ - `weight: "bold" | "medium" | "normal" | "semibold"` = "normal" — Font weight.
3046
3046
  @default "normal"
3047
3047
  - `fontStyle: "normal" | "italic"` = "normal" — Font style.
3048
3048
  @default "normal"
@@ -3065,10 +3065,10 @@ Defaults to the localized `form.optional` string.
3065
3065
  @default t("spoiler.show_less")
3066
3066
  - **Text** — Has appropriate line-height and spacing to ensure readability of long text.
3067
3067
  - `asChild: boolean` = false — If true, the text will be rendered as its child, merging its props onto that child.
3068
- - `size: Extract<ComponentSize, "xs" | "sm" | "md" | "lg" | "xl">` = "md" — Font size of the text.
3068
+ - `size: "xs" | "sm" | "md" | "lg" | "xl"` = "md" — Font size of the text.
3069
3069
  @default "md"
3070
3070
  - `color: T | (string & {})` — Text color. Accepts a design token color name or any CSS color value.
3071
- - `weight: WimFontWeightKey` = "normal" — Font weight.
3071
+ - `weight: "bold" | "medium" | "normal" | "semibold"` = "normal" — Font weight.
3072
3072
  @default "normal"
3073
3073
  - `lineHeight: T | (string & {})` — Line height. Accepts a design token name or any CSS line-height value.
3074
3074
  - `fontStyle: "normal" | "italic"` = "normal" — Font style.
@@ -3164,7 +3164,7 @@ Ignored when `truncate` is set (one line wins; they cannot both apply).
3164
3164
  - `backdropFilter: ImageFilterOptions` — Filter applied to the background (effective with transparent images)
3165
3165
  - `hoverBackdropFilter: ImageFilterOptions` — Filter applied to the background on hover
3166
3166
  - `transition: "none" | "fast" | "normal" | "slow"` = "normal" — Animation speed when switching filters
3167
- - `noise: ComponentSize | "none"` — Intensity of the film-grain (noise) effect
3167
+ - `noise: ("xs" | "sm" | "md" | "lg" | "xl" | "2xl" | "3xl" | "4xl" | "5xl") | "none"` — Intensity of the film-grain (noise) effect
3168
3168
  - `duotone: ImageDuotoneOptions` — Duotone settings
3169
3169
  - `overlay: ImageOverlayOptions` — Overlay settings
3170
3170
  - `zoom: boolean | number` = false — Zoom factor on hover (e.g. 1.1) or true (defaults to 1.05)
@@ -3471,13 +3471,13 @@ enough on its own.
3471
3471
  - **AgentStatus** — Real-time agent state indicator (thinking / running / waiting)
3472
3472
  - `status: "idle" | "thinking" | "running" | "waiting" | "done" | "error"` (required) — Current state of the agent
3473
3473
  - `message: string` — Optional description of what the agent is doing; falls back to the localized status label
3474
- - `size: Extract<ComponentSize, "sm" | "md" | "lg">` = "md" — Size variant
3474
+ - `size: "sm" | "md" | "lg"` = "md" — Size variant
3475
3475
  - `showLabel: boolean` = true — Whether to show the text label next to the indicator
3476
3476
  - `className: string` — Additional CSS class
3477
3477
  - **AIResponseFeedback** — Thumbs-up/down feedback controls and regenerate button for AI responses.
3478
- - `feedback: AIFeedbackValue | null` — Currently selected feedback value (controlled)
3479
- - `defaultFeedback: AIFeedbackValue | null` = null — Default feedback value (uncontrolled)
3480
- - `onFeedback: (value: AIFeedbackValue | null) => void` — Called when user clicks a feedback button. Passes null when deselected.
3478
+ - `feedback: ("positive" | "negative") | null` — Currently selected feedback value (controlled)
3479
+ - `defaultFeedback: ("positive" | "negative") | null` = null — Default feedback value (uncontrolled)
3480
+ - `onFeedback: (value: ("positive" | "negative") | null) => void` — Called when user clicks a feedback button. Passes null when deselected.
3481
3481
  - `showRegenerate: boolean` = false — Whether to show the regenerate button
3482
3482
  - `onRegenerate: () => void` — Called when the regenerate button is clicked
3483
3483
  - `disabled: boolean` = false — Whether all buttons are disabled
@@ -3533,7 +3533,7 @@ written in the markdown. Default `"2xl"` keeps the historical mapping
3533
3533
  - `value: string` — Selected model id (controlled)
3534
3534
  - `defaultValue: string` — Initially selected model id (uncontrolled)
3535
3535
  - `onChange: (id: string, model: ModelOption) => void` — Callback when the selected model changes
3536
- - `size: Extract<ComponentSize, "sm" | "md" | "lg">` = "md" — Size of the trigger
3536
+ - `size: "sm" | "md" | "lg"` = "md" — Size of the trigger
3537
3537
  - `disabled: boolean` = false — Whether the selector is disabled
3538
3538
  - `fullWidth: boolean` = false — Whether to take full width of parent
3539
3539
  - `showPricing: boolean` = true — Whether to show pricing metadata in the dropdown
@@ -3604,7 +3604,7 @@ page: under an `h1` use `2`, under an `h3` use `4`. Has no effect when
3604
3604
  - **UsageMeter** — UsageMeter (also exported as TokenCounter) visualizes token consumption against a budget such as a model's context window — a labeled bar plus a numeric readout that shifts to warning and danger colors near the limit. (aka Level Indicator, Capacity Indicator, Meter)
3605
3605
  - `used: number` (required) — Number of tokens used so far
3606
3606
  - `max: number` — Maximum available tokens (e.g. the context window). Omit for a counter-only display.
3607
- - `size: Extract<ComponentSize, "sm" | "md" | "lg">` = "md" — Size of the meter
3607
+ - `size: "sm" | "md" | "lg"` = "md" — Size of the meter
3608
3608
  - `showBar: boolean` = true — Whether to render the progress bar (requires `max`)
3609
3609
  - `showPercentage: boolean` = false — Whether to show the percentage instead of the raw count in the readout
3610
3610
  - `warnThreshold: number` = 0.75 — Fraction (0–1) at which the meter turns to the warning color
@@ -3639,4 +3639,7 @@ These exist in other systems' vocabularies and are **decisions, not gaps**. Do n
3639
3639
  - **Parallax Scrolling** (aka Parallax, Scroll Parallax, Parallax Hero) — Backgrounds moving at a different speed from the foreground. The motion does not correspond to any change of state, which is what this system animates. If the goal is to show scroll position, show the position. Use `ScrollProgress` instead.
3640
3640
  - **Text Scramble** (aka Scramble Text, Decrypt Text, Glitch Text) — Randomising characters before settling on the real string. The reader parses the same sentence twice and gets nothing for the lost legibility. The one case where text legitimately arrives character by character is model output, which StreamingText already covers. Use `StreamingText` instead.
3641
3641
  - **Spring Animation** (aka Spring Physics, Springs, Physics-based Animation) — A physics engine (mass / stiffness / damping props solved in a rAF loop). The bounce curve itself already exists as the `--wim-easing-spring` token, which is what press and swipe-return use. Adding the engine would put physics parameters into the public contract and move motion from CSS to JS. Use `--wim-easing-spring` instead.
3642
- - **Choropleth Map** (aka Choropleth, Filled Map, Region Map, Geo Map) — A map shading regions by value. Shipping boundary data would put its size and a political stance on disputed borders into a UI library, and large regions dominate regardless of their values. Regions are compared more accurately in a sorted bar chart. Use `BarChart` instead.
3642
+ - **Choropleth Map** (aka Choropleth, Filled Map, Region Map, Geo Map) — A map shading regions by value. Shipping boundary data would put its size and a political stance on disputed borders into a UI library, and large regions dominate regardless of their values. Regions are compared more accurately in a sorted bar chart. Use `BarChart` instead.
3643
+
3644
+ ---
3645
+ **One component, matching your installed version:** the package ships `dist/llms/<Component>.md` — every prop with its type and default, its sub-components, and the design tokens it reads (e.g. `node_modules/wimui/dist/llms/Select.md`, also exported as `wimui/llms/Select.md`). The hosted copy of this file tracks main and can be ahead of the release you installed.