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.
- package/dist/components/_internal/useAnnounce.cjs +1 -1
- package/dist/components/_internal/useAnnounce.d.ts +22 -0
- package/dist/components/_internal/useAnnounce.js +36 -19
- package/dist/components/ai/CodeDiffViewer/CodeDiffViewer.cjs +2 -2
- package/dist/components/ai/CodeDiffViewer/CodeDiffViewer.js +106 -105
- package/dist/components/ai/StreamingText/StreamingText.cjs +1 -1
- package/dist/components/ai/StreamingText/StreamingText.d.ts +1 -1
- package/dist/components/ai/StreamingText/StreamingText.js +37 -23
- package/dist/components/data-display/DataGrid/DataGrid.cjs +1 -1
- package/dist/components/data-display/DataGrid/DataGrid.js +41 -40
- package/dist/components/data-display/InfiniteScroll/InfiniteScroll.cjs +1 -1
- package/dist/components/data-display/InfiniteScroll/InfiniteScroll.d.ts +1 -1
- package/dist/components/data-display/InfiniteScroll/InfiniteScroll.js +37 -26
- package/dist/components/feedback/Spinner/Spinner.cjs +1 -1
- package/dist/components/feedback/Spinner/Spinner.js +53 -43
- package/dist/components/form/Combobox/Combobox.cjs +1 -1
- package/dist/components/form/Combobox/Combobox.js +48 -47
- package/dist/components/form/Transfer/Transfer.cjs +1 -1
- package/dist/components/form/Transfer/Transfer.js +0 -1
- package/dist/components/media/Gallery/Gallery.cjs +1 -1
- package/dist/components/media/Gallery/Gallery.js +111 -110
- package/dist/hooks/useBreakpoint.d.ts +1 -0
- package/dist/i18n/generated/data-display.cjs +1 -1
- package/dist/i18n/generated/data-display.d.ts +1 -1
- package/dist/i18n/generated/data-display.js +6 -3
- package/dist/index.cjs +1 -1
- package/dist/index.js +18 -18
- package/dist/llms/AIResponseFeedback.md +26 -0
- package/dist/llms/Accordion.md +47 -0
- package/dist/llms/Affix.md +25 -0
- package/dist/llms/AgentStatus.md +25 -0
- package/dist/llms/Alert.md +28 -0
- package/dist/llms/Anchor.md +30 -0
- package/dist/llms/AppShell.md +52 -0
- package/dist/llms/AreaChart.md +27 -0
- package/dist/llms/ArtifactsOverlay.md +27 -0
- package/dist/llms/AspectRatio.md +22 -0
- package/dist/llms/Audio.md +44 -0
- package/dist/llms/Autosave.md +23 -0
- package/dist/llms/Avatar.md +27 -0
- package/dist/llms/AvatarGroup.md +28 -0
- package/dist/llms/BackTop.md +32 -0
- package/dist/llms/Badge.md +28 -0
- package/dist/llms/Banner.md +28 -0
- package/dist/llms/BarChart.md +26 -0
- package/dist/llms/Barcode.md +26 -0
- package/dist/llms/BentoGrid.md +25 -0
- package/dist/llms/Blockquote.md +26 -0
- package/dist/llms/BottomSheet.md +26 -0
- package/dist/llms/Box.md +44 -0
- package/dist/llms/BoxPlot.md +25 -0
- package/dist/llms/Breadcrumb.md +31 -0
- package/dist/llms/Button.md +33 -0
- package/dist/llms/ButtonGroup.md +27 -0
- package/dist/llms/Calendar.md +34 -0
- package/dist/llms/CalendarHeatmap.md +33 -0
- package/dist/llms/CandlestickChart.md +25 -0
- package/dist/llms/Canvas.md +13 -0
- package/dist/llms/Card.md +41 -0
- package/dist/llms/Carousel.md +33 -0
- package/dist/llms/Cascader.md +40 -0
- package/dist/llms/Center.md +40 -0
- package/dist/llms/Charts.md +13 -0
- package/dist/llms/ChatUI.md +17 -0
- package/dist/llms/Checkbox.md +24 -0
- package/dist/llms/CheckboxGroup.md +32 -0
- package/dist/llms/Chip.md +36 -0
- package/dist/llms/Code.md +25 -0
- package/dist/llms/CodeBlock.md +27 -0
- package/dist/llms/CodeDiffViewer.md +30 -0
- package/dist/llms/ColorInput.md +48 -0
- package/dist/llms/ColorPicker.md +46 -0
- package/dist/llms/Combobox.md +37 -0
- package/dist/llms/CommandPalette.md +25 -0
- package/dist/llms/Comment.md +35 -0
- package/dist/llms/Container.md +45 -0
- package/dist/llms/ContextMenu.md +25 -0
- package/dist/llms/ContrastChecker.md +13 -0
- package/dist/llms/Controls.md +13 -0
- package/dist/llms/CopyButton.md +26 -0
- package/dist/llms/Countdown.md +31 -0
- package/dist/llms/CounterTextarea.md +32 -0
- package/dist/llms/CreditCardInput.md +42 -0
- package/dist/llms/Dashboard.md +31 -0
- package/dist/llms/DataGrid.md +43 -0
- package/dist/llms/DatePicker.md +39 -0
- package/dist/llms/DateRangePicker.md +30 -0
- package/dist/llms/DescriptionList.md +26 -0
- package/dist/llms/Dialog.md +57 -0
- package/dist/llms/Divider.md +24 -0
- package/dist/llms/Drawer.md +29 -0
- package/dist/llms/Dropdown.md +50 -0
- package/dist/llms/Dropzone.md +36 -0
- package/dist/llms/EmptyState.md +23 -0
- package/dist/llms/ErrorBoundary.md +25 -0
- package/dist/llms/FAQSection.md +24 -0
- package/dist/llms/FieldError.md +19 -0
- package/dist/llms/FieldTemplate.md +30 -0
- package/dist/llms/Fieldset.md +24 -0
- package/dist/llms/FileUpload.md +40 -0
- package/dist/llms/Flex.md +23 -0
- package/dist/llms/FloatButton.md +36 -0
- package/dist/llms/FocusTrap.md +20 -0
- package/dist/llms/Footer.md +32 -0
- package/dist/llms/FunnelChart.md +24 -0
- package/dist/llms/Gallery.md +30 -0
- package/dist/llms/GanttChart.md +29 -0
- package/dist/llms/GaugeChart.md +30 -0
- package/dist/llms/Grid.md +30 -0
- package/dist/llms/Group.md +22 -0
- package/dist/llms/HamburgerMenu.md +30 -0
- package/dist/llms/Header.md +30 -0
- package/dist/llms/Heatmap.md +25 -0
- package/dist/llms/Highlight.md +26 -0
- package/dist/llms/HoverCard.md +26 -0
- package/dist/llms/Icon.md +25 -0
- package/dist/llms/IconButton.md +30 -0
- package/dist/llms/Image.md +46 -0
- package/dist/llms/ImageCompare.md +35 -0
- package/dist/llms/ImageCropper.md +34 -0
- package/dist/llms/Indicator.md +28 -0
- package/dist/llms/InfiniteScroll.md +28 -0
- package/dist/llms/InlineEdit.md +32 -0
- package/dist/llms/Input.md +46 -0
- package/dist/llms/InputBase.md +39 -0
- package/dist/llms/InputGroup.md +23 -0
- package/dist/llms/InputMask.md +44 -0
- package/dist/llms/InteractiveArea.md +32 -0
- package/dist/llms/InteractiveGraph.md +28 -0
- package/dist/llms/JsonDiffViewer.md +24 -0
- package/dist/llms/JsonViewer.md +26 -0
- package/dist/llms/Kanban.md +25 -0
- package/dist/llms/Kbd.md +23 -0
- package/dist/llms/KeyboardShortcuts.md +25 -0
- package/dist/llms/Label.md +27 -0
- package/dist/llms/Leaderboard.md +24 -0
- package/dist/llms/Legend.md +27 -0
- package/dist/llms/Lightbox.md +47 -0
- package/dist/llms/LineChart.md +26 -0
- package/dist/llms/Link.md +28 -0
- package/dist/llms/LinkButton.md +23 -0
- package/dist/llms/List.md +35 -0
- package/dist/llms/Loader.md +23 -0
- package/dist/llms/LoadingOverlay.md +30 -0
- package/dist/llms/Markdown.md +24 -0
- package/dist/llms/MarkdownRenderer.md +24 -0
- package/dist/llms/Marquee.md +27 -0
- package/dist/llms/Masonry.md +18 -0
- package/dist/llms/Mentions.md +24 -0
- package/dist/llms/Menu.md +30 -0
- package/dist/llms/Menubar.md +50 -0
- package/dist/llms/Meta.md +13 -0
- package/dist/llms/ModelSelector.md +31 -0
- package/dist/llms/MultiSelect.md +38 -0
- package/dist/llms/Navbar.md +58 -0
- package/dist/llms/NodeGraph.md +38 -0
- package/dist/llms/Notification.md +30 -0
- package/dist/llms/NumberInput.md +23 -0
- package/dist/llms/OtpInput.md +33 -0
- package/dist/llms/OverflowList.md +31 -0
- package/dist/llms/Pagination.md +39 -0
- package/dist/llms/PasswordInput.md +39 -0
- package/dist/llms/PasswordStrength.md +34 -0
- package/dist/llms/PhoneInput.md +35 -0
- package/dist/llms/PieChart.md +23 -0
- package/dist/llms/PivotTable.md +41 -0
- package/dist/llms/PlatformIcons.md +13 -0
- package/dist/llms/Popconfirm.md +30 -0
- package/dist/llms/Popover.md +27 -0
- package/dist/llms/Portal.md +18 -0
- package/dist/llms/Presence.md +26 -0
- package/dist/llms/Progress.md +29 -0
- package/dist/llms/ProgressRing.md +27 -0
- package/dist/llms/PromptInput.md +37 -0
- package/dist/llms/PullToRefresh.md +26 -0
- package/dist/llms/QRCode.md +30 -0
- package/dist/llms/QueryBuilder.md +31 -0
- package/dist/llms/RadarChart.md +24 -0
- package/dist/llms/Radio.md +23 -0
- package/dist/llms/RadioGroup.md +32 -0
- package/dist/llms/RangeCalendar.md +26 -0
- package/dist/llms/RangeSlider.md +39 -0
- package/dist/llms/Rating.md +37 -0
- package/dist/llms/Reaction.md +26 -0
- package/dist/llms/RefTable.md +13 -0
- package/dist/llms/RelativeTime.md +24 -0
- package/dist/llms/Result.md +29 -0
- package/dist/llms/RichTextEditor.md +59 -0
- package/dist/llms/SankeyChart.md +26 -0
- package/dist/llms/ScatterChart.md +26 -0
- package/dist/llms/ScheduleView.md +35 -0
- package/dist/llms/ScrollArea.md +24 -0
- package/dist/llms/ScrollProgress.md +22 -0
- package/dist/llms/SearchInput.md +44 -0
- package/dist/llms/SegmentedControl.md +40 -0
- package/dist/llms/Select.md +44 -0
- package/dist/llms/SelectionBar.md +28 -0
- package/dist/llms/Sidebar.md +47 -0
- package/dist/llms/SignaturePad.md +36 -0
- package/dist/llms/SimpleGrid.md +24 -0
- package/dist/llms/Skeleton.md +26 -0
- package/dist/llms/Slider.md +36 -0
- package/dist/llms/SmartSearchInput.md +35 -0
- package/dist/llms/Snackbar.md +30 -0
- package/dist/llms/SortableList.md +33 -0
- package/dist/llms/SourceCitation.md +28 -0
- package/dist/llms/SourceCode.md +13 -0
- package/dist/llms/Span.md +29 -0
- package/dist/llms/Sparkline.md +27 -0
- package/dist/llms/SpeedDial.md +28 -0
- package/dist/llms/Spinner.md +26 -0
- package/dist/llms/SplitButton.md +29 -0
- package/dist/llms/Splitter.md +37 -0
- package/dist/llms/Spoiler.md +26 -0
- package/dist/llms/Stack.md +48 -0
- package/dist/llms/Stats.md +44 -0
- package/dist/llms/Stepper.md +32 -0
- package/dist/llms/StreamingText.md +24 -0
- package/dist/llms/SwipeAction.md +28 -0
- package/dist/llms/SwipeableList.md +21 -0
- package/dist/llms/Switch.md +27 -0
- package/dist/llms/SwitchGroup.md +31 -0
- package/dist/llms/T.md +13 -0
- package/dist/llms/TabBar.md +33 -0
- package/dist/llms/TabNavigation.md +30 -0
- package/dist/llms/Table.md +73 -0
- package/dist/llms/Tabs.md +40 -0
- package/dist/llms/Tag.md +30 -0
- package/dist/llms/TagInput.md +37 -0
- package/dist/llms/Terminal.md +29 -0
- package/dist/llms/Text.md +31 -0
- package/dist/llms/Textarea.md +30 -0
- package/dist/llms/ThemeToggle.md +31 -0
- package/dist/llms/ThoughtProcess.md +27 -0
- package/dist/llms/ThreadList.md +27 -0
- package/dist/llms/TimePicker.md +41 -0
- package/dist/llms/Timeline.md +24 -0
- package/dist/llms/Title.md +27 -0
- package/dist/llms/Toast.md +32 -0
- package/dist/llms/ToggleGroup.md +39 -0
- package/dist/llms/Toolbar.md +35 -0
- package/dist/llms/Tooltip.md +29 -0
- package/dist/llms/Tour.md +24 -0
- package/dist/llms/Transfer.md +35 -0
- package/dist/llms/Transition.md +34 -0
- package/dist/llms/TreeDiagram.md +33 -0
- package/dist/llms/TreeSelect.md +43 -0
- package/dist/llms/TreeView.md +50 -0
- package/dist/llms/Treemap.md +27 -0
- package/dist/llms/UsageMeter.md +31 -0
- package/dist/llms/Video.md +46 -0
- package/dist/llms/VirtualList.md +31 -0
- package/dist/llms/VisuallyHidden.md +19 -0
- package/dist/llms/VoiceVisualizer.md +30 -0
- package/dist/llms/WaterfallChart.md +25 -0
- package/dist/llms/Watermark.md +27 -0
- package/dist/llms/colorSwatch.md +13 -0
- package/dist/llms-full.txt +6 -3
- package/dist/llms.txt +4 -2
- package/dist/locales/en/data-display.json +3 -0
- package/dist/locales/ja/data-display.json +3 -0
- package/dist/locales/pt/data-display.json +3 -0
- package/dist/styles.css +1 -1
- package/dist/wimui.umd.js +5 -5
- package/package.json +10 -3
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
# SelectionBar — wimui
|
|
2
|
+
|
|
3
|
+
> Bar above a table that shows the number of selected rows, the actions for them and a way to clear the selection. Announces the count to screen readers.
|
|
4
|
+
|
|
5
|
+
Also known as: Bulk Actions, Batch Actions, Table Selection Toolbar
|
|
6
|
+
|
|
7
|
+
## Import
|
|
8
|
+
|
|
9
|
+
```ts
|
|
10
|
+
import "wimui/styles.css"; // once per app — required
|
|
11
|
+
import { SelectionBar } from "wimui/data-display";
|
|
12
|
+
```
|
|
13
|
+
|
|
14
|
+
## Props
|
|
15
|
+
|
|
16
|
+
- `count: number` (required) — Number of selected items. The bar shows while it is above 0. Keep the component mounted while the count is 0 as well: it holds the status region that announces the count, and a region that appears together with its text is not read by screen readers.
|
|
17
|
+
- `onClear: () => void` — Called by the built-in "Clear selection" button. Leave it out to render no clear button.
|
|
18
|
+
- `children: React.ReactNode` — Actions for the selected items (`Button size="sm"`, `IconButton`, `Popconfirm` ...). They are placed in a `Toolbar`, so the arrow keys move between them.
|
|
19
|
+
- `countLabel: (count: number) => React.ReactNode` — Text that states the count. Defaults to the built-in "{count} selected" (en / ja / pt).
|
|
20
|
+
- `clearLabel: string` — Label of the clear button. Defaults to the built-in "Clear selection".
|
|
21
|
+
- `returnFocusRef: React.RefObject<HTMLElement | null>` — Where focus goes when the bar closes after focus was in it — after the clear button, or after a confirmation opened from the bar (`Popconfirm`) whose trigger is gone. Without it, focus moves to the first focusable element after the bar (with `DataGrid`, the grid).
|
|
22
|
+
|
|
23
|
+
## Design tokens it reads
|
|
24
|
+
|
|
25
|
+
`--wim-color-text-primary`, `--wim-font-size-sm`, `--wim-font-weight-medium`, `--wim-spacing-sm`, `--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,47 @@
|
|
|
1
|
+
# Sidebar — wimui
|
|
2
|
+
|
|
3
|
+
> A collapsible navigation or informational panel on the side of the screen
|
|
4
|
+
|
|
5
|
+
Also known as: Source List, Inspector
|
|
6
|
+
|
|
7
|
+
## Import
|
|
8
|
+
|
|
9
|
+
```ts
|
|
10
|
+
import "wimui/styles.css"; // once per app — required
|
|
11
|
+
import { Sidebar } from "wimui/layout";
|
|
12
|
+
```
|
|
13
|
+
|
|
14
|
+
## Props
|
|
15
|
+
|
|
16
|
+
- `fixed: boolean` — Fixed position
|
|
17
|
+
- `collapsed: boolean` — Collapsed state
|
|
18
|
+
- `width: number | string` = 260 — Width when expanded
|
|
19
|
+
- `bordered: boolean` = true — Border at the right
|
|
20
|
+
- `responsive: boolean` = true — Below the `md` breakpoint, move the sidebar off-canvas so it stops taking width from the content. Defaults to `true`. **It does not bring a way back on screen.** Off-canvas means `left: -{width}` until `mobileOpen` is true, and nothing in this component flips that — so on a phone the sidebar and everything in it become unreachable unless you wire a trigger yourself. Measured at 390px: the rail sits at `x = -260` with no control anywhere on the page (T60). Pair it with `mobileOpen` and a `HamburgerMenu`, the way the AppShell story does: ```tsx const [open, setOpen] = useState(false); <HamburgerMenu visibleBelow="md" open={open} onOpenChange={setOpen} /> <Sidebar mobileOpen={open} onOverlayClick={() => setOpen(false)}>…</Sidebar> ``` `visibleBelow="md"` keeps the control out of the way at widths where the rail is already on screen. The trigger lives outside this component on purpose: it usually belongs in the header, and a built-in one would sit in the wrong place or duplicate the one you already have. Set `responsive={false}` to keep the sidebar in flow at every width.
|
|
21
|
+
- `mobileOpen: boolean` — Mobile drawer open state. Required for the rail to be reachable below `md` — see `responsive`.
|
|
22
|
+
- `onOverlayClick: () => void` — Callback when overlay is clicked
|
|
23
|
+
|
|
24
|
+
## Sidebar.Content
|
|
25
|
+
|
|
26
|
+
(no props of its own)
|
|
27
|
+
|
|
28
|
+
## Sidebar.Footer
|
|
29
|
+
|
|
30
|
+
(no props of its own)
|
|
31
|
+
|
|
32
|
+
## Sidebar.Header
|
|
33
|
+
|
|
34
|
+
(no props of its own)
|
|
35
|
+
|
|
36
|
+
## Sidebar.Item
|
|
37
|
+
|
|
38
|
+
- `active: boolean`
|
|
39
|
+
- `disabled: boolean`
|
|
40
|
+
- `icon: React.ReactNode`
|
|
41
|
+
|
|
42
|
+
## Design tokens it reads
|
|
43
|
+
|
|
44
|
+
`--wim-blur-2xs`, `--wim-border-width-thin`, `--wim-color-border-secondary`, `--wim-color-overlay-sidebar`, `--wim-color-primary-muted`, `--wim-color-surface`, `--wim-color-surface-hover`, `--wim-color-text-accent`, `--wim-color-text-primary`, `--wim-font-size-xl`, `--wim-font-weight-bold`, `--wim-height-sm`, `--wim-height-xl`, `--wim-opacity-disabled`, `--wim-sidebar-width`, `--wim-spacing-md`, `--wim-spacing-sm`, `--wim-transition-base`, `--wim-transition-fast`, `--wim-z-drawer`, `--wim-z-mask`, `--wim-z-sidebar`
|
|
45
|
+
|
|
46
|
+
---
|
|
47
|
+
Setup, composition rules and the full catalog: `llms.txt` / `llms-full.txt` in the same package.
|
|
@@ -0,0 +1,36 @@
|
|
|
1
|
+
# SignaturePad — wimui
|
|
2
|
+
|
|
3
|
+
> Handwritten signature input
|
|
4
|
+
|
|
5
|
+
## Import
|
|
6
|
+
|
|
7
|
+
```ts
|
|
8
|
+
import "wimui/styles.css"; // once per app — required
|
|
9
|
+
import { SignaturePad } from "wimui/form";
|
|
10
|
+
```
|
|
11
|
+
|
|
12
|
+
## Props
|
|
13
|
+
|
|
14
|
+
- `width: number` = 400 — Width of the canvas
|
|
15
|
+
- `height: number` = 200 — Height of the canvas
|
|
16
|
+
- `penColor: string` = "var(--wim-color-text-primary)" — Color of the pen
|
|
17
|
+
- `penWidth: number` = 2 — Width of the pen stroke
|
|
18
|
+
- `onChange: (dataUrl: string | null) => void` — Callback when signature changes or is cleared
|
|
19
|
+
- `clearLabel: React.ReactNode` — Custom label for the clear button
|
|
20
|
+
- `disabled: boolean` = false — Whether the component is disabled
|
|
21
|
+
- `className: string` — CSS class name
|
|
22
|
+
- `style: React.CSSProperties` — Inline styles
|
|
23
|
+
- `label: React.ReactNode` — Field label
|
|
24
|
+
- `error: string` — Error message
|
|
25
|
+
- `required: boolean` — Whether to show the required indicator
|
|
26
|
+
- `layout: "vertical" | "horizontal"` = "vertical" — Layout direction of label and field
|
|
27
|
+
- `canvasAriaLabel: string` — Aria label for the canvas
|
|
28
|
+
- `aria-label: string` — Accessible name for the canvas when no visible `label` is provided. Takes precedence over `canvasAriaLabel`.
|
|
29
|
+
- `aria-labelledby: string` — ID of the element that labels the canvas when no visible `label` is provided.
|
|
30
|
+
|
|
31
|
+
## Design tokens it reads
|
|
32
|
+
|
|
33
|
+
`--wim-border-width-thin`, `--wim-color-border`, `--wim-color-disabled`, `--wim-color-surface`, `--wim-font-family-default`, `--wim-opacity-disabled`, `--wim-radius-component`, `--wim-spacing-md`
|
|
34
|
+
|
|
35
|
+
---
|
|
36
|
+
Setup, composition rules and the full catalog: `llms.txt` / `llms-full.txt` in the same package.
|
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
# SimpleGrid — wimui
|
|
2
|
+
|
|
3
|
+
> Responsive fixed grid
|
|
4
|
+
|
|
5
|
+
## Import
|
|
6
|
+
|
|
7
|
+
```ts
|
|
8
|
+
import "wimui/styles.css"; // once per app — required
|
|
9
|
+
import { SimpleGrid } from "wimui/layout";
|
|
10
|
+
```
|
|
11
|
+
|
|
12
|
+
## Props
|
|
13
|
+
|
|
14
|
+
- `cols: T | { base?: T; sm?: T; md?: T; lg?: T; xl?: T; }` = 1 — Number of columns (or a responsive object per breakpoint)
|
|
15
|
+
- `spacing: number | string` = "2xl" — Spacing between cells: a spacing token name (`"md"`, `"2xl"`, …) or a raw number of pixels. Prefer the token so the gap follows the theme. @default "2xl"
|
|
16
|
+
- `verticalSpacing: number | string` — Vertical spacing between rows (defaults to `spacing`)
|
|
17
|
+
- `minChildWidth: number | string` — Minimum width of each child; columns wrap automatically to fit
|
|
18
|
+
|
|
19
|
+
## Design tokens it reads
|
|
20
|
+
|
|
21
|
+
`--wim-simple-grid-cols`, `--wim-simple-grid-cols-lg`, `--wim-simple-grid-cols-md`, `--wim-simple-grid-cols-sm`, `--wim-simple-grid-cols-xl`, `--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,26 @@
|
|
|
1
|
+
# Skeleton — wimui
|
|
2
|
+
|
|
3
|
+
> Placeholder for content loading states.
|
|
4
|
+
|
|
5
|
+
Also known as: Shimmer
|
|
6
|
+
|
|
7
|
+
## Import
|
|
8
|
+
|
|
9
|
+
```ts
|
|
10
|
+
import "wimui/styles.css"; // once per app — required
|
|
11
|
+
import { Skeleton } from "wimui/feedback";
|
|
12
|
+
```
|
|
13
|
+
|
|
14
|
+
## Props
|
|
15
|
+
|
|
16
|
+
- `variant: "text" | "rect" | "circle"` = "text" — Shape of the skeleton. - `text`: shaped like a line of text. - `rect`: rectangle. - `circle`: circle. @default "text"
|
|
17
|
+
- `animation: "pulse" | "wave" | "none"` = "pulse" — Type of animation. - `pulse`: slow fade in and out. - `wave`: wave moving from left to right. - `none`: no animation. @default "pulse"
|
|
18
|
+
- `width: string | number` — Width, including a CSS unit (px, %, rem, etc.).
|
|
19
|
+
- `height: string | number` — Height, including a CSS unit (px, %, rem, etc.).
|
|
20
|
+
|
|
21
|
+
## Design tokens it reads
|
|
22
|
+
|
|
23
|
+
`--wim-color-skeleton-bg`, `--wim-color-skeleton-shine`, `--wim-easing-emphasized`, `--wim-opacity-dim`, `--wim-radius-full`, `--wim-radius-sm`
|
|
24
|
+
|
|
25
|
+
---
|
|
26
|
+
Setup, composition rules and the full catalog: `llms.txt` / `llms-full.txt` in the same package.
|
|
@@ -0,0 +1,36 @@
|
|
|
1
|
+
# Slider — wimui
|
|
2
|
+
|
|
3
|
+
> An input to capture a numeric value from a specified range by dragging a knob
|
|
4
|
+
|
|
5
|
+
## Import
|
|
6
|
+
|
|
7
|
+
```ts
|
|
8
|
+
import "wimui/styles.css"; // once per app — required
|
|
9
|
+
import { Slider } from "wimui/form";
|
|
10
|
+
```
|
|
11
|
+
|
|
12
|
+
## Props
|
|
13
|
+
|
|
14
|
+
- `value: number` — Current value (controlled)
|
|
15
|
+
- `defaultValue: number` = 0 — Default value (uncontrolled)
|
|
16
|
+
- `min: number` = 0 — Minimum value
|
|
17
|
+
- `max: number` = 100 — Maximum value
|
|
18
|
+
- `step: number` = 1 — Step value
|
|
19
|
+
- `disabled: boolean` = false — Whether the slider is disabled
|
|
20
|
+
- `onChange: (value: number) => void` — Callback when the value changes
|
|
21
|
+
- `onAfterChange: (value: number) => void` — Callback when dragging ends
|
|
22
|
+
- `name: string` — Name attribute
|
|
23
|
+
- `label: React.ReactNode` — Accessible label
|
|
24
|
+
- `error: string` — Error message
|
|
25
|
+
- `required: boolean` — Whether to show the required indicator
|
|
26
|
+
- `layout: "vertical" | "horizontal"` = "vertical" — Layout direction of label and field
|
|
27
|
+
- `id: string` — Custom ID
|
|
28
|
+
- `asChild: boolean` = false — Whether to render as a child element.
|
|
29
|
+
- `styles: { root?: string; labelWrapper?: string; label?: string; content?: string; error?: string; }` — Custom styles for internal parts
|
|
30
|
+
|
|
31
|
+
## Design tokens it reads
|
|
32
|
+
|
|
33
|
+
`--wim-border-width-thick`, `--wim-color-border-secondary`, `--wim-color-danger`, `--wim-color-focus-outline`, `--wim-color-ghost-border-hover`, `--wim-color-primary`, `--wim-color-white`, `--wim-focus-outline-width`, `--wim-height-xs`, `--wim-opacity-ghost`, `--wim-radius-full`, `--wim-shadow-sm`, `--wim-spacing-sm`, `--wim-tap-target-min`, `--wim-transition-fast`
|
|
34
|
+
|
|
35
|
+
---
|
|
36
|
+
Setup, composition rules and the full catalog: `llms.txt` / `llms-full.txt` in the same package.
|
|
@@ -0,0 +1,35 @@
|
|
|
1
|
+
# SmartSearchInput — wimui
|
|
2
|
+
|
|
3
|
+
> Smart search input enabling both traditional search and AI prompting.
|
|
4
|
+
|
|
5
|
+
## Import
|
|
6
|
+
|
|
7
|
+
```ts
|
|
8
|
+
import "wimui/styles.css"; // once per app — required
|
|
9
|
+
import { SmartSearchInput } from "wimui/form";
|
|
10
|
+
```
|
|
11
|
+
|
|
12
|
+
## Props
|
|
13
|
+
|
|
14
|
+
- `intent: FieldIntent` = "default" — Semantic intent of the field (e.g. error state)
|
|
15
|
+
- `variant: "outline" | "ghost"` = "outline" — Visual style variant of the field
|
|
16
|
+
- `fullWidth: boolean` = false — Whether to take full width of parent
|
|
17
|
+
- `width: FieldWidth | string | number` — Fixed width of the field (width token, CSS value, or number in px)
|
|
18
|
+
- `label: React.ReactNode` — 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
|
+
- `maxRows: number` = 8 — Maximum number of rows the input grows to before scrolling
|
|
23
|
+
- `allowClear: boolean` = true — Whether to show a clear button when value is present
|
|
24
|
+
- `onClear: () => void` — Callback when the clear button is clicked
|
|
25
|
+
- `onSubmit: (value: string) => void` — Callback when the value is submitted with the Enter key
|
|
26
|
+
- `onChange: (value: string) => void` — Callback when the value changes
|
|
27
|
+
- `defaultValue: string` = "" — Initial value (uncontrolled)
|
|
28
|
+
- `maxLength: number` — Maximum number of characters
|
|
29
|
+
|
|
30
|
+
## Design tokens it reads
|
|
31
|
+
|
|
32
|
+
`--wim-border-width-thin`, `--wim-color-text-on-disabled`, `--wim-color-text-primary`, `--wim-color-text-tertiary`, `--wim-font-size-md`, `--wim-height-md`, `--wim-line-height-normal`, `--wim-spacing-xs`
|
|
33
|
+
|
|
34
|
+
---
|
|
35
|
+
Setup, composition rules and the full catalog: `llms.txt` / `llms-full.txt` in the same package.
|
|
@@ -0,0 +1,30 @@
|
|
|
1
|
+
# Snackbar — wimui
|
|
2
|
+
|
|
3
|
+
> Bottom notifications
|
|
4
|
+
|
|
5
|
+
## Import
|
|
6
|
+
|
|
7
|
+
```ts
|
|
8
|
+
import "wimui/styles.css"; // once per app — required
|
|
9
|
+
import { Snackbar } from "wimui/feedback";
|
|
10
|
+
```
|
|
11
|
+
|
|
12
|
+
## Props
|
|
13
|
+
|
|
14
|
+
- `message: string` (required) — Message displayed in the snackbar
|
|
15
|
+
- `open: boolean` = false — Whether the snackbar is shown @default false
|
|
16
|
+
- `intent: FeedbackIntent` = "default" — Intent (semantic state) @default "default"
|
|
17
|
+
- `position: "top-left" | "top-center" | "top-right" | "bottom-left" | "bottom-center" | "bottom-right"` = "bottom-center" — Position on the screen @default "bottom-center"
|
|
18
|
+
- `autoHideDuration: number` = 5000 — Time in milliseconds before the snackbar closes automatically. Set 0 to disable auto-close. @default 5000
|
|
19
|
+
- `showCloseButton: boolean` = false — Whether to show a close button @default false
|
|
20
|
+
- `actionLabel: string` — Label of the action button
|
|
21
|
+
- `onAction: () => void` — Called when the action button is clicked
|
|
22
|
+
- `onClose: () => void` — Called when the snackbar is closed
|
|
23
|
+
- `className: string` — Additional CSS class name
|
|
24
|
+
|
|
25
|
+
## Design tokens it reads
|
|
26
|
+
|
|
27
|
+
`--wim-border-width-thin`, `--wim-color-danger`, `--wim-color-info`, `--wim-color-success`, `--wim-color-warning`, `--wim-color-white`, `--wim-comp-snackbar-bg`, `--wim-comp-snackbar-fg`, `--wim-duration-slow`, `--wim-easing-standard`, `--wim-font-size-sm`, `--wim-font-weight-medium`, `--wim-line-height-normal`, `--wim-radius-full`, `--wim-radius-overlay`, `--wim-scale-active-sm`, `--wim-shadow-overlay`, `--wim-snackbar-action`, `--wim-snackbar-action-active`, `--wim-snackbar-action-bg`, `--wim-snackbar-action-hover`, `--wim-snackbar-bg`, `--wim-snackbar-border`, `--wim-snackbar-close-hover`, `--wim-snackbar-close-idle`, `--wim-snackbar-close-size`, `--wim-snackbar-fg`, `--wim-snackbar-lift`, `--wim-snackbar-max-width`, `--wim-snackbar-min-width`, `--wim-spacing-3xl`, `--wim-spacing-4xl`, `--wim-spacing-lg`, `--wim-spacing-md`, `--wim-spacing-sm`, `--wim-spacing-xs`, `--wim-tap-target-min`, `--wim-transition-fast`, `--wim-z-toast`
|
|
28
|
+
|
|
29
|
+
---
|
|
30
|
+
Setup, composition rules and the full catalog: `llms.txt` / `llms-full.txt` in the same package.
|
|
@@ -0,0 +1,33 @@
|
|
|
1
|
+
# SortableList — wimui
|
|
2
|
+
|
|
3
|
+
> Item rearrangement and reordering
|
|
4
|
+
|
|
5
|
+
## Import
|
|
6
|
+
|
|
7
|
+
```ts
|
|
8
|
+
import "wimui/styles.css"; // once per app — required
|
|
9
|
+
import { SortableList } from "wimui/data-display";
|
|
10
|
+
```
|
|
11
|
+
|
|
12
|
+
## Props
|
|
13
|
+
|
|
14
|
+
- `asChild: boolean` = false — If true, the component will be rendered as its child.
|
|
15
|
+
- `onSortEnd: (oldIndex: number, newIndex: number) => void` — Callback called when reordering is completed.
|
|
16
|
+
- `disabled: boolean` = false — Whether the entire list is disabled.
|
|
17
|
+
|
|
18
|
+
## SortableList.DragHandle
|
|
19
|
+
|
|
20
|
+
- `asChild: boolean` = false
|
|
21
|
+
|
|
22
|
+
## SortableList.Item
|
|
23
|
+
|
|
24
|
+
- `asChild: boolean` = false
|
|
25
|
+
- `index: number` (required) — The index of the item in the list.
|
|
26
|
+
- `disabled: boolean` = false — Whether this specific item is disabled for dragging.
|
|
27
|
+
|
|
28
|
+
## Design tokens it reads
|
|
29
|
+
|
|
30
|
+
`--wim-blur-glass`, `--wim-border-width-thick`, `--wim-border-width-thin`, `--wim-color-border`, `--wim-color-ghost-bg`, `--wim-color-ghost-bg-hover`, `--wim-color-ghost-border-hover`, `--wim-color-glass-bg`, `--wim-color-primary`, `--wim-color-surface`, `--wim-color-text-secondary`, `--wim-color-text-tertiary`, `--wim-duration-fast`, `--wim-easing-standard`, `--wim-opacity-disabled`, `--wim-opacity-ghost`, `--wim-radius-component`, `--wim-radius-full`, `--wim-shadow-focus-ring`, `--wim-shadow-sm`, `--wim-spacing-2xs`, `--wim-spacing-md`, `--wim-spacing-sm`, `--wim-spacing-xs`
|
|
31
|
+
|
|
32
|
+
---
|
|
33
|
+
Setup, composition rules and the full catalog: `llms.txt` / `llms-full.txt` in the same package.
|
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
# SourceCitation — wimui
|
|
2
|
+
|
|
3
|
+
> Displays cited sources with title, domain, and external link for AI-generated content.
|
|
4
|
+
|
|
5
|
+
## Import
|
|
6
|
+
|
|
7
|
+
```ts
|
|
8
|
+
import "wimui/styles.css"; // once per app — required
|
|
9
|
+
import { SourceCitation } from "wimui/ai";
|
|
10
|
+
```
|
|
11
|
+
|
|
12
|
+
## Props
|
|
13
|
+
|
|
14
|
+
- `title: string` (required) — Title of the source
|
|
15
|
+
- `url: string` — Source URL. When provided, renders as a clickable link.
|
|
16
|
+
- `description: string` — Brief excerpt or description of the source
|
|
17
|
+
- `index: number` — Numeric citation index shown as a badge (e.g. 1, 2, 3)
|
|
18
|
+
- `domain: string` — Domain label shown below the title (auto-derived from url when omitted)
|
|
19
|
+
- `className: string` — Additional CSS class
|
|
20
|
+
- `aria-label: string` — Accessible name for the citation.
|
|
21
|
+
- `aria-labelledby: string` — ID of the element that labels the citation. Takes precedence over `aria-label`.
|
|
22
|
+
|
|
23
|
+
## Design tokens it reads
|
|
24
|
+
|
|
25
|
+
`--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-primary`, `--wim-color-text-primary`, `--wim-color-text-secondary`, `--wim-color-text-tertiary`, `--wim-duration-fast`, `--wim-easing-standard`, `--wim-focus-outline-offset`, `--wim-focus-outline-width`, `--wim-font-size-sm`, `--wim-font-size-xs`, `--wim-font-weight-bold`, `--wim-font-weight-medium`, `--wim-line-height-normal`, `--wim-radius-component`, `--wim-radius-full`, `--wim-spacing-2xs`, `--wim-spacing-3xs`, `--wim-spacing-md`, `--wim-spacing-sm`
|
|
26
|
+
|
|
27
|
+
---
|
|
28
|
+
Setup, composition rules and the full catalog: `llms.txt` / `llms-full.txt` in the same package.
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
# SourceCode — wimui
|
|
2
|
+
|
|
3
|
+
> Highlighted source code display
|
|
4
|
+
|
|
5
|
+
## Import
|
|
6
|
+
|
|
7
|
+
```ts
|
|
8
|
+
import "wimui/styles.css"; // once per app — required
|
|
9
|
+
import { SourceCode } 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,29 @@
|
|
|
1
|
+
# Span — wimui
|
|
2
|
+
|
|
3
|
+
> Lightweight wrapper for inline text or short labels with icon support
|
|
4
|
+
|
|
5
|
+
## Import
|
|
6
|
+
|
|
7
|
+
```ts
|
|
8
|
+
import "wimui/styles.css"; // once per app — required
|
|
9
|
+
import { Span } from "wimui/typography";
|
|
10
|
+
```
|
|
11
|
+
|
|
12
|
+
## Props
|
|
13
|
+
|
|
14
|
+
- `asChild: boolean` = false — If true, the span 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
|
+
- `fontStyle: "normal" | "italic"` = "normal" — Font style. @default "normal"
|
|
19
|
+
- `decoration: "line-through" | "underline" | "highlight" | "none"` = "none" — Visual decoration applied to the text. @default "none"
|
|
20
|
+
- `content: React.ReactNode` — Content of the span. Alternative to children.
|
|
21
|
+
- `iconName: React.ComponentProps<typeof Icon>["name"]` = undefined — Name of the icon displayed alongside the text.
|
|
22
|
+
- `iconPosition: "left" | "right"` = "left" — Position of the icon relative to the text. @default "left"
|
|
23
|
+
|
|
24
|
+
## Design tokens it reads
|
|
25
|
+
|
|
26
|
+
`--wim-color-text-accent`, `--wim-color-text-danger`, `--wim-color-text-info`, `--wim-color-text-success`, `--wim-color-text-warning`, `--wim-comp-decoration-highlight-color`, `--wim-decoration-line-through`, `--wim-decoration-underline`, `--wim-font-size-icon-inner`, `--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-spacing-xs`, `--wim-text-underline-offset`
|
|
27
|
+
|
|
28
|
+
---
|
|
29
|
+
Setup, composition rules and the full catalog: `llms.txt` / `llms-full.txt` in the same package.
|
|
@@ -0,0 +1,27 @@
|
|
|
1
|
+
# Sparkline — wimui
|
|
2
|
+
|
|
3
|
+
> Tiny inline trend chart
|
|
4
|
+
|
|
5
|
+
## Import
|
|
6
|
+
|
|
7
|
+
```ts
|
|
8
|
+
import "wimui/styles.css"; // once per app — required
|
|
9
|
+
import { Sparkline } from "wimui/charts";
|
|
10
|
+
```
|
|
11
|
+
|
|
12
|
+
## Props
|
|
13
|
+
|
|
14
|
+
- `data: number[]` (required) — Sequence of values to plot, in order
|
|
15
|
+
- `type: "line" | "area" | "bar"` = "line" — Visual form of the sparkline
|
|
16
|
+
- `width: number | string` = "100%" — Width of the sparkline (number in px, or a CSS value such as "100%")
|
|
17
|
+
- `height: number` = 24 — Height of the sparkline in px
|
|
18
|
+
- `color: string` = "var(--wim-color-chart-primary)" — Stroke/fill color (defaults to the primary chart color)
|
|
19
|
+
- `strokeWidth: number` = 2 — Stroke width for line and area types
|
|
20
|
+
- `showLastDot: boolean` = false — Whether to emphasize the last data point with a dot (line and area only)
|
|
21
|
+
- `min: number` — Lower bound of the y-axis domain (defaults to the data minimum)
|
|
22
|
+
- `max: number` — Upper bound of the y-axis domain (defaults to the data maximum)
|
|
23
|
+
- `ariaLabel: string` — Accessible label describing the trend; when omitted the sparkline is hidden from assistive tech
|
|
24
|
+
- `className: string` — Additional class names
|
|
25
|
+
|
|
26
|
+
---
|
|
27
|
+
Setup, composition rules and the full catalog: `llms.txt` / `llms-full.txt` in the same package.
|
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
# SpeedDial — wimui
|
|
2
|
+
|
|
3
|
+
> Floating action button that expands sub-actions on hover or click.
|
|
4
|
+
|
|
5
|
+
## Import
|
|
6
|
+
|
|
7
|
+
```ts
|
|
8
|
+
import "wimui/styles.css"; // once per app — required
|
|
9
|
+
import { SpeedDial } from "wimui/navigation";
|
|
10
|
+
```
|
|
11
|
+
|
|
12
|
+
## Props
|
|
13
|
+
|
|
14
|
+
- `actions: SpeedDialAction[]` (required) — Actions to display when SpeedDial is open
|
|
15
|
+
- `icon: keyof typeof ALL_ICONS` = "PlusIcon" — Icon name for the main button when closed
|
|
16
|
+
- `activeIcon: keyof typeof ALL_ICONS` = "CloseIcon" — Icon name for the main button when open
|
|
17
|
+
- `direction: "up" | "down" | "left" | "right"` = "up" — Direction in which actions expand. **The caller picks a direction that has room.** Actions are placed with plain CSS (`left: 100%` and friends) and are never measured, so this component does not flip when the viewport runs out — a `right` dial placed near the right edge pushes the page into a horizontal scroll. Anchor a `right` dial to the leading edge (and a `left` one to the trailing edge); `up` / `down` already grow inward from the trailing corner (T175). @default "up"
|
|
18
|
+
- `trigger: "hover" | "click"` = "hover" — Trigger mode to open the SpeedDial
|
|
19
|
+
- `open: boolean` — Controlled open state
|
|
20
|
+
- `onOpenChange: (open: boolean) => void` — Callback when open state changes
|
|
21
|
+
- `aria-label: string` — Accessible name for the trigger button. Lands on the inner `FloatButton`, not on the wrapper `div`. Defaults to a translated "Open menu" / "Close menu" (en / ja / pt), following the open state.
|
|
22
|
+
|
|
23
|
+
## Design tokens it reads
|
|
24
|
+
|
|
25
|
+
`--wim-duration-base`, `--wim-easing-standard`, `--wim-spacing-md`, `--wim-z-overlay`
|
|
26
|
+
|
|
27
|
+
---
|
|
28
|
+
Setup, composition rules and the full catalog: `llms.txt` / `llms-full.txt` in the same package.
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
# Spinner — wimui
|
|
2
|
+
|
|
3
|
+
> A rotating icon indicating background activity or data fetching
|
|
4
|
+
|
|
5
|
+
Also known as: Activity Indicator
|
|
6
|
+
|
|
7
|
+
## Import
|
|
8
|
+
|
|
9
|
+
```ts
|
|
10
|
+
import "wimui/styles.css"; // once per app — required
|
|
11
|
+
import { Spinner } from "wimui/feedback";
|
|
12
|
+
```
|
|
13
|
+
|
|
14
|
+
## Props
|
|
15
|
+
|
|
16
|
+
- `size: Extract<ComponentSize, "sm" | "md" | "lg" | "xl">` = "md" — Size of the spinner. @default "md"
|
|
17
|
+
- `color: "currentColor" | WimColor` = "primary" — Color of the spinner. Accepts a design token color name or "currentColor". @default "primary"
|
|
18
|
+
- `label: string` — Text label displayed next to the spinner.
|
|
19
|
+
- `labelPosition: "right" | "bottom"` = "right" — Position of the label relative to the spinner. @default "right"
|
|
20
|
+
|
|
21
|
+
## Design tokens it reads
|
|
22
|
+
|
|
23
|
+
`--wim-color-danger`, `--wim-color-line`, `--wim-color-success`, `--wim-color-text-accent`, `--wim-color-text-secondary`, `--wim-color-warning`, `--wim-font-size-sm`, `--wim-spacing-2xl`, `--wim-spacing-3xl`, `--wim-spacing-lg`, `--wim-spacing-md`
|
|
24
|
+
|
|
25
|
+
---
|
|
26
|
+
Setup, composition rules and the full catalog: `llms.txt` / `llms-full.txt` in the same package.
|
|
@@ -0,0 +1,29 @@
|
|
|
1
|
+
# SplitButton — wimui
|
|
2
|
+
|
|
3
|
+
> SplitButton description.
|
|
4
|
+
|
|
5
|
+
## Import
|
|
6
|
+
|
|
7
|
+
```ts
|
|
8
|
+
import "wimui/styles.css"; // once per app — required
|
|
9
|
+
import { SplitButton } from "wimui/form";
|
|
10
|
+
```
|
|
11
|
+
|
|
12
|
+
## Props
|
|
13
|
+
|
|
14
|
+
- `children: React.ReactNode` — Text of the main action.
|
|
15
|
+
- `onClick: React.MouseEventHandler<HTMLButtonElement>` — Called when the main action is pressed.
|
|
16
|
+
- `actions: SplitButtonAction[]` (required) — Secondary actions listed behind the toggle.
|
|
17
|
+
- `variant: "solid" | "outline" | "ghost"` = "solid" — Visual style, applied to both halves so they read as one control.
|
|
18
|
+
- `intent: "default" | "danger" | "success"` = "default" — Intent (semantic color), applied to both halves.
|
|
19
|
+
- `size: Extract<ComponentSize, "sm" | "md" | "lg">` = "md" — Size of both halves.
|
|
20
|
+
- `disabled: boolean` = false — Disable the whole control.
|
|
21
|
+
- `loading: boolean` = false — Show a loading state on the main action.
|
|
22
|
+
- `toggleLabel: string` (required) — Accessible name for the toggle half. The main half is named by its own text, but the toggle only shows a chevron, so it needs one of its own.
|
|
23
|
+
|
|
24
|
+
## Design tokens it reads
|
|
25
|
+
|
|
26
|
+
`--wim-border-width-thick`, `--wim-border-width-thin`, `--wim-color-overlay-soft`, `--wim-opacity-dim`, `--wim-spacing-md`, `--wim-spacing-xl`, `--wim-spacing-xs`
|
|
27
|
+
|
|
28
|
+
---
|
|
29
|
+
Setup, composition rules and the full catalog: `llms.txt` / `llms-full.txt` in the same package.
|
|
@@ -0,0 +1,37 @@
|
|
|
1
|
+
# Splitter — wimui
|
|
2
|
+
|
|
3
|
+
> Split and resize panels
|
|
4
|
+
|
|
5
|
+
Also known as: Resizable, Resizable Panels, Split Pane
|
|
6
|
+
|
|
7
|
+
## Import
|
|
8
|
+
|
|
9
|
+
```ts
|
|
10
|
+
import "wimui/styles.css"; // once per app — required
|
|
11
|
+
import { Splitter } from "wimui/layout";
|
|
12
|
+
```
|
|
13
|
+
|
|
14
|
+
## Props
|
|
15
|
+
|
|
16
|
+
- `orientation: "horizontal" | "vertical"` = "horizontal" — The orientation of the splitter.
|
|
17
|
+
- `children: React.ReactNode` (required) — The components to render within the splitter. Usually a combination of `Splitter.Panel` and `Splitter.Handle`.
|
|
18
|
+
|
|
19
|
+
## Splitter.Handle
|
|
20
|
+
|
|
21
|
+
- `index: number` — @internal Injected index from parent Splitter.
|
|
22
|
+
- `active: boolean` — @internal Injected active state from parent Splitter.
|
|
23
|
+
- `ariaLabel: string` — Accessible label for the resize handle
|
|
24
|
+
|
|
25
|
+
## Splitter.Panel
|
|
26
|
+
|
|
27
|
+
- `defaultSize: number` — The default size of the panel in percentage.
|
|
28
|
+
- `minSize: number` — The minimum size of the panel in percentage.
|
|
29
|
+
- `maxSize: number` — The maximum size of the panel in percentage.
|
|
30
|
+
- `size: number` — @internal Injected size from parent Splitter.
|
|
31
|
+
|
|
32
|
+
## Design tokens it reads
|
|
33
|
+
|
|
34
|
+
`--wim-color-ghost-bg-hover`, `--wim-color-primary`, `--wim-color-text-tertiary`, `--wim-splitter-handle-active-color`, `--wim-splitter-handle-color`, `--wim-splitter-handle-hover-bg`, `--wim-splitter-handle-width`, `--wim-transition-fast`
|
|
35
|
+
|
|
36
|
+
---
|
|
37
|
+
Setup, composition rules and the full catalog: `llms.txt` / `llms-full.txt` in the same package.
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
# Spoiler — wimui
|
|
2
|
+
|
|
3
|
+
> Collapse long text such as reviews and comments to a fixed number of lines, with an accessible "show more" toggle that appears only when the text overflows.
|
|
4
|
+
|
|
5
|
+
## Import
|
|
6
|
+
|
|
7
|
+
```ts
|
|
8
|
+
import "wimui/styles.css"; // once per app — required
|
|
9
|
+
import { Spoiler } from "wimui/typography";
|
|
10
|
+
```
|
|
11
|
+
|
|
12
|
+
## Props
|
|
13
|
+
|
|
14
|
+
- `lines: number` = 3 — Number of text lines shown while collapsed. @default 3
|
|
15
|
+
- `expanded: boolean` — Controlled expanded state. Use together with onExpandedChange.
|
|
16
|
+
- `defaultExpanded: boolean` = false — Initial expanded state for uncontrolled usage. @default false
|
|
17
|
+
- `onExpandedChange: (expanded: boolean) => void` — Called with the next state when the toggle is activated.
|
|
18
|
+
- `showLabel: React.ReactNode` — Label of the toggle while collapsed. @default t("spoiler.show_more")
|
|
19
|
+
- `hideLabel: React.ReactNode` — Label of the toggle while expanded. @default t("spoiler.show_less")
|
|
20
|
+
|
|
21
|
+
## Design tokens it reads
|
|
22
|
+
|
|
23
|
+
`--wim-color-primary`, `--wim-color-text-accent`, `--wim-decoration-underline`, `--wim-font-size-sm`, `--wim-font-weight-semibold`, `--wim-radius-sm`, `--wim-shadow-focus`, `--wim-spacing-2xs`, `--wim-spoiler-lines`, `--wim-tap-target-min`, `--wim-transition-base`, `--wim-transition-fast`
|
|
24
|
+
|
|
25
|
+
---
|
|
26
|
+
Setup, composition rules and the full catalog: `llms.txt` / `llms-full.txt` in the same package.
|
|
@@ -0,0 +1,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.
|