wimui 0.76.0 → 0.76.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (55) hide show
  1. package/dist/components/_internal/useCloseWhenReferenceGone.cjs +2 -0
  2. package/dist/components/_internal/useCloseWhenReferenceGone.d.ts +9 -0
  3. package/dist/components/_internal/useCloseWhenReferenceGone.js +17 -0
  4. package/dist/components/_internal/useFloatingElement.cjs +1 -1
  5. package/dist/components/_internal/useFloatingElement.js +28 -25
  6. package/dist/components/form/Combobox/Combobox.cjs +1 -1
  7. package/dist/components/form/Combobox/Combobox.js +1 -0
  8. package/dist/components/form/RangeSlider/RangeSlider.cjs +1 -1
  9. package/dist/components/form/RangeSlider/RangeSlider.js +113 -111
  10. package/dist/components/form/Slider/Slider.cjs +1 -1
  11. package/dist/components/form/Slider/Slider.js +77 -75
  12. package/dist/components/overlay/Dropdown/Dropdown.cjs +1 -1
  13. package/dist/components/overlay/Dropdown/Dropdown.js +99 -98
  14. package/dist/i18n/generated/common.d.ts +1 -1
  15. package/dist/llms/AppShell.md +2 -0
  16. package/dist/llms/Avatar.md +2 -0
  17. package/dist/llms/Badge.md +2 -0
  18. package/dist/llms/ButtonGroup.md +2 -0
  19. package/dist/llms/Card.md +2 -0
  20. package/dist/llms/CodeBlock.md +2 -0
  21. package/dist/llms/CopyButton.md +2 -0
  22. package/dist/llms/DataGrid.md +2 -0
  23. package/dist/llms/Dialog.md +1 -1
  24. package/dist/llms/Drawer.md +1 -1
  25. package/dist/llms/Fieldset.md +2 -0
  26. package/dist/llms/FileUpload.md +1 -1
  27. package/dist/llms/Indicator.md +2 -0
  28. package/dist/llms/InlineEdit.md +1 -1
  29. package/dist/llms/Input.md +2 -0
  30. package/dist/llms/List.md +2 -0
  31. package/dist/llms/OverflowList.md +1 -1
  32. package/dist/llms/Pagination.md +2 -0
  33. package/dist/llms/Popover.md +1 -1
  34. package/dist/llms/QueryBuilder.md +2 -0
  35. package/dist/llms/Radio.md +2 -0
  36. package/dist/llms/RadioGroup.md +2 -0
  37. package/dist/llms/Result.md +2 -0
  38. package/dist/llms/SegmentedControl.md +1 -1
  39. package/dist/llms/Spinner.md +1 -1
  40. package/dist/llms/SplitButton.md +2 -0
  41. package/dist/llms/Splitter.md +1 -1
  42. package/dist/llms/Stats.md +1 -1
  43. package/dist/llms/Stepper.md +2 -0
  44. package/dist/llms/Table.md +2 -0
  45. package/dist/llms/Text.md +2 -0
  46. package/dist/llms-full.txt +32 -32
  47. package/dist/llms.txt +32 -32
  48. package/dist/locales/en/common.json +2 -1
  49. package/dist/locales/ja/common.json +2 -1
  50. package/dist/locales/pt/common.json +2 -1
  51. package/dist/utilities/slider-utils.cjs +1 -1
  52. package/dist/utilities/slider-utils.d.ts +5 -0
  53. package/dist/utilities/slider-utils.js +2 -2
  54. package/dist/wimui.umd.js +5 -5
  55. package/package.json +2 -2
package/dist/llms.txt CHANGED
@@ -4,7 +4,7 @@
4
4
 
5
5
  ## What this is
6
6
 
7
- **wimui** v0.76.0 — a React 19 component library: 231 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).
7
+ **wimui** v0.76.3 — a React 19 component library: 231 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
 
@@ -202,7 +202,7 @@ export function BillingOverview() {
202
202
 
203
203
  ### layout — `import { … } from "wimui/layout"`
204
204
 
205
- - **AppShell** — Basic application shell layout
205
+ - **AppShell** — Basic application shell layout (aka UI Shell)
206
206
  - **AspectRatio** — Fixed ratio container
207
207
  - **BentoGrid** — Modern card grid (aka Waffle Menu, Bento Menu, Grid Menu, Candy Bar Menu, Chocolate Bar Menu, ベントーメニュー, ワッフルメニュー)
208
208
  - **Box** — Polymorphic box
@@ -218,11 +218,11 @@ export function BillingOverview() {
218
218
  - **InteractiveArea** — Foundation component for consistent interactive areas with borders and states.
219
219
  - **Masonry** — Waterfall grid
220
220
  - **Navbar** — Primary navigation
221
- - **OverflowList** — Lays out items in one row and folds the ones that do not fit into a "+N" indicator. (aka Overflow)
221
+ - **OverflowList** — Lays out items in one row and folds the ones that do not fit into a "+N" indicator. (aka Overflow, Overflow Handler)
222
222
  - **ScrollArea** — A custom scrollbar component that provides high-performance, cross-browser consistent themes while maintaining a native-like feel.
223
223
  - **Sidebar** — A collapsible navigation or informational panel on the side of the screen (aka Source List, Inspector, Nav Drawer)
224
224
  - **SimpleGrid** — Responsive fixed grid
225
- - **Splitter** — Split and resize panels (aka Resizable, Resizable Panels, Split Pane)
225
+ - **Splitter** — Split and resize panels (aka Resizable, Resizable Panels, Split Pane, Resizer)
226
226
  - **Stack** — Vertical/Horizontal alignment
227
227
  - **Toolbar** — Action strip for IconButton, ToggleGroup, and related controls with toolbar keyboard navigation. (aka Action Bar)
228
228
  - **Transition** — Utilities for managing smooth enter and leave animations with CSS classes
@@ -232,28 +232,28 @@ export function BillingOverview() {
232
232
  ### form — `import { … } from "wimui/form"`
233
233
 
234
234
  - **Button** — Action triggers
235
- - **ButtonGroup** — Group of buttons
235
+ - **ButtonGroup** — Group of buttons (aka Button Set, Action Set)
236
236
  - **Cascader** — Hierarchical selection (aka Column View, Miller Columns)
237
237
  - **Checkbox** — Multiple choice
238
238
  - **CheckboxGroup** — Shared state checkboxes
239
239
  - **ColorInput** — Input with color preview (aka Color Well, Color Field)
240
240
  - **ColorPicker** — Color selection picker (aka Swatch Picker)
241
241
  - **Combobox** — Select with search (aka Autocomplete, Auto Complete)
242
- - **CopyButton** — Copy to clipboard
242
+ - **CopyButton** — Copy to clipboard (aka Copy)
243
243
  - **CounterTextarea** — Textarea with character count display
244
244
  - **CreditCardInput** — Payment card input with brand detection
245
245
  - **DatePicker** — Date selection
246
246
  - **DateRangePicker** — Date range selection
247
247
  - **Dropzone** — Drag & drop files
248
248
  - **FieldError** — Validation messages
249
- - **Fieldset** — Form grouping
249
+ - **Fieldset** — Form grouping (aka Form Group)
250
250
  - **FieldTemplate** — Standardizes label placement, required markings, and error message display for all form-related components. (aka Field)
251
- - **FileUpload** — File selection (aka Upload, File Input)
251
+ - **FileUpload** — File selection (aka Upload, File Input, File Uploader)
252
252
  - **FloatButton** — Floating action buttons
253
253
  - **IconButton** — A square button containing only an icon without a text label.
254
254
  - **ImageCropper** — Front-end image cropping and rotation tool.
255
- - **InlineEdit** — A component that allows users to switch between a view-only mode and an editable mode in-place. (aka Editable Text)
256
- - **Input** — Single-line input fields for text, numbers, or emails
255
+ - **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)
256
+ - **Input** — Single-line input fields for text, numbers, or emails (aka Text Input)
257
257
  - **InputBase** — Standardizes the visual container, icon slots (Prefix/Suffix), and clear button behavior for text-based inputs.
258
258
  - **InputGroup** — Inputs with icons/labels
259
259
  - **InputMask** — Formatted inputs
@@ -265,19 +265,19 @@ export function BillingOverview() {
265
265
  - **PasswordInput** — Password with toggle
266
266
  - **PasswordStrength** — Visual meter to indicate password security level. (aka Strength Meter)
267
267
  - **PhoneInput** — International phone number input
268
- - **QueryBuilder** — Visual builder for constructing complex search queries.
269
- - **Radio** — Single choice
270
- - **RadioGroup** — Shared state radio buttons
268
+ - **QueryBuilder** — Visual builder for constructing complex search queries. (aka Condition Builder)
269
+ - **Radio** — Single choice (aka Radio Button)
270
+ - **RadioGroup** — Shared state radio buttons (aka Radio Button Group)
271
271
  - **RangeSlider** — Range selection
272
272
  - **Rating** — Star rating (aka Star Rating, Rating Indicator, Rating Display)
273
273
  - **RichTextEditor** — WYSIWYG rich text editor
274
274
  - **SearchInput** — Search with clear button (aka Search Field, Search Bar, Search Box)
275
- - **SegmentedControl** — Button-style controls for switching between a small set of mutually exclusive options (aka Segmented Buttons, Segmented Picker)
275
+ - **SegmentedControl** — Button-style controls for switching between a small set of mutually exclusive options (aka Segmented Buttons, Segmented Picker, Content Switcher)
276
276
  - **Select** — A dropdown menu for selecting one option from a predefined list (aka Pop-Up Button, Select Menu)
277
277
  - **SignaturePad** — Handwritten signature input
278
278
  - **Slider** — An input to capture a numeric value from a specified range by dragging a knob
279
279
  - **SmartSearchInput** — Smart search input enabling both traditional search and AI prompting.
280
- - **SplitButton** — SplitButton description.
280
+ - **SplitButton** — SplitButton description. (aka Combo Button)
281
281
  - **Switch** — A binary switch for instantly toggling settings between on and off states (aka Toggle, Toggle Switch)
282
282
  - **SwitchGroup** — Shared state switches
283
283
  - **TagInput** — Input field for creating free-form tags. (aka Token Field, Chips Input)
@@ -294,18 +294,18 @@ export function BillingOverview() {
294
294
  - **Autosave** — Inline status indicator for automatic save state
295
295
  - **Banner** — Top prominent messages
296
296
  - **ErrorBoundary** — Runtime error fallback
297
- - **Indicator** — Small status dots
297
+ - **Indicator** — Small status dots (aka Badge Indicator)
298
298
  - **Loader** — Animated indicators to show that data is loading or processing
299
299
  - **LoadingOverlay** — Overlay with loading indicator
300
300
  - **Notification** — Rich notification card
301
301
  - **Progress** — Progress bar (aka Progress Bar)
302
302
  - ⚠️ 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`.
303
303
  - **ProgressRing** — ProgressRing description.
304
- - **Result** — Task status indicator
304
+ - **Result** — Task status indicator (aka Full Page Error)
305
305
  - **ScrollProgress** — Reading progress indicator
306
306
  - **Skeleton** — Placeholder for content loading states. (aka Shimmer)
307
307
  - **Snackbar** — Bottom notifications
308
- - **Spinner** — A rotating icon indicating background activity or data fetching (aka Activity Indicator)
308
+ - **Spinner** — A rotating icon indicating background activity or data fetching (aka Activity Indicator, Inline Loading, Loading)
309
309
  - **Toast** — Non-intrusive floating messages that provide feedback on system operations (aka Message, Sonner, Toaster)
310
310
  - **Tour** — Sequential guided walkthroughs to onboard users or highlight features (aka Teaching Popover, Coach Mark)
311
311
 
@@ -320,9 +320,9 @@ export function BillingOverview() {
320
320
  - **KeyboardShortcuts** — Display a structured list of keyboard shortcuts
321
321
  - **Link** — Hyperlinks
322
322
  - **Menubar** — Desktop-style application menu bar with floating File / Edit / View submenus.
323
- - **Pagination** — Multi-page navigation
323
+ - **Pagination** — Multi-page navigation (aka Pagination Nav)
324
324
  - **SpeedDial** — Floating action button that expands sub-actions on hover or click.
325
- - **Stepper** — Visual sequence steps
325
+ - **Stepper** — Visual sequence steps (aka Progress Indicator)
326
326
  - ⚠️ 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.
327
327
  - **TabBar** — Mobile bottom navigation (aka Bottom Navigation, Bottom Tab Bar)
328
328
  - **TabNavigation** — Tab-based navigation
@@ -331,18 +331,18 @@ export function BillingOverview() {
331
331
  ### data-display — `import { … } from "wimui/data-display"`
332
332
 
333
333
  - **Accordion** — Collapsible panels (aka Disclosure, Disclosure Group, Expander)
334
- - **Avatar** — Profile initials/pics
334
+ - **Avatar** — Profile initials/pics (aka User Avatar)
335
335
  - **AvatarGroup** — Stacked avatars (aka Face Pile)
336
- - **Badge** — Indicators or counts
336
+ - **Badge** — Indicators or counts (aka Icon Indicator)
337
337
  - **Barcode** — Draws a scannable Code 128 or EAN-13 barcode.
338
338
  - **Calendar** — Calendar view
339
339
  - **CalendarHeatmap** — GitHub-style activity graph for visualizing continuity
340
- - **Card** — Information containers
340
+ - **Card** — Information containers (aka Tile)
341
341
  - **Carousel** — Content slideshow
342
342
  - **Chip** — Filter/Selection tokens (aka Pill, Token)
343
343
  - **Comment** — Shows one comment in a discussion, with its actions and nested replies.
344
344
  - **Countdown** — Display the remaining time until a target moment as a live ticking timer, for sale deadlines, OTP resend waits, and maintenance notices.
345
- - **DataGrid** — Advanced data table and manipulation
345
+ - **DataGrid** — Advanced data table and manipulation (aka Data Table)
346
346
  - **DescriptionList** — Key-value pairs
347
347
  - **EmptyState** — Missing data placeholder (aka Blank Slate, Zero State)
348
348
  - **FAQSection** — Frequently Asked Questions section
@@ -351,7 +351,7 @@ export function BillingOverview() {
351
351
  - **JsonViewer** — Recursive tree viewer and editor for JSON data.
352
352
  - **Kanban** — Drag-and-drop board for visualizing workflow stages
353
353
  - **Leaderboard** — Display a ranked list of entries with scores. Medal colors for the top three are opt-in.
354
- - **List** — Structurally organized items in bullet points or numbered formats
354
+ - **List** — Structurally organized items in bullet points or numbered formats (aka Contained List, Ordered List, Unordered List)
355
355
  - **Markdown** — A component for safely rendering text in Markdown format.
356
356
  - **Marquee** — Scrolling text animation (aka Ticker)
357
357
  - **NodeGraph** — Visualizes complex networks and relationships between nodes.
@@ -365,10 +365,10 @@ export function BillingOverview() {
365
365
  - **ScheduleView** — Displays tasks or events on a chronological timeline or calendar view.
366
366
  - **SelectionBar** — 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. (aka Bulk Actions, Batch Actions, Table Selection Toolbar)
367
367
  - **SortableList** — Item rearrangement and reordering
368
- - **Stats** — A component to highlight key performance indicators and metrics (aka Statistic, Stat)
368
+ - **Stats** — A component to highlight key performance indicators and metrics (aka Statistic, Stat, Big Number)
369
369
  - **SwipeableList** — Container for SwipeAction rows that keeps at most one row open at a time. (aka Swipeable List)
370
370
  - **SwipeAction** — Mobile-friendly swipe actions (delete, archive) for list items.
371
- - **Table** — Rows and columns for displaying structured data efficiently
371
+ - **Table** — Rows and columns for displaying structured data efficiently (aka Structured List)
372
372
  - **Tag** — Compact visual descriptors used for labeling or categorizing content (aka Interaction Tag)
373
373
  - **Timeline** — A vertical list mapping events or history in chronological order
374
374
  - **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)
@@ -380,15 +380,15 @@ export function BillingOverview() {
380
380
  - **BottomSheet** — Mobile bottom overlay (aka Sheet, Action Sheet)
381
381
  - **Confirm** — Opens a confirmation dialog from code with await confirm() and returns true or false.
382
382
  - **ContextMenu** — Right-click menus
383
- - **Dialog** — Focused task windows (aka Modal, Modal Dialog)
384
- - **Drawer** — Slide-out detail panels (aka Navigation Drawer, Overlay Drawer)
383
+ - **Dialog** — Focused task windows (aka Modal, Modal Dialog, Composed Modal)
384
+ - **Drawer** — Slide-out detail panels (aka Navigation Drawer, Overlay Drawer, Side Panel)
385
385
  - **Dropdown** — Overlay selection menu (aka Overflow Menu, Kebab Menu, Meatball Menu, Vertical Ellipsis, Horizontal Ellipsis, Three Dots Menu, More Menu, App Switcher, オーバーフローメニュー, ケバブメニュー, ミートボールメニュー, Menu Button)
386
386
  - **FocusTrap** — Focus management
387
387
  - **HoverCard** — Rich content on hover
388
388
  - **Menu** — General menus
389
389
  - ⚠️ Not the same as elsewhere: In macOS, a "Menu" is the pull-down from a menu bar. WIM's `Menu` is the list of choices itself; for one that opens from a trigger, use `Dropdown`.
390
390
  - **Popconfirm** — Confirmation overlay
391
- - **Popover** — Contextual overlay (aka Info Label, Info Button)
391
+ - **Popover** — Contextual overlay (aka Info Label, Info Button, Toggletip)
392
392
  - **Portal** — Out-of-hierarchy render
393
393
  - **Tooltip** — Information on hover (aka Help Tag)
394
394
 
@@ -402,7 +402,7 @@ export function BillingOverview() {
402
402
  - **Legend** — Group title
403
403
  - **Span** — Lightweight wrapper for inline text or short labels with icon support
404
404
  - **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.
405
- - **Text** — Has appropriate line-height and spacing to ensure readability of long text.
405
+ - **Text** — Has appropriate line-height and spacing to ensure readability of long text. (aka Truncated Text)
406
406
  - **Title** — Possesses visual weight (boldness/size) to indicate page structure.
407
407
 
408
408
  ### media — `import { … } from "wimui/media"`
@@ -440,7 +440,7 @@ export function BillingOverview() {
440
440
  - **AIResponseFeedback** — Thumbs-up/down feedback controls and regenerate button for AI responses.
441
441
  - **ArtifactsOverlay** — ArtifactsOverlay is a specialized side-panel for displaying large AI-generated content (Artifacts) without interrupting the main chat context.
442
442
  - **ChatUI** — A comprehensive set of components for building chat interfaces with support for messages, avatars, timestamps, and interactive input.
443
- - **CodeBlock** — Syntax-highlighted code block with copy button, line numbers, and collapsible overflow.
443
+ - **CodeBlock** — Syntax-highlighted code block with copy button, line numbers, and collapsible overflow. (aka Code Snippet)
444
444
  - **CodeDiffViewer** — Displays code changes as a side-by-side or unified diff, with line-level highlighting and Apply/Reject actions.
445
445
  - **InteractiveGraph** — InteractiveGraph provides a canvas for visualizing node-based data. Ideal for RAG knowledge bases, agent workflows, or state machines.
446
446
  - **MarkdownRenderer** — MarkdownRenderer converts a markdown string into WIM UI components. It uses react-markdown under the hood and applies WIM's typography system.
@@ -158,7 +158,8 @@
158
158
  "reload": "Reload",
159
159
  "heatmap_less": "Less",
160
160
  "heatmap_more": "More",
161
- "heatmap_title": "Activity map"
161
+ "heatmap_title": "Activity map",
162
+ "tertiary": "Tertiary"
162
163
  },
163
164
  "copied": "Copied",
164
165
  "copy": {
@@ -165,7 +165,8 @@
165
165
  "variant": "バリアント",
166
166
  "vertical": "垂直",
167
167
  "warning": "警告",
168
- "yes": "はい"
168
+ "yes": "はい",
169
+ "tertiary": "ターシャリ"
169
170
  },
170
171
  "copied": "コピーしました",
171
172
  "copy": {
@@ -165,7 +165,8 @@
165
165
  "variant": "Variante",
166
166
  "vertical": "Vertical",
167
167
  "warning": "Aviso",
168
- "yes": "Sim"
168
+ "yes": "Sim",
169
+ "tertiary": "Terciário"
169
170
  },
170
171
  "copied": "Copiado",
171
172
  "copy": {
@@ -1,2 +1,2 @@
1
1
  "use client";
2
- let e=require("react");var t=(e,t,n)=>Math.max(t,Math.min(e,n)),n=(n,r,i)=>{let a=(0,e.useCallback)(e=>t(n+Math.round((e-n)/i)*i,n,r),[n,r,i]);return{clamp:t,alignToStep:a,calculateValue:(0,e.useCallback)((e,i)=>{if(!i)return n;let o=i.getBoundingClientRect(),s=n+t((e-o.left)/o.width,0,1)*(r-n);return a(s)},[a,r,n])}};exports.clamp=t,exports.useSliderCommon=n;
2
+ let e=require("react");var t=(e,t,n)=>Math.max(t,Math.min(e,n)),n=(e,t,n)=>Math.max(n,Math.round((t-e)/10/n)*n),r=(n,r,i)=>{let a=(0,e.useCallback)(e=>t(n+Math.round((e-n)/i)*i,n,r),[n,r,i]);return{clamp:t,alignToStep:a,calculateValue:(0,e.useCallback)((e,i)=>{if(!i)return n;let o=i.getBoundingClientRect(),s=n+t((e-o.left)/o.width,0,1)*(r-n);return a(s)},[a,r,n])}};exports.clamp=t,exports.largeStepOf=n,exports.useSliderCommon=r;
@@ -2,6 +2,11 @@
2
2
  * 値をminとmaxの範囲内に収めます。
3
3
  */
4
4
  export declare const clamp: (val: number, min: number, max: number) => number;
5
+ /**
6
+ * PageUp / PageDown で 1 回に動く幅(T410)。範囲の 10 分の 1 を step の倍数に丸め、step より小さくしない。
7
+ * 固定の 10 にすると、0〜1 の範囲では 1 回で端まで飛び、step 50 の範囲では目盛りからずれる。
8
+ */
9
+ export declare const largeStepOf: (min: number, max: number, step: number) => number;
5
10
  /**
6
11
  * スライダーの共通ロジックを提供するカスタムフック。
7
12
  */
@@ -1,7 +1,7 @@
1
1
  "use client";
2
2
  import { useCallback as e } from "react";
3
3
  //#region src/utilities/slider-utils.ts
4
- var t = (e, t, n) => Math.max(t, Math.min(e, n)), n = (n, r, i) => {
4
+ var t = (e, t, n) => Math.max(t, Math.min(e, n)), n = (e, t, n) => Math.max(n, Math.round((t - e) / 10 / n) * n), r = (n, r, i) => {
5
5
  let a = e((e) => t(n + Math.round((e - n) / i) * i, n, r), [
6
6
  n,
7
7
  r,
@@ -22,4 +22,4 @@ var t = (e, t, n) => Math.max(t, Math.min(e, n)), n = (n, r, i) => {
22
22
  };
23
23
  };
24
24
  //#endregion
25
- export { t as clamp, n as useSliderCommon };
25
+ export { t as clamp, n as largeStepOf, r as useSliderCommon };