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,44 @@
1
+ # Select — wimui
2
+
3
+ > A dropdown menu for selecting one option from a predefined list
4
+
5
+ Also known as: Pop-Up Button, Select Menu
6
+
7
+ ## Import
8
+
9
+ ```ts
10
+ import "wimui/styles.css"; // once per app — required
11
+ import { Select } from "wimui/form";
12
+ ```
13
+
14
+ ## Props
15
+
16
+ - `options: SelectOption[] | SelectOptionGroup[]` = [] — List of options (flat or grouped)
17
+ - `value: string` — Selected value (controlled)
18
+ - `onChange: (value: string) => void` — Callback when the selected value changes
19
+ - `placeholder: React.ReactNode` — Placeholder shown when nothing is selected
20
+ - `label: string` — Field label
21
+ - `disabled: boolean` = false — Whether the field is disabled
22
+ - `defaultValue: string` — Initially selected value (uncontrolled)
23
+ - `searchable: boolean` = false — Enable search/filtering functionality
24
+ - `searchPlaceholder: string` — Placeholder text for search input
25
+ - `filterOption: (option: SelectOption, searchValue: string) => boolean` — Custom filter function
26
+ - `grouped: boolean` = false — Whether options are grouped
27
+ - `allowClear: boolean` = false — Whether to show a clear button when a value is selected
28
+ - `fullWidth: boolean` = false — Whether to take full width of parent
29
+ - `id: string` — Unique ID for the component
30
+ - `intent: "default" | "danger"` = "default" — Semantic intent of the field (e.g. error state)
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
+ - `noOptionsFoundLabel: string` — Label shown when no options match the search
35
+ - `width: ("xs" | "sm" | "md" | "lg" | "xl") | string | number` — Fixed width of the field (width token, CSS value, or number in px)
36
+ - `asChild: boolean` = false — Whether to render as a child element.
37
+ - `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
38
+
39
+ ## Design tokens it reads
40
+
41
+ `--wim-border-width-thin`, `--wim-color-border`, `--wim-color-danger`, `--wim-color-disabled`, `--wim-color-focus-outline`, `--wim-color-ghost-bg-hover`, `--wim-color-line`, `--wim-color-primary`, `--wim-color-surface`, `--wim-color-surface-hover`, `--wim-color-text-on-disabled`, `--wim-color-text-placeholder`, `--wim-color-text-primary`, `--wim-color-text-secondary`, `--wim-field-padding-v`, `--wim-field-padding-y`, `--wim-field-padding-y-tight`, `--wim-floating-shift-x`, `--wim-font-family-default`, `--wim-font-size-md`, `--wim-font-size-small-scale`, `--wim-font-size-xs`, `--wim-font-weight-bold`, `--wim-font-weight-medium`, `--wim-height-md`, `--wim-input-width`, `--wim-letter-spacing-wide`, `--wim-line-height-normal`, `--wim-list-item-padding-x`, `--wim-list-item-padding-y`, `--wim-opacity-dim`, `--wim-radius-component`, `--wim-radius-overlay`, `--wim-radius-sm`, `--wim-shadow-field-focus`, `--wim-shadow-focus`, `--wim-shadow-overlay`, `--wim-spacing-md`, `--wim-spacing-sm`, `--wim-spacing-xs`, `--wim-transition-base`, `--wim-transition-fast`, `--wim-width-md`, `--wim-z-overlay`
42
+
43
+ ---
44
+ Setup, composition rules and the full catalog: `llms.txt` / `llms-full.txt` in the same package.
@@ -0,0 +1,28 @@
1
+ # SelectionBar — wimui
2
+
3
+ > Bar above a table that shows the number of selected rows, the actions for them and a way to clear the selection. Announces the count to screen readers.
4
+
5
+ Also known as: Bulk Actions, Batch Actions, Table Selection Toolbar
6
+
7
+ ## Import
8
+
9
+ ```ts
10
+ import "wimui/styles.css"; // once per app — required
11
+ import { SelectionBar } from "wimui/data-display";
12
+ ```
13
+
14
+ ## Props
15
+
16
+ - `count: number` (required) — Number of selected items. The bar shows while it is above 0. Keep the component mounted while the count is 0 as well: it holds the status region that announces the count, and a region that appears together with its text is not read by screen readers.
17
+ - `onClear: () => void` — Called by the built-in "Clear selection" button. Leave it out to render no clear button.
18
+ - `children: React.ReactNode` — Actions for the selected items (`Button size="sm"`, `IconButton`, `Popconfirm` ...). They are placed in a `Toolbar`, so the arrow keys move between them.
19
+ - `countLabel: (count: number) => React.ReactNode` — Text that states the count. Defaults to the built-in "{count} selected" (en / ja / pt).
20
+ - `clearLabel: string` — Label of the clear button. Defaults to the built-in "Clear selection".
21
+ - `returnFocusRef: React.RefObject<HTMLElement | null>` — Where focus goes when the bar closes after focus was in it — after the clear button, or after a confirmation opened from the bar (`Popconfirm`) whose trigger is gone. Without it, focus moves to the first focusable element after the bar (with `DataGrid`, the grid).
22
+
23
+ ## Design tokens it reads
24
+
25
+ `--wim-color-text-primary`, `--wim-font-size-sm`, `--wim-font-weight-medium`, `--wim-spacing-sm`, `--wim-spacing-xs`
26
+
27
+ ---
28
+ Setup, composition rules and the full catalog: `llms.txt` / `llms-full.txt` in the same package.
@@ -0,0 +1,47 @@
1
+ # Sidebar — wimui
2
+
3
+ > A collapsible navigation or informational panel on the side of the screen
4
+
5
+ Also known as: Source List, Inspector
6
+
7
+ ## Import
8
+
9
+ ```ts
10
+ import "wimui/styles.css"; // once per app — required
11
+ import { Sidebar } from "wimui/layout";
12
+ ```
13
+
14
+ ## Props
15
+
16
+ - `fixed: boolean` — Fixed position
17
+ - `collapsed: boolean` — Collapsed state
18
+ - `width: number | string` = 260 — Width when expanded
19
+ - `bordered: boolean` = true — Border at the right
20
+ - `responsive: boolean` = true — Below the `md` breakpoint, move the sidebar off-canvas so it stops taking width from the content. Defaults to `true`. **It does not bring a way back on screen.** Off-canvas means `left: -{width}` until `mobileOpen` is true, and nothing in this component flips that — so on a phone the sidebar and everything in it become unreachable unless you wire a trigger yourself. Measured at 390px: the rail sits at `x = -260` with no control anywhere on the page (T60). Pair it with `mobileOpen` and a `HamburgerMenu`, the way the AppShell story does: ```tsx const [open, setOpen] = useState(false); <HamburgerMenu visibleBelow="md" open={open} onOpenChange={setOpen} /> <Sidebar mobileOpen={open} onOverlayClick={() => setOpen(false)}>…</Sidebar> ``` `visibleBelow="md"` keeps the control out of the way at widths where the rail is already on screen. The trigger lives outside this component on purpose: it usually belongs in the header, and a built-in one would sit in the wrong place or duplicate the one you already have. Set `responsive={false}` to keep the sidebar in flow at every width.
21
+ - `mobileOpen: boolean` — Mobile drawer open state. Required for the rail to be reachable below `md` — see `responsive`.
22
+ - `onOverlayClick: () => void` — Callback when overlay is clicked
23
+
24
+ ## Sidebar.Content
25
+
26
+ (no props of its own)
27
+
28
+ ## Sidebar.Footer
29
+
30
+ (no props of its own)
31
+
32
+ ## Sidebar.Header
33
+
34
+ (no props of its own)
35
+
36
+ ## Sidebar.Item
37
+
38
+ - `active: boolean`
39
+ - `disabled: boolean`
40
+ - `icon: React.ReactNode`
41
+
42
+ ## Design tokens it reads
43
+
44
+ `--wim-blur-2xs`, `--wim-border-width-thin`, `--wim-color-border-secondary`, `--wim-color-overlay-sidebar`, `--wim-color-primary-muted`, `--wim-color-surface`, `--wim-color-surface-hover`, `--wim-color-text-accent`, `--wim-color-text-primary`, `--wim-font-size-xl`, `--wim-font-weight-bold`, `--wim-height-sm`, `--wim-height-xl`, `--wim-opacity-disabled`, `--wim-sidebar-width`, `--wim-spacing-md`, `--wim-spacing-sm`, `--wim-transition-base`, `--wim-transition-fast`, `--wim-z-drawer`, `--wim-z-mask`, `--wim-z-sidebar`
45
+
46
+ ---
47
+ Setup, composition rules and the full catalog: `llms.txt` / `llms-full.txt` in the same package.
@@ -0,0 +1,36 @@
1
+ # SignaturePad — wimui
2
+
3
+ > Handwritten signature input
4
+
5
+ ## Import
6
+
7
+ ```ts
8
+ import "wimui/styles.css"; // once per app — required
9
+ import { SignaturePad } from "wimui/form";
10
+ ```
11
+
12
+ ## Props
13
+
14
+ - `width: number` = 400 — Width of the canvas
15
+ - `height: number` = 200 — Height of the canvas
16
+ - `penColor: string` = "var(--wim-color-text-primary)" — Color of the pen
17
+ - `penWidth: number` = 2 — Width of the pen stroke
18
+ - `onChange: (dataUrl: string | null) => void` — Callback when signature changes or is cleared
19
+ - `clearLabel: React.ReactNode` — Custom label for the clear button
20
+ - `disabled: boolean` = false — Whether the component is disabled
21
+ - `className: string` — CSS class name
22
+ - `style: React.CSSProperties` — Inline styles
23
+ - `label: React.ReactNode` — Field label
24
+ - `error: string` — Error message
25
+ - `required: boolean` — Whether to show the required indicator
26
+ - `layout: "vertical" | "horizontal"` = "vertical" — Layout direction of label and field
27
+ - `canvasAriaLabel: string` — Aria label for the canvas
28
+ - `aria-label: string` — Accessible name for the canvas when no visible `label` is provided. Takes precedence over `canvasAriaLabel`.
29
+ - `aria-labelledby: string` — ID of the element that labels the canvas when no visible `label` is provided.
30
+
31
+ ## Design tokens it reads
32
+
33
+ `--wim-border-width-thin`, `--wim-color-border`, `--wim-color-disabled`, `--wim-color-surface`, `--wim-font-family-default`, `--wim-opacity-disabled`, `--wim-radius-component`, `--wim-spacing-md`
34
+
35
+ ---
36
+ Setup, composition rules and the full catalog: `llms.txt` / `llms-full.txt` in the same package.
@@ -0,0 +1,24 @@
1
+ # SimpleGrid — wimui
2
+
3
+ > Responsive fixed grid
4
+
5
+ ## Import
6
+
7
+ ```ts
8
+ import "wimui/styles.css"; // once per app — required
9
+ import { SimpleGrid } from "wimui/layout";
10
+ ```
11
+
12
+ ## Props
13
+
14
+ - `cols: T | { base?: T; sm?: T; md?: T; lg?: T; xl?: T; }` = 1 — Number of columns (or a responsive object per breakpoint)
15
+ - `spacing: number | string` = "2xl" — Spacing between cells: a spacing token name (`"md"`, `"2xl"`, …) or a raw number of pixels. Prefer the token so the gap follows the theme. @default "2xl"
16
+ - `verticalSpacing: number | string` — Vertical spacing between rows (defaults to `spacing`)
17
+ - `minChildWidth: number | string` — Minimum width of each child; columns wrap automatically to fit
18
+
19
+ ## Design tokens it reads
20
+
21
+ `--wim-simple-grid-cols`, `--wim-simple-grid-cols-lg`, `--wim-simple-grid-cols-md`, `--wim-simple-grid-cols-sm`, `--wim-simple-grid-cols-xl`, `--wim-width-sm`
22
+
23
+ ---
24
+ Setup, composition rules and the full catalog: `llms.txt` / `llms-full.txt` in the same package.
@@ -0,0 +1,26 @@
1
+ # Skeleton — wimui
2
+
3
+ > Placeholder for content loading states.
4
+
5
+ Also known as: Shimmer
6
+
7
+ ## Import
8
+
9
+ ```ts
10
+ import "wimui/styles.css"; // once per app — required
11
+ import { Skeleton } from "wimui/feedback";
12
+ ```
13
+
14
+ ## Props
15
+
16
+ - `variant: "text" | "rect" | "circle"` = "text" — Shape of the skeleton. - `text`: shaped like a line of text. - `rect`: rectangle. - `circle`: circle. @default "text"
17
+ - `animation: "pulse" | "wave" | "none"` = "pulse" — Type of animation. - `pulse`: slow fade in and out. - `wave`: wave moving from left to right. - `none`: no animation. @default "pulse"
18
+ - `width: string | number` — Width, including a CSS unit (px, %, rem, etc.).
19
+ - `height: string | number` — Height, including a CSS unit (px, %, rem, etc.).
20
+
21
+ ## Design tokens it reads
22
+
23
+ `--wim-color-skeleton-bg`, `--wim-color-skeleton-shine`, `--wim-easing-emphasized`, `--wim-opacity-dim`, `--wim-radius-full`, `--wim-radius-sm`
24
+
25
+ ---
26
+ Setup, composition rules and the full catalog: `llms.txt` / `llms-full.txt` in the same package.
@@ -0,0 +1,36 @@
1
+ # Slider — wimui
2
+
3
+ > An input to capture a numeric value from a specified range by dragging a knob
4
+
5
+ ## Import
6
+
7
+ ```ts
8
+ import "wimui/styles.css"; // once per app — required
9
+ import { Slider } from "wimui/form";
10
+ ```
11
+
12
+ ## Props
13
+
14
+ - `value: number` — Current value (controlled)
15
+ - `defaultValue: number` = 0 — Default value (uncontrolled)
16
+ - `min: number` = 0 — Minimum value
17
+ - `max: number` = 100 — Maximum value
18
+ - `step: number` = 1 — Step value
19
+ - `disabled: boolean` = false — Whether the slider is disabled
20
+ - `onChange: (value: number) => void` — Callback when the value changes
21
+ - `onAfterChange: (value: number) => void` — Callback when dragging ends
22
+ - `name: string` — Name attribute
23
+ - `label: React.ReactNode` — Accessible label
24
+ - `error: string` — Error message
25
+ - `required: boolean` — Whether to show the required indicator
26
+ - `layout: "vertical" | "horizontal"` = "vertical" — Layout direction of label and field
27
+ - `id: string` — Custom ID
28
+ - `asChild: boolean` = false — Whether to render as a child element.
29
+ - `styles: { root?: string; labelWrapper?: string; label?: string; content?: string; error?: string; }` — Custom styles for internal parts
30
+
31
+ ## Design tokens it reads
32
+
33
+ `--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-focus-outline-width`, `--wim-height-xs`, `--wim-opacity-ghost`, `--wim-radius-full`, `--wim-shadow-sm`, `--wim-spacing-sm`, `--wim-tap-target-min`, `--wim-transition-fast`
34
+
35
+ ---
36
+ Setup, composition rules and the full catalog: `llms.txt` / `llms-full.txt` in the same package.
@@ -0,0 +1,35 @@
1
+ # SmartSearchInput — wimui
2
+
3
+ > Smart search input enabling both traditional search and AI prompting.
4
+
5
+ ## Import
6
+
7
+ ```ts
8
+ import "wimui/styles.css"; // once per app — required
9
+ import { SmartSearchInput } from "wimui/form";
10
+ ```
11
+
12
+ ## Props
13
+
14
+ - `intent: "default" | "danger"` = "default" — Semantic intent of the field (e.g. error state)
15
+ - `variant: "outline" | "ghost"` = "outline" — Visual style variant of the field
16
+ - `fullWidth: boolean` = false — Whether to take full width of parent
17
+ - `width: ("xs" | "sm" | "md" | "lg" | "xl") | string | number` — Fixed width of the field (width token, CSS value, or number in px)
18
+ - `label: React.ReactNode` — Field label
19
+ - `error: string` — Error message
20
+ - `required: boolean` — Whether to show the required indicator
21
+ - `layout: "vertical" | "horizontal"` — Layout direction of label and field
22
+ - `maxRows: number` = 8 — Maximum number of rows the input grows to before scrolling
23
+ - `allowClear: boolean` = true — Whether to show a clear button when value is present
24
+ - `onClear: () => void` — Callback when the clear button is clicked
25
+ - `onSubmit: (value: string) => void` — Callback when the value is submitted with the Enter key
26
+ - `onChange: (value: string) => void` — Callback when the value changes
27
+ - `defaultValue: string` = "" — Initial value (uncontrolled)
28
+ - `maxLength: number` — Maximum number of characters
29
+
30
+ ## Design tokens it reads
31
+
32
+ `--wim-border-width-thin`, `--wim-color-text-on-disabled`, `--wim-color-text-primary`, `--wim-color-text-tertiary`, `--wim-font-size-md`, `--wim-height-md`, `--wim-line-height-normal`, `--wim-spacing-xs`
33
+
34
+ ---
35
+ Setup, composition rules and the full catalog: `llms.txt` / `llms-full.txt` in the same package.
@@ -0,0 +1,30 @@
1
+ # Snackbar — wimui
2
+
3
+ > Bottom notifications
4
+
5
+ ## Import
6
+
7
+ ```ts
8
+ import "wimui/styles.css"; // once per app — required
9
+ import { Snackbar } from "wimui/feedback";
10
+ ```
11
+
12
+ ## Props
13
+
14
+ - `message: string` (required) — Message displayed in the snackbar
15
+ - `open: boolean` = false — Whether the snackbar is shown @default false
16
+ - `intent: "default" | "info" | "success" | "warning" | "danger"` = "default" — Intent (semantic state) @default "default"
17
+ - `position: "top-left" | "top-center" | "top-right" | "bottom-left" | "bottom-center" | "bottom-right"` = "bottom-center" — Position on the screen @default "bottom-center"
18
+ - `autoHideDuration: number` = 5000 — Time in milliseconds before the snackbar closes automatically. Set 0 to disable auto-close. @default 5000
19
+ - `showCloseButton: boolean` = false — Whether to show a close button @default false
20
+ - `actionLabel: string` — Label of the action button
21
+ - `onAction: () => void` — Called when the action button is clicked
22
+ - `onClose: () => void` — Called when the snackbar is closed
23
+ - `className: string` — Additional CSS class name
24
+
25
+ ## Design tokens it reads
26
+
27
+ `--wim-border-width-thin`, `--wim-color-danger`, `--wim-color-info`, `--wim-color-success`, `--wim-color-warning`, `--wim-color-white`, `--wim-comp-snackbar-bg`, `--wim-comp-snackbar-fg`, `--wim-duration-slow`, `--wim-easing-standard`, `--wim-font-size-sm`, `--wim-font-weight-medium`, `--wim-line-height-normal`, `--wim-radius-full`, `--wim-radius-overlay`, `--wim-scale-active-sm`, `--wim-shadow-overlay`, `--wim-snackbar-action`, `--wim-snackbar-action-active`, `--wim-snackbar-action-bg`, `--wim-snackbar-action-hover`, `--wim-snackbar-bg`, `--wim-snackbar-border`, `--wim-snackbar-close-hover`, `--wim-snackbar-close-idle`, `--wim-snackbar-close-size`, `--wim-snackbar-fg`, `--wim-snackbar-lift`, `--wim-snackbar-max-width`, `--wim-snackbar-min-width`, `--wim-spacing-3xl`, `--wim-spacing-4xl`, `--wim-spacing-lg`, `--wim-spacing-md`, `--wim-spacing-sm`, `--wim-spacing-xs`, `--wim-tap-target-min`, `--wim-transition-fast`, `--wim-z-toast`
28
+
29
+ ---
30
+ Setup, composition rules and the full catalog: `llms.txt` / `llms-full.txt` in the same package.
@@ -0,0 +1,33 @@
1
+ # SortableList — wimui
2
+
3
+ > Item rearrangement and reordering
4
+
5
+ ## Import
6
+
7
+ ```ts
8
+ import "wimui/styles.css"; // once per app — required
9
+ import { SortableList } from "wimui/data-display";
10
+ ```
11
+
12
+ ## Props
13
+
14
+ - `asChild: boolean` = false — If true, the component will be rendered as its child.
15
+ - `onSortEnd: (oldIndex: number, newIndex: number) => void` — Callback called when reordering is completed.
16
+ - `disabled: boolean` = false — Whether the entire list is disabled.
17
+
18
+ ## SortableList.DragHandle
19
+
20
+ - `asChild: boolean` = false
21
+
22
+ ## SortableList.Item
23
+
24
+ - `asChild: boolean` = false
25
+ - `index: number` (required) — The index of the item in the list.
26
+ - `disabled: boolean` = false — Whether this specific item is disabled for dragging.
27
+
28
+ ## Design tokens it reads
29
+
30
+ `--wim-blur-glass`, `--wim-border-width-thick`, `--wim-border-width-thin`, `--wim-color-border`, `--wim-color-ghost-bg`, `--wim-color-ghost-bg-hover`, `--wim-color-ghost-border-hover`, `--wim-color-glass-bg`, `--wim-color-primary`, `--wim-color-surface`, `--wim-color-text-secondary`, `--wim-color-text-tertiary`, `--wim-duration-fast`, `--wim-easing-standard`, `--wim-opacity-disabled`, `--wim-opacity-ghost`, `--wim-radius-component`, `--wim-radius-full`, `--wim-shadow-focus-ring`, `--wim-shadow-sm`, `--wim-spacing-2xs`, `--wim-spacing-md`, `--wim-spacing-sm`, `--wim-spacing-xs`
31
+
32
+ ---
33
+ Setup, composition rules and the full catalog: `llms.txt` / `llms-full.txt` in the same package.
@@ -0,0 +1,28 @@
1
+ # SourceCitation — wimui
2
+
3
+ > Displays cited sources with title, domain, and external link for AI-generated content.
4
+
5
+ ## Import
6
+
7
+ ```ts
8
+ import "wimui/styles.css"; // once per app — required
9
+ import { SourceCitation } from "wimui/ai";
10
+ ```
11
+
12
+ ## Props
13
+
14
+ - `title: string` (required) — Title of the source
15
+ - `url: string` — Source URL. When provided, renders as a clickable link.
16
+ - `description: string` — Brief excerpt or description of the source
17
+ - `index: number` — Numeric citation index shown as a badge (e.g. 1, 2, 3)
18
+ - `domain: string` — Domain label shown below the title (auto-derived from url when omitted)
19
+ - `className: string` — Additional CSS class
20
+ - `aria-label: string` — Accessible name for the citation.
21
+ - `aria-labelledby: string` — ID of the element that labels the citation. Takes precedence over `aria-label`.
22
+
23
+ ## Design tokens it reads
24
+
25
+ `--wim-border-width-thin`, `--wim-color-border`, `--wim-color-focus-outline`, `--wim-color-primary`, `--wim-color-surface`, `--wim-color-text-accent`, `--wim-color-text-on-primary`, `--wim-color-text-primary`, `--wim-color-text-secondary`, `--wim-color-text-tertiary`, `--wim-duration-fast`, `--wim-easing-standard`, `--wim-focus-outline-offset`, `--wim-focus-outline-width`, `--wim-font-size-sm`, `--wim-font-size-xs`, `--wim-font-weight-bold`, `--wim-font-weight-medium`, `--wim-line-height-normal`, `--wim-radius-component`, `--wim-radius-full`, `--wim-spacing-2xs`, `--wim-spacing-3xs`, `--wim-spacing-md`, `--wim-spacing-sm`
26
+
27
+ ---
28
+ Setup, composition rules and the full catalog: `llms.txt` / `llms-full.txt` in the same package.
@@ -0,0 +1,13 @@
1
+ # SourceCode — wimui
2
+
3
+ > Highlighted source code display
4
+
5
+ ## Import
6
+
7
+ ```ts
8
+ import "wimui/styles.css"; // once per app — required
9
+ import { SourceCode } 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,29 @@
1
+ # Span — wimui
2
+
3
+ > Lightweight wrapper for inline text or short labels with icon support
4
+
5
+ ## Import
6
+
7
+ ```ts
8
+ import "wimui/styles.css"; // once per app — required
9
+ import { Span } from "wimui/typography";
10
+ ```
11
+
12
+ ## Props
13
+
14
+ - `asChild: boolean` = false — If true, the span will be rendered as its child, merging its props onto that child.
15
+ - `size: "xs" | "sm" | "md" | "lg" | "xl"` = "md" — Font size of the text. @default "md"
16
+ - `color: T | (string & {})` — Text color. Accepts a design token color name or any CSS color value.
17
+ - `weight: "bold" | "medium" | "normal" | "semibold"` = "normal" — Font weight. @default "normal"
18
+ - `fontStyle: "normal" | "italic"` = "normal" — Font style. @default "normal"
19
+ - `decoration: "line-through" | "underline" | "highlight" | "none"` = "none" — Visual decoration applied to the text. @default "none"
20
+ - `content: React.ReactNode` — Content of the span. Alternative to children.
21
+ - `iconName: React.ComponentProps<typeof Icon>["name"]` = undefined — Name of the icon displayed alongside the text.
22
+ - `iconPosition: "left" | "right"` = "left" — Position of the icon relative to the text. @default "left"
23
+
24
+ ## Design tokens it reads
25
+
26
+ `--wim-color-text-accent`, `--wim-color-text-danger`, `--wim-color-text-info`, `--wim-color-text-success`, `--wim-color-text-warning`, `--wim-comp-decoration-highlight-color`, `--wim-decoration-line-through`, `--wim-decoration-underline`, `--wim-font-size-icon-inner`, `--wim-font-size-lg`, `--wim-font-size-md`, `--wim-font-size-sm`, `--wim-font-size-xl`, `--wim-font-size-xs`, `--wim-font-weight-bold`, `--wim-spacing-xs`, `--wim-text-underline-offset`
27
+
28
+ ---
29
+ Setup, composition rules and the full catalog: `llms.txt` / `llms-full.txt` in the same package.
@@ -0,0 +1,27 @@
1
+ # Sparkline — wimui
2
+
3
+ > Tiny inline trend chart
4
+
5
+ ## Import
6
+
7
+ ```ts
8
+ import "wimui/styles.css"; // once per app — required
9
+ import { Sparkline } from "wimui/charts";
10
+ ```
11
+
12
+ ## Props
13
+
14
+ - `data: number[]` (required) — Sequence of values to plot, in order
15
+ - `type: "line" | "area" | "bar"` = "line" — Visual form of the sparkline
16
+ - `width: number | string` = "100%" — Width of the sparkline (number in px, or a CSS value such as "100%")
17
+ - `height: number` = 24 — Height of the sparkline in px
18
+ - `color: string` = "var(--wim-color-chart-primary)" — Stroke/fill color (defaults to the primary chart color)
19
+ - `strokeWidth: number` = 2 — Stroke width for line and area types
20
+ - `showLastDot: boolean` = false — Whether to emphasize the last data point with a dot (line and area only)
21
+ - `min: number` — Lower bound of the y-axis domain (defaults to the data minimum)
22
+ - `max: number` — Upper bound of the y-axis domain (defaults to the data maximum)
23
+ - `ariaLabel: string` — Accessible label describing the trend; when omitted the sparkline is hidden from assistive tech
24
+ - `className: string` — Additional class names
25
+
26
+ ---
27
+ Setup, composition rules and the full catalog: `llms.txt` / `llms-full.txt` in the same package.
@@ -0,0 +1,28 @@
1
+ # SpeedDial — wimui
2
+
3
+ > Floating action button that expands sub-actions on hover or click.
4
+
5
+ ## Import
6
+
7
+ ```ts
8
+ import "wimui/styles.css"; // once per app — required
9
+ import { SpeedDial } from "wimui/navigation";
10
+ ```
11
+
12
+ ## Props
13
+
14
+ - `actions: SpeedDialAction[]` (required) — Actions to display when SpeedDial is open
15
+ - `icon: keyof typeof ALL_ICONS` = "PlusIcon" — Icon name for the main button when closed
16
+ - `activeIcon: keyof typeof ALL_ICONS` = "CloseIcon" — Icon name for the main button when open
17
+ - `direction: "up" | "down" | "left" | "right"` = "up" — Direction in which actions expand. **The caller picks a direction that has room.** Actions are placed with plain CSS (`left: 100%` and friends) and are never measured, so this component does not flip when the viewport runs out — a `right` dial placed near the right edge pushes the page into a horizontal scroll. Anchor a `right` dial to the leading edge (and a `left` one to the trailing edge); `up` / `down` already grow inward from the trailing corner (T175). @default "up"
18
+ - `trigger: "hover" | "click"` = "hover" — Trigger mode to open the SpeedDial
19
+ - `open: boolean` — Controlled open state
20
+ - `onOpenChange: (open: boolean) => void` — Callback when open state changes
21
+ - `aria-label: string` — Accessible name for the trigger button. Lands on the inner `FloatButton`, not on the wrapper `div`. Defaults to a translated "Open menu" / "Close menu" (en / ja / pt), following the open state.
22
+
23
+ ## Design tokens it reads
24
+
25
+ `--wim-duration-base`, `--wim-easing-standard`, `--wim-spacing-md`, `--wim-z-overlay`
26
+
27
+ ---
28
+ Setup, composition rules and the full catalog: `llms.txt` / `llms-full.txt` in the same package.
@@ -0,0 +1,26 @@
1
+ # Spinner — wimui
2
+
3
+ > A rotating icon indicating background activity or data fetching
4
+
5
+ Also known as: Activity Indicator
6
+
7
+ ## Import
8
+
9
+ ```ts
10
+ import "wimui/styles.css"; // once per app — required
11
+ import { Spinner } from "wimui/feedback";
12
+ ```
13
+
14
+ ## Props
15
+
16
+ - `size: "sm" | "md" | "lg" | "xl"` = "md" — Size of the spinner. @default "md"
17
+ - `color: "currentColor" | WimColor` = "primary" — Color of the spinner. Accepts a design token color name or "currentColor". @default "primary"
18
+ - `label: string` — Text label displayed next to the spinner.
19
+ - `labelPosition: "right" | "bottom"` = "right" — Position of the label relative to the spinner. @default "right"
20
+
21
+ ## Design tokens it reads
22
+
23
+ `--wim-color-danger`, `--wim-color-line`, `--wim-color-success`, `--wim-color-text-accent`, `--wim-color-text-secondary`, `--wim-color-warning`, `--wim-font-size-sm`, `--wim-spacing-2xl`, `--wim-spacing-3xl`, `--wim-spacing-lg`, `--wim-spacing-md`
24
+
25
+ ---
26
+ Setup, composition rules and the full catalog: `llms.txt` / `llms-full.txt` in the same package.
@@ -0,0 +1,29 @@
1
+ # SplitButton — wimui
2
+
3
+ > SplitButton description.
4
+
5
+ ## Import
6
+
7
+ ```ts
8
+ import "wimui/styles.css"; // once per app — required
9
+ import { SplitButton } from "wimui/form";
10
+ ```
11
+
12
+ ## Props
13
+
14
+ - `children: React.ReactNode` — Text of the main action.
15
+ - `onClick: React.MouseEventHandler<HTMLButtonElement>` — Called when the main action is pressed.
16
+ - `actions: SplitButtonAction[]` (required) — Secondary actions listed behind the toggle.
17
+ - `variant: "solid" | "outline" | "ghost"` = "solid" — Visual style, applied to both halves so they read as one control.
18
+ - `intent: "default" | "danger" | "success"` = "default" — Intent (semantic color), applied to both halves.
19
+ - `size: "sm" | "md" | "lg"` = "md" — Size of both halves.
20
+ - `disabled: boolean` = false — Disable the whole control.
21
+ - `loading: boolean` = false — Show a loading state on the main action.
22
+ - `toggleLabel: string` (required) — Accessible name for the toggle half. The main half is named by its own text, but the toggle only shows a chevron, so it needs one of its own.
23
+
24
+ ## Design tokens it reads
25
+
26
+ `--wim-border-width-thick`, `--wim-border-width-thin`, `--wim-color-overlay-soft`, `--wim-opacity-dim`, `--wim-spacing-md`, `--wim-spacing-xl`, `--wim-spacing-xs`
27
+
28
+ ---
29
+ Setup, composition rules and the full catalog: `llms.txt` / `llms-full.txt` in the same package.
@@ -0,0 +1,37 @@
1
+ # Splitter — wimui
2
+
3
+ > Split and resize panels
4
+
5
+ Also known as: Resizable, Resizable Panels, Split Pane
6
+
7
+ ## Import
8
+
9
+ ```ts
10
+ import "wimui/styles.css"; // once per app — required
11
+ import { Splitter } from "wimui/layout";
12
+ ```
13
+
14
+ ## Props
15
+
16
+ - `orientation: "horizontal" | "vertical"` = "horizontal" — The orientation of the splitter.
17
+ - `children: React.ReactNode` (required) — The components to render within the splitter. Usually a combination of `Splitter.Panel` and `Splitter.Handle`.
18
+
19
+ ## Splitter.Handle
20
+
21
+ - `index: number` — @internal Injected index from parent Splitter.
22
+ - `active: boolean` — @internal Injected active state from parent Splitter.
23
+ - `ariaLabel: string` — Accessible label for the resize handle
24
+
25
+ ## Splitter.Panel
26
+
27
+ - `defaultSize: number` — The default size of the panel in percentage.
28
+ - `minSize: number` — The minimum size of the panel in percentage.
29
+ - `maxSize: number` — The maximum size of the panel in percentage.
30
+ - `size: number` — @internal Injected size from parent Splitter.
31
+
32
+ ## Design tokens it reads
33
+
34
+ `--wim-color-ghost-bg-hover`, `--wim-color-primary`, `--wim-color-text-tertiary`, `--wim-splitter-handle-active-color`, `--wim-splitter-handle-color`, `--wim-splitter-handle-hover-bg`, `--wim-splitter-handle-width`, `--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
+ # Spoiler — wimui
2
+
3
+ > Collapse long text such as reviews and comments to a fixed number of lines, with an accessible "show more" toggle that appears only when the text overflows.
4
+
5
+ ## Import
6
+
7
+ ```ts
8
+ import "wimui/styles.css"; // once per app — required
9
+ import { Spoiler } from "wimui/typography";
10
+ ```
11
+
12
+ ## Props
13
+
14
+ - `lines: number` = 3 — Number of text lines shown while collapsed. @default 3
15
+ - `expanded: boolean` — Controlled expanded state. Use together with onExpandedChange.
16
+ - `defaultExpanded: boolean` = false — Initial expanded state for uncontrolled usage. @default false
17
+ - `onExpandedChange: (expanded: boolean) => void` — Called with the next state when the toggle is activated.
18
+ - `showLabel: React.ReactNode` — Label of the toggle while collapsed. @default t("spoiler.show_more")
19
+ - `hideLabel: React.ReactNode` — Label of the toggle while expanded. @default t("spoiler.show_less")
20
+
21
+ ## Design tokens it reads
22
+
23
+ `--wim-color-primary`, `--wim-color-text-accent`, `--wim-decoration-underline`, `--wim-font-size-sm`, `--wim-font-weight-semibold`, `--wim-radius-sm`, `--wim-shadow-focus`, `--wim-spacing-2xs`, `--wim-spoiler-lines`, `--wim-tap-target-min`, `--wim-transition-base`, `--wim-transition-fast`
24
+
25
+ ---
26
+ Setup, composition rules and the full catalog: `llms.txt` / `llms-full.txt` in the same package.