@arc-ui/components 11.7.0 → 11.9.0

package/dist/Modal/Modal.esm.d.ts

@@ -1,30 +1,52 @@
 /// <reference types="react" />
 import React from "react";
 import { FC } from "react";
+import { ButtonProps } from "../_shared/esm/Button-d1dbcf79";
+/** Use `Modal` to focus a user's attention to an urgent or required prompt for interaction or input. */
 declare const Modal: FC<ModalProps>;
 interface ModalProps {
     /**
-     * title for the modal dialog, announced when opened
+     * Title for the modal. This will be announced by screen readers when the modal opens.
      */
     title: string;
     /**
-     * description for the modal dialog, announced when opened
+     * Role for the modal. use alertdialog if explicit user input is required e.g deleting an account. role alertdialog will remove the ability to close the modal by either the esc key being pressed, clicking the cross icon or clicking outside.
      */
-    description: string;
+    role?: "dialog" | "alertdialog";
     /**
-     * Function to be called when the modal has been requested to close.
+     * Whether to return focus to the element that was focused before the modal opened. True by default.
      */
-    onClose: () => void;
+    shouldReturnFocus?: boolean;
     /**
-     * determines whether the description is visible. If set to false it will be visually hidden, but will still be announaced by screen readers. Set to true by default.
+     * Description for the modal. This will be announced by screen readers when the modal opens.
      */
-    showDescription?: boolean;
+    description?: string;
     /**
-     * Set modal open or closed
+     * ID for the element description to be announced by screenreaders in addition to the title.
+     */
+    ariaDescribedBy?: string;
+    /**
+     * Configurable actions for the modal.
+     */
+    actions?: Pick<ButtonProps, "form" | "type" | "fill" | "icon" | "iconPosition" | "href" | "id" | "label" | "onClick" | "isDisabled" | "ariaLabel" | "rel">[];
+    /**
+     * Function to be called when the modal has been requested to close by either the esc key being pressed, outside the dialog being clicked or the close button being clicked. The callback must set the open state of the modal to false. This function is ignored if the `role` prop is set to `alertdialog`. You can prevent this behavior with the `dialog` role by ommitting this prop.
+     */
+    onRequestClose?: () => void;
+    /**
+     * Size of the modal dialog.
+     */
+    size?: "s" | "m" | "l";
+    /**
+     * Set modal open or closed.
      */
     isOpen?: boolean;
     /**
-     * content for the modal
+     * Enables the dialog content to be scrolled internally.
+     */
+    isContentScrollable?: boolean;
+    /**
+     * Custom content for `Modal`.
      */
     children?: React.ReactNode;
 }