wimui 0.70.0 → 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 (265) 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/feedback/Spinner/Spinner.cjs +1 -1
  15. package/dist/components/feedback/Spinner/Spinner.js +53 -43
  16. package/dist/components/form/Combobox/Combobox.cjs +1 -1
  17. package/dist/components/form/Combobox/Combobox.js +48 -47
  18. package/dist/components/form/Transfer/Transfer.cjs +1 -1
  19. package/dist/components/form/Transfer/Transfer.js +0 -1
  20. package/dist/components/media/Gallery/Gallery.cjs +1 -1
  21. package/dist/components/media/Gallery/Gallery.js +111 -110
  22. package/dist/hooks/useBreakpoint.d.ts +1 -0
  23. package/dist/i18n/generated/data-display.cjs +1 -1
  24. package/dist/i18n/generated/data-display.d.ts +1 -1
  25. package/dist/i18n/generated/data-display.js +6 -3
  26. package/dist/index.cjs +1 -1
  27. package/dist/index.js +18 -18
  28. package/dist/llms/AIResponseFeedback.md +26 -0
  29. package/dist/llms/Accordion.md +47 -0
  30. package/dist/llms/Affix.md +25 -0
  31. package/dist/llms/AgentStatus.md +25 -0
  32. package/dist/llms/Alert.md +28 -0
  33. package/dist/llms/Anchor.md +30 -0
  34. package/dist/llms/AppShell.md +52 -0
  35. package/dist/llms/AreaChart.md +27 -0
  36. package/dist/llms/ArtifactsOverlay.md +27 -0
  37. package/dist/llms/AspectRatio.md +22 -0
  38. package/dist/llms/Audio.md +44 -0
  39. package/dist/llms/Autosave.md +23 -0
  40. package/dist/llms/Avatar.md +27 -0
  41. package/dist/llms/AvatarGroup.md +28 -0
  42. package/dist/llms/BackTop.md +32 -0
  43. package/dist/llms/Badge.md +28 -0
  44. package/dist/llms/Banner.md +28 -0
  45. package/dist/llms/BarChart.md +26 -0
  46. package/dist/llms/Barcode.md +26 -0
  47. package/dist/llms/BentoGrid.md +25 -0
  48. package/dist/llms/Blockquote.md +26 -0
  49. package/dist/llms/BottomSheet.md +26 -0
  50. package/dist/llms/Box.md +44 -0
  51. package/dist/llms/BoxPlot.md +25 -0
  52. package/dist/llms/Breadcrumb.md +31 -0
  53. package/dist/llms/Button.md +33 -0
  54. package/dist/llms/ButtonGroup.md +27 -0
  55. package/dist/llms/Calendar.md +34 -0
  56. package/dist/llms/CalendarHeatmap.md +33 -0
  57. package/dist/llms/CandlestickChart.md +25 -0
  58. package/dist/llms/Canvas.md +13 -0
  59. package/dist/llms/Card.md +41 -0
  60. package/dist/llms/Carousel.md +33 -0
  61. package/dist/llms/Cascader.md +40 -0
  62. package/dist/llms/Center.md +40 -0
  63. package/dist/llms/Charts.md +13 -0
  64. package/dist/llms/ChatUI.md +17 -0
  65. package/dist/llms/Checkbox.md +24 -0
  66. package/dist/llms/CheckboxGroup.md +32 -0
  67. package/dist/llms/Chip.md +36 -0
  68. package/dist/llms/Code.md +25 -0
  69. package/dist/llms/CodeBlock.md +27 -0
  70. package/dist/llms/CodeDiffViewer.md +30 -0
  71. package/dist/llms/ColorInput.md +48 -0
  72. package/dist/llms/ColorPicker.md +46 -0
  73. package/dist/llms/Combobox.md +37 -0
  74. package/dist/llms/CommandPalette.md +25 -0
  75. package/dist/llms/Comment.md +35 -0
  76. package/dist/llms/Container.md +45 -0
  77. package/dist/llms/ContextMenu.md +25 -0
  78. package/dist/llms/ContrastChecker.md +13 -0
  79. package/dist/llms/Controls.md +13 -0
  80. package/dist/llms/CopyButton.md +26 -0
  81. package/dist/llms/Countdown.md +31 -0
  82. package/dist/llms/CounterTextarea.md +32 -0
  83. package/dist/llms/CreditCardInput.md +42 -0
  84. package/dist/llms/Dashboard.md +31 -0
  85. package/dist/llms/DataGrid.md +43 -0
  86. package/dist/llms/DatePicker.md +39 -0
  87. package/dist/llms/DateRangePicker.md +30 -0
  88. package/dist/llms/DescriptionList.md +26 -0
  89. package/dist/llms/Dialog.md +57 -0
  90. package/dist/llms/Divider.md +24 -0
  91. package/dist/llms/Drawer.md +29 -0
  92. package/dist/llms/Dropdown.md +50 -0
  93. package/dist/llms/Dropzone.md +36 -0
  94. package/dist/llms/EmptyState.md +23 -0
  95. package/dist/llms/ErrorBoundary.md +25 -0
  96. package/dist/llms/FAQSection.md +24 -0
  97. package/dist/llms/FieldError.md +19 -0
  98. package/dist/llms/FieldTemplate.md +30 -0
  99. package/dist/llms/Fieldset.md +24 -0
  100. package/dist/llms/FileUpload.md +40 -0
  101. package/dist/llms/Flex.md +23 -0
  102. package/dist/llms/FloatButton.md +36 -0
  103. package/dist/llms/FocusTrap.md +20 -0
  104. package/dist/llms/Footer.md +32 -0
  105. package/dist/llms/FunnelChart.md +24 -0
  106. package/dist/llms/Gallery.md +30 -0
  107. package/dist/llms/GanttChart.md +29 -0
  108. package/dist/llms/GaugeChart.md +30 -0
  109. package/dist/llms/Grid.md +30 -0
  110. package/dist/llms/Group.md +22 -0
  111. package/dist/llms/HamburgerMenu.md +30 -0
  112. package/dist/llms/Header.md +30 -0
  113. package/dist/llms/Heatmap.md +25 -0
  114. package/dist/llms/Highlight.md +26 -0
  115. package/dist/llms/HoverCard.md +26 -0
  116. package/dist/llms/Icon.md +25 -0
  117. package/dist/llms/IconButton.md +30 -0
  118. package/dist/llms/Image.md +46 -0
  119. package/dist/llms/ImageCompare.md +35 -0
  120. package/dist/llms/ImageCropper.md +34 -0
  121. package/dist/llms/Indicator.md +28 -0
  122. package/dist/llms/InfiniteScroll.md +28 -0
  123. package/dist/llms/InlineEdit.md +32 -0
  124. package/dist/llms/Input.md +46 -0
  125. package/dist/llms/InputBase.md +39 -0
  126. package/dist/llms/InputGroup.md +23 -0
  127. package/dist/llms/InputMask.md +44 -0
  128. package/dist/llms/InteractiveArea.md +32 -0
  129. package/dist/llms/InteractiveGraph.md +28 -0
  130. package/dist/llms/JsonDiffViewer.md +24 -0
  131. package/dist/llms/JsonViewer.md +26 -0
  132. package/dist/llms/Kanban.md +25 -0
  133. package/dist/llms/Kbd.md +23 -0
  134. package/dist/llms/KeyboardShortcuts.md +25 -0
  135. package/dist/llms/Label.md +27 -0
  136. package/dist/llms/Leaderboard.md +24 -0
  137. package/dist/llms/Legend.md +27 -0
  138. package/dist/llms/Lightbox.md +47 -0
  139. package/dist/llms/LineChart.md +26 -0
  140. package/dist/llms/Link.md +28 -0
  141. package/dist/llms/LinkButton.md +23 -0
  142. package/dist/llms/List.md +35 -0
  143. package/dist/llms/Loader.md +23 -0
  144. package/dist/llms/LoadingOverlay.md +30 -0
  145. package/dist/llms/Markdown.md +24 -0
  146. package/dist/llms/MarkdownRenderer.md +24 -0
  147. package/dist/llms/Marquee.md +27 -0
  148. package/dist/llms/Masonry.md +18 -0
  149. package/dist/llms/Mentions.md +24 -0
  150. package/dist/llms/Menu.md +30 -0
  151. package/dist/llms/Menubar.md +50 -0
  152. package/dist/llms/Meta.md +13 -0
  153. package/dist/llms/ModelSelector.md +31 -0
  154. package/dist/llms/MultiSelect.md +38 -0
  155. package/dist/llms/Navbar.md +58 -0
  156. package/dist/llms/NodeGraph.md +38 -0
  157. package/dist/llms/Notification.md +30 -0
  158. package/dist/llms/NumberInput.md +23 -0
  159. package/dist/llms/OtpInput.md +33 -0
  160. package/dist/llms/OverflowList.md +31 -0
  161. package/dist/llms/Pagination.md +39 -0
  162. package/dist/llms/PasswordInput.md +39 -0
  163. package/dist/llms/PasswordStrength.md +34 -0
  164. package/dist/llms/PhoneInput.md +35 -0
  165. package/dist/llms/PieChart.md +23 -0
  166. package/dist/llms/PivotTable.md +41 -0
  167. package/dist/llms/PlatformIcons.md +13 -0
  168. package/dist/llms/Popconfirm.md +30 -0
  169. package/dist/llms/Popover.md +27 -0
  170. package/dist/llms/Portal.md +18 -0
  171. package/dist/llms/Presence.md +26 -0
  172. package/dist/llms/Progress.md +29 -0
  173. package/dist/llms/ProgressRing.md +27 -0
  174. package/dist/llms/PromptInput.md +37 -0
  175. package/dist/llms/PullToRefresh.md +26 -0
  176. package/dist/llms/QRCode.md +30 -0
  177. package/dist/llms/QueryBuilder.md +31 -0
  178. package/dist/llms/RadarChart.md +24 -0
  179. package/dist/llms/Radio.md +23 -0
  180. package/dist/llms/RadioGroup.md +32 -0
  181. package/dist/llms/RangeCalendar.md +26 -0
  182. package/dist/llms/RangeSlider.md +39 -0
  183. package/dist/llms/Rating.md +37 -0
  184. package/dist/llms/Reaction.md +26 -0
  185. package/dist/llms/RefTable.md +13 -0
  186. package/dist/llms/RelativeTime.md +24 -0
  187. package/dist/llms/Result.md +29 -0
  188. package/dist/llms/RichTextEditor.md +59 -0
  189. package/dist/llms/SankeyChart.md +26 -0
  190. package/dist/llms/ScatterChart.md +26 -0
  191. package/dist/llms/ScheduleView.md +35 -0
  192. package/dist/llms/ScrollArea.md +24 -0
  193. package/dist/llms/ScrollProgress.md +22 -0
  194. package/dist/llms/SearchInput.md +44 -0
  195. package/dist/llms/SegmentedControl.md +40 -0
  196. package/dist/llms/Select.md +44 -0
  197. package/dist/llms/SelectionBar.md +28 -0
  198. package/dist/llms/Sidebar.md +47 -0
  199. package/dist/llms/SignaturePad.md +36 -0
  200. package/dist/llms/SimpleGrid.md +24 -0
  201. package/dist/llms/Skeleton.md +26 -0
  202. package/dist/llms/Slider.md +36 -0
  203. package/dist/llms/SmartSearchInput.md +35 -0
  204. package/dist/llms/Snackbar.md +30 -0
  205. package/dist/llms/SortableList.md +33 -0
  206. package/dist/llms/SourceCitation.md +28 -0
  207. package/dist/llms/SourceCode.md +13 -0
  208. package/dist/llms/Span.md +29 -0
  209. package/dist/llms/Sparkline.md +27 -0
  210. package/dist/llms/SpeedDial.md +28 -0
  211. package/dist/llms/Spinner.md +26 -0
  212. package/dist/llms/SplitButton.md +29 -0
  213. package/dist/llms/Splitter.md +37 -0
  214. package/dist/llms/Spoiler.md +26 -0
  215. package/dist/llms/Stack.md +48 -0
  216. package/dist/llms/Stats.md +44 -0
  217. package/dist/llms/Stepper.md +32 -0
  218. package/dist/llms/StreamingText.md +24 -0
  219. package/dist/llms/SwipeAction.md +28 -0
  220. package/dist/llms/SwipeableList.md +21 -0
  221. package/dist/llms/Switch.md +27 -0
  222. package/dist/llms/SwitchGroup.md +31 -0
  223. package/dist/llms/T.md +13 -0
  224. package/dist/llms/TabBar.md +33 -0
  225. package/dist/llms/TabNavigation.md +30 -0
  226. package/dist/llms/Table.md +73 -0
  227. package/dist/llms/Tabs.md +40 -0
  228. package/dist/llms/Tag.md +30 -0
  229. package/dist/llms/TagInput.md +37 -0
  230. package/dist/llms/Terminal.md +29 -0
  231. package/dist/llms/Text.md +31 -0
  232. package/dist/llms/Textarea.md +30 -0
  233. package/dist/llms/ThemeToggle.md +31 -0
  234. package/dist/llms/ThoughtProcess.md +27 -0
  235. package/dist/llms/ThreadList.md +27 -0
  236. package/dist/llms/TimePicker.md +41 -0
  237. package/dist/llms/Timeline.md +24 -0
  238. package/dist/llms/Title.md +27 -0
  239. package/dist/llms/Toast.md +32 -0
  240. package/dist/llms/ToggleGroup.md +39 -0
  241. package/dist/llms/Toolbar.md +35 -0
  242. package/dist/llms/Tooltip.md +29 -0
  243. package/dist/llms/Tour.md +24 -0
  244. package/dist/llms/Transfer.md +35 -0
  245. package/dist/llms/Transition.md +34 -0
  246. package/dist/llms/TreeDiagram.md +33 -0
  247. package/dist/llms/TreeSelect.md +43 -0
  248. package/dist/llms/TreeView.md +50 -0
  249. package/dist/llms/Treemap.md +27 -0
  250. package/dist/llms/UsageMeter.md +31 -0
  251. package/dist/llms/Video.md +46 -0
  252. package/dist/llms/VirtualList.md +31 -0
  253. package/dist/llms/VisuallyHidden.md +19 -0
  254. package/dist/llms/VoiceVisualizer.md +30 -0
  255. package/dist/llms/WaterfallChart.md +25 -0
  256. package/dist/llms/Watermark.md +27 -0
  257. package/dist/llms/colorSwatch.md +13 -0
  258. package/dist/llms-full.txt +6 -3
  259. package/dist/llms.txt +4 -2
  260. package/dist/locales/en/data-display.json +3 -0
  261. package/dist/locales/ja/data-display.json +3 -0
  262. package/dist/locales/pt/data-display.json +3 -0
  263. package/dist/styles.css +1 -1
  264. package/dist/wimui.umd.js +5 -5
  265. package/package.json +10 -3
@@ -0,0 +1,47 @@
1
+ # Lightbox — wimui
2
+
3
+ > A high-quality overlay component for displaying images and media with gallery and zoom functionality.
4
+
5
+ Also known as: Image Viewer
6
+
7
+ ## Import
8
+
9
+ ```ts
10
+ import "wimui/styles.css"; // once per app — required
11
+ import { Lightbox } from "wimui/media";
12
+ ```
13
+
14
+ ## Props
15
+
16
+ - `children: React.ReactNode` (required) — Lightbox parts (Lightbox.Trigger, Lightbox.Content, etc.)
17
+ - `open: boolean` — Controlled open state
18
+ - `onOpenChange: (open: boolean) => void` — Callback when the open state changes
19
+ - `defaultOpen: boolean` = false — Initial open state for uncontrolled usage
20
+ - `defaultIndex: number` = 0 — Index of the item shown first
21
+
22
+ ## Lightbox.Content
23
+
24
+ - `showCloseButton: boolean` = true
25
+ - `showNavigation: boolean` = true
26
+ - `showCounter: boolean` = true
27
+ - `closeOnOverlayClick: boolean` = true
28
+
29
+ ## Lightbox.Gallery
30
+
31
+ - `children: React.ReactNode` (required) — Thumbnails for the strip (`Lightbox.Trigger`). Not a `Gallery` grid.
32
+ - `items: LightboxItem[]` (required) — Items registered on the Lightbox for the overlay.
33
+
34
+ ## Lightbox.Trigger
35
+
36
+ - `asChild: boolean` = false
37
+ - `index: number`
38
+ - `src: string`
39
+ - `alt: string` — Description of the image this opens. Also becomes the button's accessible name when no `aria-label` is given.
40
+ - `caption: string`
41
+
42
+ ## Design tokens it reads
43
+
44
+ `--wim-blur-glass`, `--wim-blur-overlay`, `--wim-border-width-thin`, `--wim-color-glass-bg`, `--wim-color-glass-border`, `--wim-color-surface-void`, `--wim-color-white`, `--wim-duration-base`, `--wim-easing-emphasized-decelerate`, `--wim-easing-standard`, `--wim-font-size-lg`, `--wim-font-size-md`, `--wim-font-size-sm`, `--wim-font-weight-bold`, `--wim-font-weight-medium`, `--wim-opacity-subtle`, `--wim-radius-full`, `--wim-radius-sm`, `--wim-scale-active`, `--wim-scale-hover`, `--wim-shadow-modal`, `--wim-spacing-lg`, `--wim-spacing-md`, `--wim-spacing-sm`, `--wim-spacing-xl`, `--wim-spacing-xs`, `--wim-transition-base`, `--wim-z-overlay`, `--wim-z-overlay-panel`
45
+
46
+ ---
47
+ Setup, composition rules and the full catalog: `llms.txt` / `llms-full.txt` in the same package.
@@ -0,0 +1,26 @@
1
+ # LineChart — wimui
2
+
3
+ > Line charts
4
+
5
+ ## Import
6
+
7
+ ```ts
8
+ import "wimui/styles.css"; // once per app — required
9
+ import { LineChart } from "wimui/charts";
10
+ ```
11
+
12
+ ## Props
13
+
14
+ - `data: ChartDataPoint[]` (required) — Data to display in the chart.
15
+ - `keys: string[]` (required) — Keys in the data objects to render as lines (series).
16
+ - `xAxisKey: string` (required) — The key in the data objects used for the X axis labels.
17
+ - `height: number` = 300 — The height of the chart in pixels. @default 300
18
+ - `width: string | number` = "100%" — The width of the chart (e.g., "100%", 500). @default "100%"
19
+ - `title: string` — Optional title displayed above the chart.
20
+ - `smooth: boolean` = false — If true, draws smooth (monotone) curves instead of straight lines. @default false
21
+ - `yDomain: [ number | "auto" | "dataMin" | (string & {}), number | "auto" | "dataMax" | (string & {}), ]` = [0, "auto"] — Range of the Y axis. Pass ["auto", "auto"] when the change matters more than the distance from zero (a yield moving between 84% and 85% is a flat line on a 0–100 axis). @default [0, "auto"]
22
+ - `animated: boolean` = false — If true, animates the chart on mount. @default false
23
+ - `aria-label: string` — Accessible name for the chart. Defaults to `title` when omitted; pass this when the chart has no visible title, or when the title is not descriptive enough on its own.
24
+
25
+ ---
26
+ Setup, composition rules and the full catalog: `llms.txt` / `llms-full.txt` in the same package.
@@ -0,0 +1,28 @@
1
+ # Link — wimui
2
+
3
+ > Hyperlinks
4
+
5
+ ## Import
6
+
7
+ ```ts
8
+ import "wimui/styles.css"; // once per app — required
9
+ import { Link } from "wimui/navigation";
10
+ ```
11
+
12
+ ## Props
13
+
14
+ - `asChild: boolean` = false — If true, the link will be rendered as its child, merging its props onto that child. Useful for using the link styles with Link components from React Router or Next.js.
15
+ - `label: React.ReactNode` — Link text or element. Alternative to children.
16
+ - `size: Extract<ComponentSize, "sm" | "md" | "lg">` = "md" — Font size of the link. @default "md"
17
+ - `priority: "primary" | "secondary" | "tertiary"` = "primary" — Visual emphasis of the link. @default "primary"
18
+ - `iconName: React.ComponentProps<typeof Icon>["name"]` — Name of the icon displayed alongside the label.
19
+ - `iconPosition: "left" | "right"` = "left" — Position of the icon relative to the label. @default "left"
20
+ - `external: boolean` = false — If true, opens the link in a new tab and shows an external-link icon. @default false
21
+ - `styles: { root?: string; label?: string; inner?: string; externalIcon?: string; }` — Custom styles for internal parts
22
+
23
+ ## Design tokens it reads
24
+
25
+ `--wim-border-width-thin`, `--wim-color-primary`, `--wim-color-text-accent`, `--wim-color-text-primary`, `--wim-color-text-tertiary`, `--wim-decoration-underline`, `--wim-font-size-lg`, `--wim-font-size-md`, `--wim-font-size-sm`, `--wim-line-height-tight`, `--wim-opacity-subtle`, `--wim-radius-sm`, `--wim-shadow-focus`, `--wim-spacing-3xs`, `--wim-spacing-xs`, `--wim-text-underline-offset`, `--wim-transition-base`
26
+
27
+ ---
28
+ Setup, composition rules and the full catalog: `llms.txt` / `llms-full.txt` in the same package.
@@ -0,0 +1,23 @@
1
+ # LinkButton — wimui
2
+
3
+ > Anchor styled as button
4
+
5
+ ## Import
6
+
7
+ ```ts
8
+ import "wimui/styles.css"; // once per app — required
9
+ import { LinkButton } from "wimui/form";
10
+ ```
11
+
12
+ ## Props
13
+
14
+ - `iconPosition: "left" | "right"` = "left" — Position of the icon relative to the label
15
+ - `size: Extract<ComponentSize, "sm" | "md" | "lg">` = "md" — Size of the button
16
+ - `variant: "solid" | "outline" | "ghost"` = "outline" — Visual style variant of the button
17
+ - `intent: ButtonIntent` = "default" — Design intent of the button (visual / semantic state). Unrelated to the ARIA role attribute.
18
+ - `justify: "start" | "center" | "end" | "between"` = "center" — Horizontal alignment of the button content
19
+ - `fullWidth: boolean` = false — Whether the button should take up the full width of its container
20
+ - `asChild: unknown` = false
21
+
22
+ ---
23
+ Setup, composition rules and the full catalog: `llms.txt` / `llms-full.txt` in the same package.
@@ -0,0 +1,35 @@
1
+ # List — wimui
2
+
3
+ > Structurally organized items in bullet points or numbered formats
4
+
5
+ ## Import
6
+
7
+ ```ts
8
+ import "wimui/styles.css"; // once per app — required
9
+ import { List } from "wimui/data-display";
10
+ ```
11
+
12
+ ## Props
13
+
14
+ - `asChild: boolean` = false — Whether to render as a child element.
15
+ - `size: Extract<ComponentSize, "sm" | "md" | "lg">` = "md" — Size of the list items
16
+ - `spacing: "tight" | "normal" | "loose"` = "normal" — Spacing between items
17
+ - `bordered: boolean` = false — Whether to show borders between items
18
+ - `fullWidth: boolean` = false — Whether to take full width of parent
19
+ - `hoverable: boolean` = false — Whether items highlight on hover
20
+
21
+ ## List.Item
22
+
23
+ - `asChild: boolean` = false — Whether to render as a child element.
24
+ - `children: React.ReactNode` (required) — Content of the list item
25
+ - `iconName: React.ComponentProps<typeof Icon>["name"]` — Icon name to display
26
+ - `iconPosition: "left" | "right"` = "left" — Position of the icon relative to the content
27
+ - `iconColor: React.ComponentProps<typeof Icon>["color"]` — Color of the icon
28
+ - `selected: boolean` = false — Whether the item is in the selected state
29
+
30
+ ## Design tokens it reads
31
+
32
+ `--wim-border-width-thin`, `--wim-color-border`, `--wim-color-border-secondary`, `--wim-color-primary`, `--wim-color-surface`, `--wim-font-size-lg`, `--wim-font-size-md`, `--wim-font-size-sm`, `--wim-line-height-normal-jp`, `--wim-list-item-padding-x`, `--wim-list-item-padding-y`, `--wim-radius-component`, `--wim-radius-full`, `--wim-scale-active`, `--wim-spacing-5xl`, `--wim-spacing-md`, `--wim-spacing-sm`, `--wim-transition-fast`
33
+
34
+ ---
35
+ Setup, composition rules and the full catalog: `llms.txt` / `llms-full.txt` in the same package.
@@ -0,0 +1,23 @@
1
+ # Loader — wimui
2
+
3
+ > Animated indicators to show that data is loading or processing
4
+
5
+ ## Import
6
+
7
+ ```ts
8
+ import "wimui/styles.css"; // once per app — required
9
+ import { Loader } from "wimui/feedback";
10
+ ```
11
+
12
+ ## Props
13
+
14
+ - `variant: "bars" | "dots" | "pulse"` = "bars" — Animation style of the loader. @default "bars"
15
+ - `size: Extract<ComponentSize, "sm" | "md" | "lg" | "xl">` = "md" — Size of the loader. @default "md"
16
+ - `color: "currentColor" | WimColor` = "primary" — Color of the loader. Accepts a design token color name or "currentColor". @default "primary"
17
+
18
+ ## Design tokens it reads
19
+
20
+ `--wim-color-danger`, `--wim-color-line`, `--wim-color-success`, `--wim-color-text-accent`, `--wim-color-text-secondary`, `--wim-color-warning`, `--wim-duration-base`, `--wim-duration-circle`, `--wim-duration-fast`, `--wim-duration-slow`, `--wim-duration-slowest`, `--wim-duration-ultra-slow`, `--wim-easing-standard`, `--wim-loader-dot-gap`, `--wim-loader-duration`, `--wim-opacity-dim`, `--wim-opacity-disabled`, `--wim-radius-full`, `--wim-radius-sm`, `--wim-spacing-2xl`, `--wim-spacing-2xs`, `--wim-spacing-3xl`, `--wim-spacing-lg`, `--wim-spacing-md`, `--wim-spacing-xl`, `--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,30 @@
1
+ # LoadingOverlay — wimui
2
+
3
+ > Overlay with loading indicator
4
+
5
+ ## Import
6
+
7
+ ```ts
8
+ import "wimui/styles.css"; // once per app — required
9
+ import { LoadingOverlay } from "wimui/feedback";
10
+ ```
11
+
12
+ ## Props
13
+
14
+ - `visible: boolean` = false — Whether the overlay is shown. @default false
15
+ - `loaderType: "spinner" | "bars" | "dots" | "pulse"` = "spinner" — Type of the loading indicator. @default "spinner"
16
+ - `loaderSize: "sm" | "md" | "lg" | "xl"` = "lg" — Size of the loading indicator. @default "lg"
17
+ - `loaderColor: "currentColor" | WimColor` = "primary" — 渡した値はそのまま `Spinner` / `Loader` の `color` へ流れる。 以前はここだけが独自の閉じた集合を持っており、同じ値が 3 段で違う型を 通っていた(T118)。委譲先と同じ型にそろえる。
18
+ - `backdropVariant: "light" | "dark"` = "dark" — Background style of the overlay. @default "dark"
19
+ - `blur: "none" | "sm" | "md" | "lg"` = "sm" — Strength of the backdrop blur effect. @default "sm"
20
+ - `message: string` — Loading message displayed below the indicator. Without a message (and without children), a built-in "Loading" text is read to assistive technology in its place.
21
+ - `fixed: boolean` = false — Whether to use position: fixed (covers the whole screen). When `false` (the default) the overlay is `position: absolute`, so it covers the nearest positioned ancestor — not necessarily the element you wrapped. Give that element a position explicitly, e.g. `<Box position="relative">`. `Card` sets `position: relative` for this reason (T88), so `<Card><LoadingOverlay /></Card>` covers the card. A plain `<div>` does not, and the overlay will spread to the viewport — measured at 1280x800 from the origin while the card it was meant to cover was 1248x75. @default false
22
+ - `zIndex: number` — z-index of the overlay.
23
+ - `children: React.ReactNode` — Custom loading content, replacing the default indicator.
24
+
25
+ ## Design tokens it reads
26
+
27
+ `--wim-blur-2xs`, `--wim-blur-glass`, `--wim-blur-xs`, `--wim-color-overlay`, `--wim-color-overlay-soft`, `--wim-color-overlay-strong`, `--wim-color-text-on-overlay`, `--wim-easing-exit`, `--wim-font-size-md`, `--wim-font-weight-medium`, `--wim-spacing-md`, `--wim-transition-duration-normal`, `--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,24 @@
1
+ # Markdown — wimui
2
+
3
+ > A component for safely rendering text in Markdown format.
4
+
5
+ ## Import
6
+
7
+ ```ts
8
+ import "wimui/styles.css"; // once per app — required
9
+ import { Markdown } from "wimui/data-display";
10
+ ```
11
+
12
+ ## Props
13
+
14
+ - `content: string` — Markdown string to render. Provide either `content` or `children`.
15
+ - `children: string` — Markdown string to render (when passed as children).
16
+ - `gfm: boolean` = true — Whether to enable GitHub Flavored Markdown (default: true).
17
+ - `className: string` — Additional class names.
18
+
19
+ ## Design tokens it reads
20
+
21
+ `--wim-border-width-thin`, `--wim-color-border`, `--wim-color-surface-subtle`, `--wim-color-text-accent`, `--wim-color-text-primary`, `--wim-color-text-secondary`, `--wim-font-size-2xl`, `--wim-font-size-xl`, `--wim-font-weight-semibold`, `--wim-line-height-normal`, `--wim-line-height-tight`, `--wim-radius-component`, `--wim-radius-sm`, `--wim-spacing-2xs`, `--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.
@@ -0,0 +1,24 @@
1
+ # MarkdownRenderer — wimui
2
+
3
+ > MarkdownRenderer converts a markdown string into WIM UI components. It uses react-markdown under the hood and applies WIM's typography system.
4
+
5
+ ## Import
6
+
7
+ ```ts
8
+ import "wimui/styles.css"; // once per app — required
9
+ import { MarkdownRenderer } from "wimui/ai";
10
+ ```
11
+
12
+ ## Props
13
+
14
+ - `content: string` (required) — The markdown string to render
15
+ - `baseLevel: (typeof TITLE_SIZE_STEPS)[number]` = "2xl" — Visual size of markdown `h1`. `h2`–`h4` step one Title size down from this, clamped at `xs`. Does not change the HTML heading tag — that stays as written in the markdown. Default `"2xl"` keeps the historical mapping (`h1` 2xl / `h2` xl / `h3` lg / `h4` md).
16
+ - `className: string` — Additional CSS class for the root element
17
+ - `withAnchors: boolean` — Whether to render titles with anchor links (default: false)
18
+
19
+ ## Design tokens it reads
20
+
21
+ `--wim-border-width-thin`, `--wim-color-border`, `--wim-color-surface-variant-alpha`, `--wim-color-text-accent`, `--wim-color-text-primary`, `--wim-font-weight-bold`, `--wim-line-height-normal`, `--wim-radius-component`, `--wim-radius-sm`, `--wim-spacing-lg`, `--wim-spacing-md`, `--wim-spacing-sm`, `--wim-spacing-xs`, `--wim-width-sm`
22
+
23
+ ---
24
+ Setup, composition rules and the full catalog: `llms.txt` / `llms-full.txt` in the same package.
@@ -0,0 +1,27 @@
1
+ # Marquee — wimui
2
+
3
+ > Scrolling text animation
4
+
5
+ Also known as: Ticker
6
+
7
+ ## Import
8
+
9
+ ```ts
10
+ import "wimui/styles.css"; // once per app — required
11
+ import { Marquee } from "wimui/data-display";
12
+ ```
13
+
14
+ ## Props
15
+
16
+ - `duration: number` = 20 — Animation speed (in seconds). Defaults to `20`.
17
+ - `reverse: boolean` = false — Whether to run the animation in reverse.
18
+ - `pauseOnHover: boolean` = true — Whether to pause the animation on hover. Keyboard focus inside the marquee always pauses it, regardless of this option (WCAG 2.2.2).
19
+ - `vertical: boolean` = false — Whether to scroll vertically.
20
+ - `repeat: number` = 2 — Number of times the content is repeated. May need adjusting for a seamless loop. Defaults to `2`.
21
+
22
+ ## Design tokens it reads
23
+
24
+ `--wim-spacing-md`
25
+
26
+ ---
27
+ Setup, composition rules and the full catalog: `llms.txt` / `llms-full.txt` in the same package.
@@ -0,0 +1,18 @@
1
+ # Masonry — wimui
2
+
3
+ > Waterfall grid
4
+
5
+ ## Import
6
+
7
+ ```ts
8
+ import "wimui/styles.css"; // once per app — required
9
+ import { Masonry } from "wimui/layout";
10
+ ```
11
+
12
+ ## Props
13
+
14
+ - `columns: number` = 3 — Number of columns. Pick it from how many items there are — three columns holding four cards leaves a ragged row that reads as a template, not a choice. @default 3
15
+ - `spacing: number | string` = "2xl" — Gap between items: a spacing token name (`"md"`, `"2xl"`, …) or a raw number of pixels. Prefer the token so the gap follows the theme. @default "2xl"
16
+
17
+ ---
18
+ Setup, composition rules and the full catalog: `llms.txt` / `llms-full.txt` in the same package.
@@ -0,0 +1,24 @@
1
+ # Mentions — wimui
2
+
3
+ > @ / # suggestions
4
+
5
+ ## Import
6
+
7
+ ```ts
8
+ import "wimui/styles.css"; // once per app — required
9
+ import { Mentions } from "wimui/form";
10
+ ```
11
+
12
+ ## Props
13
+
14
+ - `options: MentionOption[]` (required) — Mention candidates to suggest
15
+ - `trigger: string` = "@" — Character that triggers the suggestion list
16
+ - `onSelect: (option: MentionOption) => void` — Callback when a suggestion is selected
17
+ - `asChild: boolean` = false — Whether to render as a child element.
18
+
19
+ ## Design tokens it reads
20
+
21
+ `--wim-border-width-thin`, `--wim-color-border`, `--wim-color-surface`, `--wim-radius-overlay`, `--wim-shadow-overlay`, `--wim-spacing-2xs`, `--wim-spacing-xs`, `--wim-z-overlay`
22
+
23
+ ---
24
+ Setup, composition rules and the full catalog: `llms.txt` / `llms-full.txt` in the same package.
@@ -0,0 +1,30 @@
1
+ # Menu — wimui
2
+
3
+ > General menus
4
+
5
+ ⚠️ Not the same as elsewhere: In macOS, a "Menu" is the pull-down from a menu bar. WIM's `Menu` is the list of choices itself; for one that opens from a trigger, use `Dropdown`.
6
+
7
+ ## Import
8
+
9
+ ```ts
10
+ import "wimui/styles.css"; // once per app — required
11
+ import { Menu } from "wimui/overlay";
12
+ ```
13
+
14
+ ## Props
15
+
16
+ - `children: ReactNode` (required) — Menu items (MenuItem, MenuItemGroup, SubMenu, MenuDivider).
17
+ - `className: string` — Additional CSS class name for the container.
18
+ - `asChild: boolean` = false — If true, the menu root will be rendered as its child, merging its props onto that child.
19
+ - `mode: "vertical" | "horizontal" | "inline"` = "vertical" — Mode of the menu
20
+ - `defaultSelectedKeys: string[]` — Default selected keys
21
+ - `defaultOpenKeys: string[]` = [] — Default opened submenu keys
22
+ - `aria-label: string` — Accessible name for the menu.
23
+ - `aria-labelledby: string` — ID of the element that labels the menu. Takes precedence over `aria-label`.
24
+
25
+ ## Design tokens it reads
26
+
27
+ `--wim-border-width-thin`, `--wim-color-border`, `--wim-color-line`, `--wim-color-surface`, `--wim-color-text-secondary`, `--wim-duration-base`, `--wim-duration-fast`, `--wim-easing-entrance`, `--wim-easing-standard`, `--wim-font-size-md`, `--wim-font-size-xs`, `--wim-font-weight-semibold`, `--wim-letter-spacing-wide`, `--wim-list-item-padding-x`, `--wim-list-item-padding-y`, `--wim-menu-min-width`, `--wim-opacity-dim`, `--wim-radius-overlay`, `--wim-radius-sm`, `--wim-shadow-focus`, `--wim-shadow-overlay`, `--wim-spacing-lg`, `--wim-spacing-md`, `--wim-spacing-xs`
28
+
29
+ ---
30
+ Setup, composition rules and the full catalog: `llms.txt` / `llms-full.txt` in the same package.
@@ -0,0 +1,50 @@
1
+ # Menubar — wimui
2
+
3
+ > Desktop-style application menu bar with floating File / Edit / View submenus.
4
+
5
+ ## Import
6
+
7
+ ```ts
8
+ import "wimui/styles.css"; // once per app — required
9
+ import { Menubar } from "wimui/navigation";
10
+ ```
11
+
12
+ ## Props
13
+
14
+ - `asChild: boolean` = false — If true, the component will be rendered as its child, merging its props onto that child.
15
+
16
+ ## Menubar.Content
17
+
18
+ - `align: "start" | "end"` = "start" — Horizontal alignment of the floating panel relative to the trigger. @default "start"
19
+
20
+ ## Menubar.Item
21
+
22
+ - `asChild: boolean` — If true, the item will be rendered as its child, merging its props onto that child. Use when the list item must be a specific element (e.g. `<li>` inside `<ul>`).
23
+ - `icon: React.ReactNode` — Left icon or element to display before the children.
24
+ - `rightSection: React.ReactNode` — Right section (e.g., shortcuts, arrows, status indicators) to display after the children.
25
+ - `active: boolean` — If true, the item will be rendered in an active/highlighted state.
26
+ - `disabled: boolean` = false — If true, the item will be rendered in a disabled state and become non-interactive.
27
+ - `danger: boolean` — If true, the item will be styled to indicate a dangerous or danger action.
28
+ - `className: string` — Additional CSS class name.
29
+ - `children: ReactNode` (required)
30
+ - `onSelect: () => void`
31
+
32
+ ## Menubar.Menu
33
+
34
+ - `value: string` (required) — Stable id for this top-level menu. Used for open-state coordination.
35
+ - `disabled: boolean` = false — Disables the top-level trigger and prevents opening.
36
+
37
+ ## Menubar.Separator
38
+
39
+ (no props of its own)
40
+
41
+ ## Menubar.Trigger
42
+
43
+ - `asChild: boolean` = false
44
+
45
+ ## Design tokens it reads
46
+
47
+ `--wim-border-width-thin`, `--wim-color-border`, `--wim-color-surface`, `--wim-color-surface-hover`, `--wim-color-text-disabled`, `--wim-color-text-primary`, `--wim-floating-shift-x`, `--wim-font-size-sm`, `--wim-line-height-normal`, `--wim-menu-min-width`, `--wim-radius-component`, `--wim-radius-overlay`, `--wim-radius-sm`, `--wim-shadow-overlay`, `--wim-spacing-2xs`, `--wim-spacing-sm`, `--wim-spacing-xs`, `--wim-tap-target-min`, `--wim-z-overlay`
48
+
49
+ ---
50
+ Setup, composition rules and the full catalog: `llms.txt` / `llms-full.txt` in the same package.
@@ -0,0 +1,13 @@
1
+ # Meta — wimui
2
+
3
+ > Page metadata configuration
4
+
5
+ ## Import
6
+
7
+ ```ts
8
+ import "wimui/styles.css"; // once per app — required
9
+ import { Meta } 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,31 @@
1
+ # ModelSelector — wimui
2
+
3
+ > ModelSelector is a dropdown for switching between AI models, surfacing the metadata that matters when choosing one — context window size and per-token pricing.
4
+
5
+ ## Import
6
+
7
+ ```ts
8
+ import "wimui/styles.css"; // once per app — required
9
+ import { ModelSelector } from "wimui/ai";
10
+ ```
11
+
12
+ ## Props
13
+
14
+ - `models: ModelOption[]` (required) — List of selectable models
15
+ - `value: string` — Selected model id (controlled)
16
+ - `defaultValue: string` — Initially selected model id (uncontrolled)
17
+ - `onChange: (id: string, model: ModelOption) => void` — Callback when the selected model changes
18
+ - `size: Extract<ComponentSize, "sm" | "md" | "lg">` = "md" — Size of the trigger
19
+ - `disabled: boolean` = false — Whether the selector is disabled
20
+ - `fullWidth: boolean` = false — Whether to take full width of parent
21
+ - `showPricing: boolean` = true — Whether to show pricing metadata in the dropdown
22
+ - `showContext: boolean` = true — Whether to show the context-length metadata in the dropdown
23
+ - `labels: { /** Placeholder shown when nothing is selected */ placeholder?: string; /** Prefix for the context-length meta (default "Context") */ contextLabel?: string; /** Prefix for the input price meta (default "In") */ inputLabel?: string; /** Prefix for the output price meta (default "Out") */ outputLabel?: string; /** Suffix appended to prices (default "/1M") */ perTokensLabel?: string; /** Accessible label for the trigger button */ triggerAriaLabel?: string; }` — Labels for internationalization
24
+ - `className: string` — Additional class names
25
+
26
+ ## Design tokens it reads
27
+
28
+ `--wim-border-width-thin`, `--wim-color-border`, `--wim-color-focus-outline`, `--wim-color-primary`, `--wim-color-primary-muted`, `--wim-color-surface`, `--wim-color-surface-variant`, `--wim-color-text-accent`, `--wim-color-text-placeholder`, `--wim-color-text-primary`, `--wim-color-text-secondary`, `--wim-color-text-tertiary`, `--wim-duration-fast`, `--wim-easing-standard`, `--wim-floating-shift-x`, `--wim-font-family-default`, `--wim-font-size-md`, `--wim-font-size-sm`, `--wim-font-size-xs`, `--wim-font-weight-medium`, `--wim-height-lg`, `--wim-height-md`, `--wim-height-sm`, `--wim-line-height-snug-jp`, `--wim-opacity-disabled`, `--wim-radius-component`, `--wim-radius-overlay`, `--wim-radius-sm`, `--wim-shadow-focus-ring`, `--wim-shadow-overlay`, `--wim-spacing-3xs`, `--wim-spacing-lg`, `--wim-spacing-md`, `--wim-spacing-sm`, `--wim-spacing-xs`, `--wim-width-md`, `--wim-width-sm`, `--wim-z-overlay`
29
+
30
+ ---
31
+ Setup, composition rules and the full catalog: `llms.txt` / `llms-full.txt` in the same package.
@@ -0,0 +1,38 @@
1
+ # MultiSelect — wimui
2
+
3
+ > Multiple selection
4
+
5
+ ## Import
6
+
7
+ ```ts
8
+ import "wimui/styles.css"; // once per app — required
9
+ import { MultiSelect } from "wimui/form";
10
+ ```
11
+
12
+ ## Props
13
+
14
+ - `options: MultiSelectOption[]` = [] — List of options
15
+ - `value: string[]` — Selected values (controlled)
16
+ - `onChange: (value: string[]) => void` — Callback when the selection changes
17
+ - `placeholder: string` — Placeholder shown when nothing is selected
18
+ - `label: string` — Field label
19
+ - `error: string` — Error message
20
+ - `required: boolean` — Whether to show the required indicator
21
+ - `layout: "vertical" | "horizontal"` — Layout direction of label and field
22
+ - `className: string` — Additional class names
23
+ - `disabled: boolean` = false — Whether the field is disabled
24
+ - `defaultValue: string[]` = [] — Initially selected values (uncontrolled)
25
+ - `allowClear: boolean` = false — Whether to show a clear button to remove all selections
26
+ - `id: string` — Unique ID for the component
27
+ - `aria-label: string` — Accessible label for the trigger when no visible label is provided
28
+ - `aria-labelledby: string` — ID of the element that labels the field
29
+ - `aria-describedby: string` — ID of the element that describes the field
30
+ - `width: FieldWidth | string | number` — Fixed width of the field (width token, CSS value, or number in px)
31
+ - `fullWidth: boolean` = false — Whether to take full width of parent
32
+
33
+ ## Design tokens it reads
34
+
35
+ `--wim-border-width-thin`, `--wim-color-border`, `--wim-color-focus-outline`, `--wim-color-primary`, `--wim-color-surface`, `--wim-color-text-accent`, `--wim-color-text-on-disabled`, `--wim-color-text-placeholder`, `--wim-color-text-primary`, `--wim-color-text-secondary`, `--wim-field-padding-y`, `--wim-floating-shift-x`, `--wim-font-family-default`, `--wim-font-size-md`, `--wim-font-weight-medium`, `--wim-height-md`, `--wim-line-height-snug-jp`, `--wim-radius-overlay`, `--wim-radius-sm`, `--wim-shadow-field-focus`, `--wim-shadow-focus`, `--wim-shadow-overlay`, `--wim-spacing-xs`, `--wim-transition-base`, `--wim-transition-fast`, `--wim-width-md`, `--wim-z-overlay`
36
+
37
+ ---
38
+ Setup, composition rules and the full catalog: `llms.txt` / `llms-full.txt` in the same package.
@@ -0,0 +1,58 @@
1
+ # Navbar — wimui
2
+
3
+ > Primary navigation
4
+
5
+ ## Import
6
+
7
+ ```ts
8
+ import "wimui/styles.css"; // once per app — required
9
+ import { Navbar } from "wimui/layout";
10
+ ```
11
+
12
+ ## Props
13
+
14
+ - `fixed: boolean` — Whether the navbar is fixed to the viewport
15
+ - `sticky: boolean` — Whether the navbar sticks to the top while scrolling
16
+ - `transparent: boolean` — Whether the navbar background is transparent
17
+ - `glass: boolean` — Whether to apply the frosted-glass effect
18
+ - `bordered: boolean` — Whether to show a bottom border
19
+ - `fluid: boolean` — Expand content to full width (disable the centered max-width container)
20
+ - `defaultMenuOpen: boolean` = false — Initial open state of the mobile menu (uncontrolled)
21
+ - `isMenuOpen: boolean` — Open state of the mobile menu (controlled)
22
+ - `onMenuOpenChange: (isOpen: boolean) => void` — Callback when the mobile menu open state changes
23
+
24
+ ## Navbar.Brand
25
+
26
+ (no props of its own)
27
+
28
+ ## Navbar.Content
29
+
30
+ - `justify: "start" | "end" | "center"` = "end"
31
+ - `hiddenOnMobile: boolean`
32
+
33
+ ## Navbar.Item
34
+
35
+ - `active: boolean`
36
+
37
+ ## Navbar.Link
38
+
39
+ - `active: boolean`
40
+
41
+ ## Navbar.Menu
42
+
43
+ - `position: "right" | "left" | "top" | "bottom"` = "top"
44
+
45
+ ## Navbar.MenuItem
46
+
47
+ - `active: boolean`
48
+
49
+ ## Navbar.Toggle
50
+
51
+ (no props of its own)
52
+
53
+ ## Design tokens it reads
54
+
55
+ `--wim-blur-glass`, `--wim-border-width-thin`, `--wim-color-border-secondary`, `--wim-color-glass-bg`, `--wim-color-surface`, `--wim-color-surface-hover`, `--wim-color-text-accent`, `--wim-color-text-primary`, `--wim-color-text-secondary`, `--wim-font-size-lg`, `--wim-font-size-md`, `--wim-font-weight-bold`, `--wim-font-weight-medium`, `--wim-height-xl`, `--wim-layout-max-width`, `--wim-radius-sm`, `--wim-spacing-5xl`, `--wim-spacing-md`, `--wim-spacing-sm`, `--wim-spacing-xl`, `--wim-spacing-xs`, `--wim-transition-base`, `--wim-z-navbar`
56
+
57
+ ---
58
+ Setup, composition rules and the full catalog: `llms.txt` / `llms-full.txt` in the same package.
@@ -0,0 +1,38 @@
1
+ # NodeGraph — wimui
2
+
3
+ > Visualizes complex networks and relationships between nodes.
4
+
5
+ ## Import
6
+
7
+ ```ts
8
+ import "wimui/styles.css"; // once per app — required
9
+ import { NodeGraph } from "wimui/data-display";
10
+ ```
11
+
12
+ ## Props
13
+
14
+ - `nodes: Node[]` (required) — Controlled nodes
15
+ - `edges: Edge[]` (required) — Controlled edges
16
+ - `onNodesChange: OnNodesChange` (required) — Called when nodes change (position, selection, add, removal)
17
+ - `onEdgesChange: OnEdgesChange` (required) — Called when edges change
18
+ - `onConnect: OnConnect` — Called when a new connection is made
19
+ - `nodeTypes: NodeTypes` — Custom node type renderers
20
+ - `edgeTypes: EdgeTypes` — Custom edge type renderers
21
+ - `nodesDraggable: boolean` = true — Whether nodes can be dragged
22
+ - `nodesConnectable: boolean` = true — Whether nodes can be connected
23
+ - `deleteKeyCode: string | null` — Keys that delete the selection, and whether the on-canvas add/delete controls are shown. `null` hides the controls and disables key deletion (read-only). When omitted, both Backspace and Delete work.
24
+ - `showMiniMap: boolean` = false — Show the minimap panel
25
+ - `showControls: boolean` = true — Show zoom/fit controls
26
+ - `backgroundVariant: BackgroundVariant` = BackgroundVariant.Dots — Background grid style
27
+ - `fitView: boolean` = true — Fit view options on mount
28
+ - `fitViewOptions: FitViewOptions` — Options for the initial fit-view behavior
29
+ - `defaultEdgeOptions: DefaultEdgeOptions` — Default options applied to new edges
30
+ - `className: string` — Additional CSS class
31
+ - `aria-label: string` — Accessible label for the graph region
32
+
33
+ ## Design tokens it reads
34
+
35
+ `--wim-border-width-thick`, `--wim-border-width-thin`, `--wim-color-border`, `--wim-color-focus-outline`, `--wim-color-ghost-bg-hover`, `--wim-color-primary`, `--wim-color-surface`, `--wim-color-surface-app`, `--wim-color-text-disabled`, `--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-font-size-sm`, `--wim-height-sm`, `--wim-line-height-tight`, `--wim-radius-component`, `--wim-radius-container`, `--wim-shadow-sm`, `--wim-spacing-md`, `--wim-spacing-sm`, `--wim-spacing-xs`, `--wim-tap-target-min`, `--wim-width-sm`
36
+
37
+ ---
38
+ Setup, composition rules and the full catalog: `llms.txt` / `llms-full.txt` in the same package.
@@ -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: FeedbackIntent` = "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.