wimui 0.69.1 → 0.71.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (282) hide show
  1. package/dist/components/_internal/typeahead.cjs +2 -0
  2. package/dist/components/_internal/typeahead.d.ts +45 -0
  3. package/dist/components/_internal/typeahead.js +24 -0
  4. package/dist/components/_internal/useAnnounce.cjs +1 -1
  5. package/dist/components/_internal/useAnnounce.d.ts +22 -0
  6. package/dist/components/_internal/useAnnounce.js +36 -19
  7. package/dist/components/ai/CodeDiffViewer/CodeDiffViewer.cjs +2 -2
  8. package/dist/components/ai/CodeDiffViewer/CodeDiffViewer.js +106 -105
  9. package/dist/components/ai/ModelSelector/ModelSelector.cjs +1 -1
  10. package/dist/components/ai/ModelSelector/ModelSelector.js +119 -119
  11. package/dist/components/ai/StreamingText/StreamingText.cjs +1 -1
  12. package/dist/components/ai/StreamingText/StreamingText.d.ts +1 -1
  13. package/dist/components/ai/StreamingText/StreamingText.js +37 -23
  14. package/dist/components/data-display/DataGrid/DataGrid.cjs +1 -1
  15. package/dist/components/data-display/DataGrid/DataGrid.js +41 -40
  16. package/dist/components/data-display/InfiniteScroll/InfiniteScroll.cjs +1 -1
  17. package/dist/components/data-display/InfiniteScroll/InfiniteScroll.d.ts +1 -1
  18. package/dist/components/data-display/InfiniteScroll/InfiniteScroll.js +37 -26
  19. package/dist/components/feedback/Spinner/Spinner.cjs +1 -1
  20. package/dist/components/feedback/Spinner/Spinner.js +53 -43
  21. package/dist/components/form/Cascader/Cascader.cjs +1 -1
  22. package/dist/components/form/Cascader/Cascader.js +168 -151
  23. package/dist/components/form/Combobox/Combobox.cjs +1 -1
  24. package/dist/components/form/Combobox/Combobox.js +48 -47
  25. package/dist/components/form/MultiSelect/MultiSelect.cjs +1 -1
  26. package/dist/components/form/MultiSelect/MultiSelect.js +131 -111
  27. package/dist/components/form/Select/useSelect.cjs +1 -1
  28. package/dist/components/form/Select/useSelect.js +83 -75
  29. package/dist/components/form/Transfer/Transfer.cjs +1 -1
  30. package/dist/components/form/Transfer/Transfer.js +147 -142
  31. package/dist/components/media/Gallery/Gallery.cjs +1 -1
  32. package/dist/components/media/Gallery/Gallery.js +111 -110
  33. package/dist/components/navigation/Menubar/Menubar.cjs +1 -1
  34. package/dist/components/navigation/Menubar/Menubar.js +133 -122
  35. package/dist/components/overlay/Dropdown/Dropdown.cjs +1 -1
  36. package/dist/components/overlay/Dropdown/Dropdown.js +131 -122
  37. package/dist/components/overlay/Menu/Menu.cjs +1 -1
  38. package/dist/components/overlay/Menu/Menu.js +100 -89
  39. package/dist/hooks/useBreakpoint.d.ts +1 -0
  40. package/dist/i18n/generated/data-display.cjs +1 -1
  41. package/dist/i18n/generated/data-display.d.ts +1 -1
  42. package/dist/i18n/generated/data-display.js +6 -3
  43. package/dist/index.cjs +1 -1
  44. package/dist/index.js +18 -18
  45. package/dist/llms/AIResponseFeedback.md +26 -0
  46. package/dist/llms/Accordion.md +47 -0
  47. package/dist/llms/Affix.md +25 -0
  48. package/dist/llms/AgentStatus.md +25 -0
  49. package/dist/llms/Alert.md +28 -0
  50. package/dist/llms/Anchor.md +30 -0
  51. package/dist/llms/AppShell.md +52 -0
  52. package/dist/llms/AreaChart.md +27 -0
  53. package/dist/llms/ArtifactsOverlay.md +27 -0
  54. package/dist/llms/AspectRatio.md +22 -0
  55. package/dist/llms/Audio.md +44 -0
  56. package/dist/llms/Autosave.md +23 -0
  57. package/dist/llms/Avatar.md +27 -0
  58. package/dist/llms/AvatarGroup.md +28 -0
  59. package/dist/llms/BackTop.md +32 -0
  60. package/dist/llms/Badge.md +28 -0
  61. package/dist/llms/Banner.md +28 -0
  62. package/dist/llms/BarChart.md +26 -0
  63. package/dist/llms/Barcode.md +26 -0
  64. package/dist/llms/BentoGrid.md +25 -0
  65. package/dist/llms/Blockquote.md +26 -0
  66. package/dist/llms/BottomSheet.md +26 -0
  67. package/dist/llms/Box.md +44 -0
  68. package/dist/llms/BoxPlot.md +25 -0
  69. package/dist/llms/Breadcrumb.md +31 -0
  70. package/dist/llms/Button.md +33 -0
  71. package/dist/llms/ButtonGroup.md +27 -0
  72. package/dist/llms/Calendar.md +34 -0
  73. package/dist/llms/CalendarHeatmap.md +33 -0
  74. package/dist/llms/CandlestickChart.md +25 -0
  75. package/dist/llms/Canvas.md +13 -0
  76. package/dist/llms/Card.md +41 -0
  77. package/dist/llms/Carousel.md +33 -0
  78. package/dist/llms/Cascader.md +40 -0
  79. package/dist/llms/Center.md +40 -0
  80. package/dist/llms/Charts.md +13 -0
  81. package/dist/llms/ChatUI.md +17 -0
  82. package/dist/llms/Checkbox.md +24 -0
  83. package/dist/llms/CheckboxGroup.md +32 -0
  84. package/dist/llms/Chip.md +36 -0
  85. package/dist/llms/Code.md +25 -0
  86. package/dist/llms/CodeBlock.md +27 -0
  87. package/dist/llms/CodeDiffViewer.md +30 -0
  88. package/dist/llms/ColorInput.md +48 -0
  89. package/dist/llms/ColorPicker.md +46 -0
  90. package/dist/llms/Combobox.md +37 -0
  91. package/dist/llms/CommandPalette.md +25 -0
  92. package/dist/llms/Comment.md +35 -0
  93. package/dist/llms/Container.md +45 -0
  94. package/dist/llms/ContextMenu.md +25 -0
  95. package/dist/llms/ContrastChecker.md +13 -0
  96. package/dist/llms/Controls.md +13 -0
  97. package/dist/llms/CopyButton.md +26 -0
  98. package/dist/llms/Countdown.md +31 -0
  99. package/dist/llms/CounterTextarea.md +32 -0
  100. package/dist/llms/CreditCardInput.md +42 -0
  101. package/dist/llms/Dashboard.md +31 -0
  102. package/dist/llms/DataGrid.md +43 -0
  103. package/dist/llms/DatePicker.md +39 -0
  104. package/dist/llms/DateRangePicker.md +30 -0
  105. package/dist/llms/DescriptionList.md +26 -0
  106. package/dist/llms/Dialog.md +57 -0
  107. package/dist/llms/Divider.md +24 -0
  108. package/dist/llms/Drawer.md +29 -0
  109. package/dist/llms/Dropdown.md +50 -0
  110. package/dist/llms/Dropzone.md +36 -0
  111. package/dist/llms/EmptyState.md +23 -0
  112. package/dist/llms/ErrorBoundary.md +25 -0
  113. package/dist/llms/FAQSection.md +24 -0
  114. package/dist/llms/FieldError.md +19 -0
  115. package/dist/llms/FieldTemplate.md +30 -0
  116. package/dist/llms/Fieldset.md +24 -0
  117. package/dist/llms/FileUpload.md +40 -0
  118. package/dist/llms/Flex.md +23 -0
  119. package/dist/llms/FloatButton.md +36 -0
  120. package/dist/llms/FocusTrap.md +20 -0
  121. package/dist/llms/Footer.md +32 -0
  122. package/dist/llms/FunnelChart.md +24 -0
  123. package/dist/llms/Gallery.md +30 -0
  124. package/dist/llms/GanttChart.md +29 -0
  125. package/dist/llms/GaugeChart.md +30 -0
  126. package/dist/llms/Grid.md +30 -0
  127. package/dist/llms/Group.md +22 -0
  128. package/dist/llms/HamburgerMenu.md +30 -0
  129. package/dist/llms/Header.md +30 -0
  130. package/dist/llms/Heatmap.md +25 -0
  131. package/dist/llms/Highlight.md +26 -0
  132. package/dist/llms/HoverCard.md +26 -0
  133. package/dist/llms/Icon.md +25 -0
  134. package/dist/llms/IconButton.md +30 -0
  135. package/dist/llms/Image.md +46 -0
  136. package/dist/llms/ImageCompare.md +35 -0
  137. package/dist/llms/ImageCropper.md +34 -0
  138. package/dist/llms/Indicator.md +28 -0
  139. package/dist/llms/InfiniteScroll.md +28 -0
  140. package/dist/llms/InlineEdit.md +32 -0
  141. package/dist/llms/Input.md +46 -0
  142. package/dist/llms/InputBase.md +39 -0
  143. package/dist/llms/InputGroup.md +23 -0
  144. package/dist/llms/InputMask.md +44 -0
  145. package/dist/llms/InteractiveArea.md +32 -0
  146. package/dist/llms/InteractiveGraph.md +28 -0
  147. package/dist/llms/JsonDiffViewer.md +24 -0
  148. package/dist/llms/JsonViewer.md +26 -0
  149. package/dist/llms/Kanban.md +25 -0
  150. package/dist/llms/Kbd.md +23 -0
  151. package/dist/llms/KeyboardShortcuts.md +25 -0
  152. package/dist/llms/Label.md +27 -0
  153. package/dist/llms/Leaderboard.md +24 -0
  154. package/dist/llms/Legend.md +27 -0
  155. package/dist/llms/Lightbox.md +47 -0
  156. package/dist/llms/LineChart.md +26 -0
  157. package/dist/llms/Link.md +28 -0
  158. package/dist/llms/LinkButton.md +23 -0
  159. package/dist/llms/List.md +35 -0
  160. package/dist/llms/Loader.md +23 -0
  161. package/dist/llms/LoadingOverlay.md +30 -0
  162. package/dist/llms/Markdown.md +24 -0
  163. package/dist/llms/MarkdownRenderer.md +24 -0
  164. package/dist/llms/Marquee.md +27 -0
  165. package/dist/llms/Masonry.md +18 -0
  166. package/dist/llms/Mentions.md +24 -0
  167. package/dist/llms/Menu.md +30 -0
  168. package/dist/llms/Menubar.md +50 -0
  169. package/dist/llms/Meta.md +13 -0
  170. package/dist/llms/ModelSelector.md +31 -0
  171. package/dist/llms/MultiSelect.md +38 -0
  172. package/dist/llms/Navbar.md +58 -0
  173. package/dist/llms/NodeGraph.md +38 -0
  174. package/dist/llms/Notification.md +30 -0
  175. package/dist/llms/NumberInput.md +23 -0
  176. package/dist/llms/OtpInput.md +33 -0
  177. package/dist/llms/OverflowList.md +31 -0
  178. package/dist/llms/Pagination.md +39 -0
  179. package/dist/llms/PasswordInput.md +39 -0
  180. package/dist/llms/PasswordStrength.md +34 -0
  181. package/dist/llms/PhoneInput.md +35 -0
  182. package/dist/llms/PieChart.md +23 -0
  183. package/dist/llms/PivotTable.md +41 -0
  184. package/dist/llms/PlatformIcons.md +13 -0
  185. package/dist/llms/Popconfirm.md +30 -0
  186. package/dist/llms/Popover.md +27 -0
  187. package/dist/llms/Portal.md +18 -0
  188. package/dist/llms/Presence.md +26 -0
  189. package/dist/llms/Progress.md +29 -0
  190. package/dist/llms/ProgressRing.md +27 -0
  191. package/dist/llms/PromptInput.md +37 -0
  192. package/dist/llms/PullToRefresh.md +26 -0
  193. package/dist/llms/QRCode.md +30 -0
  194. package/dist/llms/QueryBuilder.md +31 -0
  195. package/dist/llms/RadarChart.md +24 -0
  196. package/dist/llms/Radio.md +23 -0
  197. package/dist/llms/RadioGroup.md +32 -0
  198. package/dist/llms/RangeCalendar.md +26 -0
  199. package/dist/llms/RangeSlider.md +39 -0
  200. package/dist/llms/Rating.md +37 -0
  201. package/dist/llms/Reaction.md +26 -0
  202. package/dist/llms/RefTable.md +13 -0
  203. package/dist/llms/RelativeTime.md +24 -0
  204. package/dist/llms/Result.md +29 -0
  205. package/dist/llms/RichTextEditor.md +59 -0
  206. package/dist/llms/SankeyChart.md +26 -0
  207. package/dist/llms/ScatterChart.md +26 -0
  208. package/dist/llms/ScheduleView.md +35 -0
  209. package/dist/llms/ScrollArea.md +24 -0
  210. package/dist/llms/ScrollProgress.md +22 -0
  211. package/dist/llms/SearchInput.md +44 -0
  212. package/dist/llms/SegmentedControl.md +40 -0
  213. package/dist/llms/Select.md +44 -0
  214. package/dist/llms/SelectionBar.md +28 -0
  215. package/dist/llms/Sidebar.md +47 -0
  216. package/dist/llms/SignaturePad.md +36 -0
  217. package/dist/llms/SimpleGrid.md +24 -0
  218. package/dist/llms/Skeleton.md +26 -0
  219. package/dist/llms/Slider.md +36 -0
  220. package/dist/llms/SmartSearchInput.md +35 -0
  221. package/dist/llms/Snackbar.md +30 -0
  222. package/dist/llms/SortableList.md +33 -0
  223. package/dist/llms/SourceCitation.md +28 -0
  224. package/dist/llms/SourceCode.md +13 -0
  225. package/dist/llms/Span.md +29 -0
  226. package/dist/llms/Sparkline.md +27 -0
  227. package/dist/llms/SpeedDial.md +28 -0
  228. package/dist/llms/Spinner.md +26 -0
  229. package/dist/llms/SplitButton.md +29 -0
  230. package/dist/llms/Splitter.md +37 -0
  231. package/dist/llms/Spoiler.md +26 -0
  232. package/dist/llms/Stack.md +48 -0
  233. package/dist/llms/Stats.md +44 -0
  234. package/dist/llms/Stepper.md +32 -0
  235. package/dist/llms/StreamingText.md +24 -0
  236. package/dist/llms/SwipeAction.md +28 -0
  237. package/dist/llms/SwipeableList.md +21 -0
  238. package/dist/llms/Switch.md +27 -0
  239. package/dist/llms/SwitchGroup.md +31 -0
  240. package/dist/llms/T.md +13 -0
  241. package/dist/llms/TabBar.md +33 -0
  242. package/dist/llms/TabNavigation.md +30 -0
  243. package/dist/llms/Table.md +73 -0
  244. package/dist/llms/Tabs.md +40 -0
  245. package/dist/llms/Tag.md +30 -0
  246. package/dist/llms/TagInput.md +37 -0
  247. package/dist/llms/Terminal.md +29 -0
  248. package/dist/llms/Text.md +31 -0
  249. package/dist/llms/Textarea.md +30 -0
  250. package/dist/llms/ThemeToggle.md +31 -0
  251. package/dist/llms/ThoughtProcess.md +27 -0
  252. package/dist/llms/ThreadList.md +27 -0
  253. package/dist/llms/TimePicker.md +41 -0
  254. package/dist/llms/Timeline.md +24 -0
  255. package/dist/llms/Title.md +27 -0
  256. package/dist/llms/Toast.md +32 -0
  257. package/dist/llms/ToggleGroup.md +39 -0
  258. package/dist/llms/Toolbar.md +35 -0
  259. package/dist/llms/Tooltip.md +29 -0
  260. package/dist/llms/Tour.md +24 -0
  261. package/dist/llms/Transfer.md +35 -0
  262. package/dist/llms/Transition.md +34 -0
  263. package/dist/llms/TreeDiagram.md +33 -0
  264. package/dist/llms/TreeSelect.md +43 -0
  265. package/dist/llms/TreeView.md +50 -0
  266. package/dist/llms/Treemap.md +27 -0
  267. package/dist/llms/UsageMeter.md +31 -0
  268. package/dist/llms/Video.md +46 -0
  269. package/dist/llms/VirtualList.md +31 -0
  270. package/dist/llms/VisuallyHidden.md +19 -0
  271. package/dist/llms/VoiceVisualizer.md +30 -0
  272. package/dist/llms/WaterfallChart.md +25 -0
  273. package/dist/llms/Watermark.md +27 -0
  274. package/dist/llms/colorSwatch.md +13 -0
  275. package/dist/llms-full.txt +6 -3
  276. package/dist/llms.txt +4 -2
  277. package/dist/locales/en/data-display.json +3 -0
  278. package/dist/locales/ja/data-display.json +3 -0
  279. package/dist/locales/pt/data-display.json +3 -0
  280. package/dist/styles.css +1 -1
  281. package/dist/wimui.umd.js +5 -5
  282. package/package.json +11 -4
@@ -0,0 +1,48 @@
1
+ # Stack — wimui
2
+
3
+ > Vertical/Horizontal alignment
4
+
5
+ ## Import
6
+
7
+ ```ts
8
+ import "wimui/styles.css"; // once per app — required
9
+ import { Stack } from "wimui/layout";
10
+ ```
11
+
12
+ ## Props
13
+
14
+ - `asChild: boolean` = false — Whether to render as a child element.
15
+ - `gap: number | string` = "md" — Gap between children. Can be a number (px) or a spacing token (e.g., 'sm', 'md', 'lg').
16
+ - `direction: T | { base?: T; sm?: T; md?: T; lg?: T; xl?: T; }` = "column" — Stack direction
17
+ - `align: "start" | "center" | "end" | "stretch" | "baseline" | ReactCSSProperties["alignItems"]` — Align-items
18
+ - `justify: "start" | "center" | "end" | "between" | "around" | "evenly" | "stretch" | ReactCSSProperties["justifyContent"]` — Justify-content
19
+ - `wrap: boolean | React.CSSProperties["flexWrap"]` — Whether children should wrap
20
+ - `p: number | WimSpacing` — Padding
21
+ - `pt: number | WimSpacing` — Padding top
22
+ - `pr: number | WimSpacing` — Padding right
23
+ - `pb: number | WimSpacing` — Padding bottom
24
+ - `pl: number | WimSpacing` — Padding left
25
+ - `px: number | WimSpacing` — Padding horizontal
26
+ - `py: number | WimSpacing` — Padding vertical
27
+ - `m: number | WimSpacing` — Margin
28
+ - `mt: number | WimSpacing` — Margin top
29
+ - `mr: number | WimSpacing` — Margin right
30
+ - `mb: number | WimSpacing` — Margin bottom
31
+ - `ml: number | WimSpacing` — Margin left
32
+ - `mx: number | WimSpacing` — Margin horizontal
33
+ - `my: number | WimSpacing` — Margin vertical
34
+ - `bg: T | (string & {})` — Background color
35
+ - `color: T | (string & {})` — Text color
36
+ - `w: T | { base?: T; sm?: T; md?: T; lg?: T; xl?: T; }` — Width
37
+ - `h: T | { base?: T; sm?: T; md?: T; lg?: T; xl?: T; }` — Height
38
+ - `radius: number | WimRadius` — Border radius
39
+ - `shadow: T | (string & {})` — Box shadow
40
+ - `display: React.CSSProperties["display"]` — Display
41
+ - `position: React.CSSProperties["position"]` — Position
42
+
43
+ ## Design tokens it reads
44
+
45
+ `--wim-stack-dir`, `--wim-stack-dir-lg`, `--wim-stack-dir-md`, `--wim-stack-dir-sm`, `--wim-stack-dir-xl`
46
+
47
+ ---
48
+ Setup, composition rules and the full catalog: `llms.txt` / `llms-full.txt` in the same package.
@@ -0,0 +1,44 @@
1
+ # Stats — wimui
2
+
3
+ > A component to highlight key performance indicators and metrics
4
+
5
+ Also known as: Statistic, Stat
6
+
7
+ ## Import
8
+
9
+ ```ts
10
+ import "wimui/styles.css"; // once per app — required
11
+ import { Stats } from "wimui/data-display";
12
+ ```
13
+
14
+ ## Props
15
+
16
+ - `variant: React.ComponentProps<typeof Card>["variant"]` = "outline" — Visual style variant of the card
17
+ - `asChild: boolean` = false — If true, the card will be rendered as its child, merging its props onto that child.
18
+ - `interactive: boolean` = false — Whether the card is clickable: shows hover and press feedback and a pointer cursor
19
+ - `padding: (typeof CARD_STYLED_PADDING)[number]` = "md" — Padding size. Derived from the values `card.module.scss` implements, not from `ComponentSize`. Declaring the whole scale meant `padding="5xl"` type-checked and then did nothing (T38); deriving it means the type cannot drift from the stylesheet again, because `Card.unstyled-values.test.tsx` fails if the list stops matching the SCSS.
20
+ - `radius: (typeof CARD_STYLED_RADIUS)[number]` = "lg" — Corner radius size. Same derivation as `padding`. There is no `--wim-radius-xs` / `-3xl` / `-4xl` / `-5xl` token, so those values had nothing they could have meant.
21
+
22
+ ## Stats.Description
23
+
24
+ (no props of its own)
25
+
26
+ ## Stats.Label
27
+
28
+ (no props of its own)
29
+
30
+ ## Stats.Trend
31
+
32
+ - `direction: "up" | "down" | "neutral"` = "up" — Trend direction, which controls the arrow icon. When `intent` is not given it also sets the color (`up` = success, `down` = danger, `neutral` = neutral). @default "up"
33
+ - `intent: "success" | "danger" | "neutral"` = { up: "success", down: "danger", neutral: "neutral" } — Whether the change is good or bad, which controls the color independently of the arrow. Set it for metrics where a rise is bad news, such as costs or error rates: `direction="up" intent="danger"`. Defaults to the color implied by `direction`.
34
+
35
+ ## Stats.Value
36
+
37
+ (no props of its own)
38
+
39
+ ## Design tokens it reads
40
+
41
+ `--wim-color-surface`, `--wim-color-text-danger`, `--wim-color-text-primary`, `--wim-color-text-secondary`, `--wim-color-text-tertiary`, `--wim-comp-trend-success-fill`, `--wim-font-size-2xl`, `--wim-font-size-sm`, `--wim-font-size-xs`, `--wim-font-weight-bold`, `--wim-font-weight-medium`, `--wim-font-weight-semibold`, `--wim-line-height-normal`, `--wim-line-height-snug`, `--wim-line-height-tight`, `--wim-radius-sm`, `--wim-spacing-2xl`, `--wim-spacing-2xs`, `--wim-spacing-3xs`, `--wim-spacing-xs`
42
+
43
+ ---
44
+ Setup, composition rules and the full catalog: `llms.txt` / `llms-full.txt` in the same package.
@@ -0,0 +1,32 @@
1
+ # Stepper — wimui
2
+
3
+ > Visual sequence steps
4
+
5
+ ⚠️ Not the same as elsewhere: In Apple HIG and macOS, a "Stepper" is the control that increments a number — that is `NumberInput` here. WIM's `Stepper` shows progress through a sequence of steps, which is what Material calls a Stepper.
6
+
7
+ ## Import
8
+
9
+ ```ts
10
+ import "wimui/styles.css"; // once per app — required
11
+ import { Stepper } from "wimui/navigation";
12
+ ```
13
+
14
+ ## Props
15
+
16
+ - `steps: Step[]` = [] — Array of step configurations
17
+ - `current: number` = 0 — Index of the current active step (0-indexed)
18
+ - `direction: "horizontal" | "vertical"` = "horizontal" — Direction of the stepper
19
+ - `labelPlacement: "horizontal" | "vertical"` = "horizontal" — Placement of the labels
20
+ - `intent: "wait" | "process" | "finish" | "error"` = "process" — Workflow intent shown on the current active step (default: "process")
21
+ - `className: string` — Additional class names
22
+ - `ariaLabel: string` — Accessibility label for the navigation
23
+ - `onChange: (current: number) => void` — Callback function when a step is clicked (if applicable)
24
+ - `asChild: boolean` — Whether to use the Radix Slot pattern
25
+ - `children: React.ReactNode` — The element that becomes the stepper's root when `asChild` is set (the steps are rendered inside it). Ignored without `asChild`.
26
+
27
+ ## Design tokens it reads
28
+
29
+ `--wim-border-width-thick`, `--wim-color-border-secondary`, `--wim-color-danger`, `--wim-color-primary`, `--wim-color-surface`, `--wim-color-text-accent`, `--wim-color-text-on-primary`, `--wim-color-text-primary`, `--wim-color-text-secondary`, `--wim-focus-outline-width`, `--wim-font-size-md`, `--wim-font-size-sm`, `--wim-font-weight-bold`, `--wim-font-weight-medium`, `--wim-opacity-disabled`, `--wim-radius-full`, `--wim-scale-active-sm`, `--wim-spacing-3xl`, `--wim-spacing-lg`, `--wim-spacing-md`, `--wim-spacing-sm`, `--wim-spacing-xs`, `--wim-transition-base`, `--wim-transition-fast`, `--wim-width-sm`
30
+
31
+ ---
32
+ Setup, composition rules and the full catalog: `llms.txt` / `llms-full.txt` in the same package.
@@ -0,0 +1,24 @@
1
+ # StreamingText — wimui
2
+
3
+ > Renders text with a typewriter-like animation, ideal for AI chat responses.
4
+
5
+ ## Import
6
+
7
+ ```ts
8
+ import "wimui/styles.css"; // once per app — required
9
+ import { StreamingText } from "wimui/ai";
10
+ ```
11
+
12
+ ## Props
13
+
14
+ - `content: string` (required) — The markdown text content to render
15
+ - `isStreaming: boolean` = false — When true, a blinking cursor is shown at the end of the content
16
+ - `components: Components` — Override the default markdown component renderers
17
+ - `className: string` — Additional CSS class
18
+
19
+ ## Design tokens it reads
20
+
21
+ `--wim-border-width-thick`, `--wim-border-width-thin`, `--wim-color-border`, `--wim-color-ghost-bg`, `--wim-color-primary`, `--wim-color-text-accent`, `--wim-color-text-primary`, `--wim-color-text-secondary`, `--wim-font-size-md`, `--wim-font-weight-bold`, `--wim-line-height-loose`, `--wim-line-height-tight`, `--wim-opacity-subtle`, `--wim-radius-component`, `--wim-radius-sm`, `--wim-spacing-3xs`, `--wim-spacing-md`, `--wim-spacing-sm`, `--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,28 @@
1
+ # SwipeAction — wimui
2
+
3
+ > Mobile-friendly swipe actions (delete, archive) for list items.
4
+
5
+ ## Import
6
+
7
+ ```ts
8
+ import "wimui/styles.css"; // once per app — required
9
+ import { SwipeAction } from "wimui/data-display";
10
+ ```
11
+
12
+ ## Props
13
+
14
+ - `as: React.ElementType` = "div" — The element to render as the root container. Default is 'div'.
15
+ - `leftActions: SwipeActionItem[]` = [] — Actions revealed when swiping from left to right
16
+ - `rightActions: SwipeActionItem[]` = [] — Actions revealed when swiping from right to left
17
+ - `children: React.ReactNode` (required) — The content to be wrapped and swiped
18
+ - `asChild: boolean` = false — If true, the content div will be rendered as its child
19
+ - `id: string` — Unique ID for the item. Automatically generated if not provided.
20
+ - `closeOnAction: boolean` = true — Whether to automatically close the actions when an action is clicked. Default is true.
21
+ - `fullSwipe: "left" | "right" | "both"` — Sides where swiping all the way across runs the outermost action without a tap (`leftActions[0]` / the last of `rightActions`), as in iOS Mail. Off by default so a destructive action is never triggered by momentum; the action stays available as a button.
22
+
23
+ ## Design tokens it reads
24
+
25
+ `--wim-color-danger`, `--wim-color-line`, `--wim-color-primary`, `--wim-color-success`, `--wim-color-surface`, `--wim-color-surface-subtle-alpha`, `--wim-color-surface-variant`, `--wim-color-text-on-inverse`, `--wim-color-text-primary`, `--wim-color-warning`, `--wim-duration-fast`, `--wim-easing-standard`, `--wim-font-size-xs`, `--wim-font-weight-medium`, `--wim-spacing-md`, `--wim-spacing-xs`
26
+
27
+ ---
28
+ Setup, composition rules and the full catalog: `llms.txt` / `llms-full.txt` in the same package.
@@ -0,0 +1,21 @@
1
+ # SwipeableList — wimui
2
+
3
+ > Container for SwipeAction rows that keeps at most one row open at a time.
4
+
5
+ Also known as: Swipeable List
6
+
7
+ ## Import
8
+
9
+ ```ts
10
+ import "wimui/styles.css"; // once per app — required
11
+ import { SwipeableList } from "wimui/data-display";
12
+ ```
13
+
14
+ ## Props
15
+
16
+ - `children: React.ReactNode` (required) — The `SwipeAction` rows to coordinate
17
+ - `exclusive: boolean` = true — If true (default), only one row can be open at a time — opening a row, by swipe or by keyboard focus on its actions, closes the others.
18
+ - `className: string` — Additional CSS class
19
+
20
+ ---
21
+ Setup, composition rules and the full catalog: `llms.txt` / `llms-full.txt` in the same package.
@@ -0,0 +1,27 @@
1
+ # Switch — wimui
2
+
3
+ > A binary switch for instantly toggling settings between on and off states
4
+
5
+ Also known as: Toggle, Toggle Switch
6
+
7
+ ## Import
8
+
9
+ ```ts
10
+ import "wimui/styles.css"; // once per app — required
11
+ import { Switch } from "wimui/form";
12
+ ```
13
+
14
+ ## Props
15
+
16
+ - `asChild: boolean` = false — If true, the component will be rendered as its child, merging its props onto that child.
17
+ - `size: Extract<ComponentSize, "sm" | "md" | "lg">` = "md" — Size of the switch
18
+ - `className: string` — Additional class names
19
+ - `children: React.ReactNode` — Label content rendered next to the switch
20
+ - `error: boolean` = false — Whether to display as an error state (aria-invalid is applied)
21
+
22
+ ## Design tokens it reads
23
+
24
+ `--wim-border-width-thick`, `--wim-color-border-secondary`, `--wim-color-danger`, `--wim-color-focus-outline`, `--wim-color-primary`, `--wim-color-text-danger`, `--wim-color-white`, `--wim-duration-base`, `--wim-duration-fast`, `--wim-duration-ultra-fast`, `--wim-easing-entrance`, `--wim-easing-standard`, `--wim-opacity-ghost`, `--wim-radius-full`, `--wim-scale-active`, `--wim-shadow-error-ring`, `--wim-shadow-focus`, `--wim-shadow-sm`, `--wim-spacing-2xs`, `--wim-spacing-sm`, `--wim-switch-height-lg`, `--wim-switch-height-md`, `--wim-switch-height-sm`, `--wim-switch-width-lg`, `--wim-switch-width-md`, `--wim-switch-width-sm`, `--wim-tap-target-min`
25
+
26
+ ---
27
+ Setup, composition rules and the full catalog: `llms.txt` / `llms-full.txt` in the same package.
@@ -0,0 +1,31 @@
1
+ # SwitchGroup — wimui
2
+
3
+ > Shared state switches
4
+
5
+ ## Import
6
+
7
+ ```ts
8
+ import "wimui/styles.css"; // once per app — required
9
+ import { SwitchGroup } from "wimui/form";
10
+ ```
11
+
12
+ ## Props
13
+
14
+ - `options: Option[]` (required) — List of switch options
15
+ - `value: string[]` — Selected values (controlled)
16
+ - `defaultValue: string[]` = [] — Initially selected values (uncontrolled)
17
+ - `onChange: (value: string[]) => void` — Callback when the selected values change
18
+ - `direction: "vertical" | "horizontal"` = "vertical" — Layout direction of the switches
19
+ - `name: string` — Name attribute shared by the switch inputs
20
+ - `asChild: boolean` = false — Whether to render as a child element.
21
+ - `label: string` — Group label
22
+ - `error: string` — Error message
23
+ - `required: boolean` — Whether to show the required indicator
24
+ - `disabled: boolean` — Whether the whole group is disabled
25
+
26
+ ## Design tokens it reads
27
+
28
+ `--wim-spacing-lg`, `--wim-spacing-md`
29
+
30
+ ---
31
+ Setup, composition rules and the full catalog: `llms.txt` / `llms-full.txt` in the same package.
package/dist/llms/T.md ADDED
@@ -0,0 +1,13 @@
1
+ # T — wimui
2
+
3
+ > Display multilingual text
4
+
5
+ ## Import
6
+
7
+ ```ts
8
+ import "wimui/styles.css"; // once per app — required
9
+ import { T } 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,33 @@
1
+ # TabBar — wimui
2
+
3
+ > Mobile bottom navigation
4
+
5
+ Also known as: Bottom Navigation, Bottom Tab Bar
6
+
7
+ ## Import
8
+
9
+ ```ts
10
+ import "wimui/styles.css"; // once per app — required
11
+ import { TabBar } from "wimui/navigation";
12
+ ```
13
+
14
+ ## Props
15
+
16
+ - `fixed: boolean` = true — Pins the bar to the bottom of the **viewport**. Defaults to `true`. The pin is `position: fixed`, so the bar leaves whatever container you put it in: inside a device-width frame, a preview pane, or a split view it spans the whole window instead. Pass `false` whenever the bar belongs to a container rather than to the window — a screen inside a screen. Nothing warns you about this. `position: fixed` does not widen the document, so the page never gains a horizontal scrollbar and overflow scans stay green while the bar hangs outside its parent.
17
+ - `bordered: boolean` = true — Show top border
18
+ - `glass: boolean` = false — Glassmorphism effect
19
+
20
+ ## TabBar.Item
21
+
22
+ - `asChild: boolean` = false — If true, the item will be rendered as its child, merging its props onto that child.
23
+ - `active: boolean` — Active state
24
+ - `icon: React.ReactNode` — Icon element
25
+ - `label: string` — Text label
26
+ - `badge: React.ReactNode` — Badge content (optional)
27
+
28
+ ## Design tokens it reads
29
+
30
+ `--wim-blur-xs`, `--wim-border-width-thick`, `--wim-border-width-thin`, `--wim-color-border-secondary`, `--wim-color-danger`, `--wim-color-glass-bg`, `--wim-color-surface`, `--wim-color-text-accent`, `--wim-color-text-on-danger`, `--wim-color-text-secondary`, `--wim-font-size-2xl`, `--wim-font-size-2xs`, `--wim-font-weight-bold`, `--wim-font-weight-medium`, `--wim-height-md`, `--wim-line-height-tight`, `--wim-radius-full`, `--wim-spacing-2xs`, `--wim-spacing-3xs`, `--wim-spacing-md`, `--wim-spacing-sm`, `--wim-spacing-xl`, `--wim-spacing-xs`, `--wim-tab-nav-height`, `--wim-tab-nav-max-width`, `--wim-transition-base`, `--wim-z-overlay`
31
+
32
+ ---
33
+ Setup, composition rules and the full catalog: `llms.txt` / `llms-full.txt` in the same package.
@@ -0,0 +1,30 @@
1
+ # TabNavigation — wimui
2
+
3
+ > Tab-based navigation
4
+
5
+ ## Import
6
+
7
+ ```ts
8
+ import "wimui/styles.css"; // once per app — required
9
+ import { TabNavigation } from "wimui/navigation";
10
+ ```
11
+
12
+ ## Props
13
+
14
+ - `variant: "underline" | "pill" | "contained"` = "underline" — Visual style of the tabs
15
+ - `align: "start" | "center" | "end" | "justify"` = "start" — Alignment of the tabs
16
+ - `size: Extract<ComponentSize, "sm" | "md" | "lg">` = "md" — Size of the tabs
17
+
18
+ ## TabNavigation.Item
19
+
20
+ - `asChild: boolean` = false — If true, the item will be rendered as its child, merging its props onto that child.
21
+ - `active: boolean` — Active state
22
+ - `disabled: boolean` — Disabled state
23
+ - `icon: React.ReactNode` — Icon element
24
+
25
+ ## Design tokens it reads
26
+
27
+ `--wim-border-width-thick`, `--wim-border-width-thin`, `--wim-color-border-secondary`, `--wim-color-focus-outline`, `--wim-color-primary`, `--wim-color-surface-hover`, `--wim-color-surface-variant`, `--wim-color-text-accent`, `--wim-color-text-disabled`, `--wim-color-text-on-primary`, `--wim-color-text-primary`, `--wim-color-text-secondary`, `--wim-control-item-padding-x-lg`, `--wim-control-item-padding-x-md`, `--wim-control-padding-x-sm`, `--wim-duration-fast`, `--wim-easing-standard`, `--wim-focus-outline-width`, `--wim-font-size-lg`, `--wim-font-size-md`, `--wim-font-size-sm`, `--wim-font-weight-bold`, `--wim-font-weight-medium`, `--wim-height-lg`, `--wim-height-md`, `--wim-height-sm`, `--wim-radius-full`, `--wim-radius-sm`, `--wim-spacing-2xs`, `--wim-spacing-md`, `--wim-spacing-xl`, `--wim-spacing-xs`, `--wim-tab-nav-font-size`, `--wim-tab-nav-height`, `--wim-tab-nav-padding`, `--wim-transition-fast`
28
+
29
+ ---
30
+ Setup, composition rules and the full catalog: `llms.txt` / `llms-full.txt` in the same package.
@@ -0,0 +1,73 @@
1
+ # Table — wimui
2
+
3
+ > Rows and columns for displaying structured data efficiently
4
+
5
+ ## Import
6
+
7
+ ```ts
8
+ import "wimui/styles.css"; // once per app — required
9
+ import { Table } from "wimui/data-display";
10
+ ```
11
+
12
+ ## Props
13
+
14
+ - `asChild: boolean` = false — Whether to render as a child element.
15
+ - `striped: boolean` = false — Whether to show striped (zebra) rows
16
+ - `bordered: boolean` = false — Whether to show borders between cells
17
+ - `hoverable: boolean` = false — Whether rows highlight on hover
18
+ - `fullWidth: boolean` = false — Whether to take full width of parent
19
+ - `stickyHeader: boolean` = false — Whether the header sticks to the top while scrolling
20
+ - `scrollbar: "default" | "subtle" | "hidden"` = "default" — Scrollbar style of the container
21
+ - `mobileCard: boolean | "sm" | "md"` = false — Mobile view: switch to a card layout below a container width. `true` / `"sm"` switches under 576px, `"md"` under 768px (the old default).
22
+ - `height: string | number` — Height of the container (enables vertical scrolling)
23
+ - `maxHeight: string | number` — Maximum height of the container (enables vertical scrolling)
24
+ - `containerClassName: string` — Additional class name for the scroll container
25
+ - `card: boolean` = false — Add outer border and border-radius to the container (DataGrid look)
26
+
27
+ ## Table.Body
28
+
29
+ - `asChild: boolean` = false — Whether to render as a child element.
30
+
31
+ ## Table.Cell
32
+
33
+ - `asChild: boolean` = false — Whether to render as a child element.
34
+ - `selection: boolean` = false — Whether this is a selection (checkbox) cell
35
+ - `label: string` — Header label shown in the mobile card layout
36
+ - `stickyLeft: boolean` = false — Whether the cell sticks to the left edge while scrolling
37
+ - `stickyRight: boolean` = false — Whether the cell sticks to the right edge while scrolling
38
+ - `leftOffset: string | number` — Offset from the left edge when stickyLeft is set
39
+ - `rightOffset: string | number` — Offset from the right edge when stickyRight is set
40
+ - `stickyZIndex: number` — z-index applied to the sticky cell
41
+
42
+ ## Table.Footer
43
+
44
+ - `asChild: boolean` = false — Whether to render as a child element.
45
+
46
+ ## Table.Head
47
+
48
+ - `asChild: boolean` = false — Whether to render as a child element.
49
+ - `sortable: boolean` = false — Whether the column is sortable
50
+ - `sortDirection: "asc" | "desc" | "none"` = "none" — Current sort direction of the column
51
+ - `onSort: (e: React.SyntheticEvent) => void` — Callback when the sortable header is activated
52
+ - `selection: boolean` = false — Whether this is a selection (checkbox) column
53
+ - `stickyLeft: boolean` = false — Whether the cell sticks to the left edge while scrolling
54
+ - `stickyRight: boolean` = false — Whether the cell sticks to the right edge while scrolling
55
+ - `leftOffset: string | number` — Offset from the left edge when stickyLeft is set
56
+ - `rightOffset: string | number` — Offset from the right edge when stickyRight is set
57
+ - `stickyZIndex: number` — z-index applied to the sticky cell
58
+
59
+ ## Table.Header
60
+
61
+ - `asChild: boolean` = false — Whether to render as a child element.
62
+
63
+ ## Table.Row
64
+
65
+ - `asChild: boolean` = false — Whether to render as a child element.
66
+ - `selected: boolean` = false — Whether the row is in the selected state
67
+
68
+ ## Design tokens it reads
69
+
70
+ `--wim-border-width-thick`, `--wim-border-width-thin`, `--wim-color-border`, `--wim-color-border-secondary`, `--wim-color-primary`, `--wim-color-scrollbar-thumb`, `--wim-color-scrollbar-track`, `--wim-color-surface`, `--wim-color-surface-hover`, `--wim-color-surface-subtle`, `--wim-color-text-accent`, `--wim-color-text-primary`, `--wim-color-text-secondary`, `--wim-color-text-tertiary`, `--wim-duration-base`, `--wim-font-weight-medium`, `--wim-font-weight-semibold`, `--wim-height-md`, `--wim-radius-component`, `--wim-radius-full`, `--wim-spacing-2xl`, `--wim-spacing-lg`, `--wim-spacing-md`, `--wim-spacing-xs`, `--wim-table-cell-padding-x`, `--wim-table-cell-padding-y`, `--wim-table-row-bg`, `--wim-table-row-bg-hover`, `--wim-table-scrollbar-color`, `--wim-table-scrollbar-thumb-bg`, `--wim-table-scrollbar-track-bg`, `--wim-table-scrollbar-width`, `--wim-width-sm`, `--wim-z-overlay`, `--wim-z-sticky`
71
+
72
+ ---
73
+ Setup, composition rules and the full catalog: `llms.txt` / `llms-full.txt` in the same package.
@@ -0,0 +1,40 @@
1
+ # Tabs — wimui
2
+
3
+ > A container to organize related content into switchable view panels
4
+
5
+ ## Import
6
+
7
+ ```ts
8
+ import "wimui/styles.css"; // once per app — required
9
+ import { Tabs } from "wimui/navigation";
10
+ ```
11
+
12
+ ## Props
13
+
14
+ - `asChild: boolean` = false — If true, the tabs root will be rendered as its child, merging its props onto that child.
15
+ - `defaultValue: string` — Value of the tab selected initially, for uncontrolled usage.
16
+ - `value: string` — Controlled value of the selected tab. Use together with onChange.
17
+ - `onChange: (value: string) => void` — Called with the value of the newly selected tab.
18
+ - `orientation: "horizontal" | "vertical"` = "horizontal" — Orientation of the tab list, affecting layout and arrow-key navigation. @default "horizontal"
19
+
20
+ ## Tabs.Content
21
+
22
+ - `asChild: boolean` = false — If true, the panel will be rendered as its child, merging its props onto that child.
23
+ - `value: string` (required)
24
+
25
+ ## Tabs.List
26
+
27
+ - `asChild: boolean` = false — If true, the tab list will be rendered as its child, merging its props onto that child.
28
+
29
+ ## Tabs.Trigger
30
+
31
+ - `asChild: boolean` = false — If true, the trigger will be rendered as its child, merging its props onto that child.
32
+ - `value: string` (required)
33
+ - `disabled: unknown` = false
34
+
35
+ ## Design tokens it reads
36
+
37
+ `--wim-border-width-thick`, `--wim-border-width-thin`, `--wim-color-border-secondary`, `--wim-color-focus-outline`, `--wim-color-primary-subtle`, `--wim-color-surface-hover`, `--wim-color-text-accent`, `--wim-color-text-disabled`, `--wim-color-text-secondary`, `--wim-control-item-padding-x-lg`, `--wim-control-padding-y-sm`, `--wim-field-padding-y`, `--wim-font-weight-medium`, `--wim-menu-min-width`, `--wim-radius-component`, `--wim-radius-sm`, `--wim-spacing-2xl`, `--wim-spacing-2xs`, `--wim-spacing-md`, `--wim-spacing-xs`, `--wim-tabs-mask-size`, `--wim-tabs-vertical-width`, `--wim-transition-base`, `--wim-width-sm`
38
+
39
+ ---
40
+ Setup, composition rules and the full catalog: `llms.txt` / `llms-full.txt` in the same package.
@@ -0,0 +1,30 @@
1
+ # Tag — wimui
2
+
3
+ > Compact visual descriptors used for labeling or categorizing content
4
+
5
+ ## Import
6
+
7
+ ```ts
8
+ import "wimui/styles.css"; // once per app — required
9
+ import { Tag } from "wimui/data-display";
10
+ ```
11
+
12
+ ## Props
13
+
14
+ - `asChild: boolean` = false — If true, the tag will be rendered as its child, merging its props onto that child. Cannot be combined with `onDelete` — the delete control is a second element, and `asChild` requires a single React element child (T99).
15
+ - `children: React.ReactNode` — Content to display
16
+ - `content: React.ReactNode` — Content to display (alternative to children)
17
+ - `intent: IndicatorIntent` — Intent (semantic state)
18
+ - `variant: "solid" | "outline" | "subtle"` — Visual style variant
19
+ - `size: Extract<ComponentSize, "sm" | "md" | "lg">` — Size
20
+ - `icon: React.ReactNode` — Icon
21
+ - `onDelete: (e: React.MouseEvent<HTMLButtonElement>) => void` — Delete event. When provided, a × button is shown. Incompatible with `asChild`.
22
+ - `disabled: boolean` — Whether the tag is disabled
23
+ - `interactive: boolean` = false — Whether to enable the interactive state
24
+
25
+ ## Design tokens it reads
26
+
27
+ `--wim-border-width-thick`, `--wim-border-width-thin`, `--wim-color-disabled`, `--wim-color-surface-hover`, `--wim-color-text-on-disabled`, `--wim-font-size-2xs`, `--wim-font-size-sm`, `--wim-font-size-xs`, `--wim-font-weight-medium`, `--wim-opacity-secondary`, `--wim-radius-component`, `--wim-scale-active`, `--wim-spacing-2xs`, `--wim-spacing-3xs`, `--wim-spacing-md`, `--wim-spacing-sm`, `--wim-spacing-xs`, `--wim-tap-target-min`, `--wim-transition-fast`
28
+
29
+ ---
30
+ Setup, composition rules and the full catalog: `llms.txt` / `llms-full.txt` in the same package.
@@ -0,0 +1,37 @@
1
+ # TagInput — wimui
2
+
3
+ > Input field for creating free-form tags.
4
+
5
+ Also known as: Token Field, Chips Input
6
+
7
+ ## Import
8
+
9
+ ```ts
10
+ import "wimui/styles.css"; // once per app — required
11
+ import { TagInput } from "wimui/form";
12
+ ```
13
+
14
+ ## Props
15
+
16
+ - `value: string[]` — List of tags (controlled)
17
+ - `defaultValue: string[]` = [] — Initial list of tags (uncontrolled)
18
+ - `onChange: (tags: string[]) => void` — Callback when the tags change
19
+ - `placeholder: string` — Placeholder for the input
20
+ - `disabled: boolean` = false — Whether the input is disabled
21
+ - `intent: FieldIntent` = "default" — Semantic intent of the field (e.g. error state)
22
+ - `variant: "outline" | "ghost"` = "outline" — Visual style variant of the field
23
+ - `fullWidth: boolean` = false — Whether to take full width of parent
24
+ - `width: FieldWidth | string | number` — Fixed width of the field (width token, CSS value, or number in px)
25
+ - `label: React.ReactNode` — Field label
26
+ - `error: string` — Error message
27
+ - `required: boolean` — Whether to show the required indicator
28
+ - `layout: "vertical" | "horizontal"` — Layout direction of label and field
29
+ - `allowDelete: boolean` = true — Whether tags can be deleted
30
+ - `maxTags: number` — Maximum number of tags that can be entered
31
+
32
+ ## Design tokens it reads
33
+
34
+ `--wim-color-text-on-disabled`, `--wim-color-text-placeholder`, `--wim-color-text-primary`, `--wim-field-padding-x`, `--wim-field-padding-y`, `--wim-font-size-2xs`, `--wim-font-weight-medium`, `--wim-height-md`, `--wim-spacing-xs`
35
+
36
+ ---
37
+ Setup, composition rules and the full catalog: `llms.txt` / `llms-full.txt` in the same package.
@@ -0,0 +1,29 @@
1
+ # Terminal — wimui
2
+
3
+ > Renders terminal-style output with ANSI color support, prompt prefixes, and copy/clear controls.
4
+
5
+ ## Import
6
+
7
+ ```ts
8
+ import "wimui/styles.css"; // once per app — required
9
+ import { Terminal } from "wimui/ai";
10
+ ```
11
+
12
+ ## Props
13
+
14
+ - `lines: TerminalLine[]` = [] — Lines to display
15
+ - `title: string` — Window title shown in header bar
16
+ - `height: string | number` — Explicit height; omit to let the terminal grow with content
17
+ - `autoScroll: boolean` = true — Scroll to bottom when lines change
18
+ - `prompt: string` = "$" — Prompt prefix for input lines
19
+ - `showCopy: boolean` = true — Whether to show the copy button
20
+ - `showWindowControls: boolean` = false — Whether to show the three decorative window-control dots in the title bar (off by default: they do nothing and imitate one operating system)
21
+ - `onClear: () => void` — Whether to show the clear button; fires onClear when clicked
22
+ - `className: string` — Additional CSS class
23
+
24
+ ## Design tokens it reads
25
+
26
+ `--wim-border-width-thin`, `--wim-color-border`, `--wim-color-focus-outline`, `--wim-color-success`, `--wim-color-surface-app`, `--wim-color-surface-hover`, `--wim-color-surface-subtle`, `--wim-color-text-accent`, `--wim-color-text-danger`, `--wim-color-text-disabled`, `--wim-color-text-primary`, `--wim-color-text-tertiary`, `--wim-comp-terminal-traffic-green`, `--wim-comp-terminal-traffic-red`, `--wim-comp-terminal-traffic-yellow`, `--wim-duration-fast`, `--wim-easing-standard`, `--wim-focus-outline-offset`, `--wim-focus-outline-width`, `--wim-font-size-sm`, `--wim-font-size-xs`, `--wim-height-xs`, `--wim-line-height-loose`, `--wim-radius-component`, `--wim-radius-sm`, `--wim-spacing-2xs`, `--wim-spacing-3xs`, `--wim-spacing-md`, `--wim-spacing-sm`, `--wim-spacing-xs`, `--wim-tap-target-min`
27
+
28
+ ---
29
+ Setup, composition rules and the full catalog: `llms.txt` / `llms-full.txt` in the same package.
@@ -0,0 +1,31 @@
1
+ # Text — wimui
2
+
3
+ > Has appropriate line-height and spacing to ensure readability of long text.
4
+
5
+ ## Import
6
+
7
+ ```ts
8
+ import "wimui/styles.css"; // once per app — required
9
+ import { Text } from "wimui/typography";
10
+ ```
11
+
12
+ ## Props
13
+
14
+ - `asChild: boolean` = false — If true, the text will be rendered as its child, merging its props onto that child.
15
+ - `size: Extract<ComponentSize, "xs" | "sm" | "md" | "lg" | "xl">` = "md" — Font size of the text. @default "md"
16
+ - `color: T | (string & {})` — Text color. Accepts a design token color name or any CSS color value.
17
+ - `weight: WimFontWeightKey` = "normal" — Font weight. @default "normal"
18
+ - `lineHeight: T | (string & {})` — Line height. Accepts a design token name or any CSS line-height value.
19
+ - `fontStyle: "normal" | "italic"` = "normal" — Font style. @default "normal"
20
+ - `decoration: "line-through" | "underline" | "highlight" | "none"` = "none" — Visual decoration applied to the text. @default "none"
21
+ - `nowrap: boolean` = false — Keep the text on one line instead of wrapping. Overflow is left visible — use `truncate` to clip it with an ellipsis. @default false
22
+ - `truncate: boolean` = false — Keep the text on one line and clip the overflow with an ellipsis. Implies `nowrap`. @default false
23
+ - `lineClamp: number` — Clip the text after this many lines and end it with an ellipsis. `truncate` is the one-line case; this is the multi-line one. Use it when the text simply has to stop — a card blurb, a table cell, a list subtitle. If the reader needs a way to see the rest, use `Spoiler` instead: it always renders a toggle, which is the point of that component and the reason it cannot be used for "just stop at three lines". Ignored when `truncate` is set (one line wins; they cannot both apply).
24
+ - `content: React.ReactNode` — Content of the text. Alternative to children (children take precedence only with asChild).
25
+
26
+ ## Design tokens it reads
27
+
28
+ `--wim-color-text-accent`, `--wim-color-text-danger`, `--wim-color-text-info`, `--wim-color-text-secondary`, `--wim-color-text-success`, `--wim-color-text-warning`, `--wim-comp-decoration-highlight-color`, `--wim-decoration-line-through`, `--wim-decoration-underline`, `--wim-font-size-lg`, `--wim-font-size-md`, `--wim-font-size-sm`, `--wim-font-size-xl`, `--wim-font-size-xs`, `--wim-font-weight-bold`, `--wim-line-height-loose`, `--wim-line-height-loose-jp`, `--wim-line-height-normal`, `--wim-line-height-normal-jp`, `--wim-line-height-tight`, `--wim-line-height-tight-jp`, `--wim-text-line-clamp`, `--wim-text-underline-offset`
29
+
30
+ ---
31
+ Setup, composition rules and the full catalog: `llms.txt` / `llms-full.txt` in the same package.
@@ -0,0 +1,30 @@
1
+ # Textarea — wimui
2
+
3
+ > Multi-line input fields for longer text entries like descriptions or comments
4
+
5
+ ## Import
6
+
7
+ ```ts
8
+ import "wimui/styles.css"; // once per app — required
9
+ import { Textarea } from "wimui/form";
10
+ ```
11
+
12
+ ## Props
13
+
14
+ - `asChild: boolean` = false — If true, the textarea element will be rendered as its child, merging its props onto that child.
15
+ - `intent: FieldIntent` = "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
+ - `fieldSizing: "fixed" | "content"` = "fixed" — Sizing behavior: "fixed" keeps the height, "content" grows with the text
19
+ - `label: string` — Field label
20
+ - `error: string` — Error message
21
+ - `required: boolean` — Whether to show the required indicator
22
+ - `layout: "vertical" | "horizontal"` — Layout direction of label and field
23
+ - `width: FieldWidth | string | number` — Fixed width of the field (width token, CSS value, or number in px)
24
+
25
+ ## Design tokens it reads
26
+
27
+ `--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-padding-x`, `--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-height-md`, `--wim-input-width`, `--wim-line-height-normal`, `--wim-radius-component`, `--wim-shadow-error-ring`, `--wim-shadow-focus-ring`, `--wim-transition-base`, `--wim-width-lg`, `--wim-width-md`, `--wim-width-sm`, `--wim-width-xl`, `--wim-width-xs`
28
+
29
+ ---
30
+ Setup, composition rules and the full catalog: `llms.txt` / `llms-full.txt` in the same package.