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.
- package/dist/components/_internal/typeahead.cjs +2 -0
- package/dist/components/_internal/typeahead.d.ts +45 -0
- package/dist/components/_internal/typeahead.js +24 -0
- 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/ModelSelector/ModelSelector.cjs +1 -1
- package/dist/components/ai/ModelSelector/ModelSelector.js +119 -119
- 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/Cascader/Cascader.cjs +1 -1
- package/dist/components/form/Cascader/Cascader.js +168 -151
- package/dist/components/form/Combobox/Combobox.cjs +1 -1
- package/dist/components/form/Combobox/Combobox.js +48 -47
- package/dist/components/form/MultiSelect/MultiSelect.cjs +1 -1
- package/dist/components/form/MultiSelect/MultiSelect.js +131 -111
- package/dist/components/form/Select/useSelect.cjs +1 -1
- package/dist/components/form/Select/useSelect.js +83 -75
- package/dist/components/form/Transfer/Transfer.cjs +1 -1
- package/dist/components/form/Transfer/Transfer.js +147 -142
- package/dist/components/media/Gallery/Gallery.cjs +1 -1
- package/dist/components/media/Gallery/Gallery.js +111 -110
- package/dist/components/navigation/Menubar/Menubar.cjs +1 -1
- package/dist/components/navigation/Menubar/Menubar.js +133 -122
- package/dist/components/overlay/Dropdown/Dropdown.cjs +1 -1
- package/dist/components/overlay/Dropdown/Dropdown.js +131 -122
- package/dist/components/overlay/Menu/Menu.cjs +1 -1
- package/dist/components/overlay/Menu/Menu.js +100 -89
- 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 +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.
|
package/dist/llms/Tag.md
ADDED
|
@@ -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.
|