wimui 0.69.1 → 0.71.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 (282) hide show
  1. package/dist/components/_internal/typeahead.cjs +2 -0
  2. package/dist/components/_internal/typeahead.d.ts +45 -0
  3. package/dist/components/_internal/typeahead.js +24 -0
  4. package/dist/components/_internal/useAnnounce.cjs +1 -1
  5. package/dist/components/_internal/useAnnounce.d.ts +22 -0
  6. package/dist/components/_internal/useAnnounce.js +36 -19
  7. package/dist/components/ai/CodeDiffViewer/CodeDiffViewer.cjs +2 -2
  8. package/dist/components/ai/CodeDiffViewer/CodeDiffViewer.js +106 -105
  9. package/dist/components/ai/ModelSelector/ModelSelector.cjs +1 -1
  10. package/dist/components/ai/ModelSelector/ModelSelector.js +119 -119
  11. package/dist/components/ai/StreamingText/StreamingText.cjs +1 -1
  12. package/dist/components/ai/StreamingText/StreamingText.d.ts +1 -1
  13. package/dist/components/ai/StreamingText/StreamingText.js +37 -23
  14. package/dist/components/data-display/DataGrid/DataGrid.cjs +1 -1
  15. package/dist/components/data-display/DataGrid/DataGrid.js +41 -40
  16. package/dist/components/data-display/InfiniteScroll/InfiniteScroll.cjs +1 -1
  17. package/dist/components/data-display/InfiniteScroll/InfiniteScroll.d.ts +1 -1
  18. package/dist/components/data-display/InfiniteScroll/InfiniteScroll.js +37 -26
  19. package/dist/components/feedback/Spinner/Spinner.cjs +1 -1
  20. package/dist/components/feedback/Spinner/Spinner.js +53 -43
  21. package/dist/components/form/Cascader/Cascader.cjs +1 -1
  22. package/dist/components/form/Cascader/Cascader.js +168 -151
  23. package/dist/components/form/Combobox/Combobox.cjs +1 -1
  24. package/dist/components/form/Combobox/Combobox.js +48 -47
  25. package/dist/components/form/MultiSelect/MultiSelect.cjs +1 -1
  26. package/dist/components/form/MultiSelect/MultiSelect.js +131 -111
  27. package/dist/components/form/Select/useSelect.cjs +1 -1
  28. package/dist/components/form/Select/useSelect.js +83 -75
  29. package/dist/components/form/Transfer/Transfer.cjs +1 -1
  30. package/dist/components/form/Transfer/Transfer.js +147 -142
  31. package/dist/components/media/Gallery/Gallery.cjs +1 -1
  32. package/dist/components/media/Gallery/Gallery.js +111 -110
  33. package/dist/components/navigation/Menubar/Menubar.cjs +1 -1
  34. package/dist/components/navigation/Menubar/Menubar.js +133 -122
  35. package/dist/components/overlay/Dropdown/Dropdown.cjs +1 -1
  36. package/dist/components/overlay/Dropdown/Dropdown.js +131 -122
  37. package/dist/components/overlay/Menu/Menu.cjs +1 -1
  38. package/dist/components/overlay/Menu/Menu.js +100 -89
  39. package/dist/hooks/useBreakpoint.d.ts +1 -0
  40. package/dist/i18n/generated/data-display.cjs +1 -1
  41. package/dist/i18n/generated/data-display.d.ts +1 -1
  42. package/dist/i18n/generated/data-display.js +6 -3
  43. package/dist/index.cjs +1 -1
  44. package/dist/index.js +18 -18
  45. package/dist/llms/AIResponseFeedback.md +26 -0
  46. package/dist/llms/Accordion.md +47 -0
  47. package/dist/llms/Affix.md +25 -0
  48. package/dist/llms/AgentStatus.md +25 -0
  49. package/dist/llms/Alert.md +28 -0
  50. package/dist/llms/Anchor.md +30 -0
  51. package/dist/llms/AppShell.md +52 -0
  52. package/dist/llms/AreaChart.md +27 -0
  53. package/dist/llms/ArtifactsOverlay.md +27 -0
  54. package/dist/llms/AspectRatio.md +22 -0
  55. package/dist/llms/Audio.md +44 -0
  56. package/dist/llms/Autosave.md +23 -0
  57. package/dist/llms/Avatar.md +27 -0
  58. package/dist/llms/AvatarGroup.md +28 -0
  59. package/dist/llms/BackTop.md +32 -0
  60. package/dist/llms/Badge.md +28 -0
  61. package/dist/llms/Banner.md +28 -0
  62. package/dist/llms/BarChart.md +26 -0
  63. package/dist/llms/Barcode.md +26 -0
  64. package/dist/llms/BentoGrid.md +25 -0
  65. package/dist/llms/Blockquote.md +26 -0
  66. package/dist/llms/BottomSheet.md +26 -0
  67. package/dist/llms/Box.md +44 -0
  68. package/dist/llms/BoxPlot.md +25 -0
  69. package/dist/llms/Breadcrumb.md +31 -0
  70. package/dist/llms/Button.md +33 -0
  71. package/dist/llms/ButtonGroup.md +27 -0
  72. package/dist/llms/Calendar.md +34 -0
  73. package/dist/llms/CalendarHeatmap.md +33 -0
  74. package/dist/llms/CandlestickChart.md +25 -0
  75. package/dist/llms/Canvas.md +13 -0
  76. package/dist/llms/Card.md +41 -0
  77. package/dist/llms/Carousel.md +33 -0
  78. package/dist/llms/Cascader.md +40 -0
  79. package/dist/llms/Center.md +40 -0
  80. package/dist/llms/Charts.md +13 -0
  81. package/dist/llms/ChatUI.md +17 -0
  82. package/dist/llms/Checkbox.md +24 -0
  83. package/dist/llms/CheckboxGroup.md +32 -0
  84. package/dist/llms/Chip.md +36 -0
  85. package/dist/llms/Code.md +25 -0
  86. package/dist/llms/CodeBlock.md +27 -0
  87. package/dist/llms/CodeDiffViewer.md +30 -0
  88. package/dist/llms/ColorInput.md +48 -0
  89. package/dist/llms/ColorPicker.md +46 -0
  90. package/dist/llms/Combobox.md +37 -0
  91. package/dist/llms/CommandPalette.md +25 -0
  92. package/dist/llms/Comment.md +35 -0
  93. package/dist/llms/Container.md +45 -0
  94. package/dist/llms/ContextMenu.md +25 -0
  95. package/dist/llms/ContrastChecker.md +13 -0
  96. package/dist/llms/Controls.md +13 -0
  97. package/dist/llms/CopyButton.md +26 -0
  98. package/dist/llms/Countdown.md +31 -0
  99. package/dist/llms/CounterTextarea.md +32 -0
  100. package/dist/llms/CreditCardInput.md +42 -0
  101. package/dist/llms/Dashboard.md +31 -0
  102. package/dist/llms/DataGrid.md +43 -0
  103. package/dist/llms/DatePicker.md +39 -0
  104. package/dist/llms/DateRangePicker.md +30 -0
  105. package/dist/llms/DescriptionList.md +26 -0
  106. package/dist/llms/Dialog.md +57 -0
  107. package/dist/llms/Divider.md +24 -0
  108. package/dist/llms/Drawer.md +29 -0
  109. package/dist/llms/Dropdown.md +50 -0
  110. package/dist/llms/Dropzone.md +36 -0
  111. package/dist/llms/EmptyState.md +23 -0
  112. package/dist/llms/ErrorBoundary.md +25 -0
  113. package/dist/llms/FAQSection.md +24 -0
  114. package/dist/llms/FieldError.md +19 -0
  115. package/dist/llms/FieldTemplate.md +30 -0
  116. package/dist/llms/Fieldset.md +24 -0
  117. package/dist/llms/FileUpload.md +40 -0
  118. package/dist/llms/Flex.md +23 -0
  119. package/dist/llms/FloatButton.md +36 -0
  120. package/dist/llms/FocusTrap.md +20 -0
  121. package/dist/llms/Footer.md +32 -0
  122. package/dist/llms/FunnelChart.md +24 -0
  123. package/dist/llms/Gallery.md +30 -0
  124. package/dist/llms/GanttChart.md +29 -0
  125. package/dist/llms/GaugeChart.md +30 -0
  126. package/dist/llms/Grid.md +30 -0
  127. package/dist/llms/Group.md +22 -0
  128. package/dist/llms/HamburgerMenu.md +30 -0
  129. package/dist/llms/Header.md +30 -0
  130. package/dist/llms/Heatmap.md +25 -0
  131. package/dist/llms/Highlight.md +26 -0
  132. package/dist/llms/HoverCard.md +26 -0
  133. package/dist/llms/Icon.md +25 -0
  134. package/dist/llms/IconButton.md +30 -0
  135. package/dist/llms/Image.md +46 -0
  136. package/dist/llms/ImageCompare.md +35 -0
  137. package/dist/llms/ImageCropper.md +34 -0
  138. package/dist/llms/Indicator.md +28 -0
  139. package/dist/llms/InfiniteScroll.md +28 -0
  140. package/dist/llms/InlineEdit.md +32 -0
  141. package/dist/llms/Input.md +46 -0
  142. package/dist/llms/InputBase.md +39 -0
  143. package/dist/llms/InputGroup.md +23 -0
  144. package/dist/llms/InputMask.md +44 -0
  145. package/dist/llms/InteractiveArea.md +32 -0
  146. package/dist/llms/InteractiveGraph.md +28 -0
  147. package/dist/llms/JsonDiffViewer.md +24 -0
  148. package/dist/llms/JsonViewer.md +26 -0
  149. package/dist/llms/Kanban.md +25 -0
  150. package/dist/llms/Kbd.md +23 -0
  151. package/dist/llms/KeyboardShortcuts.md +25 -0
  152. package/dist/llms/Label.md +27 -0
  153. package/dist/llms/Leaderboard.md +24 -0
  154. package/dist/llms/Legend.md +27 -0
  155. package/dist/llms/Lightbox.md +47 -0
  156. package/dist/llms/LineChart.md +26 -0
  157. package/dist/llms/Link.md +28 -0
  158. package/dist/llms/LinkButton.md +23 -0
  159. package/dist/llms/List.md +35 -0
  160. package/dist/llms/Loader.md +23 -0
  161. package/dist/llms/LoadingOverlay.md +30 -0
  162. package/dist/llms/Markdown.md +24 -0
  163. package/dist/llms/MarkdownRenderer.md +24 -0
  164. package/dist/llms/Marquee.md +27 -0
  165. package/dist/llms/Masonry.md +18 -0
  166. package/dist/llms/Mentions.md +24 -0
  167. package/dist/llms/Menu.md +30 -0
  168. package/dist/llms/Menubar.md +50 -0
  169. package/dist/llms/Meta.md +13 -0
  170. package/dist/llms/ModelSelector.md +31 -0
  171. package/dist/llms/MultiSelect.md +38 -0
  172. package/dist/llms/Navbar.md +58 -0
  173. package/dist/llms/NodeGraph.md +38 -0
  174. package/dist/llms/Notification.md +30 -0
  175. package/dist/llms/NumberInput.md +23 -0
  176. package/dist/llms/OtpInput.md +33 -0
  177. package/dist/llms/OverflowList.md +31 -0
  178. package/dist/llms/Pagination.md +39 -0
  179. package/dist/llms/PasswordInput.md +39 -0
  180. package/dist/llms/PasswordStrength.md +34 -0
  181. package/dist/llms/PhoneInput.md +35 -0
  182. package/dist/llms/PieChart.md +23 -0
  183. package/dist/llms/PivotTable.md +41 -0
  184. package/dist/llms/PlatformIcons.md +13 -0
  185. package/dist/llms/Popconfirm.md +30 -0
  186. package/dist/llms/Popover.md +27 -0
  187. package/dist/llms/Portal.md +18 -0
  188. package/dist/llms/Presence.md +26 -0
  189. package/dist/llms/Progress.md +29 -0
  190. package/dist/llms/ProgressRing.md +27 -0
  191. package/dist/llms/PromptInput.md +37 -0
  192. package/dist/llms/PullToRefresh.md +26 -0
  193. package/dist/llms/QRCode.md +30 -0
  194. package/dist/llms/QueryBuilder.md +31 -0
  195. package/dist/llms/RadarChart.md +24 -0
  196. package/dist/llms/Radio.md +23 -0
  197. package/dist/llms/RadioGroup.md +32 -0
  198. package/dist/llms/RangeCalendar.md +26 -0
  199. package/dist/llms/RangeSlider.md +39 -0
  200. package/dist/llms/Rating.md +37 -0
  201. package/dist/llms/Reaction.md +26 -0
  202. package/dist/llms/RefTable.md +13 -0
  203. package/dist/llms/RelativeTime.md +24 -0
  204. package/dist/llms/Result.md +29 -0
  205. package/dist/llms/RichTextEditor.md +59 -0
  206. package/dist/llms/SankeyChart.md +26 -0
  207. package/dist/llms/ScatterChart.md +26 -0
  208. package/dist/llms/ScheduleView.md +35 -0
  209. package/dist/llms/ScrollArea.md +24 -0
  210. package/dist/llms/ScrollProgress.md +22 -0
  211. package/dist/llms/SearchInput.md +44 -0
  212. package/dist/llms/SegmentedControl.md +40 -0
  213. package/dist/llms/Select.md +44 -0
  214. package/dist/llms/SelectionBar.md +28 -0
  215. package/dist/llms/Sidebar.md +47 -0
  216. package/dist/llms/SignaturePad.md +36 -0
  217. package/dist/llms/SimpleGrid.md +24 -0
  218. package/dist/llms/Skeleton.md +26 -0
  219. package/dist/llms/Slider.md +36 -0
  220. package/dist/llms/SmartSearchInput.md +35 -0
  221. package/dist/llms/Snackbar.md +30 -0
  222. package/dist/llms/SortableList.md +33 -0
  223. package/dist/llms/SourceCitation.md +28 -0
  224. package/dist/llms/SourceCode.md +13 -0
  225. package/dist/llms/Span.md +29 -0
  226. package/dist/llms/Sparkline.md +27 -0
  227. package/dist/llms/SpeedDial.md +28 -0
  228. package/dist/llms/Spinner.md +26 -0
  229. package/dist/llms/SplitButton.md +29 -0
  230. package/dist/llms/Splitter.md +37 -0
  231. package/dist/llms/Spoiler.md +26 -0
  232. package/dist/llms/Stack.md +48 -0
  233. package/dist/llms/Stats.md +44 -0
  234. package/dist/llms/Stepper.md +32 -0
  235. package/dist/llms/StreamingText.md +24 -0
  236. package/dist/llms/SwipeAction.md +28 -0
  237. package/dist/llms/SwipeableList.md +21 -0
  238. package/dist/llms/Switch.md +27 -0
  239. package/dist/llms/SwitchGroup.md +31 -0
  240. package/dist/llms/T.md +13 -0
  241. package/dist/llms/TabBar.md +33 -0
  242. package/dist/llms/TabNavigation.md +30 -0
  243. package/dist/llms/Table.md +73 -0
  244. package/dist/llms/Tabs.md +40 -0
  245. package/dist/llms/Tag.md +30 -0
  246. package/dist/llms/TagInput.md +37 -0
  247. package/dist/llms/Terminal.md +29 -0
  248. package/dist/llms/Text.md +31 -0
  249. package/dist/llms/Textarea.md +30 -0
  250. package/dist/llms/ThemeToggle.md +31 -0
  251. package/dist/llms/ThoughtProcess.md +27 -0
  252. package/dist/llms/ThreadList.md +27 -0
  253. package/dist/llms/TimePicker.md +41 -0
  254. package/dist/llms/Timeline.md +24 -0
  255. package/dist/llms/Title.md +27 -0
  256. package/dist/llms/Toast.md +32 -0
  257. package/dist/llms/ToggleGroup.md +39 -0
  258. package/dist/llms/Toolbar.md +35 -0
  259. package/dist/llms/Tooltip.md +29 -0
  260. package/dist/llms/Tour.md +24 -0
  261. package/dist/llms/Transfer.md +35 -0
  262. package/dist/llms/Transition.md +34 -0
  263. package/dist/llms/TreeDiagram.md +33 -0
  264. package/dist/llms/TreeSelect.md +43 -0
  265. package/dist/llms/TreeView.md +50 -0
  266. package/dist/llms/Treemap.md +27 -0
  267. package/dist/llms/UsageMeter.md +31 -0
  268. package/dist/llms/Video.md +46 -0
  269. package/dist/llms/VirtualList.md +31 -0
  270. package/dist/llms/VisuallyHidden.md +19 -0
  271. package/dist/llms/VoiceVisualizer.md +30 -0
  272. package/dist/llms/WaterfallChart.md +25 -0
  273. package/dist/llms/Watermark.md +27 -0
  274. package/dist/llms/colorSwatch.md +13 -0
  275. package/dist/llms-full.txt +6 -3
  276. package/dist/llms.txt +4 -2
  277. package/dist/locales/en/data-display.json +3 -0
  278. package/dist/locales/ja/data-display.json +3 -0
  279. package/dist/locales/pt/data-display.json +3 -0
  280. package/dist/styles.css +1 -1
  281. package/dist/wimui.umd.js +5 -5
  282. package/package.json +11 -4
@@ -0,0 +1,46 @@
1
+ # Video — wimui
2
+
3
+ > A component for embedding and controlling local or remote video content
4
+
5
+ ## Import
6
+
7
+ ```ts
8
+ import "wimui/styles.css"; // once per app — required
9
+ import { Video } from "wimui/media";
10
+ ```
11
+
12
+ ## Props
13
+
14
+ - `src: string` — Source URL of the video
15
+ - `width: string | number` — Width of the video. A number is px; a string is used as is. Never wider than its container. Defaults to 100%.
16
+ - `height: string | number` — Height of the video
17
+ - `autoPlay: boolean` = false — Whether to start playing automatically
18
+ - `loop: boolean` = false — Whether to loop playback
19
+ - `muted: boolean` = false — Whether to start muted
20
+ - `controls: boolean` = true — Whether to show playback controls
21
+ - `poster: string` — Poster image shown before playback
22
+ - `radius: "none" | "sm" | "md" | "lg" | "full"` = "none" — Corner radius size
23
+ - `shadow: boolean` = false — Whether to show a shadow
24
+ - `border: boolean` = false — Whether to show a border
25
+ - `fit: "contain" | "cover" | "fill" | "none" | "scale-down"` = "cover" — How the video fits its box
26
+ - `preload: "auto" | "metadata" | "none"` — Preload behavior
27
+ - `caption: React.ReactNode` — Caption shown below the video
28
+ - `customControls: boolean` = false — Whether to use the custom control bar instead of native controls
29
+ - `advancedControls: boolean` = false — Whether to enable advanced controls (quality, playback rate, etc.)
30
+ - `videoId: string` — Unique ID used to persist and resume playback position
31
+ - `resumePlayback: boolean` = false — Whether to resume playback from the last saved position
32
+ - `playlist: { src: string; title?: string; poster?: string }[]` — Playlist of videos to play in sequence
33
+ - `autoPlayNext: boolean` = false — Whether to automatically play the next playlist item
34
+ - `qualities: { label: string; src: string }[]` — Selectable quality sources
35
+ - `loading: "eager" | "lazy"` = "lazy" — Loading behavior. With "lazy", an Intersection Observer is enabled.
36
+ - `fadeIn: boolean` = false — Whether to fade in when loading completes
37
+ - `demoDelay: number` — Demo only: milliseconds to intentionally delay load completion
38
+ - `labels: { playlist?: string; skipBackward?: string; skipForward?: string; play?: string; pause?: string; nextTrack?: string; seek?: string; mute?: string; unmute?: string; volume?: string; settings?: string; pip?: string; fullscreen?: string; exitFullscreen?: string; quality?: string; playbackRate?: string; aspectRatio?: string; standard?: string; back?: string; auto?: string; fit?: string; fill?: string; contain?: string; cover?: string; scaleDown?: string; none?: string; videoAriaLabel?: string; seconds?: string; // e.g. "seconds" or "秒" }` = {} — Labels for manual translation
39
+ - `tracks: React.ComponentPropsWithoutRef<"track">[]` — Subtitle/caption tracks passed as <track> elements (kind, src, srcLang, label).
40
+
41
+ ## Design tokens it reads
42
+
43
+ `--wim-blur-glass`, `--wim-border-width-thin`, `--wim-color-border`, `--wim-color-focus-outline`, `--wim-color-overlay`, `--wim-color-overlay-strong`, `--wim-color-primary`, `--wim-color-surface-subtle`, `--wim-color-surface-variant`, `--wim-color-surface-void`, `--wim-color-text-on-overlay`, `--wim-color-text-secondary`, `--wim-comp-overlay-control-active`, `--wim-comp-overlay-control-hover`, `--wim-comp-overlay-control-track`, `--wim-comp-overlay-divider`, `--wim-comp-overlay-item-hover`, `--wim-comp-overlay-menu-bg`, `--wim-duration-extra-slow`, `--wim-duration-slow`, `--wim-duration-ultra-slow`, `--wim-easing-entrance`, `--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-font-weight-semibold`, `--wim-height-lg`, `--wim-height-md`, `--wim-height-sm`, `--wim-line-height-snug-jp`, `--wim-radius-component`, `--wim-radius-full`, `--wim-radius-lg`, `--wim-radius-sm`, `--wim-scale-active-sm`, `--wim-shadow-md`, `--wim-shadow-overlay`, `--wim-spacing-2xs`, `--wim-spacing-lg`, `--wim-spacing-md`, `--wim-spacing-sm`, `--wim-spacing-xl`, `--wim-spacing-xs`, `--wim-transition-base`, `--wim-transition-fast`
44
+
45
+ ---
46
+ Setup, composition rules and the full catalog: `llms.txt` / `llms-full.txt` in the same package.
@@ -0,0 +1,31 @@
1
+ # VirtualList — wimui
2
+
3
+ > Efficiently renders large lists by virtualizing off-screen items
4
+
5
+ ## Import
6
+
7
+ ```ts
8
+ import "wimui/styles.css"; // once per app — required
9
+ import { VirtualList } from "wimui/data-display";
10
+ ```
11
+
12
+ ## Props
13
+
14
+ - `items: T[]` (required) — Array of items to display
15
+ - `itemHeight: number` (required) — Height of each row (px)
16
+ - `height: number | string` (required) — Total height of the list (px)
17
+ - `renderItem: (item: T, index: number) => React.ReactNode` (required) — Render function for each item
18
+ - `overscan: number` = 3 — Number of extra items to render outside the visible range
19
+ - `className: string` — Additional class names
20
+ - `itemRole: string` = "listitem" — Role of the element wrapping each item (for accessibility)
21
+ - `role: string` = "list" — Role of the whole list (for accessibility)
22
+ - `aria-label: string` — Accessible label
23
+ - `aria-labelledby: string` — ID of the element that labels the list
24
+ - `aria-describedby: string` — ID of the element that describes the list
25
+
26
+ ## Design tokens it reads
27
+
28
+ `--wim-color-focus-outline`, `--wim-focus-outline-width`, `--wim-list-item-padding-x`, `--wim-list-item-padding-y`
29
+
30
+ ---
31
+ Setup, composition rules and the full catalog: `llms.txt` / `llms-full.txt` in the same package.
@@ -0,0 +1,19 @@
1
+ # VisuallyHidden — wimui
2
+
3
+ > Hide content visually while keeping it accessible to screen readers
4
+
5
+ Also known as: Screen Reader Only, SR Only
6
+
7
+ ## Import
8
+
9
+ ```ts
10
+ import "wimui/styles.css"; // once per app — required
11
+ import { VisuallyHidden } from "wimui/layout";
12
+ ```
13
+
14
+ ## Props
15
+
16
+ - `children: React.ReactNode` (required) — Content that is visually hidden but still read out by screen readers.
17
+
18
+ ---
19
+ Setup, composition rules and the full catalog: `llms.txt` / `llms-full.txt` in the same package.
@@ -0,0 +1,30 @@
1
+ # VoiceVisualizer — wimui
2
+
3
+ > Animated voice-level indicator (bars / waveform)
4
+
5
+ ## Import
6
+
7
+ ```ts
8
+ import "wimui/styles.css"; // once per app — required
9
+ import { VoiceVisualizer } from "wimui/ai";
10
+ ```
11
+
12
+ ## Props
13
+
14
+ - `mode: "bars" | "waveform"` = "bars" — Visualization style
15
+ - `data: unknown` — Normalized amplitude values (0–1) per slot. When omitted, a looping idle animation plays. For bars: one value per bar (with `barCount="auto"` the values are resampled to the bar count). For waveform: time-domain samples.
16
+ - `isActive: boolean` = true — Whether audio is live (recording or playing). When false the visualizer holds still at full strength — a finished recording is not dimmed. Use `disabled` to dim it.
17
+ - `disabled: boolean` = false — Dims the visualizer to show that no audio can be captured or played (e.g. microphone permission not granted)
18
+ - `progress: number` — Playback position (0–1) of a recorded clip. The part before it is drawn in the sentiment color and the rest in a neutral color. Has effect only with `data`.
19
+ - `barCount: number | "auto"` = "auto" — Number of bars — bars mode only. `"auto"` fits as many bars as the width allows (bar width and gap stay fixed); a number draws that many bars as a centered cluster.
20
+ - `height: number | "fill"` = 40 — Rendered height in pixels, or `"fill"` to follow the parent's height (the parent needs a definite height)
21
+ - `className: string` — Additional CSS class
22
+ - `sentiment: "neutral" | "positive" | "caution" | "negative" | "informative"` = "neutral" — Sentiment context for coloring (default 'neutral')
23
+ - `ariaLabel: string` — Accessible label describing the audio; when omitted the visualizer is hidden from assistive tech
24
+
25
+ ## Design tokens it reads
26
+
27
+ `--wim-border-width-thin`, `--wim-color-danger`, `--wim-color-info`, `--wim-color-success`, `--wim-color-text-accent`, `--wim-color-text-danger`, `--wim-color-text-disabled`, `--wim-color-warning`, `--wim-duration-base`, `--wim-easing-standard`, `--wim-opacity-dim`, `--wim-opacity-ghost`
28
+
29
+ ---
30
+ Setup, composition rules and the full catalog: `llms.txt` / `llms-full.txt` in the same package.
@@ -0,0 +1,25 @@
1
+ # WaterfallChart — wimui
2
+
3
+ > Running total broken into its contributions
4
+
5
+ ## Import
6
+
7
+ ```ts
8
+ import "wimui/styles.css"; // once per app — required
9
+ import { WaterfallChart } from "wimui/charts";
10
+ ```
11
+
12
+ ## Props
13
+
14
+ - `data: WaterfallItem[]` (required) — The steps, in the order they are applied.
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
+ - `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.
19
+
20
+ ## Design tokens it reads
21
+
22
+ `--wim-color-text-secondary`, `--wim-font-family-default`, `--wim-font-size-xs`
23
+
24
+ ---
25
+ Setup, composition rules and the full catalog: `llms.txt` / `llms-full.txt` in the same package.
@@ -0,0 +1,27 @@
1
+ # Watermark — wimui
2
+
3
+ > Translucent text or images overlaid on content to indicate ownership or status
4
+
5
+ ## Import
6
+
7
+ ```ts
8
+ import "wimui/styles.css"; // once per app — required
9
+ import { Watermark } from "wimui/layout";
10
+ ```
11
+
12
+ ## Props
13
+
14
+ - `content: string | string[]` — Text content of the watermark (a string or multiple lines)
15
+ - `image: string` — Image URL used as the watermark instead of text
16
+ - `width: number` — Width of a single watermark tile (px)
17
+ - `height: number` — Height of a single watermark tile (px)
18
+ - `rotate: number` — Rotation angle of the watermark (degrees)
19
+ - `zIndex: number` — z-index of the watermark layer
20
+ - `opacity: number` — Opacity of the watermark
21
+ - `gap: [number, number]` — Gap between watermark tiles [x, y] (px)
22
+ - `offset: [number, number]` — Offset of the watermark pattern [x, y] (px)
23
+ - `children: React.ReactNode` — Content overlaid by the watermark
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,13 @@
1
+ # colorSwatch — wimui
2
+
3
+ > Color palette display grid
4
+
5
+ ## Import
6
+
7
+ ```ts
8
+ import "wimui/styles.css"; // once per app — required
9
+ import { colorSwatch } from "wimui";
10
+ ```
11
+
12
+ ---
13
+ Setup, composition rules and the full catalog: `llms.txt` / `llms-full.txt` in the same package.
@@ -4,7 +4,7 @@
4
4
 
5
5
  ## What this is
6
6
 
7
- **wimui** v0.69.1 — a React 19 component library: 230 documented components across 10 categories, with design tokens, dark mode, i18n (en/ja/pt-BR) and WAI-ARIA compliant a11y. Peer deps: react ^19, react-dom ^19 (plus optional peers for specific components — see package.json).
7
+ **wimui** v0.71.0 — a React 19 component library: 230 documented components across 10 categories, with design tokens, dark mode, i18n (en/ja/pt-BR) and WAI-ARIA compliant a11y. Peer deps: react ^19, react-dom ^19 (plus optional peers for specific components — see package.json).
8
8
 
9
9
  ## Install & required setup
10
10
 
@@ -2573,7 +2573,7 @@ in; use `"center"` only when the empty state is the only thing in its region.
2573
2573
  - `hasMore: boolean` = false — Whether there is more data to load.
2574
2574
  - `loading: boolean` = false — Whether data is currently loading.
2575
2575
  - `onLoadMore: () => void` (required) — Callback to load the next batch of data.
2576
- - `loader: React.ReactNode` — Element shown while loading.
2576
+ - `loader: React.ReactNode` — Element shown while loading. Defaults to a spinner with a localized "Loading more…" text. Its text is announced to screen readers when loading starts.
2577
2577
  - `threshold: number` = 250 — Scroll threshold (px). onLoadMore is called when the scroll position gets this close to the bottom.
2578
2578
  - `className: string` — Additional class names.
2579
2579
  - `container: React.RefObject<HTMLElement | null>` — Target whose scroll events are observed (defaults to window).
@@ -3639,4 +3639,7 @@ These exist in other systems' vocabularies and are **decisions, not gaps**. Do n
3639
3639
  - **Parallax Scrolling** (aka Parallax, Scroll Parallax, Parallax Hero) — Backgrounds moving at a different speed from the foreground. The motion does not correspond to any change of state, which is what this system animates. If the goal is to show scroll position, show the position. Use `ScrollProgress` instead.
3640
3640
  - **Text Scramble** (aka Scramble Text, Decrypt Text, Glitch Text) — Randomising characters before settling on the real string. The reader parses the same sentence twice and gets nothing for the lost legibility. The one case where text legitimately arrives character by character is model output, which StreamingText already covers. Use `StreamingText` instead.
3641
3641
  - **Spring Animation** (aka Spring Physics, Springs, Physics-based Animation) — A physics engine (mass / stiffness / damping props solved in a rAF loop). The bounce curve itself already exists as the `--wim-easing-spring` token, which is what press and swipe-return use. Adding the engine would put physics parameters into the public contract and move motion from CSS to JS. Use `--wim-easing-spring` instead.
3642
- - **Choropleth Map** (aka Choropleth, Filled Map, Region Map, Geo Map) — A map shading regions by value. Shipping boundary data would put its size and a political stance on disputed borders into a UI library, and large regions dominate regardless of their values. Regions are compared more accurately in a sorted bar chart. Use `BarChart` instead.
3642
+ - **Choropleth Map** (aka Choropleth, Filled Map, Region Map, Geo Map) — A map shading regions by value. Shipping boundary data would put its size and a political stance on disputed borders into a UI library, and large regions dominate regardless of their values. Regions are compared more accurately in a sorted bar chart. Use `BarChart` instead.
3643
+
3644
+ ---
3645
+ **One component, matching your installed version:** the package ships `dist/llms/<Component>.md` — every prop with its type and default, its sub-components, and the design tokens it reads (e.g. `node_modules/wimui/dist/llms/Select.md`, also exported as `wimui/llms/Select.md`). The hosted copy of this file tracks main and can be ahead of the release you installed.
package/dist/llms.txt CHANGED
@@ -4,7 +4,7 @@
4
4
 
5
5
  ## What this is
6
6
 
7
- **wimui** v0.69.1 — a React 19 component library: 230 documented components across 10 categories, with design tokens, dark mode, i18n (en/ja/pt-BR) and WAI-ARIA compliant a11y. Peer deps: react ^19, react-dom ^19 (plus optional peers for specific components — see package.json).
7
+ **wimui** v0.71.0 — a React 19 component library: 230 documented components across 10 categories, with design tokens, dark mode, i18n (en/ja/pt-BR) and WAI-ARIA compliant a11y. Peer deps: react ^19, react-dom ^19 (plus optional peers for specific components — see package.json).
8
8
 
9
9
  ## Install & required setup
10
10
 
@@ -463,4 +463,6 @@ These exist in other systems' vocabularies and are **decisions, not gaps**. Do n
463
463
  - **Choropleth Map** (aka Choropleth, Filled Map, Region Map, Geo Map) — A map shading regions by value. Shipping boundary data would put its size and a political stance on disputed borders into a UI library, and large regions dominate regardless of their values. Regions are compared more accurately in a sorted bar chart. Use `BarChart` instead.
464
464
 
465
465
  ---
466
- For per-component props, types and defaults, see `llms-full.txt`.
466
+ For per-component props, types and defaults, see `llms-full.txt`.
467
+
468
+ **One component, matching your installed version:** the package ships `dist/llms/<Component>.md` — every prop with its type and default, its sub-components, and the design tokens it reads (e.g. `node_modules/wimui/dist/llms/Select.md`, also exported as `wimui/llms/Select.md`). The hosted copy of this file tracks main and can be ahead of the release you installed.
@@ -18,5 +18,8 @@
18
18
  "selected": "{{count}} selected",
19
19
  "cleared": "Selection cleared",
20
20
  "clear": "Clear selection"
21
+ },
22
+ "infinite_scroll": {
23
+ "loading": "Loading more…"
21
24
  }
22
25
  }
@@ -18,5 +18,8 @@
18
18
  "selected": "{{count}} 件を選択中",
19
19
  "cleared": "選択を解除しました",
20
20
  "clear": "選択を解除"
21
+ },
22
+ "infinite_scroll": {
23
+ "loading": "さらに読み込み中…"
21
24
  }
22
25
  }
@@ -18,5 +18,8 @@
18
18
  "selected": "Selecionados: {{count}}",
19
19
  "cleared": "Seleção removida",
20
20
  "clear": "Limpar seleção"
21
+ },
22
+ "infinite_scroll": {
23
+ "loading": "Carregando mais…"
21
24
  }
22
25
  }