@ai-matrx/design-system 0.10.1 → 0.11.0

package/dist/index.d.cts

@@ -478,6 +478,110 @@ declare const CommandShortcut: {
     displayName: string;
 };
 
+/**
+ * ConfirmDialog — the `window.confirm` replacement, declarative half.
+ *
+ * WHY IT LIVES HERE AND NOT IN `@ai-matrx/kit` (census row 19i, decided by the
+ * package-graph ruling of 2026-09-07, on the row-20a Tooltip precedent).
+ *
+ * kit shipped this dialog with its own inlined AlertDialog, its own inlined
+ * button class strings, a hardcoded 80%-opaque black scrim, and
+ * `data-[state=open]:animate-in … zoom-in-95 … slide-in-from-top-[48%]` —
+ * host-plugin utilities `tailwindcss-animate`/`tw-animate-css` supply and a
+ * package cannot ship. kit ships NO stylesheet at all, so in three of the four
+ * consumers the most consequential surface in the app (the one standing
+ * between a user and a destroyed thing) appeared with no animation, no error,
+ * and a scrim that ignored the theme. kit could not import the fix:
+ * `@ai-matrx/design-system` depends on `@ai-matrx/kit`, so importing back is a
+ * cycle; giving kit its own sheet would invent a second required-CSS contract
+ * no consumer performs (the C26 silent host contract, one layer down).
+ *
+ * The resolution is the one row 20a already proved: the surface moves to the
+ * package that owns the surface. This file is built on THIS package's
+ * `AlertDialog` — so it inherits, for free and forever:
+ *
+ *   - the package motion layer (`matrx-motion-overlay` / `matrx-motion-dialog`),
+ *     whose rules ship in `styles.css` and are proven present in the tarball;
+ *   - `--matrx-overlay-scrim`, a token that answers to the host's theme,
+ *     instead of an opaque black literal;
+ *   - AlertDialog ruling 3 — clamped to `max-h-[85dvh]`, scrolling inside
+ *     itself, with a sticky footer. **This is what makes the consequence-first
+ *     copy law survivable**: a confirmation that names everything it is about
+ *     to destroy can be long, and in kit's copy a long one pushed Cancel and
+ *     Continue below the fold of a short viewport with no backdrop dismissal —
+ *     a dead end on a destructive action;
+ *   - `buttonVariants` as the ONE source of button appearance, including the
+ *     44px coarse-pointer target;
+ *   - `PortalContainerProvider`, so a dialog opened inside a popped-out window
+ *     panel renders in THAT window's document.
+ *
+ * kit keeps `./confirm-opener` — the pure, React-free imperative `confirm()`
+ * and its `globalThis`-slotted host registry — and re-exports nothing of this.
+ * Consumers mount `<ConfirmDialogHost />` from here and call `confirm()` from
+ * there. See `confirm-host.tsx` for the join.
+ *
+ * BEHAVIOR IS THE KIT PORT, VERBATIM. Every prop, default and interaction is
+ * unchanged; only the chrome underneath it is the package's.
+ *
+ * Pattern: hold the pending target in state, render `<ConfirmDialog />` once at
+ * the bottom of the component, and open it by setting the target. When busy
+ * state is meaningful (a network delete that should hold the dialog open with a
+ * spinner), use THIS component inline; the imperative `confirm()` closes
+ * immediately on click.
+ */
+
+interface ConfirmDialogProps {
+    open: boolean;
+    onOpenChange: (open: boolean) => void;
+    title: React.ReactNode;
+    /**
+     * THE CONSEQUENCE. Per the platform's destructive-and-expensive-actions law,
+     * a confirmation must name what is lost, what is duplicated, and/or what it
+     * costs — "Are you sure?" is not a confirmation. This renders as the dialog's
+     * accessible description, so a screen-reader user is told the consequence
+     * too, and it is never clamped or truncated.
+     */
+    description?: React.ReactNode | undefined;
+    /**
+     * Rich body rendered between the header and the footer, OUTSIDE the
+     * description `<p>` — use for block-level content (diffs, previews, lists of
+     * exactly what is about to be deleted) that would be invalid HTML inside
+     * `description`.
+     */
+    content?: React.ReactNode | undefined;
+    /** Extra classes for the dialog content (e.g. a wider max-w for diffs). */
+    contentClassName?: string | undefined;
+    confirmLabel?: string | undefined;
+    /**
+     * `null` hides the cancel button entirely — for acknowledge-only dialogs
+     * where there is nothing to cancel. Anything else labels it.
+     */
+    cancelLabel?: string | null | undefined;
+    variant?: "default" | "destructive" | undefined;
+    busy?: boolean | undefined;
+    /**
+     * Blocks confirming without pretending work is in flight. For a dialog whose
+     * `content` asks the user something the action cannot proceed without — the
+     * choice is missing, not loading — `busy` would show a misleading spinner.
+     */
+    confirmDisabled?: boolean | undefined;
+    /**
+     * Explicit portal target. Default (undefined): the container injected by
+     * `PortalContainerProvider`, else `document.body`. Hosts with retargeting
+     * needs (a popped-out browser window whose dialog must render in THAT
+     * window's document) may still pass the element directly.
+     */
+    portalContainer?: HTMLElement | null | undefined;
+    onConfirm: () => void | Promise<void>;
+}
+/**
+ * Drop-in replacement for `window.confirm`. Use this anywhere you would
+ * otherwise reach for a browser-level confirm dialog.
+ */
+declare function ConfirmDialog({ open, onOpenChange, title, description, content, contentClassName, confirmLabel, cancelLabel, variant, busy, confirmDisabled, portalContainer, onConfirm, }: ConfirmDialogProps): React.JSX.Element;
+
+declare function ConfirmDialogHost(): React.JSX.Element;
+
 /**
  * ContextMenu — the right-click menu primitive.
  *
@@ -1750,36 +1854,8 @@ declare const TooltipContent: React.ForwardRefExoticComponent<TooltipContentProp
  */
 /** Modal scrims: Dialog, AlertDialog, Sheet, CommandDialog. Fade only. */
 declare const MOTION_OVERLAY = "matrx-motion-overlay";
-/** The centred dialog card. Fades and scales; centring is not its business. */
+/** The centred dialog card. Fades and scales, ending on the `-50%` centring. */
 declare const MOTION_DIALOG = "matrx-motion-dialog";
-/**
- * THE CENTRING OF A CENTRED DIALOG CARD — package-owned, in the `translate`
- * property, and NEVER a Tailwind `translate-x-[-50%] translate-y-[-50%]` pair.
- *
- * Those utilities do not compile to the same thing in every host: Tailwind v3
- * writes them into `transform`, Tailwind v4 writes them into the independent
- * `translate` property, which COMPOSES with `transform` instead of being
- * replaced by it. 0.10.0's keyframes restated the centring inside `transform`,
- * which was harmless on v3 and doubled the centring on v4 — the card flew in
- * from off the top-left of the viewport for the animation's whole duration and
- * snapped into place at the end (fixed in 0.10.1).
- *
- * Owning it here means one spelling that reads the same on both, and it frees
- * `transform` so the keyframes carry ONLY the delta. Put this on every centred
- * surface UNCONDITIONALLY — it is geometry, so unlike {@link MOTION_DIALOG} it
- * must survive `animated={false}`. Its rule ships in `styles.css`.
- */
-declare const CENTERED_DIALOG = "matrx-dialog-centered";
-/**
- * The resting gap between a `popper`-positioned surface and its trigger, for
- * the primitives that want one (today: `Select`). Same law and same reason as
- * {@link CENTERED_DIALOG} — a position an animated surface holds AT REST is
- * the `translate` property's job, never a Tailwind translate utility, because
- * those land in `transform` on a v3 host and in `translate` on a v4 one while
- * the keyframes animate `transform` either way. Sizes from
- * `--matrx-popper-offset`; keys off Radix's `data-side`.
- */
-declare const POPPER_OFFSET = "matrx-popper-offset";
 /** The mobile Dialog / CommandDialog bottom sheet. Slides up and fades. */
 declare const MOTION_BOTTOM_SHEET = "matrx-motion-bottom-sheet";
 /**
@@ -1816,4 +1892,4 @@ declare const ALL_MOTION_CLASSES: readonly ["matrx-motion-overlay", "matrx-motio
  */
 declare const FORBIDDEN_HOST_MOTION_UTILITIES: readonly ["animate-in", "animate-out", "fade-in", "fade-out", "zoom-in", "zoom-out", "slide-in-from", "slide-out-to", "animate-accordion", "animate-slide-down", "animate-slide-up", "animate-pulse", "animate-spin"];
 
-export { ALL_MOTION_CLASSES, Accordion, AccordionContent, AccordionItem, type AccordionProps, type AccordionSize, AccordionTrigger, type AccordionTriggerProps, Alert, AlertDescription, AlertDialog, AlertDialogAction, AlertDialogCancel, AlertDialogContent, AlertDialogContentPrimitive, type AlertDialogContentProps, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogOverlay, AlertDialogPortal, AlertDialogTitle, AlertDialogTrigger, type AlertProps, AlertTitle, Avatar, AvatarFallback, AvatarImage, type AvatarProps, type AvatarSize, Badge, type BadgeProps, BasicInput, BasicTextarea, BottomSheet, BottomSheetBody, type BottomSheetBodyProps, BottomSheetFooter, type BottomSheetFooterProps, BottomSheetHeader, type BottomSheetHeaderProps, type BottomSheetProps, Button, type ButtonProps, CENTERED_DIALOG, Card, CardAction, CardContent, CardDescription, CardFooter, CardHeader, type CardProps, type CardSize, CardTitle, Checkbox, type CheckboxProps, type CheckboxSize, Collapsible, CollapsibleContent, type CollapsibleContentProps, CollapsibleTrigger, Command, CommandDialog, type CommandDialogProps, CommandEmpty, CommandGroup, CommandInput, CommandItem, CommandList, CommandSeparator, CommandShortcut, ContextMenu, ContextMenuCheckboxItem, ContextMenuContent, type ContextMenuContentProps, ContextMenuGroup, ContextMenuItem, ContextMenuLabel, ContextMenuPortal, ContextMenuRadioGroup, ContextMenuRadioItem, ContextMenuSeparator, ContextMenuShortcut, ContextMenuSub, ContextMenuSubContent, ContextMenuSubTrigger, ContextMenuTrigger, type CreatableOption, CreatablePicker, type CreatablePickerProps, DEFAULT_SCORE_THRESHOLDS, Dialog, DialogClose, DialogContent, DialogContentPrimitive, type DialogContentProps, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, DialogTitle, DialogTrigger, Drawer, DrawerBody, DrawerClose, DrawerContent, DrawerContentPrimitive, type DrawerContentProps, DrawerDescription, type DrawerDirection, DrawerFooter, DrawerHeader, DrawerOverlay, DrawerPortal, type DrawerProps, type DrawerSize, DrawerTitle, DrawerTrigger, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, type DropdownMenuContentProps, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, EditableLabel, type EditableLabelActivation, type EditableLabelCommitMode, type EditableLabelProps, EnterInput, type EnterInputProps, FORBIDDEN_HOST_MOTION_UTILITIES, HoverCard, HoverCardContent, type HoverCardContentProps, HoverCardTrigger, Input, type InputProps, type InputVariant, InputWithPrefix, type InputWithPrefixProps, Label, MOBILE_BREAKPOINT, MOTION_BOTTOM_SHEET, MOTION_DIALOG, MOTION_OVERLAY, MOTION_POPPER, MOTION_PULSE, MOTION_SHEET, MOTION_SPIN, OverflowToolbar, type OverflowToolbarProps, POPPER_OFFSET, type PickerIcon, Popover, PopoverAnchor, PopoverContent, type PopoverContentProps, PopoverTrigger, PortalContainerProvider, type PortalContainerProviderProps, Progress, type ProgressProps, type ProgressTone, RadioGroup, RadioGroupItem, type RadioGroupItemProps, type RadioGroupProps, type RadioGroupSize, RadixDialogModalProvider, type RadixDialogModalProviderProps, ResizableHandle, type ResizableHandleProps, type ResizableHandleSize, ResizablePanel, ResizablePanelGroup, ScoreRing, type ScoreRingProps, type ScoreThresholds, ScrollArea, type ScrollAreaProps, ScrollBar, type ScrollFadeState, type SegmentOption, SegmentedControl, type SegmentedControlProps, Select, SelectContent, type SelectContentProps, SelectGroup, SelectItem, SelectLabel, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, type SelectTriggerProps, SelectValue, Separator, Sheet, SheetClose, SheetContent, type SheetContentProps, SheetDescription, SheetFooter, SheetHeader, SheetOverlay, SheetPortal, SheetTitle, SheetTrigger, Skeleton, type SkeletonProps, Slider, type SliderProps, type SliderSize, Switch, type SwitchProps, type SwitchSize, TabbedBottomSheet, type TabbedBottomSheetProps, type TabbedBottomSheetTab, Table, TableBody, TableCaption, TableCell, TableFooter, TableHead, TableHeader, type TableHeaderProps, type TableProps, TableRow, type TableSize, Tabs, TabsContent, TabsList, TabsTrigger, TabsTriggerCore, Textarea, type TextareaProps, TextareaWithPrefix, type TextareaWithPrefixProps, Toggle, ToggleGroup, ToggleGroupItem, type ToggleGroupItemProps, type ToggleGroupProps, type ToggleProps, type ToolbarAction, type ToolbarActionTone, type ToolbarIcon, Tooltip, TooltipContent, type TooltipContentProps, TooltipProvider, TooltipTrigger, type UseScrollFadeResult, alertVariants, badgeVariants, buttonVariants, cn, scoreAccentBgClasses, scoreRingColorClasses, selectTriggerVariants, sheetVariants, toggleVariants, useAccordionSize, useCardSize, useDialogContainer, useDrawerDirection, useIsMobile, usePortalContainer, useRadixDialogModal, useScrollFade, useTableSize };
+export { ALL_MOTION_CLASSES, Accordion, AccordionContent, AccordionItem, type AccordionProps, type AccordionSize, AccordionTrigger, type AccordionTriggerProps, Alert, AlertDescription, AlertDialog, AlertDialogAction, AlertDialogCancel, AlertDialogContent, AlertDialogContentPrimitive, type AlertDialogContentProps, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogOverlay, AlertDialogPortal, AlertDialogTitle, AlertDialogTrigger, type AlertProps, AlertTitle, Avatar, AvatarFallback, AvatarImage, type AvatarProps, type AvatarSize, Badge, type BadgeProps, BasicInput, BasicTextarea, BottomSheet, BottomSheetBody, type BottomSheetBodyProps, BottomSheetFooter, type BottomSheetFooterProps, BottomSheetHeader, type BottomSheetHeaderProps, type BottomSheetProps, Button, type ButtonProps, Card, CardAction, CardContent, CardDescription, CardFooter, CardHeader, type CardProps, type CardSize, CardTitle, Checkbox, type CheckboxProps, type CheckboxSize, Collapsible, CollapsibleContent, type CollapsibleContentProps, CollapsibleTrigger, Command, CommandDialog, type CommandDialogProps, CommandEmpty, CommandGroup, CommandInput, CommandItem, CommandList, CommandSeparator, CommandShortcut, ConfirmDialog, ConfirmDialogHost, type ConfirmDialogProps, ContextMenu, ContextMenuCheckboxItem, ContextMenuContent, type ContextMenuContentProps, ContextMenuGroup, ContextMenuItem, ContextMenuLabel, ContextMenuPortal, ContextMenuRadioGroup, ContextMenuRadioItem, ContextMenuSeparator, ContextMenuShortcut, ContextMenuSub, ContextMenuSubContent, ContextMenuSubTrigger, ContextMenuTrigger, type CreatableOption, CreatablePicker, type CreatablePickerProps, DEFAULT_SCORE_THRESHOLDS, Dialog, DialogClose, DialogContent, DialogContentPrimitive, type DialogContentProps, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, DialogTitle, DialogTrigger, Drawer, DrawerBody, DrawerClose, DrawerContent, DrawerContentPrimitive, type DrawerContentProps, DrawerDescription, type DrawerDirection, DrawerFooter, DrawerHeader, DrawerOverlay, DrawerPortal, type DrawerProps, type DrawerSize, DrawerTitle, DrawerTrigger, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, type DropdownMenuContentProps, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, EditableLabel, type EditableLabelActivation, type EditableLabelCommitMode, type EditableLabelProps, EnterInput, type EnterInputProps, FORBIDDEN_HOST_MOTION_UTILITIES, HoverCard, HoverCardContent, type HoverCardContentProps, HoverCardTrigger, Input, type InputProps, type InputVariant, InputWithPrefix, type InputWithPrefixProps, Label, MOBILE_BREAKPOINT, MOTION_BOTTOM_SHEET, MOTION_DIALOG, MOTION_OVERLAY, MOTION_POPPER, MOTION_PULSE, MOTION_SHEET, MOTION_SPIN, OverflowToolbar, type OverflowToolbarProps, type PickerIcon, Popover, PopoverAnchor, PopoverContent, type PopoverContentProps, PopoverTrigger, PortalContainerProvider, type PortalContainerProviderProps, Progress, type ProgressProps, type ProgressTone, RadioGroup, RadioGroupItem, type RadioGroupItemProps, type RadioGroupProps, type RadioGroupSize, RadixDialogModalProvider, type RadixDialogModalProviderProps, ResizableHandle, type ResizableHandleProps, type ResizableHandleSize, ResizablePanel, ResizablePanelGroup, ScoreRing, type ScoreRingProps, type ScoreThresholds, ScrollArea, type ScrollAreaProps, ScrollBar, type ScrollFadeState, type SegmentOption, SegmentedControl, type SegmentedControlProps, Select, SelectContent, type SelectContentProps, SelectGroup, SelectItem, SelectLabel, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, type SelectTriggerProps, SelectValue, Separator, Sheet, SheetClose, SheetContent, type SheetContentProps, SheetDescription, SheetFooter, SheetHeader, SheetOverlay, SheetPortal, SheetTitle, SheetTrigger, Skeleton, type SkeletonProps, Slider, type SliderProps, type SliderSize, Switch, type SwitchProps, type SwitchSize, TabbedBottomSheet, type TabbedBottomSheetProps, type TabbedBottomSheetTab, Table, TableBody, TableCaption, TableCell, TableFooter, TableHead, TableHeader, type TableHeaderProps, type TableProps, TableRow, type TableSize, Tabs, TabsContent, TabsList, TabsTrigger, TabsTriggerCore, Textarea, type TextareaProps, TextareaWithPrefix, type TextareaWithPrefixProps, Toggle, ToggleGroup, ToggleGroupItem, type ToggleGroupItemProps, type ToggleGroupProps, type ToggleProps, type ToolbarAction, type ToolbarActionTone, type ToolbarIcon, Tooltip, TooltipContent, type TooltipContentProps, TooltipProvider, TooltipTrigger, type UseScrollFadeResult, alertVariants, badgeVariants, buttonVariants, cn, scoreAccentBgClasses, scoreRingColorClasses, selectTriggerVariants, sheetVariants, toggleVariants, useAccordionSize, useCardSize, useDialogContainer, useDrawerDirection, useIsMobile, usePortalContainer, useRadixDialogModal, useScrollFade, useTableSize };

package/dist/index.d.ts

@@ -478,6 +478,110 @@ declare const CommandShortcut: {
     displayName: string;
 };
 
+/**
+ * ConfirmDialog — the `window.confirm` replacement, declarative half.
+ *
+ * WHY IT LIVES HERE AND NOT IN `@ai-matrx/kit` (census row 19i, decided by the
+ * package-graph ruling of 2026-09-07, on the row-20a Tooltip precedent).
+ *
+ * kit shipped this dialog with its own inlined AlertDialog, its own inlined
+ * button class strings, a hardcoded 80%-opaque black scrim, and
+ * `data-[state=open]:animate-in … zoom-in-95 … slide-in-from-top-[48%]` —
+ * host-plugin utilities `tailwindcss-animate`/`tw-animate-css` supply and a
+ * package cannot ship. kit ships NO stylesheet at all, so in three of the four
+ * consumers the most consequential surface in the app (the one standing
+ * between a user and a destroyed thing) appeared with no animation, no error,
+ * and a scrim that ignored the theme. kit could not import the fix:
+ * `@ai-matrx/design-system` depends on `@ai-matrx/kit`, so importing back is a
+ * cycle; giving kit its own sheet would invent a second required-CSS contract
+ * no consumer performs (the C26 silent host contract, one layer down).
+ *
+ * The resolution is the one row 20a already proved: the surface moves to the
+ * package that owns the surface. This file is built on THIS package's
+ * `AlertDialog` — so it inherits, for free and forever:
+ *
+ *   - the package motion layer (`matrx-motion-overlay` / `matrx-motion-dialog`),
+ *     whose rules ship in `styles.css` and are proven present in the tarball;
+ *   - `--matrx-overlay-scrim`, a token that answers to the host's theme,
+ *     instead of an opaque black literal;
+ *   - AlertDialog ruling 3 — clamped to `max-h-[85dvh]`, scrolling inside
+ *     itself, with a sticky footer. **This is what makes the consequence-first
+ *     copy law survivable**: a confirmation that names everything it is about
+ *     to destroy can be long, and in kit's copy a long one pushed Cancel and
+ *     Continue below the fold of a short viewport with no backdrop dismissal —
+ *     a dead end on a destructive action;
+ *   - `buttonVariants` as the ONE source of button appearance, including the
+ *     44px coarse-pointer target;
+ *   - `PortalContainerProvider`, so a dialog opened inside a popped-out window
+ *     panel renders in THAT window's document.
+ *
+ * kit keeps `./confirm-opener` — the pure, React-free imperative `confirm()`
+ * and its `globalThis`-slotted host registry — and re-exports nothing of this.
+ * Consumers mount `<ConfirmDialogHost />` from here and call `confirm()` from
+ * there. See `confirm-host.tsx` for the join.
+ *
+ * BEHAVIOR IS THE KIT PORT, VERBATIM. Every prop, default and interaction is
+ * unchanged; only the chrome underneath it is the package's.
+ *
+ * Pattern: hold the pending target in state, render `<ConfirmDialog />` once at
+ * the bottom of the component, and open it by setting the target. When busy
+ * state is meaningful (a network delete that should hold the dialog open with a
+ * spinner), use THIS component inline; the imperative `confirm()` closes
+ * immediately on click.
+ */
+
+interface ConfirmDialogProps {
+    open: boolean;
+    onOpenChange: (open: boolean) => void;
+    title: React.ReactNode;
+    /**
+     * THE CONSEQUENCE. Per the platform's destructive-and-expensive-actions law,
+     * a confirmation must name what is lost, what is duplicated, and/or what it
+     * costs — "Are you sure?" is not a confirmation. This renders as the dialog's
+     * accessible description, so a screen-reader user is told the consequence
+     * too, and it is never clamped or truncated.
+     */
+    description?: React.ReactNode | undefined;
+    /**
+     * Rich body rendered between the header and the footer, OUTSIDE the
+     * description `<p>` — use for block-level content (diffs, previews, lists of
+     * exactly what is about to be deleted) that would be invalid HTML inside
+     * `description`.
+     */
+    content?: React.ReactNode | undefined;
+    /** Extra classes for the dialog content (e.g. a wider max-w for diffs). */
+    contentClassName?: string | undefined;
+    confirmLabel?: string | undefined;
+    /**
+     * `null` hides the cancel button entirely — for acknowledge-only dialogs
+     * where there is nothing to cancel. Anything else labels it.
+     */
+    cancelLabel?: string | null | undefined;
+    variant?: "default" | "destructive" | undefined;
+    busy?: boolean | undefined;
+    /**
+     * Blocks confirming without pretending work is in flight. For a dialog whose
+     * `content` asks the user something the action cannot proceed without — the
+     * choice is missing, not loading — `busy` would show a misleading spinner.
+     */
+    confirmDisabled?: boolean | undefined;
+    /**
+     * Explicit portal target. Default (undefined): the container injected by
+     * `PortalContainerProvider`, else `document.body`. Hosts with retargeting
+     * needs (a popped-out browser window whose dialog must render in THAT
+     * window's document) may still pass the element directly.
+     */
+    portalContainer?: HTMLElement | null | undefined;
+    onConfirm: () => void | Promise<void>;
+}
+/**
+ * Drop-in replacement for `window.confirm`. Use this anywhere you would
+ * otherwise reach for a browser-level confirm dialog.
+ */
+declare function ConfirmDialog({ open, onOpenChange, title, description, content, contentClassName, confirmLabel, cancelLabel, variant, busy, confirmDisabled, portalContainer, onConfirm, }: ConfirmDialogProps): React.JSX.Element;
+
+declare function ConfirmDialogHost(): React.JSX.Element;
+
 /**
  * ContextMenu — the right-click menu primitive.
  *
@@ -1750,36 +1854,8 @@ declare const TooltipContent: React.ForwardRefExoticComponent<TooltipContentProp
  */
 /** Modal scrims: Dialog, AlertDialog, Sheet, CommandDialog. Fade only. */
 declare const MOTION_OVERLAY = "matrx-motion-overlay";
-/** The centred dialog card. Fades and scales; centring is not its business. */
+/** The centred dialog card. Fades and scales, ending on the `-50%` centring. */
 declare const MOTION_DIALOG = "matrx-motion-dialog";
-/**
- * THE CENTRING OF A CENTRED DIALOG CARD — package-owned, in the `translate`
- * property, and NEVER a Tailwind `translate-x-[-50%] translate-y-[-50%]` pair.
- *
- * Those utilities do not compile to the same thing in every host: Tailwind v3
- * writes them into `transform`, Tailwind v4 writes them into the independent
- * `translate` property, which COMPOSES with `transform` instead of being
- * replaced by it. 0.10.0's keyframes restated the centring inside `transform`,
- * which was harmless on v3 and doubled the centring on v4 — the card flew in
- * from off the top-left of the viewport for the animation's whole duration and
- * snapped into place at the end (fixed in 0.10.1).
- *
- * Owning it here means one spelling that reads the same on both, and it frees
- * `transform` so the keyframes carry ONLY the delta. Put this on every centred
- * surface UNCONDITIONALLY — it is geometry, so unlike {@link MOTION_DIALOG} it
- * must survive `animated={false}`. Its rule ships in `styles.css`.
- */
-declare const CENTERED_DIALOG = "matrx-dialog-centered";
-/**
- * The resting gap between a `popper`-positioned surface and its trigger, for
- * the primitives that want one (today: `Select`). Same law and same reason as
- * {@link CENTERED_DIALOG} — a position an animated surface holds AT REST is
- * the `translate` property's job, never a Tailwind translate utility, because
- * those land in `transform` on a v3 host and in `translate` on a v4 one while
- * the keyframes animate `transform` either way. Sizes from
- * `--matrx-popper-offset`; keys off Radix's `data-side`.
- */
-declare const POPPER_OFFSET = "matrx-popper-offset";
 /** The mobile Dialog / CommandDialog bottom sheet. Slides up and fades. */
 declare const MOTION_BOTTOM_SHEET = "matrx-motion-bottom-sheet";
 /**
@@ -1816,4 +1892,4 @@ declare const ALL_MOTION_CLASSES: readonly ["matrx-motion-overlay", "matrx-motio
  */
 declare const FORBIDDEN_HOST_MOTION_UTILITIES: readonly ["animate-in", "animate-out", "fade-in", "fade-out", "zoom-in", "zoom-out", "slide-in-from", "slide-out-to", "animate-accordion", "animate-slide-down", "animate-slide-up", "animate-pulse", "animate-spin"];
 
-export { ALL_MOTION_CLASSES, Accordion, AccordionContent, AccordionItem, type AccordionProps, type AccordionSize, AccordionTrigger, type AccordionTriggerProps, Alert, AlertDescription, AlertDialog, AlertDialogAction, AlertDialogCancel, AlertDialogContent, AlertDialogContentPrimitive, type AlertDialogContentProps, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogOverlay, AlertDialogPortal, AlertDialogTitle, AlertDialogTrigger, type AlertProps, AlertTitle, Avatar, AvatarFallback, AvatarImage, type AvatarProps, type AvatarSize, Badge, type BadgeProps, BasicInput, BasicTextarea, BottomSheet, BottomSheetBody, type BottomSheetBodyProps, BottomSheetFooter, type BottomSheetFooterProps, BottomSheetHeader, type BottomSheetHeaderProps, type BottomSheetProps, Button, type ButtonProps, CENTERED_DIALOG, Card, CardAction, CardContent, CardDescription, CardFooter, CardHeader, type CardProps, type CardSize, CardTitle, Checkbox, type CheckboxProps, type CheckboxSize, Collapsible, CollapsibleContent, type CollapsibleContentProps, CollapsibleTrigger, Command, CommandDialog, type CommandDialogProps, CommandEmpty, CommandGroup, CommandInput, CommandItem, CommandList, CommandSeparator, CommandShortcut, ContextMenu, ContextMenuCheckboxItem, ContextMenuContent, type ContextMenuContentProps, ContextMenuGroup, ContextMenuItem, ContextMenuLabel, ContextMenuPortal, ContextMenuRadioGroup, ContextMenuRadioItem, ContextMenuSeparator, ContextMenuShortcut, ContextMenuSub, ContextMenuSubContent, ContextMenuSubTrigger, ContextMenuTrigger, type CreatableOption, CreatablePicker, type CreatablePickerProps, DEFAULT_SCORE_THRESHOLDS, Dialog, DialogClose, DialogContent, DialogContentPrimitive, type DialogContentProps, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, DialogTitle, DialogTrigger, Drawer, DrawerBody, DrawerClose, DrawerContent, DrawerContentPrimitive, type DrawerContentProps, DrawerDescription, type DrawerDirection, DrawerFooter, DrawerHeader, DrawerOverlay, DrawerPortal, type DrawerProps, type DrawerSize, DrawerTitle, DrawerTrigger, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, type DropdownMenuContentProps, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, EditableLabel, type EditableLabelActivation, type EditableLabelCommitMode, type EditableLabelProps, EnterInput, type EnterInputProps, FORBIDDEN_HOST_MOTION_UTILITIES, HoverCard, HoverCardContent, type HoverCardContentProps, HoverCardTrigger, Input, type InputProps, type InputVariant, InputWithPrefix, type InputWithPrefixProps, Label, MOBILE_BREAKPOINT, MOTION_BOTTOM_SHEET, MOTION_DIALOG, MOTION_OVERLAY, MOTION_POPPER, MOTION_PULSE, MOTION_SHEET, MOTION_SPIN, OverflowToolbar, type OverflowToolbarProps, POPPER_OFFSET, type PickerIcon, Popover, PopoverAnchor, PopoverContent, type PopoverContentProps, PopoverTrigger, PortalContainerProvider, type PortalContainerProviderProps, Progress, type ProgressProps, type ProgressTone, RadioGroup, RadioGroupItem, type RadioGroupItemProps, type RadioGroupProps, type RadioGroupSize, RadixDialogModalProvider, type RadixDialogModalProviderProps, ResizableHandle, type ResizableHandleProps, type ResizableHandleSize, ResizablePanel, ResizablePanelGroup, ScoreRing, type ScoreRingProps, type ScoreThresholds, ScrollArea, type ScrollAreaProps, ScrollBar, type ScrollFadeState, type SegmentOption, SegmentedControl, type SegmentedControlProps, Select, SelectContent, type SelectContentProps, SelectGroup, SelectItem, SelectLabel, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, type SelectTriggerProps, SelectValue, Separator, Sheet, SheetClose, SheetContent, type SheetContentProps, SheetDescription, SheetFooter, SheetHeader, SheetOverlay, SheetPortal, SheetTitle, SheetTrigger, Skeleton, type SkeletonProps, Slider, type SliderProps, type SliderSize, Switch, type SwitchProps, type SwitchSize, TabbedBottomSheet, type TabbedBottomSheetProps, type TabbedBottomSheetTab, Table, TableBody, TableCaption, TableCell, TableFooter, TableHead, TableHeader, type TableHeaderProps, type TableProps, TableRow, type TableSize, Tabs, TabsContent, TabsList, TabsTrigger, TabsTriggerCore, Textarea, type TextareaProps, TextareaWithPrefix, type TextareaWithPrefixProps, Toggle, ToggleGroup, ToggleGroupItem, type ToggleGroupItemProps, type ToggleGroupProps, type ToggleProps, type ToolbarAction, type ToolbarActionTone, type ToolbarIcon, Tooltip, TooltipContent, type TooltipContentProps, TooltipProvider, TooltipTrigger, type UseScrollFadeResult, alertVariants, badgeVariants, buttonVariants, cn, scoreAccentBgClasses, scoreRingColorClasses, selectTriggerVariants, sheetVariants, toggleVariants, useAccordionSize, useCardSize, useDialogContainer, useDrawerDirection, useIsMobile, usePortalContainer, useRadixDialogModal, useScrollFade, useTableSize };
+export { ALL_MOTION_CLASSES, Accordion, AccordionContent, AccordionItem, type AccordionProps, type AccordionSize, AccordionTrigger, type AccordionTriggerProps, Alert, AlertDescription, AlertDialog, AlertDialogAction, AlertDialogCancel, AlertDialogContent, AlertDialogContentPrimitive, type AlertDialogContentProps, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogOverlay, AlertDialogPortal, AlertDialogTitle, AlertDialogTrigger, type AlertProps, AlertTitle, Avatar, AvatarFallback, AvatarImage, type AvatarProps, type AvatarSize, Badge, type BadgeProps, BasicInput, BasicTextarea, BottomSheet, BottomSheetBody, type BottomSheetBodyProps, BottomSheetFooter, type BottomSheetFooterProps, BottomSheetHeader, type BottomSheetHeaderProps, type BottomSheetProps, Button, type ButtonProps, Card, CardAction, CardContent, CardDescription, CardFooter, CardHeader, type CardProps, type CardSize, CardTitle, Checkbox, type CheckboxProps, type CheckboxSize, Collapsible, CollapsibleContent, type CollapsibleContentProps, CollapsibleTrigger, Command, CommandDialog, type CommandDialogProps, CommandEmpty, CommandGroup, CommandInput, CommandItem, CommandList, CommandSeparator, CommandShortcut, ConfirmDialog, ConfirmDialogHost, type ConfirmDialogProps, ContextMenu, ContextMenuCheckboxItem, ContextMenuContent, type ContextMenuContentProps, ContextMenuGroup, ContextMenuItem, ContextMenuLabel, ContextMenuPortal, ContextMenuRadioGroup, ContextMenuRadioItem, ContextMenuSeparator, ContextMenuShortcut, ContextMenuSub, ContextMenuSubContent, ContextMenuSubTrigger, ContextMenuTrigger, type CreatableOption, CreatablePicker, type CreatablePickerProps, DEFAULT_SCORE_THRESHOLDS, Dialog, DialogClose, DialogContent, DialogContentPrimitive, type DialogContentProps, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, DialogTitle, DialogTrigger, Drawer, DrawerBody, DrawerClose, DrawerContent, DrawerContentPrimitive, type DrawerContentProps, DrawerDescription, type DrawerDirection, DrawerFooter, DrawerHeader, DrawerOverlay, DrawerPortal, type DrawerProps, type DrawerSize, DrawerTitle, DrawerTrigger, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, type DropdownMenuContentProps, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, EditableLabel, type EditableLabelActivation, type EditableLabelCommitMode, type EditableLabelProps, EnterInput, type EnterInputProps, FORBIDDEN_HOST_MOTION_UTILITIES, HoverCard, HoverCardContent, type HoverCardContentProps, HoverCardTrigger, Input, type InputProps, type InputVariant, InputWithPrefix, type InputWithPrefixProps, Label, MOBILE_BREAKPOINT, MOTION_BOTTOM_SHEET, MOTION_DIALOG, MOTION_OVERLAY, MOTION_POPPER, MOTION_PULSE, MOTION_SHEET, MOTION_SPIN, OverflowToolbar, type OverflowToolbarProps, type PickerIcon, Popover, PopoverAnchor, PopoverContent, type PopoverContentProps, PopoverTrigger, PortalContainerProvider, type PortalContainerProviderProps, Progress, type ProgressProps, type ProgressTone, RadioGroup, RadioGroupItem, type RadioGroupItemProps, type RadioGroupProps, type RadioGroupSize, RadixDialogModalProvider, type RadixDialogModalProviderProps, ResizableHandle, type ResizableHandleProps, type ResizableHandleSize, ResizablePanel, ResizablePanelGroup, ScoreRing, type ScoreRingProps, type ScoreThresholds, ScrollArea, type ScrollAreaProps, ScrollBar, type ScrollFadeState, type SegmentOption, SegmentedControl, type SegmentedControlProps, Select, SelectContent, type SelectContentProps, SelectGroup, SelectItem, SelectLabel, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, type SelectTriggerProps, SelectValue, Separator, Sheet, SheetClose, SheetContent, type SheetContentProps, SheetDescription, SheetFooter, SheetHeader, SheetOverlay, SheetPortal, SheetTitle, SheetTrigger, Skeleton, type SkeletonProps, Slider, type SliderProps, type SliderSize, Switch, type SwitchProps, type SwitchSize, TabbedBottomSheet, type TabbedBottomSheetProps, type TabbedBottomSheetTab, Table, TableBody, TableCaption, TableCell, TableFooter, TableHead, TableHeader, type TableHeaderProps, type TableProps, TableRow, type TableSize, Tabs, TabsContent, TabsList, TabsTrigger, TabsTriggerCore, Textarea, type TextareaProps, TextareaWithPrefix, type TextareaWithPrefixProps, Toggle, ToggleGroup, ToggleGroupItem, type ToggleGroupItemProps, type ToggleGroupProps, type ToggleProps, type ToolbarAction, type ToolbarActionTone, type ToolbarIcon, Tooltip, TooltipContent, type TooltipContentProps, TooltipProvider, TooltipTrigger, type UseScrollFadeResult, alertVariants, badgeVariants, buttonVariants, cn, scoreAccentBgClasses, scoreRingColorClasses, selectTriggerVariants, sheetVariants, toggleVariants, useAccordionSize, useCardSize, useDialogContainer, useDrawerDirection, useIsMobile, usePortalContainer, useRadixDialogModal, useScrollFade, useTableSize };