wimui 0.70.0 → 0.72.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- 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/data-display/List/List.cjs +1 -1
- package/dist/components/data-display/List/List.d.ts +5 -1
- package/dist/components/data-display/List/List.js +3 -3
- 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/components/media/Lightbox/Lightbox.cjs +1 -1
- package/dist/components/media/Lightbox/Lightbox.d.ts +2 -1
- package/dist/components/media/Lightbox/Lightbox.js +3 -3
- 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 +114 -111
- 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,31 @@
|
|
|
1
|
+
# QueryBuilder — wimui
|
|
2
|
+
|
|
3
|
+
> Visual builder for constructing complex search queries.
|
|
4
|
+
|
|
5
|
+
## Import
|
|
6
|
+
|
|
7
|
+
```ts
|
|
8
|
+
import "wimui/styles.css"; // once per app — required
|
|
9
|
+
import { QueryBuilder } from "wimui/form";
|
|
10
|
+
```
|
|
11
|
+
|
|
12
|
+
## Props
|
|
13
|
+
|
|
14
|
+
- `fields: QueryField[]` (required) — Field definitions
|
|
15
|
+
- `query: QueryGroup` — Current query state (controlled)
|
|
16
|
+
- `defaultQuery: QueryGroup` — Default query state (uncontrolled)
|
|
17
|
+
- `onChange: (query: QueryGroup) => void` — Callback when query changes
|
|
18
|
+
- `maxDepth: number` = 3 — Maximum nesting depth
|
|
19
|
+
- `className: string` — Additional class name
|
|
20
|
+
- `id: string` — Unique ID for the component
|
|
21
|
+
- `labels: QueryBuilderLabels` = {} — Labels for internationalization
|
|
22
|
+
- `aria-label: string` — Accessible name for the query builder region. Takes precedence over `labels.regionAriaLabel`.
|
|
23
|
+
- `aria-labelledby: string` — ID of the element that labels the query builder region. Takes precedence over `aria-label`.
|
|
24
|
+
- `aria-describedby: string` — ID of the element that describes the query builder region.
|
|
25
|
+
|
|
26
|
+
## Design tokens it reads
|
|
27
|
+
|
|
28
|
+
`--wim-border-width-thin`, `--wim-color-border`, `--wim-color-border-secondary`, `--wim-color-danger`, `--wim-color-primary`, `--wim-color-primary-soft`, `--wim-color-surface`, `--wim-color-surface-hover`, `--wim-color-surface-variant`, `--wim-duration-base`, `--wim-duration-fast`, `--wim-easing-entrance`, `--wim-easing-standard`, `--wim-focus-outline-offset`, `--wim-height-md`, `--wim-input-width`, `--wim-radius-container`, `--wim-spacing-2xs`, `--wim-spacing-3xs`, `--wim-spacing-lg`, `--wim-spacing-md`, `--wim-spacing-sm`, `--wim-spacing-xl`, `--wim-transition-fast`, `--wim-width-sm`
|
|
29
|
+
|
|
30
|
+
---
|
|
31
|
+
Setup, composition rules and the full catalog: `llms.txt` / `llms-full.txt` in the same package.
|
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
# RadarChart — wimui
|
|
2
|
+
|
|
3
|
+
> Multivariate data on concentric axes chart
|
|
4
|
+
|
|
5
|
+
## Import
|
|
6
|
+
|
|
7
|
+
```ts
|
|
8
|
+
import "wimui/styles.css"; // once per app — required
|
|
9
|
+
import { RadarChart } from "wimui/charts";
|
|
10
|
+
```
|
|
11
|
+
|
|
12
|
+
## Props
|
|
13
|
+
|
|
14
|
+
- `data: ChartDataPoint[]` (required) — Data to display in the chart.
|
|
15
|
+
- `keys: string[]` (required) — Keys in the data objects to render as radar areas (series).
|
|
16
|
+
- `indexKey: string` (required) — The key in the data objects used for the axis (category) labels.
|
|
17
|
+
- `height: number` = 300 — The height of the chart in pixels. @default 300
|
|
18
|
+
- `width: string | number` = "100%" — The width of the chart (e.g., "100%", 500). @default "100%"
|
|
19
|
+
- `title: string` — Optional title displayed above the chart.
|
|
20
|
+
- `animated: boolean` = false — If true, animates the chart on mount. @default false
|
|
21
|
+
- `aria-label: string` — Accessible name for the chart. Defaults to `title` when omitted; pass this when the chart has no visible title, or when the title is not descriptive enough on its own.
|
|
22
|
+
|
|
23
|
+
---
|
|
24
|
+
Setup, composition rules and the full catalog: `llms.txt` / `llms-full.txt` in the same package.
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
# Radio — wimui
|
|
2
|
+
|
|
3
|
+
> Single choice
|
|
4
|
+
|
|
5
|
+
## Import
|
|
6
|
+
|
|
7
|
+
```ts
|
|
8
|
+
import "wimui/styles.css"; // once per app — required
|
|
9
|
+
import { Radio } from "wimui/form";
|
|
10
|
+
```
|
|
11
|
+
|
|
12
|
+
## Props
|
|
13
|
+
|
|
14
|
+
- `asChild: boolean` = false — Whether to render as a child element.
|
|
15
|
+
- `children: React.ReactNode` — Label content rendered next to the radio
|
|
16
|
+
- `error: boolean` = false — Whether to display as an error state (aria-invalid is not supported on the radio role, so it is applied on the RadioGroup side)
|
|
17
|
+
|
|
18
|
+
## Design tokens it reads
|
|
19
|
+
|
|
20
|
+
`--wim-border-width-thick`, `--wim-color-danger`, `--wim-color-disabled`, `--wim-color-focus-outline`, `--wim-color-primary`, `--wim-color-text-danger`, `--wim-color-text-on-disabled`, `--wim-color-text-primary`, `--wim-color-text-tertiary`, `--wim-duration-base`, `--wim-easing-standard`, `--wim-font-family-default`, `--wim-font-size-md`, `--wim-line-height-normal`, `--wim-opacity-disabled`, `--wim-radio-dot-size`, `--wim-radio-size`, `--wim-radius-full`, `--wim-shadow-error-ring`, `--wim-shadow-focus`, `--wim-spacing-md`, `--wim-spacing-sm`, `--wim-tap-target-min`
|
|
21
|
+
|
|
22
|
+
---
|
|
23
|
+
Setup, composition rules and the full catalog: `llms.txt` / `llms-full.txt` in the same package.
|
|
@@ -0,0 +1,32 @@
|
|
|
1
|
+
# RadioGroup — wimui
|
|
2
|
+
|
|
3
|
+
> Shared state radio buttons
|
|
4
|
+
|
|
5
|
+
## Import
|
|
6
|
+
|
|
7
|
+
```ts
|
|
8
|
+
import "wimui/styles.css"; // once per app — required
|
|
9
|
+
import { RadioGroup } from "wimui/form";
|
|
10
|
+
```
|
|
11
|
+
|
|
12
|
+
## Props
|
|
13
|
+
|
|
14
|
+
- `options: Option[]` (required) — List of radio options
|
|
15
|
+
- `value: string` — Selected value (controlled)
|
|
16
|
+
- `defaultValue: string` — Initially selected value (uncontrolled)
|
|
17
|
+
- `onChange: (value: string) => void` — Callback when the selected value changes
|
|
18
|
+
- `direction: "vertical" | "horizontal"` = "vertical" — Layout direction of the radio buttons
|
|
19
|
+
- `variant: "default" | "card"` = "default" — `card` draws each option as a bordered card that is selectable as a whole (the card is the option's `<label>`). Keys and group semantics stay those of a radio group. Use with `description` when the options need explaining. @default "default"
|
|
20
|
+
- `name: string` — Name attribute shared by the radio inputs
|
|
21
|
+
- `asChild: boolean` = false — Whether to render as a child element.
|
|
22
|
+
- `label: string` — Group label
|
|
23
|
+
- `error: string` — Error message
|
|
24
|
+
- `required: boolean` — Whether to show the required indicator
|
|
25
|
+
- `disabled: boolean` — Whether the whole group is disabled
|
|
26
|
+
|
|
27
|
+
## Design tokens it reads
|
|
28
|
+
|
|
29
|
+
`--wim-spacing-lg`, `--wim-spacing-md`, `--wim-spacing-sm`, `--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,26 @@
|
|
|
1
|
+
# RangeCalendar — wimui
|
|
2
|
+
|
|
3
|
+
> Range calendar view
|
|
4
|
+
|
|
5
|
+
## Import
|
|
6
|
+
|
|
7
|
+
```ts
|
|
8
|
+
import "wimui/styles.css"; // once per app — required
|
|
9
|
+
import { RangeCalendar } from "wimui/data-display";
|
|
10
|
+
```
|
|
11
|
+
|
|
12
|
+
## Props
|
|
13
|
+
|
|
14
|
+
- `value: [Date | null, Date | null]` — 現在選択されている範囲 [開始日, 終了日]。
|
|
15
|
+
- `onChange: (value: RangeCalendarValue) => void` — 範囲が変更された時のコールバック。
|
|
16
|
+
- `defaultValue: [Date | null, Date | null]` — 初期値。
|
|
17
|
+
- `className: string` — 追加のクラス名。
|
|
18
|
+
- `disabled: boolean` = false — 無効化。
|
|
19
|
+
- `minDate: Date` — 選択可能な最小日付。
|
|
20
|
+
- `maxDate: Date` — 選択可能な最大日付。
|
|
21
|
+
- `disabledDates: Date[]` — 無効化する日付の配列。
|
|
22
|
+
- `isDateDisabled: (date: Date) => boolean` — 特定の日付を無効化する関数。
|
|
23
|
+
- `weekStartsOn: 0 | 1` — 週の開始曜日。0 = 日曜始まり、1 = 月曜始まり。デフォルトは 0。
|
|
24
|
+
|
|
25
|
+
---
|
|
26
|
+
Setup, composition rules and the full catalog: `llms.txt` / `llms-full.txt` in the same package.
|
|
@@ -0,0 +1,39 @@
|
|
|
1
|
+
# RangeSlider — wimui
|
|
2
|
+
|
|
3
|
+
> Range selection
|
|
4
|
+
|
|
5
|
+
## Import
|
|
6
|
+
|
|
7
|
+
```ts
|
|
8
|
+
import "wimui/styles.css"; // once per app — required
|
|
9
|
+
import { RangeSlider } from "wimui/form";
|
|
10
|
+
```
|
|
11
|
+
|
|
12
|
+
## Props
|
|
13
|
+
|
|
14
|
+
- `value: [number, number]` — Current value [min, max] (controlled)
|
|
15
|
+
- `defaultValue: [number, number]` = [20, 80] — Default value [min, max] (uncontrolled)
|
|
16
|
+
- `min: number` = 0 — Minimum value
|
|
17
|
+
- `max: number` = 100 — Maximum value
|
|
18
|
+
- `step: number` = 1 — Step value
|
|
19
|
+
- `allowCross: boolean` = false — Whether both handles may hold the same value (they never cross)
|
|
20
|
+
- `disabled: boolean` = false — Whether the slider is disabled
|
|
21
|
+
- `onChange: (value: [number, number]) => void` — Callback when the value changes
|
|
22
|
+
- `onAfterChange: (value: [number, number]) => void` — Callback when dragging ends
|
|
23
|
+
- `className: string` — Additional class names
|
|
24
|
+
- `name: string` — Name attribute
|
|
25
|
+
- `label: string` — Accessible label
|
|
26
|
+
- `error: string` — Error message
|
|
27
|
+
- `required: boolean` — Whether to show the required indicator
|
|
28
|
+
- `layout: "vertical" | "horizontal"` = "vertical" — Layout direction of label and field
|
|
29
|
+
- `id: string` — Custom ID
|
|
30
|
+
- `aria-label: string` — Accessible label when no visible label is provided
|
|
31
|
+
- `aria-labelledby: string` — ID of the element that labels the slider
|
|
32
|
+
- `asChild: boolean` = false — Whether to render as a child element.
|
|
33
|
+
|
|
34
|
+
## Design tokens it reads
|
|
35
|
+
|
|
36
|
+
`--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-duration-extra-fast`, `--wim-duration-fast`, `--wim-easing-standard`, `--wim-focus-outline-width`, `--wim-height-xs`, `--wim-opacity-ghost`, `--wim-radius-full`, `--wim-shadow-sm`, `--wim-tap-target-min`
|
|
37
|
+
|
|
38
|
+
---
|
|
39
|
+
Setup, composition rules and the full catalog: `llms.txt` / `llms-full.txt` in the same package.
|
|
@@ -0,0 +1,37 @@
|
|
|
1
|
+
# Rating — wimui
|
|
2
|
+
|
|
3
|
+
> Star rating
|
|
4
|
+
|
|
5
|
+
Also known as: Star Rating, Rating Indicator
|
|
6
|
+
|
|
7
|
+
## Import
|
|
8
|
+
|
|
9
|
+
```ts
|
|
10
|
+
import "wimui/styles.css"; // once per app — required
|
|
11
|
+
import { Rating } from "wimui/form";
|
|
12
|
+
```
|
|
13
|
+
|
|
14
|
+
## Props
|
|
15
|
+
|
|
16
|
+
- `value: number` — Current value (controlled)
|
|
17
|
+
- `defaultValue: number` = 0 — Default value (uncontrolled)
|
|
18
|
+
- `count: number` = 5 — Total number of stars
|
|
19
|
+
- `allowHalf: boolean` = false — Whether to allow half stars
|
|
20
|
+
- `disabled: boolean` = false — Whether the rating is disabled
|
|
21
|
+
- `readOnly: boolean` = false — Read-only flag (display only; unlike disabled it is not grayed out)
|
|
22
|
+
- `size: "sm" | "md" | "lg"` = "md" — Size of the stars
|
|
23
|
+
- `onChange: (value: number) => void` — Callback when the value changes
|
|
24
|
+
- `className: string` — Additional class names
|
|
25
|
+
- `label: React.ReactNode` — Accessible label
|
|
26
|
+
- `error: string` — Error message
|
|
27
|
+
- `required: boolean` — Whether to show the required indicator
|
|
28
|
+
- `layout: "vertical" | "horizontal"` = "vertical" — Layout direction of label and field
|
|
29
|
+
- `labels: { star?: (count: number) => string; readonly?: (value: number, max: number) => string; }` = {} — Labels for internationalization
|
|
30
|
+
- `asChild: boolean` = false — Whether to render as a child element.
|
|
31
|
+
|
|
32
|
+
## Design tokens it reads
|
|
33
|
+
|
|
34
|
+
`--wim-border-width-thick`, `--wim-color-border`, `--wim-color-text-tertiary`, `--wim-color-warning`, `--wim-height-md`, `--wim-height-sm`, `--wim-rating-star-size`, `--wim-spacing-2xs`, `--wim-spacing-sm`, `--wim-tap-target-min`, `--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
|
+
# Reaction — wimui
|
|
2
|
+
|
|
3
|
+
> Display emoji reaction buttons with toggleable state and counts
|
|
4
|
+
|
|
5
|
+
## Import
|
|
6
|
+
|
|
7
|
+
```ts
|
|
8
|
+
import "wimui/styles.css"; // once per app — required
|
|
9
|
+
import { Reaction } from "wimui/data-display";
|
|
10
|
+
```
|
|
11
|
+
|
|
12
|
+
## Props
|
|
13
|
+
|
|
14
|
+
- `reactions: ReactionItem[]` (required) — List of reactions
|
|
15
|
+
- `onReact: (emoji: string, active: boolean) => void` — Callback when a reaction is added or removed
|
|
16
|
+
- `showAddButton: boolean` = false — Whether to show the add button
|
|
17
|
+
- `onAdd: () => void` — Callback when the add button is clicked
|
|
18
|
+
- `size: "sm" | "md" | "lg"` = "md" — Size
|
|
19
|
+
- `disabled: boolean` = false — Whether the component is disabled
|
|
20
|
+
|
|
21
|
+
## Design tokens it reads
|
|
22
|
+
|
|
23
|
+
`--wim-border-width-thin`, `--wim-color-border`, `--wim-color-primary`, `--wim-color-surface`, `--wim-color-text-accent`, `--wim-color-text-secondary`, `--wim-color-text-tertiary`, `--wim-font-size-md`, `--wim-font-size-sm`, `--wim-font-size-xs`, `--wim-font-weight-medium`, `--wim-opacity-disabled`, `--wim-radius-full`, `--wim-scale-active`, `--wim-spacing-2xs`, `--wim-spacing-3xs`, `--wim-spacing-md`, `--wim-spacing-sm`, `--wim-spacing-xs`, `--wim-tap-target-min`, `--wim-transition-base`
|
|
24
|
+
|
|
25
|
+
---
|
|
26
|
+
Setup, composition rules and the full catalog: `llms.txt` / `llms-full.txt` in the same package.
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
# RefTable — wimui
|
|
2
|
+
|
|
3
|
+
> Property and argument reference table
|
|
4
|
+
|
|
5
|
+
## Import
|
|
6
|
+
|
|
7
|
+
```ts
|
|
8
|
+
import "wimui/styles.css"; // once per app — required
|
|
9
|
+
import { RefTable } 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,24 @@
|
|
|
1
|
+
# RelativeTime — wimui
|
|
2
|
+
|
|
3
|
+
> Display a timestamp as a localized relative phrase ("3 minutes ago", "yesterday") that updates automatically as time passes.
|
|
4
|
+
|
|
5
|
+
## Import
|
|
6
|
+
|
|
7
|
+
```ts
|
|
8
|
+
import "wimui/styles.css"; // once per app — required
|
|
9
|
+
import { RelativeTime } from "wimui/data-display";
|
|
10
|
+
```
|
|
11
|
+
|
|
12
|
+
## Props
|
|
13
|
+
|
|
14
|
+
- `date: Date | string | number` (required) — The date to display, as a Date object, ISO 8601 string, or epoch milliseconds.
|
|
15
|
+
- `baseDate: Date | string | number` — Reference point used as "now". When set, live updates are disabled. @default current time
|
|
16
|
+
- `locale: string` — BCP 47 locale override (e.g. "en", "ja", "pt-BR"). @default current i18next language
|
|
17
|
+
- `numeric: Intl.RelativeTimeFormatNumeric` = "auto" — "auto" allows idiomatic phrases like "yesterday"; "always" always uses numbers ("1 day ago"). @default "auto"
|
|
18
|
+
- `format: Intl.RelativeTimeFormatStyle` = "long" — Length of the formatted message ("long" | "short" | "narrow"). @default "long"
|
|
19
|
+
- `live: boolean` = true — Automatically re-render as time passes. Ignored when baseDate is set. @default true
|
|
20
|
+
- `fallback: React.ReactNode` — Content shown when the date cannot be parsed.
|
|
21
|
+
- `asChild: boolean` = false — If true, the component will be rendered as its child, merging its props onto that child.
|
|
22
|
+
|
|
23
|
+
---
|
|
24
|
+
Setup, composition rules and the full catalog: `llms.txt` / `llms-full.txt` in the same package.
|
|
@@ -0,0 +1,29 @@
|
|
|
1
|
+
# Result — wimui
|
|
2
|
+
|
|
3
|
+
> Task status indicator
|
|
4
|
+
|
|
5
|
+
## Import
|
|
6
|
+
|
|
7
|
+
```ts
|
|
8
|
+
import "wimui/styles.css"; // once per app — required
|
|
9
|
+
import { Result } from "wimui/feedback";
|
|
10
|
+
```
|
|
11
|
+
|
|
12
|
+
## Props
|
|
13
|
+
|
|
14
|
+
- `intent: "default" | "success" | "danger" | "info" | "warning"` = "default" — Semantic intent — determines the icon and color. `default` draws no icon unless `icon` is passed. @default "default"
|
|
15
|
+
- `status: "404" | "403" | "500"` — HTTP error status — adds a status-specific CSS class and shows a neutral icon. Use for error pages (404, 403, 500).
|
|
16
|
+
- `title: ReactNode` — The title
|
|
17
|
+
- `description: ReactNode` — The description
|
|
18
|
+
- `extra: ReactNode` — Operating area
|
|
19
|
+
- `icon: ReactNode` — Custom icon
|
|
20
|
+
- `iconSurface: boolean` = false — Sit the icon on a tinted circle in the intent's colour, instead of drawing it bare. Off by default so existing pages keep their look. Turn it on when the icon is the page's main visual — a maintenance or error page, where a bare glyph reads as an afterthought. The tint comes from `--wim-color-<intent>-subtle`, so it follows the theme and never needs a hand-mixed colour. @default false
|
|
21
|
+
- `className: string` — Custom class name
|
|
22
|
+
- `children: ReactNode` — The children
|
|
23
|
+
|
|
24
|
+
## Design tokens it reads
|
|
25
|
+
|
|
26
|
+
`--wim-color-danger-subtle`, `--wim-color-info-subtle`, `--wim-color-neutral-subtle`, `--wim-color-success-subtle`, `--wim-color-surface-subtle`, `--wim-color-warning-subtle`, `--wim-radius-full`, `--wim-radius-sm`, `--wim-result-icon-size`, `--wim-spacing-md`, `--wim-spacing-sm`
|
|
27
|
+
|
|
28
|
+
---
|
|
29
|
+
Setup, composition rules and the full catalog: `llms.txt` / `llms-full.txt` in the same package.
|
|
@@ -0,0 +1,59 @@
|
|
|
1
|
+
# RichTextEditor — wimui
|
|
2
|
+
|
|
3
|
+
> WYSIWYG rich text editor
|
|
4
|
+
|
|
5
|
+
## Import
|
|
6
|
+
|
|
7
|
+
```ts
|
|
8
|
+
import "wimui/styles.css"; // once per app — required
|
|
9
|
+
import { RichTextEditor } from "wimui/form";
|
|
10
|
+
```
|
|
11
|
+
|
|
12
|
+
## Props
|
|
13
|
+
|
|
14
|
+
- `value: string` — Content (controlled), in the format given by `format`. An empty editor is reported as "".
|
|
15
|
+
- `defaultValue: string` = "" — Initial content (uncontrolled), in the format given by `format`
|
|
16
|
+
- `onChange: (value: string) => void` — Callback when the content changes, in the format given by `format`. The content only contains what the editor's schema allows, whichever format is used.
|
|
17
|
+
- `format: "html" | "markdown"` = "html" — Format of `value`, `defaultValue` and `onChange`. With `"markdown"`, the editor reads and writes Markdown and has no underline (Markdown has no syntax for it): the underline button is hidden and underlined input keeps only its text. Read when the editor is created; changing it later does not convert the content.
|
|
18
|
+
- `placeholder: string` — Placeholder shown when the editor is empty
|
|
19
|
+
- `disabled: boolean` — Whether the editor is disabled
|
|
20
|
+
- `intent: "default" | "danger"` = "default" — Semantic intent of the field (e.g. error state)
|
|
21
|
+
- `variant: "outline" | "ghost"` = "outline" — Visual style variant of the field
|
|
22
|
+
- `fullWidth: boolean` = false — Whether to take full width of parent
|
|
23
|
+
- `width: ("xs" | "sm" | "md" | "lg" | "xl") | string | number` — Fixed width of the field (width token, CSS value, or number in px)
|
|
24
|
+
- `minHeight: number | string` = 200 — Minimum height of the editing area
|
|
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
|
+
- `className: string` — Additional class names
|
|
30
|
+
- `id: string` — Unique ID for the component
|
|
31
|
+
- `toolbar: ("bold" | "italic" | "underline" | "strikethrough" | "h1" | "h2" | "h3" | "ul" | "ol" | "link" | "unlink" | "image" | "removeFormat" | "separator")[]` = [
|
|
32
|
+
"bold",
|
|
33
|
+
"italic",
|
|
34
|
+
"underline",
|
|
35
|
+
"strikethrough",
|
|
36
|
+
"separator",
|
|
37
|
+
"h1",
|
|
38
|
+
"h2",
|
|
39
|
+
"h3",
|
|
40
|
+
"separator",
|
|
41
|
+
"ul",
|
|
42
|
+
"ol",
|
|
43
|
+
"separator",
|
|
44
|
+
"link",
|
|
45
|
+
"unlink",
|
|
46
|
+
"separator",
|
|
47
|
+
"removeFormat",
|
|
48
|
+
] — Toolbar items to display, in order
|
|
49
|
+
- `labels: { bold?: string; italic?: string; underline?: string; strikethrough?: string; h1?: string; h2?: string; h3?: string; ul?: string; ol?: string; link?: string; unlink?: string; removeFormat?: string; toolbar?: string; linkPrompt?: string; linkApply?: string; linkCancel?: string; /** Error shown in the link dialog when the URL is not allowed (only http, https, mailto and relative URLs are). */ linkInvalid?: string; /** Title of the image button and the image dialog. */ image?: string; /** Label of the image URL field. */ imageUrl?: string; /** Label of the alternative text field. */ imageAlt?: string; /** Hint under the alternative text field. */ imageAltHint?: string; /** Label of the button that picks a file (shown only with onImageUpload). */ imageUpload?: string; /** Error shown when onImageUpload rejects or returns a URL that is not allowed. */ imageUploadFailed?: string; /** Error shown in the image dialog when the URL is not allowed (only http, https and relative URLs are). */ imageInvalid?: string; }` = {} — Labels for internationalization
|
|
50
|
+
- `aria-label: string` — Accessible label when no visible label is provided
|
|
51
|
+
- `aria-labelledby: string` — ID of the element that labels the editor
|
|
52
|
+
- `onImageUpload: (file: File) => Promise<string>` — Uploads an image file and resolves to its URL (http, https or relative). When given, the image dialog offers a file picker and image files pasted or dropped into the editor are uploaded and inserted. The editor stores only the URL it gets back.
|
|
53
|
+
|
|
54
|
+
## Design tokens it reads
|
|
55
|
+
|
|
56
|
+
`--wim-border-width-thick`, `--wim-border-width-thin`, `--wim-color-disabled`, `--wim-color-focus-outline`, `--wim-color-ghost-bg-hover`, `--wim-color-line`, `--wim-color-primary`, `--wim-color-success`, `--wim-color-surface`, `--wim-color-text-accent`, `--wim-color-text-danger`, `--wim-color-text-disabled`, `--wim-color-text-on-disabled`, `--wim-color-text-primary`, `--wim-color-text-secondary`, `--wim-color-text-tertiary`, `--wim-color-warning`, `--wim-font-size-md`, `--wim-font-size-sm`, `--wim-font-size-xs`, `--wim-font-weight-bold`, `--wim-input-width`, `--wim-line-height-loose`, `--wim-radius-component`, `--wim-radius-sm`, `--wim-spacing-3xs`, `--wim-spacing-md`, `--wim-spacing-sm`, `--wim-spacing-xs`, `--wim-transition-base`, `--wim-width-sm`
|
|
57
|
+
|
|
58
|
+
---
|
|
59
|
+
Setup, composition rules and the full catalog: `llms.txt` / `llms-full.txt` in the same package.
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
# SankeyChart — wimui
|
|
2
|
+
|
|
3
|
+
> Flow chart where band width is the amount
|
|
4
|
+
|
|
5
|
+
## Import
|
|
6
|
+
|
|
7
|
+
```ts
|
|
8
|
+
import "wimui/styles.css"; // once per app — required
|
|
9
|
+
import { SankeyChart } from "wimui/charts";
|
|
10
|
+
```
|
|
11
|
+
|
|
12
|
+
## Props
|
|
13
|
+
|
|
14
|
+
- `nodes: string[]` (required) — Every node in the diagram, in the order their colors are assigned. Names are what `links` refers to, so they have to be unique.
|
|
15
|
+
- `links: SankeyLink[]` (required) — Flows between nodes, by node name. A link naming a node that is not in `nodes` is dropped (and reported in the console during development).
|
|
16
|
+
- `height: number` = 300 — The height of the chart in pixels. @default 300
|
|
17
|
+
- `width: string | number` = "100%" — The width of the chart (e.g., "100%", 500). @default "100%"
|
|
18
|
+
- `title: string` — Optional title displayed above the chart.
|
|
19
|
+
- `aria-label: string` — Accessible name for the chart. Defaults to `title` when omitted; pass this when the chart has no visible title, or when the title is not descriptive enough on its own.
|
|
20
|
+
|
|
21
|
+
## Design tokens it reads
|
|
22
|
+
|
|
23
|
+
`--wim-color-text-secondary`, `--wim-font-family-default`, `--wim-font-size-xs`
|
|
24
|
+
|
|
25
|
+
---
|
|
26
|
+
Setup, composition rules and the full catalog: `llms.txt` / `llms-full.txt` in the same package.
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
# ScatterChart — wimui
|
|
2
|
+
|
|
3
|
+
> Scatter plots
|
|
4
|
+
|
|
5
|
+
## Import
|
|
6
|
+
|
|
7
|
+
```ts
|
|
8
|
+
import "wimui/styles.css"; // once per app — required
|
|
9
|
+
import { ScatterChart } from "wimui/charts";
|
|
10
|
+
```
|
|
11
|
+
|
|
12
|
+
## Props
|
|
13
|
+
|
|
14
|
+
- `data: { x: number; y: number; z?: number; name: string }[]` (required) — Points to plot. `z` optionally controls the point size.
|
|
15
|
+
- `xAxisName: string` = "X" — Name of the X axis, shown in the tooltip. @default "X"
|
|
16
|
+
- `yAxisName: string` = "Y" — Name of the Y axis, shown in the tooltip. @default "Y"
|
|
17
|
+
- `xDomain: [ number | "auto" | "dataMin" | (string & {}), number | "auto" | "dataMax" | (string & {}), ]` = ["auto", "auto"] — Range of the X axis. @default ["auto", "auto"]
|
|
18
|
+
- `yDomain: [ number | "auto" | "dataMin" | (string & {}), number | "auto" | "dataMax" | (string & {}), ]` = ["auto", "auto"] — Range of the Y axis. @default ["auto", "auto"]
|
|
19
|
+
- `height: number` = 300 — The height of the chart in pixels. @default 300
|
|
20
|
+
- `width: string | number` = "100%" — The width of the chart (e.g., "100%", 500). @default "100%"
|
|
21
|
+
- `title: string` — Optional title displayed above the chart.
|
|
22
|
+
- `animated: boolean` = false — If true, animates the chart on mount. @default false
|
|
23
|
+
- `aria-label: string` — Accessible name for the chart. Defaults to `title` when omitted; pass this when the chart has no visible title, or when the title is not descriptive enough on its own.
|
|
24
|
+
|
|
25
|
+
---
|
|
26
|
+
Setup, composition rules and the full catalog: `llms.txt` / `llms-full.txt` in the same package.
|
|
@@ -0,0 +1,35 @@
|
|
|
1
|
+
# ScheduleView — wimui
|
|
2
|
+
|
|
3
|
+
> Displays tasks or events on a chronological timeline or calendar view.
|
|
4
|
+
|
|
5
|
+
## Import
|
|
6
|
+
|
|
7
|
+
```ts
|
|
8
|
+
import "wimui/styles.css"; // once per app — required
|
|
9
|
+
import { ScheduleView } from "wimui/data-display";
|
|
10
|
+
```
|
|
11
|
+
|
|
12
|
+
## Props
|
|
13
|
+
|
|
14
|
+
- `events: ScheduleViewEvent[]` = [] — List of calendar events
|
|
15
|
+
- `initialView: "timeGridWeek" | "timeGridDay" | "dayGridMonth"` = "timeGridWeek" — Initial view mode
|
|
16
|
+
- `editable: boolean` = true — Whether events can be dragged to new times
|
|
17
|
+
- `selectable: boolean` = true — Whether date ranges can be selected by clicking/dragging
|
|
18
|
+
- `onEventClick: (arg: EventClickArg) => void` — Called when an event is clicked
|
|
19
|
+
- `onEventDrop: (arg: EventDropArg) => void` — Called when an event is dropped to a new time
|
|
20
|
+
- `onEventChange: (arg: EventChangeArg) => void` — Called when an event is resized
|
|
21
|
+
- `onDateSelect: (arg: DateSelectArg) => void` — Called when a date/time range is selected
|
|
22
|
+
- `slotMinTime: string` = "08:00:00" — First hour displayed in the time grid (e.g. "08:00:00")
|
|
23
|
+
- `slotMaxTime: string` = "20:00:00" — Last hour displayed in the time grid (e.g. "20:00:00")
|
|
24
|
+
- `slotDuration: string` = "00:30:00" — Duration of each time slot, e.g. "00:30:00"
|
|
25
|
+
- `locale: string` = "en" — Locale string, e.g. "ja", "pt"
|
|
26
|
+
- `unselectAuto: boolean` = true — Whether clicking elsewhere on the page will clear the current selection
|
|
27
|
+
- `className: string` — Additional CSS class
|
|
28
|
+
- `aria-label: string` — Accessible label for the schedule region
|
|
29
|
+
|
|
30
|
+
## Design tokens it reads
|
|
31
|
+
|
|
32
|
+
`--wim-border-width-thin`, `--wim-color-border`, `--wim-color-focus-outline`, `--wim-color-ghost-bg`, `--wim-color-ghost-bg-hover`, `--wim-color-primary`, `--wim-color-surface`, `--wim-color-text-on-primary`, `--wim-color-text-primary`, `--wim-color-text-secondary`, `--wim-duration-fast`, `--wim-easing-standard`, `--wim-focus-outline-offset`, `--wim-focus-outline-width`, `--wim-font-size-lg`, `--wim-font-size-sm`, `--wim-font-weight-bold`, `--wim-font-weight-medium`, `--wim-radius-sm`, `--wim-spacing-sm`, `--wim-spacing-xl`, `--wim-spacing-xs`, `--wim-tap-target-min`
|
|
33
|
+
|
|
34
|
+
---
|
|
35
|
+
Setup, composition rules and the full catalog: `llms.txt` / `llms-full.txt` in the same package.
|
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
# ScrollArea — wimui
|
|
2
|
+
|
|
3
|
+
> A custom scrollbar component that provides high-performance, cross-browser consistent themes while maintaining a native-like feel.
|
|
4
|
+
|
|
5
|
+
## Import
|
|
6
|
+
|
|
7
|
+
```ts
|
|
8
|
+
import "wimui/styles.css"; // once per app — required
|
|
9
|
+
import { ScrollArea } from "wimui/layout";
|
|
10
|
+
```
|
|
11
|
+
|
|
12
|
+
## Props
|
|
13
|
+
|
|
14
|
+
- `text: React.ReactNode` — Content to display (alternative to children)
|
|
15
|
+
- `children: React.ReactNode` — Content to display
|
|
16
|
+
- `scrollAxis: "x" | "y" | "both"` = "y" — Axis along which scrolling is allowed
|
|
17
|
+
- `maxHeight: string` — Maximum height before scrolling (a CSS value, so units other than px are supported)
|
|
18
|
+
|
|
19
|
+
## Design tokens it reads
|
|
20
|
+
|
|
21
|
+
`--wim-color-border`, `--wim-color-border-secondary`, `--wim-radius-full`, `--wim-scroll-thickness`
|
|
22
|
+
|
|
23
|
+
---
|
|
24
|
+
Setup, composition rules and the full catalog: `llms.txt` / `llms-full.txt` in the same package.
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
# ScrollProgress — wimui
|
|
2
|
+
|
|
3
|
+
> Reading progress indicator
|
|
4
|
+
|
|
5
|
+
## Import
|
|
6
|
+
|
|
7
|
+
```ts
|
|
8
|
+
import "wimui/styles.css"; // once per app — required
|
|
9
|
+
import { ScrollProgress } from "wimui/feedback";
|
|
10
|
+
```
|
|
11
|
+
|
|
12
|
+
## Props
|
|
13
|
+
|
|
14
|
+
- `intent: "primary" | "success" | "warning" | "danger" | "info" | "neutral"` = "primary" — 意味の軸。兄弟の `Progress` / `ProgressRing` と同じ語彙にそろえてある。 以前は `color` という名前で、値も独自(`secondary` を含む)だった。 塗っているものは `Progress.intent` と構造まで同一だったので、prop 名だけが ずれていた(T114)。
|
|
15
|
+
- `target: React.RefObject<HTMLElement | null>` — Element whose scroll position is tracked. Defaults to `window`.
|
|
16
|
+
|
|
17
|
+
## Design tokens it reads
|
|
18
|
+
|
|
19
|
+
`--wim-color-primary`, `--wim-duration-extra-fast`, `--wim-easing-standard`, `--wim-spacing-2xs`, `--wim-z-overlay`
|
|
20
|
+
|
|
21
|
+
---
|
|
22
|
+
Setup, composition rules and the full catalog: `llms.txt` / `llms-full.txt` in the same package.
|
|
@@ -0,0 +1,44 @@
|
|
|
1
|
+
# SearchInput — wimui
|
|
2
|
+
|
|
3
|
+
> Search with clear button
|
|
4
|
+
|
|
5
|
+
Also known as: Search Field, Search Bar
|
|
6
|
+
|
|
7
|
+
## Import
|
|
8
|
+
|
|
9
|
+
```ts
|
|
10
|
+
import "wimui/styles.css"; // once per app — required
|
|
11
|
+
import { SearchInput } from "wimui/form";
|
|
12
|
+
```
|
|
13
|
+
|
|
14
|
+
## Props
|
|
15
|
+
|
|
16
|
+
- `intent: "default" | "danger"` = "default" — Semantic intent of the field (e.g. error state)
|
|
17
|
+
- `variant: "outline" | "ghost"` = "outline" — Visual style variant of the field
|
|
18
|
+
- `fullWidth: boolean` = false — Whether to take full width of parent
|
|
19
|
+
- `leftIcon: React.ComponentProps<typeof Icon>["name"]` — Icon name to display on the left side
|
|
20
|
+
- `rightIcon: React.ComponentProps<typeof Icon>["name"]` — Icon name to display on the right side
|
|
21
|
+
- `leftIconColor: React.ComponentProps<typeof Icon>["color"]` — Color of the left icon
|
|
22
|
+
- `rightIconColor: React.ComponentProps<typeof Icon>["color"]` — Color of the right icon
|
|
23
|
+
- `onLeftIconClick: (e: React.MouseEvent<HTMLButtonElement>) => void` — Callback when the left icon is clicked (renders the icon as a button)
|
|
24
|
+
- `onRightIconClick: (e: React.MouseEvent<HTMLButtonElement>) => void` — Callback when the right icon is clicked (renders the icon as a button)
|
|
25
|
+
- `allowClear: boolean` = false — Whether to show a clear button when value is present
|
|
26
|
+
- `showPasswordToggle: boolean` = true — Whether to show the visibility toggle when type is "password"
|
|
27
|
+
- `rightIconClassName: string` — Additional class name for the right icon
|
|
28
|
+
- `rightIconRotated: boolean` — Whether to rotate the right icon 180 degrees (e.g. for an open state)
|
|
29
|
+
- `width: ("xs" | "sm" | "md" | "lg" | "xl") | string | number` — Fixed width of the field (width token, CSS value, or number in px)
|
|
30
|
+
- `label: React.ReactNode` — Field label
|
|
31
|
+
- `error: string` — Error message
|
|
32
|
+
- `required: boolean` — Whether to show the required indicator
|
|
33
|
+
- `layout: "vertical" | "horizontal"` — Layout direction of label and field
|
|
34
|
+
- `inputClassName: string` — Additional class name for the inner input element
|
|
35
|
+
- `showPasswordAriaLabel: string` — Aria label for the show-password toggle
|
|
36
|
+
- `hidePasswordAriaLabel: string` — Aria label for the hide-password toggle
|
|
37
|
+
- `rightIconAriaLabel: string` — Aria label for the right icon button
|
|
38
|
+
- `rightIconDecorative: boolean` = false — Treats the clickable right icon as a pointer-only affordance: it stays clickable but leaves the tab order and is hidden from assistive technology. Use it when the field already does the same thing from the keyboard. @default false
|
|
39
|
+
- `suffix: React.ReactNode` — Static text shown after the field, inside the same shell — a unit such as `kg`, `%` or `円`. It is announced with the field via `aria-describedby`, so the unit does not have to be repeated in the label.
|
|
40
|
+
- `styles: { root?: string; inner?: string; icon?: string; icons?: string; iconItem?: string; iconButton?: string; }` — Custom styles for internal parts
|
|
41
|
+
- `asChild: boolean` = false — Whether to render as a child element.
|
|
42
|
+
|
|
43
|
+
---
|
|
44
|
+
Setup, composition rules and the full catalog: `llms.txt` / `llms-full.txt` in the same package.
|
|
@@ -0,0 +1,40 @@
|
|
|
1
|
+
# SegmentedControl — wimui
|
|
2
|
+
|
|
3
|
+
> Button-style controls for switching between a small set of mutually exclusive options
|
|
4
|
+
|
|
5
|
+
Also known as: Segmented Buttons, Segmented Picker
|
|
6
|
+
|
|
7
|
+
## Import
|
|
8
|
+
|
|
9
|
+
```ts
|
|
10
|
+
import "wimui/styles.css"; // once per app — required
|
|
11
|
+
import { SegmentedControl } from "wimui/form";
|
|
12
|
+
```
|
|
13
|
+
|
|
14
|
+
## Props
|
|
15
|
+
|
|
16
|
+
- `options: Option[]` (required) — List of segment options
|
|
17
|
+
- `value: string` (required) — Selected value
|
|
18
|
+
- `onChange: (value: string) => void` (required) — Callback when the selected value changes
|
|
19
|
+
- `size: "sm" | "md" | "lg"` = "md" — Size of the control
|
|
20
|
+
- `fullWidth: boolean` = false — Whether to take full width of parent
|
|
21
|
+
- `className: string` — Additional class names
|
|
22
|
+
- `label: string` — Accessible label
|
|
23
|
+
- `error: string` — Error message
|
|
24
|
+
- `required: boolean` — Whether to show the required indicator
|
|
25
|
+
- `layout: "vertical" | "horizontal"` = "vertical" — Layout direction of label and field
|
|
26
|
+
- `disabled: boolean` = false — Whether the control is disabled
|
|
27
|
+
- `asChild: boolean` = false — If true, merge radiogroup props onto the child element.
|
|
28
|
+
- `children: React.ReactNode` — Optional children used when asChild is true
|
|
29
|
+
- `aria-label: string` — Accessible name for the radio group when no visible `label` is provided.
|
|
30
|
+
- `aria-labelledby: string` — ID of the element that labels the radio group when no visible `label` is provided.
|
|
31
|
+
- `aria-describedby: string` — ID of the element that describes the radio group. Announced together with the error message.
|
|
32
|
+
- `id: string` — Unique ID for the component
|
|
33
|
+
- `styles: { root?: string; item?: string; slider?: string; label?: string; }` — Custom styles for internal parts
|
|
34
|
+
|
|
35
|
+
## Design tokens it reads
|
|
36
|
+
|
|
37
|
+
`--wim-border-width-thick`, `--wim-color-border`, `--wim-color-focus-outline`, `--wim-color-text-accent`, `--wim-color-text-primary`, `--wim-color-text-secondary`, `--wim-control-item-padding-x-lg`, `--wim-control-item-padding-x-md`, `--wim-control-item-padding-x-sm`, `--wim-focus-outline-offset`, `--wim-font-size-icon-inner`, `--wim-font-size-lg`, `--wim-font-size-md`, `--wim-font-size-sm`, `--wim-font-weight-medium`, `--wim-height-lg`, `--wim-height-md`, `--wim-height-sm`, `--wim-line-height-normal`, `--wim-radius-component`, `--wim-radius-full`, `--wim-segmented-control-item-size-lg`, `--wim-segmented-control-item-size-md`, `--wim-segmented-control-item-size-sm`, `--wim-spacing-2xs`, `--wim-spacing-sm`, `--wim-tap-target-min`, `--wim-transition-fast`
|
|
38
|
+
|
|
39
|
+
---
|
|
40
|
+
Setup, composition rules and the full catalog: `llms.txt` / `llms-full.txt` in the same package.
|