@atlaskit/dropdown-menu 16.8.9 → 16.8.11

package/dist/cjs/internal/components/group-title.js

@@ -17,7 +17,12 @@ var styles = {
 /**
  * __Group title__
  *
- * Used to visually represent the title for DropdownMenu groups
+ * Used to visually represent the title for DropdownMenu groups.
+ *
+ * Pre-existing a11y note: uses `role="menuitem"` with `aria-hidden="true"`.
+ * WAI-ARIA APG recommends `role="presentation"` for non-interactive group
+ * headings, with the group linked via `aria-labelledby`. Out of scope for
+ * the top-layer migration — this is legacy behavior.
  *
  * @internal
  */

package/dist/cjs/internal/use-arrow-navigation/index.js

@@ -0,0 +1,25 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+Object.defineProperty(exports, "getFirstFocusable", {
+  enumerable: true,
+  get: function get() {
+    return _focus.getFirstFocusable;
+  }
+});
+Object.defineProperty(exports, "isAtCurrentMenuLevel", {
+  enumerable: true,
+  get: function get() {
+    return _useArrowNavigation.isAtCurrentMenuLevel;
+  }
+});
+Object.defineProperty(exports, "useArrowNavigation", {
+  enumerable: true,
+  get: function get() {
+    return _useArrowNavigation.useArrowNavigation;
+  }
+});
+var _useArrowNavigation = require("./use-arrow-navigation");
+var _focus = require("@atlaskit/top-layer/focus");

package/dist/cjs/internal/use-arrow-navigation/use-arrow-navigation.js

@@ -0,0 +1,18 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+Object.defineProperty(exports, "isAtCurrentMenuLevel", {
+  enumerable: true,
+  get: function get() {
+    return _useArrowNavigation.isAtCurrentMenuLevel;
+  }
+});
+Object.defineProperty(exports, "useArrowNavigation", {
+  enumerable: true,
+  get: function get() {
+    return _useArrowNavigation.useArrowNavigation;
+  }
+});
+var _useArrowNavigation = require("@atlaskit/top-layer/use-arrow-navigation");

package/dist/es2019/dropdown-menu-top-layer.compiled.css

@@ -0,0 +1,10 @@
+
+._2rkofajl{border-radius:var(--ds-radius-small,3px)}._16qs130s{box-shadow:var(--ds-shadow-overlay,0 8px 9pt #1e1f2126,0 0 1px #1e1f214f)}
+._1bah1h6o{justify-content:center}
+._1e0c1txw{display:flex}
+._1q51v47k{padding-block-start:var(--ds-space-250,20px)}
+._1ul91lit{min-width:10pc}
+._85i5v47k{padding-block-end:var(--ds-space-250,20px)}
+._bfhk1bhr{background-color:var(--ds-surface-overlay,#fff)}
+._bozgv47k{padding-inline-start:var(--ds-space-250,20px)}
+._y4tiv47k{padding-inline-end:var(--ds-space-250,20px)}

package/dist/es2019/dropdown-menu-top-layer.js

@@ -0,0 +1,323 @@
+/* dropdown-menu-top-layer.tsx generated by @compiled/babel-plugin v0.39.1 */
+import _extends from "@babel/runtime/helpers/extends";
+import "./dropdown-menu-top-layer.compiled.css";
+import * as React from 'react';
+import { ax, ix } from "@compiled/react/runtime";
+import { useCallback, useEffect, useMemo, useRef, useState } from 'react';
+import { bind } from 'bind-event-listener';
+import Button from '@atlaskit/button/new';
+import { KEY_DOWN, KEY_ENTER, KEY_SPACE } from '@atlaskit/ds-lib/keycodes';
+import mergeRefs from '@atlaskit/ds-lib/merge-refs';
+import noop from '@atlaskit/ds-lib/noop';
+import useControlledState from '@atlaskit/ds-lib/use-controlled';
+import useFocus from '@atlaskit/ds-lib/use-focus-event';
+import ExpandIcon from '@atlaskit/icon/core/chevron-down';
+import MenuGroup from '@atlaskit/menu/menu-group';
+import Spinner from '@atlaskit/spinner';
+import { slideAndFade } from '@atlaskit/top-layer/animations';
+import { fromLegacyPlacement } from '@atlaskit/top-layer/placement-map';
+import { Popup } from '@atlaskit/top-layer/popup';
+import SelectionStore from './internal/context/selection-store';
+import { getFirstFocusable, isAtCurrentMenuLevel, useArrowNavigation } from './internal/use-arrow-navigation';
+const MAX_HEIGHT = `calc(100vh - 16px)`;
+const styles = {
+  spinnerContainer: "_1e0c1txw _1ul91lit _1bah1h6o _1q51v47k _y4tiv47k _85i5v47k _bozgv47k",
+  menuContent: "_2rkofajl _bfhk1bhr _16qs130s"
+};
+const animation = slideAndFade();
+
+/**
+ * Event types produced by trigger interactions.
+ *
+ * - `React.MouseEvent<Element>` — from the trigger's `onClick` handler
+ * - `React.KeyboardEvent<Element>` — from the trigger's `onClick` when activated via keyboard
+ * - `KeyboardEvent` — native event from the ArrowDown `bind(window, ...)` listener
+ */
+
+/**
+ * Determines whether a trigger interaction was keyboard-initiated.
+ *
+ * Keyboard signals:
+ * - `type === 'keydown'` (native KeyboardEvent from ArrowDown handler)
+ * - `clientX/clientY === 0` (assistive technology click)
+ * - `detail === 0` (keyboard-activated click via Enter/Space)
+ */
+function isKeyboardTriggered(event) {
+  if (event.type === 'keydown') {
+    return true;
+  }
+  if ('clientX' in event && (event.clientX === 0 || event.clientY === 0)) {
+    return true;
+  }
+  if (event.detail === 0) {
+    return true;
+  }
+  return false;
+}
+
+/**
+ * Loading indicator for the dropdown menu.
+ */
+function LoadingIndicator({
+  statusLabel = 'Loading',
+  testId
+}) {
+  return /*#__PURE__*/React.createElement("div", {
+    role: "menuitem",
+    className: ax([styles.spinnerContainer])
+  }, /*#__PURE__*/React.createElement(Spinner, {
+    size: "small",
+    label: statusLabel,
+    testId: testId
+  }));
+}
+
+/**
+ * Top-layer implementation of DropdownMenu.
+ *
+ * Replaces the legacy `@atlaskit/popup` + `@atlaskit/portal` + `@atlaskit/layering` pipeline
+ * with native Popover API via `@atlaskit/top-layer`.
+ *
+ * What's no longer needed:
+ * - Portal: top layer handles stacking natively
+ * - FocusLock / react-focus-lock: popover=auto provides light dismiss
+ * - z-index: top layer is always above everything
+ * - FocusManager (ref registration): replaced by DOM-query-based `useArrowNavigation`
+ * - handle-focus.tsx: replaced by `useArrowNavigation`
+ * - Layering context: top layer nesting is handled by the browser
+ * - Fallback placements / Popper: CSS Anchor Positioning handles positioning
+ */
+function DropdownMenuTopLayer({
+  autoFocus = false,
+  children,
+  defaultOpen = false,
+  isLoading = false,
+  isOpen: isOpenProp,
+  onOpenChange = noop,
+  placement = 'bottom-start',
+  shouldFitContainer = false,
+  returnFocusRef,
+  spacing,
+  statusLabel,
+  testId,
+  trigger,
+  label,
+  interactionName,
+  menuLabel
+}) {
+  var _ref;
+  const [isLocalOpen, setLocalIsOpen] = useControlledState(isOpenProp, () => defaultOpen);
+  const triggerRef = useRef(null);
+  const menuRef = useRef(null);
+  const [isTriggeredUsingKeyboard, setTriggeredUsingKeyboard] = useState(false);
+  const topLayerPlacement = useMemo(() => fromLegacyPlacement({
+    legacy: placement
+  }), [placement]);
+
+  // ── Close handling ──
+  // Focus restoration is handled natively by the Popover API:
+  //   - Escape → browser restores focus to the trigger automatically
+  //   - Click-outside → browser does NOT restore (correct behavior)
+  //
+  // The only custom focus handling needed is `returnFocusRef`: when provided,
+  // we redirect focus to a different element than the trigger. We do this
+  // in the onClose callback via rAF, which runs after the browser's native
+  // restoration — effectively overriding it.
+  const handleOnClose = useCallback(({
+    reason: _reason
+  }) => {
+    if (returnFocusRef) {
+      requestAnimationFrame(() => {
+        var _returnFocusRef$curre;
+        (_returnFocusRef$curre = returnFocusRef.current) === null || _returnFocusRef$curre === void 0 ? void 0 : _returnFocusRef$curre.focus();
+      });
+    }
+    setLocalIsOpen(false);
+    onOpenChange({
+      isOpen: false,
+      event: null
+    });
+  }, [onOpenChange, returnFocusRef, setLocalIsOpen]);
+
+  // ── Trigger click handling ──
+  const handleTriggerClicked = useCallback(event => {
+    const newValue = !isLocalOpen;
+    setTriggeredUsingKeyboard(isKeyboardTriggered(event));
+    setLocalIsOpen(newValue);
+
+    // Extract the native DOM event for onOpenChange
+    const nativeEvent = 'nativeEvent' in event ? event.nativeEvent : event;
+    onOpenChange({
+      isOpen: newValue,
+      event: nativeEvent
+    });
+  }, [isLocalOpen, setLocalIsOpen, onOpenChange]);
+  const {
+    isFocused,
+    bindFocus
+  } = useFocus();
+
+  // When trigger is focused, open dropdown on ArrowDown (top-level only).
+  // Per WAI-ARIA, ArrowDown opens a menu from a menubar/button trigger,
+  // but inside a vertical submenu, ArrowDown navigates between siblings
+  // and ArrowRight opens nested menus instead.
+  useEffect(() => {
+    var _triggerRef$current;
+    if (!isFocused || isLocalOpen) {
+      return noop;
+    }
+
+    // Don't open on ArrowDown if this trigger is inside a parent menu.
+    // Nested menus should only be opened via ArrowRight or Enter.
+    const isNestedTrigger = ((_triggerRef$current = triggerRef.current) === null || _triggerRef$current === void 0 ? void 0 : _triggerRef$current.closest('[role="menu"]')) != null;
+    return bind(window, {
+      type: 'keydown',
+      listener: function openOnKeyDown(e) {
+        if (e.key === KEY_DOWN && !isNestedTrigger) {
+          e.preventDefault();
+          handleTriggerClicked(e);
+        } else if ((e.code === KEY_SPACE || e.key === KEY_ENTER) && e.detail === 0) {
+          setTriggeredUsingKeyboard(true);
+        }
+      }
+    });
+  }, [isFocused, isLocalOpen, handleTriggerClicked]);
+
+  // ── Arrow navigation ──
+  // useArrowNavigation handles ArrowUp/Down, Home/End, and Tab-to-close
+  // by querying focusable elements in the menu DOM container.
+  const handleArrowClose = useCallback(() => {
+    handleOnClose({
+      reason: 'escape'
+    });
+  }, [handleOnClose]);
+  const handleNestedOpen = useCallback(({
+    trigger
+  }) => {
+    trigger.click();
+  }, []);
+  const handleNestedClose = useCallback(() => {
+    handleOnClose({
+      reason: 'escape'
+    });
+  }, [handleOnClose]);
+  useArrowNavigation({
+    containerRef: menuRef,
+    onClose: handleArrowClose,
+    onNestedOpen: handleNestedOpen,
+    onNestedClose: handleNestedClose,
+    isEnabled: isLocalOpen,
+    filter: isAtCurrentMenuLevel
+  });
+
+  // ── Auto-focus first item on open ──
+  useEffect(() => {
+    if (!isLocalOpen || !isTriggeredUsingKeyboard && !autoFocus) {
+      return;
+    }
+    requestAnimationFrame(() => {
+      const menu = menuRef.current;
+      if (!menu) {
+        return;
+      }
+      const firstItem = getFirstFocusable({
+        container: menu
+      });
+      firstItem === null || firstItem === void 0 ? void 0 : firstItem.focus();
+    });
+  }, [isLocalOpen, isTriggeredUsingKeyboard, autoFocus]);
+
+  // shouldFitContainer is handled by the width prop on Popup.Content below.
+  const popupContentWidth = shouldFitContainer ? 'min-trigger' : 'content';
+
+  // ── Close on menu item click ──
+  // Close when a regular menuitem is clicked, but not checkboxes/radios
+  // and not nested triggers (items with aria-haspopup).
+  const handleMenuClick = useCallback(e => {
+    var _target$closest;
+    const target = e.target;
+    const menuItem = (_target$closest = target.closest) === null || _target$closest === void 0 ? void 0 : _target$closest.call(target, '[role="menuitem"], [role="menuitemcheckbox"], [role="menuitemradio"]');
+    if (!menuItem) {
+      return;
+    }
+    const isCheckboxOrRadio = menuItem.getAttribute('role') === 'menuitemcheckbox' || menuItem.getAttribute('role') === 'menuitemradio';
+    // Don't close the menu when clicking a nested trigger (aria-haspopup).
+    // The nested dropdown will handle its own open/close.
+    const isNestedTrigger = menuItem.hasAttribute('aria-haspopup');
+    if (!isCheckboxOrRadio && !isNestedTrigger) {
+      setLocalIsOpen(false);
+      onOpenChange({
+        isOpen: false,
+        event: e.nativeEvent
+      });
+    }
+  }, [setLocalIsOpen, onOpenChange]);
+  return /*#__PURE__*/React.createElement(SelectionStore, null, /*#__PURE__*/React.createElement(Popup, {
+    placement: topLayerPlacement,
+    onClose: handleOnClose
+  }, /*#__PURE__*/React.createElement(Popup.TriggerFunction, null, ({
+    ref,
+    toggle: _toggle,
+    ariaAttributes
+  }) => {
+    const combinedRef = mergeRefs([ref, triggerRef]);
+
+    // FUDGE(top-layer-api): cast `ariaAttributes` to the narrow shape that adopter
+    // public types expect. `@atlaskit/top-layer` types `aria-haspopup` as the wider
+    // WAI-ARIA union (boolean | 'dialog' | 'menu' | 'listbox' | 'tree' | 'grid'),
+    // but the public `CustomTriggerProps` (extending `@atlaskit/popup` `TriggerProps`)
+    // is intentionally kept narrow (boolean | 'dialog') because the top-layer API
+    // surface is not yet settled. The runtime value is unchanged; only the
+    // TypeScript-visible type is narrowed at this boundary.
+    // REMOVE WHEN: the top-layer public API is committed (see
+    // packages/design-system/top-layer/notes/decisions/migration-roadmap.md "Open API
+    // decisions deferred to a follow-up PR") and a follow-up `minor` PR widens
+    // `TriggerProps['aria-haspopup']` on `@atlaskit/popup` to match.
+    const narrowAriaAttributes = ariaAttributes;
+    if (typeof trigger === 'function') {
+      return trigger({
+        ...narrowAriaAttributes,
+        ...bindFocus,
+        triggerRef: combinedRef,
+        isSelected: isLocalOpen,
+        onClick: handleTriggerClicked,
+        testId: testId && `${testId}--trigger`
+      });
+    }
+    return /*#__PURE__*/React.createElement(Button, _extends({}, bindFocus, {
+      ref: combinedRef
+    }, narrowAriaAttributes, {
+      isSelected: isLocalOpen,
+      iconAfter: iconProps => /*#__PURE__*/React.createElement(ExpandIcon, _extends({}, iconProps, {
+        size: "small"
+      })),
+      onClick: handleTriggerClicked,
+      testId: testId && `${testId}--trigger`,
+      "aria-label": label,
+      interactionName: interactionName
+    }), trigger);
+  }), /*#__PURE__*/React.createElement(Popup.Content, {
+    role: "menu",
+    label: (_ref = menuLabel !== null && menuLabel !== void 0 ? menuLabel : label) !== null && _ref !== void 0 ? _ref : typeof trigger === 'string' ? trigger : 'Menu',
+    isOpen: isLocalOpen,
+    animate: animation,
+    width: popupContentWidth,
+    testId: testId && `${testId}--content`
+  }, /*#__PURE__*/React.createElement("div", {
+    ref: menuRef,
+    className: ax([styles.menuContent])
+  }, /*#__PURE__*/React.createElement(MenuGroup, {
+    isLoading: isLoading,
+    maxHeight: MAX_HEIGHT,
+    maxWidth: shouldFitContainer ? undefined : 800,
+    onClick: handleMenuClick,
+    role: "menu",
+    spacing: spacing,
+    testId: testId && `${testId}--menu-wrapper--menu-group`,
+    menuLabel: menuLabel
+  }, isLoading ? /*#__PURE__*/React.createElement(LoadingIndicator, {
+    statusLabel: statusLabel,
+    testId: testId && `${testId}--menu-wrapper--loading-indicator`
+  }) : children)))));
+}
+export default DropdownMenuTopLayer;

package/dist/es2019/dropdown-menu.js

@@ -9,9 +9,11 @@ import useControlledState from '@atlaskit/ds-lib/use-controlled';
 import useFocus from '@atlaskit/ds-lib/use-focus-event';
 import ExpandIcon from '@atlaskit/icon/core/chevron-down';
 import { useLayering } from '@atlaskit/layering';
+import { fg } from '@atlaskit/platform-feature-flags';
 import Popup from '@atlaskit/popup';
 // eslint-disable-next-line @atlaskit/design-system/no-deprecated-imports
 import { layers } from '@atlaskit/theme/constants';
+import DropdownMenuTopLayer from './dropdown-menu-top-layer';
 import FocusManager from './internal/components/focus-manager';
 import MenuWrapper from './internal/components/menu-wrapper';
 import SelectionStore from './internal/context/selection-store';
@@ -50,15 +52,9 @@ function isKeyboardEvent(event) {
 }
 
 /**
- * __Dropdown menu__
- *
- * A dropdown menu displays a list of actions or options to a user.
- *
- * - [Examples](https://atlassian.design/components/dropdown-menu/examples)
- * - [Code](https://atlassian.design/components/dropdown-menu/code)
- * - [Usage](https://atlassian.design/components/dropdown-menu/usage)
+ * Legacy Popper/Popup implementation (hooks run unconditionally when this component mounts).
  */
-const DropdownMenu = ({
+function DropdownMenuLegacy({
   autoFocus = false,
   children,
   defaultOpen = false,
@@ -80,7 +76,7 @@ const DropdownMenu = ({
   strategy,
   menuLabel,
   shouldPreventEscapePropagation = false
-}) => {
+}) {
   const [isLocalOpen, setLocalIsOpen] = useControlledState(isOpen, () => defaultOpen);
   const triggerRef = useRef(null);
   const [isTriggeredUsingKeyboard, setTriggeredUsingKeyboard] = useState(false);
@@ -315,5 +311,59 @@ const DropdownMenu = ({
       menuLabel: menuLabel
     }, children))
   })));
+}
+
+/**
+ * __Dropdown menu__
+ *
+ * A dropdown menu displays a list of actions or options to a user.
+ *
+ * - [Examples](https://atlassian.design/components/dropdown-menu/examples)
+ * - [Code](https://atlassian.design/components/dropdown-menu/code)
+ * - [Usage](https://atlassian.design/components/dropdown-menu/usage)
+ */
+const DropdownMenu = props => {
+  const {
+    autoFocus = false,
+    children,
+    defaultOpen = false,
+    isLoading = false,
+    isOpen,
+    onOpenChange = noop,
+    placement = 'bottom-start',
+    shouldFitContainer = false,
+    returnFocusRef,
+    spacing,
+    statusLabel,
+    testId,
+    trigger,
+    label,
+    interactionName,
+    menuLabel
+  } = props;
+  if (fg('platform-dst-top-layer')) {
+    return /*#__PURE__*/React.createElement(DropdownMenuTopLayer, {
+      autoFocus: autoFocus,
+      children: children,
+      defaultOpen: defaultOpen,
+      isLoading: isLoading,
+      isOpen: isOpen,
+      onOpenChange: onOpenChange,
+      placement: placement,
+      shouldFitContainer: shouldFitContainer,
+      returnFocusRef: returnFocusRef,
+      spacing: spacing,
+      statusLabel: statusLabel,
+      testId: testId,
+      trigger: trigger,
+      label: label,
+      interactionName: interactionName,
+      menuLabel: menuLabel
+    });
+  }
+
+  // Forward full public props to the legacy Popper/Popup implementation unchanged.
+  // eslint-disable-next-line @repo/internal/react/no-unsafe-spread-props -- wrapper delegates entire DropdownMenuProps API
+  return /*#__PURE__*/React.createElement(DropdownMenuLegacy, props);
 };
 export default DropdownMenu;

package/dist/es2019/internal/components/group-title.js

@@ -10,7 +10,12 @@ const styles = {
 /**
  * __Group title__
  *
- * Used to visually represent the title for DropdownMenu groups
+ * Used to visually represent the title for DropdownMenu groups.
+ *
+ * Pre-existing a11y note: uses `role="menuitem"` with `aria-hidden="true"`.
+ * WAI-ARIA APG recommends `role="presentation"` for non-interactive group
+ * headings, with the group linked via `aria-labelledby`. Out of scope for
+ * the top-layer migration — this is legacy behavior.
  *
  * @internal
  */

package/dist/es2019/internal/use-arrow-navigation/index.js

@@ -0,0 +1,2 @@
+export { useArrowNavigation, isAtCurrentMenuLevel } from './use-arrow-navigation';
+export { getFirstFocusable } from '@atlaskit/top-layer/focus';

package/dist/es2019/internal/use-arrow-navigation/use-arrow-navigation.js

@@ -0,0 +1 @@
+export { useArrowNavigation, isAtCurrentMenuLevel } from '@atlaskit/top-layer/use-arrow-navigation';

package/dist/esm/dropdown-menu-top-layer.compiled.css

@@ -0,0 +1,10 @@
+
+._2rkofajl{border-radius:var(--ds-radius-small,3px)}._16qs130s{box-shadow:var(--ds-shadow-overlay,0 8px 9pt #1e1f2126,0 0 1px #1e1f214f)}
+._1bah1h6o{justify-content:center}
+._1e0c1txw{display:flex}
+._1q51v47k{padding-block-start:var(--ds-space-250,20px)}
+._1ul91lit{min-width:10pc}
+._85i5v47k{padding-block-end:var(--ds-space-250,20px)}
+._bfhk1bhr{background-color:var(--ds-surface-overlay,#fff)}
+._bozgv47k{padding-inline-start:var(--ds-space-250,20px)}
+._y4tiv47k{padding-inline-end:var(--ds-space-250,20px)}