@allxsmith/bestax-bulma 5.45.0 → 5.45.1

package/dist/esm/components/Modal.js

@@ -1,6 +1,6 @@
 /* @allxsmith/bestax-bulma — AI agents: see AGENTS.md in the package root, or https://bestax.io/llms.txt */
 import { jsx, jsxs } from 'react/jsx-runtime';
-import React, { forwardRef, useRef, useCallback, useId, useEffect } from 'react';
+import React, { createContext, forwardRef, useRef, useCallback, useId, useEffect, useContext } from 'react';
 import { createPortal } from 'react-dom';
 import { usePrefixedClassNames, classNames, prefixedClassNames } from '../helpers/classNames.js';
 import { withSubComponents } from '../helpers/withSubComponents.js';
@@ -15,8 +15,12 @@ import { useLatestRef } from '../helpers/useLatestRef.js';
 import { useOverlayStack } from '../helpers/overlayStack.js';
 import { trapTab, focusTabStop } from '../helpers/useFocusTrap.js';
 
+// The enclosing modal's `onClose`, for a `Modal.Close` written as a part, so
+// it closes the modal the way the button the props form renders does.
+const ModalCloseContext = createContext(undefined);
 /**
- * Modal.Background - Renders the modal background overlay.
+ * Modal.Background - Renders the modal background overlay. Pass it
+ * `onClick={onClose}` for a click on it to close the modal.
  *
  * @function
  * @param {ModalBackgroundProps} props - Component props.
@@ -100,7 +104,8 @@ const ModalCard = withSubComponents(ModalCardComponent, {
     Foot: ModalCardFoot,
 });
 /**
- * Modal.Close - Renders modal close button with two variant styles.
+ * Modal.Close - Renders modal close button with two variant styles. It calls
+ * the modal's `onClose` unless given an `onClick` of its own.
  *
  * @function
  * @param {ModalCloseProps} props - Component props.
@@ -113,9 +118,15 @@ const ModalCard = withSubComponents(ModalCardComponent, {
  *
  * The size prop only applies to the 'floating' variant.
  */
-const ModalClose = ({ className, size = 'large', variant = 'delete', ...props }) => {
+const ModalClose = ({ className, size = 'large', variant = 'delete', onClick, ...props }) => {
+    const onClose = useContext(ModalCloseContext);
     const classes = classNames(usePrefixedClassNames(variant === 'delete' ? 'delete' : 'modal-close', variant === 'floating' && size && { [`is-${size}`]: true }), className);
-    return (jsx("button", { className: classes, ...props, "aria-label": props['aria-label'] || 'close', type: buttonType(props.type) }));
+    return (jsx("button", { className: classes, ...props, "aria-label": props['aria-label'] || 'close', type: buttonType(props.type), 
+        // A caller's own `onClick` replaces the close rather than running
+        // before it, unlike `Popover.Close`: this button used to close only
+        // through that handler, so a caller already closing there, as with
+        // `onClick={onClose}`, would otherwise close twice.
+        onClick: onClick ?? (onClose && (() => onClose())) }));
 };
 /**
  * The `Modal` component provides an empty, accessible overlay for arbitrary content — for a ready-made confirm or alert, reach for `Dialog` instead.
@@ -132,12 +143,12 @@ const ModalClose = ({ className, size = 'large', variant = 'delete', ...props })
  *
  * @example
  * // Compound Component API
- * <Modal isActive={isOpen}>
+ * <Modal isActive={isOpen} onClose={handleClose}>
  *   <Modal.Background onClick={handleClose} />
  *   <Modal.Card>
  *     <Modal.Card.Head>
  *       <Modal.Card.Title>Title</Modal.Card.Title>
- *       <Modal.Close onClick={handleClose} />
+ *       <Modal.Close />
  *     </Modal.Card.Head>
  *     <Modal.Card.Body>Content</Modal.Card.Body>
  *   </Modal.Card>
@@ -316,6 +327,8 @@ const ModalRoot = forwardRef(function ModalRoot({ active, isActive, onClose, cla
             isModalCard = !!modalCardTitle || !!modalCardFoot;
         modalElement = (jsxs("div", { className: modalClasses, ref: combinedRef, role: resolvedRole, "aria-modal": resolvedAriaModal, "aria-labelledby": titleId, tabIndex: -1, ...rest, "data-testid": "modal", children: [jsx("div", { className: prefixedClassNames(classPrefix, 'modal-background'), onClick: onClose, "data-testid": "modal-background" }), isModalCard ? (jsxs("div", { className: prefixedClassNames(classPrefix, 'modal-card'), children: [modalCardTitle && (jsxs("header", { className: prefixedClassNames(classPrefix, 'modal-card-head'), children: [jsx("p", { id: titleId, className: prefixedClassNames(classPrefix, 'modal-card-title'), children: modalCardTitle }), onClose && (jsx("button", { className: deleteClass, "aria-label": "close", onClick: onClose, type: "button", "data-testid": "modal-close" }))] })), jsx("section", { className: prefixedClassNames(classPrefix, 'modal-card-body'), "data-testid": "modal-body", children: children }), modalCardFoot && (jsx("footer", { className: prefixedClassNames(classPrefix, 'modal-card-foot'), children: modalCardFoot }))] })) : (jsx("div", { className: prefixedClassNames(classPrefix, 'modal-content'), "data-testid": "modal-content", children: children })), (!isModalCard || (!modalCardTitle && onClose)) && onClose && (jsx("button", { className: prefixedClassNames(classPrefix, 'modal-close', 'is-large'), "aria-label": "close", onClick: onClose, type: "button", "data-testid": "modal-close-float" }))] }));
     }
+    // In both forms, so a `Modal.Close` anywhere inside closes this modal.
+    modalElement = (jsx(ModalCloseContext.Provider, { value: onClose, children: modalElement }));
     if (isPortaled) {
         const target = resolveContainer(typeof portal === 'boolean' ? undefined : portal);
         return createPortal(modalElement, target);

package/dist/esm/components/Modal.js.map

@@ -1 +1 @@
-{"version":3,"file":"Modal.js","sources":["../../../src/components/Modal.tsx"],"sourcesContent":["import React, {\n  forwardRef,\n  useCallback,\n  useEffect,\n  useId,\n  useRef,\n} from 'react';\nimport { createPortal } from 'react-dom';\nimport {\n  classNames,\n  usePrefixedClassNames,\n  prefixedClassNames,\n} from '../helpers/classNames';\nimport { withSubComponents } from '../helpers/withSubComponents';\nimport { buttonType } from '../helpers/buttonType';\nimport {\n  useBulmaClasses,\n  BulmaClassesProps,\n  validColors,\n} from '../helpers/useBulmaClasses';\nimport { useConfig } from '../helpers/Config';\nimport { useScrollLock } from '../helpers/scrollLock';\nimport {\n  getActiveElementInTree,\n  getDeepestActiveElement,\n} from '../helpers/shadowDom';\nimport { usePortalContainer } from '../helpers/portal';\nimport { useIsHydrated } from '../helpers/useIsHydrated';\nimport { useLatestRef } from '../helpers/useLatestRef';\nimport { useOverlayStack } from '../helpers/overlayStack';\nimport { focusTabStop, trapTab } from '../helpers/useFocusTrap';\n\n/**\n * Props for the Modal component.\n * @extraProp {React.Ref<HTMLDivElement>} [ref] - Ref forwarded to the root `.modal` element.\n */\nexport interface ModalProps\n  extends\n    Omit<React.HTMLAttributes<HTMLDivElement>, 'color' | 'title'>,\n    Omit<BulmaClassesProps, 'color' | 'backgroundColor'> {\n  /** Whether the modal is open/visible. */\n  active?: boolean;\n  /** Alias for `active`. Whether the modal is open/visible. */\n  isActive?: boolean; // Alias for active\n  /** Callback invoked to request modal close (background or close button). */\n  onClose?: () => void;\n  /** Additional CSS classes for the modal. */\n  className?: string;\n  /** Text color for modal content. */\n  textColor?: (typeof validColors)[number] | 'inherit' | 'current';\n  /** Background color for modal content. */\n  bgColor?: (typeof validColors)[number] | 'inherit' | 'current';\n  /** Title/header for modal-card variant. (Legacy API only) */\n  modalCardTitle?: React.ReactNode;\n  /** Footer for modal-card variant. (Legacy API only) */\n  modalCardFoot?: React.ReactNode;\n  /**\n   * Modal style: `'card'` for modal-card, `'content'` for modal-content. (Legacy API only)\n   * @defaultValue auto\n   */\n  type?: 'card' | 'content';\n  /** Modal body/content or compound components. */\n  children?: React.ReactNode;\n  /**\n   * Close the modal when the Escape key is pressed (calls `onClose`). Only the\n   * topmost open overlay responds, whichever Modal, Dialog, Sidebar or\n   * full-page Loading opened last, so Escape closes one layer at a time. The\n   * modal marks the Escape it closes on as used with `preventDefault()`, and\n   * a Toast waits until no overlay is open. Turned off, a modal on top still\n   * keeps Escape from the layers under it. A popup inside it, such as a\n   * Dropdown's menu or a date picker's calendar, takes its own Escape first,\n   * and so does content that calls `preventDefault()` on it.\n   * @defaultValue true\n   */\n  closeOnEscape?: boolean;\n  /**\n   * Lock body scroll while the modal is active. Ref-counted and shared with\n   * `Dialog`, `Sidebar` and `Loading`, so whichever overlay closes first does\n   * not unlock the page underneath one that is still open.\n   * @defaultValue true\n   */\n  lockScroll?: boolean;\n  /**\n   * Renders the modal into a portal target instead of inline, so it isn't\n   * clipped by an ancestor with `overflow: hidden`, `filter` or `transform`.\n   * `true` portals to the `portalContainer` a `ConfigProvider` sets,\n   * `document.body` by default; a string is used as a\n   * `document.querySelector` selector; an element is used directly. Renders\n   * inline on the server and while hydrating, moving into the portal once the\n   * client takes over, so hydration matches.\n   * @defaultValue false\n   */\n  portal?: boolean | string | HTMLElement;\n}\n\n/**\n * Props for Modal.Background component.\n */\nexport interface ModalBackgroundProps extends React.HTMLAttributes<HTMLDivElement> {\n  /** Additional CSS classes. */\n  className?: string;\n}\n\n/**\n * Props for Modal.Content component.\n */\nexport interface ModalContentProps extends React.HTMLAttributes<HTMLDivElement> {\n  /** Additional CSS classes. */\n  className?: string;\n}\n\n/**\n * Props for Modal.Card component.\n */\nexport interface ModalCardProps extends React.HTMLAttributes<HTMLDivElement> {\n  /** Additional CSS classes. */\n  className?: string;\n}\n\n/**\n * Props for Modal.Card.Head component.\n */\nexport interface ModalCardHeadProps extends React.HTMLAttributes<HTMLElement> {\n  /** Additional CSS classes. */\n  className?: string;\n}\n\n/**\n * Props for Modal.Card.Title component.\n */\nexport interface ModalCardTitleProps extends React.HTMLAttributes<HTMLParagraphElement> {\n  /** Additional CSS classes. */\n  className?: string;\n}\n\n/**\n * Props for Modal.Card.Body component.\n */\nexport interface ModalCardBodyProps extends React.HTMLAttributes<HTMLElement> {\n  /** Additional CSS classes. */\n  className?: string;\n}\n\n/**\n * Props for Modal.Card.Foot component.\n */\nexport interface ModalCardFootProps extends React.HTMLAttributes<HTMLElement> {\n  /** Additional CSS classes. */\n  className?: string;\n}\n\n/**\n * Props for Modal.Close component.\n * @extraProp {'button' | 'submit' | 'reset'} [type='button'] - Button type. Defaults to `'button'`, so a close button inside a form does not submit it. Pass `'submit'` or `'reset'` and yours is used; any other value, or a spread carrying `type: undefined`, renders `'button'`.\n * @extraProp {string} [aria-label='close'] - Accessible name. Pass your own to replace it. An empty one, or a spread carrying `'aria-label': undefined`, keeps the default rather than leaving the button unnamed.\n */\nexport interface ModalCloseProps extends React.ButtonHTMLAttributes<HTMLButtonElement> {\n  /** Additional CSS classes. */\n  className?: string;\n  /** Size of the close button (only applies to 'floating' variant). */\n  size?: 'small' | 'medium' | 'large';\n  /** Button variant. 'delete' (default) for modal card headers, 'floating' for overlay close button. */\n  variant?: 'delete' | 'floating';\n}\n\n/**\n * Modal.Background - Renders the modal background overlay.\n *\n * @function\n * @param {ModalBackgroundProps} props - Component props.\n * @returns {JSX.Element} Modal background element.\n */\nconst ModalBackground: React.FC<ModalBackgroundProps> = ({\n  className,\n  ...props\n}) => {\n  const classes = classNames(\n    usePrefixedClassNames('modal-background'),\n    className\n  );\n  return <div className={classes} {...props} />;\n};\n\n/**\n * Modal.Content - Renders modal content wrapper for custom content.\n *\n * @function\n * @param {ModalContentProps} props - Component props.\n * @returns {JSX.Element} Modal content element.\n */\nconst ModalContent: React.FC<ModalContentProps> = ({ className, ...props }) => {\n  const classes = classNames(usePrefixedClassNames('modal-content'), className);\n  return <div className={classes} {...props} />;\n};\n\n/**\n * Modal.Card.Head - Renders modal card header section.\n *\n * @function\n * @param {ModalCardHeadProps} props - Component props.\n * @returns {JSX.Element} Modal card header element.\n */\nconst ModalCardHead: React.FC<ModalCardHeadProps> = ({\n  className,\n  ...props\n}) => {\n  const classes = classNames(\n    usePrefixedClassNames('modal-card-head'),\n    className\n  );\n  return <header className={classes} {...props} />;\n};\n\n/**\n * Modal.Card.Title - Renders modal card title.\n *\n * @function\n * @param {ModalCardTitleProps} props - Component props.\n * @returns {JSX.Element} Modal card title element.\n */\nconst ModalCardTitle: React.FC<ModalCardTitleProps> = ({\n  className,\n  ...props\n}) => {\n  const classes = classNames(\n    usePrefixedClassNames('modal-card-title'),\n    className\n  );\n  return <p className={classes} {...props} />;\n};\n\n/**\n * Modal.Card.Body - Renders modal card body section.\n *\n * @function\n * @param {ModalCardBodyProps} props - Component props.\n * @returns {JSX.Element} Modal card body element.\n */\nconst ModalCardBody: React.FC<ModalCardBodyProps> = ({\n  className,\n  ...props\n}) => {\n  const classes = classNames(\n    usePrefixedClassNames('modal-card-body'),\n    className\n  );\n  return <section className={classes} {...props} />;\n};\n\n/**\n * Modal.Card.Foot - Renders modal card footer section.\n *\n * @function\n * @param {ModalCardFootProps} props - Component props.\n * @returns {JSX.Element} Modal card footer element.\n */\nconst ModalCardFoot: React.FC<ModalCardFootProps> = ({\n  className,\n  ...props\n}) => {\n  const classes = classNames(\n    usePrefixedClassNames('modal-card-foot'),\n    className\n  );\n  return <footer className={classes} {...props} />;\n};\n\n/**\n * Modal.Card - Renders modal card wrapper with compound components.\n * Use with Modal.Card.Head, Modal.Card.Title, Modal.Card.Body, and Modal.Card.Foot.\n *\n * @function\n * @param {ModalCardProps} props - Component props.\n * @returns {JSX.Element} Modal card element.\n */\nconst ModalCardComponent: React.FC<ModalCardProps> = ({\n  className,\n  ...props\n}) => {\n  const classes = classNames(usePrefixedClassNames('modal-card'), className);\n  return <div className={classes} {...props} />;\n};\n\nconst ModalCard = withSubComponents(ModalCardComponent, {\n  Head: ModalCardHead,\n  Title: ModalCardTitle,\n  Body: ModalCardBody,\n  Foot: ModalCardFoot,\n});\n\n/**\n * Modal.Close - Renders modal close button with two variant styles.\n *\n * @function\n * @param {ModalCloseProps} props - Component props.\n * @returns {JSX.Element} Close button element.\n *\n * @remarks\n * Supports two variants:\n * - 'delete' (default): For use in modal card headers, renders with 'delete' class\n * - 'floating': For floating overlay close button, renders with 'modal-close' class\n *\n * The size prop only applies to the 'floating' variant.\n */\nconst ModalClose: React.FC<ModalCloseProps> = ({\n  className,\n  size = 'large',\n  variant = 'delete',\n  ...props\n}) => {\n  const classes = classNames(\n    usePrefixedClassNames(\n      variant === 'delete' ? 'delete' : 'modal-close',\n      variant === 'floating' && size && { [`is-${size}`]: true }\n    ),\n    className\n  );\n  return (\n    <button\n      className={classes}\n      {...props}\n      // After the spread, reading through it: a key the spread carries with no\n      // value would otherwise erase the default, leaving a nameless button\n      // that submits the form around it. An empty label falls back too: the\n      // button is drawn as an icon, so `''` would leave it unnamed. A caller's\n      // own value still wins; `buttonType` says more.\n      aria-label={props['aria-label'] || 'close'}\n      type={buttonType(props.type)}\n    />\n  );\n};\n\n/**\n * The `Modal` component provides an empty, accessible overlay for arbitrary content — for a ready-made confirm or alert, reach for `Dialog` instead.\n *\n * @function\n * @param {ModalProps} props - Props for the Modal component.\n * @returns {JSX.Element} The rendered modal.\n *\n * @example\n * // Legacy API\n * <Modal active={isOpen} onClose={handleClose} modalCardTitle=\"Title\">\n *   Content\n * </Modal>\n *\n * @example\n * // Compound Component API\n * <Modal isActive={isOpen}>\n *   <Modal.Background onClick={handleClose} />\n *   <Modal.Card>\n *     <Modal.Card.Head>\n *       <Modal.Card.Title>Title</Modal.Card.Title>\n *       <Modal.Close onClick={handleClose} />\n *     </Modal.Card.Head>\n *     <Modal.Card.Body>Content</Modal.Card.Body>\n *   </Modal.Card>\n * </Modal>\n *\n * @see {@link https://bulma.io/documentation/components/modal/ | Bulma Modal documentation}\n */\nconst ModalRoot = forwardRef<HTMLDivElement, ModalProps>(function ModalRoot(\n  {\n    active,\n    isActive,\n    onClose,\n    className,\n    textColor,\n    bgColor,\n    modalCardTitle,\n    modalCardFoot,\n    type,\n    children,\n    closeOnEscape = true,\n    lockScroll = true,\n    portal = false,\n    role,\n    'aria-modal': ariaModalProp,\n    ...props\n  },\n  ref\n) {\n  const { classPrefix, portalContainer } = useConfig();\n  const { bulmaHelperClasses, rest } = useBulmaClasses({\n    color: textColor,\n    backgroundColor: bgColor,\n    ...props,\n  });\n\n  // Support both active and isActive props\n  const isModalActive = active ?? isActive ?? false;\n\n  const modalRootRef = useRef<HTMLDivElement>(null);\n\n  // Cleanup returned by a consumer's callback ref on attach, held until detach.\n  const consumerCleanupRef = useRef<(() => void) | null>(null);\n\n  // The forwarded ref and the internal one must both see the node: focus\n  // management and the Tab trap read `modalRootRef`, while consumers expect\n  // their own ref to resolve.\n  const combinedRef = useCallback(\n    (node: HTMLDivElement | null) => {\n      (modalRootRef as React.MutableRefObject<HTMLDivElement | null>).current =\n        node;\n      if (typeof ref === 'function') {\n        // React 19 lets a callback ref return a cleanup function and detaches\n        // by running it instead of calling the ref with `null`; React 18\n        // discards the return value entirely. Returning it from here would be\n        // a React-19-only contract, so instead we hold the cleanup and run it\n        // ourselves on detach — a consumer's cleanup ref then behaves the same\n        // on both majors of the CI matrix. Same shape as `Dropdown`.\n        if (node === null) {\n          const consumerCleanup = consumerCleanupRef.current;\n          consumerCleanupRef.current = null;\n          if (consumerCleanup) {\n            consumerCleanup();\n          } else {\n            ref(null);\n          }\n          return;\n        }\n        const cleanup: unknown = ref(node);\n        consumerCleanupRef.current =\n          typeof cleanup === 'function' ? (cleanup as () => void) : null;\n      } else if (ref) {\n        (ref as React.MutableRefObject<HTMLDivElement | null>).current = node;\n      }\n    },\n    [ref]\n  );\n  const previouslyFocusedRef = useRef<HTMLElement | null>(null);\n  const generatedTitleId = useId();\n  // A portal has no server-rendered counterpart, so the server render and the\n  // hydrating render have to stay inline and only move into the portal once\n  // we're past hydration.\n  const onClient = useIsHydrated();\n  const resolveContainer = usePortalContainer();\n  // Moving into the portal, or from one portal target to another, remounts\n  // the modal's subtree, so any effect holding a DOM node from before the move\n  // is holding a detached one. Effects that touch the modal's nodes key on\n  // this, on `portal` and on `defaultTarget`, so they re-run against the new\n  // tree.\n  const isPortaled = Boolean(portal) && onClient;\n  // The configured `portalContainer` only places a modal portaled with\n  // `portal` set to `true`. In place, or with a target of its own, a change\n  // to it moves nothing, so it mustn't re-run the effects either.\n  const defaultTarget =\n    isPortaled && portal === true ? portalContainer : undefined;\n\n  useScrollLock(isModalActive && lockScroll);\n\n  // Read when Escape arrives, so the key listener stays put while `onClose`\n  // changes identity, as an inline one does on every render of the parent.\n  const onCloseRef = useLatestRef(onClose);\n\n  // Joins the stack of open overlays, so the keyboard handling below only\n  // applies while this modal is on top.\n  const isTopmost = useOverlayStack(isModalActive);\n\n  // Escape closes, only for the topmost overlay. The listener is on\n  // `window`, where a keydown arrives last, so everything inside the modal\n  // has had the key first: React's handlers, and `document` listeners added\n  // after this one, such as a date picker's.\n  useEffect(() => {\n    if (!isModalActive) return undefined;\n\n    const handleKeyDown = (e: KeyboardEvent) => {\n      if (e.key !== 'Escape' || !isTopmost()) return;\n      // Something inside already used this Escape, such as a popup that\n      // closed on it, so the modal waits for the next one. One the modal\n      // closes on is marked used, so nothing under it acts on it as well.\n      if (closeOnEscape && onCloseRef.current && !e.defaultPrevented) {\n        e.preventDefault();\n        onCloseRef.current();\n      }\n    };\n\n    window.addEventListener('keydown', handleKeyDown);\n    return () => window.removeEventListener('keydown', handleKeyDown);\n  }, [isModalActive, closeOnEscape, onCloseRef, isTopmost]);\n\n  // Keep Tab within the modal: `aria-modal` hides the rest of the page from\n  // assistive technology, so the keyboard order has to agree. Only while\n  // it's the topmost modal overlay, so an overlay that isn't modal, such as\n  // a Sidebar without an overlay, takes Escape from it but leaves it Tab.\n  // It's the trap `useFocusTrap` sets, so it wraps at the stops Tab really\n  // visits, skipping hidden, inert and closed content, and sends back a Tab\n  // the browser still takes out. On `window` for the same reason as Escape:\n  // a trap inside, such as a portaled popup's, has had the Tab first, and\n  // one it used is left where it put focus. It reads the modal's node as\n  // each key arrives, so a portal move that remounts the node, including one\n  // to a selector that only starts matching while the modal is open, keeps\n  // it trapped.\n  useEffect(() => {\n    if (!isModalActive) return undefined;\n    return trapTab(\n      () => modalRootRef.current,\n      window,\n      () => isTopmost('modal')\n    );\n  }, [isModalActive, isTopmost]);\n\n  // Move focus into the modal on open, restore it on close\n  useEffect(() => {\n    if (!isModalActive) return undefined;\n\n    // The element that had focus, wherever it sits: a portaled modal renders\n    // under `document.body` while its opener can be inside a shadow root.\n    previouslyFocusedRef.current =\n      getDeepestActiveElement() as HTMLElement | null;\n    const node = modalRootRef.current;\n    if (node) focusTabStop(node);\n\n    return () => {\n      // Only hand focus back if this modal still owns it: closing a background\n      // modal must not pull focus out of one that is still open on top. A\n      // removed subtree leaves focus on <body>, which still counts as ours.\n      const activeElement = getActiveElementInTree(node);\n      if (\n        activeElement &&\n        activeElement !== document.body &&\n        !node?.contains(activeElement)\n      ) {\n        return;\n      }\n      previouslyFocusedRef.current?.focus?.();\n    };\n    // `isPortaled` flips once when a hydrated portal modal moves out of the\n    // inline tree, and `portal` or `defaultTarget` changing moves a portaled\n    // one to another target; re-running rebinds focus onto the remounted\n    // nodes. The cleanup above restores focus to the pre-open element first\n    // (the detached subtree has left focus on <body>), so the re-run re-records\n    // the same element and restore-on-close still lands in the right place.\n  }, [isModalActive, isPortaled, portal, defaultTarget]);\n\n  // Check if children contain compound components\n  const hasCompoundComponents = React.Children.toArray(children).some(\n    child =>\n      React.isValidElement(child) &&\n      (child.type === ModalBackground ||\n        child.type === ModalContent ||\n        child.type === ModalCard ||\n        child.type === ModalClose)\n  );\n\n  // Generate Bulma classes with prefix\n  const bulmaClasses = usePrefixedClassNames('modal', {\n    'is-active': isModalActive,\n  });\n  const deleteClass = usePrefixedClassNames('delete');\n\n  const modalClasses = classNames(bulmaClasses, bulmaHelperClasses, className);\n\n  const resolvedRole = role ?? (isModalActive ? 'dialog' : undefined);\n  const resolvedAriaModal =\n    ariaModalProp ??\n    (isModalActive && resolvedRole !== 'presentation' ? 'true' : undefined);\n  // A dialog needs an accessible name: the legacy card title is wired up\n  // automatically, compound users pass their own aria-label/aria-labelledby\n  // (both arrive in `rest`, which is spread last and so wins).\n  const titleId = modalCardTitle ? generatedTitleId : undefined;\n\n  let modalElement: React.ReactElement;\n\n  // If using compound components, render children as-is\n  if (hasCompoundComponents) {\n    modalElement = (\n      <div\n        className={modalClasses}\n        ref={combinedRef}\n        role={resolvedRole}\n        aria-modal={resolvedAriaModal}\n        tabIndex={-1}\n        {...rest}\n        data-testid=\"modal\"\n      >\n        {children}\n      </div>\n    );\n  } else {\n    // Legacy API: EXPLICIT type wins; fallback to auto detection if not provided\n    let isModalCard: boolean;\n    if (type === 'card') isModalCard = true;\n    else if (type === 'content') isModalCard = false;\n    else isModalCard = !!modalCardTitle || !!modalCardFoot;\n\n    modalElement = (\n      <div\n        className={modalClasses}\n        ref={combinedRef}\n        role={resolvedRole}\n        aria-modal={resolvedAriaModal}\n        aria-labelledby={titleId}\n        tabIndex={-1}\n        {...rest}\n        data-testid=\"modal\"\n      >\n        <div\n          className={prefixedClassNames(classPrefix, 'modal-background')}\n          onClick={onClose}\n          data-testid=\"modal-background\"\n        />\n        {isModalCard ? (\n          <div className={prefixedClassNames(classPrefix, 'modal-card')}>\n            {modalCardTitle && (\n              <header\n                className={prefixedClassNames(classPrefix, 'modal-card-head')}\n              >\n                <p\n                  id={titleId}\n                  className={prefixedClassNames(\n                    classPrefix,\n                    'modal-card-title'\n                  )}\n                >\n                  {modalCardTitle}\n                </p>\n                {onClose && (\n                  <button\n                    className={deleteClass}\n                    aria-label=\"close\"\n                    onClick={onClose}\n                    type=\"button\"\n                    data-testid=\"modal-close\"\n                  />\n                )}\n              </header>\n            )}\n            <section\n              className={prefixedClassNames(classPrefix, 'modal-card-body')}\n              data-testid=\"modal-body\"\n            >\n              {children}\n            </section>\n            {modalCardFoot && (\n              <footer\n                className={prefixedClassNames(classPrefix, 'modal-card-foot')}\n              >\n                {modalCardFoot}\n              </footer>\n            )}\n          </div>\n        ) : (\n          <div\n            className={prefixedClassNames(classPrefix, 'modal-content')}\n            data-testid=\"modal-content\"\n          >\n            {children}\n          </div>\n        )}\n        {/* Show floating close button for modal-content, or for modal-card when no header */}\n        {(!isModalCard || (!modalCardTitle && onClose)) && onClose && (\n          <button\n            className={prefixedClassNames(\n              classPrefix,\n              'modal-close',\n              'is-large'\n            )}\n            aria-label=\"close\"\n            onClick={onClose}\n            type=\"button\"\n            data-testid=\"modal-close-float\"\n          />\n        )}\n      </div>\n    );\n  }\n\n  if (isPortaled) {\n    const target = resolveContainer(\n      typeof portal === 'boolean' ? undefined : portal\n    );\n    return createPortal(modalElement, target);\n  }\n\n  return modalElement;\n});\n\nexport const Modal = withSubComponents(\n  ModalRoot,\n  {\n    Background: ModalBackground,\n    Content: ModalContent,\n    Card: ModalCard,\n    Close: ModalClose,\n  },\n  'Modal'\n);\nexport default Modal;\n"],"names":["_jsx","_jsxs"],"mappings":"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"}
+{"version":3,"file":"Modal.js","sources":["../../../src/components/Modal.tsx"],"sourcesContent":["import React, {\n  createContext,\n  forwardRef,\n  useCallback,\n  useContext,\n  useEffect,\n  useId,\n  useRef,\n} from 'react';\nimport { createPortal } from 'react-dom';\nimport {\n  classNames,\n  usePrefixedClassNames,\n  prefixedClassNames,\n} from '../helpers/classNames';\nimport { withSubComponents } from '../helpers/withSubComponents';\nimport { buttonType } from '../helpers/buttonType';\nimport {\n  useBulmaClasses,\n  BulmaClassesProps,\n  validColors,\n} from '../helpers/useBulmaClasses';\nimport { useConfig } from '../helpers/Config';\nimport { useScrollLock } from '../helpers/scrollLock';\nimport {\n  getActiveElementInTree,\n  getDeepestActiveElement,\n} from '../helpers/shadowDom';\nimport { usePortalContainer } from '../helpers/portal';\nimport { useIsHydrated } from '../helpers/useIsHydrated';\nimport { useLatestRef } from '../helpers/useLatestRef';\nimport { useOverlayStack } from '../helpers/overlayStack';\nimport { focusTabStop, trapTab } from '../helpers/useFocusTrap';\n\n/**\n * Props for the Modal component.\n * @extraProp {React.Ref<HTMLDivElement>} [ref] - Ref forwarded to the root `.modal` element.\n */\nexport interface ModalProps\n  extends\n    Omit<React.HTMLAttributes<HTMLDivElement>, 'color' | 'title'>,\n    Omit<BulmaClassesProps, 'color' | 'backgroundColor'> {\n  /** Whether the modal is open/visible. */\n  active?: boolean;\n  /** Alias for `active`. Whether the modal is open/visible. */\n  isActive?: boolean; // Alias for active\n  /**\n   * Called to ask for the modal to close. The props form calls it from the\n   * background and the close button it renders. In the compound form,\n   * `Modal.Close` calls it unless you give it an `onClick` of your own, and\n   * `Modal.Background` doesn't call it on its own: pass it\n   * `onClick={onClose}` for a click on the background to close the modal.\n   * Escape calls it in both forms unless `closeOnEscape` is `false`.\n   */\n  onClose?: () => void;\n  /** Additional CSS classes for the modal. */\n  className?: string;\n  /** Text color for modal content. */\n  textColor?: (typeof validColors)[number] | 'inherit' | 'current';\n  /** Background color for modal content. */\n  bgColor?: (typeof validColors)[number] | 'inherit' | 'current';\n  /** Title/header for modal-card variant. (Legacy API only) */\n  modalCardTitle?: React.ReactNode;\n  /** Footer for modal-card variant. (Legacy API only) */\n  modalCardFoot?: React.ReactNode;\n  /**\n   * Modal style: `'card'` for modal-card, `'content'` for modal-content. (Legacy API only)\n   * @defaultValue auto\n   */\n  type?: 'card' | 'content';\n  /** Modal body/content or compound components. */\n  children?: React.ReactNode;\n  /**\n   * Close the modal when the Escape key is pressed (calls `onClose`). Only the\n   * topmost open overlay responds, whichever Modal, Dialog, Sidebar or\n   * full-page Loading opened last, so Escape closes one layer at a time. The\n   * modal marks the Escape it closes on as used with `preventDefault()`, and\n   * a Toast waits until no overlay is open. Turned off, a modal on top still\n   * keeps Escape from the layers under it. A popup inside it, such as a\n   * Dropdown's menu or a date picker's calendar, takes its own Escape first,\n   * and so does content that calls `preventDefault()` on it.\n   * @defaultValue true\n   */\n  closeOnEscape?: boolean;\n  /**\n   * Lock body scroll while the modal is active. Ref-counted and shared with\n   * `Dialog`, `Sidebar` and `Loading`, so whichever overlay closes first does\n   * not unlock the page underneath one that is still open.\n   * @defaultValue true\n   */\n  lockScroll?: boolean;\n  /**\n   * Renders the modal into a portal target instead of inline, so it isn't\n   * clipped by an ancestor with `overflow: hidden`, `filter` or `transform`.\n   * `true` portals to the `portalContainer` a `ConfigProvider` sets,\n   * `document.body` by default; a string is used as a\n   * `document.querySelector` selector; an element is used directly. Renders\n   * inline on the server and while hydrating, moving into the portal once the\n   * client takes over, so hydration matches.\n   * @defaultValue false\n   */\n  portal?: boolean | string | HTMLElement;\n}\n\n/**\n * Props for Modal.Background component.\n * @extraProp {React.MouseEventHandler<HTMLDivElement>} [onClick] - Called when the background is clicked. The background doesn't call the modal's `onClose` on its own, so pass `onClick={onClose}` for a click on it to close the modal.\n */\nexport interface ModalBackgroundProps extends React.HTMLAttributes<HTMLDivElement> {\n  /** Additional CSS classes. */\n  className?: string;\n}\n\n/**\n * Props for Modal.Content component.\n */\nexport interface ModalContentProps extends React.HTMLAttributes<HTMLDivElement> {\n  /** Additional CSS classes. */\n  className?: string;\n}\n\n/**\n * Props for Modal.Card component.\n */\nexport interface ModalCardProps extends React.HTMLAttributes<HTMLDivElement> {\n  /** Additional CSS classes. */\n  className?: string;\n}\n\n/**\n * Props for Modal.Card.Head component.\n */\nexport interface ModalCardHeadProps extends React.HTMLAttributes<HTMLElement> {\n  /** Additional CSS classes. */\n  className?: string;\n}\n\n/**\n * Props for Modal.Card.Title component.\n */\nexport interface ModalCardTitleProps extends React.HTMLAttributes<HTMLParagraphElement> {\n  /** Additional CSS classes. */\n  className?: string;\n}\n\n/**\n * Props for Modal.Card.Body component.\n */\nexport interface ModalCardBodyProps extends React.HTMLAttributes<HTMLElement> {\n  /** Additional CSS classes. */\n  className?: string;\n}\n\n/**\n * Props for Modal.Card.Foot component.\n */\nexport interface ModalCardFootProps extends React.HTMLAttributes<HTMLElement> {\n  /** Additional CSS classes. */\n  className?: string;\n}\n\n/**\n * Props for Modal.Close component.\n * @extraProp {'button' | 'submit' | 'reset'} [type='button'] - Button type. Defaults to `'button'`, so a close button inside a form does not submit it. Pass `'submit'` or `'reset'` and yours is used; any other value, or a spread carrying `type: undefined`, renders `'button'`.\n * @extraProp {string} [aria-label='close'] - Accessible name. Pass your own to replace it. An empty one, or a spread carrying `'aria-label': undefined`, keeps the default rather than leaving the button unnamed.\n * @extraProp {React.MouseEventHandler<HTMLButtonElement>} [onClick] - Called when the button is clicked. Without one, the button calls the `onClose` of the `Modal` around it. Yours replaces that rather than running before it, so call `onClose` from it if the button should still close the modal.\n */\nexport interface ModalCloseProps extends React.ButtonHTMLAttributes<HTMLButtonElement> {\n  /** Additional CSS classes. */\n  className?: string;\n  /** Size of the close button (only applies to 'floating' variant). */\n  size?: 'small' | 'medium' | 'large';\n  /** Button variant. 'delete' (default) for modal card headers, 'floating' for overlay close button. */\n  variant?: 'delete' | 'floating';\n}\n\n// The enclosing modal's `onClose`, for a `Modal.Close` written as a part, so\n// it closes the modal the way the button the props form renders does.\nconst ModalCloseContext = createContext<(() => void) | undefined>(undefined);\n\n/**\n * Modal.Background - Renders the modal background overlay. Pass it\n * `onClick={onClose}` for a click on it to close the modal.\n *\n * @function\n * @param {ModalBackgroundProps} props - Component props.\n * @returns {JSX.Element} Modal background element.\n */\nconst ModalBackground: React.FC<ModalBackgroundProps> = ({\n  className,\n  ...props\n}) => {\n  const classes = classNames(\n    usePrefixedClassNames('modal-background'),\n    className\n  );\n  return <div className={classes} {...props} />;\n};\n\n/**\n * Modal.Content - Renders modal content wrapper for custom content.\n *\n * @function\n * @param {ModalContentProps} props - Component props.\n * @returns {JSX.Element} Modal content element.\n */\nconst ModalContent: React.FC<ModalContentProps> = ({ className, ...props }) => {\n  const classes = classNames(usePrefixedClassNames('modal-content'), className);\n  return <div className={classes} {...props} />;\n};\n\n/**\n * Modal.Card.Head - Renders modal card header section.\n *\n * @function\n * @param {ModalCardHeadProps} props - Component props.\n * @returns {JSX.Element} Modal card header element.\n */\nconst ModalCardHead: React.FC<ModalCardHeadProps> = ({\n  className,\n  ...props\n}) => {\n  const classes = classNames(\n    usePrefixedClassNames('modal-card-head'),\n    className\n  );\n  return <header className={classes} {...props} />;\n};\n\n/**\n * Modal.Card.Title - Renders modal card title.\n *\n * @function\n * @param {ModalCardTitleProps} props - Component props.\n * @returns {JSX.Element} Modal card title element.\n */\nconst ModalCardTitle: React.FC<ModalCardTitleProps> = ({\n  className,\n  ...props\n}) => {\n  const classes = classNames(\n    usePrefixedClassNames('modal-card-title'),\n    className\n  );\n  return <p className={classes} {...props} />;\n};\n\n/**\n * Modal.Card.Body - Renders modal card body section.\n *\n * @function\n * @param {ModalCardBodyProps} props - Component props.\n * @returns {JSX.Element} Modal card body element.\n */\nconst ModalCardBody: React.FC<ModalCardBodyProps> = ({\n  className,\n  ...props\n}) => {\n  const classes = classNames(\n    usePrefixedClassNames('modal-card-body'),\n    className\n  );\n  return <section className={classes} {...props} />;\n};\n\n/**\n * Modal.Card.Foot - Renders modal card footer section.\n *\n * @function\n * @param {ModalCardFootProps} props - Component props.\n * @returns {JSX.Element} Modal card footer element.\n */\nconst ModalCardFoot: React.FC<ModalCardFootProps> = ({\n  className,\n  ...props\n}) => {\n  const classes = classNames(\n    usePrefixedClassNames('modal-card-foot'),\n    className\n  );\n  return <footer className={classes} {...props} />;\n};\n\n/**\n * Modal.Card - Renders modal card wrapper with compound components.\n * Use with Modal.Card.Head, Modal.Card.Title, Modal.Card.Body, and Modal.Card.Foot.\n *\n * @function\n * @param {ModalCardProps} props - Component props.\n * @returns {JSX.Element} Modal card element.\n */\nconst ModalCardComponent: React.FC<ModalCardProps> = ({\n  className,\n  ...props\n}) => {\n  const classes = classNames(usePrefixedClassNames('modal-card'), className);\n  return <div className={classes} {...props} />;\n};\n\nconst ModalCard = withSubComponents(ModalCardComponent, {\n  Head: ModalCardHead,\n  Title: ModalCardTitle,\n  Body: ModalCardBody,\n  Foot: ModalCardFoot,\n});\n\n/**\n * Modal.Close - Renders modal close button with two variant styles. It calls\n * the modal's `onClose` unless given an `onClick` of its own.\n *\n * @function\n * @param {ModalCloseProps} props - Component props.\n * @returns {JSX.Element} Close button element.\n *\n * @remarks\n * Supports two variants:\n * - 'delete' (default): For use in modal card headers, renders with 'delete' class\n * - 'floating': For floating overlay close button, renders with 'modal-close' class\n *\n * The size prop only applies to the 'floating' variant.\n */\nconst ModalClose: React.FC<ModalCloseProps> = ({\n  className,\n  size = 'large',\n  variant = 'delete',\n  onClick,\n  ...props\n}) => {\n  const onClose = useContext(ModalCloseContext);\n  const classes = classNames(\n    usePrefixedClassNames(\n      variant === 'delete' ? 'delete' : 'modal-close',\n      variant === 'floating' && size && { [`is-${size}`]: true }\n    ),\n    className\n  );\n  return (\n    <button\n      className={classes}\n      {...props}\n      // After the spread, reading through it: a key the spread carries with no\n      // value would otherwise erase the default, leaving a nameless button\n      // that submits the form around it. An empty label falls back too: the\n      // button is drawn as an icon, so `''` would leave it unnamed. A caller's\n      // own value still wins; `buttonType` says more.\n      aria-label={props['aria-label'] || 'close'}\n      type={buttonType(props.type)}\n      // A caller's own `onClick` replaces the close rather than running\n      // before it, unlike `Popover.Close`: this button used to close only\n      // through that handler, so a caller already closing there, as with\n      // `onClick={onClose}`, would otherwise close twice.\n      onClick={onClick ?? (onClose && (() => onClose()))}\n    />\n  );\n};\n\n/**\n * The `Modal` component provides an empty, accessible overlay for arbitrary content — for a ready-made confirm or alert, reach for `Dialog` instead.\n *\n * @function\n * @param {ModalProps} props - Props for the Modal component.\n * @returns {JSX.Element} The rendered modal.\n *\n * @example\n * // Legacy API\n * <Modal active={isOpen} onClose={handleClose} modalCardTitle=\"Title\">\n *   Content\n * </Modal>\n *\n * @example\n * // Compound Component API\n * <Modal isActive={isOpen} onClose={handleClose}>\n *   <Modal.Background onClick={handleClose} />\n *   <Modal.Card>\n *     <Modal.Card.Head>\n *       <Modal.Card.Title>Title</Modal.Card.Title>\n *       <Modal.Close />\n *     </Modal.Card.Head>\n *     <Modal.Card.Body>Content</Modal.Card.Body>\n *   </Modal.Card>\n * </Modal>\n *\n * @see {@link https://bulma.io/documentation/components/modal/ | Bulma Modal documentation}\n */\nconst ModalRoot = forwardRef<HTMLDivElement, ModalProps>(function ModalRoot(\n  {\n    active,\n    isActive,\n    onClose,\n    className,\n    textColor,\n    bgColor,\n    modalCardTitle,\n    modalCardFoot,\n    type,\n    children,\n    closeOnEscape = true,\n    lockScroll = true,\n    portal = false,\n    role,\n    'aria-modal': ariaModalProp,\n    ...props\n  },\n  ref\n) {\n  const { classPrefix, portalContainer } = useConfig();\n  const { bulmaHelperClasses, rest } = useBulmaClasses({\n    color: textColor,\n    backgroundColor: bgColor,\n    ...props,\n  });\n\n  // Support both active and isActive props\n  const isModalActive = active ?? isActive ?? false;\n\n  const modalRootRef = useRef<HTMLDivElement>(null);\n\n  // Cleanup returned by a consumer's callback ref on attach, held until detach.\n  const consumerCleanupRef = useRef<(() => void) | null>(null);\n\n  // The forwarded ref and the internal one must both see the node: focus\n  // management and the Tab trap read `modalRootRef`, while consumers expect\n  // their own ref to resolve.\n  const combinedRef = useCallback(\n    (node: HTMLDivElement | null) => {\n      (modalRootRef as React.MutableRefObject<HTMLDivElement | null>).current =\n        node;\n      if (typeof ref === 'function') {\n        // React 19 lets a callback ref return a cleanup function and detaches\n        // by running it instead of calling the ref with `null`; React 18\n        // discards the return value entirely. Returning it from here would be\n        // a React-19-only contract, so instead we hold the cleanup and run it\n        // ourselves on detach — a consumer's cleanup ref then behaves the same\n        // on both majors of the CI matrix. Same shape as `Dropdown`.\n        if (node === null) {\n          const consumerCleanup = consumerCleanupRef.current;\n          consumerCleanupRef.current = null;\n          if (consumerCleanup) {\n            consumerCleanup();\n          } else {\n            ref(null);\n          }\n          return;\n        }\n        const cleanup: unknown = ref(node);\n        consumerCleanupRef.current =\n          typeof cleanup === 'function' ? (cleanup as () => void) : null;\n      } else if (ref) {\n        (ref as React.MutableRefObject<HTMLDivElement | null>).current = node;\n      }\n    },\n    [ref]\n  );\n  const previouslyFocusedRef = useRef<HTMLElement | null>(null);\n  const generatedTitleId = useId();\n  // A portal has no server-rendered counterpart, so the server render and the\n  // hydrating render have to stay inline and only move into the portal once\n  // we're past hydration.\n  const onClient = useIsHydrated();\n  const resolveContainer = usePortalContainer();\n  // Moving into the portal, or from one portal target to another, remounts\n  // the modal's subtree, so any effect holding a DOM node from before the move\n  // is holding a detached one. Effects that touch the modal's nodes key on\n  // this, on `portal` and on `defaultTarget`, so they re-run against the new\n  // tree.\n  const isPortaled = Boolean(portal) && onClient;\n  // The configured `portalContainer` only places a modal portaled with\n  // `portal` set to `true`. In place, or with a target of its own, a change\n  // to it moves nothing, so it mustn't re-run the effects either.\n  const defaultTarget =\n    isPortaled && portal === true ? portalContainer : undefined;\n\n  useScrollLock(isModalActive && lockScroll);\n\n  // Read when Escape arrives, so the key listener stays put while `onClose`\n  // changes identity, as an inline one does on every render of the parent.\n  const onCloseRef = useLatestRef(onClose);\n\n  // Joins the stack of open overlays, so the keyboard handling below only\n  // applies while this modal is on top.\n  const isTopmost = useOverlayStack(isModalActive);\n\n  // Escape closes, only for the topmost overlay. The listener is on\n  // `window`, where a keydown arrives last, so everything inside the modal\n  // has had the key first: React's handlers, and `document` listeners added\n  // after this one, such as a date picker's.\n  useEffect(() => {\n    if (!isModalActive) return undefined;\n\n    const handleKeyDown = (e: KeyboardEvent) => {\n      if (e.key !== 'Escape' || !isTopmost()) return;\n      // Something inside already used this Escape, such as a popup that\n      // closed on it, so the modal waits for the next one. One the modal\n      // closes on is marked used, so nothing under it acts on it as well.\n      if (closeOnEscape && onCloseRef.current && !e.defaultPrevented) {\n        e.preventDefault();\n        onCloseRef.current();\n      }\n    };\n\n    window.addEventListener('keydown', handleKeyDown);\n    return () => window.removeEventListener('keydown', handleKeyDown);\n  }, [isModalActive, closeOnEscape, onCloseRef, isTopmost]);\n\n  // Keep Tab within the modal: `aria-modal` hides the rest of the page from\n  // assistive technology, so the keyboard order has to agree. Only while\n  // it's the topmost modal overlay, so an overlay that isn't modal, such as\n  // a Sidebar without an overlay, takes Escape from it but leaves it Tab.\n  // It's the trap `useFocusTrap` sets, so it wraps at the stops Tab really\n  // visits, skipping hidden, inert and closed content, and sends back a Tab\n  // the browser still takes out. On `window` for the same reason as Escape:\n  // a trap inside, such as a portaled popup's, has had the Tab first, and\n  // one it used is left where it put focus. It reads the modal's node as\n  // each key arrives, so a portal move that remounts the node, including one\n  // to a selector that only starts matching while the modal is open, keeps\n  // it trapped.\n  useEffect(() => {\n    if (!isModalActive) return undefined;\n    return trapTab(\n      () => modalRootRef.current,\n      window,\n      () => isTopmost('modal')\n    );\n  }, [isModalActive, isTopmost]);\n\n  // Move focus into the modal on open, restore it on close\n  useEffect(() => {\n    if (!isModalActive) return undefined;\n\n    // The element that had focus, wherever it sits: a portaled modal renders\n    // under `document.body` while its opener can be inside a shadow root.\n    previouslyFocusedRef.current =\n      getDeepestActiveElement() as HTMLElement | null;\n    const node = modalRootRef.current;\n    if (node) focusTabStop(node);\n\n    return () => {\n      // Only hand focus back if this modal still owns it: closing a background\n      // modal must not pull focus out of one that is still open on top. A\n      // removed subtree leaves focus on <body>, which still counts as ours.\n      const activeElement = getActiveElementInTree(node);\n      if (\n        activeElement &&\n        activeElement !== document.body &&\n        !node?.contains(activeElement)\n      ) {\n        return;\n      }\n      previouslyFocusedRef.current?.focus?.();\n    };\n    // `isPortaled` flips once when a hydrated portal modal moves out of the\n    // inline tree, and `portal` or `defaultTarget` changing moves a portaled\n    // one to another target; re-running rebinds focus onto the remounted\n    // nodes. The cleanup above restores focus to the pre-open element first\n    // (the detached subtree has left focus on <body>), so the re-run re-records\n    // the same element and restore-on-close still lands in the right place.\n  }, [isModalActive, isPortaled, portal, defaultTarget]);\n\n  // Check if children contain compound components\n  const hasCompoundComponents = React.Children.toArray(children).some(\n    child =>\n      React.isValidElement(child) &&\n      (child.type === ModalBackground ||\n        child.type === ModalContent ||\n        child.type === ModalCard ||\n        child.type === ModalClose)\n  );\n\n  // Generate Bulma classes with prefix\n  const bulmaClasses = usePrefixedClassNames('modal', {\n    'is-active': isModalActive,\n  });\n  const deleteClass = usePrefixedClassNames('delete');\n\n  const modalClasses = classNames(bulmaClasses, bulmaHelperClasses, className);\n\n  const resolvedRole = role ?? (isModalActive ? 'dialog' : undefined);\n  const resolvedAriaModal =\n    ariaModalProp ??\n    (isModalActive && resolvedRole !== 'presentation' ? 'true' : undefined);\n  // A dialog needs an accessible name: the legacy card title is wired up\n  // automatically, compound users pass their own aria-label/aria-labelledby\n  // (both arrive in `rest`, which is spread last and so wins).\n  const titleId = modalCardTitle ? generatedTitleId : undefined;\n\n  let modalElement: React.ReactElement;\n\n  // If using compound components, render children as-is\n  if (hasCompoundComponents) {\n    modalElement = (\n      <div\n        className={modalClasses}\n        ref={combinedRef}\n        role={resolvedRole}\n        aria-modal={resolvedAriaModal}\n        tabIndex={-1}\n        {...rest}\n        data-testid=\"modal\"\n      >\n        {children}\n      </div>\n    );\n  } else {\n    // Legacy API: EXPLICIT type wins; fallback to auto detection if not provided\n    let isModalCard: boolean;\n    if (type === 'card') isModalCard = true;\n    else if (type === 'content') isModalCard = false;\n    else isModalCard = !!modalCardTitle || !!modalCardFoot;\n\n    modalElement = (\n      <div\n        className={modalClasses}\n        ref={combinedRef}\n        role={resolvedRole}\n        aria-modal={resolvedAriaModal}\n        aria-labelledby={titleId}\n        tabIndex={-1}\n        {...rest}\n        data-testid=\"modal\"\n      >\n        <div\n          className={prefixedClassNames(classPrefix, 'modal-background')}\n          onClick={onClose}\n          data-testid=\"modal-background\"\n        />\n        {isModalCard ? (\n          <div className={prefixedClassNames(classPrefix, 'modal-card')}>\n            {modalCardTitle && (\n              <header\n                className={prefixedClassNames(classPrefix, 'modal-card-head')}\n              >\n                <p\n                  id={titleId}\n                  className={prefixedClassNames(\n                    classPrefix,\n                    'modal-card-title'\n                  )}\n                >\n                  {modalCardTitle}\n                </p>\n                {onClose && (\n                  <button\n                    className={deleteClass}\n                    aria-label=\"close\"\n                    onClick={onClose}\n                    type=\"button\"\n                    data-testid=\"modal-close\"\n                  />\n                )}\n              </header>\n            )}\n            <section\n              className={prefixedClassNames(classPrefix, 'modal-card-body')}\n              data-testid=\"modal-body\"\n            >\n              {children}\n            </section>\n            {modalCardFoot && (\n              <footer\n                className={prefixedClassNames(classPrefix, 'modal-card-foot')}\n              >\n                {modalCardFoot}\n              </footer>\n            )}\n          </div>\n        ) : (\n          <div\n            className={prefixedClassNames(classPrefix, 'modal-content')}\n            data-testid=\"modal-content\"\n          >\n            {children}\n          </div>\n        )}\n        {/* Show floating close button for modal-content, or for modal-card when no header */}\n        {(!isModalCard || (!modalCardTitle && onClose)) && onClose && (\n          <button\n            className={prefixedClassNames(\n              classPrefix,\n              'modal-close',\n              'is-large'\n            )}\n            aria-label=\"close\"\n            onClick={onClose}\n            type=\"button\"\n            data-testid=\"modal-close-float\"\n          />\n        )}\n      </div>\n    );\n  }\n\n  // In both forms, so a `Modal.Close` anywhere inside closes this modal.\n  modalElement = (\n    <ModalCloseContext.Provider value={onClose}>\n      {modalElement}\n    </ModalCloseContext.Provider>\n  );\n\n  if (isPortaled) {\n    const target = resolveContainer(\n      typeof portal === 'boolean' ? undefined : portal\n    );\n    return createPortal(modalElement, target);\n  }\n\n  return modalElement;\n});\n\nexport const Modal = withSubComponents(\n  ModalRoot,\n  {\n    Background: ModalBackground,\n    Content: ModalContent,\n    Card: ModalCard,\n    Close: ModalClose,\n  },\n  'Modal'\n);\nexport default Modal;\n"],"names":["_jsx","_jsxs"],"mappings":"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"}

package/dist/index.cjs

@@ -4595,8 +4595,12 @@ function useFocusTrap(containerRef, options = {}) {
     });
 }
 
+// The enclosing modal's `onClose`, for a `Modal.Close` written as a part, so
+// it closes the modal the way the button the props form renders does.
+const ModalCloseContext = React.createContext(undefined);
 /**
- * Modal.Background - Renders the modal background overlay.
+ * Modal.Background - Renders the modal background overlay. Pass it
+ * `onClick={onClose}` for a click on it to close the modal.
  *
  * @function
  * @param {ModalBackgroundProps} props - Component props.
@@ -4680,7 +4684,8 @@ const ModalCard = withSubComponents(ModalCardComponent, {
     Foot: ModalCardFoot,
 });
 /**
- * Modal.Close - Renders modal close button with two variant styles.
+ * Modal.Close - Renders modal close button with two variant styles. It calls
+ * the modal's `onClose` unless given an `onClick` of its own.
  *
  * @function
  * @param {ModalCloseProps} props - Component props.
@@ -4693,9 +4698,15 @@ const ModalCard = withSubComponents(ModalCardComponent, {
  *
  * The size prop only applies to the 'floating' variant.
  */
-const ModalClose = ({ className, size = 'large', variant = 'delete', ...props }) => {
+const ModalClose = ({ className, size = 'large', variant = 'delete', onClick, ...props }) => {
+    const onClose = React.useContext(ModalCloseContext);
     const classes = classNames(usePrefixedClassNames(variant === 'delete' ? 'delete' : 'modal-close', variant === 'floating' && size && { [`is-${size}`]: true }), className);
-    return (jsxRuntime.jsx("button", { className: classes, ...props, "aria-label": props['aria-label'] || 'close', type: buttonType(props.type) }));
+    return (jsxRuntime.jsx("button", { className: classes, ...props, "aria-label": props['aria-label'] || 'close', type: buttonType(props.type), 
+        // A caller's own `onClick` replaces the close rather than running
+        // before it, unlike `Popover.Close`: this button used to close only
+        // through that handler, so a caller already closing there, as with
+        // `onClick={onClose}`, would otherwise close twice.
+        onClick: onClick ?? (onClose && (() => onClose())) }));
 };
 /**
  * The `Modal` component provides an empty, accessible overlay for arbitrary content — for a ready-made confirm or alert, reach for `Dialog` instead.
@@ -4712,12 +4723,12 @@ const ModalClose = ({ className, size = 'large', variant = 'delete', ...props })
  *
  * @example
  * // Compound Component API
- * <Modal isActive={isOpen}>
+ * <Modal isActive={isOpen} onClose={handleClose}>
  *   <Modal.Background onClick={handleClose} />
  *   <Modal.Card>
  *     <Modal.Card.Head>
  *       <Modal.Card.Title>Title</Modal.Card.Title>
- *       <Modal.Close onClick={handleClose} />
+ *       <Modal.Close />
  *     </Modal.Card.Head>
  *     <Modal.Card.Body>Content</Modal.Card.Body>
  *   </Modal.Card>
@@ -4896,6 +4907,8 @@ const ModalRoot = React.forwardRef(function ModalRoot({ active, isActive, onClos
             isModalCard = !!modalCardTitle || !!modalCardFoot;
         modalElement = (jsxRuntime.jsxs("div", { className: modalClasses, ref: combinedRef, role: resolvedRole, "aria-modal": resolvedAriaModal, "aria-labelledby": titleId, tabIndex: -1, ...rest, "data-testid": "modal", children: [jsxRuntime.jsx("div", { className: prefixedClassNames(classPrefix, 'modal-background'), onClick: onClose, "data-testid": "modal-background" }), isModalCard ? (jsxRuntime.jsxs("div", { className: prefixedClassNames(classPrefix, 'modal-card'), children: [modalCardTitle && (jsxRuntime.jsxs("header", { className: prefixedClassNames(classPrefix, 'modal-card-head'), children: [jsxRuntime.jsx("p", { id: titleId, className: prefixedClassNames(classPrefix, 'modal-card-title'), children: modalCardTitle }), onClose && (jsxRuntime.jsx("button", { className: deleteClass, "aria-label": "close", onClick: onClose, type: "button", "data-testid": "modal-close" }))] })), jsxRuntime.jsx("section", { className: prefixedClassNames(classPrefix, 'modal-card-body'), "data-testid": "modal-body", children: children }), modalCardFoot && (jsxRuntime.jsx("footer", { className: prefixedClassNames(classPrefix, 'modal-card-foot'), children: modalCardFoot }))] })) : (jsxRuntime.jsx("div", { className: prefixedClassNames(classPrefix, 'modal-content'), "data-testid": "modal-content", children: children })), (!isModalCard || (!modalCardTitle && onClose)) && onClose && (jsxRuntime.jsx("button", { className: prefixedClassNames(classPrefix, 'modal-close', 'is-large'), "aria-label": "close", onClick: onClose, type: "button", "data-testid": "modal-close-float" }))] }));
     }
+    // In both forms, so a `Modal.Close` anywhere inside closes this modal.
+    modalElement = (jsxRuntime.jsx(ModalCloseContext.Provider, { value: onClose, children: modalElement }));
     if (isPortaled) {
         const target = resolveContainer(typeof portal === 'boolean' ? undefined : portal);
         return reactDom.createPortal(modalElement, target);