@allxsmith/bestax-bulma 5.37.0 → 5.38.0

package/dist/esm/components/Popover.js

@@ -9,6 +9,7 @@ import { useIsHydrated } from '../helpers/useIsHydrated.js';
 import { useFocusTrap, firstTabStop } from '../helpers/useFocusTrap.js';
 import { useAnchoredPosition, marginGap } from '../helpers/useAnchoredPosition.js';
 import { useClientLayoutEffect } from '../helpers/useClientLayoutEffect.js';
+import { useLatestRef } from '../helpers/useLatestRef.js';
 import { getDeepestActiveElement, isEventInside } from '../helpers/shadowDom.js';
 import { buttonType } from '../helpers/buttonType.js';
 import { warnOnce } from '../helpers/devWarnings.js';
@@ -122,6 +123,10 @@ const PopoverComponent = ({ trigger, children, open: controlledOpen, defaultOpen
             }
         };
     }, [panelMounted, trapFocus, triggerNode]);
+    // Read when a press lands outside, so the listener stays put while `close`
+    // changes identity, which it does with `onOpenChange`, and an inline one
+    // changes on every render of the parent.
+    const closeRef = useLatestRef(close);
     useEffect(() => {
         if (!panelMounted || !closeOnClickOutside)
             return undefined;
@@ -129,14 +134,14 @@ const PopoverComponent = ({ trigger, children, open: controlledOpen, defaultOpen
             if (e === insidePointerRef.current || isEventInside(e, rootRef.current)) {
                 return;
             }
-            close();
+            closeRef.current();
         };
         // The wrapper is on the page whenever the panel is. Its document, an
         // iframe's when the tree renders into one, is where presses land.
         const doc = rootRef.current.ownerDocument;
         doc.addEventListener('pointerdown', handlePointerDown);
         return () => doc.removeEventListener('pointerdown', handlePointerDown);
-    }, [panelMounted, closeOnClickOutside, close]);
+    }, [panelMounted, closeOnClickOutside, closeRef]);
     const handlePanelKeyDown = (e) => {
         if (e.key !== 'Escape' || !closeOnEscape || e.defaultPrevented)
             return;

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

@@ -1 +1 @@
-{"version":3,"file":"Popover.js","sources":["../../../src/components/Popover.tsx"],"sourcesContent":["import React, {\n  cloneElement,\n  createContext,\n  useCallback,\n  useContext,\n  useEffect,\n  useId,\n  useMemo,\n  useRef,\n  useState,\n} from 'react';\nimport { classNames, usePrefixedClassNames } from '../helpers/classNames';\nimport { useBulmaClasses, BulmaClassesProps } from '../helpers/useBulmaClasses';\nimport { withSubComponents } from '../helpers/withSubComponents';\nimport { Portal } from '../helpers/portal';\nimport { useIsHydrated } from '../helpers/useIsHydrated';\nimport { firstTabStop, useFocusTrap } from '../helpers/useFocusTrap';\nimport { marginGap, useAnchoredPosition } from '../helpers/useAnchoredPosition';\nimport { useClientLayoutEffect } from '../helpers/useClientLayoutEffect';\nimport { getDeepestActiveElement, isEventInside } from '../helpers/shadowDom';\nimport { buttonType } from '../helpers/buttonType';\nimport { warnOnce } from '../helpers/devWarnings';\nimport { Button, ButtonOwnProps } from '../elements/Button';\nimport type { PickerPosition } from '../form/_pickerInternals/pickerTypes';\n\n/**\n * Where the panel opens against its trigger: below (`bottom-*`) or above\n * (`top-*`), lined up with the trigger's left or right edge. `auto` picks the\n * one that keeps the panel in the viewport, preferring below and lined up on\n * the left. The same union the date and time pickers take.\n */\nexport type PopoverPosition = PickerPosition;\n\n/**\n * Props for the Popover component. `className`, `id`, the other HTML\n * attributes and the helper props land on the wrapper around the trigger,\n * not on the panel; `contentClassName` reaches the panel.\n * @extraProp {string} [className] - Additional classes for the wrapper around the trigger. The panel takes `contentClassName`.\n */\nexport interface PopoverProps\n  extends\n    Omit<React.HTMLAttributes<HTMLDivElement>, 'color' | 'children'>,\n    Omit<BulmaClassesProps, 'color' | 'backgroundColor'> {\n  /**\n   * The element that opens and closes the popover, such as a `Button`.\n   * Popover gives it `aria-haspopup=\"dialog\"`, `aria-expanded`,\n   * `aria-controls` while the panel is open, and click and key handlers that\n   * run after its own (call `preventDefault()` in yours to keep the popover\n   * from toggling). It has to be a single element that passes `onClick` and\n   * `onKeyDown` to its DOM node. Enter and Space toggle a trigger the browser\n   * doesn't click on its own, and an intrinsic element that isn't already a\n   * control (a `<span>`) also gets `role=\"button\"` and `tabIndex={0}` unless\n   * it sets them; a component that renders one has to take those itself.\n   */\n  trigger: React.ReactElement;\n  /** The panel's content, usually `Popover.Header`, `Popover.Body` and `Popover.Footer`. */\n  children?: React.ReactNode;\n  /**\n   * Controlled open state. When set, the trigger and every dismissal only\n   * report through `onOpenChange`.\n   */\n  open?: boolean;\n  /**\n   * Initial open state when uncontrolled. Opening moves focus into the\n   * panel, so a popover that starts open takes focus once the page loads.\n   * @defaultValue false\n   */\n  defaultOpen?: boolean;\n  /**\n   * Called with the state asked for: `true` from the trigger opening it,\n   * `false` from the trigger, `Popover.Close`, Escape or an outside\n   * `pointerdown`. Fires in both controlled and uncontrolled use.\n   */\n  onOpenChange?: (open: boolean) => void;\n  /**\n   * Where the panel opens against the trigger.\n   * @defaultValue 'bottom-left'\n   */\n  position?: PopoverPosition;\n  /**\n   * Render the panel through `Portal`, into the `portalContainer` a\n   * `ConfigProvider` sets, `document.body` by default, fixed to the viewport,\n   * so an ancestor's `overflow`, `transform` or stacking context can't clip\n   * it. The panel then shows from the commit after hydration, never in server\n   * markup. It is measured against the trigger when it opens and on resize\n   * and scroll, so it doesn't follow content that changes size while it is\n   * open. Theming variables set on an ancestor of the trigger reach it only\n   * when its container is inside that ancestor.\n   * @defaultValue false\n   */\n  appendToBody?: boolean;\n  /**\n   * Keep Tab and Shift+Tab inside the panel while it is open, as the ARIA\n   * dialog pattern does for a non-modal dialog. Pointer focus leaves freely\n   * and the page stays usable. With `false`, Tab moves past the panel and\n   * the popover stays open. Focus moves into the panel on open and back to\n   * the trigger on close either way.\n   * @defaultValue true\n   */\n  trapFocus?: boolean;\n  /**\n   * Close on a `pointerdown` outside the trigger and the panel. Content the\n   * panel renders through a portal (a nested `Popover`, a portaled picker)\n   * still counts as inside.\n   * @defaultValue true\n   */\n  closeOnClickOutside?: boolean;\n  /**\n   * Close on Escape while focus is in the panel or on the trigger. A dialog\n   * nested in the panel, such as a date picker's calendar, takes its own\n   * Escape first, and so does content that calls `preventDefault()` on it.\n   * @defaultValue true\n   */\n  closeOnEscape?: boolean;\n  /**\n   * The panel's accessible name. Without it the panel is named by its\n   * `Popover.Header`, and a development build warns when it has neither.\n   */\n  ariaLabel?: string;\n  /** Additional classes for the panel (`.popover-content`). */\n  contentClassName?: string;\n}\n\ninterface PopoverContextValue {\n  /** The id `Popover.Header` takes, which names the panel. */\n  titleId: string;\n  /** Records a mounted `Popover.Header`; the returned function forgets it. */\n  registerTitle: () => () => void;\n  /** Asks the popover to close. */\n  close: () => void;\n}\n\nconst PopoverContext = createContext<PopoverContextValue | null>(null);\n\n/** The trigger props Popover reads before replacing them. */\ninterface TriggerProps {\n  onClick?: (event: React.MouseEvent<HTMLElement>) => void;\n  onKeyDown?: (event: React.KeyboardEvent<HTMLElement>) => void;\n  role?: string;\n  tabIndex?: number;\n  href?: unknown;\n}\n\n/** Intrinsic elements that are controls already, and keep their own role. */\nconst NATIVE_CONTROLS = new Set([\n  'button',\n  'input',\n  'select',\n  'textarea',\n  'summary',\n]);\n\n/**\n * Whether the browser answers this key on `el` itself, by clicking it or by\n * using the key as input, so the trigger's click handler covers it.\n */\nfunction handlesKeyItself(el: Element, key: string): boolean {\n  if (NATIVE_CONTROLS.has(el.localName)) return true;\n  return el.localName === 'a' && key === 'Enter' && el.hasAttribute('href');\n}\n\n/** The innermost dialog the event passed through, which is the one its Escape belongs to. */\nfunction nearestDialog(event: Event): EventTarget | null {\n  return (\n    event.composedPath().find(node => {\n      const role = (node as Element).getAttribute?.('role');\n      return role === 'dialog' || role === 'alertdialog';\n    }) ?? null\n  );\n}\n\n/**\n * The `Popover` component opens a panel of interactive content, such as a filter form or a set of share options, anchored to the element that toggles it.\n *\n * The panel is a non-modal `role=\"dialog\"`: focus moves into it on open\n * and returns to the trigger on close, while the rest of the page stays\n * reachable by pointer and assistive technology. For hover-only hints use\n * `Tooltip`, and for a list of actions use `Dropdown`.\n *\n * @function\n * @param {PopoverProps} props - Props for the Popover component.\n * @returns {JSX.Element} The trigger in its wrapper, and the panel while open.\n *\n * @example\n * <Popover trigger={<Button>Filters</Button>}>\n *   <Popover.Header>Filter rows</Popover.Header>\n *   <Popover.Body>…</Popover.Body>\n *   <Popover.Footer>\n *     <Popover.Close>Done</Popover.Close>\n *   </Popover.Footer>\n * </Popover>\n */\nconst PopoverComponent: React.FC<PopoverProps> = ({\n  trigger,\n  children,\n  open: controlledOpen,\n  defaultOpen = false,\n  onOpenChange,\n  position = 'bottom-left',\n  appendToBody = false,\n  trapFocus = true,\n  closeOnClickOutside = true,\n  closeOnEscape = true,\n  ariaLabel,\n  className,\n  contentClassName,\n  ...props\n}) => {\n  const { bulmaHelperClasses, rest } = useBulmaClasses(props);\n  const rootRef = useRef<HTMLDivElement>(null);\n  const panelRef = useRef<HTMLDivElement>(null);\n  // The last pointerdown React saw inside the panel. React's tree includes\n  // content the panel portals elsewhere, which the DOM path doesn't.\n  const insidePointerRef = useRef<Event | null>(null);\n  const baseId = useId();\n  const panelId = `${baseId}-panel`;\n  const titleId = `${baseId}-title`;\n\n  const isControlled = controlledOpen !== undefined;\n  const [internalOpen, setInternalOpen] = useState(defaultOpen);\n  const isOpen = controlledOpen ?? internalOpen;\n\n  const requestOpen = useCallback(\n    (next: boolean) => {\n      onOpenChange?.(next);\n      if (!isControlled) setInternalOpen(next);\n    },\n    [isControlled, onOpenChange]\n  );\n  const close = useCallback(() => requestOpen(false), [requestOpen]);\n\n  // A portaled panel has no server markup, so it only exists from the commit\n  // after hydration. Everything that measures or focuses it waits for that.\n  const hydrated = useIsHydrated();\n  const panelMounted = isOpen && (hydrated || !appendToBody);\n\n  const resolved = useAnchoredPosition(rootRef, panelRef, {\n    active: panelMounted,\n    position,\n    fixed: appendToBody,\n    // The gap comes from `--bulma-popover-offset` in the stylesheet, so the\n    // coordinates leave it out and `auto` reads it off the panel.\n    offset: 0,\n    styledGap: marginGap,\n  });\n\n  // The trigger renders first inside the wrapper. Read when needed rather\n  // than held, so a trigger that remounted is still the one found.\n  const triggerNode = useCallback((): HTMLElement | null => {\n    const first = rootRef.current?.firstElementChild;\n    return first && first !== panelRef.current ? (first as HTMLElement) : null;\n  }, []);\n  const restoreFocusRef = useMemo(\n    () => ({\n      get current() {\n        return triggerNode();\n      },\n    }),\n    [triggerNode]\n  );\n\n  useFocusTrap(panelRef, {\n    active: panelMounted && trapFocus,\n    restoreFocus: restoreFocusRef,\n  });\n\n  // Without the trap, focus still arrives in the panel and goes back to the\n  // trigger, on the trap's terms: only while the panel still holds it.\n  useEffect(() => {\n    const panel = panelRef.current;\n    if (!panelMounted || trapFocus || !panel) return undefined;\n    (firstTabStop(panel) ?? panel).focus();\n    return () => {\n      const doc = panel.ownerDocument;\n      const now = getDeepestActiveElement(doc);\n      if (!now || now === doc.body || panel.contains(now)) {\n        triggerNode()?.focus();\n      }\n    };\n  }, [panelMounted, trapFocus, triggerNode]);\n\n  useEffect(() => {\n    if (!panelMounted || !closeOnClickOutside) return undefined;\n    const handlePointerDown = (e: PointerEvent) => {\n      if (e === insidePointerRef.current || isEventInside(e, rootRef.current)) {\n        return;\n      }\n      close();\n    };\n    // The wrapper is on the page whenever the panel is. Its document, an\n    // iframe's when the tree renders into one, is where presses land.\n    const doc = (rootRef.current as HTMLDivElement).ownerDocument;\n    doc.addEventListener('pointerdown', handlePointerDown);\n    return () => doc.removeEventListener('pointerdown', handlePointerDown);\n  }, [panelMounted, closeOnClickOutside, close]);\n\n  const handlePanelKeyDown = (e: React.KeyboardEvent<HTMLDivElement>) => {\n    if (e.key !== 'Escape' || !closeOnEscape || e.defaultPrevented) return;\n    // React bubbles the key here from portaled content as well, so a dialog\n    // of its own on the way (a nested popover, a picker's calendar) owns it.\n    const owner = nearestDialog(e.nativeEvent);\n    if (owner && owner !== panelRef.current) return;\n    e.preventDefault();\n    close();\n  };\n\n  const triggerProps = trigger.props as TriggerProps;\n\n  const handleTriggerClick = (e: React.MouseEvent<HTMLElement>) => {\n    triggerProps.onClick?.(e);\n    if (!e.defaultPrevented) requestOpen(!isOpen);\n  };\n\n  const handleTriggerKeyDown = (e: React.KeyboardEvent<HTMLElement>) => {\n    triggerProps.onKeyDown?.(e);\n    // A key on something inside the trigger is that element's to answer.\n    if (e.defaultPrevented || e.target !== e.currentTarget) return;\n    if (e.key === 'Escape') {\n      if (isOpen && closeOnEscape) {\n        e.preventDefault();\n        close();\n      }\n      return;\n    }\n    if (e.key !== 'Enter' && e.key !== ' ') return;\n    if (handlesKeyItself(e.currentTarget, e.key)) return;\n    // Space would scroll the page; a held key repeats.\n    e.preventDefault();\n    if (!e.repeat) requestOpen(!isOpen);\n  };\n\n  const needsButtonRole =\n    typeof trigger.type === 'string' &&\n    !NATIVE_CONTROLS.has(trigger.type) &&\n    !(trigger.type === 'a' && triggerProps.href != null);\n\n  const clonedTrigger = cloneElement(\n    trigger as React.ReactElement<Record<string, unknown>>,\n    {\n      ...(needsButtonRole\n        ? {\n            role: triggerProps.role ?? 'button',\n            tabIndex: triggerProps.tabIndex ?? 0,\n          }\n        : {}),\n      'aria-haspopup': 'dialog',\n      'aria-expanded': isOpen,\n      'aria-controls': panelMounted ? panelId : undefined,\n      onClick: handleTriggerClick,\n      onKeyDown: handleTriggerKeyDown,\n    }\n  );\n\n  const rootClasses = classNames(\n    usePrefixedClassNames('popover', { 'is-active': isOpen }),\n    bulmaHelperClasses,\n    className\n  );\n  const panelClasses = classNames(\n    usePrefixedClassNames('popover-content', {\n      [`is-${resolved.position}`]: true,\n      'is-portal': appendToBody,\n    }),\n    contentClassName\n  );\n\n  return (\n    // The ref after the spread: React 19 hands a function component a `ref`\n    // prop like any other, and the wrapper has to stay ours.\n    <div className={rootClasses} {...rest} ref={rootRef}>\n      {clonedTrigger}\n      {isOpen && (\n        <Portal disabled={!appendToBody}>\n          <PopoverPanel\n            panelRef={panelRef}\n            titleId={titleId}\n            ariaLabel={ariaLabel}\n            close={close}\n            id={panelId}\n            className={panelClasses}\n            style={\n              appendToBody\n                ? {\n                    position: 'fixed',\n                    top: resolved.top,\n                    left: resolved.left,\n                  }\n                : undefined\n            }\n            onKeyDown={handlePanelKeyDown}\n            onPointerDownCapture={e => {\n              insidePointerRef.current = e.nativeEvent;\n            }}\n          >\n            {children}\n          </PopoverPanel>\n        </Portal>\n      )}\n    </div>\n  );\n};\n\ninterface PopoverPanelProps extends React.HTMLAttributes<HTMLDivElement> {\n  panelRef: React.RefObject<HTMLDivElement | null>;\n  titleId: string;\n  ariaLabel?: string;\n  close: () => void;\n}\n\n/**\n * The open panel. It mounts with each opening, so it counts the\n * `Popover.Header`s inside it afresh every time.\n */\nfunction PopoverPanel({\n  panelRef,\n  titleId,\n  ariaLabel,\n  close,\n  children,\n  ...attrs\n}: PopoverPanelProps) {\n  // Headers register in a layout effect, after this first render, and this\n  // panel's own layout effect runs after theirs. Until then the panel assumes\n  // it has one, so a panel that does is named from its first commit, before\n  // focus moves in, and one that doesn't drops the reference before it paints.\n  const [titlesCounted, setTitlesCounted] = useState(false);\n  const [titleCount, setTitleCount] = useState(0);\n  const registerTitle = useCallback(() => {\n    setTitleCount(n => n + 1);\n    return () => setTitleCount(n => n - 1);\n  }, []);\n  useClientLayoutEffect(() => {\n    setTitlesCounted(true);\n  }, []);\n  const named = Boolean(ariaLabel) || titleCount > 0;\n\n  useEffect(() => {\n    if (titlesCounted && !named) {\n      warnOnce(\n        'Popover:unnamed',\n        '[bestax-bulma] <Popover> opened a panel with no accessible name. ' +\n          'Pass ariaLabel, or render a Popover.Header inside it.'\n      );\n    }\n  }, [titlesCounted, named]);\n\n  const context = useMemo(\n    () => ({ titleId, registerTitle, close }),\n    [titleId, registerTitle, close]\n  );\n\n  return (\n    <PopoverContext.Provider value={context}>\n      <div\n        {...attrs}\n        ref={panelRef}\n        role=\"dialog\"\n        aria-label={ariaLabel}\n        aria-labelledby={\n          !ariaLabel && (!titlesCounted || titleCount > 0) ? titleId : undefined\n        }\n        tabIndex={-1}\n      >\n        {children}\n      </div>\n    </PopoverContext.Provider>\n  );\n}\n\n/**\n * Props for the Popover.Header component. Its `id` is the one the panel's\n * `aria-labelledby` names, so it isn't yours to set.\n */\nexport interface PopoverHeaderProps\n  extends\n    Omit<React.HTMLAttributes<HTMLDivElement>, 'color' | 'id'>,\n    BulmaClassesProps {\n  /** Additional CSS classes. */\n  className?: string;\n}\n\n/**\n * The popover's title, which names the panel for assistive technology.\n *\n * @function\n * @param {PopoverHeaderProps} props - Props for the Popover.Header component.\n * @returns {JSX.Element} The header element.\n */\nexport const PopoverHeader: React.FC<PopoverHeaderProps> = ({\n  className,\n  ...props\n}) => {\n  const context = useContext(PopoverContext);\n  const registerTitle = context?.registerTitle;\n  // Before paint, so the panel is named by the time it shows.\n  useClientLayoutEffect(() => registerTitle?.(), [registerTitle]);\n  const { bulmaHelperClasses, rest } = useBulmaClasses(props);\n  return (\n    <div\n      className={classNames(\n        usePrefixedClassNames('popover-header'),\n        bulmaHelperClasses,\n        className\n      )}\n      {...rest}\n      id={context?.titleId}\n    />\n  );\n};\n\n/**\n * Props for the Popover.Body component.\n */\nexport interface PopoverBodyProps\n  extends\n    Omit<React.HTMLAttributes<HTMLDivElement>, 'color'>,\n    BulmaClassesProps {\n  /** Additional CSS classes. */\n  className?: string;\n}\n\n/**\n * The popover's main content area.\n *\n * @function\n * @param {PopoverBodyProps} props - Props for the Popover.Body component.\n * @returns {JSX.Element} The body element.\n */\nexport const PopoverBody: React.FC<PopoverBodyProps> = ({\n  className,\n  ...props\n}) => {\n  const { bulmaHelperClasses, rest } = useBulmaClasses(props);\n  return (\n    <div\n      className={classNames(\n        usePrefixedClassNames('popover-body'),\n        bulmaHelperClasses,\n        className\n      )}\n      {...rest}\n    />\n  );\n};\n\n/**\n * Props for the Popover.Footer component.\n */\nexport interface PopoverFooterProps\n  extends\n    Omit<React.HTMLAttributes<HTMLDivElement>, 'color'>,\n    BulmaClassesProps {\n  /** Additional CSS classes. */\n  className?: string;\n}\n\n/**\n * A row of actions along the bottom of the popover, aligned to the end.\n *\n * @function\n * @param {PopoverFooterProps} props - Props for the Popover.Footer component.\n * @returns {JSX.Element} The footer element.\n */\nexport const PopoverFooter: React.FC<PopoverFooterProps> = ({\n  className,\n  ...props\n}) => {\n  const { bulmaHelperClasses, rest } = useBulmaClasses(props);\n  return (\n    <div\n      className={classNames(\n        usePrefixedClassNames('popover-footer'),\n        bulmaHelperClasses,\n        className\n      )}\n      {...rest}\n    />\n  );\n};\n\n/**\n * Props for the Popover.Close component: the props of a `Button` rendered as\n * a `<button>`.\n * @extraProp {'button' | 'submit' | 'reset'} [type='button'] - Button type. Defaults to `'button'`, so a close button inside a form doesn't submit it.\n * @extraProp {React.MouseEventHandler<HTMLButtonElement>} [onClick] - Runs before the popover closes. Call `preventDefault()` to keep it open.\n */\nexport interface PopoverCloseProps\n  extends\n    ButtonOwnProps,\n    Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, keyof ButtonOwnProps> {}\n\n/**\n * A `Button` that closes the popover, handing focus back to the trigger.\n *\n * @function\n * @param {PopoverCloseProps} props - Props for the Popover.Close component.\n * @returns {JSX.Element} The close button.\n */\nexport const PopoverClose: React.FC<PopoverCloseProps> = ({\n  onClick,\n  ...props\n}) => {\n  const context = useContext(PopoverContext);\n  return (\n    <Button\n      {...props}\n      type={buttonType(props.type)}\n      onClick={(e: React.MouseEvent<HTMLButtonElement>) => {\n        onClick?.(e);\n        if (!e.defaultPrevented) context?.close();\n      }}\n    />\n  );\n};\n\n/** Popover with Header, Body, Footer and Close sub-components. */\nexport const Popover = withSubComponents(\n  PopoverComponent,\n  {\n    Header: PopoverHeader,\n    Body: PopoverBody,\n    Footer: PopoverFooter,\n    Close: PopoverClose,\n  },\n  'Popover'\n);\n\nexport default Popover;\n"],"names":["_jsxs","_jsx"],"mappings":"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"}
+{"version":3,"file":"Popover.js","sources":["../../../src/components/Popover.tsx"],"sourcesContent":["import React, {\n  cloneElement,\n  createContext,\n  useCallback,\n  useContext,\n  useEffect,\n  useId,\n  useMemo,\n  useRef,\n  useState,\n} from 'react';\nimport { classNames, usePrefixedClassNames } from '../helpers/classNames';\nimport { useBulmaClasses, BulmaClassesProps } from '../helpers/useBulmaClasses';\nimport { withSubComponents } from '../helpers/withSubComponents';\nimport { Portal } from '../helpers/portal';\nimport { useIsHydrated } from '../helpers/useIsHydrated';\nimport { firstTabStop, useFocusTrap } from '../helpers/useFocusTrap';\nimport { marginGap, useAnchoredPosition } from '../helpers/useAnchoredPosition';\nimport { useClientLayoutEffect } from '../helpers/useClientLayoutEffect';\nimport { useLatestRef } from '../helpers/useLatestRef';\nimport { getDeepestActiveElement, isEventInside } from '../helpers/shadowDom';\nimport { buttonType } from '../helpers/buttonType';\nimport { warnOnce } from '../helpers/devWarnings';\nimport { Button, ButtonOwnProps } from '../elements/Button';\nimport type { PickerPosition } from '../form/_pickerInternals/pickerTypes';\n\n/**\n * Where the panel opens against its trigger: below (`bottom-*`) or above\n * (`top-*`), lined up with the trigger's left or right edge. `auto` picks the\n * one that keeps the panel in the viewport, preferring below and lined up on\n * the left. The same union the date and time pickers take.\n */\nexport type PopoverPosition = PickerPosition;\n\n/**\n * Props for the Popover component. `className`, `id`, the other HTML\n * attributes and the helper props land on the wrapper around the trigger,\n * not on the panel; `contentClassName` reaches the panel.\n * @extraProp {string} [className] - Additional classes for the wrapper around the trigger. The panel takes `contentClassName`.\n */\nexport interface PopoverProps\n  extends\n    Omit<React.HTMLAttributes<HTMLDivElement>, 'color' | 'children'>,\n    Omit<BulmaClassesProps, 'color' | 'backgroundColor'> {\n  /**\n   * The element that opens and closes the popover, such as a `Button`.\n   * Popover gives it `aria-haspopup=\"dialog\"`, `aria-expanded`,\n   * `aria-controls` while the panel is open, and click and key handlers that\n   * run after its own (call `preventDefault()` in yours to keep the popover\n   * from toggling). It has to be a single element that passes `onClick` and\n   * `onKeyDown` to its DOM node. Enter and Space toggle a trigger the browser\n   * doesn't click on its own, and an intrinsic element that isn't already a\n   * control (a `<span>`) also gets `role=\"button\"` and `tabIndex={0}` unless\n   * it sets them; a component that renders one has to take those itself.\n   */\n  trigger: React.ReactElement;\n  /** The panel's content, usually `Popover.Header`, `Popover.Body` and `Popover.Footer`. */\n  children?: React.ReactNode;\n  /**\n   * Controlled open state. When set, the trigger and every dismissal only\n   * report through `onOpenChange`.\n   */\n  open?: boolean;\n  /**\n   * Initial open state when uncontrolled. Opening moves focus into the\n   * panel, so a popover that starts open takes focus once the page loads.\n   * @defaultValue false\n   */\n  defaultOpen?: boolean;\n  /**\n   * Called with the state asked for: `true` from the trigger opening it,\n   * `false` from the trigger, `Popover.Close`, Escape or an outside\n   * `pointerdown`. Fires in both controlled and uncontrolled use.\n   */\n  onOpenChange?: (open: boolean) => void;\n  /**\n   * Where the panel opens against the trigger.\n   * @defaultValue 'bottom-left'\n   */\n  position?: PopoverPosition;\n  /**\n   * Render the panel through `Portal`, into the `portalContainer` a\n   * `ConfigProvider` sets, `document.body` by default, fixed to the viewport,\n   * so an ancestor's `overflow`, `transform` or stacking context can't clip\n   * it. The panel then shows from the commit after hydration, never in server\n   * markup. It is measured against the trigger when it opens and on resize\n   * and scroll, so it doesn't follow content that changes size while it is\n   * open. Theming variables set on an ancestor of the trigger reach it only\n   * when its container is inside that ancestor.\n   * @defaultValue false\n   */\n  appendToBody?: boolean;\n  /**\n   * Keep Tab and Shift+Tab inside the panel while it is open, as the ARIA\n   * dialog pattern does for a non-modal dialog. Pointer focus leaves freely\n   * and the page stays usable. With `false`, Tab moves past the panel and\n   * the popover stays open. Focus moves into the panel on open and back to\n   * the trigger on close either way.\n   * @defaultValue true\n   */\n  trapFocus?: boolean;\n  /**\n   * Close on a `pointerdown` outside the trigger and the panel. Content the\n   * panel renders through a portal (a nested `Popover`, a portaled picker)\n   * still counts as inside.\n   * @defaultValue true\n   */\n  closeOnClickOutside?: boolean;\n  /**\n   * Close on Escape while focus is in the panel or on the trigger. A dialog\n   * nested in the panel, such as a date picker's calendar, takes its own\n   * Escape first, and so does content that calls `preventDefault()` on it.\n   * @defaultValue true\n   */\n  closeOnEscape?: boolean;\n  /**\n   * The panel's accessible name. Without it the panel is named by its\n   * `Popover.Header`, and a development build warns when it has neither.\n   */\n  ariaLabel?: string;\n  /** Additional classes for the panel (`.popover-content`). */\n  contentClassName?: string;\n}\n\ninterface PopoverContextValue {\n  /** The id `Popover.Header` takes, which names the panel. */\n  titleId: string;\n  /** Records a mounted `Popover.Header`; the returned function forgets it. */\n  registerTitle: () => () => void;\n  /** Asks the popover to close. */\n  close: () => void;\n}\n\nconst PopoverContext = createContext<PopoverContextValue | null>(null);\n\n/** The trigger props Popover reads before replacing them. */\ninterface TriggerProps {\n  onClick?: (event: React.MouseEvent<HTMLElement>) => void;\n  onKeyDown?: (event: React.KeyboardEvent<HTMLElement>) => void;\n  role?: string;\n  tabIndex?: number;\n  href?: unknown;\n}\n\n/** Intrinsic elements that are controls already, and keep their own role. */\nconst NATIVE_CONTROLS = new Set([\n  'button',\n  'input',\n  'select',\n  'textarea',\n  'summary',\n]);\n\n/**\n * Whether the browser answers this key on `el` itself, by clicking it or by\n * using the key as input, so the trigger's click handler covers it.\n */\nfunction handlesKeyItself(el: Element, key: string): boolean {\n  if (NATIVE_CONTROLS.has(el.localName)) return true;\n  return el.localName === 'a' && key === 'Enter' && el.hasAttribute('href');\n}\n\n/** The innermost dialog the event passed through, which is the one its Escape belongs to. */\nfunction nearestDialog(event: Event): EventTarget | null {\n  return (\n    event.composedPath().find(node => {\n      const role = (node as Element).getAttribute?.('role');\n      return role === 'dialog' || role === 'alertdialog';\n    }) ?? null\n  );\n}\n\n/**\n * The `Popover` component opens a panel of interactive content, such as a filter form or a set of share options, anchored to the element that toggles it.\n *\n * The panel is a non-modal `role=\"dialog\"`: focus moves into it on open\n * and returns to the trigger on close, while the rest of the page stays\n * reachable by pointer and assistive technology. For hover-only hints use\n * `Tooltip`, and for a list of actions use `Dropdown`.\n *\n * @function\n * @param {PopoverProps} props - Props for the Popover component.\n * @returns {JSX.Element} The trigger in its wrapper, and the panel while open.\n *\n * @example\n * <Popover trigger={<Button>Filters</Button>}>\n *   <Popover.Header>Filter rows</Popover.Header>\n *   <Popover.Body>…</Popover.Body>\n *   <Popover.Footer>\n *     <Popover.Close>Done</Popover.Close>\n *   </Popover.Footer>\n * </Popover>\n */\nconst PopoverComponent: React.FC<PopoverProps> = ({\n  trigger,\n  children,\n  open: controlledOpen,\n  defaultOpen = false,\n  onOpenChange,\n  position = 'bottom-left',\n  appendToBody = false,\n  trapFocus = true,\n  closeOnClickOutside = true,\n  closeOnEscape = true,\n  ariaLabel,\n  className,\n  contentClassName,\n  ...props\n}) => {\n  const { bulmaHelperClasses, rest } = useBulmaClasses(props);\n  const rootRef = useRef<HTMLDivElement>(null);\n  const panelRef = useRef<HTMLDivElement>(null);\n  // The last pointerdown React saw inside the panel. React's tree includes\n  // content the panel portals elsewhere, which the DOM path doesn't.\n  const insidePointerRef = useRef<Event | null>(null);\n  const baseId = useId();\n  const panelId = `${baseId}-panel`;\n  const titleId = `${baseId}-title`;\n\n  const isControlled = controlledOpen !== undefined;\n  const [internalOpen, setInternalOpen] = useState(defaultOpen);\n  const isOpen = controlledOpen ?? internalOpen;\n\n  const requestOpen = useCallback(\n    (next: boolean) => {\n      onOpenChange?.(next);\n      if (!isControlled) setInternalOpen(next);\n    },\n    [isControlled, onOpenChange]\n  );\n  const close = useCallback(() => requestOpen(false), [requestOpen]);\n\n  // A portaled panel has no server markup, so it only exists from the commit\n  // after hydration. Everything that measures or focuses it waits for that.\n  const hydrated = useIsHydrated();\n  const panelMounted = isOpen && (hydrated || !appendToBody);\n\n  const resolved = useAnchoredPosition(rootRef, panelRef, {\n    active: panelMounted,\n    position,\n    fixed: appendToBody,\n    // The gap comes from `--bulma-popover-offset` in the stylesheet, so the\n    // coordinates leave it out and `auto` reads it off the panel.\n    offset: 0,\n    styledGap: marginGap,\n  });\n\n  // The trigger renders first inside the wrapper. Read when needed rather\n  // than held, so a trigger that remounted is still the one found.\n  const triggerNode = useCallback((): HTMLElement | null => {\n    const first = rootRef.current?.firstElementChild;\n    return first && first !== panelRef.current ? (first as HTMLElement) : null;\n  }, []);\n  const restoreFocusRef = useMemo(\n    () => ({\n      get current() {\n        return triggerNode();\n      },\n    }),\n    [triggerNode]\n  );\n\n  useFocusTrap(panelRef, {\n    active: panelMounted && trapFocus,\n    restoreFocus: restoreFocusRef,\n  });\n\n  // Without the trap, focus still arrives in the panel and goes back to the\n  // trigger, on the trap's terms: only while the panel still holds it.\n  useEffect(() => {\n    const panel = panelRef.current;\n    if (!panelMounted || trapFocus || !panel) return undefined;\n    (firstTabStop(panel) ?? panel).focus();\n    return () => {\n      const doc = panel.ownerDocument;\n      const now = getDeepestActiveElement(doc);\n      if (!now || now === doc.body || panel.contains(now)) {\n        triggerNode()?.focus();\n      }\n    };\n  }, [panelMounted, trapFocus, triggerNode]);\n\n  // Read when a press lands outside, so the listener stays put while `close`\n  // changes identity, which it does with `onOpenChange`, and an inline one\n  // changes on every render of the parent.\n  const closeRef = useLatestRef(close);\n\n  useEffect(() => {\n    if (!panelMounted || !closeOnClickOutside) return undefined;\n    const handlePointerDown = (e: PointerEvent) => {\n      if (e === insidePointerRef.current || isEventInside(e, rootRef.current)) {\n        return;\n      }\n      closeRef.current();\n    };\n    // The wrapper is on the page whenever the panel is. Its document, an\n    // iframe's when the tree renders into one, is where presses land.\n    const doc = (rootRef.current as HTMLDivElement).ownerDocument;\n    doc.addEventListener('pointerdown', handlePointerDown);\n    return () => doc.removeEventListener('pointerdown', handlePointerDown);\n  }, [panelMounted, closeOnClickOutside, closeRef]);\n\n  const handlePanelKeyDown = (e: React.KeyboardEvent<HTMLDivElement>) => {\n    if (e.key !== 'Escape' || !closeOnEscape || e.defaultPrevented) return;\n    // React bubbles the key here from portaled content as well, so a dialog\n    // of its own on the way (a nested popover, a picker's calendar) owns it.\n    const owner = nearestDialog(e.nativeEvent);\n    if (owner && owner !== panelRef.current) return;\n    e.preventDefault();\n    close();\n  };\n\n  const triggerProps = trigger.props as TriggerProps;\n\n  const handleTriggerClick = (e: React.MouseEvent<HTMLElement>) => {\n    triggerProps.onClick?.(e);\n    if (!e.defaultPrevented) requestOpen(!isOpen);\n  };\n\n  const handleTriggerKeyDown = (e: React.KeyboardEvent<HTMLElement>) => {\n    triggerProps.onKeyDown?.(e);\n    // A key on something inside the trigger is that element's to answer.\n    if (e.defaultPrevented || e.target !== e.currentTarget) return;\n    if (e.key === 'Escape') {\n      if (isOpen && closeOnEscape) {\n        e.preventDefault();\n        close();\n      }\n      return;\n    }\n    if (e.key !== 'Enter' && e.key !== ' ') return;\n    if (handlesKeyItself(e.currentTarget, e.key)) return;\n    // Space would scroll the page; a held key repeats.\n    e.preventDefault();\n    if (!e.repeat) requestOpen(!isOpen);\n  };\n\n  const needsButtonRole =\n    typeof trigger.type === 'string' &&\n    !NATIVE_CONTROLS.has(trigger.type) &&\n    !(trigger.type === 'a' && triggerProps.href != null);\n\n  const clonedTrigger = cloneElement(\n    trigger as React.ReactElement<Record<string, unknown>>,\n    {\n      ...(needsButtonRole\n        ? {\n            role: triggerProps.role ?? 'button',\n            tabIndex: triggerProps.tabIndex ?? 0,\n          }\n        : {}),\n      'aria-haspopup': 'dialog',\n      'aria-expanded': isOpen,\n      'aria-controls': panelMounted ? panelId : undefined,\n      onClick: handleTriggerClick,\n      onKeyDown: handleTriggerKeyDown,\n    }\n  );\n\n  const rootClasses = classNames(\n    usePrefixedClassNames('popover', { 'is-active': isOpen }),\n    bulmaHelperClasses,\n    className\n  );\n  const panelClasses = classNames(\n    usePrefixedClassNames('popover-content', {\n      [`is-${resolved.position}`]: true,\n      'is-portal': appendToBody,\n    }),\n    contentClassName\n  );\n\n  return (\n    // The ref after the spread: React 19 hands a function component a `ref`\n    // prop like any other, and the wrapper has to stay ours.\n    <div className={rootClasses} {...rest} ref={rootRef}>\n      {clonedTrigger}\n      {isOpen && (\n        <Portal disabled={!appendToBody}>\n          <PopoverPanel\n            panelRef={panelRef}\n            titleId={titleId}\n            ariaLabel={ariaLabel}\n            close={close}\n            id={panelId}\n            className={panelClasses}\n            style={\n              appendToBody\n                ? {\n                    position: 'fixed',\n                    top: resolved.top,\n                    left: resolved.left,\n                  }\n                : undefined\n            }\n            onKeyDown={handlePanelKeyDown}\n            onPointerDownCapture={e => {\n              insidePointerRef.current = e.nativeEvent;\n            }}\n          >\n            {children}\n          </PopoverPanel>\n        </Portal>\n      )}\n    </div>\n  );\n};\n\ninterface PopoverPanelProps extends React.HTMLAttributes<HTMLDivElement> {\n  panelRef: React.RefObject<HTMLDivElement | null>;\n  titleId: string;\n  ariaLabel?: string;\n  close: () => void;\n}\n\n/**\n * The open panel. It mounts with each opening, so it counts the\n * `Popover.Header`s inside it afresh every time.\n */\nfunction PopoverPanel({\n  panelRef,\n  titleId,\n  ariaLabel,\n  close,\n  children,\n  ...attrs\n}: PopoverPanelProps) {\n  // Headers register in a layout effect, after this first render, and this\n  // panel's own layout effect runs after theirs. Until then the panel assumes\n  // it has one, so a panel that does is named from its first commit, before\n  // focus moves in, and one that doesn't drops the reference before it paints.\n  const [titlesCounted, setTitlesCounted] = useState(false);\n  const [titleCount, setTitleCount] = useState(0);\n  const registerTitle = useCallback(() => {\n    setTitleCount(n => n + 1);\n    return () => setTitleCount(n => n - 1);\n  }, []);\n  useClientLayoutEffect(() => {\n    setTitlesCounted(true);\n  }, []);\n  const named = Boolean(ariaLabel) || titleCount > 0;\n\n  useEffect(() => {\n    if (titlesCounted && !named) {\n      warnOnce(\n        'Popover:unnamed',\n        '[bestax-bulma] <Popover> opened a panel with no accessible name. ' +\n          'Pass ariaLabel, or render a Popover.Header inside it.'\n      );\n    }\n  }, [titlesCounted, named]);\n\n  const context = useMemo(\n    () => ({ titleId, registerTitle, close }),\n    [titleId, registerTitle, close]\n  );\n\n  return (\n    <PopoverContext.Provider value={context}>\n      <div\n        {...attrs}\n        ref={panelRef}\n        role=\"dialog\"\n        aria-label={ariaLabel}\n        aria-labelledby={\n          !ariaLabel && (!titlesCounted || titleCount > 0) ? titleId : undefined\n        }\n        tabIndex={-1}\n      >\n        {children}\n      </div>\n    </PopoverContext.Provider>\n  );\n}\n\n/**\n * Props for the Popover.Header component. Its `id` is the one the panel's\n * `aria-labelledby` names, so it isn't yours to set.\n */\nexport interface PopoverHeaderProps\n  extends\n    Omit<React.HTMLAttributes<HTMLDivElement>, 'color' | 'id'>,\n    BulmaClassesProps {\n  /** Additional CSS classes. */\n  className?: string;\n}\n\n/**\n * The popover's title, which names the panel for assistive technology.\n *\n * @function\n * @param {PopoverHeaderProps} props - Props for the Popover.Header component.\n * @returns {JSX.Element} The header element.\n */\nexport const PopoverHeader: React.FC<PopoverHeaderProps> = ({\n  className,\n  ...props\n}) => {\n  const context = useContext(PopoverContext);\n  const registerTitle = context?.registerTitle;\n  // Before paint, so the panel is named by the time it shows.\n  useClientLayoutEffect(() => registerTitle?.(), [registerTitle]);\n  const { bulmaHelperClasses, rest } = useBulmaClasses(props);\n  return (\n    <div\n      className={classNames(\n        usePrefixedClassNames('popover-header'),\n        bulmaHelperClasses,\n        className\n      )}\n      {...rest}\n      id={context?.titleId}\n    />\n  );\n};\n\n/**\n * Props for the Popover.Body component.\n */\nexport interface PopoverBodyProps\n  extends\n    Omit<React.HTMLAttributes<HTMLDivElement>, 'color'>,\n    BulmaClassesProps {\n  /** Additional CSS classes. */\n  className?: string;\n}\n\n/**\n * The popover's main content area.\n *\n * @function\n * @param {PopoverBodyProps} props - Props for the Popover.Body component.\n * @returns {JSX.Element} The body element.\n */\nexport const PopoverBody: React.FC<PopoverBodyProps> = ({\n  className,\n  ...props\n}) => {\n  const { bulmaHelperClasses, rest } = useBulmaClasses(props);\n  return (\n    <div\n      className={classNames(\n        usePrefixedClassNames('popover-body'),\n        bulmaHelperClasses,\n        className\n      )}\n      {...rest}\n    />\n  );\n};\n\n/**\n * Props for the Popover.Footer component.\n */\nexport interface PopoverFooterProps\n  extends\n    Omit<React.HTMLAttributes<HTMLDivElement>, 'color'>,\n    BulmaClassesProps {\n  /** Additional CSS classes. */\n  className?: string;\n}\n\n/**\n * A row of actions along the bottom of the popover, aligned to the end.\n *\n * @function\n * @param {PopoverFooterProps} props - Props for the Popover.Footer component.\n * @returns {JSX.Element} The footer element.\n */\nexport const PopoverFooter: React.FC<PopoverFooterProps> = ({\n  className,\n  ...props\n}) => {\n  const { bulmaHelperClasses, rest } = useBulmaClasses(props);\n  return (\n    <div\n      className={classNames(\n        usePrefixedClassNames('popover-footer'),\n        bulmaHelperClasses,\n        className\n      )}\n      {...rest}\n    />\n  );\n};\n\n/**\n * Props for the Popover.Close component: the props of a `Button` rendered as\n * a `<button>`.\n * @extraProp {'button' | 'submit' | 'reset'} [type='button'] - Button type. Defaults to `'button'`, so a close button inside a form doesn't submit it.\n * @extraProp {React.MouseEventHandler<HTMLButtonElement>} [onClick] - Runs before the popover closes. Call `preventDefault()` to keep it open.\n */\nexport interface PopoverCloseProps\n  extends\n    ButtonOwnProps,\n    Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, keyof ButtonOwnProps> {}\n\n/**\n * A `Button` that closes the popover, handing focus back to the trigger.\n *\n * @function\n * @param {PopoverCloseProps} props - Props for the Popover.Close component.\n * @returns {JSX.Element} The close button.\n */\nexport const PopoverClose: React.FC<PopoverCloseProps> = ({\n  onClick,\n  ...props\n}) => {\n  const context = useContext(PopoverContext);\n  return (\n    <Button\n      {...props}\n      type={buttonType(props.type)}\n      onClick={(e: React.MouseEvent<HTMLButtonElement>) => {\n        onClick?.(e);\n        if (!e.defaultPrevented) context?.close();\n      }}\n    />\n  );\n};\n\n/** Popover with Header, Body, Footer and Close sub-components. */\nexport const Popover = withSubComponents(\n  PopoverComponent,\n  {\n    Header: PopoverHeader,\n    Body: PopoverBody,\n    Footer: PopoverFooter,\n    Close: PopoverClose,\n  },\n  'Popover'\n);\n\nexport default Popover;\n"],"names":["_jsxs","_jsx"],"mappings":"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"}

package/dist/esm/components/Sidebar.js

@@ -11,6 +11,9 @@ import { useConfig } from '../helpers/Config.js';
 import { buttonType } from '../helpers/buttonType.js';
 import { useLatestRef } from '../helpers/useLatestRef.js';
 import { useOverlayStack } from '../helpers/overlayStack.js';
+import { trapTab, firstTabStop } from '../helpers/useFocusTrap.js';
+import { inertProps } from '../helpers/inertProps.js';
+import { getDeepestActiveElement, getActiveElementInTree } from '../helpers/shadowDom.js';
 
 /**
  * The `Sidebar` component provides a slide-out navigation panel that appears from the left or right side of the screen.
@@ -84,27 +87,53 @@ const SidebarComponent = forwardRef(({ isOpen, onClose, position = 'left', width
         window.addEventListener('keydown', handleKeyDown);
         return () => window.removeEventListener('keydown', handleKeyDown);
     }, [isOpen, closesOnEscape, handleCloseRef, isTopmost]);
+    // Keep Tab inside while there's an overlay, as `Modal` does:
+    // `aria-modal` hides the rest of the page from assistive technology, so
+    // the keyboard order has to agree. Only while it's the topmost overlay,
+    // so a Modal or Dialog opened over the sidebar, even one rendered inside
+    // it, holds Tab instead until it closes. On `window` for the same reason
+    // as Escape: a trap inside, such as a portaled popup's, has had the Tab
+    // first, and one it used is left where it put focus. It's the trap
+    // `useFocusTrap` sets, so a Tab the browser still takes out, as Safari
+    // does past links, is sent back in.
+    useEffect(() => {
+        const node = sidebarRef.current;
+        if (!isOpen || !overlay || !node)
+            return undefined;
+        return trapTab(node, window, isTopmost);
+        // A different `defaultTarget`, or switching `inline`, remounts the
+        // aside, so the trap moves to the new node.
+    }, [isOpen, overlay, isTopmost, defaultTarget, inline]);
     // Prevent body scroll when sidebar is open. Ref-counted through the shared
     // helper so an overlapping Modal/Dialog/Loading doesn't unlock underneath.
     useScrollLock(isOpen && overlay);
-    // Focus trap (basic - focus sidebar when opened). A different
-    // `defaultTarget` remounts the portaled sidebar, so it focuses the new
-    // nodes then too.
+    // Move focus into the sidebar on open, to the first stop Tab wraps to or
+    // the sidebar itself, and hand it back on close, as `Modal` does. A
+    // different `defaultTarget` remounts the portaled sidebar: the cleanup
+    // hands focus back from the old nodes, which left it on <body>, and the
+    // re-run records the same opener and focuses the new nodes.
     useEffect(() => {
-        if (isOpen) {
-            const element = sidebarRef.current;
-            /* istanbul ignore else: the aside renders whenever the sidebar is open, so its ref is set before this runs */
-            if (element) {
-                // Focus first focusable element or sidebar itself
-                const focusable = element.querySelector('button, [href], input, select, textarea, [tabindex]:not([tabindex="-1"])');
-                if (focusable) {
-                    focusable.focus();
-                }
-                else {
-                    element.focus();
-                }
+        if (!isOpen)
+            return undefined;
+        const element = sidebarRef.current;
+        /* istanbul ignore if: the aside renders whenever the sidebar is open, so its ref is set before this runs */
+        if (!element)
+            return undefined;
+        // The element that had focus, wherever it sits: a portaled sidebar
+        // renders under `document.body` while its opener can be inside a
+        // shadow root.
+        const opener = getDeepestActiveElement();
+        (firstTabStop(element) ?? element).focus();
+        return () => {
+            // Only while the sidebar still holds focus: closing one under another
+            // overlay mustn't pull focus out of the one on top, and focus moved
+            // out to the page stays there. A removed subtree leaves focus on
+            // <body>, which still counts as held.
+            const active = getActiveElementInTree(element);
+            if (active === document.body || element.contains(active)) {
+                opener?.focus();
             }
-        }
+        };
     }, [isOpen, defaultTarget]);
     // Use combined ref
     const combinedRef = useCallback((node) => {
@@ -154,7 +183,7 @@ const SidebarComponent = forwardRef(({ isOpen, onClose, position = 'left', width
         ...style,
         '--bulma-sidebar-width': resolvedFullwidth ? '100%' : width,
     };
-    const sidebarContent = (jsxs(Fragment, { children: [overlay && (jsx("div", { className: backgroundClass, onClick: handleOverlayClick, "aria-hidden": "true" })), jsx("aside", { ref: combinedRef, className: combinedClasses, style: sidebarStyle, role: "dialog", "aria-modal": overlay ? 'true' : undefined, "aria-hidden": !isOpen, tabIndex: -1, ...rest, children: jsx("div", { className: contentClass, children: children }) })] }));
+    const sidebarContent = (jsxs(Fragment, { children: [overlay && (jsx("div", { className: backgroundClass, onClick: handleOverlayClick, "aria-hidden": "true" })), jsx("aside", { ref: combinedRef, className: combinedClasses, style: sidebarStyle, role: "dialog", "aria-modal": overlay ? 'true' : undefined, "aria-hidden": !isOpen, ...inertProps(!isOpen), tabIndex: -1, ...rest, children: jsx("div", { className: contentClass, children: children }) })] }));
     if (inline) {
         return sidebarContent;
     }

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

@@ -1 +1 @@
-{"version":3,"file":"Sidebar.js","sources":["../../../src/components/Sidebar.tsx"],"sourcesContent":["import React, { forwardRef, useEffect, useCallback, useRef } from 'react';\nimport { createPortal } from 'react-dom';\nimport { classNames, usePrefixedClassNames } from '../helpers/classNames';\nimport { useBulmaClasses, BulmaClassesProps } from '../helpers/useBulmaClasses';\nimport { withSubComponents } from '../helpers/withSubComponents';\nimport { useScrollLock } from '../helpers/scrollLock';\nimport { usePortalContainer } from '../helpers/portal';\nimport { useConfig } from '../helpers/Config';\nimport { buttonType } from '../helpers/buttonType';\nimport { useLatestRef } from '../helpers/useLatestRef';\nimport { useOverlayStack } from '../helpers/overlayStack';\n\n/** Position of the sidebar relative to the viewport. */\nexport type SidebarPosition = 'left' | 'right';\n\n/**\n * Props for the Sidebar component.\n * @extraProp {string} [className] - Additional CSS classes.\n * @extraProp {React.Ref<HTMLElement>} [ref] - Ref forwarded to the sidebar element.\n */\nexport interface SidebarProps\n  extends\n    Omit<React.HTMLAttributes<HTMLElement>, 'children' | 'color'>,\n    BulmaClassesProps {\n  /** Whether the sidebar is open (required). */\n  isOpen: boolean;\n  /** Callback when sidebar should close. */\n  onClose?: () => void;\n  /** Which side the sidebar appears from. Default: 'left'. */\n  position?: SidebarPosition;\n  /** Custom width of the sidebar. */\n  width?: string;\n  /** Sidebar takes full width (mobile-style). */\n  isFullwidth?: boolean;\n  /** Sidebar takes full width (mobile-style). @deprecated Use `isFullwidth` instead — `isFullwidth` wins if both are set. */\n  fullWidth?: boolean;\n  /** Show overlay behind sidebar. Default: true. */\n  overlay?: boolean;\n  /** Close sidebar when overlay is clicked. Default: true. */\n  overlayClose?: boolean;\n  /**\n   * Close sidebar on Escape key. Only the topmost open overlay responds,\n   * whichever Modal, Dialog, Sidebar or full-page Loading opened last, so\n   * Escape closes one layer at a time. The sidebar marks the Escape it closes\n   * on as used with `preventDefault()`, and a Toast waits until no overlay is\n   * open. Turned off, a sidebar on top still keeps Escape from the layers\n   * under it. A popup inside it, such as a Dropdown's menu or a date picker's\n   * calendar, takes its own Escape first, and so does content that calls\n   * `preventDefault()` on it. Default: true.\n   */\n  escapeClose?: boolean;\n  /** Allow closing the sidebar. Default: true. */\n  canCancel?: boolean;\n  /** Content to display in the sidebar. */\n  children?: React.ReactNode;\n  /** Renders inline instead of using a portal. */\n  inline?: boolean;\n}\n\n/**\n * The `Sidebar` component provides a slide-out navigation panel that appears from the left or right side of the screen.\n *\n * @function\n * @param {SidebarProps} props - Props for the Sidebar component.\n * @param {React.Ref<HTMLElement>} ref - Forwarded ref to the sidebar element.\n * @returns {JSX.Element | null} The rendered sidebar component.\n *\n * @example\n * // Basic sidebar\n * const [isOpen, setIsOpen] = useState(false);\n * <Sidebar isOpen={isOpen} onClose={() => setIsOpen(false)}>\n *   <Menu>...</Menu>\n * </Sidebar>\n *\n * @example\n * // Right-side sidebar with custom width\n * <Sidebar\n *   isOpen={isOpen}\n *   onClose={() => setIsOpen(false)}\n *   position=\"right\"\n *   width=\"320px\"\n * >\n *   <div>Panel content</div>\n * </Sidebar>\n */\nconst SidebarComponent = forwardRef<HTMLElement, SidebarProps>(\n  (\n    {\n      isOpen,\n      onClose,\n      position = 'left',\n      width = '260px',\n      isFullwidth,\n      fullWidth,\n      overlay = true,\n      overlayClose = true,\n      escapeClose = true,\n      canCancel = true,\n      children,\n      inline = false,\n      className,\n      style,\n      ...props\n    },\n    ref\n  ) => {\n    const { bulmaHelperClasses, rest } = useBulmaClasses(props);\n    const resolveContainer = usePortalContainer();\n    const { portalContainer } = useConfig();\n    // Where the configured default puts the sidebar. An `inline` one doesn't\n    // portal, so a change to the default moves nothing.\n    const defaultTarget = inline ? undefined : portalContainer;\n    const sidebarRef = useRef<HTMLElement>(null);\n    // Cleanup returned by a consumer's callback ref on attach, held until detach.\n    const consumerCleanupRef = useRef<(() => void) | null>(null);\n    const resolvedFullwidth = isFullwidth ?? fullWidth ?? false;\n\n    // Close handler\n    const handleClose = useCallback(() => {\n      if (canCancel && onClose) {\n        onClose();\n      }\n    }, [canCancel, onClose]);\n\n    // Handle overlay click\n    const handleOverlayClick = useCallback(() => {\n      if (overlayClose) {\n        handleClose();\n      }\n    }, [overlayClose, handleClose]);\n\n    // Read when Escape arrives, so the key listener stays put while\n    // `onClose` changes identity, as an inline one does on every render of\n    // the parent.\n    const handleCloseRef = useLatestRef(handleClose);\n\n    // Joins the stack of open overlays, so the sidebar answers Escape only\n    // while it's the topmost overlay, and keeps it from those under it.\n    const isTopmost = useOverlayStack(isOpen);\n    const closesOnEscape = escapeClose && canCancel && Boolean(onClose);\n\n    // Handle escape key. On `window`, as in `Modal`, so everything inside the\n    // sidebar has had the key first, and an Escape it used is left to it. One\n    // the sidebar closes on is marked used, so nothing under it acts on it.\n    useEffect(() => {\n      if (!isOpen || !closesOnEscape) return;\n\n      const handleKeyDown = (e: KeyboardEvent) => {\n        if (e.key !== 'Escape' || e.defaultPrevented || !isTopmost()) return;\n        e.preventDefault();\n        handleCloseRef.current();\n      };\n\n      window.addEventListener('keydown', handleKeyDown);\n      return () => window.removeEventListener('keydown', handleKeyDown);\n    }, [isOpen, closesOnEscape, handleCloseRef, isTopmost]);\n\n    // Prevent body scroll when sidebar is open. Ref-counted through the shared\n    // helper so an overlapping Modal/Dialog/Loading doesn't unlock underneath.\n    useScrollLock(isOpen && overlay);\n\n    // Focus trap (basic - focus sidebar when opened). A different\n    // `defaultTarget` remounts the portaled sidebar, so it focuses the new\n    // nodes then too.\n    useEffect(() => {\n      if (isOpen) {\n        const element = sidebarRef.current;\n        /* istanbul ignore else: the aside renders whenever the sidebar is open, so its ref is set before this runs */\n        if (element) {\n          // Focus first focusable element or sidebar itself\n          const focusable = element.querySelector<HTMLElement>(\n            'button, [href], input, select, textarea, [tabindex]:not([tabindex=\"-1\"])'\n          );\n          if (focusable) {\n            focusable.focus();\n          } else {\n            element.focus();\n          }\n        }\n      }\n    }, [isOpen, defaultTarget]);\n\n    // Use combined ref\n    const combinedRef = useCallback(\n      (node: HTMLElement | null) => {\n        (sidebarRef as React.MutableRefObject<HTMLElement | null>).current =\n          node;\n        if (typeof ref === 'function') {\n          // React 19 lets a callback ref return a cleanup function and detaches by\n          // running it instead of calling the ref with `null`; React 18 discards the\n          // return value entirely. Returning it from here would be a React-19-only\n          // contract, so we hold the cleanup and run it ourselves on detach — the\n          // same shape as `Dropdown`, `Modal`, `Dialog`, `Toast` and `Carousel`.\n          // The form controls that merge a forwarded ref still discard the cleanup\n          // and detach with `ref(null)`, so this is not yet library-wide — grep\n          // `typeof ref === 'function'` for the current split.\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<HTMLElement | null>).current = node;\n        }\n      },\n      [ref]\n    );\n\n    // Generate classes\n    const sidebarClasses = usePrefixedClassNames('sidebar', {\n      'is-active': isOpen,\n      [`is-${position}`]: position,\n      'is-fullwidth': resolvedFullwidth,\n    });\n    const backgroundClass = usePrefixedClassNames('sidebar-background', {\n      'is-active': isOpen,\n    });\n    const contentClass = usePrefixedClassNames('sidebar-content');\n\n    const combinedClasses = classNames(\n      sidebarClasses,\n      bulmaHelperClasses,\n      className\n    );\n\n    // Custom style for width\n    const sidebarStyle: React.CSSProperties = {\n      ...style,\n      '--bulma-sidebar-width': resolvedFullwidth ? '100%' : width,\n    } as React.CSSProperties;\n\n    const sidebarContent = (\n      <>\n        {overlay && (\n          <div\n            className={backgroundClass}\n            onClick={handleOverlayClick}\n            aria-hidden=\"true\"\n          />\n        )}\n        <aside\n          ref={combinedRef}\n          className={combinedClasses}\n          style={sidebarStyle}\n          role=\"dialog\"\n          aria-modal={overlay ? 'true' : undefined}\n          aria-hidden={!isOpen}\n          tabIndex={-1}\n          {...rest}\n        >\n          <div className={contentClass}>{children}</div>\n        </aside>\n      </>\n    );\n\n    if (inline) {\n      return sidebarContent;\n    }\n\n    // Render to portal for proper stacking\n    if (typeof document !== 'undefined') {\n      return createPortal(sidebarContent, resolveContainer());\n    }\n\n    return null;\n  }\n);\n\n// Sub-components\n\n/**\n * Props for the SidebarHeader component.\n */\ninterface SidebarHeaderProps extends React.HTMLAttributes<HTMLDivElement> {\n  /** Header content. */\n  children?: React.ReactNode;\n}\n\n/**\n * Container for the sidebar header.\n *\n * @function\n * @param {SidebarHeaderProps} props - Props for the SidebarHeader component.\n * @returns {JSX.Element} The rendered sidebar header.\n */\nconst SidebarHeader: React.FC<SidebarHeaderProps> = ({\n  className,\n  children,\n  ...props\n}) => {\n  const headerClass = usePrefixedClassNames('sidebar-header');\n  return (\n    <div className={classNames(headerClass, className)} {...props}>\n      {children}\n    </div>\n  );\n};\n\n/**\n * Props for the SidebarTitle component.\n */\ninterface SidebarTitleProps extends React.HTMLAttributes<HTMLParagraphElement> {\n  /** Title content. */\n  children?: React.ReactNode;\n}\n\n/**\n * Title text inside the header.\n *\n * @function\n * @param {SidebarTitleProps} props - Props for the SidebarTitle component.\n * @returns {JSX.Element} The rendered sidebar title.\n */\nconst SidebarTitle: React.FC<SidebarTitleProps> = ({\n  className,\n  children,\n  ...props\n}) => {\n  const titleClass = usePrefixedClassNames('sidebar-title');\n  return (\n    <p className={classNames(titleClass, className)} {...props}>\n      {children}\n    </p>\n  );\n};\n\n/**\n * Props for the SidebarClose component.\n * Extends standard button attributes.\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 */\ntype SidebarCloseProps = React.ButtonHTMLAttributes<HTMLButtonElement>;\n\n/**\n * Close button for the sidebar.\n *\n * @function\n * @param {SidebarCloseProps} props - Props for the SidebarClose component.\n * @returns {JSX.Element} The rendered close button.\n */\nconst SidebarClose: React.FC<SidebarCloseProps> = ({\n  className,\n  children,\n  ...props\n}) => {\n  const closeClass = usePrefixedClassNames('sidebar-close');\n  return (\n    <button\n      className={classNames(closeClass, className)}\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      {children}\n    </button>\n  );\n};\n\n/**\n * Props for the SidebarBody component.\n */\ninterface SidebarBodyProps extends React.HTMLAttributes<HTMLDivElement> {\n  /** Body content. */\n  children?: React.ReactNode;\n}\n\n/**\n * Main content area of the sidebar.\n *\n * @function\n * @param {SidebarBodyProps} props - Props for the SidebarBody component.\n * @returns {JSX.Element} The rendered sidebar body.\n */\nconst SidebarBody: React.FC<SidebarBodyProps> = ({\n  className,\n  children,\n  ...props\n}) => {\n  const bodyClass = usePrefixedClassNames('sidebar-body');\n  return (\n    <div className={classNames(bodyClass, className)} {...props}>\n      {children}\n    </div>\n  );\n};\n\n/**\n * Props for the SidebarFooter component.\n */\ninterface SidebarFooterProps extends React.HTMLAttributes<HTMLDivElement> {\n  /** Footer content. */\n  children?: React.ReactNode;\n}\n\n/**\n * Footer area of the sidebar.\n *\n * @function\n * @param {SidebarFooterProps} props - Props for the SidebarFooter component.\n * @returns {JSX.Element} The rendered sidebar footer.\n */\nconst SidebarFooter: React.FC<SidebarFooterProps> = ({\n  className,\n  children,\n  ...props\n}) => {\n  const footerClass = usePrefixedClassNames('sidebar-footer');\n  return (\n    <div className={classNames(footerClass, className)} {...props}>\n      {children}\n    </div>\n  );\n};\n\n// Attach static subcomponents\nexport const Sidebar = withSubComponents(\n  SidebarComponent,\n  {\n    Header: SidebarHeader,\n    Title: SidebarTitle,\n    Close: SidebarClose,\n    Body: SidebarBody,\n    Footer: SidebarFooter,\n  },\n  'Sidebar'\n);\n\nexport default Sidebar;\n"],"names":["_jsxs","_Fragment","_jsx"],"mappings":"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"}
+{"version":3,"file":"Sidebar.js","sources":["../../../src/components/Sidebar.tsx"],"sourcesContent":["import React, { forwardRef, useEffect, useCallback, useRef } from 'react';\nimport { createPortal } from 'react-dom';\nimport { classNames, usePrefixedClassNames } from '../helpers/classNames';\nimport { useBulmaClasses, BulmaClassesProps } from '../helpers/useBulmaClasses';\nimport { withSubComponents } from '../helpers/withSubComponents';\nimport { useScrollLock } from '../helpers/scrollLock';\nimport { usePortalContainer } from '../helpers/portal';\nimport { useConfig } from '../helpers/Config';\nimport { buttonType } from '../helpers/buttonType';\nimport { useLatestRef } from '../helpers/useLatestRef';\nimport { useOverlayStack } from '../helpers/overlayStack';\nimport { firstTabStop, trapTab } from '../helpers/useFocusTrap';\nimport { inertProps } from '../helpers/inertProps';\nimport {\n  getActiveElementInTree,\n  getDeepestActiveElement,\n} from '../helpers/shadowDom';\n\n/** Position of the sidebar relative to the viewport. */\nexport type SidebarPosition = 'left' | 'right';\n\n/**\n * Props for the Sidebar component.\n * @extraProp {string} [className] - Additional CSS classes.\n * @extraProp {React.Ref<HTMLElement>} [ref] - Ref forwarded to the sidebar element.\n */\nexport interface SidebarProps\n  extends\n    Omit<React.HTMLAttributes<HTMLElement>, 'children' | 'color'>,\n    BulmaClassesProps {\n  /**\n   * Whether the sidebar is open (required). Opening moves focus into the\n   * sidebar, to its first tab stop or the sidebar itself. Closing hands focus\n   * back to whatever had it when the sidebar opened, unless focus has already\n   * left the sidebar, as it does for an overlay opened over it. A closed\n   * sidebar stays in the page, so it can slide out, and is `inert` and\n   * `aria-hidden` there: Tab passes over its content and assistive\n   * technology doesn't read it.\n   */\n  isOpen: boolean;\n  /** Callback when sidebar should close. */\n  onClose?: () => void;\n  /** Which side the sidebar appears from. Default: 'left'. */\n  position?: SidebarPosition;\n  /** Custom width of the sidebar. */\n  width?: string;\n  /** Sidebar takes full width (mobile-style). */\n  isFullwidth?: boolean;\n  /** Sidebar takes full width (mobile-style). @deprecated Use `isFullwidth` instead — `isFullwidth` wins if both are set. */\n  fullWidth?: boolean;\n  /**\n   * Show an overlay behind the sidebar, which makes it modal: it gets\n   * `aria-modal=\"true\"`, locks body scroll, and keeps Tab and Shift+Tab\n   * inside it while it is the topmost overlay. A Modal or Dialog opened over\n   * it, even one rendered inside it, holds Tab until it closes. Without an\n   * overlay the sidebar isn't modal, and Tab moves in and out of it freely.\n   * Default: true.\n   */\n  overlay?: boolean;\n  /** Close sidebar when overlay is clicked. Default: true. */\n  overlayClose?: boolean;\n  /**\n   * Close sidebar on Escape key. Only the topmost open overlay responds,\n   * whichever Modal, Dialog, Sidebar or full-page Loading opened last, so\n   * Escape closes one layer at a time. The sidebar marks the Escape it closes\n   * on as used with `preventDefault()`, and a Toast waits until no overlay is\n   * open. Turned off, a sidebar on top still keeps Escape from the layers\n   * under it. A popup inside it, such as a Dropdown's menu or a date picker's\n   * calendar, takes its own Escape first, and so does content that calls\n   * `preventDefault()` on it. Default: true.\n   */\n  escapeClose?: boolean;\n  /** Allow closing the sidebar. Default: true. */\n  canCancel?: boolean;\n  /** Content to display in the sidebar. */\n  children?: React.ReactNode;\n  /** Renders inline instead of using a portal. */\n  inline?: boolean;\n}\n\n/**\n * The `Sidebar` component provides a slide-out navigation panel that appears from the left or right side of the screen.\n *\n * @function\n * @param {SidebarProps} props - Props for the Sidebar component.\n * @param {React.Ref<HTMLElement>} ref - Forwarded ref to the sidebar element.\n * @returns {JSX.Element | null} The rendered sidebar component.\n *\n * @example\n * // Basic sidebar\n * const [isOpen, setIsOpen] = useState(false);\n * <Sidebar isOpen={isOpen} onClose={() => setIsOpen(false)}>\n *   <Menu>...</Menu>\n * </Sidebar>\n *\n * @example\n * // Right-side sidebar with custom width\n * <Sidebar\n *   isOpen={isOpen}\n *   onClose={() => setIsOpen(false)}\n *   position=\"right\"\n *   width=\"320px\"\n * >\n *   <div>Panel content</div>\n * </Sidebar>\n */\nconst SidebarComponent = forwardRef<HTMLElement, SidebarProps>(\n  (\n    {\n      isOpen,\n      onClose,\n      position = 'left',\n      width = '260px',\n      isFullwidth,\n      fullWidth,\n      overlay = true,\n      overlayClose = true,\n      escapeClose = true,\n      canCancel = true,\n      children,\n      inline = false,\n      className,\n      style,\n      ...props\n    },\n    ref\n  ) => {\n    const { bulmaHelperClasses, rest } = useBulmaClasses(props);\n    const resolveContainer = usePortalContainer();\n    const { portalContainer } = useConfig();\n    // Where the configured default puts the sidebar. An `inline` one doesn't\n    // portal, so a change to the default moves nothing.\n    const defaultTarget = inline ? undefined : portalContainer;\n    const sidebarRef = useRef<HTMLElement>(null);\n    // Cleanup returned by a consumer's callback ref on attach, held until detach.\n    const consumerCleanupRef = useRef<(() => void) | null>(null);\n    const resolvedFullwidth = isFullwidth ?? fullWidth ?? false;\n\n    // Close handler\n    const handleClose = useCallback(() => {\n      if (canCancel && onClose) {\n        onClose();\n      }\n    }, [canCancel, onClose]);\n\n    // Handle overlay click\n    const handleOverlayClick = useCallback(() => {\n      if (overlayClose) {\n        handleClose();\n      }\n    }, [overlayClose, handleClose]);\n\n    // Read when Escape arrives, so the key listener stays put while\n    // `onClose` changes identity, as an inline one does on every render of\n    // the parent.\n    const handleCloseRef = useLatestRef(handleClose);\n\n    // Joins the stack of open overlays, so the sidebar answers Escape only\n    // while it's the topmost overlay, and keeps it from those under it.\n    const isTopmost = useOverlayStack(isOpen);\n    const closesOnEscape = escapeClose && canCancel && Boolean(onClose);\n\n    // Handle escape key. On `window`, as in `Modal`, so everything inside the\n    // sidebar has had the key first, and an Escape it used is left to it. One\n    // the sidebar closes on is marked used, so nothing under it acts on it.\n    useEffect(() => {\n      if (!isOpen || !closesOnEscape) return;\n\n      const handleKeyDown = (e: KeyboardEvent) => {\n        if (e.key !== 'Escape' || e.defaultPrevented || !isTopmost()) return;\n        e.preventDefault();\n        handleCloseRef.current();\n      };\n\n      window.addEventListener('keydown', handleKeyDown);\n      return () => window.removeEventListener('keydown', handleKeyDown);\n    }, [isOpen, closesOnEscape, handleCloseRef, isTopmost]);\n\n    // Keep Tab inside while there's an overlay, as `Modal` does:\n    // `aria-modal` hides the rest of the page from assistive technology, so\n    // the keyboard order has to agree. Only while it's the topmost overlay,\n    // so a Modal or Dialog opened over the sidebar, even one rendered inside\n    // it, holds Tab instead until it closes. On `window` for the same reason\n    // as Escape: a trap inside, such as a portaled popup's, has had the Tab\n    // first, and one it used is left where it put focus. It's the trap\n    // `useFocusTrap` sets, so a Tab the browser still takes out, as Safari\n    // does past links, is sent back in.\n    useEffect(() => {\n      const node = sidebarRef.current;\n      if (!isOpen || !overlay || !node) return undefined;\n      return trapTab(node, window, isTopmost);\n      // A different `defaultTarget`, or switching `inline`, remounts the\n      // aside, so the trap moves to the new node.\n    }, [isOpen, overlay, isTopmost, defaultTarget, inline]);\n\n    // Prevent body scroll when sidebar is open. Ref-counted through the shared\n    // helper so an overlapping Modal/Dialog/Loading doesn't unlock underneath.\n    useScrollLock(isOpen && overlay);\n\n    // Move focus into the sidebar on open, to the first stop Tab wraps to or\n    // the sidebar itself, and hand it back on close, as `Modal` does. A\n    // different `defaultTarget` remounts the portaled sidebar: the cleanup\n    // hands focus back from the old nodes, which left it on <body>, and the\n    // re-run records the same opener and focuses the new nodes.\n    useEffect(() => {\n      if (!isOpen) return undefined;\n      const element = sidebarRef.current;\n      /* istanbul ignore if: the aside renders whenever the sidebar is open, so its ref is set before this runs */\n      if (!element) return undefined;\n\n      // The element that had focus, wherever it sits: a portaled sidebar\n      // renders under `document.body` while its opener can be inside a\n      // shadow root.\n      const opener = getDeepestActiveElement() as HTMLElement | null;\n      (firstTabStop(element) ?? element).focus();\n\n      return () => {\n        // Only while the sidebar still holds focus: closing one under another\n        // overlay mustn't pull focus out of the one on top, and focus moved\n        // out to the page stays there. A removed subtree leaves focus on\n        // <body>, which still counts as held.\n        const active = getActiveElementInTree(element);\n        if (active === document.body || element.contains(active)) {\n          opener?.focus();\n        }\n      };\n    }, [isOpen, defaultTarget]);\n\n    // Use combined ref\n    const combinedRef = useCallback(\n      (node: HTMLElement | null) => {\n        (sidebarRef as React.MutableRefObject<HTMLElement | null>).current =\n          node;\n        if (typeof ref === 'function') {\n          // React 19 lets a callback ref return a cleanup function and detaches by\n          // running it instead of calling the ref with `null`; React 18 discards the\n          // return value entirely. Returning it from here would be a React-19-only\n          // contract, so we hold the cleanup and run it ourselves on detach — the\n          // same shape as `Dropdown`, `Modal`, `Dialog`, `Toast` and `Carousel`.\n          // The form controls that merge a forwarded ref still discard the cleanup\n          // and detach with `ref(null)`, so this is not yet library-wide — grep\n          // `typeof ref === 'function'` for the current split.\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<HTMLElement | null>).current = node;\n        }\n      },\n      [ref]\n    );\n\n    // Generate classes\n    const sidebarClasses = usePrefixedClassNames('sidebar', {\n      'is-active': isOpen,\n      [`is-${position}`]: position,\n      'is-fullwidth': resolvedFullwidth,\n    });\n    const backgroundClass = usePrefixedClassNames('sidebar-background', {\n      'is-active': isOpen,\n    });\n    const contentClass = usePrefixedClassNames('sidebar-content');\n\n    const combinedClasses = classNames(\n      sidebarClasses,\n      bulmaHelperClasses,\n      className\n    );\n\n    // Custom style for width\n    const sidebarStyle: React.CSSProperties = {\n      ...style,\n      '--bulma-sidebar-width': resolvedFullwidth ? '100%' : width,\n    } as React.CSSProperties;\n\n    const sidebarContent = (\n      <>\n        {overlay && (\n          <div\n            className={backgroundClass}\n            onClick={handleOverlayClick}\n            aria-hidden=\"true\"\n          />\n        )}\n        <aside\n          ref={combinedRef}\n          className={combinedClasses}\n          style={sidebarStyle}\n          role=\"dialog\"\n          aria-modal={overlay ? 'true' : undefined}\n          aria-hidden={!isOpen}\n          // React commits this before the effect that moves focus in runs, so\n          // an opening sidebar is no longer inert by then.\n          {...inertProps(!isOpen)}\n          tabIndex={-1}\n          {...rest}\n        >\n          <div className={contentClass}>{children}</div>\n        </aside>\n      </>\n    );\n\n    if (inline) {\n      return sidebarContent;\n    }\n\n    // Render to portal for proper stacking\n    if (typeof document !== 'undefined') {\n      return createPortal(sidebarContent, resolveContainer());\n    }\n\n    return null;\n  }\n);\n\n// Sub-components\n\n/**\n * Props for the SidebarHeader component.\n */\ninterface SidebarHeaderProps extends React.HTMLAttributes<HTMLDivElement> {\n  /** Header content. */\n  children?: React.ReactNode;\n}\n\n/**\n * Container for the sidebar header.\n *\n * @function\n * @param {SidebarHeaderProps} props - Props for the SidebarHeader component.\n * @returns {JSX.Element} The rendered sidebar header.\n */\nconst SidebarHeader: React.FC<SidebarHeaderProps> = ({\n  className,\n  children,\n  ...props\n}) => {\n  const headerClass = usePrefixedClassNames('sidebar-header');\n  return (\n    <div className={classNames(headerClass, className)} {...props}>\n      {children}\n    </div>\n  );\n};\n\n/**\n * Props for the SidebarTitle component.\n */\ninterface SidebarTitleProps extends React.HTMLAttributes<HTMLParagraphElement> {\n  /** Title content. */\n  children?: React.ReactNode;\n}\n\n/**\n * Title text inside the header.\n *\n * @function\n * @param {SidebarTitleProps} props - Props for the SidebarTitle component.\n * @returns {JSX.Element} The rendered sidebar title.\n */\nconst SidebarTitle: React.FC<SidebarTitleProps> = ({\n  className,\n  children,\n  ...props\n}) => {\n  const titleClass = usePrefixedClassNames('sidebar-title');\n  return (\n    <p className={classNames(titleClass, className)} {...props}>\n      {children}\n    </p>\n  );\n};\n\n/**\n * Props for the SidebarClose component.\n * Extends standard button attributes.\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 */\ntype SidebarCloseProps = React.ButtonHTMLAttributes<HTMLButtonElement>;\n\n/**\n * Close button for the sidebar.\n *\n * @function\n * @param {SidebarCloseProps} props - Props for the SidebarClose component.\n * @returns {JSX.Element} The rendered close button.\n */\nconst SidebarClose: React.FC<SidebarCloseProps> = ({\n  className,\n  children,\n  ...props\n}) => {\n  const closeClass = usePrefixedClassNames('sidebar-close');\n  return (\n    <button\n      className={classNames(closeClass, className)}\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      {children}\n    </button>\n  );\n};\n\n/**\n * Props for the SidebarBody component.\n */\ninterface SidebarBodyProps extends React.HTMLAttributes<HTMLDivElement> {\n  /** Body content. */\n  children?: React.ReactNode;\n}\n\n/**\n * Main content area of the sidebar.\n *\n * @function\n * @param {SidebarBodyProps} props - Props for the SidebarBody component.\n * @returns {JSX.Element} The rendered sidebar body.\n */\nconst SidebarBody: React.FC<SidebarBodyProps> = ({\n  className,\n  children,\n  ...props\n}) => {\n  const bodyClass = usePrefixedClassNames('sidebar-body');\n  return (\n    <div className={classNames(bodyClass, className)} {...props}>\n      {children}\n    </div>\n  );\n};\n\n/**\n * Props for the SidebarFooter component.\n */\ninterface SidebarFooterProps extends React.HTMLAttributes<HTMLDivElement> {\n  /** Footer content. */\n  children?: React.ReactNode;\n}\n\n/**\n * Footer area of the sidebar.\n *\n * @function\n * @param {SidebarFooterProps} props - Props for the SidebarFooter component.\n * @returns {JSX.Element} The rendered sidebar footer.\n */\nconst SidebarFooter: React.FC<SidebarFooterProps> = ({\n  className,\n  children,\n  ...props\n}) => {\n  const footerClass = usePrefixedClassNames('sidebar-footer');\n  return (\n    <div className={classNames(footerClass, className)} {...props}>\n      {children}\n    </div>\n  );\n};\n\n// Attach static subcomponents\nexport const Sidebar = withSubComponents(\n  SidebarComponent,\n  {\n    Header: SidebarHeader,\n    Title: SidebarTitle,\n    Close: SidebarClose,\n    Body: SidebarBody,\n    Footer: SidebarFooter,\n  },\n  'Sidebar'\n);\n\nexport default Sidebar;\n"],"names":["_jsxs","_Fragment","_jsx"],"mappings":";;;;;;;;;;;;;;;;;AAgFA;;;;;;;;;;;;;;;;;;;;;;;;;AAyBG;AACH,MAAM,gBAAgB,GAAG,UAAU,CACjC,CACE,EACE,MAAM,EACN,OAAO,EACP,QAAQ,GAAG,MAAM,EACjB,KAAK,GAAG,OAAO,EACf,WAAW,EACX,SAAS,EACT,OAAO,GAAG,IAAI,EACd,YAAY,GAAG,IAAI,EACnB,WAAW,GAAG,IAAI,EAClB,SAAS,GAAG,IAAI,EAChB,QAAQ,EACR,MAAM,GAAG,KAAK,EACd,SAAS,EACT,KAAK,EACL,GAAG,KAAK,EACT,EACD,GAAG,KACD;IACF,MAAM,EAAE,kBAAkB,EAAE,IAAI,EAAE,GAAG,eAAe,CAAC,KAAK,CAAC;AAC3D,IAAA,MAAM,gBAAgB,GAAG,kBAAkB,EAAE;AAC7C,IAAA,MAAM,EAAE,eAAe,EAAE,GAAG,SAAS,EAAE;;;IAGvC,MAAM,aAAa,GAAG,MAAM,GAAG,SAAS,GAAG,eAAe;AAC1D,IAAA,MAAM,UAAU,GAAG,MAAM,CAAc,IAAI,CAAC;;AAE5C,IAAA,MAAM,kBAAkB,GAAG,MAAM,CAAsB,IAAI,CAAC;AAC5D,IAAA,MAAM,iBAAiB,GAAG,WAAW,IAAI,SAAS,IAAI,KAAK;;AAG3D,IAAA,MAAM,WAAW,GAAG,WAAW,CAAC,MAAK;AACnC,QAAA,IAAI,SAAS,IAAI,OAAO,EAAE;AACxB,YAAA,OAAO,EAAE;QACX;AACF,IAAA,CAAC,EAAE,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;;AAGxB,IAAA,MAAM,kBAAkB,GAAG,WAAW,CAAC,MAAK;QAC1C,IAAI,YAAY,EAAE;AAChB,YAAA,WAAW,EAAE;QACf;AACF,IAAA,CAAC,EAAE,CAAC,YAAY,EAAE,WAAW,CAAC,CAAC;;;;AAK/B,IAAA,MAAM,cAAc,GAAG,YAAY,CAAC,WAAW,CAAC;;;AAIhD,IAAA,MAAM,SAAS,GAAG,eAAe,CAAC,MAAM,CAAC;IACzC,MAAM,cAAc,GAAG,WAAW,IAAI,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC;;;;IAKnE,SAAS,CAAC,MAAK;AACb,QAAA,IAAI,CAAC,MAAM,IAAI,CAAC,cAAc;YAAE;AAEhC,QAAA,MAAM,aAAa,GAAG,CAAC,CAAgB,KAAI;AACzC,YAAA,IAAI,CAAC,CAAC,GAAG,KAAK,QAAQ,IAAI,CAAC,CAAC,gBAAgB,IAAI,CAAC,SAAS,EAAE;gBAAE;YAC9D,CAAC,CAAC,cAAc,EAAE;YAClB,cAAc,CAAC,OAAO,EAAE;AAC1B,QAAA,CAAC;AAED,QAAA,MAAM,CAAC,gBAAgB,CAAC,SAAS,EAAE,aAAa,CAAC;QACjD,OAAO,MAAM,MAAM,CAAC,mBAAmB,CAAC,SAAS,EAAE,aAAa,CAAC;IACnE,CAAC,EAAE,CAAC,MAAM,EAAE,cAAc,EAAE,cAAc,EAAE,SAAS,CAAC,CAAC;;;;;;;;;;IAWvD,SAAS,CAAC,MAAK;AACb,QAAA,MAAM,IAAI,GAAG,UAAU,CAAC,OAAO;AAC/B,QAAA,IAAI,CAAC,MAAM,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI;AAAE,YAAA,OAAO,SAAS;QAClD,OAAO,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,CAAC;;;AAGzC,IAAA,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,CAAC,CAAC;;;AAIvD,IAAA,aAAa,CAAC,MAAM,IAAI,OAAO,CAAC;;;;;;IAOhC,SAAS,CAAC,MAAK;AACb,QAAA,IAAI,CAAC,MAAM;AAAE,YAAA,OAAO,SAAS;AAC7B,QAAA,MAAM,OAAO,GAAG,UAAU,CAAC,OAAO;;AAElC,QAAA,IAAI,CAAC,OAAO;AAAE,YAAA,OAAO,SAAS;;;;AAK9B,QAAA,MAAM,MAAM,GAAG,uBAAuB,EAAwB;QAC9D,CAAC,YAAY,CAAC,OAAO,CAAC,IAAI,OAAO,EAAE,KAAK,EAAE;AAE1C,QAAA,OAAO,MAAK;;;;;AAKV,YAAA,MAAM,MAAM,GAAG,sBAAsB,CAAC,OAAO,CAAC;AAC9C,YAAA,IAAI,MAAM,KAAK,QAAQ,CAAC,IAAI,IAAI,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE;gBACxD,MAAM,EAAE,KAAK,EAAE;YACjB;AACF,QAAA,CAAC;AACH,IAAA,CAAC,EAAE,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;;AAG3B,IAAA,MAAM,WAAW,GAAG,WAAW,CAC7B,CAAC,IAAwB,KAAI;AAC1B,QAAA,UAAyD,CAAC,OAAO;AAChE,YAAA,IAAI;AACN,QAAA,IAAI,OAAO,GAAG,KAAK,UAAU,EAAE;;;;;;;;;AAS7B,YAAA,IAAI,IAAI,KAAK,IAAI,EAAE;AACjB,gBAAA,MAAM,eAAe,GAAG,kBAAkB,CAAC,OAAO;AAClD,gBAAA,kBAAkB,CAAC,OAAO,GAAG,IAAI;gBACjC,IAAI,eAAe,EAAE;AACnB,oBAAA,eAAe,EAAE;gBACnB;qBAAO;oBACL,GAAG,CAAC,IAAI,CAAC;gBACX;gBACA;YACF;AACA,YAAA,MAAM,OAAO,GAAY,GAAG,CAAC,IAAI,CAAC;AAClC,YAAA,kBAAkB,CAAC,OAAO;gBACxB,OAAO,OAAO,KAAK,UAAU,GAAI,OAAsB,GAAG,IAAI;QAClE;aAAO,IAAI,GAAG,EAAE;AACb,YAAA,GAAkD,CAAC,OAAO,GAAG,IAAI;QACpE;AACF,IAAA,CAAC,EACD,CAAC,GAAG,CAAC,CACN;;AAGD,IAAA,MAAM,cAAc,GAAG,qBAAqB,CAAC,SAAS,EAAE;AACtD,QAAA,WAAW,EAAE,MAAM;AACnB,QAAA,CAAC,CAAA,GAAA,EAAM,QAAQ,CAAA,CAAE,GAAG,QAAQ;AAC5B,QAAA,cAAc,EAAE,iBAAiB;AAClC,KAAA,CAAC;AACF,IAAA,MAAM,eAAe,GAAG,qBAAqB,CAAC,oBAAoB,EAAE;AAClE,QAAA,WAAW,EAAE,MAAM;AACpB,KAAA,CAAC;AACF,IAAA,MAAM,YAAY,GAAG,qBAAqB,CAAC,iBAAiB,CAAC;IAE7D,MAAM,eAAe,GAAG,UAAU,CAChC,cAAc,EACd,kBAAkB,EAClB,SAAS,CACV;;AAGD,IAAA,MAAM,YAAY,GAAwB;AACxC,QAAA,GAAG,KAAK;QACR,uBAAuB,EAAE,iBAAiB,GAAG,MAAM,GAAG,KAAK;KACrC;AAExB,IAAA,MAAM,cAAc,IAClBA,IAAA,CAAAC,QAAA,EAAA,EAAA,QAAA,EAAA,CACG,OAAO,KACNC,GAAA,CAAA,KAAA,EAAA,EACE,SAAS,EAAE,eAAe,EAC1B,OAAO,EAAE,kBAAkB,EAAA,aAAA,EACf,MAAM,EAAA,CAClB,CACH,EACDA,GAAA,CAAA,OAAA,EAAA,EACE,GAAG,EAAE,WAAW,EAChB,SAAS,EAAE,eAAe,EAC1B,KAAK,EAAE,YAAY,EACnB,IAAI,EAAC,QAAQ,EAAA,YAAA,EACD,OAAO,GAAG,MAAM,GAAG,SAAS,EAAA,aAAA,EAC3B,CAAC,MAAM,EAAA,GAGhB,UAAU,CAAC,CAAC,MAAM,CAAC,EACvB,QAAQ,EAAE,EAAE,EAAA,GACR,IAAI,YAERA,GAAA,CAAA,KAAA,EAAA,EAAK,SAAS,EAAE,YAAY,YAAG,QAAQ,EAAA,CAAO,EAAA,CACxC,CAAA,EAAA,CACP,CACJ;IAED,IAAI,MAAM,EAAE;AACV,QAAA,OAAO,cAAc;IACvB;;AAGA,IAAA,IAAI,OAAO,QAAQ,KAAK,WAAW,EAAE;AACnC,QAAA,OAAO,YAAY,CAAC,cAAc,EAAE,gBAAgB,EAAE,CAAC;IACzD;AAEA,IAAA,OAAO,IAAI;AACb,CAAC,CACF;AAYD;;;;;;AAMG;AACH,MAAM,aAAa,GAAiC,CAAC,EACnD,SAAS,EACT,QAAQ,EACR,GAAG,KAAK,EACT,KAAI;AACH,IAAA,MAAM,WAAW,GAAG,qBAAqB,CAAC,gBAAgB,CAAC;AAC3D,IAAA,QACEA,GAAA,CAAA,KAAA,EAAA,EAAK,SAAS,EAAE,UAAU,CAAC,WAAW,EAAE,SAAS,CAAC,KAAM,KAAK,EAAA,QAAA,EAC1D,QAAQ,EAAA,CACL;AAEV,CAAC;AAUD;;;;;;AAMG;AACH,MAAM,YAAY,GAAgC,CAAC,EACjD,SAAS,EACT,QAAQ,EACR,GAAG,KAAK,EACT,KAAI;AACH,IAAA,MAAM,UAAU,GAAG,qBAAqB,CAAC,eAAe,CAAC;AACzD,IAAA,QACEA,GAAA,CAAA,GAAA,EAAA,EAAG,SAAS,EAAE,UAAU,CAAC,UAAU,EAAE,SAAS,CAAC,KAAM,KAAK,EAAA,QAAA,EACvD,QAAQ,EAAA,CACP;AAER,CAAC;AAUD;;;;;;AAMG;AACH,MAAM,YAAY,GAAgC,CAAC,EACjD,SAAS,EACT,QAAQ,EACR,GAAG,KAAK,EACT,KAAI;AACH,IAAA,MAAM,UAAU,GAAG,qBAAqB,CAAC,eAAe,CAAC;AACzD,IAAA,QACEA,GAAA,CAAA,QAAA,EAAA,EACE,SAAS,EAAE,UAAU,CAAC,UAAU,EAAE,SAAS,CAAC,EAAA,GACxC,KAAK,EAAA,YAAA,EAMG,KAAK,CAAC,YAAY,CAAC,IAAI,OAAO,EAC1C,IAAI,EAAE,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,EAAA,QAAA,EAE3B,QAAQ,EAAA,CACF;AAEb,CAAC;AAUD;;;;;;AAMG;AACH,MAAM,WAAW,GAA+B,CAAC,EAC/C,SAAS,EACT,QAAQ,EACR,GAAG,KAAK,EACT,KAAI;AACH,IAAA,MAAM,SAAS,GAAG,qBAAqB,CAAC,cAAc,CAAC;AACvD,IAAA,QACEA,GAAA,CAAA,KAAA,EAAA,EAAK,SAAS,EAAE,UAAU,CAAC,SAAS,EAAE,SAAS,CAAC,KAAM,KAAK,EAAA,QAAA,EACxD,QAAQ,EAAA,CACL;AAEV,CAAC;AAUD;;;;;;AAMG;AACH,MAAM,aAAa,GAAiC,CAAC,EACnD,SAAS,EACT,QAAQ,EACR,GAAG,KAAK,EACT,KAAI;AACH,IAAA,MAAM,WAAW,GAAG,qBAAqB,CAAC,gBAAgB,CAAC;AAC3D,IAAA,QACEA,GAAA,CAAA,KAAA,EAAA,EAAK,SAAS,EAAE,UAAU,CAAC,WAAW,EAAE,SAAS,CAAC,KAAM,KAAK,EAAA,QAAA,EAC1D,QAAQ,EAAA,CACL;AAEV,CAAC;AAED;AACO,MAAM,OAAO,GAAG,iBAAiB,CACtC,gBAAgB,EAChB;AACE,IAAA,MAAM,EAAE,aAAa;AACrB,IAAA,KAAK,EAAE,YAAY;AACnB,IAAA,KAAK,EAAE,YAAY;AACnB,IAAA,IAAI,EAAE,WAAW;AACjB,IAAA,MAAM,EAAE,aAAa;CACtB,EACD,SAAS;;"}

package/dist/esm/form/Autocomplete.js

@@ -9,11 +9,12 @@ import { Field } from './Field.js';
 import { useAutoLabelId } from './useAutoLabelId.js';
 import { useControlLoading } from './controlLoading.js';
 import { spokenText, StatusRegion } from '../helpers/statusRegion.js';
+import { useLatestRef } from '../helpers/useLatestRef.js';
 
 // What the status region announces: the `empty` content, as the one item
 // it's handed while that content is on screen because of the user's typing.
-const typedNoMatches = [{ id: 'empty' }];
-const nothingToAnnounce = [];
+const typedNoMatches$1 = [{ id: 'empty' }];
+const nothingToAnnounce$1 = [];
 // A press on an option would take focus from the field, since an option
 // can't hold it, and nothing would put it back. Cancelling the press keeps
 // it there, as the ARIA Authoring Practices' combobox does, and the click
@@ -22,7 +23,7 @@ const keepFocus = (e) => e.preventDefault();
 // An IME that's composing owns every key: Enter confirms what it composed,
 // and the arrows move through its candidates. Safari can say so with
 // `keyCode` 229 rather than `isComposing`.
-const isComposing$1 = (e) => e.nativeEvent.isComposing || e.nativeEvent.keyCode === 229;
+const isComposing$2 = (e) => e.nativeEvent.isComposing || e.nativeEvent.keyCode === 229;
 // Whether an option can be picked. The arrows still reach a disabled one, so
 // a screen reader user finds it.
 const isEnabled = (item) => typeof item === 'string' || !item.disabled;
@@ -147,6 +148,19 @@ label, labelSize, labelProps, horizontal, message, messageColor, fieldClassName,
             setIsActive(true);
         }
     }, [openOnFocus, disabled]);
+    // Read when a click lands outside, so the listener stays put while the
+    // list is open. What it selects changes as the user types and arrows
+    // through suggestions, the filtered list is new on every render, and an
+    // inline `onInput` or `onSelect` changes on every render of the parent.
+    // Typing leaves the highlight where it was, so a list that narrowed can
+    // leave it past the last suggestion, with nothing there to select.
+    const selectHighlightedRef = useLatestRef(() => {
+        if (selectOnClickOutside &&
+            highlightedIndex >= 0 &&
+            highlightedIndex < filteredData.length) {
+            handleSelect(filteredData[highlightedIndex]);
+        }
+    });
     // Handle blur (click outside)
     useEffect(() => {
         if (!isActive)
@@ -158,25 +172,21 @@ label, labelSize, labelProps, horizontal, message, messageColor, fieldClassName,
             const path = e.composedPath();
             const isInside = path.includes(containerRef.current);
             if (!isInside) {
-                if (selectOnClickOutside && highlightedIndex >= 0) {
-                    handleSelect(filteredData[highlightedIndex]);
-                }
+                selectHighlightedRef.current();
                 setIsActive(false);
             }
         };
         document.addEventListener('mousedown', handleClickOutside);
         return () => document.removeEventListener('mousedown', handleClickOutside);
-    }, [
-        isActive,
-        selectOnClickOutside,
-        highlightedIndex,
-        filteredData,
-        handleSelect,
-    ]);
+    }, [isActive, selectHighlightedRef]);
+    // Read when the dropdown opens or closes, so an inline `onActiveChange`,
+    // new on every render of the parent, isn't told again about a state that
+    // didn't change.
+    const onActiveChangeRef = useLatestRef(onActiveChange);
     // Notify active state change
     useEffect(() => {
-        onActiveChange?.(isActive);
-    }, [isActive, onActiveChange]);
+        onActiveChangeRef.current?.(isActive);
+    }, [isActive, onActiveChangeRef]);
     // Keep first highlighted
     useEffect(() => {
         if (keepFirst && isActive && filteredData.length > 0) {
@@ -185,7 +195,7 @@ label, labelSize, labelProps, horizontal, message, messageColor, fieldClassName,
     }, [keepFirst, isActive, filteredData.length, inputValue]);
     // Handle keyboard navigation
     const handleKeyDown = useCallback((e) => {
-        if (disabled || isComposing$1(e))
+        if (disabled || isComposing$2(e))
             return;
         switch (e.key) {
             case 'ArrowDown':
@@ -341,8 +351,8 @@ label, labelSize, labelProps, horizontal, message, messageColor, fieldClassName,
         !!inputValue &&
         !loading &&
         !controlLoading
-        ? typedNoMatches
-        : nothingToAnnounce;
+        ? typedNoMatches$1
+        : nothingToAnnounce$1;
     // The region reads the text on screen, whatever `empty` renders.
     const emptyRef = useRef(null);
     const describeEmpty = useCallback(() => {