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,30 @@
1
+ # Notification — wimui
2
+
3
+ > Rich notification card
4
+
5
+ ## Import
6
+
7
+ ```ts
8
+ import "wimui/styles.css"; // once per app — required
9
+ import { Notification } from "wimui/feedback";
10
+ ```
11
+
12
+ ## Props
13
+
14
+ - `id: string` — The unique identifier of notification
15
+ - `title: ReactNode` (required) — The title of notification
16
+ - `description: ReactNode` — The description of notification
17
+ - `icon: ReactNode` — The icon of notification
18
+ - `intent: "default" | "info" | "success" | "warning" | "danger"` = "default" — The intent of notification @default "default"
19
+ - `onClose: (id?: string) => void` — Callback when notification is closed
20
+ - `closable: boolean` = true — Whether to show close button
21
+ - `className: string` — Additional class name
22
+ - `aria-label: string` — Accessible name for the notification.
23
+ - `aria-labelledby: string` — ID of the element that labels the notification. Takes precedence over `aria-label`.
24
+
25
+ ## Design tokens it reads
26
+
27
+ `--wim-border-width-thin`, `--wim-color-border`, `--wim-color-border-secondary`, `--wim-color-danger`, `--wim-color-info`, `--wim-color-success`, `--wim-color-surface`, `--wim-color-text-disabled`, `--wim-color-text-primary`, `--wim-color-text-secondary`, `--wim-color-warning`, `--wim-font-size-md`, `--wim-font-size-sm`, `--wim-font-weight-medium`, `--wim-line-height-normal-jp`, `--wim-line-height-tight`, `--wim-notification-border-accent-width`, `--wim-notification-width`, `--wim-radius-overlay`, `--wim-scale-active-sm`, `--wim-shadow-overlay`, `--wim-spacing-2xs`, `--wim-spacing-4xl`, `--wim-spacing-lg`, `--wim-spacing-md`, `--wim-spacing-sm`, `--wim-spacing-xs`, `--wim-tap-target-min`, `--wim-transition-base`, `--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,23 @@
1
+ # NumberInput — wimui
2
+
3
+ > Input with step adjustments
4
+
5
+ Also known as: Spin Button, Numeric Stepper
6
+
7
+ ## Import
8
+
9
+ ```ts
10
+ import "wimui/styles.css"; // once per app — required
11
+ import { NumberInput } from "wimui/form";
12
+ ```
13
+
14
+ ## Props
15
+
16
+ - `mode: "number" | "text"` = "number" — 'number': uses the native type="number" (e.g. quantity steppers) 'text': uses type="text" + inputmode (e.g. card numbers or IDs where leading zeros must be kept)
17
+ - `hideSpinButton: boolean` = true — Whether to hide the spin buttons
18
+ - `allowDecimal: boolean` = false — Whether to allow decimal points (effective only when mode="number")
19
+ - `allowNegative: boolean` = false — Whether to allow negative numbers (effective only when mode="number")
20
+ - `asChild: boolean` = false — Whether to render as a child element.
21
+
22
+ ---
23
+ Setup, composition rules and the full catalog: `llms.txt` / `llms-full.txt` in the same package.
@@ -0,0 +1,33 @@
1
+ # OtpInput — wimui
2
+
3
+ > One-time password fields
4
+
5
+ Also known as: Pin Input, Input OTP, PIN Code Input
6
+
7
+ ## Import
8
+
9
+ ```ts
10
+ import "wimui/styles.css"; // once per app — required
11
+ import { OtpInput } from "wimui/form";
12
+ ```
13
+
14
+ ## Props
15
+
16
+ - `length: number` = 6 — Number of digits
17
+ - `value: string` = "" — Current value (controlled)
18
+ - `onChange: (value: string) => void` — Callback when the value changes
19
+ - `disabled: boolean` = false — Whether the input is disabled
20
+ - `error: string` — Error message
21
+ - `required: boolean` — Whether to show the required indicator
22
+ - `label: React.ReactNode` — Field label
23
+ - `layout: "vertical" | "horizontal"` — Layout direction of label and field
24
+ - `labels: { /** * Accessible name for one digit box. * * `position` is **1-based**: the first box is `1`, and the last is `length`. * It is meant to be read aloud ("Digit 3 of 6"), so it counts the way a person * would. Treating it as a 0-based index and adding one yields "Digit 2" for the * first box. * * @param position 1-based position of the box, from `1` to `length` * @default (position) => `Digit ${position}` */ digitAriaLabel?: (position: number) => string; }` = {} — Labels for internationalization. `digitAriaLabel(position)` names one digit box and receives a **1-based** position — the first box is `1`, not `0`.
25
+ - `asChild: boolean` = false — Whether to render as a child element.
26
+ - `fullWidth: boolean` = false — Whether to take full width of parent
27
+
28
+ ## Design tokens it reads
29
+
30
+ `--wim-border-width-thin`, `--wim-color-border`, `--wim-color-disabled`, `--wim-color-focus-outline`, `--wim-color-surface`, `--wim-color-text-on-disabled`, `--wim-color-text-primary`, `--wim-font-size-md`, `--wim-font-size-xl`, `--wim-height-lg`, `--wim-height-md`, `--wim-radius-component`, `--wim-shadow-error-ring`, `--wim-shadow-focus-ring`, `--wim-spacing-sm`, `--wim-spacing-xs`, `--wim-transition-base`, `--wim-width-md`, `--wim-width-sm`
31
+
32
+ ---
33
+ Setup, composition rules and the full catalog: `llms.txt` / `llms-full.txt` in the same package.
@@ -0,0 +1,31 @@
1
+ # OverflowList — wimui
2
+
3
+ > Lays out items in one row and folds the ones that do not fit into a "+N" indicator.
4
+
5
+ ## Import
6
+
7
+ ```ts
8
+ import "wimui/styles.css"; // once per app — required
9
+ import { OverflowList } from "wimui/layout";
10
+ ```
11
+
12
+ ## Props
13
+
14
+ - `items: T[]` (required) — Items to lay out in a single row, in reading order.
15
+ - `renderItem: (item: T, index: number) => React.ReactNode` (required) — Renders one item. Return a single element: each top-level element is measured as one item.
16
+ - `renderOverflow: (hiddenItems: T[]) => React.ReactNode` (required) — Renders the overflow indicator from the items that did not fit (for example a "+N" button that opens a Popover listing them). Return a single element. Not rendered while every item fits, unless `alwaysRenderOverflow` is set. The hidden items are not in the DOM, so the indicator is how users — including keyboard and screen reader users — reach them.
17
+ - `collapseFrom: "start" | "end" | "middle"` = "end" — The side items are collapsed from. `"end"` keeps the first items (tags, toolbars); `"start"` keeps the last ones (a path keeps the current folder); `"middle"` keeps the first item and collapses from the second one, with the indicator right after the first item (a breadcrumb keeps its root and the current page). @default "end"
18
+ - `listElement: "ul" | "ol"` — Renders the row as a list. `renderItem` and `renderOverflow` must then return `<li>` elements. Without it, the row is a `div`, which a list may not contain.
19
+ - `minVisibleItems: number` = 0 — Items that stay visible however narrow the row gets. They may then overflow the row. @default 0
20
+ - `alwaysRenderOverflow: boolean` = false — Renders the overflow indicator even when every item fits (it receives an empty array). @default false
21
+ - `onOverflow: (hiddenItems: T[]) => void` — Called with the hidden items whenever the set of hidden items changes.
22
+ - `gap: WimSpacing` = "sm" — Gap between items: a spacing token name (`"sm"`, `"md"`, …). @default "sm"
23
+ - `asChild: boolean` = false — If true, the list will be rendered as its child, merging its props onto that child.
24
+ - `children: React.ReactNode` — The element that becomes the root (in place of `div`) when `asChild` is set. The items are rendered inside it. Ignored without `asChild`.
25
+
26
+ ## Design tokens it reads
27
+
28
+ `--wim-overflow-list-gap`, `--wim-spacing-sm`, `--wim-width-xs`
29
+
30
+ ---
31
+ Setup, composition rules and the full catalog: `llms.txt` / `llms-full.txt` in the same package.
@@ -0,0 +1,39 @@
1
+ # Pagination — wimui
2
+
3
+ > Multi-page navigation
4
+
5
+ ## Import
6
+
7
+ ```ts
8
+ import "wimui/styles.css"; // once per app — required
9
+ import { Pagination } from "wimui/navigation";
10
+ ```
11
+
12
+ ## Props
13
+
14
+ - `total: number` (required) — Total number of items
15
+ - `pageSize: number` = 10 — Number of items per page
16
+ - `current: number` = 1 — Current page number (1-indexed)
17
+ - `onChange: (page: number, pageSize: number) => void` — Callback function when page changes
18
+ - `onPageSizeChange: (pageSize: number) => void` — Callback function when page size changes
19
+ - `siblingCount: number` = 1 — Number of sibling pages to show around the current page
20
+ - `className: string` — Additional class names
21
+ - `asChild: boolean` = false — If true, merge nav props onto the child element.
22
+ - `children: React.ReactNode` — Optional child used when asChild is true
23
+ - `renderPage: (page: number, props: PaginationPageRenderProps) => React.ReactNode` — Custom renderer for page number controls. Defaults to PaginationPage. Useful for URL-based pagination (e.g. wrap with a Link via PaginationPage asChild).
24
+ - `simple: boolean` = false — Whether to show a simplified version
25
+ - `hideOnSinglePage: boolean` = false — Whether to hide the pagination if there is only one page
26
+ - `showSizeChanger: boolean` = false — Whether to show the page size changer
27
+ - `pageSizeOptions: number[]` = [10, 20, 50, 100] — Page size options for the page size changer
28
+ - `showTotal: (total: number, range: [number, number]) => React.ReactNode` — Function to display the total count
29
+ - `showQuickJumper: boolean` = false — Whether to show quick jumper
30
+ - `labels: { prevPage?: string; nextPage?: string; pageAriaLabel?: (page: number) => string; itemsPerPage?: string; goTo?: string; go?: string; pageSizeAriaLabel?: string; jumpToPageAriaLabel?: string; navAriaLabel?: string; totalLabel?: string; /** Announced to screen readers when the page changes. Receives the current page and the page count. */ pageStatus?: (current: number, totalPages: number) => string; }` = {} — Labels for internationalization
31
+ - `aria-label: string` — Accessible name for the navigation landmark. Takes precedence over `labels.navAriaLabel`.
32
+ - `aria-labelledby: string` — ID of the element that labels the navigation landmark. Takes precedence over `aria-label`.
33
+
34
+ ## Design tokens it reads
35
+
36
+ `--wim-border-width-thin`, `--wim-color-primary`, `--wim-color-surface`, `--wim-color-text-disabled`, `--wim-color-text-on-primary`, `--wim-color-text-primary`, `--wim-color-text-secondary`, `--wim-font-size-md`, `--wim-font-weight-medium`, `--wim-radius-component`, `--wim-radius-sm`, `--wim-scale-active`, `--wim-shadow-focus`, `--wim-spacing-lg`, `--wim-spacing-md`, `--wim-spacing-sm`, `--wim-spacing-xs`, `--wim-tap-target-min`, `--wim-transition-base`, `--wim-width-sm`
37
+
38
+ ---
39
+ Setup, composition rules and the full catalog: `llms.txt` / `llms-full.txt` in the same package.
@@ -0,0 +1,39 @@
1
+ # PasswordInput — wimui
2
+
3
+ > Password with toggle
4
+
5
+ ## Import
6
+
7
+ ```ts
8
+ import "wimui/styles.css"; // once per app — required
9
+ import { PasswordInput } 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
+ - `leftIcon: React.ComponentProps<typeof Icon>["name"]` — Icon name to display on the left side
18
+ - `leftIconColor: React.ComponentProps<typeof Icon>["color"]` — Color of the left icon
19
+ - `rightIconColor: React.ComponentProps<typeof Icon>["color"]` — Color of the right icon
20
+ - `onLeftIconClick: (e: React.MouseEvent<HTMLButtonElement>) => void` — Callback when the left icon is clicked (renders the icon as a button)
21
+ - `allowClear: boolean` = false — Whether to show a clear button when value is present
22
+ - `rightIconClassName: string` — Additional class name for the right icon
23
+ - `rightIconRotated: boolean` — Whether to rotate the right icon 180 degrees (e.g. for an open state)
24
+ - `width: ("xs" | "sm" | "md" | "lg" | "xl") | string | number` — Fixed width of the field (width token, CSS value, or number in px)
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
+ - `inputClassName: string` — Additional class name for the inner input element
30
+ - `showPasswordAriaLabel: string` — Aria label for the show-password toggle
31
+ - `hidePasswordAriaLabel: string` — Aria label for the hide-password toggle
32
+ - `rightIconAriaLabel: string` — Aria label for the right icon button
33
+ - `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
34
+ - `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.
35
+ - `styles: { root?: string; inner?: string; icon?: string; icons?: string; iconItem?: string; iconButton?: string; }` — Custom styles for internal parts
36
+ - `asChild: boolean` = false — Whether to render as a child element.
37
+
38
+ ---
39
+ Setup, composition rules and the full catalog: `llms.txt` / `llms-full.txt` in the same package.
@@ -0,0 +1,34 @@
1
+ # PasswordStrength — wimui
2
+
3
+ > Visual meter to indicate password security level.
4
+
5
+ Also known as: Strength Meter
6
+
7
+ ## Import
8
+
9
+ ```ts
10
+ import "wimui/styles.css"; // once per app — required
11
+ import { PasswordStrength } from "wimui/form";
12
+ ```
13
+
14
+ ## Props
15
+
16
+ - `password: string` = "" — Password string to evaluate
17
+ - `score: 0 | 1 | 2 | 3 | 4` — Strength score (the default calculation is used when omitted) 0: very weak, 1: weak, 2: fair, 3: strong, 4: very strong
18
+ - `showLabel: boolean` = true — Whether to show the strength label
19
+ - `calculateLevel: (password: string) => (0 | 1 | 2 | 3 | 4)` = (password: string): PasswordStrengthLevel => {
20
+ if (!password) return 0;
21
+ let score = 0;
22
+ if (password.length >= 8) score++;
23
+ if (/[A-Z]/.test(password)) score++;
24
+ if (/[0-9]/.test(password)) score++;
25
+ if (/[^A-Za-z0-9]/.test(password)) score++;
26
+ return score as PasswordStrengthLevel;
27
+ } — Custom strength calculation function
28
+
29
+ ## Design tokens it reads
30
+
31
+ `--wim-color-border-secondary`, `--wim-color-danger`, `--wim-color-success`, `--wim-color-text-danger`, `--wim-color-text-success`, `--wim-color-text-warning`, `--wim-color-warning`, `--wim-duration-base`, `--wim-easing-standard`, `--wim-font-size-xs`, `--wim-font-weight-medium`, `--wim-radius-full`, `--wim-spacing-3xs`, `--wim-spacing-xs`
32
+
33
+ ---
34
+ Setup, composition rules and the full catalog: `llms.txt` / `llms-full.txt` in the same package.
@@ -0,0 +1,35 @@
1
+ # PhoneInput — wimui
2
+
3
+ > International phone number input
4
+
5
+ ## Import
6
+
7
+ ```ts
8
+ import "wimui/styles.css"; // once per app — required
9
+ import { PhoneInput } from "wimui/form";
10
+ ```
11
+
12
+ ## Props
13
+
14
+ - `value: string` = "" — Phone number value (the number part, excluding the country dial code).
15
+ - `onChange: (value: string) => void` — Callback when the phone number changes.
16
+ - `countryCode: string` = "US" — Selected country code (e.g. "JP", "US").
17
+ - `onCountryChange: (countryCode: string) => void` — Callback when the country code changes.
18
+ - `placeholder: string` = "000-0000-0000" — Placeholder for the phone number input.
19
+ - `disabled: boolean` = false — Whether the field is disabled.
20
+ - `error: string` — Error message.
21
+ - `required: boolean` = false — Whether to show the required indicator.
22
+ - `label: string` — Field label.
23
+ - `layout: "vertical" | "horizontal"` = "vertical" — Layout direction of label and field.
24
+ - `className: string` — Additional class names.
25
+ - `fullWidth: boolean` = false — Whether to take full width of parent.
26
+ - `aria-label: string` — Accessible name for the phone number input when no visible `label` is provided.
27
+ - `aria-labelledby: string` — ID of the element that labels the phone number input when no visible `label` is provided.
28
+ - `aria-describedby: string` — ID of the element that describes the phone number input. Announced together with the error message.
29
+
30
+ ## Design tokens it reads
31
+
32
+ `--wim-border-width-thin`, `--wim-color-border`, `--wim-color-border-secondary`, `--wim-color-disabled`, `--wim-color-line`, `--wim-color-primary`, `--wim-color-surface`, `--wim-color-surface-hover`, `--wim-color-text-accent`, `--wim-color-text-on-disabled`, `--wim-color-text-primary`, `--wim-color-text-secondary`, `--wim-color-text-tertiary`, `--wim-floating-shift-x`, `--wim-font-size-md`, `--wim-font-size-sm`, `--wim-font-weight-medium`, `--wim-height-md`, `--wim-list-item-padding-x`, `--wim-list-item-padding-y`, `--wim-radius-component`, `--wim-radius-overlay`, `--wim-shadow-error-ring`, `--wim-shadow-focus-ring`, `--wim-shadow-overlay`, `--wim-spacing-md`, `--wim-spacing-xs`, `--wim-transition-base`, `--wim-transition-fast`, `--wim-width-md`, `--wim-z-overlay`
33
+
34
+ ---
35
+ Setup, composition rules and the full catalog: `llms.txt` / `llms-full.txt` in the same package.
@@ -0,0 +1,23 @@
1
+ # PieChart — wimui
2
+
3
+ > Proportional parts of a whole chart
4
+
5
+ ## Import
6
+
7
+ ```ts
8
+ import "wimui/styles.css"; // once per app — required
9
+ import { PieChart } from "wimui/charts";
10
+ ```
11
+
12
+ ## Props
13
+
14
+ - `data: { name: string; value: number }[]` (required) — Slices to display. Each entry has a name (label) and a value.
15
+ - `height: number` = 300 — The height of the chart in pixels. @default 300
16
+ - `width: string | number` = "100%" — The width of the chart (e.g., "100%", 500). @default "100%"
17
+ - `title: string` — Optional title displayed above the chart.
18
+ - `donut: boolean` = false — If true, renders as a donut chart with a hollow center. @default false
19
+ - `animated: boolean` = false — If true, animates the chart on mount. @default false
20
+ - `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.
21
+
22
+ ---
23
+ Setup, composition rules and the full catalog: `llms.txt` / `llms-full.txt` in the same package.
@@ -0,0 +1,41 @@
1
+ # PivotTable — wimui
2
+
3
+ > Draws aggregated data as a table with multi-level row and column headings, subtotals and grand totals.
4
+
5
+ Also known as: Pivot, Cross Tab, Crosstab
6
+
7
+ ## Import
8
+
9
+ ```ts
10
+ import "wimui/styles.css"; // once per app — required
11
+ import { PivotTable } from "wimui/data-display";
12
+ ```
13
+
14
+ ## Props
15
+
16
+ - `rows: PivotTableAxisNode[]` (required) — The row axis as a tree. Groups are drawn as an outline: one indented row per node.
17
+ - `columns: PivotTableAxisNode[]` (required) — The column axis as a tree. Groups become headings that span their columns.
18
+ - `getValue: (rowKey: string | null, columnKey: string | null) => React.ReactNode` (required) — Returns the content of one cell. The component does not aggregate: a group key asks for that group's subtotal and `null` asks for the grand total of that axis. Return `null` or `undefined` for an empty cell. Group keys are asked on both axes: a row group for its own row, a column group for its subtotal column and for the single column it leaves when it is collapsed.
19
+ - `rowAxisLabel: React.ReactNode` — Heading of the row axis, shown in the top-left corner.
20
+ - `caption: React.ReactNode` — Visible title of the table, also its accessible name.
21
+ - `expandedRowValues: string[]` — Keys of the expanded row groups (controlled). A group that is not listed shows only its own row, which carries its subtotal.
22
+ - `defaultExpandedRowValues: string[]` — Row groups expanded on first render (uncontrolled). Defaults to every group.
23
+ - `onExpandedRowChange: (values: string[]) => void` — Called with the new list of expanded row groups when a row group is expanded or collapsed.
24
+ - `expandedColumnValues: string[]` — Keys of the expanded column groups (controlled). A group that is not listed shows a single column, which carries its subtotal: `getValue` receives the group's key.
25
+ - `defaultExpandedColumnValues: string[]` — Column groups expanded on first render (uncontrolled). Defaults to every group.
26
+ - `onExpandedColumnChange: (values: string[]) => void` — Called with the new list of expanded column groups when a column group is expanded or collapsed.
27
+ - `maxHeight: string | number` — Maximum height of the table (a number is px). Past it the table scrolls vertically inside its own box.
28
+ - `stickyHeader: boolean` = false — Keeps the column headings in view while the table scrolls vertically. Every heading level stays, stacked in order. Only has an effect together with `maxHeight`.
29
+ - `stickyRowHeaders: boolean` = false — Keeps the row headings in view while the table scrolls sideways. The column is only pinned while it takes at most half of the visible width; in a narrower container it scrolls with the rest, so that the values stay readable.
30
+ - `virtualized: boolean` = false — Renders only the rows in view (plus a few around them) and keeps the scroll height with empty spacer rows. Use it for tables with hundreds of rows, together with `maxHeight`. Rows must all have the same height, so keep labels and values on one line.
31
+ - `columnSubtotals: boolean` = false — Adds a subtotal column after the columns of each expanded column group.
32
+ - `totalRow: boolean` = false — Adds a grand total row at the bottom.
33
+ - `totalColumn: boolean` = false — Adds a grand total column at the right edge.
34
+ - `labels: { /** Heading of the grand total row / column and of each subtotal column. */ total?: string; }` — Text of the total headings, for when the built-in translations do not fit.
35
+
36
+ ## Design tokens it reads
37
+
38
+ `--wim-border-width-thick`, `--wim-border-width-thin`, `--wim-color-border`, `--wim-color-border-secondary`, `--wim-color-focus-outline`, `--wim-color-surface`, `--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-weight-medium`, `--wim-font-weight-normal`, `--wim-font-weight-semibold`, `--wim-pivot-table-depth`, `--wim-radius-component`, `--wim-scale-active-sm`, `--wim-spacing-2xl`, `--wim-spacing-3xl`, `--wim-spacing-xs`, `--wim-table-cell-padding-x`, `--wim-table-cell-padding-y`, `--wim-table-row-bg`, `--wim-tap-target-min`, `--wim-transition-fast`, `--wim-width-sm`
39
+
40
+ ---
41
+ Setup, composition rules and the full catalog: `llms.txt` / `llms-full.txt` in the same package.
@@ -0,0 +1,13 @@
1
+ # PlatformIcons — wimui
2
+
3
+ > Display supported platform icons
4
+
5
+ ## Import
6
+
7
+ ```ts
8
+ import "wimui/styles.css"; // once per app — required
9
+ import { PlatformIcons } 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,30 @@
1
+ # Popconfirm — wimui
2
+
3
+ > Confirmation overlay
4
+
5
+ ## Import
6
+
7
+ ```ts
8
+ import "wimui/styles.css"; // once per app — required
9
+ import { Popconfirm } from "wimui/overlay";
10
+ ```
11
+
12
+ ## Props
13
+
14
+ - `title: ReactNode` (required) — The title of the confirmation box
15
+ - `description: ReactNode` — The description of the confirmation box
16
+ - `onConfirm: () => void` — Callback when the user clicks the confirm button
17
+ - `onCancel: () => void` — Callback when the user clicks the cancel button
18
+ - `okText: ReactNode` = "OK" — Text of the confirm button
19
+ - `cancelText: ReactNode` = "Cancel" — Text of the cancel button
20
+ - `okType: "default" | "danger" | "success"` = "default" — Color role of the confirm button
21
+ - `children: ReactNode` (required) — The target element which the Popconfirm will be attached to
22
+ - `icon: ReactNode` — Customize the icon
23
+ - `disabled: boolean` = false — Whether to show the popconfirm
24
+
25
+ ## Design tokens it reads
26
+
27
+ `--wim-border-width-thin`, `--wim-color-border`, `--wim-color-surface`, `--wim-color-text-primary`, `--wim-color-text-secondary`, `--wim-font-size-sm`, `--wim-font-size-xs`, `--wim-font-weight-medium`, `--wim-menu-min-width`, `--wim-overlay-max-width-sm`, `--wim-radius-overlay`, `--wim-shadow-overlay`, `--wim-spacing-2xs`, `--wim-spacing-md`, `--wim-spacing-sm`, `--wim-spacing-xs`, `--wim-z-overlay`
28
+
29
+ ---
30
+ Setup, composition rules and the full catalog: `llms.txt` / `llms-full.txt` in the same package.
@@ -0,0 +1,27 @@
1
+ # Popover — wimui
2
+
3
+ > Contextual overlay
4
+
5
+ ## Import
6
+
7
+ ```ts
8
+ import "wimui/styles.css"; // once per app — required
9
+ import { Popover } from "wimui/overlay";
10
+ ```
11
+
12
+ ## Props
13
+
14
+ - `children: ReactNode` (required) — Popover parts (PopoverTrigger, PopoverContent, etc.).
15
+ - `className: string` — Additional CSS class name for the container.
16
+ - `defaultOpen: boolean` = false — If true, the popover component will manage its own open state.
17
+ - `open: boolean` — If provided, controls the open state.
18
+ - `onOpenChange: (open: boolean) => void` — Callback when open state changes.
19
+ - `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.
20
+ - `variant: "default" | "glass"` = "default" — The variant of the popover content.
21
+
22
+ ## Design tokens it reads
23
+
24
+ `--wim-border-width-thin`, `--wim-color-border`, `--wim-color-glass-bg`, `--wim-color-glass-blur`, `--wim-color-glass-border`, `--wim-color-shadow-glass`, `--wim-color-surface`, `--wim-color-text-primary`, `--wim-color-text-secondary`, `--wim-menu-min-width`, `--wim-radius-overlay`, `--wim-shadow-overlay`, `--wim-spacing-2xl`, `--wim-spacing-md`, `--wim-spacing-sm`, `--wim-tap-target-min`, `--wim-z-overlay`
25
+
26
+ ---
27
+ Setup, composition rules and the full catalog: `llms.txt` / `llms-full.txt` in the same package.
@@ -0,0 +1,18 @@
1
+ # Portal — wimui
2
+
3
+ > Out-of-hierarchy render
4
+
5
+ ## Import
6
+
7
+ ```ts
8
+ import "wimui/styles.css"; // once per app — required
9
+ import { Portal } from "wimui/overlay";
10
+ ```
11
+
12
+ ## Props
13
+
14
+ - `children: React.ReactNode` (required) — The content to be rendered in the portal
15
+ - `container: HTMLElement | null` — The container where the portal will be rendered. Defaults to document.body
16
+
17
+ ---
18
+ Setup, composition rules and the full catalog: `llms.txt` / `llms-full.txt` in the same package.
@@ -0,0 +1,26 @@
1
+ # Presence — wimui
2
+
3
+ > Shows whether a person is online, away, busy, or offline.
4
+
5
+ ## Import
6
+
7
+ ```ts
8
+ import "wimui/styles.css"; // once per app — required
9
+ import { Presence } from "wimui/data-display";
10
+ ```
11
+
12
+ ## Props
13
+
14
+ - `status: "online" | "away" | "busy" | "offline"` (required) — Availability of the person or resource.
15
+ - `label: string` — Text for the status. Defaults to the localized name of `status`.
16
+ - `showLabel: boolean` = false — Whether the label is shown next to the dot. The label is always exposed to assistive technology; this only controls whether it is also visible. @default false
17
+ - `size: "sm" | "md" | "lg"` = "md" — Size of the dot. @default "md"
18
+ - `position: "top-right" | "top-left" | "bottom-right" | "bottom-left"` = "bottom-right" — Corner the dot is placed at. Only applies when `children` is given. @default "bottom-right"
19
+ - `children: React.ReactNode` — Element the dot is attached to, typically an `Avatar`. Without it the dot renders inline, next to whatever follows it.
20
+
21
+ ## Design tokens it reads
22
+
23
+ `--wim-color-text-secondary`, `--wim-font-family-default`, `--wim-font-size-sm`, `--wim-font-weight-medium`, `--wim-spacing-xs`
24
+
25
+ ---
26
+ Setup, composition rules and the full catalog: `llms.txt` / `llms-full.txt` in the same package.
@@ -0,0 +1,29 @@
1
+ # Progress — wimui
2
+
3
+ > Progress bar
4
+
5
+ ⚠️ Not the same as elsewhere: Material's "Progress Indicator" covers indeterminate spinners as well. WIM's `Progress` is determinate and linear only — for the indeterminate case use `Spinner`.
6
+
7
+ ## Import
8
+
9
+ ```ts
10
+ import "wimui/styles.css"; // once per app — required
11
+ import { Progress } from "wimui/feedback";
12
+ ```
13
+
14
+ ## Props
15
+
16
+ - `value: number` = 0 — Current value of the progress bar. @default 0
17
+ - `max: number` = 100 — Maximum value of the progress bar. @default 100
18
+ - `intent: "primary" | "success" | "warning" | "danger" | "info" | "neutral"` = "primary" — Intent (semantic color) of the bar. @default "primary"
19
+ - `size: "sm" | "md" | "lg"` = "md" — Size of the bar. @default "md"
20
+ - `label: string` — Text label displayed above the bar. Also used as the accessible name unless `aria-label` / `aria-labelledby` is given. A progress bar always carries `role="progressbar"`, and a progressbar with no accessible name is a WCAG failure (axe `aria-progressbar-name`, serious). The type therefore requires one of `label` / `aria-label` / `aria-labelledby`.
21
+ - `showValue: boolean` = false — Whether to display the current value as a percentage. @default false
22
+ - `indeterminate: boolean` = false — If true, shows an indeterminate animation instead of a value. @default false
23
+
24
+ ## Design tokens it reads
25
+
26
+ `--wim-color-danger`, `--wim-color-disabled`, `--wim-color-info`, `--wim-color-primary`, `--wim-color-success`, `--wim-color-surface-variant`, `--wim-color-text-secondary`, `--wim-color-warning`, `--wim-duration-base`, `--wim-easing-standard`, `--wim-font-size-sm`, `--wim-progress-width`, `--wim-radius-full`, `--wim-spacing-lg`, `--wim-spacing-md`, `--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,27 @@
1
+ # ProgressRing — wimui
2
+
3
+ > ProgressRing description.
4
+
5
+ ## Import
6
+
7
+ ```ts
8
+ import "wimui/styles.css"; // once per app — required
9
+ import { ProgressRing } from "wimui/feedback";
10
+ ```
11
+
12
+ ## Props
13
+
14
+ - `value: number` = 0 — Current value of the progress ring. @default 0
15
+ - `max: number` = 100 — Maximum value of the progress ring. @default 100
16
+ - `intent: "primary" | "success" | "warning" | "danger" | "info" | "neutral"` = "primary" — Intent (semantic color) of the ring. @default "primary"
17
+ - `size: "sm" | "md" | "lg"` = "md" — Size of the ring. @default "md"
18
+ - `label: string` — Text label displayed below the ring. Also used as the accessible name unless `aria-label` / `aria-labelledby` is given. A progress ring always carries `role="progressbar"`, and a progressbar with no accessible name is a WCAG failure (axe `aria-progressbar-name`, serious). The type therefore requires one of `label` / `aria-label` / `aria-labelledby`.
19
+ - `showValue: boolean` = false — Whether to display the current value as a percentage inside the ring. @default false
20
+ - `indeterminate: boolean` = false — If true, shows an indeterminate animation instead of a value. @default false
21
+
22
+ ## Design tokens it reads
23
+
24
+ `--wim-color-danger`, `--wim-color-info`, `--wim-color-neutral-fill`, `--wim-color-primary`, `--wim-color-success`, `--wim-color-surface-variant`, `--wim-color-text-primary`, `--wim-color-text-secondary`, `--wim-color-warning`, `--wim-duration-base`, `--wim-duration-circle`, `--wim-easing-standard`, `--wim-font-size-md`, `--wim-font-size-sm`, `--wim-font-size-xs`, `--wim-font-weight-semibold`, `--wim-height-lg`, `--wim-height-md`, `--wim-height-sm`, `--wim-height-xl`, `--wim-progress-ring-size`, `--wim-progress-ring-thickness`, `--wim-progress-ring-value`, `--wim-progress-ring-value-font-size`, `--wim-spacing-lg`, `--wim-spacing-md`, `--wim-spacing-xs`
25
+
26
+ ---
27
+ Setup, composition rules and the full catalog: `llms.txt` / `llms-full.txt` in the same package.
@@ -0,0 +1,37 @@
1
+ # PromptInput — wimui
2
+
3
+ > Interactive input optimized for AI prompt engineering with multi-line support and action triggers.
4
+
5
+ ## Import
6
+
7
+ ```ts
8
+ import "wimui/styles.css"; // once per app — required
9
+ import { PromptInput } from "wimui/ai";
10
+ ```
11
+
12
+ ## Props
13
+
14
+ - `value: string` — Current text value (controlled)
15
+ - `defaultValue: string` = "" — Default value (uncontrolled)
16
+ - `onChange: (value: string) => void` — Callback when value changes
17
+ - `onSubmit: (value: string) => void` — Callback when user submits (Enter or button click)
18
+ - `placeholder: string` — Placeholder text
19
+ - `maxLength: number` — Maximum number of characters
20
+ - `disabled: boolean` = false — Whether the input is disabled
21
+ - `loading: boolean` = false — Whether the input is in a loading state
22
+ - `showAttach: boolean` = false — Whether to show the attachment button
23
+ - `onAttach: () => void` — Callback when attachment button is clicked
24
+ - `maxRows: number` = 8 — Maximum number of rows to show before scrolling
25
+ - `fullWidth: boolean` = false — Whether the input should take up the full width of its container
26
+ - `className: string` — Additional CSS class
27
+ - `label: React.ReactNode` — Label for the field
28
+ - `error: string` — Error message
29
+ - `required: boolean` — Whether the field is required
30
+ - `layout: "vertical" | "horizontal"` — Layout of the field
31
+
32
+ ## Design tokens it reads
33
+
34
+ `--wim-border-width-thick`, `--wim-border-width-thin`, `--wim-color-disabled`, `--wim-color-ghost-bg-hover`, `--wim-color-line`, `--wim-color-primary`, `--wim-color-surface`, `--wim-color-text-accent`, `--wim-color-text-on-disabled`, `--wim-color-text-primary`, `--wim-color-text-secondary`, `--wim-color-text-tertiary`, `--wim-duration-fast`, `--wim-easing-standard`, `--wim-field-radius`, `--wim-font-size-md`, `--wim-height-md`, `--wim-line-height-normal`, `--wim-opacity-disabled`, `--wim-radius-component`, `--wim-shadow-error-ring`, `--wim-shadow-focus-ring`, `--wim-spacing-2xs`, `--wim-spacing-md`, `--wim-spacing-sm`, `--wim-spacing-xs`, `--wim-width-md`, `--wim-width-sm`
35
+
36
+ ---
37
+ Setup, composition rules and the full catalog: `llms.txt` / `llms-full.txt` in the same package.
@@ -0,0 +1,26 @@
1
+ # PullToRefresh — wimui
2
+
3
+ > Pull-to-refresh utility for enhancing mobile user experience.
4
+
5
+ ## Import
6
+
7
+ ```ts
8
+ import "wimui/styles.css"; // once per app — required
9
+ import { PullToRefresh } from "wimui/data-display";
10
+ ```
11
+
12
+ ## Props
13
+
14
+ - `onRefresh: () => Promise<void> | void` (required) — Callback when refresh is triggered. Should return a promise.
15
+ - `refreshing: boolean` — Whether the refreshing is currently in progress (controlled)
16
+ - `threshold: number` = 60 — Distance in pixels to pull before triggering refresh
17
+ - `maxDistance: number` = 120 — Maximum distance in pixels the container can be pulled
18
+ - `children: React.ReactNode` (required) — The content to be wrapped and pulled
19
+ - `asChild: boolean` = false — If true, the content div will be rendered as its child
20
+
21
+ ## Design tokens it reads
22
+
23
+ `--wim-border-width-thin`, `--wim-color-border-secondary`, `--wim-color-surface`, `--wim-color-surface-subtle-alpha`, `--wim-color-text-accent`, `--wim-duration-fast`, `--wim-easing-standard`, `--wim-font-size-sm`, `--wim-font-weight-medium`, `--wim-spacing-sm`
24
+
25
+ ---
26
+ Setup, composition rules and the full catalog: `llms.txt` / `llms-full.txt` in the same package.
@@ -0,0 +1,30 @@
1
+ # QRCode — wimui
2
+
3
+ > QR generator
4
+
5
+ ## Import
6
+
7
+ ```ts
8
+ import "wimui/styles.css"; // once per app — required
9
+ import { QRCode } from "wimui/data-display";
10
+ ```
11
+
12
+ ## Props
13
+
14
+ - `value: string` (required) — Value encoded in the QR code
15
+ - `size: number` = 128 — Size of the QR code in px
16
+ - `level: "L" | "M" | "Q" | "H"` = "M" — Error correction level
17
+ - `bgColor: string` = "var(--wim-color-surface)" — Background color
18
+ - `fgColor: string` = "var(--wim-color-text-primary)" — Foreground (module) color
19
+ - `marginSize: number` = 0 — Size of the quiet-zone margin, in modules
20
+ - `renderAs: "svg" | "canvas"` = "svg" — Whether to render as an SVG or a canvas
21
+ - `imageSettings: React.ComponentProps<typeof QRCodeSVG>["imageSettings"]` — Settings for an image embedded in the center of the QR code
22
+ - `className: string` — Additional class names
23
+ - `aria-label: string` — Accessible label describing what the QR code represents
24
+
25
+ ## Design tokens it reads
26
+
27
+ `--wim-border-width-thin`, `--wim-color-border-secondary`, `--wim-color-white`, `--wim-radius-component`, `--wim-spacing-md`
28
+
29
+ ---
30
+ Setup, composition rules and the full catalog: `llms.txt` / `llms-full.txt` in the same package.