docthub-core-components 2.67.0 → 2.68.0

package/dist/src/components/ui/dialog.d.ts

@@ -6,6 +6,14 @@ interface DialogProps {
     modal?: boolean;
     children?: React.ReactNode;
 }
+/**
+ * Modal dialog built on Base UI. Supports stacked dialogs.
+ *
+ * **Stacked dialogs with overlay:** If you need an overlay on a child dialog (e.g., dimming
+ * the parent when the child is open), render both dialogs in parallel as siblings—do not
+ * nest the child dialog inside the parent's content. Use controlled state (open/onOpenChange)
+ * and trigger the child via a button callback. See the Stacked Dialogs story for the pattern.
+ */
 declare const Dialog: React.FC<DialogProps>;
 interface DialogTriggerProps extends React.ComponentPropsWithoutRef<"button"> {
     asChild?: boolean;
@@ -32,6 +40,8 @@ type DialogContentProps = React.ComponentPropsWithoutRef<"div"> & {
     size?: keyof typeof sizeClasses;
     showCloseButton?: boolean;
     closeOnEscape?: boolean;
+    /** When true, prevents the default auto-focus when the dialog opens. */
+    preventOpenAutoFocus?: boolean;
 };
 declare const DialogContent: React.ForwardRefExoticComponent<Omit<React.DetailedHTMLProps<React.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & {
     closeOnOutsideClick?: boolean;
@@ -39,6 +49,8 @@ declare const DialogContent: React.ForwardRefExoticComponent<Omit<React.Detailed
     size?: keyof typeof sizeClasses;
     showCloseButton?: boolean;
     closeOnEscape?: boolean;
+    /** When true, prevents the default auto-focus when the dialog opens. */
+    preventOpenAutoFocus?: boolean;
 } & React.RefAttributes<HTMLDivElement>>;
 declare const DialogHeader: {
     ({ className, ...props }: React.HTMLAttributes<HTMLDivElement>): import("react/jsx-runtime").JSX.Element;