wimui 0.77.0 → 0.79.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/README.ja.md +2 -2
- package/README.md +2 -2
- package/dist/components/ai/InteractiveGraph/InteractiveGraph.cjs +1 -1
- package/dist/components/ai/InteractiveGraph/InteractiveGraph.js +22 -37
- package/dist/components/ai/InteractiveGraph/interactive-graph.module.cjs +1 -1
- package/dist/components/ai/InteractiveGraph/interactive-graph.module.js +1 -1
- package/dist/components/data-display/DataGrid/DataGrid.cjs +1 -1
- package/dist/components/data-display/DataGrid/DataGrid.js +136 -111
- package/dist/components/data-display/DataGrid/useDataGridKeyboard.cjs +1 -1
- package/dist/components/data-display/DataGrid/useDataGridKeyboard.js +23 -23
- package/dist/components/data-display/NodeGraph/NodeGraph.cjs +1 -1
- package/dist/components/data-display/NodeGraph/NodeGraph.js +69 -66
- package/dist/components/data-display/NodeGraph/node-graph.module.cjs +1 -1
- package/dist/components/data-display/NodeGraph/node-graph.module.js +1 -1
- package/dist/components/data-display/Persona/Persona.cjs +2 -0
- package/dist/components/data-display/Persona/Persona.d.ts +71 -0
- package/dist/components/data-display/Persona/Persona.js +58 -0
- package/dist/components/data-display/Persona/persona.module.cjs +2 -0
- package/dist/components/data-display/Persona/persona.module.js +16 -0
- package/dist/components/form/Cascader/cascader.module.cjs +1 -1
- package/dist/components/form/Cascader/cascader.module.js +7 -6
- package/dist/components/form/OtpInput/OtpInput.cjs +1 -1
- package/dist/components/form/OtpInput/OtpInput.d.ts +5 -0
- package/dist/components/form/OtpInput/OtpInput.js +48 -41
- package/dist/components/form/SignaturePad/signature-pad.module.cjs +1 -1
- package/dist/components/form/SignaturePad/signature-pad.module.js +7 -6
- package/dist/components/form/Transfer/transfer.module.cjs +1 -1
- package/dist/components/form/Transfer/transfer.module.js +7 -6
- package/dist/components/form/TreeSelect/tree-select.module.cjs +1 -1
- package/dist/components/form/TreeSelect/tree-select.module.js +7 -6
- package/dist/data-display-core.d.ts +1 -0
- package/dist/data-display.cjs +1 -1
- package/dist/data-display.js +4 -3
- package/dist/i18n/generated/components.d.ts +1 -1
- package/dist/index.cjs +1 -1
- package/dist/index.js +43 -42
- package/dist/llms/Alert.md +3 -1
- package/dist/llms/Anchor.md +1 -1
- package/dist/llms/AvatarGroup.md +1 -1
- package/dist/llms/Breadcrumb.md +1 -1
- package/dist/llms/CodeDiffViewer.md +2 -0
- package/dist/llms/Combobox.md +1 -1
- package/dist/llms/CommandPalette.md +1 -1
- package/dist/llms/CopyButton.md +1 -1
- package/dist/llms/Countdown.md +2 -0
- package/dist/llms/DatePicker.md +4 -0
- package/dist/llms/DateRangePicker.md +4 -0
- package/dist/llms/DescriptionList.md +2 -0
- package/dist/llms/EmptyState.md +1 -1
- package/dist/llms/Group.md +2 -0
- package/dist/llms/Highlight.md +2 -0
- package/dist/llms/InlineEdit.md +1 -1
- package/dist/llms/InputGroup.md +2 -0
- package/dist/llms/JsonViewer.md +2 -0
- package/dist/llms/Kbd.md +2 -0
- package/dist/llms/KeyboardShortcuts.md +4 -0
- package/dist/llms/LinkButton.md +2 -0
- package/dist/llms/List.md +1 -1
- package/dist/llms/NumberInput.md +1 -1
- package/dist/llms/OtpInput.md +1 -0
- package/dist/llms/Persona.md +31 -0
- package/dist/llms/Presence.md +2 -0
- package/dist/llms/ProgressRing.md +2 -0
- package/dist/llms/Rating.md +1 -1
- package/dist/llms/SegmentedControl.md +1 -1
- package/dist/llms/Stepper.md +1 -1
- package/dist/llms/Switch.md +2 -0
- package/dist/llms/Table.md +1 -1
- package/dist/llms/TagInput.md +1 -1
- package/dist/llms/ThemeToggle.md +2 -0
- package/dist/llms/Title.md +2 -0
- package/dist/llms/TreeView.md +1 -1
- package/dist/llms-full.txt +60 -34
- package/dist/llms.txt +48 -34
- package/dist/locales/en/components.json +2 -1
- package/dist/locales/ja/components.json +2 -1
- package/dist/locales/pt/components.json +2 -1
- package/dist/reset.css +1 -1
- package/dist/styles.css +1 -1
- package/dist/wimui.umd.css +1 -1
- package/dist/wimui.umd.js +5 -5
- package/package.json +20 -17
package/dist/llms-full.txt
CHANGED
|
@@ -4,7 +4,7 @@
|
|
|
4
4
|
|
|
5
5
|
## What this is
|
|
6
6
|
|
|
7
|
-
**wimui** v0.
|
|
7
|
+
**wimui** v0.79.0 — a React 19 component library: 234 documented components across 10 categories, with design tokens, dark mode, i18n (en/ja/pt-BR) and WAI-ARIA compliant a11y. Peer deps: react ^19, react-dom ^19 (plus optional peers for specific components — see package.json).
|
|
8
8
|
|
|
9
9
|
## Install & required setup
|
|
10
10
|
|
|
@@ -763,7 +763,7 @@ The container-query wrapper div is preserved to maintain responsive column behav
|
|
|
763
763
|
- `justify: "start" | "center" | "end" | "between" | "around" | "stretch"` — Justification of items along the inline (horizontal) axis
|
|
764
764
|
- `flow: "row" | "column" | "dense" | "row dense" | "column dense"` — Grid auto-flow direction
|
|
765
765
|
- `inline: boolean` = false — Whether to render as an inline grid
|
|
766
|
-
- **Group** — Flexible grouping
|
|
766
|
+
- **Group** — Flexible grouping (aka Wrap)
|
|
767
767
|
- `asChild: boolean` — If true, the group will be rendered as its child, merging its props onto that child.
|
|
768
768
|
- `align: "start" | "center" | "end" | "stretch" | "baseline"` = "center" — Vertical alignment
|
|
769
769
|
- `justify: "start" | "center" | "end" | "between" | "around" | "evenly"` = "start" — Horizontal alignment
|
|
@@ -1108,7 +1108,7 @@ Use it when the field already does the same thing from the keyboard.
|
|
|
1108
1108
|
so the unit does not have to be repeated in the label.
|
|
1109
1109
|
- `styles: { root?: string; inner?: string; icon?: string; icons?: string; iconItem?: string; iconButton?: string; }` — Custom styles for internal parts
|
|
1110
1110
|
- `asChild: boolean` = false — Whether to render as a child element.
|
|
1111
|
-
- **Combobox** — Select with search (aka Autocomplete, Auto Complete)
|
|
1111
|
+
- **Combobox** — Select with search (aka Autocomplete, Auto Complete, Suggest)
|
|
1112
1112
|
- `options: ComboboxOption[]` = [] — List of suggestion options
|
|
1113
1113
|
- `onChange: (option: ComboboxOption) => void` — Callback when an option is selected
|
|
1114
1114
|
- `placeholder: string` — Placeholder for the input
|
|
@@ -1124,7 +1124,7 @@ so the unit does not have to be repeated in the label.
|
|
|
1124
1124
|
- `fullWidth: boolean` = false — Whether to take full width of parent
|
|
1125
1125
|
- `id: string` — Unique ID for the component
|
|
1126
1126
|
- `labels: { noResults?: React.ReactNode; }` = {} — Labels for internationalization
|
|
1127
|
-
- **CopyButton** — Copy to clipboard (aka Copy)
|
|
1127
|
+
- **CopyButton** — Copy to clipboard (aka Copy, Clipboard)
|
|
1128
1128
|
- `value: string` (required) — Text copied to the clipboard
|
|
1129
1129
|
- `size: "sm" | "md" | "lg"` = "md" — Size of the button
|
|
1130
1130
|
- `className: string` — Additional class names
|
|
@@ -1184,7 +1184,8 @@ Use it when the field already does the same thing from the keyboard.
|
|
|
1184
1184
|
`kg`, `%` or `円`. It is announced with the field via `aria-describedby`,
|
|
1185
1185
|
so the unit does not have to be repeated in the label.
|
|
1186
1186
|
- `styles: { root?: string; inner?: string; icon?: string; icons?: string; iconItem?: string; iconButton?: string; }` — Custom styles for internal parts
|
|
1187
|
-
- **DatePicker** — Date selection
|
|
1187
|
+
- **DatePicker** — Date selection (aka Date Input)
|
|
1188
|
+
- ⚠️ Not the same as elsewhere: In Blueprint, a "DatePicker" is the calendar panel shown inline — that is `Calendar` here. WIM's `DatePicker` is a text field that opens a calendar, which Blueprint calls DateInput.
|
|
1188
1189
|
- `intent: "default" | "danger"` = "default" — Semantic intent of the field (e.g. error state)
|
|
1189
1190
|
- `variant: "outline" | "ghost"` = "outline" — Visual style variant of the field
|
|
1190
1191
|
- `fullWidth: boolean` = false — Whether to take full width of parent
|
|
@@ -1204,7 +1205,8 @@ so the unit does not have to be repeated in the label.
|
|
|
1204
1205
|
- `labels: { placeholder?: string; }` — Labels for manual translation
|
|
1205
1206
|
- `width: ("xs" | "sm" | "md" | "lg" | "xl") | string | number` — Fixed width of the field (width token, CSS value, or number in px)
|
|
1206
1207
|
- `asChild: boolean` = false — Whether to render as a child element.
|
|
1207
|
-
- **DateRangePicker** — Date range selection
|
|
1208
|
+
- **DateRangePicker** — Date range selection (aka Date Range Input)
|
|
1209
|
+
- ⚠️ Not the same as elsewhere: In Blueprint, a "DateRangePicker" is the calendar panel for choosing a range — that is `RangeCalendar` here. WIM's `DateRangePicker` is a pair of date fields, which Blueprint calls DateRangeInput.
|
|
1208
1210
|
- `startProps: React.ComponentProps<typeof DatePicker>` — Props passed to the start-date DatePicker
|
|
1209
1211
|
- `endProps: React.ComponentProps<typeof DatePicker>` — Props passed to the end-date DatePicker
|
|
1210
1212
|
- `className: string` — Additional class names
|
|
@@ -1347,7 +1349,7 @@ resolution of the source image; without a bound a large photo produces a large d
|
|
|
1347
1349
|
@default 0.92
|
|
1348
1350
|
- `crossOrigin: "anonymous" | "use-credentials"` — CORS mode used to load the image. Needed to crop an image served from another origin;
|
|
1349
1351
|
the server must send matching CORS headers or the image will not load at all.
|
|
1350
|
-
- **InlineEdit** — A component that allows users to switch between a view-only mode and an editable mode in-place. (aka Editable Text, Edit In Place)
|
|
1352
|
+
- **InlineEdit** — A component that allows users to switch between a view-only mode and an editable mode in-place. (aka Editable Text, Edit In Place, Editable)
|
|
1351
1353
|
- `value: string` — Current text (controlled)
|
|
1352
1354
|
- `defaultValue: string` — Initial text (uncontrolled)
|
|
1353
1355
|
- `onChange: (value: string) => void` — Callback when the text changes while editing
|
|
@@ -1412,7 +1414,7 @@ make room rather than running underneath it.
|
|
|
1412
1414
|
- `onClear: () => void` — Callback when the clear button is clicked
|
|
1413
1415
|
- `clearAriaLabel: string` — Aria label for the clear button
|
|
1414
1416
|
- `styles: { root?: string; inner?: string; icon?: string; icons?: string; iconItem?: string; iconButton?: string; }` — Custom styles for internal parts
|
|
1415
|
-
- **InputGroup** — Inputs with icons/labels
|
|
1417
|
+
- **InputGroup** — Inputs with icons/labels (aka Control Group)
|
|
1416
1418
|
- `children: React.ReactNode` (required) — Inputs, buttons, and add-ons to combine into one unit
|
|
1417
1419
|
- `fullWidth: boolean` = false — Whether to take full width of parent
|
|
1418
1420
|
- `className: string` — Additional class names
|
|
@@ -1450,7 +1452,7 @@ Use it when the field already does the same thing from the keyboard.
|
|
|
1450
1452
|
so the unit does not have to be repeated in the label.
|
|
1451
1453
|
- `styles: { root?: string; inner?: string; icon?: string; icons?: string; iconItem?: string; iconButton?: string; }` — Custom styles for internal parts
|
|
1452
1454
|
- `asChild: boolean` = false — Whether to render as a child element.
|
|
1453
|
-
- **LinkButton** — Anchor styled as button
|
|
1455
|
+
- **LinkButton** — Anchor styled as button (aka Anchor Button)
|
|
1454
1456
|
- `iconPosition: "left" | "right"` = "left" — Position of the icon relative to the label
|
|
1455
1457
|
- `size: "sm" | "md" | "lg"` = "md" — Size of the button
|
|
1456
1458
|
- `variant: "solid" | "outline" | "ghost"` = "outline" — Visual style variant of the button
|
|
@@ -1481,7 +1483,7 @@ so the unit does not have to be repeated in the label.
|
|
|
1481
1483
|
- `aria-describedby: string` — ID of the element that describes the field
|
|
1482
1484
|
- `width: ("xs" | "sm" | "md" | "lg" | "xl") | string | number` — Fixed width of the field (width token, CSS value, or number in px)
|
|
1483
1485
|
- `fullWidth: boolean` = false — Whether to take full width of parent
|
|
1484
|
-
- **NumberInput** — Input with step adjustments (aka Spin Button, Numeric Stepper)
|
|
1486
|
+
- **NumberInput** — Input with step adjustments (aka Spin Button, Numeric Stepper, Numeric Input)
|
|
1485
1487
|
- `mode: "number" | "text"` = "number" — 'number': uses the native type="number" (e.g. quantity steppers)
|
|
1486
1488
|
'text': uses type="text" + inputmode (e.g. card numbers or IDs where leading zeros must be kept)
|
|
1487
1489
|
- `hideSpinButton: boolean` = true — Whether to hide the spin buttons
|
|
@@ -1501,6 +1503,8 @@ so the unit does not have to be repeated in the label.
|
|
|
1501
1503
|
box and receives a **1-based** position — the first box is `1`, not `0`.
|
|
1502
1504
|
- `asChild: boolean` = false — Whether to render as a child element.
|
|
1503
1505
|
- `fullWidth: boolean` = false — Whether to take full width of parent
|
|
1506
|
+
- `inputMode: "numeric" | "text"` = "numeric" — Keyboard shown on touch devices. Use `"text"` for codes that contain letters.
|
|
1507
|
+
@default "numeric"
|
|
1504
1508
|
- **PasswordInput** — Password with toggle
|
|
1505
1509
|
- `intent: "default" | "danger"` = "default" — Semantic intent of the field (e.g. error state)
|
|
1506
1510
|
- `variant: "outline" | "ghost"` = "outline" — Visual style variant of the field
|
|
@@ -1612,7 +1616,7 @@ of a radio group. Use with `description` when the options need explaining.
|
|
|
1612
1616
|
- `aria-label: string` — Accessible label when no visible label is provided
|
|
1613
1617
|
- `aria-labelledby: string` — ID of the element that labels the slider
|
|
1614
1618
|
- `asChild: boolean` = false — Whether to render as a child element.
|
|
1615
|
-
- **Rating** — Star rating (aka Star Rating, Rating Indicator, Rating Display)
|
|
1619
|
+
- **Rating** — Star rating (aka Star Rating, Rating Indicator, Rating Display, Rating Group)
|
|
1616
1620
|
- `value: number` — Current value (controlled)
|
|
1617
1621
|
- `defaultValue: number` = 0 — Default value (uncontrolled)
|
|
1618
1622
|
- `count: number` = 5 — Total number of stars
|
|
@@ -1704,7 +1708,7 @@ Use it when the field already does the same thing from the keyboard.
|
|
|
1704
1708
|
so the unit does not have to be repeated in the label.
|
|
1705
1709
|
- `styles: { root?: string; inner?: string; icon?: string; icons?: string; iconItem?: string; iconButton?: string; }` — Custom styles for internal parts
|
|
1706
1710
|
- `asChild: boolean` = false — Whether to render as a child element.
|
|
1707
|
-
- **SegmentedControl** — Button-style controls for switching between a small set of mutually exclusive options (aka Segmented Buttons, Segmented Picker, Content Switcher)
|
|
1711
|
+
- **SegmentedControl** — Button-style controls for switching between a small set of mutually exclusive options (aka Segmented Buttons, Segmented Picker, Content Switcher, Segment Group)
|
|
1708
1712
|
- `options: Option[]` (required) — List of segment options
|
|
1709
1713
|
- `value: string` (required) — Selected value
|
|
1710
1714
|
- `onChange: (value: string) => void` (required) — Callback when the selected value changes
|
|
@@ -1808,6 +1812,7 @@ so the unit does not have to be repeated in the label.
|
|
|
1808
1812
|
- `toggleLabel: string` (required) — Accessible name for the toggle half. The main half is named by its own text,
|
|
1809
1813
|
but the toggle only shows a chevron, so it needs one of its own.
|
|
1810
1814
|
- **Switch** — A binary switch for instantly toggling settings between on and off states (aka Toggle, Toggle Switch)
|
|
1815
|
+
- ⚠️ Not the same as elsewhere: In Radix, shadcn/ui and Ark UI, a "Toggle" is a button that stays pressed (`aria-pressed`) — use a one-item `ToggleGroup` here. WIM's `Switch` is the on/off control that Apple and Material call a toggle.
|
|
1811
1816
|
- `asChild: boolean` = false — If true, the component will be rendered as its child, merging its props onto that child.
|
|
1812
1817
|
- `size: "sm" | "md" | "lg"` = "md" — Size of the switch
|
|
1813
1818
|
- `className: string` — Additional class names
|
|
@@ -1825,7 +1830,7 @@ but the toggle only shows a chevron, so it needs one of its own.
|
|
|
1825
1830
|
- `error: string` — Error message
|
|
1826
1831
|
- `required: boolean` — Whether to show the required indicator
|
|
1827
1832
|
- `disabled: boolean` — Whether the whole group is disabled
|
|
1828
|
-
- **TagInput** — Input field for creating free-form tags. (aka Token Field, Chips Input)
|
|
1833
|
+
- **TagInput** — Input field for creating free-form tags. (aka Token Field, Chips Input, Tags Input)
|
|
1829
1834
|
- `value: string[]` — List of tags (controlled)
|
|
1830
1835
|
- `defaultValue: string[]` = [] — Initial list of tags (uncontrolled)
|
|
1831
1836
|
- `onChange: (tags: string[]) => void` — Callback when the tags change
|
|
@@ -1852,7 +1857,7 @@ but the toggle only shows a chevron, so it needs one of its own.
|
|
|
1852
1857
|
- `required: boolean` — Whether to show the required indicator
|
|
1853
1858
|
- `layout: "vertical" | "horizontal"` — Layout direction of label and field
|
|
1854
1859
|
- `width: ("xs" | "sm" | "md" | "lg" | "xl") | string | number` — Fixed width of the field (width token, CSS value, or number in px)
|
|
1855
|
-
- **ThemeToggle** — Light / dark / system theme switcher
|
|
1860
|
+
- **ThemeToggle** — Light / dark / system theme switcher (aka Animated Theme Toggler)
|
|
1856
1861
|
- `value: "light" | "dark" | "system"` — Selected mode (controlled)
|
|
1857
1862
|
- `defaultValue: "light" | "dark" | "system"` = "system" — Initially selected mode (uncontrolled)
|
|
1858
1863
|
- `onChange: (mode: ("light" | "dark" | "system")) => void` — Callback when the mode changes
|
|
@@ -1960,7 +1965,8 @@ so the unit does not have to be repeated in the label.
|
|
|
1960
1965
|
|
|
1961
1966
|
### feedback — `import { … } from "wimui/feedback"`
|
|
1962
1967
|
|
|
1963
|
-
- **Alert** — Important messages (aka Message Bar)
|
|
1968
|
+
- **Alert** — Important messages (aka Message Bar, Callout)
|
|
1969
|
+
- ⚠️ Not the same as elsewhere: In Fluent UI v8, a "Callout" is a popup anchored to an element — that is `Popover` here. WIM's `Alert` matches Blueprint's Callout: an inline message in the page flow.
|
|
1964
1970
|
- `title: React.ReactNode` — Title of the alert
|
|
1965
1971
|
- `titleTag: "h1" | "h2" | "h3" | "h4" | "h5" | "h6" | "div" | "p" | "strong" | "span"` = "div" — HTML tag used for the alert title.
|
|
1966
1972
|
|
|
@@ -2083,7 +2089,7 @@ type therefore requires one of `label` / `aria-label` / `aria-labelledby`.
|
|
|
2083
2089
|
@default false
|
|
2084
2090
|
- `indeterminate: boolean` = false — If true, shows an indeterminate animation instead of a value.
|
|
2085
2091
|
@default false
|
|
2086
|
-
- **ProgressRing** — ProgressRing description.
|
|
2092
|
+
- **ProgressRing** — ProgressRing description. (aka Progress Circle, Animated Circular Progress Bar)
|
|
2087
2093
|
- `value: number` = 0 — Current value of the progress ring.
|
|
2088
2094
|
@default 0
|
|
2089
2095
|
- `max: number` = 100 — Maximum value of the progress ring.
|
|
@@ -2194,7 +2200,7 @@ follows the theme and never needs a hand-mixed colour.
|
|
|
2194
2200
|
- `children: React.ReactNode` (required) — Children to be rendered inside the affix
|
|
2195
2201
|
- `className: string` — Additional class names
|
|
2196
2202
|
- `style: React.CSSProperties` — Style attribute
|
|
2197
|
-
- **Anchor** — Smooth scroll links (aka Scrollspy, Table of Contents, TableOfContents)
|
|
2203
|
+
- **Anchor** — Smooth scroll links (aka Scrollspy, Table of Contents, TableOfContents, TOC)
|
|
2198
2204
|
- `items: AnchorLinkItem[]` = [] — Array of anchor link configurations
|
|
2199
2205
|
- `bounds: number` = 5 — Bounding distance (in pixels) for triggering active state
|
|
2200
2206
|
- `offset: number` = 0 — Offset (in pixels) from top when clicking to scroll
|
|
@@ -2214,7 +2220,7 @@ follows the theme and never needs a hand-mixed colour.
|
|
|
2214
2220
|
- `aria-labelledby: string` — ID of the element that labels the button. Takes precedence over `aria-label`.
|
|
2215
2221
|
- `aria-describedby: string` — ID of the element that describes the button.
|
|
2216
2222
|
- `asChild: boolean` = false — Whether to render as a child element.
|
|
2217
|
-
- **Breadcrumb** — Location trace (aka Path Bar, Path Control)
|
|
2223
|
+
- **Breadcrumb** — Location trace (aka Path Bar, Path Control, Breadcrumbs)
|
|
2218
2224
|
- `items: BreadcrumbItem[]` (required) — Items to display, from the root to the current page.
|
|
2219
2225
|
- `separator: React.ReactNode` — Separator displayed between items. Defaults to a chevron icon.
|
|
2220
2226
|
- `size: "sm" | "md" | "lg"` = "md" — Size of the breadcrumb.
|
|
@@ -2230,7 +2236,7 @@ into a "…" button that lists them.
|
|
|
2230
2236
|
- `asChild: boolean` — If true, the breadcrumb will be rendered as its child, merging its props onto that child.
|
|
2231
2237
|
- `children: React.ReactNode` — The element that becomes the breadcrumb's root (in place of `nav`) when
|
|
2232
2238
|
`asChild` is set. The list of items is rendered inside it. Ignored without `asChild`.
|
|
2233
|
-
- **CommandPalette** — Cmd+K search overlay (aka Command Bar, Quick Open)
|
|
2239
|
+
- **CommandPalette** — Cmd+K search overlay (aka Command Bar, Quick Open, Omnibar, Command)
|
|
2234
2240
|
- `children: ReactNode` (required) — Palette parts (CommandPaletteTrigger, CommandPaletteContent, etc.).
|
|
2235
2241
|
- `open: boolean` — Controlled open state. Use together with onOpenChange.
|
|
2236
2242
|
- `onOpenChange: (open: boolean) => void` — Called with the next state when the palette is opened or closed.
|
|
@@ -2245,7 +2251,8 @@ button. Without this callback the button cannot close on Escape, because `open`
|
|
|
2245
2251
|
- `color: string` — Color of the bars
|
|
2246
2252
|
- `visibleBelow: "xs" | "sm" | "md" | "lg" | "xl"` — Show only below the given breakpoint (e.g. "md" matches Sidebar's mobile drawer range)
|
|
2247
2253
|
- `className: string` — Custom class name
|
|
2248
|
-
- **KeyboardShortcuts** — Display a structured list of keyboard shortcuts
|
|
2254
|
+
- **KeyboardShortcuts** — Display a structured list of keyboard shortcuts (aka Hotkeys)
|
|
2255
|
+
- ⚠️ Not the same as elsewhere: Blueprint's Hotkeys also registers the key bindings. WIM's `KeyboardShortcuts` only shows the list of shortcuts; bind the keys in your app.
|
|
2249
2256
|
- `shortcuts: ShortcutItem[]` (required) — List of shortcuts to display
|
|
2250
2257
|
- `title: string` — Section title
|
|
2251
2258
|
- `titleLevel: 2 | 3 | 4 | 5 | 6` — `title` を見出しとして描くときの段(T211)。渡さなければ見出しにならず `p` のまま。
|
|
@@ -2316,7 +2323,7 @@ near the right edge pushes the page into a horizontal scroll. Anchor a
|
|
|
2316
2323
|
- `aria-label: string` — Accessible name for the trigger button.
|
|
2317
2324
|
Lands on the inner `FloatButton`, not on the wrapper `div`.
|
|
2318
2325
|
Defaults to a translated "Open menu" / "Close menu" (en / ja / pt), following the open state.
|
|
2319
|
-
- **Stepper** — Visual sequence steps (aka Progress Indicator)
|
|
2326
|
+
- **Stepper** — Visual sequence steps (aka Progress Indicator, Steps)
|
|
2320
2327
|
- ⚠️ 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.
|
|
2321
2328
|
- `steps: Step[]` = [] — Array of step configurations
|
|
2322
2329
|
- `current: number` = 0 — Index of the current active step (0-indexed)
|
|
@@ -2374,7 +2381,7 @@ scans stay green while the bar hangs outside its parent.
|
|
|
2374
2381
|
- `size: "sm" | "md" | "lg"` = "md" — Size of the avatar
|
|
2375
2382
|
- `shape: "circle" | "rounded"` = "circle" — Shape of the avatar
|
|
2376
2383
|
- `intent: "primary" | "success" | "warning" | "danger" | "info" | "neutral"` — Intent (semantic color) applied to the avatar
|
|
2377
|
-
- **AvatarGroup** — Stacked avatars (aka Face Pile)
|
|
2384
|
+
- **AvatarGroup** — Stacked avatars (aka Face Pile, Avatar Circles)
|
|
2378
2385
|
- `children: React.ReactNode` (required) — Avatar elements to group
|
|
2379
2386
|
- `max: number` — Maximum number of avatars to show before collapsing into a count. Ignored with `overflow="collapse"`.
|
|
2380
2387
|
- `size: "sm" | "md" | "lg"` = "md" — Size applied to the avatars
|
|
@@ -2510,7 +2517,7 @@ body rather than appearing alongside it.
|
|
|
2510
2517
|
- `onDelete: (id: string) => void` — Shows a Delete button when set.
|
|
2511
2518
|
- `actions: React.ReactNode` — Extra actions, placed after the built-in ones.
|
|
2512
2519
|
- `className: string` — Additional class names
|
|
2513
|
-
- **Countdown** — Display the remaining time until a target moment as a live ticking timer, for sale deadlines, OTP resend waits, and maintenance notices.
|
|
2520
|
+
- **Countdown** — Display the remaining time until a target moment as a live ticking timer, for sale deadlines, OTP resend waits, and maintenance notices. (aka Timer)
|
|
2514
2521
|
- `target: Date | string | number` (required) — The moment the countdown ends, as a Date object, ISO 8601 string,
|
|
2515
2522
|
or epoch milliseconds.
|
|
2516
2523
|
- `baseDate: Date | string | number` — Reference point used as "now". When set, the countdown is frozen at
|
|
@@ -2561,14 +2568,14 @@ drops secondary text below the AA contrast floor.
|
|
|
2561
2568
|
- `ariaLabel: string` — Accessibility label for the grid
|
|
2562
2569
|
- `aria-label: string` — Accessible name for the grid. Takes precedence over `ariaLabel`.
|
|
2563
2570
|
- `aria-labelledby: string` — ID of the element that labels the grid. Takes precedence over `aria-label`.
|
|
2564
|
-
- **DescriptionList** — Key-value pairs
|
|
2571
|
+
- **DescriptionList** — Key-value pairs (aka Data List)
|
|
2565
2572
|
- `children: React.ReactNode` (required) — DescriptionListItem elements
|
|
2566
2573
|
- `className: string` — Additional class names
|
|
2567
2574
|
- `layout: "horizontal" | "vertical" | "compact"` = "horizontal" — Layout of terms and descriptions
|
|
2568
2575
|
- `size: "sm" | "md" | "lg"` = "md" — Size of the text
|
|
2569
2576
|
- `border: boolean` = false — Whether to show borders (alias of bordered)
|
|
2570
2577
|
- `bordered: boolean` = false — Whether to show borders
|
|
2571
|
-
- **EmptyState** — Missing data placeholder (aka Blank Slate, Zero State)
|
|
2578
|
+
- **EmptyState** — Missing data placeholder (aka Blank Slate, Zero State, Non-Ideal State)
|
|
2572
2579
|
- `title: React.ReactNode` (required) — Title to display.
|
|
2573
2580
|
- `description: React.ReactNode` — Description text to display.
|
|
2574
2581
|
- `icon: React.ReactNode` — Icon to display.
|
|
@@ -2601,7 +2608,7 @@ in; use `"center"` only when the empty state is the only thing in its region.
|
|
|
2601
2608
|
- `after: unknown` (required) — JSON value after the change
|
|
2602
2609
|
- `indent: number` = 2 — Indentation spaces for JSON.stringify (default: 2)
|
|
2603
2610
|
- `view: "split" | "unified"` — Display mode inherited from CodeDiffViewer
|
|
2604
|
-
- **JsonViewer** — Recursive tree viewer and editor for JSON data.
|
|
2611
|
+
- **JsonViewer** — Recursive tree viewer and editor for JSON data. (aka JSON Tree View)
|
|
2605
2612
|
- `data: unknown` (required) — The JSON data to display
|
|
2606
2613
|
- `expandDepth: number` = 1 — Initial depth to expand
|
|
2607
2614
|
- `showCopy: boolean` = true — If true, show copy button
|
|
@@ -2620,7 +2627,7 @@ Without it, pointer devices show the move button in the card's corner on hover o
|
|
|
2620
2627
|
- `unit: string` — Label for the score unit
|
|
2621
2628
|
- `size: "sm" | "md" | "lg"` = "md" — Size
|
|
2622
2629
|
- `showMedals: boolean` = false — Whether to paint the rank badges of the top three in gold, silver and bronze (off by default: the number and the order already say the rank)
|
|
2623
|
-
- **List** — Structurally organized items in bullet points or numbered formats (aka Contained List, Ordered List, Unordered List)
|
|
2630
|
+
- **List** — Structurally organized items in bullet points or numbered formats (aka Contained List, Ordered List, Unordered List, Card List)
|
|
2624
2631
|
- `asChild: boolean` = false — Whether to render as a child element.
|
|
2625
2632
|
- `size: "sm" | "md" | "lg"` = "md" — Size of the list items
|
|
2626
2633
|
- `spacing: "tight" | "normal" | "loose"` = "normal" — Spacing between items
|
|
@@ -2660,6 +2667,17 @@ When omitted, both Backspace and Delete work.
|
|
|
2660
2667
|
- `defaultEdgeOptions: DefaultEdgeOptions` — Default options applied to new edges
|
|
2661
2668
|
- `className: string` — Additional CSS class
|
|
2662
2669
|
- `aria-label: string` — Accessible label for the graph region
|
|
2670
|
+
- **Persona** — Shows a person as one unit: avatar, name and up to two lines of description, with text sizes matched to the avatar. The name is read once.
|
|
2671
|
+
- `name: React.ReactNode` (required) — The person's name. Read once; the avatar is never given the name as its alternative text.
|
|
2672
|
+
- `description: React.ReactNode` — First line under the name, such as a role or a team.
|
|
2673
|
+
- `secondaryDescription: React.ReactNode` — Second line under the name, smaller and quieter, such as a status or a time.
|
|
2674
|
+
- `avatar: { /** Image source URL. */ src?: string; /** Initials shown when there is no image. */ initials?: string; /** Icon shown when there is no image and no initials. */ icon?: React.ReactNode; }` — What the avatar shows. The avatar is decorative: the name next to it
|
|
2675
|
+
already says who it is.
|
|
2676
|
+
- `presence: "online" | "away" | "busy" | "offline"` — Presence shown on the avatar. Announced right after the name.
|
|
2677
|
+
- `size: "sm" | "md" | "lg"` = "md" — Size of the avatar. The name and description sizes and the gaps follow it.
|
|
2678
|
+
@default "md"
|
|
2679
|
+
- `textPosition: "after" | "below"` = "after" — Where the text sits relative to the avatar.
|
|
2680
|
+
@default "after"
|
|
2663
2681
|
- **PivotTable** — Draws aggregated data as a table with multi-level row and column headings, subtotals and grand totals. (aka Pivot, Cross Tab, Crosstab)
|
|
2664
2682
|
- `rows: PivotTableAxisNode[]` (required) — The row axis as a tree. Groups are drawn as an outline: one indented row per node.
|
|
2665
2683
|
- `columns: PivotTableAxisNode[]` (required) — The column axis as a tree. Groups become headings that span their columns.
|
|
@@ -2693,6 +2711,7 @@ with empty spacer rows. Use it for tables with hundreds of rows, together with
|
|
|
2693
2711
|
- `totalColumn: boolean` = false — Adds a grand total column at the right edge.
|
|
2694
2712
|
- `labels: { /** Heading of the grand total row / column and of each subtotal column. */ total?: string; }` — Text of the total headings, for when the built-in translations do not fit.
|
|
2695
2713
|
- **Presence** — Shows whether a person is online, away, busy, or offline.
|
|
2714
|
+
- ⚠️ Not the same as elsewhere: In Ark UI and Chakra UI, "Presence" is the helper that animates an element in and out as it mounts and unmounts — that is `Transition` here. WIM's `Presence` shows whether a person is online, away, busy or offline.
|
|
2696
2715
|
- `status: "online" | "away" | "busy" | "offline"` (required) — Availability of the person or resource.
|
|
2697
2716
|
- `label: string` — Text for the status. Defaults to the localized name of `status`.
|
|
2698
2717
|
- `showLabel: boolean` = false — Whether the label is shown next to the dot. The label is always exposed to
|
|
@@ -2818,7 +2837,7 @@ or by keyboard focus on its actions, closes the others.
|
|
|
2818
2837
|
- `fullSwipe: "left" | "right" | "both"` — Sides where swiping all the way across runs the outermost action without a tap
|
|
2819
2838
|
(`leftActions[0]` / the last of `rightActions`), as in iOS Mail. Off by default so a
|
|
2820
2839
|
destructive action is never triggered by momentum; the action stays available as a button.
|
|
2821
|
-
- **Table** — Rows and columns for displaying structured data efficiently (aka Structured List)
|
|
2840
|
+
- **Table** — Rows and columns for displaying structured data efficiently (aka Structured List, HTML Table)
|
|
2822
2841
|
- `asChild: boolean` = false — Whether to render as a child element.
|
|
2823
2842
|
- `striped: boolean` = false — Whether to show striped (zebra) rows
|
|
2824
2843
|
- `bordered: boolean` = false — Whether to show borders between cells
|
|
@@ -2865,7 +2884,7 @@ this is given; without it the diagram is read-only.
|
|
|
2865
2884
|
anything is measured; long text is truncated and read in full by assistive technology.
|
|
2866
2885
|
- `nodeHeight: number` = 64 — Card height in px.
|
|
2867
2886
|
- `labels: { /** Accessible name of the collapse / expand button. */ expand?: (label: string) => string; collapse?: (label: string) => string; }` — Accessible names of the collapse / expand button, for when the built-in translations do not fit.
|
|
2868
|
-
- **TreeView** — Hierarchical data (aka Outline View, Tree, Flat Tree)
|
|
2887
|
+
- **TreeView** — Hierarchical data (aka Outline View, Tree, Flat Tree, File Tree)
|
|
2869
2888
|
- `children: React.ReactNode` — JSX-based items (children API). Use this when not using `nodes`.
|
|
2870
2889
|
- `nodes: TreeViewNode[]` — Node array for data-driven mode.
|
|
2871
2890
|
- `className: string` — Additional class names
|
|
@@ -3024,14 +3043,14 @@ is marked.
|
|
|
3024
3043
|
- `block: boolean` = false — If true, renders as a block (`<pre>`) instead of inline.
|
|
3025
3044
|
@default false
|
|
3026
3045
|
- `language: string` — Language identifier appended as a `language-<lang>` class for syntax highlighters.
|
|
3027
|
-
- **Highlight** — Text highlighting
|
|
3046
|
+
- **Highlight** — Text highlighting (aka Mark, Highlighter)
|
|
3028
3047
|
- `children: React.ReactNode` (required) — The full text to highlight substrings in.
|
|
3029
3048
|
- `highlight: string | string[]` (required) — Substring(s) to highlight.
|
|
3030
3049
|
- `highlightClassName: string` — Custom class name for the highlighted `<mark>` element.
|
|
3031
3050
|
- `highlightStyles: React.CSSProperties` — Custom styles for the highlighted `<mark>` element.
|
|
3032
3051
|
- `as: React.ElementType` = "span" — The HTML tag or component to use for the container. Default is "span".
|
|
3033
3052
|
- `asChild: boolean` = false — If true, the component will be rendered as its child.
|
|
3034
|
-
- **Kbd** — Keyboard shortcuts
|
|
3053
|
+
- **Kbd** — Keyboard shortcuts (aka Key Combo)
|
|
3035
3054
|
- `asChild: boolean` = false — If true, the Kbd will be rendered as its child, merging its props onto that child.
|
|
3036
3055
|
- `size: "sm" | "md" | "lg"` = "md" — Size of the key cap.
|
|
3037
3056
|
@default "md"
|
|
@@ -3116,7 +3135,7 @@ used for "just stop at three lines".
|
|
|
3116
3135
|
|
|
3117
3136
|
Ignored when `truncate` is set (one line wins; they cannot both apply).
|
|
3118
3137
|
- `content: React.ReactNode` — Content of the text. Alternative to children (children take precedence only with asChild).
|
|
3119
|
-
- **Title** — Possesses visual weight (boldness/size) to indicate page structure.
|
|
3138
|
+
- **Title** — Possesses visual weight (boldness/size) to indicate page structure. (aka Heading)
|
|
3120
3139
|
- `asChild: boolean` = false — If true, the heading will be rendered as its child, merging its props onto that child.
|
|
3121
3140
|
- `tag: "h1" | "h2" | "h3" | "h4" | "h5" | "h6"` = "h1" — The semantic HTML tag to use.
|
|
3122
3141
|
- `size: "xs" | "sm" | "md" | "lg" | "xl" | "2xl" | "3xl" | "4xl"` = "xl" — The visual size of the title.
|
|
@@ -3537,7 +3556,7 @@ to a heading or in the corner of a card.
|
|
|
3537
3556
|
Pass a CSS value (e.g. "300px") or a number of lines (e.g. 20).
|
|
3538
3557
|
When set, an expand/collapse toggle is shown.
|
|
3539
3558
|
- `className: string` — Additional CSS class
|
|
3540
|
-
- **CodeDiffViewer** — Displays code changes as a side-by-side or unified diff, with line-level highlighting and Apply/Reject actions.
|
|
3559
|
+
- **CodeDiffViewer** — Displays code changes as a side-by-side or unified diff, with line-level highlighting and Apply/Reject actions. (aka Code Comparison)
|
|
3541
3560
|
- `before: string` (required) — Code before the change
|
|
3542
3561
|
- `after: string` (required) — Code after the change
|
|
3543
3562
|
- `language: string` — Language label shown in header
|
|
@@ -3773,9 +3792,16 @@ Exported hooks. Prefer them over hand-rolled equivalents (`matchMedia` listeners
|
|
|
3773
3792
|
These exist in other systems' vocabularies and are **decisions, not gaps**. Do not hand-roll them into a wimui screen; the alternative given is the supported way to express the same intent.
|
|
3774
3793
|
|
|
3775
3794
|
- **Parallax Scrolling** (aka Parallax, Scroll Parallax, Parallax Hero) — Backgrounds moving at a different speed from the foreground. The motion does not correspond to any change of state, which is what this system animates. If the goal is to show scroll position, show the position. Use `ScrollProgress` instead.
|
|
3776
|
-
- **Text Scramble** (aka Scramble Text, Decrypt Text, Glitch Text) — Randomising characters before settling on the real string. The reader parses the same sentence twice and gets nothing for the lost legibility. The one case where text legitimately arrives character by character is model output, which StreamingText already covers. Use `StreamingText` instead.
|
|
3795
|
+
- **Text Scramble** (aka Scramble Text, Decrypt Text, Glitch Text, Hyper Text) — Randomising characters before settling on the real string. The reader parses the same sentence twice and gets nothing for the lost legibility. The one case where text legitimately arrives character by character is model output, which StreamingText already covers. Use `StreamingText` instead.
|
|
3777
3796
|
- **Spring Animation** (aka Spring Physics, Springs, Physics-based Animation) — A physics engine (mass / stiffness / damping props solved in a rAF loop). The bounce curve itself already exists as the `--wim-easing-spring` token, which is what press and swipe-return use. Adding the engine would put physics parameters into the public contract and move motion from CSS to JS. Use `--wim-easing-spring` instead.
|
|
3778
3797
|
- **Choropleth Map** (aka Choropleth, Filled Map, Region Map, Geo Map) — A map shading regions by value. Shipping boundary data would put its size and a political stance on disputed borders into a UI library, and large regions dominate regardless of their values. Regions are compared more accurately in a sorted bar chart. Use `BarChart` instead.
|
|
3798
|
+
- **Animated Text Effects** (aka Animated Gradient Text, Animated Shiny Text, Aurora Text, Morphing Text, Sparkles Text, Spinning Text, Text Reveal, Typing Animation, Word Rotate, Line Shadow Text, Comic Text, Kinetic Text, Video Text, Text 3D Flip, Text Animate, Dia Text Reveal) — Text that shimmers, rotates, morphs or types itself out. It cannot be read while it moves, and keeps moving after it has been read. Emphasis is a matter of weight, colour and size; the one case where text legitimately arrives piece by piece is model output, which StreamingText covers. Use `Text` instead.
|
|
3799
|
+
- **Decorative Background Pattern** (aka Dot Pattern, Grid Pattern, Animated Grid Pattern, Interactive Grid Pattern, Flickering Grid, Hexagon Pattern, Striped Pattern, Retro Grid, Noise Texture, Dither Field, Light Rays, Meteors, Particles, Warp Background, Glyph Matrix, Backlight, Floating 3D Particles, Ripple) — Patterns and particles laid behind content that carry no meaning of their own. They make the background under text uneven, which costs contrast, and moving ones compete with real motion in the foreground. Separate surfaces with the surface tokens and borders instead. Use `Box` instead.
|
|
3800
|
+
- **Animated Button Effects** (aka Shimmer Button, Shiny Button, Rainbow Button, Pulsating Button, Ripple Button, Interactive Hover Button, Animated Subscribe Button, Confetti, Cool Mode) — Buttons that shimmer, pulse, ripple or burst into confetti. They only attract attention before the click, and once several buttons do it the primary action is lost. Rank actions with Button variants, and report the result through the state change and an announcement. Use `Button` instead.
|
|
3801
|
+
- **Glow and Spotlight Card** (aka Magic Card, Neon Gradient Card, Shine Border, Glare Hover, Lens, Progressive Blur, Blur Fade, Pixel Image) — Cards with glowing borders, a spotlight that follows the pointer, or content that fades in from a blur. Nothing happens for touch or keyboard users, and for pointer users it does not help tell the cards apart. Use Card variants and the heading inside the card. Use `Card` instead.
|
|
3802
|
+
- **Device Mockup** (aka iPhone Mockup, Android Mockup, Safari Mockup, Browser Frame, Device Frame) — Phone and browser frames around a screenshot. It is marketing artwork rather than an interface component, and the frames go out of date with every device generation. Show the screenshot with Image, with the frame baked into the image if one is needed. Use `Image` instead.
|
|
3803
|
+
- **Decorative Motion Graphics** (aka Globe, Icon Cloud, Orbiting Circles, Animated Beam, Dock, Scroll Based Velocity, Animated List, Dotted Map, Smooth Cursor, Pointer Effect, Hero Video Dialog) — Spinning globes, floating icon clouds, beams between logos, a magnifying dock, a custom cursor: motion that carries no information. It pulls attention away from the content and is a burden for people who reduce motion. Show relationships with NodeGraph, items with List, and a video with Video inside a Dialog. Use `List` instead.
|
|
3804
|
+
- **Social Post Embed** (aka Tweet Card, Client Tweet Card, Tweet Embed) — Embedding a post from a social network in that network's own look. Its appearance and the way it is fetched change on the provider's schedule, which a design system cannot keep up with. Quote it in a Blockquote or Card with a link to the source. Use `Card` instead.
|
|
3779
3805
|
|
|
3780
3806
|
---
|
|
3781
3807
|
**One component, matching your installed version:** the package ships `dist/llms/<Component>.md` — every prop with its type and default, its sub-components, and the design tokens it reads (e.g. `node_modules/wimui/dist/llms/Select.md`, also exported as `wimui/llms/Select.md`). The hosted copy of this file tracks main and can be ahead of the release you installed.
|
package/dist/llms.txt
CHANGED
|
@@ -4,7 +4,7 @@
|
|
|
4
4
|
|
|
5
5
|
## What this is
|
|
6
6
|
|
|
7
|
-
**wimui** v0.
|
|
7
|
+
**wimui** v0.79.0 — a React 19 component library: 234 documented components across 10 categories, with design tokens, dark mode, i18n (en/ja/pt-BR) and WAI-ARIA compliant a11y. Peer deps: react ^19, react-dom ^19 (plus optional peers for specific components — see package.json).
|
|
8
8
|
|
|
9
9
|
## Install & required setup
|
|
10
10
|
|
|
@@ -213,7 +213,7 @@ export function BillingOverview() {
|
|
|
213
213
|
- **Flex** — Flexible layout
|
|
214
214
|
- **Footer** — Lower navigation
|
|
215
215
|
- **Grid** — Flexbox or CSS Grid system
|
|
216
|
-
- **Group** — Flexible grouping
|
|
216
|
+
- **Group** — Flexible grouping (aka Wrap)
|
|
217
217
|
- **Header** — Upper navigation
|
|
218
218
|
- **InteractiveArea** — Foundation component for consistent interactive areas with borders and states.
|
|
219
219
|
- **Masonry** — Waterfall grid
|
|
@@ -239,12 +239,14 @@ export function BillingOverview() {
|
|
|
239
239
|
- **CheckboxGroup** — Shared state checkboxes
|
|
240
240
|
- **ColorInput** — Input with color preview (aka Color Well, Color Field)
|
|
241
241
|
- **ColorPicker** — Color selection picker (aka Swatch Picker)
|
|
242
|
-
- **Combobox** — Select with search (aka Autocomplete, Auto Complete)
|
|
243
|
-
- **CopyButton** — Copy to clipboard (aka Copy)
|
|
242
|
+
- **Combobox** — Select with search (aka Autocomplete, Auto Complete, Suggest)
|
|
243
|
+
- **CopyButton** — Copy to clipboard (aka Copy, Clipboard)
|
|
244
244
|
- **CounterTextarea** — Textarea with character count display
|
|
245
245
|
- **CreditCardInput** — Payment card input with brand detection
|
|
246
|
-
- **DatePicker** — Date selection
|
|
247
|
-
-
|
|
246
|
+
- **DatePicker** — Date selection (aka Date Input)
|
|
247
|
+
- ⚠️ Not the same as elsewhere: In Blueprint, a "DatePicker" is the calendar panel shown inline — that is `Calendar` here. WIM's `DatePicker` is a text field that opens a calendar, which Blueprint calls DateInput.
|
|
248
|
+
- **DateRangePicker** — Date range selection (aka Date Range Input)
|
|
249
|
+
- ⚠️ Not the same as elsewhere: In Blueprint, a "DateRangePicker" is the calendar panel for choosing a range — that is `RangeCalendar` here. WIM's `DateRangePicker` is a pair of date fields, which Blueprint calls DateRangeInput.
|
|
248
250
|
- **Dropzone** — Drag & drop files
|
|
249
251
|
- **FieldError** — Validation messages
|
|
250
252
|
- **Fieldset** — Form grouping (aka Form Group)
|
|
@@ -253,15 +255,15 @@ export function BillingOverview() {
|
|
|
253
255
|
- **FloatButton** — Floating action buttons
|
|
254
256
|
- **IconButton** — A square button containing only an icon without a text label.
|
|
255
257
|
- **ImageCropper** — Front-end image cropping and rotation tool.
|
|
256
|
-
- **InlineEdit** — A component that allows users to switch between a view-only mode and an editable mode in-place. (aka Editable Text, Edit In Place)
|
|
258
|
+
- **InlineEdit** — A component that allows users to switch between a view-only mode and an editable mode in-place. (aka Editable Text, Edit In Place, Editable)
|
|
257
259
|
- **Input** — Single-line input fields for text, numbers, or emails (aka Text Input)
|
|
258
260
|
- **InputBase** — Standardizes the visual container, icon slots (Prefix/Suffix), and clear button behavior for text-based inputs.
|
|
259
|
-
- **InputGroup** — Inputs with icons/labels
|
|
261
|
+
- **InputGroup** — Inputs with icons/labels (aka Control Group)
|
|
260
262
|
- **InputMask** — Formatted inputs
|
|
261
|
-
- **LinkButton** — Anchor styled as button
|
|
263
|
+
- **LinkButton** — Anchor styled as button (aka Anchor Button)
|
|
262
264
|
- **Mentions** — @ / # suggestions
|
|
263
265
|
- **MultiSelect** — Multiple selection (aka Tag Picker)
|
|
264
|
-
- **NumberInput** — Input with step adjustments (aka Spin Button, Numeric Stepper)
|
|
266
|
+
- **NumberInput** — Input with step adjustments (aka Spin Button, Numeric Stepper, Numeric Input)
|
|
265
267
|
- **OtpInput** — One-time password fields (aka Pin Input, Input OTP, PIN Code Input)
|
|
266
268
|
- **PasswordInput** — Password with toggle
|
|
267
269
|
- **PasswordStrength** — Visual meter to indicate password security level. (aka Strength Meter)
|
|
@@ -270,20 +272,21 @@ export function BillingOverview() {
|
|
|
270
272
|
- **Radio** — Single choice (aka Radio Button)
|
|
271
273
|
- **RadioGroup** — Shared state radio buttons (aka Radio Button Group)
|
|
272
274
|
- **RangeSlider** — Range selection
|
|
273
|
-
- **Rating** — Star rating (aka Star Rating, Rating Indicator, Rating Display)
|
|
275
|
+
- **Rating** — Star rating (aka Star Rating, Rating Indicator, Rating Display, Rating Group)
|
|
274
276
|
- **RichTextEditor** — WYSIWYG rich text editor
|
|
275
277
|
- **SearchInput** — Search with clear button (aka Search Field, Search Bar, Search Box)
|
|
276
|
-
- **SegmentedControl** — Button-style controls for switching between a small set of mutually exclusive options (aka Segmented Buttons, Segmented Picker, Content Switcher)
|
|
278
|
+
- **SegmentedControl** — Button-style controls for switching between a small set of mutually exclusive options (aka Segmented Buttons, Segmented Picker, Content Switcher, Segment Group)
|
|
277
279
|
- **Select** — A dropdown menu for selecting one option from a predefined list (aka Pop-Up Button, Select Menu)
|
|
278
280
|
- **SignaturePad** — Handwritten signature input
|
|
279
281
|
- **Slider** — An input to capture a numeric value from a specified range by dragging a knob
|
|
280
282
|
- **SmartSearchInput** — Smart search input enabling both traditional search and AI prompting.
|
|
281
283
|
- **SplitButton** — SplitButton description. (aka Combo Button)
|
|
282
284
|
- **Switch** — A binary switch for instantly toggling settings between on and off states (aka Toggle, Toggle Switch)
|
|
285
|
+
- ⚠️ Not the same as elsewhere: In Radix, shadcn/ui and Ark UI, a "Toggle" is a button that stays pressed (`aria-pressed`) — use a one-item `ToggleGroup` here. WIM's `Switch` is the on/off control that Apple and Material call a toggle.
|
|
283
286
|
- **SwitchGroup** — Shared state switches
|
|
284
|
-
- **TagInput** — Input field for creating free-form tags. (aka Token Field, Chips Input)
|
|
287
|
+
- **TagInput** — Input field for creating free-form tags. (aka Token Field, Chips Input, Tags Input)
|
|
285
288
|
- **Textarea** — Multi-line input fields for longer text entries like descriptions or comments
|
|
286
|
-
- **ThemeToggle** — Light / dark / system theme switcher
|
|
289
|
+
- **ThemeToggle** — Light / dark / system theme switcher (aka Animated Theme Toggler)
|
|
287
290
|
- **TimePicker** — Time selection
|
|
288
291
|
- **ToggleGroup** — Toggleable buttons
|
|
289
292
|
- **Transfer** — Move items between lists
|
|
@@ -291,7 +294,8 @@ export function BillingOverview() {
|
|
|
291
294
|
|
|
292
295
|
### feedback — `import { … } from "wimui/feedback"`
|
|
293
296
|
|
|
294
|
-
- **Alert** — Important messages (aka Message Bar)
|
|
297
|
+
- **Alert** — Important messages (aka Message Bar, Callout)
|
|
298
|
+
- ⚠️ Not the same as elsewhere: In Fluent UI v8, a "Callout" is a popup anchored to an element — that is `Popover` here. WIM's `Alert` matches Blueprint's Callout: an inline message in the page flow.
|
|
295
299
|
- **Autosave** — Inline status indicator for automatic save state
|
|
296
300
|
- **Banner** — Top prominent messages
|
|
297
301
|
- **ErrorBoundary** — Runtime error fallback
|
|
@@ -301,7 +305,7 @@ export function BillingOverview() {
|
|
|
301
305
|
- **Notification** — Rich notification card
|
|
302
306
|
- **Progress** — Progress bar (aka Progress Bar)
|
|
303
307
|
- ⚠️ Not the same as elsewhere: Material's "Progress Indicator" covers indeterminate spinners as well. WIM's `Progress` is determinate and linear only — for the indeterminate case use `Spinner`.
|
|
304
|
-
- **ProgressRing** — ProgressRing description.
|
|
308
|
+
- **ProgressRing** — ProgressRing description. (aka Progress Circle, Animated Circular Progress Bar)
|
|
305
309
|
- **Result** — Task status indicator (aka Full Page Error)
|
|
306
310
|
- **ScrollProgress** — Reading progress indicator
|
|
307
311
|
- **Skeleton** — Placeholder for content loading states. (aka Shimmer)
|
|
@@ -313,17 +317,18 @@ export function BillingOverview() {
|
|
|
313
317
|
### navigation — `import { … } from "wimui/navigation"`
|
|
314
318
|
|
|
315
319
|
- **Affix** — Sticky elements (aka Sticky)
|
|
316
|
-
- **Anchor** — Smooth scroll links (aka Scrollspy, Table of Contents, TableOfContents)
|
|
320
|
+
- **Anchor** — Smooth scroll links (aka Scrollspy, Table of Contents, TableOfContents, TOC)
|
|
317
321
|
- **BackTop** — Back to top button (aka Back to Top)
|
|
318
|
-
- **Breadcrumb** — Location trace (aka Path Bar, Path Control)
|
|
319
|
-
- **CommandPalette** — Cmd+K search overlay (aka Command Bar, Quick Open)
|
|
322
|
+
- **Breadcrumb** — Location trace (aka Path Bar, Path Control, Breadcrumbs)
|
|
323
|
+
- **CommandPalette** — Cmd+K search overlay (aka Command Bar, Quick Open, Omnibar, Command)
|
|
320
324
|
- **HamburgerMenu** — Toggleable menu (aka Sandwich Menu, Navigation Drawer Trigger, Nav Toggle, Cheeseburger Menu, Veggie Burger Menu, Pancake Menu, Bacon Menu, Hot Dog Menu, ハンバーガーメニュー, サンドイッチメニュー, Hamburger)
|
|
321
|
-
- **KeyboardShortcuts** — Display a structured list of keyboard shortcuts
|
|
325
|
+
- **KeyboardShortcuts** — Display a structured list of keyboard shortcuts (aka Hotkeys)
|
|
326
|
+
- ⚠️ Not the same as elsewhere: Blueprint's Hotkeys also registers the key bindings. WIM's `KeyboardShortcuts` only shows the list of shortcuts; bind the keys in your app.
|
|
322
327
|
- **Link** — Hyperlinks
|
|
323
328
|
- **Menubar** — Desktop-style application menu bar with floating File / Edit / View submenus.
|
|
324
329
|
- **Pagination** — Multi-page navigation (aka Pagination Nav)
|
|
325
330
|
- **SpeedDial** — Floating action button that expands sub-actions on hover or click.
|
|
326
|
-
- **Stepper** — Visual sequence steps (aka Progress Indicator)
|
|
331
|
+
- **Stepper** — Visual sequence steps (aka Progress Indicator, Steps)
|
|
327
332
|
- ⚠️ 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.
|
|
328
333
|
- **TabBar** — Mobile bottom navigation (aka Bottom Navigation, Bottom Tab Bar)
|
|
329
334
|
- **TabNavigation** — Tab-based navigation
|
|
@@ -333,7 +338,7 @@ export function BillingOverview() {
|
|
|
333
338
|
|
|
334
339
|
- **Accordion** — Collapsible panels (aka Disclosure, Disclosure Group, Expander)
|
|
335
340
|
- **Avatar** — Profile initials/pics (aka User Avatar)
|
|
336
|
-
- **AvatarGroup** — Stacked avatars (aka Face Pile)
|
|
341
|
+
- **AvatarGroup** — Stacked avatars (aka Face Pile, Avatar Circles)
|
|
337
342
|
- **Badge** — Indicators or counts (aka Icon Indicator)
|
|
338
343
|
- **Barcode** — Draws a scannable Code 128 or EAN-13 barcode.
|
|
339
344
|
- **Calendar** — Calendar view
|
|
@@ -342,22 +347,24 @@ export function BillingOverview() {
|
|
|
342
347
|
- **Carousel** — Content slideshow
|
|
343
348
|
- **Chip** — Filter/Selection tokens (aka Pill, Token)
|
|
344
349
|
- **Comment** — Shows one comment in a discussion, with its actions and nested replies.
|
|
345
|
-
- **Countdown** — Display the remaining time until a target moment as a live ticking timer, for sale deadlines, OTP resend waits, and maintenance notices.
|
|
350
|
+
- **Countdown** — Display the remaining time until a target moment as a live ticking timer, for sale deadlines, OTP resend waits, and maintenance notices. (aka Timer)
|
|
346
351
|
- **DataGrid** — Advanced data table and manipulation (aka Data Table)
|
|
347
|
-
- **DescriptionList** — Key-value pairs
|
|
348
|
-
- **EmptyState** — Missing data placeholder (aka Blank Slate, Zero State)
|
|
352
|
+
- **DescriptionList** — Key-value pairs (aka Data List)
|
|
353
|
+
- **EmptyState** — Missing data placeholder (aka Blank Slate, Zero State, Non-Ideal State)
|
|
349
354
|
- **FAQSection** — Frequently Asked Questions section
|
|
350
355
|
- **InfiniteScroll** — Infinite scroll control
|
|
351
356
|
- **JsonDiffViewer** — Compares two JSON values as a formatted side-by-side or unified diff, built on top of CodeDiffViewer.
|
|
352
|
-
- **JsonViewer** — Recursive tree viewer and editor for JSON data.
|
|
357
|
+
- **JsonViewer** — Recursive tree viewer and editor for JSON data. (aka JSON Tree View)
|
|
353
358
|
- **Kanban** — Drag-and-drop board for visualizing workflow stages
|
|
354
359
|
- **Leaderboard** — Display a ranked list of entries with scores. Medal colors for the top three are opt-in.
|
|
355
|
-
- **List** — Structurally organized items in bullet points or numbered formats (aka Contained List, Ordered List, Unordered List)
|
|
360
|
+
- **List** — Structurally organized items in bullet points or numbered formats (aka Contained List, Ordered List, Unordered List, Card List)
|
|
356
361
|
- **Markdown** — A component for safely rendering text in Markdown format.
|
|
357
362
|
- **Marquee** — Scrolling text animation (aka Ticker)
|
|
358
363
|
- **NodeGraph** — Visualizes complex networks and relationships between nodes.
|
|
364
|
+
- **Persona** — Shows a person as one unit: avatar, name and up to two lines of description, with text sizes matched to the avatar. The name is read once.
|
|
359
365
|
- **PivotTable** — Draws aggregated data as a table with multi-level row and column headings, subtotals and grand totals. (aka Pivot, Cross Tab, Crosstab)
|
|
360
366
|
- **Presence** — Shows whether a person is online, away, busy, or offline.
|
|
367
|
+
- ⚠️ Not the same as elsewhere: In Ark UI and Chakra UI, "Presence" is the helper that animates an element in and out as it mounts and unmounts — that is `Transition` here. WIM's `Presence` shows whether a person is online, away, busy or offline.
|
|
361
368
|
- **PullToRefresh** — Pull-to-refresh utility for enhancing mobile user experience.
|
|
362
369
|
- **QRCode** — QR generator
|
|
363
370
|
- **RangeCalendar** — Range calendar view
|
|
@@ -369,11 +376,11 @@ export function BillingOverview() {
|
|
|
369
376
|
- **Stats** — A component to highlight key performance indicators and metrics (aka Statistic, Stat, Big Number)
|
|
370
377
|
- **SwipeableList** — Container for SwipeAction rows that keeps at most one row open at a time. (aka Swipeable List)
|
|
371
378
|
- **SwipeAction** — Mobile-friendly swipe actions (delete, archive) for list items.
|
|
372
|
-
- **Table** — Rows and columns for displaying structured data efficiently (aka Structured List)
|
|
379
|
+
- **Table** — Rows and columns for displaying structured data efficiently (aka Structured List, HTML Table)
|
|
373
380
|
- **Tag** — Compact visual descriptors used for labeling or categorizing content (aka Interaction Tag)
|
|
374
381
|
- **Timeline** — A vertical list mapping events or history in chronological order
|
|
375
382
|
- **TreeDiagram** — Lays out a tree such as an org chart from the data alone, with parents centred over their children and collapsible subtrees. (aka Org Chart, Tree Chart, Hierarchy Diagram)
|
|
376
|
-
- **TreeView** — Hierarchical data (aka Outline View, Tree, Flat Tree)
|
|
383
|
+
- **TreeView** — Hierarchical data (aka Outline View, Tree, Flat Tree, File Tree)
|
|
377
384
|
- **VirtualList** — Efficiently renders large lists by virtualizing off-screen items
|
|
378
385
|
|
|
379
386
|
### overlay — `import { … } from "wimui/overlay"`
|
|
@@ -397,14 +404,14 @@ export function BillingOverview() {
|
|
|
397
404
|
|
|
398
405
|
- **Blockquote** — Visually separates external quotes or text to be emphasized.
|
|
399
406
|
- **Code** — Code snippets
|
|
400
|
-
- **Highlight** — Text highlighting
|
|
401
|
-
- **Kbd** — Keyboard shortcuts
|
|
407
|
+
- **Highlight** — Text highlighting (aka Mark, Highlighter)
|
|
408
|
+
- **Kbd** — Keyboard shortcuts (aka Key Combo)
|
|
402
409
|
- **Label** — Descriptive text for input fields, including required/optional marks
|
|
403
410
|
- **Legend** — Group title
|
|
404
411
|
- **Span** — Lightweight wrapper for inline text or short labels with icon support
|
|
405
412
|
- **Spoiler** — Collapse long text such as reviews and comments to a fixed number of lines, with an accessible "show more" toggle that appears only when the text overflows.
|
|
406
413
|
- **Text** — Has appropriate line-height and spacing to ensure readability of long text. (aka Truncated Text)
|
|
407
|
-
- **Title** — Possesses visual weight (boldness/size) to indicate page structure.
|
|
414
|
+
- **Title** — Possesses visual weight (boldness/size) to indicate page structure. (aka Heading)
|
|
408
415
|
|
|
409
416
|
### media — `import { … } from "wimui/media"`
|
|
410
417
|
|
|
@@ -443,7 +450,7 @@ export function BillingOverview() {
|
|
|
443
450
|
- **ArtifactsOverlay** — ArtifactsOverlay is a specialized side-panel for displaying large AI-generated content (Artifacts) without interrupting the main chat context.
|
|
444
451
|
- **ChatUI** — A comprehensive set of components for building chat interfaces with support for messages, avatars, timestamps, and interactive input.
|
|
445
452
|
- **CodeBlock** — Syntax-highlighted code block with copy button, line numbers, and collapsible overflow. (aka Code Snippet)
|
|
446
|
-
- **CodeDiffViewer** — Displays code changes as a side-by-side or unified diff, with line-level highlighting and Apply/Reject actions.
|
|
453
|
+
- **CodeDiffViewer** — Displays code changes as a side-by-side or unified diff, with line-level highlighting and Apply/Reject actions. (aka Code Comparison)
|
|
447
454
|
- **InteractiveGraph** — InteractiveGraph provides a canvas for visualizing node-based data. Ideal for RAG knowledge bases, agent workflows, or state machines.
|
|
448
455
|
- **MarkdownRenderer** — MarkdownRenderer converts a markdown string into WIM UI components. It uses react-markdown under the hood and applies WIM's typography system.
|
|
449
456
|
- **ModelSelector** — ModelSelector is a dropdown for switching between AI models, surfacing the metadata that matters when choosing one — context window size and per-token pricing.
|
|
@@ -478,9 +485,16 @@ Exported hooks. Prefer them over hand-rolled equivalents (`matchMedia` listeners
|
|
|
478
485
|
These exist in other systems' vocabularies and are **decisions, not gaps**. Do not hand-roll them into a wimui screen; the alternative given is the supported way to express the same intent.
|
|
479
486
|
|
|
480
487
|
- **Parallax Scrolling** (aka Parallax, Scroll Parallax, Parallax Hero) — Backgrounds moving at a different speed from the foreground. The motion does not correspond to any change of state, which is what this system animates. If the goal is to show scroll position, show the position. Use `ScrollProgress` instead.
|
|
481
|
-
- **Text Scramble** (aka Scramble Text, Decrypt Text, Glitch Text) — Randomising characters before settling on the real string. The reader parses the same sentence twice and gets nothing for the lost legibility. The one case where text legitimately arrives character by character is model output, which StreamingText already covers. Use `StreamingText` instead.
|
|
488
|
+
- **Text Scramble** (aka Scramble Text, Decrypt Text, Glitch Text, Hyper Text) — Randomising characters before settling on the real string. The reader parses the same sentence twice and gets nothing for the lost legibility. The one case where text legitimately arrives character by character is model output, which StreamingText already covers. Use `StreamingText` instead.
|
|
482
489
|
- **Spring Animation** (aka Spring Physics, Springs, Physics-based Animation) — A physics engine (mass / stiffness / damping props solved in a rAF loop). The bounce curve itself already exists as the `--wim-easing-spring` token, which is what press and swipe-return use. Adding the engine would put physics parameters into the public contract and move motion from CSS to JS. Use `--wim-easing-spring` instead.
|
|
483
490
|
- **Choropleth Map** (aka Choropleth, Filled Map, Region Map, Geo Map) — A map shading regions by value. Shipping boundary data would put its size and a political stance on disputed borders into a UI library, and large regions dominate regardless of their values. Regions are compared more accurately in a sorted bar chart. Use `BarChart` instead.
|
|
491
|
+
- **Animated Text Effects** (aka Animated Gradient Text, Animated Shiny Text, Aurora Text, Morphing Text, Sparkles Text, Spinning Text, Text Reveal, Typing Animation, Word Rotate, Line Shadow Text, Comic Text, Kinetic Text, Video Text, Text 3D Flip, Text Animate, Dia Text Reveal) — Text that shimmers, rotates, morphs or types itself out. It cannot be read while it moves, and keeps moving after it has been read. Emphasis is a matter of weight, colour and size; the one case where text legitimately arrives piece by piece is model output, which StreamingText covers. Use `Text` instead.
|
|
492
|
+
- **Decorative Background Pattern** (aka Dot Pattern, Grid Pattern, Animated Grid Pattern, Interactive Grid Pattern, Flickering Grid, Hexagon Pattern, Striped Pattern, Retro Grid, Noise Texture, Dither Field, Light Rays, Meteors, Particles, Warp Background, Glyph Matrix, Backlight, Floating 3D Particles, Ripple) — Patterns and particles laid behind content that carry no meaning of their own. They make the background under text uneven, which costs contrast, and moving ones compete with real motion in the foreground. Separate surfaces with the surface tokens and borders instead. Use `Box` instead.
|
|
493
|
+
- **Animated Button Effects** (aka Shimmer Button, Shiny Button, Rainbow Button, Pulsating Button, Ripple Button, Interactive Hover Button, Animated Subscribe Button, Confetti, Cool Mode) — Buttons that shimmer, pulse, ripple or burst into confetti. They only attract attention before the click, and once several buttons do it the primary action is lost. Rank actions with Button variants, and report the result through the state change and an announcement. Use `Button` instead.
|
|
494
|
+
- **Glow and Spotlight Card** (aka Magic Card, Neon Gradient Card, Shine Border, Glare Hover, Lens, Progressive Blur, Blur Fade, Pixel Image) — Cards with glowing borders, a spotlight that follows the pointer, or content that fades in from a blur. Nothing happens for touch or keyboard users, and for pointer users it does not help tell the cards apart. Use Card variants and the heading inside the card. Use `Card` instead.
|
|
495
|
+
- **Device Mockup** (aka iPhone Mockup, Android Mockup, Safari Mockup, Browser Frame, Device Frame) — Phone and browser frames around a screenshot. It is marketing artwork rather than an interface component, and the frames go out of date with every device generation. Show the screenshot with Image, with the frame baked into the image if one is needed. Use `Image` instead.
|
|
496
|
+
- **Decorative Motion Graphics** (aka Globe, Icon Cloud, Orbiting Circles, Animated Beam, Dock, Scroll Based Velocity, Animated List, Dotted Map, Smooth Cursor, Pointer Effect, Hero Video Dialog) — Spinning globes, floating icon clouds, beams between logos, a magnifying dock, a custom cursor: motion that carries no information. It pulls attention away from the content and is a burden for people who reduce motion. Show relationships with NodeGraph, items with List, and a video with Video inside a Dialog. Use `List` instead.
|
|
497
|
+
- **Social Post Embed** (aka Tweet Card, Client Tweet Card, Tweet Embed) — Embedding a post from a social network in that network's own look. Its appearance and the way it is fetched change on the provider's schedule, which a design system cannot keep up with. Quote it in a Blockquote or Card with a link to the source. Use `Card` instead.
|
|
484
498
|
|
|
485
499
|
---
|
|
486
500
|
For per-component props, types and defaults, see `llms-full.txt`.
|
|
@@ -147,7 +147,8 @@
|
|
|
147
147
|
"selectionBar_desc": "Bar above a table that shows the number of selected rows, the actions for them and a way to clear the selection. Announces the count to screen readers.",
|
|
148
148
|
"confirm_desc": "Opens a confirmation dialog from code with await confirm() and returns true or false.",
|
|
149
149
|
"aiLabel_desc": "Marks a value or a block as produced by AI. Pressing the mark opens an explanation of what the AI did.",
|
|
150
|
-
"pageHeader_desc": "Head of a page: breadcrumb, title (always h1), status, description, actions and tabs in a fixed order and spacing."
|
|
150
|
+
"pageHeader_desc": "Head of a page: breadcrumb, title (always h1), status, description, actions and tabs in a fixed order and spacing.",
|
|
151
|
+
"persona_desc": "Shows a person as one unit: avatar, name and up to two lines of description, with text sizes matched to the avatar. The name is read once."
|
|
151
152
|
},
|
|
152
153
|
"cat": {
|
|
153
154
|
"ai": "AI"
|