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,46 @@
1
+ # Image — wimui
2
+
3
+ > Image content
4
+
5
+ ## Import
6
+
7
+ ```ts
8
+ import "wimui/styles.css"; // once per app — required
9
+ import { Image } from "wimui/media";
10
+ ```
11
+
12
+ ## Props
13
+
14
+ - `src: string` (required) — Source URL of the image
15
+ - `alt: string` (required) — Alternative text for the image
16
+ - `width: string | number` — Width of the image
17
+ - `height: string | number` — Height of the image
18
+ - `radius: "none" | "sm" | "md" | "lg" | "full"` = "none" — Corner radius size
19
+ - `shadow: boolean` = false — Whether to show a shadow
20
+ - `border: boolean` = false — Whether to show a border
21
+ - `fit: "contain" | "cover" | "fill" | "none" | "scale-down"` = "cover" — How the image fits its box
22
+ - `loading: "eager" | "lazy"` — Lazy-loading behavior
23
+ - `caption: string` — Caption shown below the image
24
+ - `filter: ImageFilterOptions` — Filter applied to the image itself
25
+ - `hoverFilter: ImageFilterOptions` — Filter applied on hover (when omitted, `filter` is kept)
26
+ - `backdropFilter: ImageFilterOptions` — Filter applied to the background (effective with transparent images)
27
+ - `hoverBackdropFilter: ImageFilterOptions` — Filter applied to the background on hover
28
+ - `transition: "none" | "fast" | "normal" | "slow"` = "normal" — Animation speed when switching filters
29
+ - `noise: ("xs" | "sm" | "md" | "lg" | "xl" | "2xl" | "3xl" | "4xl" | "5xl") | "none"` — Intensity of the film-grain (noise) effect
30
+ - `duotone: ImageDuotoneOptions` — Duotone settings
31
+ - `overlay: ImageOverlayOptions` — Overlay settings
32
+ - `zoom: boolean | number` = false — Zoom factor on hover (e.g. 1.1) or true (defaults to 1.05)
33
+ - `tilt: boolean` = false — Tilt effect that follows the mouse
34
+ - `fadeIn: boolean` = false — Whether to fade in when loading completes
35
+ - `blendMode: React.CSSProperties["mixBlendMode"]` — Blend mode of the image itself
36
+ - `bgColor: string` — Background color used for blending
37
+ - `demoDelay: number` — Demo only: milliseconds to intentionally delay load completion
38
+ - `priority: boolean` = false — Whether to raise loading priority (e.g. an LCP candidate; sets fetchpriority="high")
39
+ - `fallback: React.ReactNode` — Custom element shown when loading fails
40
+
41
+ ## Design tokens it reads
42
+
43
+ `--wim-border-width-thin`, `--wim-color-border`, `--wim-color-skeleton-bg`, `--wim-color-skeleton-shine`, `--wim-color-surface-subtle-alpha`, `--wim-color-text-secondary`, `--wim-duration-base`, `--wim-duration-extra-fast`, `--wim-duration-extra-slow`, `--wim-duration-slow`, `--wim-duration-ultra-slow`, `--wim-easing-entrance`, `--wim-easing-standard`, `--wim-font-size-sm`, `--wim-font-size-xs`, `--wim-font-weight-medium`, `--wim-image-backdrop`, `--wim-image-bg-color`, `--wim-image-blend-mode`, `--wim-image-filter`, `--wim-image-hover-backdrop`, `--wim-image-hover-filter`, `--wim-image-noise-opacity`, `--wim-image-overlay-blend`, `--wim-image-overlay-color`, `--wim-image-overlay-hover-opacity`, `--wim-image-overlay-opacity`, `--wim-image-transition-duration`, `--wim-image-zoom-scale`, `--wim-line-height-snug-jp`, `--wim-radius-component`, `--wim-radius-full`, `--wim-radius-lg`, `--wim-radius-sm`, `--wim-shadow-md`, `--wim-spacing-md`, `--wim-spacing-sm`, `--wim-spacing-xs`, `--wim-transition-base`, `--wim-transition-spring`
44
+
45
+ ---
46
+ Setup, composition rules and the full catalog: `llms.txt` / `llms-full.txt` in the same package.
@@ -0,0 +1,35 @@
1
+ # ImageCompare — wimui
2
+
3
+ > ImageCompare overlays two images and reveals them with a draggable divider — a before/after slider for comparing edits, restorations, or AI-generated results against their source.
4
+
5
+ ## Import
6
+
7
+ ```ts
8
+ import "wimui/styles.css"; // once per app — required
9
+ import { ImageCompare } from "wimui/media";
10
+ ```
11
+
12
+ ## Props
13
+
14
+ - `before: string` (required) — Source URL of the "before" image (revealed on the leading side)
15
+ - `after: string` (required) — Source URL of the "after" image (revealed on the trailing side)
16
+ - `beforeAlt: string` = "" — Alternative text for the before image
17
+ - `afterAlt: string` = "" — Alternative text for the after image
18
+ - `beforeLabel: React.ReactNode` — Badge label overlaid on the before side
19
+ - `afterLabel: React.ReactNode` — Badge label overlaid on the after side
20
+ - `defaultPosition: number` = 50 — Initial divider position as a percentage 0–100 (uncontrolled)
21
+ - `position: number` — Divider position as a percentage 0–100 (controlled)
22
+ - `onPositionChange: (position: number) => void` — Callback when the divider position changes
23
+ - `orientation: "horizontal" | "vertical"` = "horizontal" — Direction the divider slides along
24
+ - `width: string | number` — Width of the component
25
+ - `height: string | number` — Height of the component
26
+ - `radius: "none" | "sm" | "md" | "lg" | "full"` = "md" — Corner radius size
27
+ - `labels: { /** Accessible label for the drag handle */ handleAriaLabel?: string; }` — Labels for internationalization
28
+ - `className: string` — Additional class names
29
+
30
+ ## Design tokens it reads
31
+
32
+ `--wim-border-width-thick`, `--wim-border-width-thin`, `--wim-color-border`, `--wim-color-focus-outline`, `--wim-color-overlay-strong`, `--wim-color-surface`, `--wim-color-text-on-overlay`, `--wim-color-text-primary`, `--wim-color-text-secondary`, `--wim-color-white`, `--wim-font-size-xs`, `--wim-radius-full`, `--wim-radius-lg`, `--wim-radius-md`, `--wim-radius-sm`, `--wim-shadow-focus-ring`, `--wim-shadow-md`, `--wim-spacing-2xl`, `--wim-spacing-3xs`, `--wim-spacing-sm`, `--wim-tap-target-min`
33
+
34
+ ---
35
+ Setup, composition rules and the full catalog: `llms.txt` / `llms-full.txt` in the same package.
@@ -0,0 +1,34 @@
1
+ # ImageCropper — wimui
2
+
3
+ > Front-end image cropping and rotation tool.
4
+
5
+ ## Import
6
+
7
+ ```ts
8
+ import "wimui/styles.css"; // once per app — required
9
+ import { ImageCropper } from "wimui/form";
10
+ ```
11
+
12
+ ## Props
13
+
14
+ - `src: string` — URL or data URL of the image to crop
15
+ - `aspectRatio: number` = 1 — Aspect ratio (width / height); 1 produces a square
16
+ - `circular: boolean` = false — Whether to display a circular crop area (for profile images)
17
+ - `onCrop: (dataUrl: string, detail: ImageCropDetail) => void` — Called with the cropped image as a data URL once the crop is confirmed. The second argument describes the crop (offset, zoom, rotation, frame and output size) so it can be redone elsewhere.
18
+ - `showRotation: boolean` = true — Whether to show the rotation button
19
+ - `showZoom: boolean` = true — Whether to show the zoom slider
20
+ - `showApplyButton: boolean` = true — Whether to show the apply button
21
+ - `applyLabel: string` — Label of the apply button
22
+ - `onApply: (dataUrl: string, detail: ImageCropDetail) => void` — Called with the cropped image and the crop detail when the crop is applied (after confirming in the dialog)
23
+ - `onCropError: (error: Error, detail: ImageCropDetail) => void` — Called instead of onCrop and onApply when the image cannot be produced, with the crop detail. The usual cause is an image from another origin drawn without CORS approval: the browser then refuses to read the canvas. Set crossOrigin and serve the image with CORS headers, or crop on the server from the detail.
24
+ - `maxOutputSize: number` — Upper bound, in px, for the longer side of the output image. The crop is taken at the resolution of the source image; without a bound a large photo produces a large data URL.
25
+ - `outputType: "image/png" | "image/jpeg" | "image/webp"` = "image/png" — Image format of the output. "image/png" keeps transparency where the image does not cover the frame. @default "image/png"
26
+ - `outputQuality: number` = 0.92 — Quality from 0 to 1 for "image/jpeg" and "image/webp". Ignored for "image/png". @default 0.92
27
+ - `crossOrigin: "anonymous" | "use-credentials"` — CORS mode used to load the image. Needed to crop an image served from another origin; the server must send matching CORS headers or the image will not load at all.
28
+
29
+ ## Design tokens it reads
30
+
31
+ `--wim-border-width-thick`, `--wim-border-width-thin`, `--wim-color-border`, `--wim-color-border-secondary`, `--wim-color-focus-outline`, `--wim-color-glass-bg`, `--wim-color-surface`, `--wim-color-surface-subtle-alpha`, `--wim-color-surface-void`, `--wim-color-text-secondary`, `--wim-color-white`, `--wim-focus-outline-width`, `--wim-font-size-sm`, `--wim-radius-container`, `--wim-radius-full`, `--wim-spacing-2xl`, `--wim-spacing-3xs`, `--wim-spacing-lg`, `--wim-spacing-md`
32
+
33
+ ---
34
+ Setup, composition rules and the full catalog: `llms.txt` / `llms-full.txt` in the same package.
@@ -0,0 +1,28 @@
1
+ # Indicator — wimui
2
+
3
+ > Small status dots
4
+
5
+ ## Import
6
+
7
+ ```ts
8
+ import "wimui/styles.css"; // once per app — required
9
+ import { Indicator } from "wimui/feedback";
10
+ ```
11
+
12
+ ## Props
13
+
14
+ - `children: React.ReactNode` — Element the indicator dot is attached to. If omitted, only the dot is rendered.
15
+ - `color: T | (string & {})` = "primary" — Color of the dot. Accepts a design token color name or any CSS color value. @default "primary"
16
+ - `size: "sm" | "md" | "lg"` = "md" — Size of the dot. @default "md"
17
+ - `position: "top-right" | "top-left" | "bottom-right" | "bottom-left"` = "top-right" — Corner of the children the dot is placed at. @default "top-right"
18
+ - `pulse: boolean` = false — If true, the dot pulses to draw attention. @default false
19
+ - `inline: boolean` = false — If true, renders the dot inline instead of positioning it on a corner. @default false
20
+ - `className: string` — Additional CSS class name.
21
+ - `style: React.CSSProperties` — Inline styles for the container.
22
+
23
+ ## Design tokens it reads
24
+
25
+ `--wim-border-width-thick`, `--wim-color-danger`, `--wim-color-line`, `--wim-color-primary`, `--wim-color-success`, `--wim-color-surface`, `--wim-color-warning`, `--wim-duration-breathe`, `--wim-easing-gentle`, `--wim-radius-full`
26
+
27
+ ---
28
+ Setup, composition rules and the full catalog: `llms.txt` / `llms-full.txt` in the same package.
@@ -0,0 +1,28 @@
1
+ # InfiniteScroll — wimui
2
+
3
+ > Infinite scroll control
4
+
5
+ ## Import
6
+
7
+ ```ts
8
+ import "wimui/styles.css"; // once per app — required
9
+ import { InfiniteScroll } from "wimui/data-display";
10
+ ```
11
+
12
+ ## Props
13
+
14
+ - `children: React.ReactNode` (required) — Content to display.
15
+ - `hasMore: boolean` = false — Whether there is more data to load.
16
+ - `loading: boolean` = false — Whether data is currently loading.
17
+ - `onLoadMore: () => void` (required) — Callback to load the next batch of data.
18
+ - `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.
19
+ - `threshold: number` = 250 — Scroll threshold (px). onLoadMore is called when the scroll position gets this close to the bottom.
20
+ - `className: string` — Additional class names.
21
+ - `container: React.RefObject<HTMLElement | null>` — Target whose scroll events are observed (defaults to window).
22
+
23
+ ## Design tokens it reads
24
+
25
+ `--wim-spacing-md`
26
+
27
+ ---
28
+ Setup, composition rules and the full catalog: `llms.txt` / `llms-full.txt` in the same package.
@@ -0,0 +1,32 @@
1
+ # InlineEdit — wimui
2
+
3
+ > A component that allows users to switch between a view-only mode and an editable mode in-place.
4
+
5
+ Also known as: Editable Text
6
+
7
+ ## Import
8
+
9
+ ```ts
10
+ import "wimui/styles.css"; // once per app — required
11
+ import { InlineEdit } from "wimui/form";
12
+ ```
13
+
14
+ ## Props
15
+
16
+ - `value: string` — Current text (controlled)
17
+ - `defaultValue: string` — Initial text (uncontrolled)
18
+ - `onChange: (value: string) => void` — Callback when the text changes while editing
19
+ - `onSave: (value: string) => void` — Callback when the edit is confirmed
20
+ - `onCancel: () => void` — Callback when the edit is cancelled
21
+ - `onEdit: () => void` — Callback when editing starts
22
+ - `placeholder: string` — Placeholder shown when the text is empty
23
+ - `disabled: boolean` = false — Whether editing is disabled
24
+ - `fullWidth: boolean` = false — Whether to take full width of parent
25
+ - `label: React.ReactNode` — Accessible label for the text and edit button
26
+
27
+ ## Design tokens it reads
28
+
29
+ `--wim-border-width-thin`, `--wim-color-focus-outline`, `--wim-color-surface-hover`, `--wim-color-text-disabled`, `--wim-color-text-placeholder`, `--wim-color-text-primary`, `--wim-color-text-secondary`, `--wim-field-padding-x`, `--wim-field-padding-y-tight`, `--wim-focus-outline-offset`, `--wim-focus-outline-width`, `--wim-height-md`, `--wim-radius-component`, `--wim-spacing-xs`, `--wim-transition-base`, `--wim-width-md`
30
+
31
+ ---
32
+ Setup, composition rules and the full catalog: `llms.txt` / `llms-full.txt` in the same package.
@@ -0,0 +1,46 @@
1
+ # Input — wimui
2
+
3
+ > Single-line input fields for text, numbers, or emails
4
+
5
+ ## Import
6
+
7
+ ```ts
8
+ import "wimui/styles.css"; // once per app — required
9
+ import { Input } 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
+ - `rightIcon: React.ComponentProps<typeof Icon>["name"]` — Icon name to display on the right side
19
+ - `leftIconColor: React.ComponentProps<typeof Icon>["color"]` — Color of the left icon
20
+ - `rightIconColor: React.ComponentProps<typeof Icon>["color"]` — Color of the right icon
21
+ - `onLeftIconClick: (e: React.MouseEvent<HTMLButtonElement>) => void` — Callback when the left icon is clicked (renders the icon as a button)
22
+ - `onRightIconClick: (e: React.MouseEvent<HTMLButtonElement>) => void` — Callback when the right icon is clicked (renders the icon as a button)
23
+ - `allowClear: boolean` = false — Whether to show a clear button when value is present
24
+ - `showPasswordToggle: boolean` = true — Whether to show the visibility toggle when type is "password"
25
+ - `rightIconClassName: string` — Additional class name for the right icon
26
+ - `rightIconRotated: boolean` — Whether to rotate the right icon 180 degrees (e.g. for an open state)
27
+ - `width: ("xs" | "sm" | "md" | "lg" | "xl") | string | number` — Fixed width of the field (width token, CSS value, or number in px)
28
+ - `label: React.ReactNode` — Field label
29
+ - `error: string` — Error message
30
+ - `required: boolean` — Whether to show the required indicator
31
+ - `layout: "vertical" | "horizontal"` — Layout direction of label and field
32
+ - `inputClassName: string` — Additional class name for the inner input element
33
+ - `showPasswordAriaLabel: string` — Aria label for the show-password toggle
34
+ - `hidePasswordAriaLabel: string` — Aria label for the hide-password toggle
35
+ - `rightIconAriaLabel: string` — Aria label for the right icon button
36
+ - `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
37
+ - `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.
38
+ - `styles: { root?: string; inner?: string; icon?: string; icons?: string; iconItem?: string; iconButton?: string; }` — Custom styles for internal parts
39
+ - `asChild: boolean` = false — Whether to render as a child element.
40
+
41
+ ## Design tokens it reads
42
+
43
+ `--wim-border-width-thin`, `--wim-color-disabled`, `--wim-color-focus-outline`, `--wim-color-ghost-bg-hover`, `--wim-color-line`, `--wim-color-surface`, `--wim-color-text-on-disabled`, `--wim-color-text-primary`, `--wim-color-text-tertiary`, `--wim-field-bg`, `--wim-field-border`, `--wim-field-outline`, `--wim-field-radius`, `--wim-field-radius-bl`, `--wim-field-radius-br`, `--wim-field-radius-tl`, `--wim-field-radius-tr`, `--wim-field-shadow`, `--wim-font-size-md`, `--wim-height-md`, `--wim-radius-component`, `--wim-shadow-error-ring`, `--wim-shadow-focus-ring`, `--wim-transition-base`
44
+
45
+ ---
46
+ Setup, composition rules and the full catalog: `llms.txt` / `llms-full.txt` in the same package.
@@ -0,0 +1,39 @@
1
+ # InputBase — wimui
2
+
3
+ > Standardizes the visual container, icon slots (Prefix/Suffix), and clear button behavior for text-based inputs.
4
+
5
+ ## Import
6
+
7
+ ```ts
8
+ import "wimui/styles.css"; // once per app — required
9
+ import { InputBase } from "wimui/form";
10
+ ```
11
+
12
+ ## Props
13
+
14
+ - `children: React.ReactNode` (required) — Inner form control element(s) wrapped by the shell
15
+ - `intent: ("default" | "danger") | ("primary" | "success" | "warning" | "danger" | "info" | "neutral" | "default")` = "default" — Semantic intent of the field (e.g. error state)
16
+ - `variant: "outline" | "ghost"` = "outline" — Visual style variant of the field
17
+ - `fullWidth: boolean` = false — Whether to take full width of parent
18
+ - `width: ("xs" | "sm" | "md" | "lg" | "xl") | string | number` — Fixed width of the field (width token, CSS value, or number in px)
19
+ - `className: string` — Additional class names
20
+ - `disabled: boolean` — Whether the field is disabled
21
+ - `leftIcon: React.ComponentProps<typeof Icon>["name"]` — Icon name to display on the left side
22
+ - `leftIconColor: React.ComponentProps<typeof Icon>["color"]` — Color of the left icon
23
+ - `onLeftIconClick: (e: React.MouseEvent<HTMLButtonElement>) => void` — Callback when the left icon is clicked (renders the icon as a button)
24
+ - `leftIconAriaLabel: string` — Aria label for the left icon button
25
+ - `rightIcons: InputBaseIcon[]` = [] — Icons to display on the right side
26
+ - `suffix: React.ReactNode` — Static text shown after the control, inside the same shell — a unit such as `kg`, `%` or `円`. It sits in the flex flow, so the control shrinks to make room rather than running underneath it.
27
+ - `suffixId: string` — `id` for the suffix, so the control can point `aria-describedby` at it
28
+ - `allowClear: boolean` — Whether to show a clear button when value is present
29
+ - `hasValue: boolean` — Whether the field currently has a value (controls clear button visibility)
30
+ - `onClear: () => void` — Callback when the clear button is clicked
31
+ - `clearAriaLabel: string` — Aria label for the clear button
32
+ - `styles: { root?: string; inner?: string; icon?: string; icons?: string; iconItem?: string; iconButton?: string; }` — Custom styles for internal parts
33
+
34
+ ## Design tokens it reads
35
+
36
+ `--wim-border-width-thin`, `--wim-color-disabled`, `--wim-color-ghost-bg-hover`, `--wim-color-line`, `--wim-color-primary`, `--wim-color-success`, `--wim-color-surface`, `--wim-color-surface-hover`, `--wim-color-text-on-disabled`, `--wim-color-text-secondary`, `--wim-color-warning`, `--wim-field-padding-x`, `--wim-field-radius`, `--wim-field-radius-bl`, `--wim-field-radius-br`, `--wim-field-radius-tl`, `--wim-field-radius-tr`, `--wim-height-md`, `--wim-input-base-border`, `--wim-input-min-width`, `--wim-input-offset-left`, `--wim-input-offset-right`, `--wim-input-width`, `--wim-radius-component`, `--wim-radius-sm`, `--wim-shadow-error-ring`, `--wim-shadow-focus-ring`, `--wim-spacing-2xl`, `--wim-spacing-3xs`, `--wim-spacing-4xl`, `--wim-spacing-md`, `--wim-spacing-sm`, `--wim-spacing-xl`, `--wim-spacing-xs`, `--wim-tap-target-min`, `--wim-transition-base`, `--wim-transition-fast`, `--wim-transition-slow`, `--wim-width-lg`, `--wim-width-md`, `--wim-width-sm`, `--wim-width-xl`, `--wim-width-xs`
37
+
38
+ ---
39
+ Setup, composition rules and the full catalog: `llms.txt` / `llms-full.txt` in the same package.
@@ -0,0 +1,23 @@
1
+ # InputGroup — wimui
2
+
3
+ > Inputs with icons/labels
4
+
5
+ ## Import
6
+
7
+ ```ts
8
+ import "wimui/styles.css"; // once per app — required
9
+ import { InputGroup } from "wimui/form";
10
+ ```
11
+
12
+ ## Props
13
+
14
+ - `children: React.ReactNode` (required) — Inputs, buttons, and add-ons to combine into one unit
15
+ - `fullWidth: boolean` = false — Whether to take full width of parent
16
+ - `className: string` — Additional class names
17
+
18
+ ## Design tokens it reads
19
+
20
+ `--wim-border-width-thin`, `--wim-color-disabled`, `--wim-color-line`, `--wim-color-text-on-disabled`, `--wim-color-text-secondary`, `--wim-control-item-padding-x-lg`, `--wim-field-padding-y-tight`, `--wim-field-radius`, `--wim-field-radius-bl`, `--wim-field-radius-br`, `--wim-field-radius-tl`, `--wim-field-radius-tr`, `--wim-font-size-md`, `--wim-font-weight-normal`, `--wim-radius-component`, `--wim-spacing-xl`
21
+
22
+ ---
23
+ Setup, composition rules and the full catalog: `llms.txt` / `llms-full.txt` in the same package.
@@ -0,0 +1,44 @@
1
+ # InputMask — wimui
2
+
3
+ > Formatted inputs
4
+
5
+ ## Import
6
+
7
+ ```ts
8
+ import "wimui/styles.css"; // once per app — required
9
+ import { InputMask } from "wimui/form";
10
+ ```
11
+
12
+ ## Props
13
+
14
+ - `mask: string` (required) — Mask pattern ('9': digit, 'a': letter, '*': alphanumeric; other characters are shown as-is)
15
+ - `maskChar: string` = "_" — Placeholder character for unfilled mask positions
16
+ - `intent: "default" | "danger"` = "default" — Semantic intent of the field (e.g. error state)
17
+ - `variant: "outline" | "ghost"` = "outline" — Visual style variant of the field
18
+ - `fullWidth: boolean` = false — Whether to take full width of parent
19
+ - `leftIcon: React.ComponentProps<typeof Icon>["name"]` — Icon name to display on the left side
20
+ - `rightIcon: React.ComponentProps<typeof Icon>["name"]` — Icon name to display on the right side
21
+ - `leftIconColor: React.ComponentProps<typeof Icon>["color"]` — Color of the left icon
22
+ - `rightIconColor: React.ComponentProps<typeof Icon>["color"]` — Color of the right icon
23
+ - `onLeftIconClick: (e: React.MouseEvent<HTMLButtonElement>) => void` — Callback when the left icon is clicked (renders the icon as a button)
24
+ - `onRightIconClick: (e: React.MouseEvent<HTMLButtonElement>) => void` — Callback when the right icon is clicked (renders the icon as a button)
25
+ - `allowClear: boolean` = false — Whether to show a clear button when value is present
26
+ - `showPasswordToggle: boolean` = true — Whether to show the visibility toggle when type is "password"
27
+ - `rightIconClassName: string` — Additional class name for the right icon
28
+ - `rightIconRotated: boolean` — Whether to rotate the right icon 180 degrees (e.g. for an open state)
29
+ - `width: ("xs" | "sm" | "md" | "lg" | "xl") | string | number` — Fixed width of the field (width token, CSS value, or number in px)
30
+ - `label: React.ReactNode` — Field label
31
+ - `error: string` — Error message
32
+ - `required: boolean` — Whether to show the required indicator
33
+ - `layout: "vertical" | "horizontal"` — Layout direction of label and field
34
+ - `inputClassName: string` — Additional class name for the inner input element
35
+ - `showPasswordAriaLabel: string` — Aria label for the show-password toggle
36
+ - `hidePasswordAriaLabel: string` — Aria label for the hide-password toggle
37
+ - `rightIconAriaLabel: string` — Aria label for the right icon button
38
+ - `rightIconDecorative: boolean` = false — Treats the clickable right icon as a pointer-only affordance: it stays clickable but leaves the tab order and is hidden from assistive technology. Use it when the field already does the same thing from the keyboard. @default false
39
+ - `suffix: React.ReactNode` — Static text shown after the field, inside the same shell — a unit such as `kg`, `%` or `円`. It is announced with the field via `aria-describedby`, so the unit does not have to be repeated in the label.
40
+ - `styles: { root?: string; inner?: string; icon?: string; icons?: string; iconItem?: string; iconButton?: string; }` — Custom styles for internal parts
41
+ - `asChild: boolean` = false — Whether to render as a child element.
42
+
43
+ ---
44
+ Setup, composition rules and the full catalog: `llms.txt` / `llms-full.txt` in the same package.
@@ -0,0 +1,32 @@
1
+ # InteractiveArea — wimui
2
+
3
+ > Foundation component for consistent interactive areas with borders and states.
4
+
5
+ ## Import
6
+
7
+ ```ts
8
+ import "wimui/styles.css"; // once per app — required
9
+ import { InteractiveArea } from "wimui/layout";
10
+ ```
11
+
12
+ ## Props
13
+
14
+ - `title: ReactNode` — Area title
15
+ - `description: ReactNode` — Area description
16
+ - `icon: ReactNode` — Icon to display
17
+ - `actions: ReactNode` — Action elements (buttons, etc.)
18
+ - `variant: "dashed" | "solid" | "none"` = "dashed" — Border variant
19
+ - `bgVariant: "default" | "transparent" | "muted"` = "default" — Background variant
20
+ - `size: "sm" | "md" | "lg"` = "md" — Size variation
21
+ - `align: "start" | "center"` = "center" — Horizontal alignment of the icon, text and actions. Centred content only reads as deliberate when the area is the one thing in its region — a drop target or a whole result page. Inside a card, a table or a column of prose, use `"start"` so the block lines up with the text around it. @default "center"
22
+ - `isDragging: boolean` = false — Whether the area is currently in a dragging state (for dropzone)
23
+ - `isClickable: boolean` = false — Whether the area is clickable
24
+ - `disabled: boolean` = false — Whether the area is disabled
25
+ - `styles: { inner?: string; icon?: string; title?: string; description?: string; content?: string; actions?: string; }` — Custom styles for internal parts
26
+
27
+ ## Design tokens it reads
28
+
29
+ `--wim-border-width-thick`, `--wim-border-width-thin`, `--wim-color-border`, `--wim-color-primary`, `--wim-color-primary-muted`, `--wim-color-surface`, `--wim-color-surface-variant`, `--wim-color-text-primary`, `--wim-color-text-secondary`, `--wim-font-size-2xl`, `--wim-font-size-4xl`, `--wim-font-size-5xl`, `--wim-font-size-lg`, `--wim-font-size-md`, `--wim-font-size-xl`, `--wim-font-weight-bold`, `--wim-opacity-disabled`, `--wim-radius-container`, `--wim-scale-active`, `--wim-spacing-3xl`, `--wim-spacing-lg`, `--wim-spacing-md`, `--wim-spacing-sm`, `--wim-spacing-xl`, `--wim-spacing-xs`, `--wim-transition-fast`
30
+
31
+ ---
32
+ Setup, composition rules and the full catalog: `llms.txt` / `llms-full.txt` in the same package.
@@ -0,0 +1,28 @@
1
+ # InteractiveGraph — wimui
2
+
3
+ > InteractiveGraph provides a canvas for visualizing node-based data. Ideal for RAG knowledge bases, agent workflows, or state machines.
4
+
5
+ ## Import
6
+
7
+ ```ts
8
+ import "wimui/styles.css"; // once per app — required
9
+ import { InteractiveGraph } from "wimui/ai";
10
+ ```
11
+
12
+ ## Props
13
+
14
+ - `nodes: Node[]` (required) — Initial nodes
15
+ - `edges: Edge[]` (required) — Initial edges
16
+ - `height: string | number` — Height of the container
17
+ - `width: string | number` — Width of the container
18
+ - `className: string` — Additional CSS class
19
+ - `showGrid: boolean` — Whether to show the background grid
20
+ - `showMiniMap: boolean` — Whether to show the minimap
21
+ - `showControls: boolean` — Whether to show controls
22
+
23
+ ## Design tokens it reads
24
+
25
+ `--wim-border-width-thick`, `--wim-border-width-thin`, `--wim-color-border`, `--wim-color-focus-outline`, `--wim-color-primary`, `--wim-color-surface`, `--wim-color-surface-app`, `--wim-color-surface-hover`, `--wim-color-text-primary`, `--wim-color-text-secondary`, `--wim-comp-graph-edge`, `--wim-focus-outline-offset`, `--wim-focus-outline-width`, `--wim-font-family-default`, `--wim-radius-component`, `--wim-radius-container`, `--wim-shadow-overlay`, `--wim-shadow-sm`, `--wim-spacing-xs`, `--wim-width-sm`
26
+
27
+ ---
28
+ Setup, composition rules and the full catalog: `llms.txt` / `llms-full.txt` in the same package.
@@ -0,0 +1,24 @@
1
+ # JsonDiffViewer — wimui
2
+
3
+ > Compares two JSON values as a formatted side-by-side or unified diff, built on top of CodeDiffViewer.
4
+
5
+ ## Import
6
+
7
+ ```ts
8
+ import "wimui/styles.css"; // once per app — required
9
+ import { JsonDiffViewer } from "wimui/data-display";
10
+ ```
11
+
12
+ ## Props
13
+
14
+ - `before: unknown` (required) — JSON value before the change
15
+ - `after: unknown` (required) — JSON value after the change
16
+ - `indent: number` = 2 — Indentation spaces for JSON.stringify (default: 2)
17
+ - `view: "split" | "unified"` — Display mode inherited from CodeDiffViewer
18
+
19
+ ## Design tokens it reads
20
+
21
+ `--wim-spacing-md`
22
+
23
+ ---
24
+ Setup, composition rules and the full catalog: `llms.txt` / `llms-full.txt` in the same package.
@@ -0,0 +1,26 @@
1
+ # JsonViewer — wimui
2
+
3
+ > Recursive tree viewer and editor for JSON data.
4
+
5
+ ## Import
6
+
7
+ ```ts
8
+ import "wimui/styles.css"; // once per app — required
9
+ import { JsonViewer } from "wimui/data-display";
10
+ ```
11
+
12
+ ## Props
13
+
14
+ - `data: unknown` (required) — The JSON data to display
15
+ - `expandDepth: number` = 1 — Initial depth to expand
16
+ - `showCopy: boolean` = true — If true, show copy button
17
+ - `showToolbar: boolean` = true — If true, show toolbar
18
+ - `editable: boolean` = false — If true, the data can be edited inline
19
+ - `onChange: (data: unknown) => void` — Callback when data changes
20
+
21
+ ## Design tokens it reads
22
+
23
+ `--wim-border-width-thin`, `--wim-color-border`, `--wim-color-border-secondary`, `--wim-color-danger`, `--wim-color-danger-subtle`, `--wim-color-focus-outline`, `--wim-color-primary`, `--wim-color-surface`, `--wim-color-surface-subtle-alpha`, `--wim-color-text-accent`, `--wim-color-text-danger`, `--wim-color-text-info`, `--wim-color-text-primary`, `--wim-color-text-secondary`, `--wim-color-text-success`, `--wim-color-text-tertiary`, `--wim-duration-fast`, `--wim-focus-outline-offset`, `--wim-focus-outline-width`, `--wim-font-size-sm`, `--wim-font-size-xs`, `--wim-font-weight-bold`, `--wim-height-xs`, `--wim-letter-spacing-wide`, `--wim-line-height-loose`, `--wim-radius-component`, `--wim-radius-sm`, `--wim-scale-active-sm`, `--wim-spacing-2xs`, `--wim-spacing-3xs`, `--wim-spacing-md`, `--wim-spacing-sm`, `--wim-spacing-xs`, `--wim-tap-target-min`, `--wim-transition-fast`
24
+
25
+ ---
26
+ Setup, composition rules and the full catalog: `llms.txt` / `llms-full.txt` in the same package.
@@ -0,0 +1,25 @@
1
+ # Kanban — wimui
2
+
3
+ > Drag-and-drop board for visualizing workflow stages
4
+
5
+ ## Import
6
+
7
+ ```ts
8
+ import "wimui/styles.css"; // once per app — required
9
+ import { Kanban } from "wimui/data-display";
10
+ ```
11
+
12
+ ## Props
13
+
14
+ - `columns: KanbanColumnData[]` — Kanban column data (for prop-driven usage).
15
+ - `onMove: (itemId: string, fromColumnId: string, toColumnId: string) => void` — Callback when a card is moved.
16
+ - `onCardMove: (itemId: string, fromColumnId: string, toColumnId: string) => void` — Callback when a card is moved (legacy / alternative name).
17
+ - `forceMobileUI: boolean` = false — Whether to force the touch-device UI.
18
+ - `asChild: boolean` = false — Whether to render as a child element.
19
+
20
+ ## Design tokens it reads
21
+
22
+ `--wim-border-width-thin`, `--wim-color-border`, `--wim-color-primary`, `--wim-color-surface`, `--wim-color-surface-hover`, `--wim-color-surface-subtle`, `--wim-color-surface-variant`, `--wim-color-text-primary`, `--wim-color-text-secondary`, `--wim-color-text-tertiary`, `--wim-duration-fast`, `--wim-easing-standard`, `--wim-focus-outline-width`, `--wim-font-size-md`, `--wim-font-size-sm`, `--wim-font-weight-semibold`, `--wim-opacity-dim`, `--wim-opacity-disabled`, `--wim-radius-component`, `--wim-radius-container`, `--wim-radius-full`, `--wim-shadow-md`, `--wim-shadow-sm`, `--wim-spacing-2xl`, `--wim-spacing-2xs`
23
+
24
+ ---
25
+ Setup, composition rules and the full catalog: `llms.txt` / `llms-full.txt` in the same package.
@@ -0,0 +1,23 @@
1
+ # Kbd — wimui
2
+
3
+ > Keyboard shortcuts
4
+
5
+ ## Import
6
+
7
+ ```ts
8
+ import "wimui/styles.css"; // once per app — required
9
+ import { Kbd } from "wimui/typography";
10
+ ```
11
+
12
+ ## Props
13
+
14
+ - `asChild: boolean` = false — If true, the Kbd will be rendered as its child, merging its props onto that child.
15
+ - `size: "sm" | "md" | "lg"` = "md" — Size of the key cap. @default "md"
16
+ - `children: React.ReactNode` — Key label(s) to display.
17
+
18
+ ## Design tokens it reads
19
+
20
+ `--wim-border-width-thick`, `--wim-border-width-thin`, `--wim-color-border`, `--wim-color-surface`, `--wim-color-text-primary`, `--wim-font-size-md`, `--wim-font-size-sm`, `--wim-font-size-xs`, `--wim-font-weight-bold`, `--wim-kbd-border-bottom-width`, `--wim-kbd-height-lg`, `--wim-kbd-height-md`, `--wim-kbd-height-sm`, `--wim-kbd-min-width-lg`, `--wim-kbd-min-width-md`, `--wim-kbd-min-width-sm`, `--wim-radius-component`, `--wim-shadow-xs`, `--wim-spacing-md`, `--wim-spacing-sm`, `--wim-spacing-xs`
21
+
22
+ ---
23
+ Setup, composition rules and the full catalog: `llms.txt` / `llms-full.txt` in the same package.
@@ -0,0 +1,25 @@
1
+ # KeyboardShortcuts — wimui
2
+
3
+ > Display a structured list of keyboard shortcuts
4
+
5
+ ## Import
6
+
7
+ ```ts
8
+ import "wimui/styles.css"; // once per app — required
9
+ import { KeyboardShortcuts } from "wimui/navigation";
10
+ ```
11
+
12
+ ## Props
13
+
14
+ - `shortcuts: ShortcutItem[]` (required) — List of shortcuts to display
15
+ - `title: string` — Section title
16
+ - `titleLevel: 2 | 3 | 4 | 5 | 6` — `title` を見出しとして描くときの段(T211)。渡さなければ見出しにならず `p` のまま。 ショートカット一覧は「編集」「移動」のように節ごとに積んで使うので、段で辿れると 効く。ただし既定を見出しにはしない ── 段を決め打つとページに `h1` / `h2` がある 場合に段が飛び、axe の `heading-order` が鳴る(T191 で `Footer` が実際に踏んだ)。 段を決めるのはページ側の構造を知っている呼び出し元の仕事で、`Alert` の `titleTag` (既定 `div`)と同じ形。
17
+ - `separator: string` = "+" — Separator displayed between keys @default "+"
18
+ - `size: "sm" | "md" | "lg"` = "md" — Size of the list @default "md"
19
+
20
+ ## Design tokens it reads
21
+
22
+ `--wim-border-width-thin`, `--wim-color-border-secondary`, `--wim-color-text-primary`, `--wim-color-text-secondary`, `--wim-color-text-tertiary`, `--wim-font-size-md`, `--wim-font-size-sm`, `--wim-font-size-xs`, `--wim-font-weight-semibold`, `--wim-letter-spacing-wide`, `--wim-spacing-2xs`, `--wim-spacing-md`, `--wim-spacing-sm`, `--wim-spacing-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
+ # Label — wimui
2
+
3
+ > Descriptive text for input fields, including required/optional marks
4
+
5
+ ## Import
6
+
7
+ ```ts
8
+ import "wimui/styles.css"; // once per app — required
9
+ import { Label } from "wimui/typography";
10
+ ```
11
+
12
+ ## Props
13
+
14
+ - `label: React.ReactNode` (required) — The main label text or element.
15
+ - `required: boolean` = false — Whether the field is mandatory. If true, displays a required badge.
16
+ - `requiredLabel: React.ReactNode` — Custom text or element for the required badge. Defaults to the localized `form.required` string.
17
+ - `showOptional: boolean` = false — Whether to display an optional badge when `required` is false. @default false
18
+ - `optionalLabel: React.ReactNode` — Custom text or element for the optional badge. Defaults to the localized `form.optional` string.
19
+ - `className: string` — Additional CSS class name for the container.
20
+ - `asChild: boolean` = false — If true, the Label will be rendered as its child, merging its props onto that child.
21
+
22
+ ## Design tokens it reads
23
+
24
+ `--wim-color-text-primary`, `--wim-font-size-sm`, `--wim-font-weight-bold`, `--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,24 @@
1
+ # Leaderboard — wimui
2
+
3
+ > Display a ranked list of entries with scores. Medal colors for the top three are opt-in.
4
+
5
+ ## Import
6
+
7
+ ```ts
8
+ import "wimui/styles.css"; // once per app — required
9
+ import { Leaderboard } from "wimui/data-display";
10
+ ```
11
+
12
+ ## Props
13
+
14
+ - `entries: LeaderboardEntry[]` (required) — List of ranking entries
15
+ - `unit: string` — Label for the score unit
16
+ - `size: "sm" | "md" | "lg"` = "md" — Size
17
+ - `showMedals: boolean` = false — Whether to paint the rank badges of the top three in gold, silver and bronze (off by default: the number and the order already say the rank)
18
+
19
+ ## Design tokens it reads
20
+
21
+ `--wim-border-width-thin`, `--wim-color-border`, `--wim-color-primary`, `--wim-color-surface`, `--wim-color-surface-variant`, `--wim-color-text-on-warning`, `--wim-color-text-primary`, `--wim-color-text-secondary`, `--wim-color-text-tertiary`, `--wim-font-size-md`, `--wim-font-size-sm`, `--wim-font-size-xs`, `--wim-font-weight-bold`, `--wim-font-weight-medium`, `--wim-radius-component`, `--wim-radius-full`, `--wim-spacing-2xs`, `--wim-spacing-3xs`, `--wim-spacing-lg`, `--wim-spacing-md`, `--wim-spacing-sm`, `--wim-spacing-xl`, `--wim-spacing-xs`
22
+
23
+ ---
24
+ Setup, composition rules and the full catalog: `llms.txt` / `llms-full.txt` in the same package.