@atlaskit/dropdown-menu 16.8.9 → 16.8.11

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

@@ -0,0 +1,338 @@
+/* dropdown-menu-top-layer.tsx generated by @compiled/babel-plugin v0.39.1 */
+import _extends from "@babel/runtime/helpers/extends";
+import _defineProperty from "@babel/runtime/helpers/defineProperty";
+import _slicedToArray from "@babel/runtime/helpers/slicedToArray";
+import "./dropdown-menu-top-layer.compiled.css";
+import * as React from 'react';
+import { ax, ix } from "@compiled/react/runtime";
+function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
+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';
+var MAX_HEIGHT = "calc(100vh - 16px)";
+var styles = {
+  spinnerContainer: "_1e0c1txw _1ul91lit _1bah1h6o _1q51v47k _y4tiv47k _85i5v47k _bozgv47k",
+  menuContent: "_2rkofajl _bfhk1bhr _16qs130s"
+};
+var 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(_ref) {
+  var _ref$statusLabel = _ref.statusLabel,
+    statusLabel = _ref$statusLabel === void 0 ? 'Loading' : _ref$statusLabel,
+    testId = _ref.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(_ref2) {
+  var _ref6;
+  var _ref2$autoFocus = _ref2.autoFocus,
+    autoFocus = _ref2$autoFocus === void 0 ? false : _ref2$autoFocus,
+    children = _ref2.children,
+    _ref2$defaultOpen = _ref2.defaultOpen,
+    defaultOpen = _ref2$defaultOpen === void 0 ? false : _ref2$defaultOpen,
+    _ref2$isLoading = _ref2.isLoading,
+    isLoading = _ref2$isLoading === void 0 ? false : _ref2$isLoading,
+    isOpenProp = _ref2.isOpen,
+    _ref2$onOpenChange = _ref2.onOpenChange,
+    onOpenChange = _ref2$onOpenChange === void 0 ? noop : _ref2$onOpenChange,
+    _ref2$placement = _ref2.placement,
+    placement = _ref2$placement === void 0 ? 'bottom-start' : _ref2$placement,
+    _ref2$shouldFitContai = _ref2.shouldFitContainer,
+    shouldFitContainer = _ref2$shouldFitContai === void 0 ? false : _ref2$shouldFitContai,
+    returnFocusRef = _ref2.returnFocusRef,
+    spacing = _ref2.spacing,
+    statusLabel = _ref2.statusLabel,
+    testId = _ref2.testId,
+    trigger = _ref2.trigger,
+    label = _ref2.label,
+    interactionName = _ref2.interactionName,
+    menuLabel = _ref2.menuLabel;
+  var _useControlledState = useControlledState(isOpenProp, function () {
+      return defaultOpen;
+    }),
+    _useControlledState2 = _slicedToArray(_useControlledState, 2),
+    isLocalOpen = _useControlledState2[0],
+    setLocalIsOpen = _useControlledState2[1];
+  var triggerRef = useRef(null);
+  var menuRef = useRef(null);
+  var _useState = useState(false),
+    _useState2 = _slicedToArray(_useState, 2),
+    isTriggeredUsingKeyboard = _useState2[0],
+    setTriggeredUsingKeyboard = _useState2[1];
+  var topLayerPlacement = useMemo(function () {
+    return 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.
+  var handleOnClose = useCallback(function (_ref3) {
+    var _reason = _ref3.reason;
+    if (returnFocusRef) {
+      requestAnimationFrame(function () {
+        var _returnFocusRef$curre;
+        (_returnFocusRef$curre = returnFocusRef.current) === null || _returnFocusRef$curre === void 0 || _returnFocusRef$curre.focus();
+      });
+    }
+    setLocalIsOpen(false);
+    onOpenChange({
+      isOpen: false,
+      event: null
+    });
+  }, [onOpenChange, returnFocusRef, setLocalIsOpen]);
+
+  // ── Trigger click handling ──
+  var handleTriggerClicked = useCallback(function (event) {
+    var newValue = !isLocalOpen;
+    setTriggeredUsingKeyboard(isKeyboardTriggered(event));
+    setLocalIsOpen(newValue);
+
+    // Extract the native DOM event for onOpenChange
+    var nativeEvent = 'nativeEvent' in event ? event.nativeEvent : event;
+    onOpenChange({
+      isOpen: newValue,
+      event: nativeEvent
+    });
+  }, [isLocalOpen, setLocalIsOpen, onOpenChange]);
+  var _useFocus = useFocus(),
+    isFocused = _useFocus.isFocused,
+    bindFocus = _useFocus.bindFocus;
+
+  // 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(function () {
+    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.
+    var 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.
+  var handleArrowClose = useCallback(function () {
+    handleOnClose({
+      reason: 'escape'
+    });
+  }, [handleOnClose]);
+  var handleNestedOpen = useCallback(function (_ref4) {
+    var trigger = _ref4.trigger;
+    trigger.click();
+  }, []);
+  var handleNestedClose = useCallback(function () {
+    handleOnClose({
+      reason: 'escape'
+    });
+  }, [handleOnClose]);
+  useArrowNavigation({
+    containerRef: menuRef,
+    onClose: handleArrowClose,
+    onNestedOpen: handleNestedOpen,
+    onNestedClose: handleNestedClose,
+    isEnabled: isLocalOpen,
+    filter: isAtCurrentMenuLevel
+  });
+
+  // ── Auto-focus first item on open ──
+  useEffect(function () {
+    if (!isLocalOpen || !isTriggeredUsingKeyboard && !autoFocus) {
+      return;
+    }
+    requestAnimationFrame(function () {
+      var menu = menuRef.current;
+      if (!menu) {
+        return;
+      }
+      var firstItem = getFirstFocusable({
+        container: menu
+      });
+      firstItem === null || firstItem === void 0 || firstItem.focus();
+    });
+  }, [isLocalOpen, isTriggeredUsingKeyboard, autoFocus]);
+
+  // shouldFitContainer is handled by the width prop on Popup.Content below.
+  var 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).
+  var handleMenuClick = useCallback(function (e) {
+    var _target$closest;
+    var target = e.target;
+    var 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;
+    }
+    var 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.
+    var 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, function (_ref5) {
+    var ref = _ref5.ref,
+      _toggle = _ref5.toggle,
+      ariaAttributes = _ref5.ariaAttributes;
+    var 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.
+    var narrowAriaAttributes = ariaAttributes;
+    if (typeof trigger === 'function') {
+      return trigger(_objectSpread(_objectSpread(_objectSpread({}, narrowAriaAttributes), bindFocus), {}, {
+        triggerRef: combinedRef,
+        isSelected: isLocalOpen,
+        onClick: handleTriggerClicked,
+        testId: testId && "".concat(testId, "--trigger")
+      }));
+    }
+    return /*#__PURE__*/React.createElement(Button, _extends({}, bindFocus, {
+      ref: combinedRef
+    }, narrowAriaAttributes, {
+      isSelected: isLocalOpen,
+      iconAfter: function iconAfter(iconProps) {
+        return /*#__PURE__*/React.createElement(ExpandIcon, _extends({}, iconProps, {
+          size: "small"
+        }));
+      },
+      onClick: handleTriggerClicked,
+      testId: testId && "".concat(testId, "--trigger"),
+      "aria-label": label,
+      interactionName: interactionName
+    }), trigger);
+  }), /*#__PURE__*/React.createElement(Popup.Content, {
+    role: "menu",
+    label: (_ref6 = menuLabel !== null && menuLabel !== void 0 ? menuLabel : label) !== null && _ref6 !== void 0 ? _ref6 : typeof trigger === 'string' ? trigger : 'Menu',
+    isOpen: isLocalOpen,
+    animate: animation,
+    width: popupContentWidth,
+    testId: testId && "".concat(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 && "".concat(testId, "--menu-wrapper--menu-group"),
+    menuLabel: menuLabel
+  }, isLoading ? /*#__PURE__*/React.createElement(LoadingIndicator, {
+    statusLabel: statusLabel,
+    testId: testId && "".concat(testId, "--menu-wrapper--loading-indicator")
+  }) : children)))));
+}
+export default DropdownMenuTopLayer;

package/dist/esm/dropdown-menu.js

@@ -15,9 +15,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';
@@ -56,15 +58,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).
  */
-var DropdownMenu = function DropdownMenu(_ref) {
+function DropdownMenuLegacy(_ref) {
   var _ref$autoFocus = _ref.autoFocus,
     autoFocus = _ref$autoFocus === void 0 ? false : _ref$autoFocus,
     children = _ref.children,
@@ -336,5 +332,63 @@ var DropdownMenu = function DropdownMenu(_ref) {
       }, 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)
+ */
+var DropdownMenu = function DropdownMenu(props) {
+  var _props$autoFocus = props.autoFocus,
+    autoFocus = _props$autoFocus === void 0 ? false : _props$autoFocus,
+    children = props.children,
+    _props$defaultOpen = props.defaultOpen,
+    defaultOpen = _props$defaultOpen === void 0 ? false : _props$defaultOpen,
+    _props$isLoading = props.isLoading,
+    isLoading = _props$isLoading === void 0 ? false : _props$isLoading,
+    isOpen = props.isOpen,
+    _props$onOpenChange = props.onOpenChange,
+    onOpenChange = _props$onOpenChange === void 0 ? noop : _props$onOpenChange,
+    _props$placement = props.placement,
+    placement = _props$placement === void 0 ? 'bottom-start' : _props$placement,
+    _props$shouldFitConta = props.shouldFitContainer,
+    shouldFitContainer = _props$shouldFitConta === void 0 ? false : _props$shouldFitConta,
+    returnFocusRef = props.returnFocusRef,
+    spacing = props.spacing,
+    statusLabel = props.statusLabel,
+    testId = props.testId,
+    trigger = props.trigger,
+    label = props.label,
+    interactionName = props.interactionName,
+    menuLabel = props.menuLabel;
+  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/esm/internal/components/group-title.js

@@ -10,7 +10,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/esm/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/esm/internal/use-arrow-navigation/use-arrow-navigation.js

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

package/dist/types/dropdown-menu-top-layer.d.ts

@@ -0,0 +1,18 @@
+import type { DropdownMenuProps } from './types';
+/**
+ * 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
+ */
+declare function DropdownMenuTopLayer({ autoFocus, children, defaultOpen, isLoading, isOpen: isOpenProp, onOpenChange, placement, shouldFitContainer, returnFocusRef, spacing, statusLabel, testId, trigger, label, interactionName, menuLabel, }: DropdownMenuProps): React.JSX.Element;
+export default DropdownMenuTopLayer;

package/dist/types/dropdown-menu.d.ts

@@ -9,5 +9,5 @@ import type { DropdownMenuProps } from './types';
  * - [Code](https://atlassian.design/components/dropdown-menu/code)
  * - [Usage](https://atlassian.design/components/dropdown-menu/usage)
  */
-declare const DropdownMenu: <T extends HTMLElement = any>({ autoFocus, children, defaultOpen, isLoading, isOpen, onOpenChange, placement, shouldFitContainer, shouldFlip, shouldRenderToParent, returnFocusRef, spacing, statusLabel, testId, trigger, zIndex, label, interactionName, strategy, menuLabel, shouldPreventEscapePropagation, }: DropdownMenuProps<T>) => React.JSX.Element;
+declare const DropdownMenu: <T extends HTMLElement = any>(props: DropdownMenuProps<T>) => React.JSX.Element;
 export default DropdownMenu;

package/dist/types/internal/components/group-title.d.ts

@@ -2,7 +2,12 @@ import React from 'react';
 /**
  * __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/types/internal/use-arrow-navigation/index.d.ts

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

package/dist/types/internal/use-arrow-navigation/use-arrow-navigation.d.ts

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

package/dist/types/types.d.ts

@@ -114,6 +114,10 @@ interface InternalDropdownMenuProps<TriggerElement extends HTMLElement = any> {
     /**
      * Allows the dropdown menu to be placed on the opposite side of its trigger if it does not
      * fit in the viewport.
+     *
+     * @private
+     * @deprecated No-op when `platform-dst-top-layer` is enabled — CSS Anchor Positioning
+     * handles flipping natively via `position-try-fallbacks`.
      */
     shouldFlip?: boolean;
     /**
@@ -121,6 +125,10 @@ interface InternalDropdownMenuProps<TriggerElement extends HTMLElement = any> {
      * `true` renders the dropdown menu in the DOM node closest to the trigger; focus is not trapped inside the element.
      * `false` renders the dropdown menu in React.Portal and focus is trapped inside the element.
      * Defaults to `false`.
+     *
+     * @private
+     * @deprecated No-op when `platform-dst-top-layer` is enabled — content always
+     * renders in the browser's top layer.
      */
     shouldRenderToParent?: boolean;
     /**
@@ -162,6 +170,10 @@ interface InternalDropdownMenuProps<TriggerElement extends HTMLElement = any> {
      * Z-index that the popup should be displayed in.
      * This is passed to the portal component.
      * Defaults to `layers.modal()` from `@atlaskit/theme` which is 510.
+     *
+     * @private
+     * @deprecated No-op when `platform-dst-top-layer` is enabled — the browser's
+     * top layer manages stacking without z-index.
      */
     zIndex?: number;
     /**
@@ -179,6 +191,10 @@ interface InternalDropdownMenuProps<TriggerElement extends HTMLElement = any> {
     /**
      * This controls the positioning strategy to use. Can vary between `absolute` and `fixed`.
      * The default is `fixed`.
+     *
+     * @private
+     * @deprecated No-op when `platform-dst-top-layer` is enabled — CSS Anchor Positioning
+     * replaces Popper's positioning strategy.
      */
     strategy?: 'absolute' | 'fixed';
     /**
@@ -188,6 +204,10 @@ interface InternalDropdownMenuProps<TriggerElement extends HTMLElement = any> {
     /**
      * When set to true, will call stopPropagation on the ESCAPE key event.
      * This prevents the ESCAPE event from bubbling up to parent elements.
+     *
+     * @private
+     * @deprecated No-op when `platform-dst-top-layer` is enabled — the native
+     * popover dismiss handles Escape propagation.
      */
     shouldPreventEscapePropagation?: boolean;
 }

package/dist/types-ts4.5/dropdown-menu-top-layer.d.ts

@@ -0,0 +1,18 @@
+import type { DropdownMenuProps } from './types';
+/**
+ * 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
+ */
+declare function DropdownMenuTopLayer({ autoFocus, children, defaultOpen, isLoading, isOpen: isOpenProp, onOpenChange, placement, shouldFitContainer, returnFocusRef, spacing, statusLabel, testId, trigger, label, interactionName, menuLabel, }: DropdownMenuProps): React.JSX.Element;
+export default DropdownMenuTopLayer;

package/dist/types-ts4.5/dropdown-menu.d.ts

@@ -9,5 +9,5 @@ import type { DropdownMenuProps } from './types';
  * - [Code](https://atlassian.design/components/dropdown-menu/code)
  * - [Usage](https://atlassian.design/components/dropdown-menu/usage)
  */
-declare const DropdownMenu: <T extends HTMLElement = any>({ autoFocus, children, defaultOpen, isLoading, isOpen, onOpenChange, placement, shouldFitContainer, shouldFlip, shouldRenderToParent, returnFocusRef, spacing, statusLabel, testId, trigger, zIndex, label, interactionName, strategy, menuLabel, shouldPreventEscapePropagation, }: DropdownMenuProps<T>) => React.JSX.Element;
+declare const DropdownMenu: <T extends HTMLElement = any>(props: DropdownMenuProps<T>) => React.JSX.Element;
 export default DropdownMenu;

package/dist/types-ts4.5/internal/components/group-title.d.ts

@@ -2,7 +2,12 @@ import React from 'react';
 /**
  * __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/types-ts4.5/internal/use-arrow-navigation/index.d.ts

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

package/dist/types-ts4.5/internal/use-arrow-navigation/use-arrow-navigation.d.ts

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

package/dist/types-ts4.5/types.d.ts

@@ -114,6 +114,10 @@ interface InternalDropdownMenuProps<TriggerElement extends HTMLElement = any> {
     /**
      * Allows the dropdown menu to be placed on the opposite side of its trigger if it does not
      * fit in the viewport.
+     *
+     * @private
+     * @deprecated No-op when `platform-dst-top-layer` is enabled — CSS Anchor Positioning
+     * handles flipping natively via `position-try-fallbacks`.
      */
     shouldFlip?: boolean;
     /**
@@ -121,6 +125,10 @@ interface InternalDropdownMenuProps<TriggerElement extends HTMLElement = any> {
      * `true` renders the dropdown menu in the DOM node closest to the trigger; focus is not trapped inside the element.
      * `false` renders the dropdown menu in React.Portal and focus is trapped inside the element.
      * Defaults to `false`.
+     *
+     * @private
+     * @deprecated No-op when `platform-dst-top-layer` is enabled — content always
+     * renders in the browser's top layer.
      */
     shouldRenderToParent?: boolean;
     /**
@@ -162,6 +170,10 @@ interface InternalDropdownMenuProps<TriggerElement extends HTMLElement = any> {
      * Z-index that the popup should be displayed in.
      * This is passed to the portal component.
      * Defaults to `layers.modal()` from `@atlaskit/theme` which is 510.
+     *
+     * @private
+     * @deprecated No-op when `platform-dst-top-layer` is enabled — the browser's
+     * top layer manages stacking without z-index.
      */
     zIndex?: number;
     /**
@@ -179,6 +191,10 @@ interface InternalDropdownMenuProps<TriggerElement extends HTMLElement = any> {
     /**
      * This controls the positioning strategy to use. Can vary between `absolute` and `fixed`.
      * The default is `fixed`.
+     *
+     * @private
+     * @deprecated No-op when `platform-dst-top-layer` is enabled — CSS Anchor Positioning
+     * replaces Popper's positioning strategy.
      */
     strategy?: 'absolute' | 'fixed';
     /**
@@ -188,6 +204,10 @@ interface InternalDropdownMenuProps<TriggerElement extends HTMLElement = any> {
     /**
      * When set to true, will call stopPropagation on the ESCAPE key event.
      * This prevents the ESCAPE event from bubbling up to parent elements.
+     *
+     * @private
+     * @deprecated No-op when `platform-dst-top-layer` is enabled — the native
+     * popover dismiss handles Escape propagation.
      */
     shouldPreventEscapePropagation?: boolean;
 }