wimui 0.75.2 → 0.76.1

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 (73) hide show
  1. package/dist/components/_internal/OverlayBase.cjs +1 -1
  2. package/dist/components/_internal/OverlayBase.js +13 -23
  3. package/dist/components/_internal/escapeStack.cjs +2 -0
  4. package/dist/components/_internal/escapeStack.d.ts +4 -0
  5. package/dist/components/_internal/escapeStack.js +23 -0
  6. package/dist/components/data-display/Calendar/Calendar.cjs +1 -1
  7. package/dist/components/data-display/Calendar/Calendar.js +12 -0
  8. package/dist/components/data-display/Kanban/Kanban.cjs +1 -1
  9. package/dist/components/data-display/Kanban/Kanban.js +10 -0
  10. package/dist/components/form/Combobox/Combobox.cjs +1 -1
  11. package/dist/components/form/Combobox/Combobox.js +2 -1
  12. package/dist/components/form/DatePicker/DatePicker.cjs +1 -1
  13. package/dist/components/form/DatePicker/DatePicker.js +62 -64
  14. package/dist/components/form/RangeSlider/RangeSlider.cjs +1 -1
  15. package/dist/components/form/RangeSlider/RangeSlider.js +113 -111
  16. package/dist/components/form/Select/Select.cjs +1 -1
  17. package/dist/components/form/Select/Select.js +12 -0
  18. package/dist/components/form/Select/useSelect.cjs +1 -1
  19. package/dist/components/form/Select/useSelect.js +1 -0
  20. package/dist/components/form/Slider/Slider.cjs +1 -1
  21. package/dist/components/form/Slider/Slider.js +77 -75
  22. package/dist/components/form/TagInput/TagInput.cjs +1 -1
  23. package/dist/components/form/TagInput/TagInput.d.ts +1 -1
  24. package/dist/components/form/TagInput/TagInput.js +50 -46
  25. package/dist/components/overlay/Confirm/Confirm.cjs +2 -0
  26. package/dist/components/overlay/Confirm/Confirm.d.ts +60 -0
  27. package/dist/components/overlay/Confirm/Confirm.js +63 -0
  28. package/dist/components/overlay/Dropdown/Dropdown.cjs +1 -1
  29. package/dist/components/overlay/Dropdown/Dropdown.js +120 -121
  30. package/dist/i18n/generated/common.cjs +1 -1
  31. package/dist/i18n/generated/common.d.ts +1 -1
  32. package/dist/i18n/generated/common.js +3 -0
  33. package/dist/i18n/generated/components.d.ts +1 -1
  34. package/dist/index.cjs +1 -1
  35. package/dist/index.js +33 -32
  36. package/dist/llms/Alert.md +2 -0
  37. package/dist/llms/Calendar.md +4 -0
  38. package/dist/llms/ColorPicker.md +2 -0
  39. package/dist/llms/Confirm.md +13 -0
  40. package/dist/llms/Drawer.md +1 -1
  41. package/dist/llms/Dropdown.md +1 -1
  42. package/dist/llms/FieldTemplate.md +2 -0
  43. package/dist/llms/HamburgerMenu.md +1 -1
  44. package/dist/llms/Kanban.md +4 -0
  45. package/dist/llms/MultiSelect.md +2 -0
  46. package/dist/llms/OverflowList.md +2 -0
  47. package/dist/llms/Popover.md +2 -0
  48. package/dist/llms/Progress.md +2 -0
  49. package/dist/llms/Rating.md +1 -1
  50. package/dist/llms/SearchInput.md +1 -1
  51. package/dist/llms/Select.md +4 -0
  52. package/dist/llms/Sidebar.md +1 -1
  53. package/dist/llms/Tabs.md +2 -0
  54. package/dist/llms/Tag.md +2 -0
  55. package/dist/llms/Toast.md +1 -1
  56. package/dist/llms/Tour.md +2 -0
  57. package/dist/llms/TreeView.md +1 -1
  58. package/dist/llms-full.txt +29 -19
  59. package/dist/llms.txt +21 -19
  60. package/dist/locales/en/common.json +1 -0
  61. package/dist/locales/en/components.json +2 -1
  62. package/dist/locales/ja/common.json +1 -0
  63. package/dist/locales/ja/components.json +2 -1
  64. package/dist/locales/pt/common.json +1 -0
  65. package/dist/locales/pt/components.json +2 -1
  66. package/dist/overlay.cjs +1 -1
  67. package/dist/overlay.d.ts +1 -0
  68. package/dist/overlay.js +2 -1
  69. package/dist/utilities/slider-utils.cjs +1 -1
  70. package/dist/utilities/slider-utils.d.ts +5 -0
  71. package/dist/utilities/slider-utils.js +2 -2
  72. package/dist/wimui.umd.js +5 -5
  73. package/package.json +13 -6
@@ -4,7 +4,7 @@
4
4
 
5
5
  ## What this is
6
6
 
7
- **wimui** v0.75.2 — a React 19 component library: 230 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.1 — 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
 
@@ -813,7 +813,7 @@ of pixels. Prefer the token so the gap follows the theme.
813
813
  - `defaultMenuOpen: boolean` = false — Initial open state of the mobile menu (uncontrolled)
814
814
  - `isMenuOpen: boolean` — Open state of the mobile menu (controlled)
815
815
  - `onMenuOpenChange: (isOpen: boolean) => void` — Callback when the mobile menu open state changes
816
- - **OverflowList** — Lays out items in one row and folds the ones that do not fit into a "+N" indicator.
816
+ - **OverflowList** — Lays out items in one row and folds the ones that do not fit into a "+N" indicator. (aka Overflow)
817
817
  - `items: T[]` (required) — Items to lay out in a single row, in reading order.
818
818
  - `renderItem: (item: T, index: number) => React.ReactNode` (required) — Renders one item. Return a single element: each top-level element is measured as one item.
819
819
  - `renderOverflow: (hiddenItems: T[]) => React.ReactNode` (required) — Renders the overflow indicator from the items that did not fit (for example a "+N" button
@@ -842,7 +842,7 @@ rendered inside it. Ignored without `asChild`.
842
842
  - `children: React.ReactNode` — Content to display
843
843
  - `scrollAxis: "x" | "y" | "both"` = "y" — Axis along which scrolling is allowed
844
844
  - `maxHeight: string` — Maximum height before scrolling (a CSS value, so units other than px are supported)
845
- - **Sidebar** — A collapsible navigation or informational panel on the side of the screen (aka Source List, Inspector)
845
+ - **Sidebar** — A collapsible navigation or informational panel on the side of the screen (aka Source List, Inspector, Nav Drawer)
846
846
  - `fixed: boolean` — Fixed position
847
847
  - `collapsed: boolean` — Collapsed state
848
848
  - `width: number | string` = 260 — Width when expanded
@@ -1059,7 +1059,7 @@ Use it when the field already does the same thing from the keyboard.
1059
1059
  so the unit does not have to be repeated in the label.
1060
1060
  - `styles: { root?: string; inner?: string; icon?: string; icons?: string; iconItem?: string; iconButton?: string; }` — Custom styles for internal parts
1061
1061
  - `asChild: boolean` = false — Whether to render as a child element.
1062
- - **ColorPicker** — Color selection picker
1062
+ - **ColorPicker** — Color selection picker (aka Swatch Picker)
1063
1063
  - `intent: "default" | "danger"` = "default" — Semantic intent of the field (e.g. error state)
1064
1064
  - `variant: "outline" | "ghost"` = "outline" — Visual style variant of the field
1065
1065
  - `fullWidth: boolean` = false — Whether to take full width of parent
@@ -1242,7 +1242,7 @@ inside a `Card` or any surface that already draws a border, where a framed
1242
1242
  fieldset would put a box inside a box. The `<fieldset>` and its `<legend>`
1243
1243
  still do their job for assistive technology.
1244
1244
  - `className: string` — Additional class names
1245
- - **FieldTemplate** — Standardizes label placement, required markings, and error message display for all form-related components.
1245
+ - **FieldTemplate** — Standardizes label placement, required markings, and error message display for all form-related components. (aka Field)
1246
1246
  - `asChild: boolean` = false — Whether to render as a child element.
1247
1247
  - `label: React.ReactNode` — Label text of the field
1248
1248
  - `error: string` — Error message
@@ -1453,7 +1453,7 @@ so the unit does not have to be repeated in the label.
1453
1453
  - `trigger: string` = "@" — Character that triggers the suggestion list
1454
1454
  - `onSelect: (option: MentionOption) => void` — Callback when a suggestion is selected
1455
1455
  - `asChild: boolean` = false — Whether to render as a child element.
1456
- - **MultiSelect** — Multiple selection
1456
+ - **MultiSelect** — Multiple selection (aka Tag Picker)
1457
1457
  - `options: MultiSelectOption[]` = [] — List of options
1458
1458
  - `value: string[]` — Selected values (controlled)
1459
1459
  - `onChange: (value: string[]) => void` — Callback when the selection changes
@@ -1603,7 +1603,7 @@ of a radio group. Use with `description` when the options need explaining.
1603
1603
  - `aria-label: string` — Accessible label when no visible label is provided
1604
1604
  - `aria-labelledby: string` — ID of the element that labels the slider
1605
1605
  - `asChild: boolean` = false — Whether to render as a child element.
1606
- - **Rating** — Star rating (aka Star Rating, Rating Indicator)
1606
+ - **Rating** — Star rating (aka Star Rating, Rating Indicator, Rating Display)
1607
1607
  - `value: number` — Current value (controlled)
1608
1608
  - `defaultValue: number` = 0 — Default value (uncontrolled)
1609
1609
  - `count: number` = 5 — Total number of stars
@@ -1663,7 +1663,7 @@ editor is created; changing it later does not convert the content.
1663
1663
  - `aria-labelledby: string` — ID of the element that labels the editor
1664
1664
  - `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
1665
1665
  and image files pasted or dropped into the editor are uploaded and inserted. The editor stores only the URL it gets back.
1666
- - **SearchInput** — Search with clear button (aka Search Field, Search Bar)
1666
+ - **SearchInput** — Search with clear button (aka Search Field, Search Bar, Search Box)
1667
1667
  - `intent: "default" | "danger"` = "default" — Semantic intent of the field (e.g. error state)
1668
1668
  - `variant: "outline" | "ghost"` = "outline" — Visual style variant of the field
1669
1669
  - `fullWidth: boolean` = false — Whether to take full width of parent
@@ -1951,7 +1951,7 @@ so the unit does not have to be repeated in the label.
1951
1951
 
1952
1952
  ### feedback — `import { … } from "wimui/feedback"`
1953
1953
 
1954
- - **Alert** — Important messages
1954
+ - **Alert** — Important messages (aka Message Bar)
1955
1955
  - `title: React.ReactNode` — Title of the alert
1956
1956
  - `titleTag: "h1" | "h2" | "h3" | "h4" | "h5" | "h6" | "div" | "p" | "strong" | "span"` = "div" — HTML tag used for the alert title.
1957
1957
 
@@ -2054,7 +2054,7 @@ origin while the card it was meant to cover was 1248x75.
2054
2054
  - `className: string` — Additional class name
2055
2055
  - `aria-label: string` — Accessible name for the notification.
2056
2056
  - `aria-labelledby: string` — ID of the element that labels the notification. Takes precedence over `aria-label`.
2057
- - **Progress** — Progress bar
2057
+ - **Progress** — Progress bar (aka Progress Bar)
2058
2058
  - ⚠️ 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`.
2059
2059
  - `value: number` = 0 — Current value of the progress bar.
2060
2060
  @default 0
@@ -2155,7 +2155,7 @@ follows the theme and never needs a hand-mixed colour.
2155
2155
  - `label: string` — Text label displayed next to the spinner.
2156
2156
  - `labelPosition: "right" | "bottom"` = "right" — Position of the label relative to the spinner.
2157
2157
  @default "right"
2158
- - **Toast** — Non-intrusive floating messages that provide feedback on system operations (aka Message, Sonner)
2158
+ - **Toast** — Non-intrusive floating messages that provide feedback on system operations (aka Message, Sonner, Toaster)
2159
2159
  - `id: string` — Identifier of the toast, passed to onClose. Used by ToastProvider to manage a stack.
2160
2160
  - `title: string` — Title of the toast.
2161
2161
  - `description: string` — Description text displayed below the title.
@@ -2169,7 +2169,7 @@ follows the theme and never needs a hand-mixed colour.
2169
2169
  - `className: string` — Additional CSS class name.
2170
2170
  - `aria-label: string` — Accessible name for the toast.
2171
2171
  - `aria-labelledby: string` — ID of the element that labels the toast. Takes precedence over `aria-label`.
2172
- - **Tour** — Sequential guided walkthroughs to onboard users or highlight features
2172
+ - **Tour** — Sequential guided walkthroughs to onboard users or highlight features (aka Teaching Popover, Coach Mark)
2173
2173
  - `steps: TourStep[]` (required) — Steps of the tour. Each step targets an element via a CSS selector.
2174
2174
  - `open: boolean` (required) — Whether the tour is shown.
2175
2175
  - `onClose: () => void` (required) — Called when the tour is dismissed before completion.
@@ -2225,7 +2225,7 @@ into a "…" button that lists them.
2225
2225
  - `children: ReactNode` (required) — Palette parts (CommandPaletteTrigger, CommandPaletteContent, etc.).
2226
2226
  - `open: boolean` — Controlled open state. Use together with onOpenChange.
2227
2227
  - `onOpenChange: (open: boolean) => void` — Called with the next state when the palette is opened or closed.
2228
- - **HamburgerMenu** — Toggleable menu (aka Sandwich Menu, Navigation Drawer Trigger, Nav Toggle, Cheeseburger Menu, Veggie Burger Menu, Pancake Menu, Bacon Menu, Hot Dog Menu, ハンバーガーメニュー, サンドイッチメニュー)
2228
+ - **HamburgerMenu** — Toggleable menu (aka Sandwich Menu, Navigation Drawer Trigger, Nav Toggle, Cheeseburger Menu, Veggie Burger Menu, Pancake Menu, Bacon Menu, Hot Dog Menu, ハンバーガーメニュー, サンドイッチメニュー, Hamburger)
2229
2229
  - `asChild: boolean` = false — If true, merge button props onto the child element.
2230
2230
  - `open: boolean` = false — Whether the menu is open
2231
2231
  - `onClick: React.MouseEventHandler<HTMLButtonElement>` — Callback function when the menu is toggled
@@ -2337,7 +2337,7 @@ scans stay green while the bar hangs outside its parent.
2337
2337
  - `variant: "underline" | "pill" | "contained"` = "underline" — Visual style of the tabs
2338
2338
  - `align: "start" | "center" | "end" | "justify"` = "start" — Alignment of the tabs
2339
2339
  - `size: "sm" | "md" | "lg"` = "md" — Size of the tabs
2340
- - **Tabs** — A container to organize related content into switchable view panels
2340
+ - **Tabs** — A container to organize related content into switchable view panels (aka Tab List)
2341
2341
  - `asChild: boolean` = false — If true, the tabs root will be rendered as its child, merging its props onto that child.
2342
2342
  - `defaultValue: string` — Value of the tab selected initially, for uncontrolled usage.
2343
2343
  - `value: string` — Controlled value of the selected tab. Use together with onChange.
@@ -2823,7 +2823,7 @@ destructive action is never triggered by momentum; the action stays available as
2823
2823
  - `maxHeight: string | number` — Maximum height of the container (enables vertical scrolling)
2824
2824
  - `containerClassName: string` — Additional class name for the scroll container
2825
2825
  - `card: boolean` = false — Add outer border and border-radius to the container (DataGrid look)
2826
- - **Tag** — Compact visual descriptors used for labeling or categorizing content
2826
+ - **Tag** — Compact visual descriptors used for labeling or categorizing content (aka Interaction Tag)
2827
2827
  - `asChild: boolean` = false — If true, the tag will be rendered as its child, merging its props onto that child.
2828
2828
  Cannot be combined with `onDelete` — the delete control is a second element, and
2829
2829
  `asChild` requires a single React element child (T99).
@@ -2856,7 +2856,7 @@ this is given; without it the diagram is read-only.
2856
2856
  anything is measured; long text is truncated and read in full by assistive technology.
2857
2857
  - `nodeHeight: number` = 64 — Card height in px.
2858
2858
  - `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.
2859
- - **TreeView** — Hierarchical data (aka Outline View)
2859
+ - **TreeView** — Hierarchical data (aka Outline View, Tree, Flat Tree)
2860
2860
  - `children: React.ReactNode` — JSX-based items (children API). Use this when not using `nodes`.
2861
2861
  - `nodes: TreeViewNode[]` — Node array for data-driven mode.
2862
2862
  - `className: string` — Additional class names
@@ -2899,6 +2899,7 @@ anything is measured; long text is truncated and read in full by assistive techn
2899
2899
  - `defaultOpen: boolean` = false — Initial open state for uncontrolled usage.
2900
2900
  @default false
2901
2901
  - `onOpenChange: (open: boolean) => void` — Called with the next state when the sheet is opened or closed.
2902
+ - **Confirm** — Opens a confirmation dialog from code with await confirm() and returns true or false.
2902
2903
  - **ContextMenu** — Right-click menus
2903
2904
  - `children: ReactNode` (required) — Element that opens the context menu on right-click.
2904
2905
  - `menu: ReactNode` (required) — Menu items to display in the context menu
@@ -2919,7 +2920,7 @@ interrupts the user and needs a response before they can continue, such as
2919
2920
  confirming a destructive action. An alert dialog does not close when the
2920
2921
  overlay is clicked unless closeOnOverlayClick is set; Escape still closes it.
2921
2922
  @default "dialog"
2922
- - **Drawer** — Slide-out detail panels (aka Navigation Drawer)
2923
+ - **Drawer** — Slide-out detail panels (aka Navigation Drawer, Overlay Drawer)
2923
2924
  - `children: React.ReactNode` (required) — Drawer parts (DrawerTrigger, DrawerContent, etc.).
2924
2925
  - `open: boolean` — Controlled open state. Use together with onOpenChange.
2925
2926
  - `onOpenChange: (open: boolean) => void` — Called with the next state when the drawer is opened or closed.
@@ -2931,7 +2932,7 @@ overlay is clicked unless closeOnOverlayClick is set; Escape still closes it.
2931
2932
  @default true
2932
2933
  - `slideOut: boolean` = true — Whether to animate the drawer when closing.
2933
2934
  @default true
2934
- - **Dropdown** — Overlay selection menu (aka Overflow Menu, Kebab Menu, Meatball Menu, Vertical Ellipsis, Horizontal Ellipsis, Three Dots Menu, More Menu, App Switcher, オーバーフローメニュー, ケバブメニュー, ミートボールメニュー)
2935
+ - **Dropdown** — Overlay selection menu (aka Overflow Menu, Kebab Menu, Meatball Menu, Vertical Ellipsis, Horizontal Ellipsis, Three Dots Menu, More Menu, App Switcher, オーバーフローメニュー, ケバブメニュー, ミートボールメニュー, Menu Button)
2935
2936
  - `children: ReactNode` (required) — Dropdown parts (Dropdown.Trigger and Dropdown.Menu).
2936
2937
  - `asChild: boolean` = false — If true, the dropdown will be rendered as its child, merging its props onto that child.
2937
2938
  - `defaultOpen: boolean` = false — Whether the menu starts open. Use it for a screenshot, a test, or a menu that should
@@ -2976,7 +2977,7 @@ is marked.
2976
2977
  - `children: ReactNode` (required) — The target element which the Popconfirm will be attached to
2977
2978
  - `icon: ReactNode` — Customize the icon
2978
2979
  - `disabled: boolean` = false — Whether to show the popconfirm
2979
- - **Popover** — Contextual overlay
2980
+ - **Popover** — Contextual overlay (aka Info Label, Info Button)
2980
2981
  - `children: ReactNode` (required) — Popover parts (PopoverTrigger, PopoverContent, etc.).
2981
2982
  - `className: string` — Additional CSS class name for the container.
2982
2983
  - `defaultOpen: boolean` = false — If true, the popover component will manage its own open state.
@@ -3690,6 +3691,15 @@ Exported hooks. Prefer them over hand-rolled equivalents (`matchMedia` listeners
3690
3691
  const isDesktop = useBreakpointUp("lg");
3691
3692
  ```
3692
3693
 
3694
+ - **useConfirm** — `import { useConfirm } from "wimui/overlay"` — Ask the user to confirm an action and wait for the answer, from anywhere under `ConfirmProvider`. Resolves to true when the user confirms, and to false when they cancel, press Escape, or the provider unmounts. Use it before an action the user cannot easily undo; for an action that can be undone, run it and offer Undo in a `Snackbar` instead.
3695
+ - Signature: `(): ConfirmFunction`
3696
+
3697
+ ```tsx
3698
+ const confirm = useConfirm();
3699
+ const ok = await confirm({ title: "Delete this file?", confirmLabel: "Delete", intent: "danger" });
3700
+ if (ok) await deleteFile(id);
3701
+ ```
3702
+
3693
3703
  - **useMediaQuery** — `import { useMediaQuery } from "wimui"` — Subscribe to a CSS media query and track whether it currently matches.
3694
3704
  - Signature: `(query: string, defaultState?: boolean): boolean`
3695
3705
 
package/dist/llms.txt CHANGED
@@ -4,7 +4,7 @@
4
4
 
5
5
  ## What this is
6
6
 
7
- **wimui** v0.75.2 — a React 19 component library: 230 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.1 — 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
 
@@ -218,9 +218,9 @@ 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.
221
+ - **OverflowList** — Lays out items in one row and folds the ones that do not fit into a "+N" indicator. (aka Overflow)
222
222
  - **ScrollArea** — A custom scrollbar component that provides high-performance, cross-browser consistent themes while maintaining a native-like feel.
223
- - **Sidebar** — A collapsible navigation or informational panel on the side of the screen (aka Source List, Inspector)
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
225
  - **Splitter** — Split and resize panels (aka Resizable, Resizable Panels, Split Pane)
226
226
  - **Stack** — Vertical/Horizontal alignment
@@ -237,7 +237,7 @@ export function BillingOverview() {
237
237
  - **Checkbox** — Multiple choice
238
238
  - **CheckboxGroup** — Shared state checkboxes
239
239
  - **ColorInput** — Input with color preview (aka Color Well, Color Field)
240
- - **ColorPicker** — Color selection picker
240
+ - **ColorPicker** — Color selection picker (aka Swatch Picker)
241
241
  - **Combobox** — Select with search (aka Autocomplete, Auto Complete)
242
242
  - **CopyButton** — Copy to clipboard
243
243
  - **CounterTextarea** — Textarea with character count display
@@ -247,7 +247,7 @@ export function BillingOverview() {
247
247
  - **Dropzone** — Drag & drop files
248
248
  - **FieldError** — Validation messages
249
249
  - **Fieldset** — Form grouping
250
- - **FieldTemplate** — Standardizes label placement, required markings, and error message display for all form-related components.
250
+ - **FieldTemplate** — Standardizes label placement, required markings, and error message display for all form-related components. (aka Field)
251
251
  - **FileUpload** — File selection (aka Upload, File Input)
252
252
  - **FloatButton** — Floating action buttons
253
253
  - **IconButton** — A square button containing only an icon without a text label.
@@ -259,7 +259,7 @@ export function BillingOverview() {
259
259
  - **InputMask** — Formatted inputs
260
260
  - **LinkButton** — Anchor styled as button
261
261
  - **Mentions** — @ / # suggestions
262
- - **MultiSelect** — Multiple selection
262
+ - **MultiSelect** — Multiple selection (aka Tag Picker)
263
263
  - **NumberInput** — Input with step adjustments (aka Spin Button, Numeric Stepper)
264
264
  - **OtpInput** — One-time password fields (aka Pin Input, Input OTP, PIN Code Input)
265
265
  - **PasswordInput** — Password with toggle
@@ -269,9 +269,9 @@ export function BillingOverview() {
269
269
  - **Radio** — Single choice
270
270
  - **RadioGroup** — Shared state radio buttons
271
271
  - **RangeSlider** — Range selection
272
- - **Rating** — Star rating (aka Star Rating, Rating Indicator)
272
+ - **Rating** — Star rating (aka Star Rating, Rating Indicator, Rating Display)
273
273
  - **RichTextEditor** — WYSIWYG rich text editor
274
- - **SearchInput** — Search with clear button (aka Search Field, Search Bar)
274
+ - **SearchInput** — Search with clear button (aka Search Field, Search Bar, Search Box)
275
275
  - **SegmentedControl** — Button-style controls for switching between a small set of mutually exclusive options (aka Segmented Buttons, Segmented Picker)
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
@@ -290,7 +290,7 @@ export function BillingOverview() {
290
290
 
291
291
  ### feedback — `import { … } from "wimui/feedback"`
292
292
 
293
- - **Alert** — Important messages
293
+ - **Alert** — Important messages (aka Message Bar)
294
294
  - **Autosave** — Inline status indicator for automatic save state
295
295
  - **Banner** — Top prominent messages
296
296
  - **ErrorBoundary** — Runtime error fallback
@@ -298,7 +298,7 @@ export function BillingOverview() {
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
- - **Progress** — Progress bar
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
304
  - **Result** — Task status indicator
@@ -306,8 +306,8 @@ export function BillingOverview() {
306
306
  - **Skeleton** — Placeholder for content loading states. (aka Shimmer)
307
307
  - **Snackbar** — Bottom notifications
308
308
  - **Spinner** — A rotating icon indicating background activity or data fetching (aka Activity Indicator)
309
- - **Toast** — Non-intrusive floating messages that provide feedback on system operations (aka Message, Sonner)
310
- - **Tour** — Sequential guided walkthroughs to onboard users or highlight features
309
+ - **Toast** — Non-intrusive floating messages that provide feedback on system operations (aka Message, Sonner, Toaster)
310
+ - **Tour** — Sequential guided walkthroughs to onboard users or highlight features (aka Teaching Popover, Coach Mark)
311
311
 
312
312
  ### navigation — `import { … } from "wimui/navigation"`
313
313
 
@@ -316,7 +316,7 @@ export function BillingOverview() {
316
316
  - **BackTop** — Back to top button (aka Back to Top)
317
317
  - **Breadcrumb** — Location trace (aka Path Bar, Path Control)
318
318
  - **CommandPalette** — Cmd+K search overlay (aka Command Bar, Quick Open)
319
- - **HamburgerMenu** — Toggleable menu (aka Sandwich Menu, Navigation Drawer Trigger, Nav Toggle, Cheeseburger Menu, Veggie Burger Menu, Pancake Menu, Bacon Menu, Hot Dog Menu, ハンバーガーメニュー, サンドイッチメニュー)
319
+ - **HamburgerMenu** — Toggleable menu (aka Sandwich Menu, Navigation Drawer Trigger, Nav Toggle, Cheeseburger Menu, Veggie Burger Menu, Pancake Menu, Bacon Menu, Hot Dog Menu, ハンバーガーメニュー, サンドイッチメニュー, Hamburger)
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.
@@ -326,7 +326,7 @@ export function BillingOverview() {
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
329
- - **Tabs** — A container to organize related content into switchable view panels
329
+ - **Tabs** — A container to organize related content into switchable view panels (aka Tab List)
330
330
 
331
331
  ### data-display — `import { … } from "wimui/data-display"`
332
332
 
@@ -369,25 +369,26 @@ export function BillingOverview() {
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
371
  - **Table** — Rows and columns for displaying structured data efficiently
372
- - **Tag** — Compact visual descriptors used for labeling or categorizing content
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)
375
- - **TreeView** — Hierarchical data (aka Outline View)
375
+ - **TreeView** — Hierarchical data (aka Outline View, Tree, Flat Tree)
376
376
  - **VirtualList** — Efficiently renders large lists by virtualizing off-screen items
377
377
 
378
378
  ### overlay — `import { … } from "wimui/overlay"`
379
379
 
380
380
  - **BottomSheet** — Mobile bottom overlay (aka Sheet, Action Sheet)
381
+ - **Confirm** — Opens a confirmation dialog from code with await confirm() and returns true or false.
381
382
  - **ContextMenu** — Right-click menus
382
383
  - **Dialog** — Focused task windows (aka Modal, Modal Dialog)
383
- - **Drawer** — Slide-out detail panels (aka Navigation Drawer)
384
- - **Dropdown** — Overlay selection menu (aka Overflow Menu, Kebab Menu, Meatball Menu, Vertical Ellipsis, Horizontal Ellipsis, Three Dots Menu, More Menu, App Switcher, オーバーフローメニュー, ケバブメニュー, ミートボールメニュー)
384
+ - **Drawer** — Slide-out detail panels (aka Navigation Drawer, Overlay Drawer)
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)
385
386
  - **FocusTrap** — Focus management
386
387
  - **HoverCard** — Rich content on hover
387
388
  - **Menu** — General menus
388
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`.
389
390
  - **Popconfirm** — Confirmation overlay
390
- - **Popover** — Contextual overlay
391
+ - **Popover** — Contextual overlay (aka Info Label, Info Button)
391
392
  - **Portal** — Out-of-hierarchy render
392
393
  - **Tooltip** — Information on hover (aka Help Tag)
393
394
 
@@ -462,6 +463,7 @@ Exported hooks. Prefer them over hand-rolled equivalents (`matchMedia` listeners
462
463
  - **useBreakpoint** — `import { useBreakpoint } from "wimui"` — Resolve the current active breakpoint — the largest whose min-width the viewport satisfies. Returns the smallest breakpoint below the first threshold. SSR-safe (defaults to the smallest until mounted).
463
464
  - **useBreakpointDown** — `import { useBreakpointDown } from "wimui"` — Track whether the viewport is below a named breakpoint (max-width), mirroring the SCSS `down()` mixin — the JS equivalent of HamburgerMenu's `visibleBelow`. SSR-safe.
464
465
  - **useBreakpointUp** — `import { useBreakpointUp } from "wimui"` — Track whether the viewport is at or above a named breakpoint (min-width), mirroring the SCSS `up()` mixin. SSR-safe.
466
+ - **useConfirm** — `import { useConfirm } from "wimui/overlay"` — Ask the user to confirm an action and wait for the answer, from anywhere under `ConfirmProvider`. Resolves to true when the user confirms, and to false when they cancel, press Escape, or the provider unmounts. Use it before an action the user cannot easily undo; for an action that can be undone, run it and offer Undo in a `Snackbar` instead.
465
467
  - **useMediaQuery** — `import { useMediaQuery } from "wimui"` — Subscribe to a CSS media query and track whether it currently matches.
466
468
  - **useNotification** — `import { useNotification } from "wimui/feedback"` — Show a notification card in a corner of the screen from anywhere under `NotificationProvider`. Notifications stack, carry a title and a body, and suit events that happened elsewhere (a finished export, a new comment) rather than the result of the user's last action.
467
469
  - **useSnackbar** — `import { useSnackbar } from "wimui/feedback"` — Show a single message bar at the edge of the screen from anywhere under `SnackbarProvider`. One message at a time: showing a new one replaces the current one. Use it when the message may carry one action (for example "Undo").
@@ -76,6 +76,7 @@
76
76
  "edit": "Edit",
77
77
  "finish": "Finish",
78
78
  "next": "Next",
79
+ "ok": "OK",
79
80
  "save": "Save",
80
81
  "search": "Search",
81
82
  "submit": "Submit",
@@ -144,7 +144,8 @@
144
144
  "treeDiagram_desc": "Lays out a tree such as an org chart from the data alone, with parents centred over their children and collapsible subtrees.",
145
145
  "pivotTable_desc": "Draws aggregated data as a table with multi-level row and column headings, subtotals and grand totals.",
146
146
  "overflowList_desc": "Lays out items in one row and folds the ones that do not fit into a \"+N\" indicator.",
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."
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
+ "confirm_desc": "Opens a confirmation dialog from code with await confirm() and returns true or false."
148
149
  },
149
150
  "cat": {
150
151
  "ai": "AI"
@@ -76,6 +76,7 @@
76
76
  "edit": "編集",
77
77
  "finish": "完了",
78
78
  "next": "次へ",
79
+ "ok": "OK",
79
80
  "save": "保存",
80
81
  "search": "検索",
81
82
  "submit": "送信",
@@ -216,7 +216,8 @@
216
216
  "treeDiagram_desc": "組織図のような木を、座標を渡さずデータだけから並べます。親は子の中央に置き、部分木は折りたためます。",
217
217
  "pivotTable_desc": "集計済みのデータを、多段の行見出し・列見出しと小計・総計を持つ表として描画します。",
218
218
  "overflowList_desc": "項目を 1 行に並べ、入らない分を「+N」にまとめます。",
219
- "selectionBar_desc": "表の上に置き、選んだ行の数・その行への操作・選択の解除を出すバー。件数の変化をスクリーンリーダーに伝える。"
219
+ "selectionBar_desc": "表の上に置き、選んだ行の数・その行への操作・選択の解除を出すバー。件数の変化をスクリーンリーダーに伝える。",
220
+ "confirm_desc": "await confirm() でコードから確認のダイアログを開き、true か false を返します。"
220
221
  },
221
222
  "effects": {
222
223
  "common_vars": "共通変数"
@@ -76,6 +76,7 @@
76
76
  "edit": "Editar",
77
77
  "finish": "Concluir",
78
78
  "next": "Próximo",
79
+ "ok": "OK",
79
80
  "save": "Salvar",
80
81
  "search": "Pesquisar",
81
82
  "submit": "Enviar",
@@ -216,7 +216,8 @@
216
216
  "treeDiagram_desc": "Organiza uma árvore, como um organograma, apenas a partir dos dados, com os pais centralizados sobre os filhos e subárvores recolhíveis.",
217
217
  "pivotTable_desc": "Desenha dados agregados como uma tabela com cabeçalhos de linha e de coluna em vários níveis, subtotais e totais gerais.",
218
218
  "overflowList_desc": "Organiza itens em uma única linha e agrupa os que não cabem em um indicador \"+N\".",
219
- "selectionBar_desc": "Barra acima de uma tabela que mostra o número de linhas selecionadas, as ações para elas e uma forma de limpar a seleção. Anuncia a contagem para leitores de tela."
219
+ "selectionBar_desc": "Barra acima de uma tabela que mostra o número de linhas selecionadas, as ações para elas e uma forma de limpar a seleção. Anuncia a contagem para leitores de tela.",
220
+ "confirm_desc": "Abre uma caixa de diálogo de confirmação pelo código com await confirm() e devolve true ou false."
220
221
  },
221
222
  "effects": {
222
223
  "common_vars": "Variáveis Comuns"
package/dist/overlay.cjs CHANGED
@@ -1,2 +1,2 @@
1
1
  "use client";
2
- Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./components/overlay/Portal/Portal.cjs"),t=require("./components/overlay/FocusTrap/FocusTrap.cjs"),n=require("./components/overlay/Drawer/Drawer.cjs"),r=require("./components/overlay/Tooltip/Tooltip.cjs"),i=require("./components/overlay/Dialog/Dialog.cjs"),a=require("./components/overlay/Dropdown/Dropdown.cjs"),o=require("./components/overlay/BottomSheet/BottomSheet.cjs"),s=require("./components/overlay/ContextMenu/ContextMenu.cjs"),c=require("./components/overlay/HoverCard/HoverCard.cjs"),l=require("./components/overlay/Menu/Menu.cjs"),u=require("./components/overlay/Popover/Popover.cjs"),d=require("./components/overlay/Popconfirm/Popconfirm.cjs");exports.BottomSheet=o.BottomSheet,exports.BottomSheetBody=o.BottomSheetBody,exports.BottomSheetClose=o.BottomSheetClose,exports.BottomSheetContent=o.BottomSheetContent,exports.BottomSheetDescription=o.BottomSheetDescription,exports.BottomSheetFooter=o.BottomSheetFooter,exports.BottomSheetHeader=o.BottomSheetHeader,exports.BottomSheetTitle=o.BottomSheetTitle,exports.BottomSheetTrigger=o.BottomSheetTrigger,exports.ContextMenu=s.ContextMenu,exports.ContextMenuDivider=s.ContextMenuDivider,exports.ContextMenuGroup=s.ContextMenuGroup,exports.ContextMenuItem=s.ContextMenuItem,exports.Dialog=i.Dialog,exports.DialogClose=i.DialogClose,exports.DialogContent=i.DialogContent,exports.DialogDescription=i.DialogDescription,exports.DialogFooter=i.DialogFooter,exports.DialogHeader=i.DialogHeader,exports.DialogTitle=i.DialogTitle,exports.DialogTrigger=i.DialogTrigger,exports.Drawer=n.Drawer,exports.DrawerBody=n.DrawerBody,exports.DrawerClose=n.DrawerClose,exports.DrawerContent=n.DrawerContent,exports.DrawerDescription=n.DrawerDescription,exports.DrawerFooter=n.DrawerFooter,exports.DrawerHeader=n.DrawerHeader,exports.DrawerTitle=n.DrawerTitle,exports.DrawerTrigger=n.DrawerTrigger,exports.Dropdown=a.Dropdown,exports.DropdownItem=a.DropdownItem,exports.DropdownMenu=a.DropdownMenu,exports.DropdownTrigger=a.DropdownTrigger,exports.FocusTrap=t.FocusTrap,exports.HoverCard=c.HoverCard,exports.HoverCardContent=c.HoverCardContent,exports.HoverCardTrigger=c.HoverCardTrigger,exports.Menu=l.Menu,exports.MenuDivider=l.MenuDivider,exports.MenuItem=l.MenuItem,exports.MenuItemGroup=l.MenuItemGroup,exports.Popconfirm=d.Popconfirm,exports.Popover=u.Popover,exports.PopoverClose=u.PopoverClose,exports.PopoverContent=u.PopoverContent,exports.PopoverTrigger=u.PopoverTrigger,exports.Portal=e.Portal,exports.SubMenu=l.SubMenu,exports.Tooltip=r.Tooltip,exports.TooltipContent=r.TooltipContent,exports.TooltipTrigger=r.TooltipTrigger;
2
+ Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./components/overlay/Portal/Portal.cjs"),t=require("./components/overlay/FocusTrap/FocusTrap.cjs"),n=require("./components/overlay/Drawer/Drawer.cjs"),r=require("./components/overlay/Tooltip/Tooltip.cjs"),i=require("./components/overlay/Dialog/Dialog.cjs"),a=require("./components/overlay/Dropdown/Dropdown.cjs"),o=require("./components/overlay/BottomSheet/BottomSheet.cjs"),s=require("./components/overlay/ContextMenu/ContextMenu.cjs"),c=require("./components/overlay/HoverCard/HoverCard.cjs"),l=require("./components/overlay/Menu/Menu.cjs"),u=require("./components/overlay/Popover/Popover.cjs"),d=require("./components/overlay/Popconfirm/Popconfirm.cjs"),f=require("./components/overlay/Confirm/Confirm.cjs");exports.BottomSheet=o.BottomSheet,exports.BottomSheetBody=o.BottomSheetBody,exports.BottomSheetClose=o.BottomSheetClose,exports.BottomSheetContent=o.BottomSheetContent,exports.BottomSheetDescription=o.BottomSheetDescription,exports.BottomSheetFooter=o.BottomSheetFooter,exports.BottomSheetHeader=o.BottomSheetHeader,exports.BottomSheetTitle=o.BottomSheetTitle,exports.BottomSheetTrigger=o.BottomSheetTrigger,exports.ConfirmProvider=f.ConfirmProvider,exports.ContextMenu=s.ContextMenu,exports.ContextMenuDivider=s.ContextMenuDivider,exports.ContextMenuGroup=s.ContextMenuGroup,exports.ContextMenuItem=s.ContextMenuItem,exports.Dialog=i.Dialog,exports.DialogClose=i.DialogClose,exports.DialogContent=i.DialogContent,exports.DialogDescription=i.DialogDescription,exports.DialogFooter=i.DialogFooter,exports.DialogHeader=i.DialogHeader,exports.DialogTitle=i.DialogTitle,exports.DialogTrigger=i.DialogTrigger,exports.Drawer=n.Drawer,exports.DrawerBody=n.DrawerBody,exports.DrawerClose=n.DrawerClose,exports.DrawerContent=n.DrawerContent,exports.DrawerDescription=n.DrawerDescription,exports.DrawerFooter=n.DrawerFooter,exports.DrawerHeader=n.DrawerHeader,exports.DrawerTitle=n.DrawerTitle,exports.DrawerTrigger=n.DrawerTrigger,exports.Dropdown=a.Dropdown,exports.DropdownItem=a.DropdownItem,exports.DropdownMenu=a.DropdownMenu,exports.DropdownTrigger=a.DropdownTrigger,exports.FocusTrap=t.FocusTrap,exports.HoverCard=c.HoverCard,exports.HoverCardContent=c.HoverCardContent,exports.HoverCardTrigger=c.HoverCardTrigger,exports.Menu=l.Menu,exports.MenuDivider=l.MenuDivider,exports.MenuItem=l.MenuItem,exports.MenuItemGroup=l.MenuItemGroup,exports.Popconfirm=d.Popconfirm,exports.Popover=u.Popover,exports.PopoverClose=u.PopoverClose,exports.PopoverContent=u.PopoverContent,exports.PopoverTrigger=u.PopoverTrigger,exports.Portal=e.Portal,exports.SubMenu=l.SubMenu,exports.Tooltip=r.Tooltip,exports.TooltipContent=r.TooltipContent,exports.TooltipTrigger=r.TooltipTrigger,exports.useConfirm=f.useConfirm;
package/dist/overlay.d.ts CHANGED
@@ -10,3 +10,4 @@ export * from './components/overlay/Popover/Popover.js';
10
10
  export * from './components/overlay/Tooltip/Tooltip.js';
11
11
  export * from './components/overlay/Portal/Portal.js';
12
12
  export * from './components/overlay/FocusTrap/FocusTrap.js';
13
+ export * from './components/overlay/Confirm/Confirm.js';
package/dist/overlay.js CHANGED
@@ -11,4 +11,5 @@ import { HoverCard as z, HoverCardContent as B, HoverCardTrigger as V } from "./
11
11
  import { Menu as H, MenuDivider as U, MenuItem as W, MenuItemGroup as G, SubMenu as K } from "./components/overlay/Menu/Menu.js";
12
12
  import { Popover as q, PopoverClose as J, PopoverContent as Y, PopoverTrigger as X } from "./components/overlay/Popover/Popover.js";
13
13
  import { Popconfirm as Z } from "./components/overlay/Popconfirm/Popconfirm.js";
14
- export { E as BottomSheet, D as BottomSheetBody, O as BottomSheetClose, k as BottomSheetContent, A as BottomSheetDescription, j as BottomSheetFooter, M as BottomSheetHeader, N as BottomSheetTitle, P as BottomSheetTrigger, F as ContextMenu, I as ContextMenuDivider, L as ContextMenuGroup, R as ContextMenuItem, m as Dialog, h as DialogClose, g as DialogContent, _ as DialogDescription, v as DialogFooter, y as DialogHeader, b as DialogTitle, x as DialogTrigger, n as Drawer, r as DrawerBody, i as DrawerClose, a as DrawerContent, o as DrawerDescription, s as DrawerFooter, c as DrawerHeader, l as DrawerTitle, u as DrawerTrigger, S as Dropdown, C as DropdownItem, w as DropdownMenu, T as DropdownTrigger, t as FocusTrap, z as HoverCard, B as HoverCardContent, V as HoverCardTrigger, H as Menu, U as MenuDivider, W as MenuItem, G as MenuItemGroup, Z as Popconfirm, q as Popover, J as PopoverClose, Y as PopoverContent, X as PopoverTrigger, e as Portal, K as SubMenu, d as Tooltip, f as TooltipContent, p as TooltipTrigger };
14
+ import { ConfirmProvider as Q, useConfirm as $ } from "./components/overlay/Confirm/Confirm.js";
15
+ export { E as BottomSheet, D as BottomSheetBody, O as BottomSheetClose, k as BottomSheetContent, A as BottomSheetDescription, j as BottomSheetFooter, M as BottomSheetHeader, N as BottomSheetTitle, P as BottomSheetTrigger, Q as ConfirmProvider, F as ContextMenu, I as ContextMenuDivider, L as ContextMenuGroup, R as ContextMenuItem, m as Dialog, h as DialogClose, g as DialogContent, _ as DialogDescription, v as DialogFooter, y as DialogHeader, b as DialogTitle, x as DialogTrigger, n as Drawer, r as DrawerBody, i as DrawerClose, a as DrawerContent, o as DrawerDescription, s as DrawerFooter, c as DrawerHeader, l as DrawerTitle, u as DrawerTrigger, S as Dropdown, C as DropdownItem, w as DropdownMenu, T as DropdownTrigger, t as FocusTrap, z as HoverCard, B as HoverCardContent, V as HoverCardTrigger, H as Menu, U as MenuDivider, W as MenuItem, G as MenuItemGroup, Z as Popconfirm, q as Popover, J as PopoverClose, Y as PopoverContent, X as PopoverTrigger, e as Portal, K as SubMenu, d as Tooltip, f as TooltipContent, p as TooltipTrigger, $ as useConfirm };
@@ -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 };