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
@@ -0,0 +1,31 @@
1
+ # QueryBuilder — wimui
2
+
3
+ > Visual builder for constructing complex search queries.
4
+
5
+ ## Import
6
+
7
+ ```ts
8
+ import "wimui/styles.css"; // once per app — required
9
+ import { QueryBuilder } from "wimui/form";
10
+ ```
11
+
12
+ ## Props
13
+
14
+ - `fields: QueryField[]` (required) — Field definitions
15
+ - `query: QueryGroup` — Current query state (controlled)
16
+ - `defaultQuery: QueryGroup` — Default query state (uncontrolled)
17
+ - `onChange: (query: QueryGroup) => void` — Callback when query changes
18
+ - `maxDepth: number` = 3 — Maximum nesting depth
19
+ - `className: string` — Additional class name
20
+ - `id: string` — Unique ID for the component
21
+ - `labels: QueryBuilderLabels` = {} — Labels for internationalization
22
+ - `aria-label: string` — Accessible name for the query builder region. Takes precedence over `labels.regionAriaLabel`.
23
+ - `aria-labelledby: string` — ID of the element that labels the query builder region. Takes precedence over `aria-label`.
24
+ - `aria-describedby: string` — ID of the element that describes the query builder region.
25
+
26
+ ## Design tokens it reads
27
+
28
+ `--wim-border-width-thin`, `--wim-color-border`, `--wim-color-border-secondary`, `--wim-color-danger`, `--wim-color-primary`, `--wim-color-primary-soft`, `--wim-color-surface`, `--wim-color-surface-hover`, `--wim-color-surface-variant`, `--wim-duration-base`, `--wim-duration-fast`, `--wim-easing-entrance`, `--wim-easing-standard`, `--wim-focus-outline-offset`, `--wim-height-md`, `--wim-input-width`, `--wim-radius-container`, `--wim-spacing-2xs`, `--wim-spacing-3xs`, `--wim-spacing-lg`, `--wim-spacing-md`, `--wim-spacing-sm`, `--wim-spacing-xl`, `--wim-transition-fast`, `--wim-width-sm`
29
+
30
+ ---
31
+ Setup, composition rules and the full catalog: `llms.txt` / `llms-full.txt` in the same package.
@@ -0,0 +1,24 @@
1
+ # RadarChart — wimui
2
+
3
+ > Multivariate data on concentric axes chart
4
+
5
+ ## Import
6
+
7
+ ```ts
8
+ import "wimui/styles.css"; // once per app — required
9
+ import { RadarChart } from "wimui/charts";
10
+ ```
11
+
12
+ ## Props
13
+
14
+ - `data: ChartDataPoint[]` (required) — Data to display in the chart.
15
+ - `keys: string[]` (required) — Keys in the data objects to render as radar areas (series).
16
+ - `indexKey: string` (required) — The key in the data objects used for the axis (category) labels.
17
+ - `height: number` = 300 — The height of the chart in pixels. @default 300
18
+ - `width: string | number` = "100%" — The width of the chart (e.g., "100%", 500). @default "100%"
19
+ - `title: string` — Optional title displayed above the chart.
20
+ - `animated: boolean` = false — If true, animates the chart on mount. @default false
21
+ - `aria-label: string` — Accessible name for the chart. Defaults to `title` when omitted; pass this when the chart has no visible title, or when the title is not descriptive enough on its own.
22
+
23
+ ---
24
+ Setup, composition rules and the full catalog: `llms.txt` / `llms-full.txt` in the same package.
@@ -0,0 +1,23 @@
1
+ # Radio — wimui
2
+
3
+ > Single choice
4
+
5
+ ## Import
6
+
7
+ ```ts
8
+ import "wimui/styles.css"; // once per app — required
9
+ import { Radio } from "wimui/form";
10
+ ```
11
+
12
+ ## Props
13
+
14
+ - `asChild: boolean` = false — Whether to render as a child element.
15
+ - `children: React.ReactNode` — Label content rendered next to the radio
16
+ - `error: boolean` = false — Whether to display as an error state (aria-invalid is not supported on the radio role, so it is applied on the RadioGroup side)
17
+
18
+ ## Design tokens it reads
19
+
20
+ `--wim-border-width-thick`, `--wim-color-danger`, `--wim-color-disabled`, `--wim-color-focus-outline`, `--wim-color-primary`, `--wim-color-text-danger`, `--wim-color-text-on-disabled`, `--wim-color-text-primary`, `--wim-color-text-tertiary`, `--wim-duration-base`, `--wim-easing-standard`, `--wim-font-family-default`, `--wim-font-size-md`, `--wim-line-height-normal`, `--wim-opacity-disabled`, `--wim-radio-dot-size`, `--wim-radio-size`, `--wim-radius-full`, `--wim-shadow-error-ring`, `--wim-shadow-focus`, `--wim-spacing-md`, `--wim-spacing-sm`, `--wim-tap-target-min`
21
+
22
+ ---
23
+ Setup, composition rules and the full catalog: `llms.txt` / `llms-full.txt` in the same package.
@@ -0,0 +1,32 @@
1
+ # RadioGroup — wimui
2
+
3
+ > Shared state radio buttons
4
+
5
+ ## Import
6
+
7
+ ```ts
8
+ import "wimui/styles.css"; // once per app — required
9
+ import { RadioGroup } from "wimui/form";
10
+ ```
11
+
12
+ ## Props
13
+
14
+ - `options: Option[]` (required) — List of radio options
15
+ - `value: string` — Selected value (controlled)
16
+ - `defaultValue: string` — Initially selected value (uncontrolled)
17
+ - `onChange: (value: string) => void` — Callback when the selected value changes
18
+ - `direction: "vertical" | "horizontal"` = "vertical" — Layout direction of the radio buttons
19
+ - `variant: "default" | "card"` = "default" — `card` draws each option as a bordered card that is selectable as a whole (the card is the option's `<label>`). Keys and group semantics stay those of a radio group. Use with `description` when the options need explaining. @default "default"
20
+ - `name: string` — Name attribute shared by the radio inputs
21
+ - `asChild: boolean` = false — Whether to render as a child element.
22
+ - `label: string` — Group label
23
+ - `error: string` — Error message
24
+ - `required: boolean` — Whether to show the required indicator
25
+ - `disabled: boolean` — Whether the whole group is disabled
26
+
27
+ ## Design tokens it reads
28
+
29
+ `--wim-spacing-lg`, `--wim-spacing-md`, `--wim-spacing-sm`, `--wim-width-sm`
30
+
31
+ ---
32
+ Setup, composition rules and the full catalog: `llms.txt` / `llms-full.txt` in the same package.
@@ -0,0 +1,26 @@
1
+ # RangeCalendar — wimui
2
+
3
+ > Range calendar view
4
+
5
+ ## Import
6
+
7
+ ```ts
8
+ import "wimui/styles.css"; // once per app — required
9
+ import { RangeCalendar } from "wimui/data-display";
10
+ ```
11
+
12
+ ## Props
13
+
14
+ - `value: [Date | null, Date | null]` — 現在選択されている範囲 [開始日, 終了日]。
15
+ - `onChange: (value: RangeCalendarValue) => void` — 範囲が変更された時のコールバック。
16
+ - `defaultValue: [Date | null, Date | null]` — 初期値。
17
+ - `className: string` — 追加のクラス名。
18
+ - `disabled: boolean` = false — 無効化。
19
+ - `minDate: Date` — 選択可能な最小日付。
20
+ - `maxDate: Date` — 選択可能な最大日付。
21
+ - `disabledDates: Date[]` — 無効化する日付の配列。
22
+ - `isDateDisabled: (date: Date) => boolean` — 特定の日付を無効化する関数。
23
+ - `weekStartsOn: 0 | 1` — 週の開始曜日。0 = 日曜始まり、1 = 月曜始まり。デフォルトは 0。
24
+
25
+ ---
26
+ Setup, composition rules and the full catalog: `llms.txt` / `llms-full.txt` in the same package.
@@ -0,0 +1,39 @@
1
+ # RangeSlider — wimui
2
+
3
+ > Range selection
4
+
5
+ ## Import
6
+
7
+ ```ts
8
+ import "wimui/styles.css"; // once per app — required
9
+ import { RangeSlider } from "wimui/form";
10
+ ```
11
+
12
+ ## Props
13
+
14
+ - `value: [number, number]` — Current value [min, max] (controlled)
15
+ - `defaultValue: [number, number]` = [20, 80] — Default value [min, max] (uncontrolled)
16
+ - `min: number` = 0 — Minimum value
17
+ - `max: number` = 100 — Maximum value
18
+ - `step: number` = 1 — Step value
19
+ - `allowCross: boolean` = false — Whether both handles may hold the same value (they never cross)
20
+ - `disabled: boolean` = false — Whether the slider is disabled
21
+ - `onChange: (value: [number, number]) => void` — Callback when the value changes
22
+ - `onAfterChange: (value: [number, number]) => void` — Callback when dragging ends
23
+ - `className: string` — Additional class names
24
+ - `name: string` — Name attribute
25
+ - `label: string` — Accessible label
26
+ - `error: string` — Error message
27
+ - `required: boolean` — Whether to show the required indicator
28
+ - `layout: "vertical" | "horizontal"` = "vertical" — Layout direction of label and field
29
+ - `id: string` — Custom ID
30
+ - `aria-label: string` — Accessible label when no visible label is provided
31
+ - `aria-labelledby: string` — ID of the element that labels the slider
32
+ - `asChild: boolean` = false — Whether to render as a child element.
33
+
34
+ ## Design tokens it reads
35
+
36
+ `--wim-border-width-thick`, `--wim-color-border-secondary`, `--wim-color-danger`, `--wim-color-focus-outline`, `--wim-color-ghost-border-hover`, `--wim-color-primary`, `--wim-color-white`, `--wim-duration-extra-fast`, `--wim-duration-fast`, `--wim-easing-standard`, `--wim-focus-outline-width`, `--wim-height-xs`, `--wim-opacity-ghost`, `--wim-radius-full`, `--wim-shadow-sm`, `--wim-tap-target-min`
37
+
38
+ ---
39
+ Setup, composition rules and the full catalog: `llms.txt` / `llms-full.txt` in the same package.
@@ -0,0 +1,37 @@
1
+ # Rating — wimui
2
+
3
+ > Star rating
4
+
5
+ Also known as: Star Rating, Rating Indicator
6
+
7
+ ## Import
8
+
9
+ ```ts
10
+ import "wimui/styles.css"; // once per app — required
11
+ import { Rating } from "wimui/form";
12
+ ```
13
+
14
+ ## Props
15
+
16
+ - `value: number` — Current value (controlled)
17
+ - `defaultValue: number` = 0 — Default value (uncontrolled)
18
+ - `count: number` = 5 — Total number of stars
19
+ - `allowHalf: boolean` = false — Whether to allow half stars
20
+ - `disabled: boolean` = false — Whether the rating is disabled
21
+ - `readOnly: boolean` = false — Read-only flag (display only; unlike disabled it is not grayed out)
22
+ - `size: "sm" | "md" | "lg"` = "md" — Size of the stars
23
+ - `onChange: (value: number) => void` — Callback when the value changes
24
+ - `className: string` — Additional class names
25
+ - `label: React.ReactNode` — Accessible label
26
+ - `error: string` — Error message
27
+ - `required: boolean` — Whether to show the required indicator
28
+ - `layout: "vertical" | "horizontal"` = "vertical" — Layout direction of label and field
29
+ - `labels: { star?: (count: number) => string; readonly?: (value: number, max: number) => string; }` = {} — Labels for internationalization
30
+ - `asChild: boolean` = false — Whether to render as a child element.
31
+
32
+ ## Design tokens it reads
33
+
34
+ `--wim-border-width-thick`, `--wim-color-border`, `--wim-color-text-tertiary`, `--wim-color-warning`, `--wim-height-md`, `--wim-height-sm`, `--wim-rating-star-size`, `--wim-spacing-2xs`, `--wim-spacing-sm`, `--wim-tap-target-min`, `--wim-transition-fast`
35
+
36
+ ---
37
+ Setup, composition rules and the full catalog: `llms.txt` / `llms-full.txt` in the same package.
@@ -0,0 +1,26 @@
1
+ # Reaction — wimui
2
+
3
+ > Display emoji reaction buttons with toggleable state and counts
4
+
5
+ ## Import
6
+
7
+ ```ts
8
+ import "wimui/styles.css"; // once per app — required
9
+ import { Reaction } from "wimui/data-display";
10
+ ```
11
+
12
+ ## Props
13
+
14
+ - `reactions: ReactionItem[]` (required) — List of reactions
15
+ - `onReact: (emoji: string, active: boolean) => void` — Callback when a reaction is added or removed
16
+ - `showAddButton: boolean` = false — Whether to show the add button
17
+ - `onAdd: () => void` — Callback when the add button is clicked
18
+ - `size: "sm" | "md" | "lg"` = "md" — Size
19
+ - `disabled: boolean` = false — Whether the component is disabled
20
+
21
+ ## Design tokens it reads
22
+
23
+ `--wim-border-width-thin`, `--wim-color-border`, `--wim-color-primary`, `--wim-color-surface`, `--wim-color-text-accent`, `--wim-color-text-secondary`, `--wim-color-text-tertiary`, `--wim-font-size-md`, `--wim-font-size-sm`, `--wim-font-size-xs`, `--wim-font-weight-medium`, `--wim-opacity-disabled`, `--wim-radius-full`, `--wim-scale-active`, `--wim-spacing-2xs`, `--wim-spacing-3xs`, `--wim-spacing-md`, `--wim-spacing-sm`, `--wim-spacing-xs`, `--wim-tap-target-min`, `--wim-transition-base`
24
+
25
+ ---
26
+ Setup, composition rules and the full catalog: `llms.txt` / `llms-full.txt` in the same package.
@@ -0,0 +1,13 @@
1
+ # RefTable — wimui
2
+
3
+ > Property and argument reference table
4
+
5
+ ## Import
6
+
7
+ ```ts
8
+ import "wimui/styles.css"; // once per app — required
9
+ import { RefTable } from "wimui";
10
+ ```
11
+
12
+ ---
13
+ Setup, composition rules and the full catalog: `llms.txt` / `llms-full.txt` in the same package.
@@ -0,0 +1,24 @@
1
+ # RelativeTime — wimui
2
+
3
+ > Display a timestamp as a localized relative phrase ("3 minutes ago", "yesterday") that updates automatically as time passes.
4
+
5
+ ## Import
6
+
7
+ ```ts
8
+ import "wimui/styles.css"; // once per app — required
9
+ import { RelativeTime } from "wimui/data-display";
10
+ ```
11
+
12
+ ## Props
13
+
14
+ - `date: Date | string | number` (required) — The date to display, as a Date object, ISO 8601 string, or epoch milliseconds.
15
+ - `baseDate: Date | string | number` — Reference point used as "now". When set, live updates are disabled. @default current time
16
+ - `locale: string` — BCP 47 locale override (e.g. "en", "ja", "pt-BR"). @default current i18next language
17
+ - `numeric: Intl.RelativeTimeFormatNumeric` = "auto" — "auto" allows idiomatic phrases like "yesterday"; "always" always uses numbers ("1 day ago"). @default "auto"
18
+ - `format: Intl.RelativeTimeFormatStyle` = "long" — Length of the formatted message ("long" | "short" | "narrow"). @default "long"
19
+ - `live: boolean` = true — Automatically re-render as time passes. Ignored when baseDate is set. @default true
20
+ - `fallback: React.ReactNode` — Content shown when the date cannot be parsed.
21
+ - `asChild: boolean` = false — If true, the component will be rendered as its child, merging its props onto that child.
22
+
23
+ ---
24
+ Setup, composition rules and the full catalog: `llms.txt` / `llms-full.txt` in the same package.
@@ -0,0 +1,29 @@
1
+ # Result — wimui
2
+
3
+ > Task status indicator
4
+
5
+ ## Import
6
+
7
+ ```ts
8
+ import "wimui/styles.css"; // once per app — required
9
+ import { Result } from "wimui/feedback";
10
+ ```
11
+
12
+ ## Props
13
+
14
+ - `intent: "default" | "success" | "danger" | "info" | "warning"` = "default" — Semantic intent — determines the icon and color. `default` draws no icon unless `icon` is passed. @default "default"
15
+ - `status: "404" | "403" | "500"` — HTTP error status — adds a status-specific CSS class and shows a neutral icon. Use for error pages (404, 403, 500).
16
+ - `title: ReactNode` — The title
17
+ - `description: ReactNode` — The description
18
+ - `extra: ReactNode` — Operating area
19
+ - `icon: ReactNode` — Custom icon
20
+ - `iconSurface: boolean` = false — Sit the icon on a tinted circle in the intent's colour, instead of drawing it bare. Off by default so existing pages keep their look. Turn it on when the icon is the page's main visual — a maintenance or error page, where a bare glyph reads as an afterthought. The tint comes from `--wim-color-<intent>-subtle`, so it follows the theme and never needs a hand-mixed colour. @default false
21
+ - `className: string` — Custom class name
22
+ - `children: ReactNode` — The children
23
+
24
+ ## Design tokens it reads
25
+
26
+ `--wim-color-danger-subtle`, `--wim-color-info-subtle`, `--wim-color-neutral-subtle`, `--wim-color-success-subtle`, `--wim-color-surface-subtle`, `--wim-color-warning-subtle`, `--wim-radius-full`, `--wim-radius-sm`, `--wim-result-icon-size`, `--wim-spacing-md`, `--wim-spacing-sm`
27
+
28
+ ---
29
+ Setup, composition rules and the full catalog: `llms.txt` / `llms-full.txt` in the same package.
@@ -0,0 +1,59 @@
1
+ # RichTextEditor — wimui
2
+
3
+ > WYSIWYG rich text editor
4
+
5
+ ## Import
6
+
7
+ ```ts
8
+ import "wimui/styles.css"; // once per app — required
9
+ import { RichTextEditor } from "wimui/form";
10
+ ```
11
+
12
+ ## Props
13
+
14
+ - `value: string` — Content (controlled), in the format given by `format`. An empty editor is reported as "".
15
+ - `defaultValue: string` = "" — Initial content (uncontrolled), in the format given by `format`
16
+ - `onChange: (value: string) => void` — Callback when the content changes, in the format given by `format`. The content only contains what the editor's schema allows, whichever format is used.
17
+ - `format: "html" | "markdown"` = "html" — Format of `value`, `defaultValue` and `onChange`. With `"markdown"`, the editor reads and writes Markdown and has no underline (Markdown has no syntax for it): the underline button is hidden and underlined input keeps only its text. Read when the editor is created; changing it later does not convert the content.
18
+ - `placeholder: string` — Placeholder shown when the editor is empty
19
+ - `disabled: boolean` — Whether the editor is disabled
20
+ - `intent: "default" | "danger"` = "default" — Semantic intent of the field (e.g. error state)
21
+ - `variant: "outline" | "ghost"` = "outline" — Visual style variant of the field
22
+ - `fullWidth: boolean` = false — Whether to take full width of parent
23
+ - `width: ("xs" | "sm" | "md" | "lg" | "xl") | string | number` — Fixed width of the field (width token, CSS value, or number in px)
24
+ - `minHeight: number | string` = 200 — Minimum height of the editing area
25
+ - `label: React.ReactNode` — Field label
26
+ - `error: string` — Error message
27
+ - `required: boolean` — Whether to show the required indicator
28
+ - `layout: "vertical" | "horizontal"` — Layout direction of label and field
29
+ - `className: string` — Additional class names
30
+ - `id: string` — Unique ID for the component
31
+ - `toolbar: ("bold" | "italic" | "underline" | "strikethrough" | "h1" | "h2" | "h3" | "ul" | "ol" | "link" | "unlink" | "image" | "removeFormat" | "separator")[]` = [
32
+ "bold",
33
+ "italic",
34
+ "underline",
35
+ "strikethrough",
36
+ "separator",
37
+ "h1",
38
+ "h2",
39
+ "h3",
40
+ "separator",
41
+ "ul",
42
+ "ol",
43
+ "separator",
44
+ "link",
45
+ "unlink",
46
+ "separator",
47
+ "removeFormat",
48
+ ] — Toolbar items to display, in order
49
+ - `labels: { bold?: string; italic?: string; underline?: string; strikethrough?: string; h1?: string; h2?: string; h3?: string; ul?: string; ol?: string; link?: string; unlink?: string; removeFormat?: string; toolbar?: string; linkPrompt?: string; linkApply?: string; linkCancel?: string; /** Error shown in the link dialog when the URL is not allowed (only http, https, mailto and relative URLs are). */ linkInvalid?: string; /** Title of the image button and the image dialog. */ image?: string; /** Label of the image URL field. */ imageUrl?: string; /** Label of the alternative text field. */ imageAlt?: string; /** Hint under the alternative text field. */ imageAltHint?: string; /** Label of the button that picks a file (shown only with onImageUpload). */ imageUpload?: string; /** Error shown when onImageUpload rejects or returns a URL that is not allowed. */ imageUploadFailed?: string; /** Error shown in the image dialog when the URL is not allowed (only http, https and relative URLs are). */ imageInvalid?: string; }` = {} — Labels for internationalization
50
+ - `aria-label: string` — Accessible label when no visible label is provided
51
+ - `aria-labelledby: string` — ID of the element that labels the editor
52
+ - `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 and image files pasted or dropped into the editor are uploaded and inserted. The editor stores only the URL it gets back.
53
+
54
+ ## Design tokens it reads
55
+
56
+ `--wim-border-width-thick`, `--wim-border-width-thin`, `--wim-color-disabled`, `--wim-color-focus-outline`, `--wim-color-ghost-bg-hover`, `--wim-color-line`, `--wim-color-primary`, `--wim-color-success`, `--wim-color-surface`, `--wim-color-text-accent`, `--wim-color-text-danger`, `--wim-color-text-disabled`, `--wim-color-text-on-disabled`, `--wim-color-text-primary`, `--wim-color-text-secondary`, `--wim-color-text-tertiary`, `--wim-color-warning`, `--wim-font-size-md`, `--wim-font-size-sm`, `--wim-font-size-xs`, `--wim-font-weight-bold`, `--wim-input-width`, `--wim-line-height-loose`, `--wim-radius-component`, `--wim-radius-sm`, `--wim-spacing-3xs`, `--wim-spacing-md`, `--wim-spacing-sm`, `--wim-spacing-xs`, `--wim-transition-base`, `--wim-width-sm`
57
+
58
+ ---
59
+ Setup, composition rules and the full catalog: `llms.txt` / `llms-full.txt` in the same package.
@@ -0,0 +1,26 @@
1
+ # SankeyChart — wimui
2
+
3
+ > Flow chart where band width is the amount
4
+
5
+ ## Import
6
+
7
+ ```ts
8
+ import "wimui/styles.css"; // once per app — required
9
+ import { SankeyChart } from "wimui/charts";
10
+ ```
11
+
12
+ ## Props
13
+
14
+ - `nodes: string[]` (required) — Every node in the diagram, in the order their colors are assigned. Names are what `links` refers to, so they have to be unique.
15
+ - `links: SankeyLink[]` (required) — Flows between nodes, by node name. A link naming a node that is not in `nodes` is dropped (and reported in the console during development).
16
+ - `height: number` = 300 — The height of the chart in pixels. @default 300
17
+ - `width: string | number` = "100%" — The width of the chart (e.g., "100%", 500). @default "100%"
18
+ - `title: string` — Optional title displayed above the chart.
19
+ - `aria-label: string` — Accessible name for the chart. Defaults to `title` when omitted; pass this when the chart has no visible title, or when the title is not descriptive enough on its own.
20
+
21
+ ## Design tokens it reads
22
+
23
+ `--wim-color-text-secondary`, `--wim-font-family-default`, `--wim-font-size-xs`
24
+
25
+ ---
26
+ Setup, composition rules and the full catalog: `llms.txt` / `llms-full.txt` in the same package.
@@ -0,0 +1,26 @@
1
+ # ScatterChart — wimui
2
+
3
+ > Scatter plots
4
+
5
+ ## Import
6
+
7
+ ```ts
8
+ import "wimui/styles.css"; // once per app — required
9
+ import { ScatterChart } from "wimui/charts";
10
+ ```
11
+
12
+ ## Props
13
+
14
+ - `data: { x: number; y: number; z?: number; name: string }[]` (required) — Points to plot. `z` optionally controls the point size.
15
+ - `xAxisName: string` = "X" — Name of the X axis, shown in the tooltip. @default "X"
16
+ - `yAxisName: string` = "Y" — Name of the Y axis, shown in the tooltip. @default "Y"
17
+ - `xDomain: [ number | "auto" | "dataMin" | (string & {}), number | "auto" | "dataMax" | (string & {}), ]` = ["auto", "auto"] — Range of the X axis. @default ["auto", "auto"]
18
+ - `yDomain: [ number | "auto" | "dataMin" | (string & {}), number | "auto" | "dataMax" | (string & {}), ]` = ["auto", "auto"] — Range of the Y axis. @default ["auto", "auto"]
19
+ - `height: number` = 300 — The height of the chart in pixels. @default 300
20
+ - `width: string | number` = "100%" — The width of the chart (e.g., "100%", 500). @default "100%"
21
+ - `title: string` — Optional title displayed above the chart.
22
+ - `animated: boolean` = false — If true, animates the chart on mount. @default false
23
+ - `aria-label: string` — Accessible name for the chart. Defaults to `title` when omitted; pass this when the chart has no visible title, or when the title is not descriptive enough on its own.
24
+
25
+ ---
26
+ Setup, composition rules and the full catalog: `llms.txt` / `llms-full.txt` in the same package.
@@ -0,0 +1,35 @@
1
+ # ScheduleView — wimui
2
+
3
+ > Displays tasks or events on a chronological timeline or calendar view.
4
+
5
+ ## Import
6
+
7
+ ```ts
8
+ import "wimui/styles.css"; // once per app — required
9
+ import { ScheduleView } from "wimui/data-display";
10
+ ```
11
+
12
+ ## Props
13
+
14
+ - `events: ScheduleViewEvent[]` = [] — List of calendar events
15
+ - `initialView: "timeGridWeek" | "timeGridDay" | "dayGridMonth"` = "timeGridWeek" — Initial view mode
16
+ - `editable: boolean` = true — Whether events can be dragged to new times
17
+ - `selectable: boolean` = true — Whether date ranges can be selected by clicking/dragging
18
+ - `onEventClick: (arg: EventClickArg) => void` — Called when an event is clicked
19
+ - `onEventDrop: (arg: EventDropArg) => void` — Called when an event is dropped to a new time
20
+ - `onEventChange: (arg: EventChangeArg) => void` — Called when an event is resized
21
+ - `onDateSelect: (arg: DateSelectArg) => void` — Called when a date/time range is selected
22
+ - `slotMinTime: string` = "08:00:00" — First hour displayed in the time grid (e.g. "08:00:00")
23
+ - `slotMaxTime: string` = "20:00:00" — Last hour displayed in the time grid (e.g. "20:00:00")
24
+ - `slotDuration: string` = "00:30:00" — Duration of each time slot, e.g. "00:30:00"
25
+ - `locale: string` = "en" — Locale string, e.g. "ja", "pt"
26
+ - `unselectAuto: boolean` = true — Whether clicking elsewhere on the page will clear the current selection
27
+ - `className: string` — Additional CSS class
28
+ - `aria-label: string` — Accessible label for the schedule region
29
+
30
+ ## Design tokens it reads
31
+
32
+ `--wim-border-width-thin`, `--wim-color-border`, `--wim-color-focus-outline`, `--wim-color-ghost-bg`, `--wim-color-ghost-bg-hover`, `--wim-color-primary`, `--wim-color-surface`, `--wim-color-text-on-primary`, `--wim-color-text-primary`, `--wim-color-text-secondary`, `--wim-duration-fast`, `--wim-easing-standard`, `--wim-focus-outline-offset`, `--wim-focus-outline-width`, `--wim-font-size-lg`, `--wim-font-size-sm`, `--wim-font-weight-bold`, `--wim-font-weight-medium`, `--wim-radius-sm`, `--wim-spacing-sm`, `--wim-spacing-xl`, `--wim-spacing-xs`, `--wim-tap-target-min`
33
+
34
+ ---
35
+ Setup, composition rules and the full catalog: `llms.txt` / `llms-full.txt` in the same package.
@@ -0,0 +1,24 @@
1
+ # ScrollArea — wimui
2
+
3
+ > A custom scrollbar component that provides high-performance, cross-browser consistent themes while maintaining a native-like feel.
4
+
5
+ ## Import
6
+
7
+ ```ts
8
+ import "wimui/styles.css"; // once per app — required
9
+ import { ScrollArea } from "wimui/layout";
10
+ ```
11
+
12
+ ## Props
13
+
14
+ - `text: React.ReactNode` — Content to display (alternative to children)
15
+ - `children: React.ReactNode` — Content to display
16
+ - `scrollAxis: "x" | "y" | "both"` = "y" — Axis along which scrolling is allowed
17
+ - `maxHeight: string` — Maximum height before scrolling (a CSS value, so units other than px are supported)
18
+
19
+ ## Design tokens it reads
20
+
21
+ `--wim-color-border`, `--wim-color-border-secondary`, `--wim-radius-full`, `--wim-scroll-thickness`
22
+
23
+ ---
24
+ Setup, composition rules and the full catalog: `llms.txt` / `llms-full.txt` in the same package.
@@ -0,0 +1,22 @@
1
+ # ScrollProgress — wimui
2
+
3
+ > Reading progress indicator
4
+
5
+ ## Import
6
+
7
+ ```ts
8
+ import "wimui/styles.css"; // once per app — required
9
+ import { ScrollProgress } from "wimui/feedback";
10
+ ```
11
+
12
+ ## Props
13
+
14
+ - `intent: "primary" | "success" | "warning" | "danger" | "info" | "neutral"` = "primary" — 意味の軸。兄弟の `Progress` / `ProgressRing` と同じ語彙にそろえてある。 以前は `color` という名前で、値も独自(`secondary` を含む)だった。 塗っているものは `Progress.intent` と構造まで同一だったので、prop 名だけが ずれていた(T114)。
15
+ - `target: React.RefObject<HTMLElement | null>` — Element whose scroll position is tracked. Defaults to `window`.
16
+
17
+ ## Design tokens it reads
18
+
19
+ `--wim-color-primary`, `--wim-duration-extra-fast`, `--wim-easing-standard`, `--wim-spacing-2xs`, `--wim-z-overlay`
20
+
21
+ ---
22
+ Setup, composition rules and the full catalog: `llms.txt` / `llms-full.txt` in the same package.
@@ -0,0 +1,44 @@
1
+ # SearchInput — wimui
2
+
3
+ > Search with clear button
4
+
5
+ Also known as: Search Field, Search Bar
6
+
7
+ ## Import
8
+
9
+ ```ts
10
+ import "wimui/styles.css"; // once per app — required
11
+ import { SearchInput } from "wimui/form";
12
+ ```
13
+
14
+ ## Props
15
+
16
+ - `intent: "default" | "danger"` = "default" — Semantic intent of the field (e.g. error state)
17
+ - `variant: "outline" | "ghost"` = "outline" — Visual style variant of the field
18
+ - `fullWidth: boolean` = false — Whether to take full width of parent
19
+ - `leftIcon: React.ComponentProps<typeof Icon>["name"]` — Icon name to display on the left side
20
+ - `rightIcon: React.ComponentProps<typeof Icon>["name"]` — Icon name to display on the right side
21
+ - `leftIconColor: React.ComponentProps<typeof Icon>["color"]` — Color of the left icon
22
+ - `rightIconColor: React.ComponentProps<typeof Icon>["color"]` — Color of the right icon
23
+ - `onLeftIconClick: (e: React.MouseEvent<HTMLButtonElement>) => void` — Callback when the left icon is clicked (renders the icon as a button)
24
+ - `onRightIconClick: (e: React.MouseEvent<HTMLButtonElement>) => void` — Callback when the right icon is clicked (renders the icon as a button)
25
+ - `allowClear: boolean` = false — Whether to show a clear button when value is present
26
+ - `showPasswordToggle: boolean` = true — Whether to show the visibility toggle when type is "password"
27
+ - `rightIconClassName: string` — Additional class name for the right icon
28
+ - `rightIconRotated: boolean` — Whether to rotate the right icon 180 degrees (e.g. for an open state)
29
+ - `width: ("xs" | "sm" | "md" | "lg" | "xl") | string | number` — Fixed width of the field (width token, CSS value, or number in px)
30
+ - `label: React.ReactNode` — Field label
31
+ - `error: string` — Error message
32
+ - `required: boolean` — Whether to show the required indicator
33
+ - `layout: "vertical" | "horizontal"` — Layout direction of label and field
34
+ - `inputClassName: string` — Additional class name for the inner input element
35
+ - `showPasswordAriaLabel: string` — Aria label for the show-password toggle
36
+ - `hidePasswordAriaLabel: string` — Aria label for the hide-password toggle
37
+ - `rightIconAriaLabel: string` — Aria label for the right icon button
38
+ - `rightIconDecorative: boolean` = false — Treats the clickable right icon as a pointer-only affordance: it stays clickable but leaves the tab order and is hidden from assistive technology. Use it when the field already does the same thing from the keyboard. @default false
39
+ - `suffix: React.ReactNode` — Static text shown after the field, inside the same shell — a unit such as `kg`, `%` or `円`. It is announced with the field via `aria-describedby`, so the unit does not have to be repeated in the label.
40
+ - `styles: { root?: string; inner?: string; icon?: string; icons?: string; iconItem?: string; iconButton?: string; }` — Custom styles for internal parts
41
+ - `asChild: boolean` = false — Whether to render as a child element.
42
+
43
+ ---
44
+ Setup, composition rules and the full catalog: `llms.txt` / `llms-full.txt` in the same package.
@@ -0,0 +1,40 @@
1
+ # SegmentedControl — wimui
2
+
3
+ > Button-style controls for switching between a small set of mutually exclusive options
4
+
5
+ Also known as: Segmented Buttons, Segmented Picker
6
+
7
+ ## Import
8
+
9
+ ```ts
10
+ import "wimui/styles.css"; // once per app — required
11
+ import { SegmentedControl } from "wimui/form";
12
+ ```
13
+
14
+ ## Props
15
+
16
+ - `options: Option[]` (required) — List of segment options
17
+ - `value: string` (required) — Selected value
18
+ - `onChange: (value: string) => void` (required) — Callback when the selected value changes
19
+ - `size: "sm" | "md" | "lg"` = "md" — Size of the control
20
+ - `fullWidth: boolean` = false — Whether to take full width of parent
21
+ - `className: string` — Additional class names
22
+ - `label: string` — Accessible label
23
+ - `error: string` — Error message
24
+ - `required: boolean` — Whether to show the required indicator
25
+ - `layout: "vertical" | "horizontal"` = "vertical" — Layout direction of label and field
26
+ - `disabled: boolean` = false — Whether the control is disabled
27
+ - `asChild: boolean` = false — If true, merge radiogroup props onto the child element.
28
+ - `children: React.ReactNode` — Optional children used when asChild is true
29
+ - `aria-label: string` — Accessible name for the radio group when no visible `label` is provided.
30
+ - `aria-labelledby: string` — ID of the element that labels the radio group when no visible `label` is provided.
31
+ - `aria-describedby: string` — ID of the element that describes the radio group. Announced together with the error message.
32
+ - `id: string` — Unique ID for the component
33
+ - `styles: { root?: string; item?: string; slider?: string; label?: string; }` — Custom styles for internal parts
34
+
35
+ ## Design tokens it reads
36
+
37
+ `--wim-border-width-thick`, `--wim-color-border`, `--wim-color-focus-outline`, `--wim-color-text-accent`, `--wim-color-text-primary`, `--wim-color-text-secondary`, `--wim-control-item-padding-x-lg`, `--wim-control-item-padding-x-md`, `--wim-control-item-padding-x-sm`, `--wim-focus-outline-offset`, `--wim-font-size-icon-inner`, `--wim-font-size-lg`, `--wim-font-size-md`, `--wim-font-size-sm`, `--wim-font-weight-medium`, `--wim-height-lg`, `--wim-height-md`, `--wim-height-sm`, `--wim-line-height-normal`, `--wim-radius-component`, `--wim-radius-full`, `--wim-segmented-control-item-size-lg`, `--wim-segmented-control-item-size-md`, `--wim-segmented-control-item-size-sm`, `--wim-spacing-2xs`, `--wim-spacing-sm`, `--wim-tap-target-min`, `--wim-transition-fast`
38
+
39
+ ---
40
+ Setup, composition rules and the full catalog: `llms.txt` / `llms-full.txt` in the same package.