@neo4j-ndl/react 4.24.0 → 4.24.1

package/lib/cjs/popover/Popover.js

@@ -67,7 +67,7 @@ const usePopoverContext = () => {
     return context;
 };
 exports.usePopoverContext = usePopoverContext;
-const PopoverComponent = ({ children, anchorElement, placement, isOpen, offset, anchorPosition, hasAnchorPortal: hasAnchorPortalProp, shouldCaptureFocus = false, initialFocus, onOpenChange, role, closeOnClickOutside = true, isPortaled: isPortaledProp, strategy: strategyProp, shouldConstrainSize, }) => {
+const PopoverComponent = ({ children, anchorElement, placement, isOpen, offset, anchorPosition, hasAnchorPortal: hasAnchorPortalProp, shouldCaptureFocus = false, initialFocus, onOpenChange, role, closeOnClickOutside = true, shouldCloseOnFocusOut, isPortaled: isPortaledProp, strategy: strategyProp, shouldConstrainSize, }) => {
     const isInsideDialog = (0, dialog_context_1.useIsInsideDialog)();
     const strategy = isInsideDialog ? 'fixed' : 'absolute';
     const hasAnchorPortal = isInsideDialog;
@@ -85,6 +85,7 @@ const PopoverComponent = ({ children, anchorElement, placement, isOpen, offset,
         placement: placement ? exports.placementTranslation[placement] : undefined,
         role,
         shouldCaptureFocus,
+        shouldCloseOnFocusOut: shouldCloseOnFocusOut !== null && shouldCloseOnFocusOut !== void 0 ? shouldCloseOnFocusOut : closeOnClickOutside,
         shouldConstrainSize,
         strategy: strategyProp !== null && strategyProp !== void 0 ? strategyProp : strategy,
     });
@@ -144,7 +145,7 @@ const PopoverContent = (_a) => {
             return ((0, jsx_runtime_1.jsx)(react_1.FloatingPortal, { root: ((_a = context.anchorElementAsPortalAnchor) !== null && _a !== void 0 ? _a : false)
                     ? context.refs.reference.current
                     : undefined, children: wrapChildren }));
-        }, children: (0, jsx_runtime_1.jsx)(react_1.FloatingFocusManager, { context: floatingContext, modal: context.shouldCaptureFocus, initialFocus: context.initialFocus, children: (0, jsx_runtime_1.jsx)(Component, Object.assign({ className: classes, "aria-labelledby": context.labelId, "aria-describedby": context.descriptionId, style: Object.assign(Object.assign(Object.assign({}, context.floatingStyles), context.transitionStyles), style), ref: refs }, context.getFloatingProps(Object.assign({}, htmlAttributes)), restProps, { children: children })) }) }));
+        }, children: (0, jsx_runtime_1.jsx)(react_1.FloatingFocusManager, { context: floatingContext, modal: context.shouldCaptureFocus, initialFocus: context.initialFocus, closeOnFocusOut: context.shouldCloseOnFocusOut, children: (0, jsx_runtime_1.jsx)(Component, Object.assign({ className: classes, "aria-labelledby": context.labelId, "aria-describedby": context.descriptionId, style: Object.assign(Object.assign(Object.assign({}, context.floatingStyles), context.transitionStyles), style), ref: refs }, context.getFloatingProps(Object.assign({}, htmlAttributes)), restProps, { children: children })) }) }));
 };
 const Popover = Object.assign(PopoverComponent, {
     Anchor: PopoverAnchor,

package/lib/cjs/popover/Popover.js.map

@@ -1 +1 @@
-{"version":3,"file":"Popover.js","sourceRoot":"","sources":["../../../src/popover/Popover.tsx"],"names":[],"mappings":"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","sourcesContent":["/*!\n *\n *  Copyright (c) \"Neo4j\"\n *  Neo4j Sweden AB [http://neo4j.com]\n *\n *  This file is part of Neo4j.\n *\n *  Neo4j is free software: you can redistribute it and/or modify\n *  it under the terms of the GNU General Public License as published by\n *  the Free Software Foundation, either version 3 of the License, or\n *  (at your option) any later version.\n *\n *  This program is distributed in the hope that it will be useful,\n *  but WITHOUT ANY WARRANTY; without even the implied warranty of\n *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the\n *  GNU General Public License for more details.\n *\n *  You should have received a copy of the GNU General Public License\n *  along with this program.  If not, see <http://www.gnu.org/licenses/>.\n */\nimport {\n  FloatingFocusManager,\n  FloatingPortal,\n  type OffsetOptions,\n  type Placement,\n  useMergeRefs,\n} from '@floating-ui/react';\nimport classNames from 'classnames';\nimport React from 'react';\n\nimport {\n  type CommonProps,\n  type PolymorphicCommonProps,\n} from '../_common/types';\nimport { ConditionalWrap } from '../conditional-wrap';\nimport { useIsInsideDialog } from '../dialog/dialog-context';\nimport { useNeedleTheme } from '../theme/ThemeProvider';\nimport { usePopover } from './use-popover';\nimport { usePatchFloatingFocusGuards } from './usePatchFloatingFocusGuards';\n\ntype PlacementOptions =\n  | 'bottom-end-top-end'\n  | 'bottom-start-top-start'\n  | 'bottom-middle-top-middle'\n  | 'top-end-bottom-end'\n  | 'top-start-bottom-start'\n  | 'top-middle-bottom-middle'\n  | 'bottom-start-bottom-end'\n  | 'top-start-top-end'\n  | 'middle-start-middle-end'\n  | 'bottom-end-bottom-start'\n  | 'top-end-top-start'\n  | 'middle-end-middle-start';\n\nexport const placementTranslation: Record<PlacementOptions, Placement> = {\n  'bottom-end-bottom-start': 'right-end',\n  'bottom-end-top-end': 'bottom-end',\n  'bottom-middle-top-middle': 'bottom',\n  'bottom-start-bottom-end': 'left-end',\n  'bottom-start-top-start': 'bottom-start',\n  'middle-end-middle-start': 'right',\n  'middle-start-middle-end': 'left',\n  'top-end-bottom-end': 'top-end',\n  'top-end-top-start': 'right-start',\n  'top-middle-bottom-middle': 'top',\n  'top-start-bottom-start': 'top-start',\n  'top-start-top-end': 'left-start',\n};\ntype PopoverProps = {\n  /** if the popover is open */\n  isOpen?: boolean;\n  /** The content of the popover */\n  children?: React.ReactNode;\n  /**\n   * Can be used if the anchor should be separated from the trigger.\n   * Note: to visually separate the anchor from the trigger, use the Popover.Anchor component instead.\n   */\n  anchorElement?: Element | null;\n  /** If the anchorPosition is provided the anchorElement will be ignored */\n  anchorPosition?: {\n    // TODO v5: create componentProps type for this\n    // oxlint-disable-next-line id-length\n    x: number;\n    // TODO v5: create componentProps type for this\n    // oxlint-disable-next-line id-length\n    y: number;\n  };\n  /** The placement of the floating element is determined by two sets of words. The first set of words specifies the point on the anchor element where the floating element will be attached. The second set of coordinates specifies the point on the floating element that will attach to the anchor element. */\n  placement?: PlacementOptions;\n  /** can take either a number, an object or a function. Full documentation here:  https://floating-ui.com/docs/offset   */\n  offset?: OffsetOptions;\n  /** Called when an internal state change is triggered, when the floating element either opens or closes. It is not called when `isOpen` is updated by the consumer. */\n  onOpenChange?: (isOpen: boolean, event?: Event) => void;\n  /** Use anchorEl for portal's container. Should be used if the popover is portaled and is inside a Dialog for example. */\n  hasAnchorPortal?: boolean;\n  /** If the popover should constrain the focus inside the popover while open */\n  shouldCaptureFocus?: boolean;\n  /** Which element to initially focus. */\n  initialFocus?: number | React.RefObject<HTMLElement | null>;\n  // TODO v5: remove this prop\n  /** The role of the popover.\n   * @deprecated - This prop will be removed in v5.\n   */\n  role?:\n    | 'tooltip'\n    | 'dialog'\n    | 'alertdialog'\n    | 'menu'\n    | 'listbox'\n    | 'grid'\n    | 'tree';\n  /** If the popover should close when the user clicks outside of it */\n  // TODO v5: change naming (if component isn't deprecated)\n  // eslint-disable-next-line @typescript-eslint/naming-convention\n  closeOnClickOutside?: boolean;\n  /** The strategy of the popover. Fixed should be used when the popover is inside a Dialog. */\n  strategy?: 'fixed' | 'absolute';\n  /** Whether the content is rendered in a portal */\n  isPortaled?: boolean;\n  /**\n   * When true, limits the popover's max-height and max-width to the available viewport space.\n   * The consumer is responsible for adding overflow handling (e.g. overflow-y: auto) to the content.\n   * */\n  shouldConstrainSize?: boolean;\n};\n\ntype ContextType = ReturnType<typeof usePopover> | null;\n\nconst PopoverContext = React.createContext<ContextType>(null);\n\nexport const usePopoverContext = () => {\n  const context = React.useContext(PopoverContext);\n\n  if (context === null) {\n    throw new Error('Popover components must be wrapped in <Popover />');\n  }\n\n  return context;\n};\n\nconst PopoverComponent = ({\n  children,\n  anchorElement,\n  placement,\n  isOpen,\n  offset,\n  anchorPosition,\n  hasAnchorPortal: hasAnchorPortalProp,\n  shouldCaptureFocus = false,\n  initialFocus,\n  onOpenChange,\n  role,\n  closeOnClickOutside = true,\n  isPortaled: isPortaledProp,\n  strategy: strategyProp,\n  shouldConstrainSize,\n}: PopoverProps) => {\n  const isInsideDialog = useIsInsideDialog();\n\n  const strategy = isInsideDialog ? 'fixed' : 'absolute';\n  const hasAnchorPortal = isInsideDialog;\n  const isPortaled = !isInsideDialog;\n\n  const popover = usePopover({\n    anchorElement,\n    anchorElementAsPortalAnchor: hasAnchorPortalProp ?? hasAnchorPortal,\n    anchorPosition,\n    closeOnClickOutside,\n    initialFocus,\n    isOpen: isOpen,\n    isPortaled: isPortaledProp ?? isPortaled,\n    offsetOption: offset,\n    onOpenChange: onOpenChange,\n    placement: placement ? placementTranslation[placement] : undefined,\n    role,\n    shouldCaptureFocus,\n    shouldConstrainSize,\n    strategy: strategyProp ?? strategy,\n  });\n\n  return (\n    <PopoverContext.Provider value={popover}>\n      {children}\n    </PopoverContext.Provider>\n  );\n};\n\ntype PopoverTriggerProps = {\n  /** The content of the trigger */\n  children: React.ReactNode;\n  /** Whether the trigger should render a button element, or pass its props to the child element */\n  hasButtonWrapper?: boolean;\n};\n\nconst PopoverTrigger = ({\n  children,\n  hasButtonWrapper = false,\n  ref,\n  ...props\n}: CommonProps<'button', PopoverTriggerProps>) => {\n  const context = usePopoverContext();\n  // Example from floating UI\n  // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n  const childrenProps = (children as any).props;\n  const mergedRefs = useMergeRefs([\n    context.refs.setReference,\n    ref,\n    childrenProps?.ref,\n  ]);\n\n  // `hasButtonWrapper` allows the user to pass any element as the anchor\n  if (hasButtonWrapper && React.isValidElement(children)) {\n    return React.cloneElement(\n      children,\n      context.getReferenceProps({\n        ...props,\n        ...childrenProps,\n        'data-state': context.isOpen ? 'open' : 'closed',\n        ref: mergedRefs,\n      }),\n    );\n  }\n  return (\n    <button\n      ref={context.refs.setReference}\n      type=\"button\"\n      data-state={context.isOpen ? 'open' : 'closed'}\n      {...context.getReferenceProps(props)}\n    >\n      {children}\n    </button>\n  );\n};\n\ntype PopoverAnchorProps = {\n  children?: React.ReactNode;\n};\n\n/**\n * Use this to separate the anchor visually from the trigger.\n */\nconst PopoverAnchor = ({\n  children,\n  ref,\n  ...props\n}: CommonProps<'div', PopoverAnchorProps>) => {\n  const context = usePopoverContext();\n\n  // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n  const childrenProps = (children as any)?.props;\n  const mergedRefs = useMergeRefs([\n    context.refs.setPositionReference,\n    ref,\n    childrenProps?.ref,\n  ]);\n\n  if (React.isValidElement(children)) {\n    return React.cloneElement(children, {\n      ...props,\n      ...childrenProps,\n      ref: mergedRefs,\n    });\n  }\n\n  return (\n    <div ref={mergedRefs} {...props}>\n      {children}\n    </div>\n  );\n};\n\ntype PopoverContentProps = {\n  children: React.ReactNode;\n  className?: string;\n  style?: React.CSSProperties;\n};\n\nconst PopoverContent = <T extends React.ElementType = 'div'>({\n  as,\n  className,\n  style,\n  children,\n  htmlAttributes,\n  ref,\n  ...restProps\n}: PolymorphicCommonProps<T, PopoverContentProps>) => {\n  const { context: floatingContext, ...context } = usePopoverContext();\n\n  const refs = useMergeRefs([context.refs.setFloating, ref]);\n\n  const { themeClassName } = useNeedleTheme();\n\n  const classes = classNames('ndl-popover', themeClassName, className);\n  const Component: React.ElementType = as ?? 'div';\n\n  // Patch to not get axe errors for the focus guards\n  // To be noted is that axe gives us a false positive error here since the focus guards directly pass focus to other elements\n  // https://github.com/floating-ui/floating-ui/issues/2462\n  usePatchFloatingFocusGuards();\n\n  if (!floatingContext.open) {\n    return null;\n  }\n\n  return (\n    <ConditionalWrap\n      shouldWrap={context.isPortaled}\n      wrap={(wrapChildren) => (\n        <FloatingPortal\n          root={\n            (context.anchorElementAsPortalAnchor ?? false)\n              ? (context.refs.reference.current as HTMLElement | null)\n              : undefined\n          }\n        >\n          {wrapChildren}\n        </FloatingPortal>\n      )}\n    >\n      <FloatingFocusManager\n        context={floatingContext}\n        modal={context.shouldCaptureFocus}\n        initialFocus={context.initialFocus}\n      >\n        <Component\n          className={classes}\n          aria-labelledby={context.labelId}\n          aria-describedby={context.descriptionId}\n          style={{\n            ...context.floatingStyles,\n            ...context.transitionStyles,\n            ...style,\n          }}\n          ref={refs}\n          {...context.getFloatingProps({ ...htmlAttributes })}\n          {...restProps}\n        >\n          {children}\n        </Component>\n      </FloatingFocusManager>\n    </ConditionalWrap>\n  );\n};\n\nconst Popover = Object.assign(PopoverComponent, {\n  Anchor: PopoverAnchor,\n  Content: PopoverContent,\n  Trigger: PopoverTrigger,\n});\n\nexport { Popover };\n"]}
+{"version":3,"file":"Popover.js","sourceRoot":"","sources":["../../../src/popover/Popover.tsx"],"names":[],"mappings":"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","sourcesContent":["/*!\n *\n *  Copyright (c) \"Neo4j\"\n *  Neo4j Sweden AB [http://neo4j.com]\n *\n *  This file is part of Neo4j.\n *\n *  Neo4j is free software: you can redistribute it and/or modify\n *  it under the terms of the GNU General Public License as published by\n *  the Free Software Foundation, either version 3 of the License, or\n *  (at your option) any later version.\n *\n *  This program is distributed in the hope that it will be useful,\n *  but WITHOUT ANY WARRANTY; without even the implied warranty of\n *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the\n *  GNU General Public License for more details.\n *\n *  You should have received a copy of the GNU General Public License\n *  along with this program.  If not, see <http://www.gnu.org/licenses/>.\n */\nimport {\n  FloatingFocusManager,\n  FloatingPortal,\n  type OffsetOptions,\n  type Placement,\n  useMergeRefs,\n} from '@floating-ui/react';\nimport classNames from 'classnames';\nimport React from 'react';\n\nimport {\n  type CommonProps,\n  type PolymorphicCommonProps,\n} from '../_common/types';\nimport { ConditionalWrap } from '../conditional-wrap';\nimport { useIsInsideDialog } from '../dialog/dialog-context';\nimport { useNeedleTheme } from '../theme/ThemeProvider';\nimport { usePopover } from './use-popover';\nimport { usePatchFloatingFocusGuards } from './usePatchFloatingFocusGuards';\n\ntype PlacementOptions =\n  | 'bottom-end-top-end'\n  | 'bottom-start-top-start'\n  | 'bottom-middle-top-middle'\n  | 'top-end-bottom-end'\n  | 'top-start-bottom-start'\n  | 'top-middle-bottom-middle'\n  | 'bottom-start-bottom-end'\n  | 'top-start-top-end'\n  | 'middle-start-middle-end'\n  | 'bottom-end-bottom-start'\n  | 'top-end-top-start'\n  | 'middle-end-middle-start';\n\nexport const placementTranslation: Record<PlacementOptions, Placement> = {\n  'bottom-end-bottom-start': 'right-end',\n  'bottom-end-top-end': 'bottom-end',\n  'bottom-middle-top-middle': 'bottom',\n  'bottom-start-bottom-end': 'left-end',\n  'bottom-start-top-start': 'bottom-start',\n  'middle-end-middle-start': 'right',\n  'middle-start-middle-end': 'left',\n  'top-end-bottom-end': 'top-end',\n  'top-end-top-start': 'right-start',\n  'top-middle-bottom-middle': 'top',\n  'top-start-bottom-start': 'top-start',\n  'top-start-top-end': 'left-start',\n};\ntype PopoverProps = {\n  /** if the popover is open */\n  isOpen?: boolean;\n  /** The content of the popover */\n  children?: React.ReactNode;\n  /**\n   * Can be used if the anchor should be separated from the trigger.\n   * Note: to visually separate the anchor from the trigger, use the Popover.Anchor component instead.\n   */\n  anchorElement?: Element | null;\n  /** If the anchorPosition is provided the anchorElement will be ignored */\n  anchorPosition?: {\n    // TODO v5: create componentProps type for this\n    // oxlint-disable-next-line id-length\n    x: number;\n    // TODO v5: create componentProps type for this\n    // oxlint-disable-next-line id-length\n    y: number;\n  };\n  /** The placement of the floating element is determined by two sets of words. The first set of words specifies the point on the anchor element where the floating element will be attached. The second set of coordinates specifies the point on the floating element that will attach to the anchor element. */\n  placement?: PlacementOptions;\n  /** can take either a number, an object or a function. Full documentation here:  https://floating-ui.com/docs/offset   */\n  offset?: OffsetOptions;\n  /** Called when an internal state change is triggered, when the floating element either opens or closes. It is not called when `isOpen` is updated by the consumer. */\n  onOpenChange?: (isOpen: boolean, event?: Event) => void;\n  /** Use anchorEl for portal's container. Should be used if the popover is portaled and is inside a Dialog for example. */\n  hasAnchorPortal?: boolean;\n  /** If the popover should constrain the focus inside the popover while open */\n  shouldCaptureFocus?: boolean;\n  /** Which element to initially focus. */\n  initialFocus?: number | React.RefObject<HTMLElement | null>;\n  // TODO v5: remove this prop\n  /** The role of the popover.\n   * @deprecated - This prop will be removed in v5.\n   */\n  role?:\n    | 'tooltip'\n    | 'dialog'\n    | 'alertdialog'\n    | 'menu'\n    | 'listbox'\n    | 'grid'\n    | 'tree';\n  /** If the popover should close when the user clicks outside of it */\n  // TODO v5: change naming (if component isn't deprecated)\n  // eslint-disable-next-line @typescript-eslint/naming-convention\n  closeOnClickOutside?: boolean;\n  /**\n   * If the popover should close when focus moves outside of it, for example when tabbing away or focusing another element.\n   * Defaults to the value of `closeOnClickOutside`.\n   * Has no effect when `shouldCaptureFocus` is true, since focus cannot leave the popover.\n   */\n  shouldCloseOnFocusOut?: boolean;\n  /** The strategy of the popover. Fixed should be used when the popover is inside a Dialog. */\n  strategy?: 'fixed' | 'absolute';\n  /** Whether the content is rendered in a portal */\n  isPortaled?: boolean;\n  /**\n   * When true, limits the popover's max-height and max-width to the available viewport space.\n   * The consumer is responsible for adding overflow handling (e.g. overflow-y: auto) to the content.\n   * */\n  shouldConstrainSize?: boolean;\n};\n\ntype ContextType = ReturnType<typeof usePopover> | null;\n\nconst PopoverContext = React.createContext<ContextType>(null);\n\nexport const usePopoverContext = () => {\n  const context = React.useContext(PopoverContext);\n\n  if (context === null) {\n    throw new Error('Popover components must be wrapped in <Popover />');\n  }\n\n  return context;\n};\n\nconst PopoverComponent = ({\n  children,\n  anchorElement,\n  placement,\n  isOpen,\n  offset,\n  anchorPosition,\n  hasAnchorPortal: hasAnchorPortalProp,\n  shouldCaptureFocus = false,\n  initialFocus,\n  onOpenChange,\n  role,\n  closeOnClickOutside = true,\n  shouldCloseOnFocusOut,\n  isPortaled: isPortaledProp,\n  strategy: strategyProp,\n  shouldConstrainSize,\n}: PopoverProps) => {\n  const isInsideDialog = useIsInsideDialog();\n\n  const strategy = isInsideDialog ? 'fixed' : 'absolute';\n  const hasAnchorPortal = isInsideDialog;\n  const isPortaled = !isInsideDialog;\n\n  const popover = usePopover({\n    anchorElement,\n    anchorElementAsPortalAnchor: hasAnchorPortalProp ?? hasAnchorPortal,\n    anchorPosition,\n    closeOnClickOutside,\n    initialFocus,\n    isOpen: isOpen,\n    isPortaled: isPortaledProp ?? isPortaled,\n    offsetOption: offset,\n    onOpenChange: onOpenChange,\n    placement: placement ? placementTranslation[placement] : undefined,\n    role,\n    shouldCaptureFocus,\n    shouldCloseOnFocusOut: shouldCloseOnFocusOut ?? closeOnClickOutside,\n    shouldConstrainSize,\n    strategy: strategyProp ?? strategy,\n  });\n\n  return (\n    <PopoverContext.Provider value={popover}>\n      {children}\n    </PopoverContext.Provider>\n  );\n};\n\ntype PopoverTriggerProps = {\n  /** The content of the trigger */\n  children: React.ReactNode;\n  /** Whether the trigger should render a button element, or pass its props to the child element */\n  hasButtonWrapper?: boolean;\n};\n\nconst PopoverTrigger = ({\n  children,\n  hasButtonWrapper = false,\n  ref,\n  ...props\n}: CommonProps<'button', PopoverTriggerProps>) => {\n  const context = usePopoverContext();\n  // Example from floating UI\n  // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n  const childrenProps = (children as any).props;\n  const mergedRefs = useMergeRefs([\n    context.refs.setReference,\n    ref,\n    childrenProps?.ref,\n  ]);\n\n  // `hasButtonWrapper` allows the user to pass any element as the anchor\n  if (hasButtonWrapper && React.isValidElement(children)) {\n    return React.cloneElement(\n      children,\n      context.getReferenceProps({\n        ...props,\n        ...childrenProps,\n        'data-state': context.isOpen ? 'open' : 'closed',\n        ref: mergedRefs,\n      }),\n    );\n  }\n  return (\n    <button\n      ref={context.refs.setReference}\n      type=\"button\"\n      data-state={context.isOpen ? 'open' : 'closed'}\n      {...context.getReferenceProps(props)}\n    >\n      {children}\n    </button>\n  );\n};\n\ntype PopoverAnchorProps = {\n  children?: React.ReactNode;\n};\n\n/**\n * Use this to separate the anchor visually from the trigger.\n */\nconst PopoverAnchor = ({\n  children,\n  ref,\n  ...props\n}: CommonProps<'div', PopoverAnchorProps>) => {\n  const context = usePopoverContext();\n\n  // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n  const childrenProps = (children as any)?.props;\n  const mergedRefs = useMergeRefs([\n    context.refs.setPositionReference,\n    ref,\n    childrenProps?.ref,\n  ]);\n\n  if (React.isValidElement(children)) {\n    return React.cloneElement(children, {\n      ...props,\n      ...childrenProps,\n      ref: mergedRefs,\n    });\n  }\n\n  return (\n    <div ref={mergedRefs} {...props}>\n      {children}\n    </div>\n  );\n};\n\ntype PopoverContentProps = {\n  children: React.ReactNode;\n  className?: string;\n  style?: React.CSSProperties;\n};\n\nconst PopoverContent = <T extends React.ElementType = 'div'>({\n  as,\n  className,\n  style,\n  children,\n  htmlAttributes,\n  ref,\n  ...restProps\n}: PolymorphicCommonProps<T, PopoverContentProps>) => {\n  const { context: floatingContext, ...context } = usePopoverContext();\n\n  const refs = useMergeRefs([context.refs.setFloating, ref]);\n\n  const { themeClassName } = useNeedleTheme();\n\n  const classes = classNames('ndl-popover', themeClassName, className);\n  const Component: React.ElementType = as ?? 'div';\n\n  // Patch to not get axe errors for the focus guards\n  // To be noted is that axe gives us a false positive error here since the focus guards directly pass focus to other elements\n  // https://github.com/floating-ui/floating-ui/issues/2462\n  usePatchFloatingFocusGuards();\n\n  if (!floatingContext.open) {\n    return null;\n  }\n\n  return (\n    <ConditionalWrap\n      shouldWrap={context.isPortaled}\n      wrap={(wrapChildren) => (\n        <FloatingPortal\n          root={\n            (context.anchorElementAsPortalAnchor ?? false)\n              ? (context.refs.reference.current as HTMLElement | null)\n              : undefined\n          }\n        >\n          {wrapChildren}\n        </FloatingPortal>\n      )}\n    >\n      <FloatingFocusManager\n        context={floatingContext}\n        modal={context.shouldCaptureFocus}\n        initialFocus={context.initialFocus}\n        closeOnFocusOut={context.shouldCloseOnFocusOut}\n      >\n        <Component\n          className={classes}\n          aria-labelledby={context.labelId}\n          aria-describedby={context.descriptionId}\n          style={{\n            ...context.floatingStyles,\n            ...context.transitionStyles,\n            ...style,\n          }}\n          ref={refs}\n          {...context.getFloatingProps({ ...htmlAttributes })}\n          {...restProps}\n        >\n          {children}\n        </Component>\n      </FloatingFocusManager>\n    </ConditionalWrap>\n  );\n};\n\nconst Popover = Object.assign(PopoverComponent, {\n  Anchor: PopoverAnchor,\n  Content: PopoverContent,\n  Trigger: PopoverTrigger,\n});\n\nexport { Popover };\n"]}

package/lib/cjs/popover/use-popover.js

@@ -24,7 +24,7 @@ exports.usePopover = usePopover;
 const react_1 = require("@floating-ui/react");
 const base_1 = require("@neo4j-ndl/base");
 const react_2 = require("react");
-function usePopover({ isInitialOpen = false, placement = 'bottom', isOpen: controlledOpen, onOpenChange: setControlledOpen, offsetOption = 10, anchorElement, anchorPosition, anchorElementAsPortalAnchor, shouldCaptureFocus, initialFocus, role: roleProp, closeOnClickOutside, closeOnReferencePress, returnFocus, strategy = 'absolute', isPortaled = true, shouldConstrainSize = false, } = {}) {
+function usePopover({ isInitialOpen = false, placement = 'bottom', isOpen: controlledOpen, onOpenChange: setControlledOpen, offsetOption = 10, anchorElement, anchorPosition, anchorElementAsPortalAnchor, shouldCaptureFocus, initialFocus, role: roleProp, closeOnClickOutside, closeOnReferencePress, shouldCloseOnFocusOut, returnFocus, strategy = 'absolute', isPortaled = true, shouldConstrainSize = false, } = {}) {
     var _a;
     // Internal state for uncontrolled mode (no `isOpen` prop provided).
     const [isOpenUncontrolled, setIsOpenUncontrolled] = (0, react_2.useState)(isInitialOpen);
@@ -105,6 +105,7 @@ function usePopover({ isInitialOpen = false, placement = 'bottom', isOpen: contr
         setDescriptionId,
         setLabelId,
         shouldCaptureFocus,
+        shouldCloseOnFocusOut,
         transitionStyles })), [
         isOpen,
         interactions,
@@ -114,6 +115,7 @@ function usePopover({ isInitialOpen = false, placement = 'bottom', isOpen: contr
         descriptionId,
         anchorElementAsPortalAnchor,
         shouldCaptureFocus,
+        shouldCloseOnFocusOut,
         initialFocus,
         isPortaled,
         returnFocus,

package/lib/cjs/popover/use-popover.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-popover.js","sourceRoot":"","sources":["../../../src/popover/use-popover.tsx"],"names":[],"mappings":"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","sourcesContent":["/*!\n *\n *  Copyright (c) \"Neo4j\"\n *  Neo4j Sweden AB [http://neo4j.com]\n *\n *  This file is part of Neo4j.\n *\n *  Neo4j is free software: you can redistribute it and/or modify\n *  it under the terms of the GNU General Public License as published by\n *  the Free Software Foundation, either version 3 of the License, or\n *  (at your option) any later version.\n *\n *  This program is distributed in the hope that it will be useful,\n *  but WITHOUT ANY WARRANTY; without even the implied warranty of\n *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the\n *  GNU General Public License for more details.\n *\n *  You should have received a copy of the GNU General Public License\n *  along with this program.  If not, see <http://www.gnu.org/licenses/>.\n */\nimport {\n  autoUpdate,\n  flip,\n  type FloatingFocusManagerProps,\n  offset,\n  type OffsetOptions,\n  type Placement,\n  shift,\n  size,\n  useClick,\n  useClientPoint,\n  useDismiss,\n  useFloating,\n  useInteractions,\n  type UseInteractionsReturn,\n  useRole,\n  useTransitionStyles,\n} from '@floating-ui/react';\nimport { tokens } from '@neo4j-ndl/base';\nimport { useMemo, useState } from 'react';\n\nexport interface PopoverOptions {\n  isInitialOpen?: boolean;\n  placement?: Placement;\n  isOpen?: boolean;\n  onOpenChange?: (open: boolean, event?: Event) => void;\n  offsetOption?: OffsetOptions;\n  anchorElement?: Element | null;\n  anchorPosition?: {\n    // TODO v5: create componentProps type for this\n    // oxlint-disable-next-line id-length\n    x: number;\n    // TODO v5: create componentProps type for this\n    // oxlint-disable-next-line id-length\n    y: number;\n  };\n  // TODO v5: fix boolean naming convention\n  // eslint-disable-next-line @typescript-eslint/naming-convention\n  anchorElementAsPortalAnchor?: boolean;\n  shouldCaptureFocus?: boolean;\n  initialFocus?: number | React.RefObject<HTMLElement | null>;\n  role?:\n    | 'tooltip'\n    | 'dialog'\n    | 'alertdialog'\n    | 'menu'\n    | 'listbox'\n    | 'grid'\n    | 'tree';\n  // TODO v5: decide if this naming is okay, or change it\n  // eslint-disable-next-line @typescript-eslint/naming-convention\n  closeOnClickOutside?: boolean;\n  // TODO v5: decide if this naming is okay, or change it\n  // eslint-disable-next-line @typescript-eslint/naming-convention\n  closeOnReferencePress?: boolean;\n  returnFocus?: FloatingFocusManagerProps['returnFocus'];\n  strategy?: 'fixed' | 'absolute';\n  isPortaled?: boolean;\n  shouldConstrainSize?: boolean;\n}\n\nexport interface UsePopoverReturn\n  extends UseInteractionsReturn, ReturnType<typeof useFloating> {\n  isOpen: boolean;\n  labelId: string | undefined;\n  descriptionId: string | undefined;\n  transitionStyles: React.CSSProperties;\n  setLabelId: (labelId: string | undefined) => void;\n  setDescriptionId: (descriptionId: string | undefined) => void;\n  // TODO v5: fix boolean naming convention\n  // eslint-disable-next-line @typescript-eslint/naming-convention\n  anchorElementAsPortalAnchor: boolean | undefined;\n  shouldCaptureFocus: boolean | undefined;\n  initialFocus: number | React.RefObject<HTMLElement | null> | undefined;\n  isPortaled: boolean;\n  returnFocus: FloatingFocusManagerProps['returnFocus'];\n}\n\nexport function usePopover({\n  isInitialOpen = false,\n  placement = 'bottom',\n  isOpen: controlledOpen,\n  onOpenChange: setControlledOpen,\n  offsetOption = 10,\n  anchorElement,\n  anchorPosition,\n  anchorElementAsPortalAnchor,\n  shouldCaptureFocus,\n  initialFocus,\n  role: roleProp,\n  closeOnClickOutside,\n  closeOnReferencePress,\n  returnFocus,\n  strategy = 'absolute',\n  isPortaled = true,\n  shouldConstrainSize = false,\n}: PopoverOptions = {}): UsePopoverReturn {\n  // Internal state for uncontrolled mode (no `isOpen` prop provided).\n  const [isOpenUncontrolled, setIsOpenUncontrolled] = useState(isInitialOpen);\n  const [labelId, setLabelId] = useState<string | undefined>();\n  const [descriptionId, setDescriptionId] = useState<string | undefined>();\n\n  // Controlled/uncontrolled pattern: prefer the consumer-provided `isOpen`,\n  // falling back to internal state when not provided.\n  const isOpen = controlledOpen ?? isOpenUncontrolled;\n\n  const data = useFloating({\n    elements: {\n      reference: anchorElement,\n    },\n    middleware: [\n      offset(offsetOption),\n      flip({\n        crossAxis: placement.includes('-'),\n        fallbackAxisSideDirection: 'end',\n        padding: 5,\n      }),\n      shift(),\n      ...(shouldConstrainSize\n        ? [\n            size({\n              apply({ availableHeight, availableWidth, elements }) {\n                Object.assign(elements.floating.style, {\n                  maxHeight: `${availableHeight}px`,\n                  maxWidth: `${availableWidth}px`,\n                });\n              },\n              padding: 5,\n            }),\n          ]\n        : []),\n    ],\n    // Floating UI calls this when interactions (useClick, useDismiss, etc.)\n    // trigger an open/close. We always sync internal state so uncontrolled\n    // mode works, and notify the consumer callback exactly once if provided.\n    onOpenChange: (open, event) => {\n      setIsOpenUncontrolled(open);\n      setControlledOpen?.(open, event);\n    },\n    open: isOpen,\n    placement: placement,\n    strategy,\n    whileElementsMounted: autoUpdate,\n  });\n  const context = data.context;\n\n  // Only enable built-in click-to-toggle in uncontrolled mode. In controlled\n  // mode the consumer owns the open state and wires up their own trigger.\n  const click = useClick(context, {\n    enabled: controlledOpen === undefined,\n  });\n\n  const dismiss = useDismiss(context, {\n    outsidePress: closeOnClickOutside,\n    referencePress: closeOnReferencePress,\n  });\n  const role = useRole(context, {\n    role: roleProp,\n  });\n\n  const clientPoint = useClientPoint(context, {\n    enabled: anchorPosition !== undefined,\n    // oxlint-disable-next-line id-length\n    x: anchorPosition?.x,\n    // oxlint-disable-next-line id-length\n    y: anchorPosition?.y,\n  });\n\n  const interactions = useInteractions([click, dismiss, role, clientPoint]);\n\n  const { styles: transitionStyles } = useTransitionStyles(context, {\n    duration: Number.parseInt(tokens.motion.duration.quick) ?? 0,\n  });\n\n  return useMemo(\n    () => ({\n      ...data,\n      ...interactions,\n      anchorElementAsPortalAnchor,\n      descriptionId,\n      initialFocus,\n      isOpen,\n      isPortaled,\n      labelId,\n      returnFocus,\n      setDescriptionId,\n      setLabelId,\n      shouldCaptureFocus,\n      transitionStyles,\n    }),\n    [\n      isOpen,\n      interactions,\n      data,\n      transitionStyles,\n      labelId,\n      descriptionId,\n      anchorElementAsPortalAnchor,\n      shouldCaptureFocus,\n      initialFocus,\n      isPortaled,\n      returnFocus,\n    ],\n  );\n}\n"]}
+{"version":3,"file":"use-popover.js","sourceRoot":"","sources":["../../../src/popover/use-popover.tsx"],"names":[],"mappings":"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","sourcesContent":["/*!\n *\n *  Copyright (c) \"Neo4j\"\n *  Neo4j Sweden AB [http://neo4j.com]\n *\n *  This file is part of Neo4j.\n *\n *  Neo4j is free software: you can redistribute it and/or modify\n *  it under the terms of the GNU General Public License as published by\n *  the Free Software Foundation, either version 3 of the License, or\n *  (at your option) any later version.\n *\n *  This program is distributed in the hope that it will be useful,\n *  but WITHOUT ANY WARRANTY; without even the implied warranty of\n *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the\n *  GNU General Public License for more details.\n *\n *  You should have received a copy of the GNU General Public License\n *  along with this program.  If not, see <http://www.gnu.org/licenses/>.\n */\nimport {\n  autoUpdate,\n  flip,\n  type FloatingFocusManagerProps,\n  offset,\n  type OffsetOptions,\n  type Placement,\n  shift,\n  size,\n  useClick,\n  useClientPoint,\n  useDismiss,\n  useFloating,\n  useInteractions,\n  type UseInteractionsReturn,\n  useRole,\n  useTransitionStyles,\n} from '@floating-ui/react';\nimport { tokens } from '@neo4j-ndl/base';\nimport { useMemo, useState } from 'react';\n\nexport interface PopoverOptions {\n  isInitialOpen?: boolean;\n  placement?: Placement;\n  isOpen?: boolean;\n  onOpenChange?: (open: boolean, event?: Event) => void;\n  offsetOption?: OffsetOptions;\n  anchorElement?: Element | null;\n  anchorPosition?: {\n    // TODO v5: create componentProps type for this\n    // oxlint-disable-next-line id-length\n    x: number;\n    // TODO v5: create componentProps type for this\n    // oxlint-disable-next-line id-length\n    y: number;\n  };\n  // TODO v5: fix boolean naming convention\n  // eslint-disable-next-line @typescript-eslint/naming-convention\n  anchorElementAsPortalAnchor?: boolean;\n  shouldCaptureFocus?: boolean;\n  initialFocus?: number | React.RefObject<HTMLElement | null>;\n  role?:\n    | 'tooltip'\n    | 'dialog'\n    | 'alertdialog'\n    | 'menu'\n    | 'listbox'\n    | 'grid'\n    | 'tree';\n  // TODO v5: decide if this naming is okay, or change it\n  // eslint-disable-next-line @typescript-eslint/naming-convention\n  closeOnClickOutside?: boolean;\n  // TODO v5: decide if this naming is okay, or change it\n  // eslint-disable-next-line @typescript-eslint/naming-convention\n  closeOnReferencePress?: boolean;\n  shouldCloseOnFocusOut?: boolean;\n  returnFocus?: FloatingFocusManagerProps['returnFocus'];\n  strategy?: 'fixed' | 'absolute';\n  isPortaled?: boolean;\n  shouldConstrainSize?: boolean;\n}\n\nexport interface UsePopoverReturn\n  extends UseInteractionsReturn, ReturnType<typeof useFloating> {\n  isOpen: boolean;\n  labelId: string | undefined;\n  descriptionId: string | undefined;\n  transitionStyles: React.CSSProperties;\n  setLabelId: (labelId: string | undefined) => void;\n  setDescriptionId: (descriptionId: string | undefined) => void;\n  // TODO v5: fix boolean naming convention\n  // eslint-disable-next-line @typescript-eslint/naming-convention\n  anchorElementAsPortalAnchor: boolean | undefined;\n  shouldCaptureFocus: boolean | undefined;\n  shouldCloseOnFocusOut: boolean | undefined;\n  initialFocus: number | React.RefObject<HTMLElement | null> | undefined;\n  isPortaled: boolean;\n  returnFocus: FloatingFocusManagerProps['returnFocus'];\n}\n\nexport function usePopover({\n  isInitialOpen = false,\n  placement = 'bottom',\n  isOpen: controlledOpen,\n  onOpenChange: setControlledOpen,\n  offsetOption = 10,\n  anchorElement,\n  anchorPosition,\n  anchorElementAsPortalAnchor,\n  shouldCaptureFocus,\n  initialFocus,\n  role: roleProp,\n  closeOnClickOutside,\n  closeOnReferencePress,\n  shouldCloseOnFocusOut,\n  returnFocus,\n  strategy = 'absolute',\n  isPortaled = true,\n  shouldConstrainSize = false,\n}: PopoverOptions = {}): UsePopoverReturn {\n  // Internal state for uncontrolled mode (no `isOpen` prop provided).\n  const [isOpenUncontrolled, setIsOpenUncontrolled] = useState(isInitialOpen);\n  const [labelId, setLabelId] = useState<string | undefined>();\n  const [descriptionId, setDescriptionId] = useState<string | undefined>();\n\n  // Controlled/uncontrolled pattern: prefer the consumer-provided `isOpen`,\n  // falling back to internal state when not provided.\n  const isOpen = controlledOpen ?? isOpenUncontrolled;\n\n  const data = useFloating({\n    elements: {\n      reference: anchorElement,\n    },\n    middleware: [\n      offset(offsetOption),\n      flip({\n        crossAxis: placement.includes('-'),\n        fallbackAxisSideDirection: 'end',\n        padding: 5,\n      }),\n      shift(),\n      ...(shouldConstrainSize\n        ? [\n            size({\n              apply({ availableHeight, availableWidth, elements }) {\n                Object.assign(elements.floating.style, {\n                  maxHeight: `${availableHeight}px`,\n                  maxWidth: `${availableWidth}px`,\n                });\n              },\n              padding: 5,\n            }),\n          ]\n        : []),\n    ],\n    // Floating UI calls this when interactions (useClick, useDismiss, etc.)\n    // trigger an open/close. We always sync internal state so uncontrolled\n    // mode works, and notify the consumer callback exactly once if provided.\n    onOpenChange: (open, event) => {\n      setIsOpenUncontrolled(open);\n      setControlledOpen?.(open, event);\n    },\n    open: isOpen,\n    placement: placement,\n    strategy,\n    whileElementsMounted: autoUpdate,\n  });\n  const context = data.context;\n\n  // Only enable built-in click-to-toggle in uncontrolled mode. In controlled\n  // mode the consumer owns the open state and wires up their own trigger.\n  const click = useClick(context, {\n    enabled: controlledOpen === undefined,\n  });\n\n  const dismiss = useDismiss(context, {\n    outsidePress: closeOnClickOutside,\n    referencePress: closeOnReferencePress,\n  });\n  const role = useRole(context, {\n    role: roleProp,\n  });\n\n  const clientPoint = useClientPoint(context, {\n    enabled: anchorPosition !== undefined,\n    // oxlint-disable-next-line id-length\n    x: anchorPosition?.x,\n    // oxlint-disable-next-line id-length\n    y: anchorPosition?.y,\n  });\n\n  const interactions = useInteractions([click, dismiss, role, clientPoint]);\n\n  const { styles: transitionStyles } = useTransitionStyles(context, {\n    duration: Number.parseInt(tokens.motion.duration.quick) ?? 0,\n  });\n\n  return useMemo(\n    () => ({\n      ...data,\n      ...interactions,\n      anchorElementAsPortalAnchor,\n      descriptionId,\n      initialFocus,\n      isOpen,\n      isPortaled,\n      labelId,\n      returnFocus,\n      setDescriptionId,\n      setLabelId,\n      shouldCaptureFocus,\n      shouldCloseOnFocusOut,\n      transitionStyles,\n    }),\n    [\n      isOpen,\n      interactions,\n      data,\n      transitionStyles,\n      labelId,\n      descriptionId,\n      anchorElementAsPortalAnchor,\n      shouldCaptureFocus,\n      shouldCloseOnFocusOut,\n      initialFocus,\n      isPortaled,\n      returnFocus,\n    ],\n  );\n}\n"]}

package/lib/esm/popover/Popover.js

@@ -60,7 +60,7 @@ export const usePopoverContext = () => {
     }
     return context;
 };
-const PopoverComponent = ({ children, anchorElement, placement, isOpen, offset, anchorPosition, hasAnchorPortal: hasAnchorPortalProp, shouldCaptureFocus = false, initialFocus, onOpenChange, role, closeOnClickOutside = true, isPortaled: isPortaledProp, strategy: strategyProp, shouldConstrainSize, }) => {
+const PopoverComponent = ({ children, anchorElement, placement, isOpen, offset, anchorPosition, hasAnchorPortal: hasAnchorPortalProp, shouldCaptureFocus = false, initialFocus, onOpenChange, role, closeOnClickOutside = true, shouldCloseOnFocusOut, isPortaled: isPortaledProp, strategy: strategyProp, shouldConstrainSize, }) => {
     const isInsideDialog = useIsInsideDialog();
     const strategy = isInsideDialog ? 'fixed' : 'absolute';
     const hasAnchorPortal = isInsideDialog;
@@ -78,6 +78,7 @@ const PopoverComponent = ({ children, anchorElement, placement, isOpen, offset,
         placement: placement ? placementTranslation[placement] : undefined,
         role,
         shouldCaptureFocus,
+        shouldCloseOnFocusOut: shouldCloseOnFocusOut !== null && shouldCloseOnFocusOut !== void 0 ? shouldCloseOnFocusOut : closeOnClickOutside,
         shouldConstrainSize,
         strategy: strategyProp !== null && strategyProp !== void 0 ? strategyProp : strategy,
     });
@@ -137,7 +138,7 @@ const PopoverContent = (_a) => {
             return (_jsx(FloatingPortal, { root: ((_a = context.anchorElementAsPortalAnchor) !== null && _a !== void 0 ? _a : false)
                     ? context.refs.reference.current
                     : undefined, children: wrapChildren }));
-        }, children: _jsx(FloatingFocusManager, { context: floatingContext, modal: context.shouldCaptureFocus, initialFocus: context.initialFocus, children: _jsx(Component, Object.assign({ className: classes, "aria-labelledby": context.labelId, "aria-describedby": context.descriptionId, style: Object.assign(Object.assign(Object.assign({}, context.floatingStyles), context.transitionStyles), style), ref: refs }, context.getFloatingProps(Object.assign({}, htmlAttributes)), restProps, { children: children })) }) }));
+        }, children: _jsx(FloatingFocusManager, { context: floatingContext, modal: context.shouldCaptureFocus, initialFocus: context.initialFocus, closeOnFocusOut: context.shouldCloseOnFocusOut, children: _jsx(Component, Object.assign({ className: classes, "aria-labelledby": context.labelId, "aria-describedby": context.descriptionId, style: Object.assign(Object.assign(Object.assign({}, context.floatingStyles), context.transitionStyles), style), ref: refs }, context.getFloatingProps(Object.assign({}, htmlAttributes)), restProps, { children: children })) }) }));
 };
 const Popover = Object.assign(PopoverComponent, {
     Anchor: PopoverAnchor,

package/lib/esm/popover/Popover.js.map

@@ -1 +1 @@
-{"version":3,"file":"Popover.js","sourceRoot":"","sources":["../../../src/popover/Popover.tsx"],"names":[],"mappings":"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","sourcesContent":["/*!\n *\n *  Copyright (c) \"Neo4j\"\n *  Neo4j Sweden AB [http://neo4j.com]\n *\n *  This file is part of Neo4j.\n *\n *  Neo4j is free software: you can redistribute it and/or modify\n *  it under the terms of the GNU General Public License as published by\n *  the Free Software Foundation, either version 3 of the License, or\n *  (at your option) any later version.\n *\n *  This program is distributed in the hope that it will be useful,\n *  but WITHOUT ANY WARRANTY; without even the implied warranty of\n *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the\n *  GNU General Public License for more details.\n *\n *  You should have received a copy of the GNU General Public License\n *  along with this program.  If not, see <http://www.gnu.org/licenses/>.\n */\nimport {\n  FloatingFocusManager,\n  FloatingPortal,\n  type OffsetOptions,\n  type Placement,\n  useMergeRefs,\n} from '@floating-ui/react';\nimport classNames from 'classnames';\nimport React from 'react';\n\nimport {\n  type CommonProps,\n  type PolymorphicCommonProps,\n} from '../_common/types';\nimport { ConditionalWrap } from '../conditional-wrap';\nimport { useIsInsideDialog } from '../dialog/dialog-context';\nimport { useNeedleTheme } from '../theme/ThemeProvider';\nimport { usePopover } from './use-popover';\nimport { usePatchFloatingFocusGuards } from './usePatchFloatingFocusGuards';\n\ntype PlacementOptions =\n  | 'bottom-end-top-end'\n  | 'bottom-start-top-start'\n  | 'bottom-middle-top-middle'\n  | 'top-end-bottom-end'\n  | 'top-start-bottom-start'\n  | 'top-middle-bottom-middle'\n  | 'bottom-start-bottom-end'\n  | 'top-start-top-end'\n  | 'middle-start-middle-end'\n  | 'bottom-end-bottom-start'\n  | 'top-end-top-start'\n  | 'middle-end-middle-start';\n\nexport const placementTranslation: Record<PlacementOptions, Placement> = {\n  'bottom-end-bottom-start': 'right-end',\n  'bottom-end-top-end': 'bottom-end',\n  'bottom-middle-top-middle': 'bottom',\n  'bottom-start-bottom-end': 'left-end',\n  'bottom-start-top-start': 'bottom-start',\n  'middle-end-middle-start': 'right',\n  'middle-start-middle-end': 'left',\n  'top-end-bottom-end': 'top-end',\n  'top-end-top-start': 'right-start',\n  'top-middle-bottom-middle': 'top',\n  'top-start-bottom-start': 'top-start',\n  'top-start-top-end': 'left-start',\n};\ntype PopoverProps = {\n  /** if the popover is open */\n  isOpen?: boolean;\n  /** The content of the popover */\n  children?: React.ReactNode;\n  /**\n   * Can be used if the anchor should be separated from the trigger.\n   * Note: to visually separate the anchor from the trigger, use the Popover.Anchor component instead.\n   */\n  anchorElement?: Element | null;\n  /** If the anchorPosition is provided the anchorElement will be ignored */\n  anchorPosition?: {\n    // TODO v5: create componentProps type for this\n    // oxlint-disable-next-line id-length\n    x: number;\n    // TODO v5: create componentProps type for this\n    // oxlint-disable-next-line id-length\n    y: number;\n  };\n  /** The placement of the floating element is determined by two sets of words. The first set of words specifies the point on the anchor element where the floating element will be attached. The second set of coordinates specifies the point on the floating element that will attach to the anchor element. */\n  placement?: PlacementOptions;\n  /** can take either a number, an object or a function. Full documentation here:  https://floating-ui.com/docs/offset   */\n  offset?: OffsetOptions;\n  /** Called when an internal state change is triggered, when the floating element either opens or closes. It is not called when `isOpen` is updated by the consumer. */\n  onOpenChange?: (isOpen: boolean, event?: Event) => void;\n  /** Use anchorEl for portal's container. Should be used if the popover is portaled and is inside a Dialog for example. */\n  hasAnchorPortal?: boolean;\n  /** If the popover should constrain the focus inside the popover while open */\n  shouldCaptureFocus?: boolean;\n  /** Which element to initially focus. */\n  initialFocus?: number | React.RefObject<HTMLElement | null>;\n  // TODO v5: remove this prop\n  /** The role of the popover.\n   * @deprecated - This prop will be removed in v5.\n   */\n  role?:\n    | 'tooltip'\n    | 'dialog'\n    | 'alertdialog'\n    | 'menu'\n    | 'listbox'\n    | 'grid'\n    | 'tree';\n  /** If the popover should close when the user clicks outside of it */\n  // TODO v5: change naming (if component isn't deprecated)\n  // eslint-disable-next-line @typescript-eslint/naming-convention\n  closeOnClickOutside?: boolean;\n  /** The strategy of the popover. Fixed should be used when the popover is inside a Dialog. */\n  strategy?: 'fixed' | 'absolute';\n  /** Whether the content is rendered in a portal */\n  isPortaled?: boolean;\n  /**\n   * When true, limits the popover's max-height and max-width to the available viewport space.\n   * The consumer is responsible for adding overflow handling (e.g. overflow-y: auto) to the content.\n   * */\n  shouldConstrainSize?: boolean;\n};\n\ntype ContextType = ReturnType<typeof usePopover> | null;\n\nconst PopoverContext = React.createContext<ContextType>(null);\n\nexport const usePopoverContext = () => {\n  const context = React.useContext(PopoverContext);\n\n  if (context === null) {\n    throw new Error('Popover components must be wrapped in <Popover />');\n  }\n\n  return context;\n};\n\nconst PopoverComponent = ({\n  children,\n  anchorElement,\n  placement,\n  isOpen,\n  offset,\n  anchorPosition,\n  hasAnchorPortal: hasAnchorPortalProp,\n  shouldCaptureFocus = false,\n  initialFocus,\n  onOpenChange,\n  role,\n  closeOnClickOutside = true,\n  isPortaled: isPortaledProp,\n  strategy: strategyProp,\n  shouldConstrainSize,\n}: PopoverProps) => {\n  const isInsideDialog = useIsInsideDialog();\n\n  const strategy = isInsideDialog ? 'fixed' : 'absolute';\n  const hasAnchorPortal = isInsideDialog;\n  const isPortaled = !isInsideDialog;\n\n  const popover = usePopover({\n    anchorElement,\n    anchorElementAsPortalAnchor: hasAnchorPortalProp ?? hasAnchorPortal,\n    anchorPosition,\n    closeOnClickOutside,\n    initialFocus,\n    isOpen: isOpen,\n    isPortaled: isPortaledProp ?? isPortaled,\n    offsetOption: offset,\n    onOpenChange: onOpenChange,\n    placement: placement ? placementTranslation[placement] : undefined,\n    role,\n    shouldCaptureFocus,\n    shouldConstrainSize,\n    strategy: strategyProp ?? strategy,\n  });\n\n  return (\n    <PopoverContext.Provider value={popover}>\n      {children}\n    </PopoverContext.Provider>\n  );\n};\n\ntype PopoverTriggerProps = {\n  /** The content of the trigger */\n  children: React.ReactNode;\n  /** Whether the trigger should render a button element, or pass its props to the child element */\n  hasButtonWrapper?: boolean;\n};\n\nconst PopoverTrigger = ({\n  children,\n  hasButtonWrapper = false,\n  ref,\n  ...props\n}: CommonProps<'button', PopoverTriggerProps>) => {\n  const context = usePopoverContext();\n  // Example from floating UI\n  // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n  const childrenProps = (children as any).props;\n  const mergedRefs = useMergeRefs([\n    context.refs.setReference,\n    ref,\n    childrenProps?.ref,\n  ]);\n\n  // `hasButtonWrapper` allows the user to pass any element as the anchor\n  if (hasButtonWrapper && React.isValidElement(children)) {\n    return React.cloneElement(\n      children,\n      context.getReferenceProps({\n        ...props,\n        ...childrenProps,\n        'data-state': context.isOpen ? 'open' : 'closed',\n        ref: mergedRefs,\n      }),\n    );\n  }\n  return (\n    <button\n      ref={context.refs.setReference}\n      type=\"button\"\n      data-state={context.isOpen ? 'open' : 'closed'}\n      {...context.getReferenceProps(props)}\n    >\n      {children}\n    </button>\n  );\n};\n\ntype PopoverAnchorProps = {\n  children?: React.ReactNode;\n};\n\n/**\n * Use this to separate the anchor visually from the trigger.\n */\nconst PopoverAnchor = ({\n  children,\n  ref,\n  ...props\n}: CommonProps<'div', PopoverAnchorProps>) => {\n  const context = usePopoverContext();\n\n  // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n  const childrenProps = (children as any)?.props;\n  const mergedRefs = useMergeRefs([\n    context.refs.setPositionReference,\n    ref,\n    childrenProps?.ref,\n  ]);\n\n  if (React.isValidElement(children)) {\n    return React.cloneElement(children, {\n      ...props,\n      ...childrenProps,\n      ref: mergedRefs,\n    });\n  }\n\n  return (\n    <div ref={mergedRefs} {...props}>\n      {children}\n    </div>\n  );\n};\n\ntype PopoverContentProps = {\n  children: React.ReactNode;\n  className?: string;\n  style?: React.CSSProperties;\n};\n\nconst PopoverContent = <T extends React.ElementType = 'div'>({\n  as,\n  className,\n  style,\n  children,\n  htmlAttributes,\n  ref,\n  ...restProps\n}: PolymorphicCommonProps<T, PopoverContentProps>) => {\n  const { context: floatingContext, ...context } = usePopoverContext();\n\n  const refs = useMergeRefs([context.refs.setFloating, ref]);\n\n  const { themeClassName } = useNeedleTheme();\n\n  const classes = classNames('ndl-popover', themeClassName, className);\n  const Component: React.ElementType = as ?? 'div';\n\n  // Patch to not get axe errors for the focus guards\n  // To be noted is that axe gives us a false positive error here since the focus guards directly pass focus to other elements\n  // https://github.com/floating-ui/floating-ui/issues/2462\n  usePatchFloatingFocusGuards();\n\n  if (!floatingContext.open) {\n    return null;\n  }\n\n  return (\n    <ConditionalWrap\n      shouldWrap={context.isPortaled}\n      wrap={(wrapChildren) => (\n        <FloatingPortal\n          root={\n            (context.anchorElementAsPortalAnchor ?? false)\n              ? (context.refs.reference.current as HTMLElement | null)\n              : undefined\n          }\n        >\n          {wrapChildren}\n        </FloatingPortal>\n      )}\n    >\n      <FloatingFocusManager\n        context={floatingContext}\n        modal={context.shouldCaptureFocus}\n        initialFocus={context.initialFocus}\n      >\n        <Component\n          className={classes}\n          aria-labelledby={context.labelId}\n          aria-describedby={context.descriptionId}\n          style={{\n            ...context.floatingStyles,\n            ...context.transitionStyles,\n            ...style,\n          }}\n          ref={refs}\n          {...context.getFloatingProps({ ...htmlAttributes })}\n          {...restProps}\n        >\n          {children}\n        </Component>\n      </FloatingFocusManager>\n    </ConditionalWrap>\n  );\n};\n\nconst Popover = Object.assign(PopoverComponent, {\n  Anchor: PopoverAnchor,\n  Content: PopoverContent,\n  Trigger: PopoverTrigger,\n});\n\nexport { Popover };\n"]}
+{"version":3,"file":"Popover.js","sourceRoot":"","sources":["../../../src/popover/Popover.tsx"],"names":[],"mappings":"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","sourcesContent":["/*!\n *\n *  Copyright (c) \"Neo4j\"\n *  Neo4j Sweden AB [http://neo4j.com]\n *\n *  This file is part of Neo4j.\n *\n *  Neo4j is free software: you can redistribute it and/or modify\n *  it under the terms of the GNU General Public License as published by\n *  the Free Software Foundation, either version 3 of the License, or\n *  (at your option) any later version.\n *\n *  This program is distributed in the hope that it will be useful,\n *  but WITHOUT ANY WARRANTY; without even the implied warranty of\n *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the\n *  GNU General Public License for more details.\n *\n *  You should have received a copy of the GNU General Public License\n *  along with this program.  If not, see <http://www.gnu.org/licenses/>.\n */\nimport {\n  FloatingFocusManager,\n  FloatingPortal,\n  type OffsetOptions,\n  type Placement,\n  useMergeRefs,\n} from '@floating-ui/react';\nimport classNames from 'classnames';\nimport React from 'react';\n\nimport {\n  type CommonProps,\n  type PolymorphicCommonProps,\n} from '../_common/types';\nimport { ConditionalWrap } from '../conditional-wrap';\nimport { useIsInsideDialog } from '../dialog/dialog-context';\nimport { useNeedleTheme } from '../theme/ThemeProvider';\nimport { usePopover } from './use-popover';\nimport { usePatchFloatingFocusGuards } from './usePatchFloatingFocusGuards';\n\ntype PlacementOptions =\n  | 'bottom-end-top-end'\n  | 'bottom-start-top-start'\n  | 'bottom-middle-top-middle'\n  | 'top-end-bottom-end'\n  | 'top-start-bottom-start'\n  | 'top-middle-bottom-middle'\n  | 'bottom-start-bottom-end'\n  | 'top-start-top-end'\n  | 'middle-start-middle-end'\n  | 'bottom-end-bottom-start'\n  | 'top-end-top-start'\n  | 'middle-end-middle-start';\n\nexport const placementTranslation: Record<PlacementOptions, Placement> = {\n  'bottom-end-bottom-start': 'right-end',\n  'bottom-end-top-end': 'bottom-end',\n  'bottom-middle-top-middle': 'bottom',\n  'bottom-start-bottom-end': 'left-end',\n  'bottom-start-top-start': 'bottom-start',\n  'middle-end-middle-start': 'right',\n  'middle-start-middle-end': 'left',\n  'top-end-bottom-end': 'top-end',\n  'top-end-top-start': 'right-start',\n  'top-middle-bottom-middle': 'top',\n  'top-start-bottom-start': 'top-start',\n  'top-start-top-end': 'left-start',\n};\ntype PopoverProps = {\n  /** if the popover is open */\n  isOpen?: boolean;\n  /** The content of the popover */\n  children?: React.ReactNode;\n  /**\n   * Can be used if the anchor should be separated from the trigger.\n   * Note: to visually separate the anchor from the trigger, use the Popover.Anchor component instead.\n   */\n  anchorElement?: Element | null;\n  /** If the anchorPosition is provided the anchorElement will be ignored */\n  anchorPosition?: {\n    // TODO v5: create componentProps type for this\n    // oxlint-disable-next-line id-length\n    x: number;\n    // TODO v5: create componentProps type for this\n    // oxlint-disable-next-line id-length\n    y: number;\n  };\n  /** The placement of the floating element is determined by two sets of words. The first set of words specifies the point on the anchor element where the floating element will be attached. The second set of coordinates specifies the point on the floating element that will attach to the anchor element. */\n  placement?: PlacementOptions;\n  /** can take either a number, an object or a function. Full documentation here:  https://floating-ui.com/docs/offset   */\n  offset?: OffsetOptions;\n  /** Called when an internal state change is triggered, when the floating element either opens or closes. It is not called when `isOpen` is updated by the consumer. */\n  onOpenChange?: (isOpen: boolean, event?: Event) => void;\n  /** Use anchorEl for portal's container. Should be used if the popover is portaled and is inside a Dialog for example. */\n  hasAnchorPortal?: boolean;\n  /** If the popover should constrain the focus inside the popover while open */\n  shouldCaptureFocus?: boolean;\n  /** Which element to initially focus. */\n  initialFocus?: number | React.RefObject<HTMLElement | null>;\n  // TODO v5: remove this prop\n  /** The role of the popover.\n   * @deprecated - This prop will be removed in v5.\n   */\n  role?:\n    | 'tooltip'\n    | 'dialog'\n    | 'alertdialog'\n    | 'menu'\n    | 'listbox'\n    | 'grid'\n    | 'tree';\n  /** If the popover should close when the user clicks outside of it */\n  // TODO v5: change naming (if component isn't deprecated)\n  // eslint-disable-next-line @typescript-eslint/naming-convention\n  closeOnClickOutside?: boolean;\n  /**\n   * If the popover should close when focus moves outside of it, for example when tabbing away or focusing another element.\n   * Defaults to the value of `closeOnClickOutside`.\n   * Has no effect when `shouldCaptureFocus` is true, since focus cannot leave the popover.\n   */\n  shouldCloseOnFocusOut?: boolean;\n  /** The strategy of the popover. Fixed should be used when the popover is inside a Dialog. */\n  strategy?: 'fixed' | 'absolute';\n  /** Whether the content is rendered in a portal */\n  isPortaled?: boolean;\n  /**\n   * When true, limits the popover's max-height and max-width to the available viewport space.\n   * The consumer is responsible for adding overflow handling (e.g. overflow-y: auto) to the content.\n   * */\n  shouldConstrainSize?: boolean;\n};\n\ntype ContextType = ReturnType<typeof usePopover> | null;\n\nconst PopoverContext = React.createContext<ContextType>(null);\n\nexport const usePopoverContext = () => {\n  const context = React.useContext(PopoverContext);\n\n  if (context === null) {\n    throw new Error('Popover components must be wrapped in <Popover />');\n  }\n\n  return context;\n};\n\nconst PopoverComponent = ({\n  children,\n  anchorElement,\n  placement,\n  isOpen,\n  offset,\n  anchorPosition,\n  hasAnchorPortal: hasAnchorPortalProp,\n  shouldCaptureFocus = false,\n  initialFocus,\n  onOpenChange,\n  role,\n  closeOnClickOutside = true,\n  shouldCloseOnFocusOut,\n  isPortaled: isPortaledProp,\n  strategy: strategyProp,\n  shouldConstrainSize,\n}: PopoverProps) => {\n  const isInsideDialog = useIsInsideDialog();\n\n  const strategy = isInsideDialog ? 'fixed' : 'absolute';\n  const hasAnchorPortal = isInsideDialog;\n  const isPortaled = !isInsideDialog;\n\n  const popover = usePopover({\n    anchorElement,\n    anchorElementAsPortalAnchor: hasAnchorPortalProp ?? hasAnchorPortal,\n    anchorPosition,\n    closeOnClickOutside,\n    initialFocus,\n    isOpen: isOpen,\n    isPortaled: isPortaledProp ?? isPortaled,\n    offsetOption: offset,\n    onOpenChange: onOpenChange,\n    placement: placement ? placementTranslation[placement] : undefined,\n    role,\n    shouldCaptureFocus,\n    shouldCloseOnFocusOut: shouldCloseOnFocusOut ?? closeOnClickOutside,\n    shouldConstrainSize,\n    strategy: strategyProp ?? strategy,\n  });\n\n  return (\n    <PopoverContext.Provider value={popover}>\n      {children}\n    </PopoverContext.Provider>\n  );\n};\n\ntype PopoverTriggerProps = {\n  /** The content of the trigger */\n  children: React.ReactNode;\n  /** Whether the trigger should render a button element, or pass its props to the child element */\n  hasButtonWrapper?: boolean;\n};\n\nconst PopoverTrigger = ({\n  children,\n  hasButtonWrapper = false,\n  ref,\n  ...props\n}: CommonProps<'button', PopoverTriggerProps>) => {\n  const context = usePopoverContext();\n  // Example from floating UI\n  // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n  const childrenProps = (children as any).props;\n  const mergedRefs = useMergeRefs([\n    context.refs.setReference,\n    ref,\n    childrenProps?.ref,\n  ]);\n\n  // `hasButtonWrapper` allows the user to pass any element as the anchor\n  if (hasButtonWrapper && React.isValidElement(children)) {\n    return React.cloneElement(\n      children,\n      context.getReferenceProps({\n        ...props,\n        ...childrenProps,\n        'data-state': context.isOpen ? 'open' : 'closed',\n        ref: mergedRefs,\n      }),\n    );\n  }\n  return (\n    <button\n      ref={context.refs.setReference}\n      type=\"button\"\n      data-state={context.isOpen ? 'open' : 'closed'}\n      {...context.getReferenceProps(props)}\n    >\n      {children}\n    </button>\n  );\n};\n\ntype PopoverAnchorProps = {\n  children?: React.ReactNode;\n};\n\n/**\n * Use this to separate the anchor visually from the trigger.\n */\nconst PopoverAnchor = ({\n  children,\n  ref,\n  ...props\n}: CommonProps<'div', PopoverAnchorProps>) => {\n  const context = usePopoverContext();\n\n  // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n  const childrenProps = (children as any)?.props;\n  const mergedRefs = useMergeRefs([\n    context.refs.setPositionReference,\n    ref,\n    childrenProps?.ref,\n  ]);\n\n  if (React.isValidElement(children)) {\n    return React.cloneElement(children, {\n      ...props,\n      ...childrenProps,\n      ref: mergedRefs,\n    });\n  }\n\n  return (\n    <div ref={mergedRefs} {...props}>\n      {children}\n    </div>\n  );\n};\n\ntype PopoverContentProps = {\n  children: React.ReactNode;\n  className?: string;\n  style?: React.CSSProperties;\n};\n\nconst PopoverContent = <T extends React.ElementType = 'div'>({\n  as,\n  className,\n  style,\n  children,\n  htmlAttributes,\n  ref,\n  ...restProps\n}: PolymorphicCommonProps<T, PopoverContentProps>) => {\n  const { context: floatingContext, ...context } = usePopoverContext();\n\n  const refs = useMergeRefs([context.refs.setFloating, ref]);\n\n  const { themeClassName } = useNeedleTheme();\n\n  const classes = classNames('ndl-popover', themeClassName, className);\n  const Component: React.ElementType = as ?? 'div';\n\n  // Patch to not get axe errors for the focus guards\n  // To be noted is that axe gives us a false positive error here since the focus guards directly pass focus to other elements\n  // https://github.com/floating-ui/floating-ui/issues/2462\n  usePatchFloatingFocusGuards();\n\n  if (!floatingContext.open) {\n    return null;\n  }\n\n  return (\n    <ConditionalWrap\n      shouldWrap={context.isPortaled}\n      wrap={(wrapChildren) => (\n        <FloatingPortal\n          root={\n            (context.anchorElementAsPortalAnchor ?? false)\n              ? (context.refs.reference.current as HTMLElement | null)\n              : undefined\n          }\n        >\n          {wrapChildren}\n        </FloatingPortal>\n      )}\n    >\n      <FloatingFocusManager\n        context={floatingContext}\n        modal={context.shouldCaptureFocus}\n        initialFocus={context.initialFocus}\n        closeOnFocusOut={context.shouldCloseOnFocusOut}\n      >\n        <Component\n          className={classes}\n          aria-labelledby={context.labelId}\n          aria-describedby={context.descriptionId}\n          style={{\n            ...context.floatingStyles,\n            ...context.transitionStyles,\n            ...style,\n          }}\n          ref={refs}\n          {...context.getFloatingProps({ ...htmlAttributes })}\n          {...restProps}\n        >\n          {children}\n        </Component>\n      </FloatingFocusManager>\n    </ConditionalWrap>\n  );\n};\n\nconst Popover = Object.assign(PopoverComponent, {\n  Anchor: PopoverAnchor,\n  Content: PopoverContent,\n  Trigger: PopoverTrigger,\n});\n\nexport { Popover };\n"]}

package/lib/esm/popover/use-popover.js

@@ -21,7 +21,7 @@
 import { autoUpdate, flip, offset, shift, size, useClick, useClientPoint, useDismiss, useFloating, useInteractions, useRole, useTransitionStyles, } from '@floating-ui/react';
 import { tokens } from '@neo4j-ndl/base';
 import { useMemo, useState } from 'react';
-export function usePopover({ isInitialOpen = false, placement = 'bottom', isOpen: controlledOpen, onOpenChange: setControlledOpen, offsetOption = 10, anchorElement, anchorPosition, anchorElementAsPortalAnchor, shouldCaptureFocus, initialFocus, role: roleProp, closeOnClickOutside, closeOnReferencePress, returnFocus, strategy = 'absolute', isPortaled = true, shouldConstrainSize = false, } = {}) {
+export function usePopover({ isInitialOpen = false, placement = 'bottom', isOpen: controlledOpen, onOpenChange: setControlledOpen, offsetOption = 10, anchorElement, anchorPosition, anchorElementAsPortalAnchor, shouldCaptureFocus, initialFocus, role: roleProp, closeOnClickOutside, closeOnReferencePress, shouldCloseOnFocusOut, returnFocus, strategy = 'absolute', isPortaled = true, shouldConstrainSize = false, } = {}) {
     var _a;
     // Internal state for uncontrolled mode (no `isOpen` prop provided).
     const [isOpenUncontrolled, setIsOpenUncontrolled] = useState(isInitialOpen);
@@ -102,6 +102,7 @@ export function usePopover({ isInitialOpen = false, placement = 'bottom', isOpen
         setDescriptionId,
         setLabelId,
         shouldCaptureFocus,
+        shouldCloseOnFocusOut,
         transitionStyles })), [
         isOpen,
         interactions,
@@ -111,6 +112,7 @@ export function usePopover({ isInitialOpen = false, placement = 'bottom', isOpen
         descriptionId,
         anchorElementAsPortalAnchor,
         shouldCaptureFocus,
+        shouldCloseOnFocusOut,
         initialFocus,
         isPortaled,
         returnFocus,

package/lib/esm/popover/use-popover.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-popover.js","sourceRoot":"","sources":["../../../src/popover/use-popover.tsx"],"names":[],"mappings":"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","sourcesContent":["/*!\n *\n *  Copyright (c) \"Neo4j\"\n *  Neo4j Sweden AB [http://neo4j.com]\n *\n *  This file is part of Neo4j.\n *\n *  Neo4j is free software: you can redistribute it and/or modify\n *  it under the terms of the GNU General Public License as published by\n *  the Free Software Foundation, either version 3 of the License, or\n *  (at your option) any later version.\n *\n *  This program is distributed in the hope that it will be useful,\n *  but WITHOUT ANY WARRANTY; without even the implied warranty of\n *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the\n *  GNU General Public License for more details.\n *\n *  You should have received a copy of the GNU General Public License\n *  along with this program.  If not, see <http://www.gnu.org/licenses/>.\n */\nimport {\n  autoUpdate,\n  flip,\n  type FloatingFocusManagerProps,\n  offset,\n  type OffsetOptions,\n  type Placement,\n  shift,\n  size,\n  useClick,\n  useClientPoint,\n  useDismiss,\n  useFloating,\n  useInteractions,\n  type UseInteractionsReturn,\n  useRole,\n  useTransitionStyles,\n} from '@floating-ui/react';\nimport { tokens } from '@neo4j-ndl/base';\nimport { useMemo, useState } from 'react';\n\nexport interface PopoverOptions {\n  isInitialOpen?: boolean;\n  placement?: Placement;\n  isOpen?: boolean;\n  onOpenChange?: (open: boolean, event?: Event) => void;\n  offsetOption?: OffsetOptions;\n  anchorElement?: Element | null;\n  anchorPosition?: {\n    // TODO v5: create componentProps type for this\n    // oxlint-disable-next-line id-length\n    x: number;\n    // TODO v5: create componentProps type for this\n    // oxlint-disable-next-line id-length\n    y: number;\n  };\n  // TODO v5: fix boolean naming convention\n  // eslint-disable-next-line @typescript-eslint/naming-convention\n  anchorElementAsPortalAnchor?: boolean;\n  shouldCaptureFocus?: boolean;\n  initialFocus?: number | React.RefObject<HTMLElement | null>;\n  role?:\n    | 'tooltip'\n    | 'dialog'\n    | 'alertdialog'\n    | 'menu'\n    | 'listbox'\n    | 'grid'\n    | 'tree';\n  // TODO v5: decide if this naming is okay, or change it\n  // eslint-disable-next-line @typescript-eslint/naming-convention\n  closeOnClickOutside?: boolean;\n  // TODO v5: decide if this naming is okay, or change it\n  // eslint-disable-next-line @typescript-eslint/naming-convention\n  closeOnReferencePress?: boolean;\n  returnFocus?: FloatingFocusManagerProps['returnFocus'];\n  strategy?: 'fixed' | 'absolute';\n  isPortaled?: boolean;\n  shouldConstrainSize?: boolean;\n}\n\nexport interface UsePopoverReturn\n  extends UseInteractionsReturn, ReturnType<typeof useFloating> {\n  isOpen: boolean;\n  labelId: string | undefined;\n  descriptionId: string | undefined;\n  transitionStyles: React.CSSProperties;\n  setLabelId: (labelId: string | undefined) => void;\n  setDescriptionId: (descriptionId: string | undefined) => void;\n  // TODO v5: fix boolean naming convention\n  // eslint-disable-next-line @typescript-eslint/naming-convention\n  anchorElementAsPortalAnchor: boolean | undefined;\n  shouldCaptureFocus: boolean | undefined;\n  initialFocus: number | React.RefObject<HTMLElement | null> | undefined;\n  isPortaled: boolean;\n  returnFocus: FloatingFocusManagerProps['returnFocus'];\n}\n\nexport function usePopover({\n  isInitialOpen = false,\n  placement = 'bottom',\n  isOpen: controlledOpen,\n  onOpenChange: setControlledOpen,\n  offsetOption = 10,\n  anchorElement,\n  anchorPosition,\n  anchorElementAsPortalAnchor,\n  shouldCaptureFocus,\n  initialFocus,\n  role: roleProp,\n  closeOnClickOutside,\n  closeOnReferencePress,\n  returnFocus,\n  strategy = 'absolute',\n  isPortaled = true,\n  shouldConstrainSize = false,\n}: PopoverOptions = {}): UsePopoverReturn {\n  // Internal state for uncontrolled mode (no `isOpen` prop provided).\n  const [isOpenUncontrolled, setIsOpenUncontrolled] = useState(isInitialOpen);\n  const [labelId, setLabelId] = useState<string | undefined>();\n  const [descriptionId, setDescriptionId] = useState<string | undefined>();\n\n  // Controlled/uncontrolled pattern: prefer the consumer-provided `isOpen`,\n  // falling back to internal state when not provided.\n  const isOpen = controlledOpen ?? isOpenUncontrolled;\n\n  const data = useFloating({\n    elements: {\n      reference: anchorElement,\n    },\n    middleware: [\n      offset(offsetOption),\n      flip({\n        crossAxis: placement.includes('-'),\n        fallbackAxisSideDirection: 'end',\n        padding: 5,\n      }),\n      shift(),\n      ...(shouldConstrainSize\n        ? [\n            size({\n              apply({ availableHeight, availableWidth, elements }) {\n                Object.assign(elements.floating.style, {\n                  maxHeight: `${availableHeight}px`,\n                  maxWidth: `${availableWidth}px`,\n                });\n              },\n              padding: 5,\n            }),\n          ]\n        : []),\n    ],\n    // Floating UI calls this when interactions (useClick, useDismiss, etc.)\n    // trigger an open/close. We always sync internal state so uncontrolled\n    // mode works, and notify the consumer callback exactly once if provided.\n    onOpenChange: (open, event) => {\n      setIsOpenUncontrolled(open);\n      setControlledOpen?.(open, event);\n    },\n    open: isOpen,\n    placement: placement,\n    strategy,\n    whileElementsMounted: autoUpdate,\n  });\n  const context = data.context;\n\n  // Only enable built-in click-to-toggle in uncontrolled mode. In controlled\n  // mode the consumer owns the open state and wires up their own trigger.\n  const click = useClick(context, {\n    enabled: controlledOpen === undefined,\n  });\n\n  const dismiss = useDismiss(context, {\n    outsidePress: closeOnClickOutside,\n    referencePress: closeOnReferencePress,\n  });\n  const role = useRole(context, {\n    role: roleProp,\n  });\n\n  const clientPoint = useClientPoint(context, {\n    enabled: anchorPosition !== undefined,\n    // oxlint-disable-next-line id-length\n    x: anchorPosition?.x,\n    // oxlint-disable-next-line id-length\n    y: anchorPosition?.y,\n  });\n\n  const interactions = useInteractions([click, dismiss, role, clientPoint]);\n\n  const { styles: transitionStyles } = useTransitionStyles(context, {\n    duration: Number.parseInt(tokens.motion.duration.quick) ?? 0,\n  });\n\n  return useMemo(\n    () => ({\n      ...data,\n      ...interactions,\n      anchorElementAsPortalAnchor,\n      descriptionId,\n      initialFocus,\n      isOpen,\n      isPortaled,\n      labelId,\n      returnFocus,\n      setDescriptionId,\n      setLabelId,\n      shouldCaptureFocus,\n      transitionStyles,\n    }),\n    [\n      isOpen,\n      interactions,\n      data,\n      transitionStyles,\n      labelId,\n      descriptionId,\n      anchorElementAsPortalAnchor,\n      shouldCaptureFocus,\n      initialFocus,\n      isPortaled,\n      returnFocus,\n    ],\n  );\n}\n"]}
+{"version":3,"file":"use-popover.js","sourceRoot":"","sources":["../../../src/popover/use-popover.tsx"],"names":[],"mappings":"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","sourcesContent":["/*!\n *\n *  Copyright (c) \"Neo4j\"\n *  Neo4j Sweden AB [http://neo4j.com]\n *\n *  This file is part of Neo4j.\n *\n *  Neo4j is free software: you can redistribute it and/or modify\n *  it under the terms of the GNU General Public License as published by\n *  the Free Software Foundation, either version 3 of the License, or\n *  (at your option) any later version.\n *\n *  This program is distributed in the hope that it will be useful,\n *  but WITHOUT ANY WARRANTY; without even the implied warranty of\n *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the\n *  GNU General Public License for more details.\n *\n *  You should have received a copy of the GNU General Public License\n *  along with this program.  If not, see <http://www.gnu.org/licenses/>.\n */\nimport {\n  autoUpdate,\n  flip,\n  type FloatingFocusManagerProps,\n  offset,\n  type OffsetOptions,\n  type Placement,\n  shift,\n  size,\n  useClick,\n  useClientPoint,\n  useDismiss,\n  useFloating,\n  useInteractions,\n  type UseInteractionsReturn,\n  useRole,\n  useTransitionStyles,\n} from '@floating-ui/react';\nimport { tokens } from '@neo4j-ndl/base';\nimport { useMemo, useState } from 'react';\n\nexport interface PopoverOptions {\n  isInitialOpen?: boolean;\n  placement?: Placement;\n  isOpen?: boolean;\n  onOpenChange?: (open: boolean, event?: Event) => void;\n  offsetOption?: OffsetOptions;\n  anchorElement?: Element | null;\n  anchorPosition?: {\n    // TODO v5: create componentProps type for this\n    // oxlint-disable-next-line id-length\n    x: number;\n    // TODO v5: create componentProps type for this\n    // oxlint-disable-next-line id-length\n    y: number;\n  };\n  // TODO v5: fix boolean naming convention\n  // eslint-disable-next-line @typescript-eslint/naming-convention\n  anchorElementAsPortalAnchor?: boolean;\n  shouldCaptureFocus?: boolean;\n  initialFocus?: number | React.RefObject<HTMLElement | null>;\n  role?:\n    | 'tooltip'\n    | 'dialog'\n    | 'alertdialog'\n    | 'menu'\n    | 'listbox'\n    | 'grid'\n    | 'tree';\n  // TODO v5: decide if this naming is okay, or change it\n  // eslint-disable-next-line @typescript-eslint/naming-convention\n  closeOnClickOutside?: boolean;\n  // TODO v5: decide if this naming is okay, or change it\n  // eslint-disable-next-line @typescript-eslint/naming-convention\n  closeOnReferencePress?: boolean;\n  shouldCloseOnFocusOut?: boolean;\n  returnFocus?: FloatingFocusManagerProps['returnFocus'];\n  strategy?: 'fixed' | 'absolute';\n  isPortaled?: boolean;\n  shouldConstrainSize?: boolean;\n}\n\nexport interface UsePopoverReturn\n  extends UseInteractionsReturn, ReturnType<typeof useFloating> {\n  isOpen: boolean;\n  labelId: string | undefined;\n  descriptionId: string | undefined;\n  transitionStyles: React.CSSProperties;\n  setLabelId: (labelId: string | undefined) => void;\n  setDescriptionId: (descriptionId: string | undefined) => void;\n  // TODO v5: fix boolean naming convention\n  // eslint-disable-next-line @typescript-eslint/naming-convention\n  anchorElementAsPortalAnchor: boolean | undefined;\n  shouldCaptureFocus: boolean | undefined;\n  shouldCloseOnFocusOut: boolean | undefined;\n  initialFocus: number | React.RefObject<HTMLElement | null> | undefined;\n  isPortaled: boolean;\n  returnFocus: FloatingFocusManagerProps['returnFocus'];\n}\n\nexport function usePopover({\n  isInitialOpen = false,\n  placement = 'bottom',\n  isOpen: controlledOpen,\n  onOpenChange: setControlledOpen,\n  offsetOption = 10,\n  anchorElement,\n  anchorPosition,\n  anchorElementAsPortalAnchor,\n  shouldCaptureFocus,\n  initialFocus,\n  role: roleProp,\n  closeOnClickOutside,\n  closeOnReferencePress,\n  shouldCloseOnFocusOut,\n  returnFocus,\n  strategy = 'absolute',\n  isPortaled = true,\n  shouldConstrainSize = false,\n}: PopoverOptions = {}): UsePopoverReturn {\n  // Internal state for uncontrolled mode (no `isOpen` prop provided).\n  const [isOpenUncontrolled, setIsOpenUncontrolled] = useState(isInitialOpen);\n  const [labelId, setLabelId] = useState<string | undefined>();\n  const [descriptionId, setDescriptionId] = useState<string | undefined>();\n\n  // Controlled/uncontrolled pattern: prefer the consumer-provided `isOpen`,\n  // falling back to internal state when not provided.\n  const isOpen = controlledOpen ?? isOpenUncontrolled;\n\n  const data = useFloating({\n    elements: {\n      reference: anchorElement,\n    },\n    middleware: [\n      offset(offsetOption),\n      flip({\n        crossAxis: placement.includes('-'),\n        fallbackAxisSideDirection: 'end',\n        padding: 5,\n      }),\n      shift(),\n      ...(shouldConstrainSize\n        ? [\n            size({\n              apply({ availableHeight, availableWidth, elements }) {\n                Object.assign(elements.floating.style, {\n                  maxHeight: `${availableHeight}px`,\n                  maxWidth: `${availableWidth}px`,\n                });\n              },\n              padding: 5,\n            }),\n          ]\n        : []),\n    ],\n    // Floating UI calls this when interactions (useClick, useDismiss, etc.)\n    // trigger an open/close. We always sync internal state so uncontrolled\n    // mode works, and notify the consumer callback exactly once if provided.\n    onOpenChange: (open, event) => {\n      setIsOpenUncontrolled(open);\n      setControlledOpen?.(open, event);\n    },\n    open: isOpen,\n    placement: placement,\n    strategy,\n    whileElementsMounted: autoUpdate,\n  });\n  const context = data.context;\n\n  // Only enable built-in click-to-toggle in uncontrolled mode. In controlled\n  // mode the consumer owns the open state and wires up their own trigger.\n  const click = useClick(context, {\n    enabled: controlledOpen === undefined,\n  });\n\n  const dismiss = useDismiss(context, {\n    outsidePress: closeOnClickOutside,\n    referencePress: closeOnReferencePress,\n  });\n  const role = useRole(context, {\n    role: roleProp,\n  });\n\n  const clientPoint = useClientPoint(context, {\n    enabled: anchorPosition !== undefined,\n    // oxlint-disable-next-line id-length\n    x: anchorPosition?.x,\n    // oxlint-disable-next-line id-length\n    y: anchorPosition?.y,\n  });\n\n  const interactions = useInteractions([click, dismiss, role, clientPoint]);\n\n  const { styles: transitionStyles } = useTransitionStyles(context, {\n    duration: Number.parseInt(tokens.motion.duration.quick) ?? 0,\n  });\n\n  return useMemo(\n    () => ({\n      ...data,\n      ...interactions,\n      anchorElementAsPortalAnchor,\n      descriptionId,\n      initialFocus,\n      isOpen,\n      isPortaled,\n      labelId,\n      returnFocus,\n      setDescriptionId,\n      setLabelId,\n      shouldCaptureFocus,\n      shouldCloseOnFocusOut,\n      transitionStyles,\n    }),\n    [\n      isOpen,\n      interactions,\n      data,\n      transitionStyles,\n      labelId,\n      descriptionId,\n      anchorElementAsPortalAnchor,\n      shouldCaptureFocus,\n      shouldCloseOnFocusOut,\n      initialFocus,\n      isPortaled,\n      returnFocus,\n    ],\n  );\n}\n"]}

package/lib/types/popover/Popover.d.ts

@@ -56,6 +56,12 @@ type PopoverProps = {
     role?: 'tooltip' | 'dialog' | 'alertdialog' | 'menu' | 'listbox' | 'grid' | 'tree';
     /** If the popover should close when the user clicks outside of it */
     closeOnClickOutside?: boolean;
+    /**
+     * If the popover should close when focus moves outside of it, for example when tabbing away or focusing another element.
+     * Defaults to the value of `closeOnClickOutside`.
+     * Has no effect when `shouldCaptureFocus` is true, since focus cannot leave the popover.
+     */
+    shouldCloseOnFocusOut?: boolean;
     /** The strategy of the popover. Fixed should be used when the popover is inside a Dialog. */
     strategy?: 'fixed' | 'absolute';
     /** Whether the content is rendered in a portal */
@@ -81,7 +87,7 @@ type PopoverContentProps = {
     className?: string;
     style?: React.CSSProperties;
 };
-declare const Popover: (({ children, anchorElement, placement, isOpen, offset, anchorPosition, hasAnchorPortal: hasAnchorPortalProp, shouldCaptureFocus, initialFocus, onOpenChange, role, closeOnClickOutside, isPortaled: isPortaledProp, strategy: strategyProp, shouldConstrainSize, }: PopoverProps) => import("react/jsx-runtime").JSX.Element) & {
+declare const Popover: (({ children, anchorElement, placement, isOpen, offset, anchorPosition, hasAnchorPortal: hasAnchorPortalProp, shouldCaptureFocus, initialFocus, onOpenChange, role, closeOnClickOutside, shouldCloseOnFocusOut, isPortaled: isPortaledProp, strategy: strategyProp, shouldConstrainSize, }: PopoverProps) => import("react/jsx-runtime").JSX.Element) & {
     Anchor: ({ children, ref, ...props }: CommonProps<"div", PopoverAnchorProps>) => import("react/jsx-runtime").JSX.Element;
     Content: <T extends React.ElementType = "div">({ as, className, style, children, htmlAttributes, ref, ...restProps }: PolymorphicCommonProps<T, PopoverContentProps>) => import("react/jsx-runtime").JSX.Element | null;
     Trigger: ({ children, hasButtonWrapper, ref, ...props }: CommonProps<"button", PopoverTriggerProps>) => import("react/jsx-runtime").JSX.Element;

package/lib/types/popover/Popover.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Popover.d.ts","sourceRoot":"","sources":["../../../src/popover/Popover.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,EAGL,KAAK,aAAa,EAClB,KAAK,SAAS,EAEf,MAAM,oBAAoB,CAAC;AAE5B,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,EACL,KAAK,WAAW,EAChB,KAAK,sBAAsB,EAC5B,MAAM,kBAAkB,CAAC;AAO1B,KAAK,gBAAgB,GACjB,oBAAoB,GACpB,wBAAwB,GACxB,0BAA0B,GAC1B,oBAAoB,GACpB,wBAAwB,GACxB,0BAA0B,GAC1B,yBAAyB,GACzB,mBAAmB,GACnB,yBAAyB,GACzB,yBAAyB,GACzB,mBAAmB,GACnB,yBAAyB,CAAC;AAE9B,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,gBAAgB,EAAE,SAAS,CAapE,CAAC;AACF,KAAK,YAAY,GAAG;IAClB,6BAA6B;IAC7B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,iCAAiC;IACjC,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAC/B,0EAA0E;IAC1E,cAAc,CAAC,EAAE;QAGf,CAAC,EAAE,MAAM,CAAC;QAGV,CAAC,EAAE,MAAM,CAAC;KACX,CAAC;IACF,gTAAgT;IAChT,SAAS,CAAC,EAAE,gBAAgB,CAAC;IAC7B,yHAAyH;IACzH,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,sKAAsK;IACtK,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,KAAK,KAAK,IAAI,CAAC;IACxD,yHAAyH;IACzH,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,8EAA8E;IAC9E,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,wCAAwC;IACxC,YAAY,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IAE5D;;OAEG;IACH,IAAI,CAAC,EACD,SAAS,GACT,QAAQ,GACR,aAAa,GACb,MAAM,GACN,SAAS,GACT,MAAM,GACN,MAAM,CAAC;IACX,qEAAqE;IAGrE,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,6FAA6F;IAC7F,QAAQ,CAAC,EAAE,OAAO,GAAG,UAAU,CAAC;IAChC,kDAAkD;IAClD,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;SAGK;IACL,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B,CAAC;AAMF,eAAO,MAAM,iBAAiB,gDAQ7B,CAAC;AAiDF,KAAK,mBAAmB,GAAG;IACzB,iCAAiC;IACjC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,iGAAiG;IACjG,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B,CAAC;AA0CF,KAAK,kBAAkB,GAAG;IACxB,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CAC5B,CAAC;AAmCF,KAAK,mBAAmB,GAAG;IACzB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;CAC7B,CAAC;AAqEF,QAAA,MAAM,OAAO,uQA5LV,YAAY;0CAyFZ,WAAW,CAAC,KAAK,EAAE,kBAAkB,CAAC;cAgCjB,CAAC,SAAS,KAAK,CAAC,WAAW,iFAQhD,sBAAsB,CAAC,CAAC,EAAE,mBAAmB,CAAC;6DAtF9C,WAAW,CAAC,QAAQ,EAAE,mBAAmB,CAAC;CAqJ3C,CAAC;AAEH,OAAO,EAAE,OAAO,EAAE,CAAC"}
+{"version":3,"file":"Popover.d.ts","sourceRoot":"","sources":["../../../src/popover/Popover.tsx"],"names":[],"mappings":"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"}

package/lib/types/popover/use-popover.d.ts

@@ -36,6 +36,7 @@ export interface PopoverOptions {
     role?: 'tooltip' | 'dialog' | 'alertdialog' | 'menu' | 'listbox' | 'grid' | 'tree';
     closeOnClickOutside?: boolean;
     closeOnReferencePress?: boolean;
+    shouldCloseOnFocusOut?: boolean;
     returnFocus?: FloatingFocusManagerProps['returnFocus'];
     strategy?: 'fixed' | 'absolute';
     isPortaled?: boolean;
@@ -50,9 +51,10 @@ export interface UsePopoverReturn extends UseInteractionsReturn, ReturnType<type
     setDescriptionId: (descriptionId: string | undefined) => void;
     anchorElementAsPortalAnchor: boolean | undefined;
     shouldCaptureFocus: boolean | undefined;
+    shouldCloseOnFocusOut: boolean | undefined;
     initialFocus: number | React.RefObject<HTMLElement | null> | undefined;
     isPortaled: boolean;
     returnFocus: FloatingFocusManagerProps['returnFocus'];
 }
-export declare function usePopover({ isInitialOpen, placement, isOpen: controlledOpen, onOpenChange: setControlledOpen, offsetOption, anchorElement, anchorPosition, anchorElementAsPortalAnchor, shouldCaptureFocus, initialFocus, role: roleProp, closeOnClickOutside, closeOnReferencePress, returnFocus, strategy, isPortaled, shouldConstrainSize, }?: PopoverOptions): UsePopoverReturn;
+export declare function usePopover({ isInitialOpen, placement, isOpen: controlledOpen, onOpenChange: setControlledOpen, offsetOption, anchorElement, anchorPosition, anchorElementAsPortalAnchor, shouldCaptureFocus, initialFocus, role: roleProp, closeOnClickOutside, closeOnReferencePress, shouldCloseOnFocusOut, returnFocus, strategy, isPortaled, shouldConstrainSize, }?: PopoverOptions): UsePopoverReturn;
 //# sourceMappingURL=use-popover.d.ts.map

package/lib/types/popover/use-popover.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-popover.d.ts","sourceRoot":"","sources":["../../../src/popover/use-popover.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,EAGL,KAAK,yBAAyB,EAE9B,KAAK,aAAa,EAClB,KAAK,SAAS,EAMd,WAAW,EAEX,KAAK,qBAAqB,EAG3B,MAAM,oBAAoB,CAAC;AAI5B,MAAM,WAAW,cAAc;IAC7B,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,KAAK,KAAK,IAAI,CAAC;IACtD,YAAY,CAAC,EAAE,aAAa,CAAC;IAC7B,aAAa,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAC/B,cAAc,CAAC,EAAE;QAGf,CAAC,EAAE,MAAM,CAAC;QAGV,CAAC,EAAE,MAAM,CAAC;KACX,CAAC;IAGF,2BAA2B,CAAC,EAAE,OAAO,CAAC;IACtC,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,YAAY,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IAC5D,IAAI,CAAC,EACD,SAAS,GACT,QAAQ,GACR,aAAa,GACb,MAAM,GACN,SAAS,GACT,MAAM,GACN,MAAM,CAAC;IAGX,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAG9B,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,WAAW,CAAC,EAAE,yBAAyB,CAAC,aAAa,CAAC,CAAC;IACvD,QAAQ,CAAC,EAAE,OAAO,GAAG,UAAU,CAAC;IAChC,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B;AAED,MAAM,WAAW,gBACf,SAAQ,qBAAqB,EAAE,UAAU,CAAC,OAAO,WAAW,CAAC;IAC7D,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,aAAa,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,gBAAgB,EAAE,KAAK,CAAC,aAAa,CAAC;IACtC,UAAU,EAAE,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,KAAK,IAAI,CAAC;IAClD,gBAAgB,EAAE,CAAC,aAAa,EAAE,MAAM,GAAG,SAAS,KAAK,IAAI,CAAC;IAG9D,2BAA2B,EAAE,OAAO,GAAG,SAAS,CAAC;IACjD,kBAAkB,EAAE,OAAO,GAAG,SAAS,CAAC;IACxC,YAAY,EAAE,MAAM,GAAG,KAAK,CAAC,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,GAAG,SAAS,CAAC;IACvE,UAAU,EAAE,OAAO,CAAC;IACpB,WAAW,EAAE,yBAAyB,CAAC,aAAa,CAAC,CAAC;CACvD;AAED,wBAAgB,UAAU,CAAC,EACzB,aAAqB,EACrB,SAAoB,EACpB,MAAM,EAAE,cAAc,EACtB,YAAY,EAAE,iBAAiB,EAC/B,YAAiB,EACjB,aAAa,EACb,cAAc,EACd,2BAA2B,EAC3B,kBAAkB,EAClB,YAAY,EACZ,IAAI,EAAE,QAAQ,EACd,mBAAmB,EACnB,qBAAqB,EACrB,WAAW,EACX,QAAqB,EACrB,UAAiB,EACjB,mBAA2B,GAC5B,GAAE,cAAmB,GAAG,gBAAgB,CA4GxC"}
+{"version":3,"file":"use-popover.d.ts","sourceRoot":"","sources":["../../../src/popover/use-popover.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,EAGL,KAAK,yBAAyB,EAE9B,KAAK,aAAa,EAClB,KAAK,SAAS,EAMd,WAAW,EAEX,KAAK,qBAAqB,EAG3B,MAAM,oBAAoB,CAAC;AAI5B,MAAM,WAAW,cAAc;IAC7B,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,KAAK,KAAK,IAAI,CAAC;IACtD,YAAY,CAAC,EAAE,aAAa,CAAC;IAC7B,aAAa,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAC/B,cAAc,CAAC,EAAE;QAGf,CAAC,EAAE,MAAM,CAAC;QAGV,CAAC,EAAE,MAAM,CAAC;KACX,CAAC;IAGF,2BAA2B,CAAC,EAAE,OAAO,CAAC;IACtC,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,YAAY,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IAC5D,IAAI,CAAC,EACD,SAAS,GACT,QAAQ,GACR,aAAa,GACb,MAAM,GACN,SAAS,GACT,MAAM,GACN,MAAM,CAAC;IAGX,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAG9B,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,WAAW,CAAC,EAAE,yBAAyB,CAAC,aAAa,CAAC,CAAC;IACvD,QAAQ,CAAC,EAAE,OAAO,GAAG,UAAU,CAAC;IAChC,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B;AAED,MAAM,WAAW,gBACf,SAAQ,qBAAqB,EAAE,UAAU,CAAC,OAAO,WAAW,CAAC;IAC7D,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,aAAa,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,gBAAgB,EAAE,KAAK,CAAC,aAAa,CAAC;IACtC,UAAU,EAAE,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,KAAK,IAAI,CAAC;IAClD,gBAAgB,EAAE,CAAC,aAAa,EAAE,MAAM,GAAG,SAAS,KAAK,IAAI,CAAC;IAG9D,2BAA2B,EAAE,OAAO,GAAG,SAAS,CAAC;IACjD,kBAAkB,EAAE,OAAO,GAAG,SAAS,CAAC;IACxC,qBAAqB,EAAE,OAAO,GAAG,SAAS,CAAC;IAC3C,YAAY,EAAE,MAAM,GAAG,KAAK,CAAC,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,GAAG,SAAS,CAAC;IACvE,UAAU,EAAE,OAAO,CAAC;IACpB,WAAW,EAAE,yBAAyB,CAAC,aAAa,CAAC,CAAC;CACvD;AAED,wBAAgB,UAAU,CAAC,EACzB,aAAqB,EACrB,SAAoB,EACpB,MAAM,EAAE,cAAc,EACtB,YAAY,EAAE,iBAAiB,EAC/B,YAAiB,EACjB,aAAa,EACb,cAAc,EACd,2BAA2B,EAC3B,kBAAkB,EAClB,YAAY,EACZ,IAAI,EAAE,QAAQ,EACd,mBAAmB,EACnB,qBAAqB,EACrB,qBAAqB,EACrB,WAAW,EACX,QAAqB,EACrB,UAAiB,EACjB,mBAA2B,GAC5B,GAAE,cAAmB,GAAG,gBAAgB,CA8GxC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@neo4j-ndl/react",
-  "version": "4.24.0",
+  "version": "4.24.1",
   "sideEffects": false,
   "description": "React implementation of Neo4j Design System",
   "keywords": [

package/skills/ndl-react/SKILL.md

@@ -2,7 +2,7 @@
 name: ndl-react
 metadata:
   package: '@neo4j-ndl/react'
-  version: '4.24.0'
+  version: '4.24.1'
 description: >-
   Build and edit UI with the Neo4j Needle React design system
   (@neo4j-ndl/react). Use when adding, composing, or modifying Needle components
@@ -15,7 +15,7 @@ description: >-
 
 # Neo4j Needle (@neo4j-ndl/react)
 
-> 📌 Shipped with `@neo4j-ndl/react` v4.24.0. Once installed into your repo (e.g. via
+> 📌 Shipped with `@neo4j-ndl/react` v4.24.1. Once installed into your repo (e.g. via
 > `npx skills add`) this folder is detached from the package — the installed
 > package (TypeScript types in `node_modules/@neo4j-ndl/react`) is the source of
 > truth.

package/skills/ndl-react/components/popover.md

@@ -23,6 +23,7 @@ Import: `import { Popover } from '@neo4j-ndl/react'`
 | `placement` | `'bottom-end-bottom-start' \| 'bottom-end-top-end' \| 'bottom-middle-top-middle' \| 'bottom-start-bottom-end' \| 'bottom-start-top-start' \| 'middle-end-middle-start' \| 'middle-start-middle-end' \| 'top-end-bottom-end' \| 'top-end-top-start' \| 'top-middle-bottom-middle' \| 'top-start-bottom-start' \| 'top-start-top-end'` |  |  | The placement of the floating element is determined by two sets of words. The first set of words specifies the point on the anchor element where the floating element will be attached. The second set of coordinates specifies the point on the floating element that will attach to the anchor element. |
 | `role` | `'alertdialog' \| 'dialog' \| 'grid' \| 'listbox' \| 'menu' \| 'tooltip' \| 'tree'` |  |  | The role of the popover. @deprecated - This prop will be removed in v5. |
 | `shouldCaptureFocus` | `boolean` |  | `false` | If the popover should constrain the focus inside the popover while open |
+| `shouldCloseOnFocusOut` | `boolean` |  |  | If the popover should close when focus moves outside of it, for example when tabbing away or focusing another element. Defaults to the value of `closeOnClickOutside`. Has no effect when `shouldCaptureFocus` is true, since focus cannot leave the popover. |
 | `shouldConstrainSize` | `boolean` |  |  | When true, limits the popover's max-height and max-width to the available viewport space. The consumer is responsible for adding overflow handling (e.g. overflow-y: auto) to the content. |
 | `strategy` | `'absolute' \| 'fixed'` |  |  | The strategy of the popover. Fixed should be used when the popover is inside a Dialog. |
 
@@ -55,6 +56,8 @@ Import: `import { Popover } from '@neo4j-ndl/react'`
 
 When used with a toggle button, the button should have aria-expanded (true when open, false when closed), aria-haspopup set to the role of the popover, and aria-controls set to the id of the popover.
 
+By default, a popover that doesn't capture focus closes when focus moves outside of it. Setting `closeOnClickOutside` or `shouldCloseOnFocusOut` to false keeps it open while keyboard users tab through the rest of the page. Make sure it doesn't hide the focused element (WCAG 2.4.11), and give users a way to close it, for example with the Escape key or a close button.
+
 ## Examples
 
 ### Default