@fluentui/react-menu 9.74.7-experimental.cli-api.20261006-ccaa611d58.0 → 9.74.9-experimental.menu-disable-autofocus.20261008-e9914a95c6.0

package/CHANGELOG.md

@@ -1,29 +1,57 @@
 # Change Log - @fluentui/react-menu
 
-<!-- This log was last generated on Tue, 06 Oct 2026 11:40:25 GMT and should not be manually modified. -->
+<!-- This log was last generated on Thu, 08 Oct 2026 09:39:56 GMT and should not be manually modified. -->
 
 <!-- Start content -->
 
-## [9.74.7-experimental.cli-api.20261006-ccaa611d58.0](https://github.com/microsoft/fluentui/tree/@fluentui/react-menu_v9.74.7-experimental.cli-api.20261006-ccaa611d58.0)
+## [9.74.9-experimental.menu-disable-autofocus.20261008-e9914a95c6.0](https://github.com/microsoft/fluentui/tree/@fluentui/react-menu_v9.74.9-experimental.menu-disable-autofocus.20261008-e9914a95c6.0)
 
-Tue, 06 Oct 2026 11:40:25 GMT 
-[Compare changes](https://github.com/microsoft/fluentui/compare/@fluentui/react-menu_v9.25.4..@fluentui/react-menu_v9.74.7-experimental.cli-api.20261006-ccaa611d58.0)
+Thu, 08 Oct 2026 09:39:56 GMT 
+[Compare changes](https://github.com/microsoft/fluentui/compare/@fluentui/react-menu_v9.25.6..@fluentui/react-menu_v9.74.9-experimental.menu-disable-autofocus.20261008-e9914a95c6.0)
 
 ### Changes
 
-- Release 9.74.7-experimental.cli-api.20261006-ccaa611d58 ([commit](https://github.com/microsoft/fluentui/commit/undefined) by 257645319+office-ogx-auth-helper[bot]@users.noreply.github.com)
-- Bump @fluentui/keyboard-keys to v9.74.7-experimental.cli-api.20261006-ccaa611d58.0 ([commit](https://github.com/microsoft/fluentui/commit/undefined) by beachball)
-- Bump @fluentui/react-aria to v9.74.7-experimental.cli-api.20261006-ccaa611d58.0 ([commit](https://github.com/microsoft/fluentui/commit/undefined) by beachball)
-- Bump @fluentui/react-context-selector to v9.74.7-experimental.cli-api.20261006-ccaa611d58.0 ([commit](https://github.com/microsoft/fluentui/commit/undefined) by beachball)
-- Bump @fluentui/react-jsx-runtime to v9.74.7-experimental.cli-api.20261006-ccaa611d58.0 ([commit](https://github.com/microsoft/fluentui/commit/undefined) by beachball)
-- Bump @fluentui/react-motion to v9.74.7-experimental.cli-api.20261006-ccaa611d58.0 ([commit](https://github.com/microsoft/fluentui/commit/undefined) by beachball)
-- Bump @fluentui/react-motion-components-preview to v9.74.7-experimental.cli-api.20261006-ccaa611d58.0 ([commit](https://github.com/microsoft/fluentui/commit/undefined) by beachball)
-- Bump @fluentui/react-portal to v9.74.7-experimental.cli-api.20261006-ccaa611d58.0 ([commit](https://github.com/microsoft/fluentui/commit/undefined) by beachball)
-- Bump @fluentui/react-positioning to v9.74.7-experimental.cli-api.20261006-ccaa611d58.0 ([commit](https://github.com/microsoft/fluentui/commit/undefined) by beachball)
-- Bump @fluentui/react-shared-contexts to v9.74.7-experimental.cli-api.20261006-ccaa611d58.0 ([commit](https://github.com/microsoft/fluentui/commit/undefined) by beachball)
-- Bump @fluentui/react-tabster to v9.74.7-experimental.cli-api.20261006-ccaa611d58.0 ([commit](https://github.com/microsoft/fluentui/commit/undefined) by beachball)
-- Bump @fluentui/react-theme to v9.74.7-experimental.cli-api.20261006-ccaa611d58.0 ([commit](https://github.com/microsoft/fluentui/commit/undefined) by beachball)
-- Bump @fluentui/react-utilities to v9.74.7-experimental.cli-api.20261006-ccaa611d58.0 ([commit](https://github.com/microsoft/fluentui/commit/undefined) by beachball)
+- Release 9.74.9-experimental.menu-disable-autofocus.20261008-e9914a95c6 ([commit](https://github.com/microsoft/fluentui/commit/undefined) by 257645319+office-ogx-auth-helper[bot]@users.noreply.github.com)
+- Bump @fluentui/keyboard-keys to v9.74.9-experimental.menu-disable-autofocus.20261008-e9914a95c6.0 ([commit](https://github.com/microsoft/fluentui/commit/undefined) by beachball)
+- Bump @fluentui/react-aria to v9.74.9-experimental.menu-disable-autofocus.20261008-e9914a95c6.0 ([commit](https://github.com/microsoft/fluentui/commit/undefined) by beachball)
+- Bump @fluentui/react-context-selector to v9.74.9-experimental.menu-disable-autofocus.20261008-e9914a95c6.0 ([commit](https://github.com/microsoft/fluentui/commit/undefined) by beachball)
+- Bump @fluentui/react-jsx-runtime to v9.74.9-experimental.menu-disable-autofocus.20261008-e9914a95c6.0 ([commit](https://github.com/microsoft/fluentui/commit/undefined) by beachball)
+- Bump @fluentui/react-motion to v9.74.9-experimental.menu-disable-autofocus.20261008-e9914a95c6.0 ([commit](https://github.com/microsoft/fluentui/commit/undefined) by beachball)
+- Bump @fluentui/react-motion-components-preview to v9.74.9-experimental.menu-disable-autofocus.20261008-e9914a95c6.0 ([commit](https://github.com/microsoft/fluentui/commit/undefined) by beachball)
+- Bump @fluentui/react-portal to v9.74.9-experimental.menu-disable-autofocus.20261008-e9914a95c6.0 ([commit](https://github.com/microsoft/fluentui/commit/undefined) by beachball)
+- Bump @fluentui/react-positioning to v9.74.9-experimental.menu-disable-autofocus.20261008-e9914a95c6.0 ([commit](https://github.com/microsoft/fluentui/commit/undefined) by beachball)
+- Bump @fluentui/react-shared-contexts to v9.74.9-experimental.menu-disable-autofocus.20261008-e9914a95c6.0 ([commit](https://github.com/microsoft/fluentui/commit/undefined) by beachball)
+- Bump @fluentui/react-tabster to v9.74.9-experimental.menu-disable-autofocus.20261008-e9914a95c6.0 ([commit](https://github.com/microsoft/fluentui/commit/undefined) by beachball)
+- Bump @fluentui/react-theme to v9.74.9-experimental.menu-disable-autofocus.20261008-e9914a95c6.0 ([commit](https://github.com/microsoft/fluentui/commit/undefined) by beachball)
+- Bump @fluentui/react-utilities to v9.74.9-experimental.menu-disable-autofocus.20261008-e9914a95c6.0 ([commit](https://github.com/microsoft/fluentui/commit/undefined) by beachball)
+
+## [9.25.6](https://github.com/microsoft/fluentui/tree/@fluentui/react-menu_v9.25.6)
+
+Wed, 23 Sep 2026 09:04:33 GMT 
+[Compare changes](https://github.com/microsoft/fluentui/compare/@fluentui/react-menu_v9.25.5..@fluentui/react-menu_v9.25.6)
+
+### Patches
+
+- Bump @fluentui/react-positioning to v9.23.3 ([commit](https://github.com/microsoft/fluentui/commit/undefined) by beachball)
+
+## [9.25.5](https://github.com/microsoft/fluentui/tree/@fluentui/react-menu_v9.25.5)
+
+Tue, 22 Sep 2026 11:25:40 GMT 
+[Compare changes](https://github.com/microsoft/fluentui/compare/@fluentui/react-menu_v9.25.4..@fluentui/react-menu_v9.25.5)
+
+### Patches
+
+- fix: remove unused react-dom and @types/react-dom peer dependencies, mark @types/react as optional ([PR #36559](https://github.com/microsoft/fluentui/pull/36559) by martinhochel@microsoft.com)
+- Bump @fluentui/react-aria to v9.17.15 ([commit](https://github.com/microsoft/fluentui/commit/undefined) by beachball)
+- Bump @fluentui/react-context-selector to v9.2.20 ([commit](https://github.com/microsoft/fluentui/commit/undefined) by beachball)
+- Bump @fluentui/react-jsx-runtime to v9.4.6 ([commit](https://github.com/microsoft/fluentui/commit/undefined) by beachball)
+- Bump @fluentui/react-motion to v9.16.4 ([commit](https://github.com/microsoft/fluentui/commit/undefined) by beachball)
+- Bump @fluentui/react-motion-components-preview to v0.15.9 ([commit](https://github.com/microsoft/fluentui/commit/undefined) by beachball)
+- Bump @fluentui/react-portal to v9.8.16 ([commit](https://github.com/microsoft/fluentui/commit/undefined) by beachball)
+- Bump @fluentui/react-positioning to v9.23.2 ([commit](https://github.com/microsoft/fluentui/commit/undefined) by beachball)
+- Bump @fluentui/react-shared-contexts to v9.26.4 ([commit](https://github.com/microsoft/fluentui/commit/undefined) by beachball)
+- Bump @fluentui/react-tabster to v9.26.18 ([commit](https://github.com/microsoft/fluentui/commit/undefined) by beachball)
+- Bump @fluentui/react-utilities to v9.26.7 ([commit](https://github.com/microsoft/fluentui/commit/undefined) by beachball)
 
 ## [9.25.4](https://github.com/microsoft/fluentui/tree/@fluentui/react-menu_v9.25.4)
 

package/dist/index.d.cts

@@ -56,7 +56,7 @@ export declare type MenuCheckedValueChangeEvent = React_2.MouseEvent | React_2.K
  *
  * Extends and drills down MenuList props to simplify API
  */
-export declare type MenuContextValue = Pick<MenuState, 'openOnHover' | 'openOnContext' | 'triggerRef' | 'menuPopoverRef' | 'setOpen' | 'isSubmenu' | 'mountNode' | 'triggerId' | 'hasIcons' | 'hasCheckmarks' | 'persistOnItemClick' | 'inline' | 'checkedValues' | 'onCheckedValueChange' | 'safeZone'> & {
+export declare type MenuContextValue = Pick<MenuState, 'openOnHover' | 'openOnContext' | 'triggerRef' | 'menuPopoverRef' | 'setOpen' | 'isSubmenu' | 'mountNode' | 'triggerId' | 'hasIcons' | 'hasCheckmarks' | 'persistOnItemClick' | 'inline' | 'checkedValues' | 'onCheckedValueChange' | 'safeZone'> & Pick<MenuProps, 'unstable_disableAutoFocus'> & {
     open: boolean;
     triggerId: string;
     /**
@@ -527,6 +527,15 @@ export declare type MenuProps = ComponentProps<Partial<MenuSlots>> & Pick<Portal
      * @default false
      */
     defaultOpen?: boolean;
+    /**
+     * Disables automatically focusing the first item when this menu opens.
+     * Does not affect focus restoration on close or autofocus in nested menus.
+     * The consumer is responsible for accessible trigger semantics, deliberate
+     * keyboard entry, and dismissal while focus remains outside the menu.
+     *
+     * @default false
+     */
+    unstable_disableAutoFocus?: boolean;
     /**
      * Opens the menu on right click (context menu), removes all other menu open interactions
      *
@@ -596,7 +605,7 @@ export declare type MenuSplitGroupSlots = {
  */
 export declare type MenuSplitGroupState = ComponentState<MenuSplitGroupSlots> & Pick<MenuSplitGroupContextValue, 'setMultiline'>;
 
-export declare type MenuState = ComponentState<InternalMenuSlots> & Required<Pick<MenuProps, 'hasCheckmarks' | 'hasIcons' | 'mountNode' | 'inline' | 'checkedValues' | 'onCheckedValueChange' | 'open' | 'openOnHover' | 'closeOnScroll' | 'hoverDelay' | 'openOnContext' | 'persistOnItemClick'>> & {
+export declare type MenuState = ComponentState<InternalMenuSlots> & Required<Pick<MenuProps, 'hasCheckmarks' | 'hasIcons' | 'mountNode' | 'inline' | 'checkedValues' | 'onCheckedValueChange' | 'open' | 'openOnHover' | 'closeOnScroll' | 'hoverDelay' | 'openOnContext' | 'persistOnItemClick' | 'unstable_disableAutoFocus'>> & {
     /**
      * Anchors the popper to the mouse click for context events
      */

package/dist/index.d.ts

@@ -56,7 +56,7 @@ export declare type MenuCheckedValueChangeEvent = React_2.MouseEvent | React_2.K
  *
  * Extends and drills down MenuList props to simplify API
  */
-export declare type MenuContextValue = Pick<MenuState, 'openOnHover' | 'openOnContext' | 'triggerRef' | 'menuPopoverRef' | 'setOpen' | 'isSubmenu' | 'mountNode' | 'triggerId' | 'hasIcons' | 'hasCheckmarks' | 'persistOnItemClick' | 'inline' | 'checkedValues' | 'onCheckedValueChange' | 'safeZone'> & {
+export declare type MenuContextValue = Pick<MenuState, 'openOnHover' | 'openOnContext' | 'triggerRef' | 'menuPopoverRef' | 'setOpen' | 'isSubmenu' | 'mountNode' | 'triggerId' | 'hasIcons' | 'hasCheckmarks' | 'persistOnItemClick' | 'inline' | 'checkedValues' | 'onCheckedValueChange' | 'safeZone'> & Pick<MenuProps, 'unstable_disableAutoFocus'> & {
     open: boolean;
     triggerId: string;
     /**
@@ -527,6 +527,15 @@ export declare type MenuProps = ComponentProps<Partial<MenuSlots>> & Pick<Portal
      * @default false
      */
     defaultOpen?: boolean;
+    /**
+     * Disables automatically focusing the first item when this menu opens.
+     * Does not affect focus restoration on close or autofocus in nested menus.
+     * The consumer is responsible for accessible trigger semantics, deliberate
+     * keyboard entry, and dismissal while focus remains outside the menu.
+     *
+     * @default false
+     */
+    unstable_disableAutoFocus?: boolean;
     /**
      * Opens the menu on right click (context menu), removes all other menu open interactions
      *
@@ -596,7 +605,7 @@ export declare type MenuSplitGroupSlots = {
  */
 export declare type MenuSplitGroupState = ComponentState<MenuSplitGroupSlots> & Pick<MenuSplitGroupContextValue, 'setMultiline'>;
 
-export declare type MenuState = ComponentState<InternalMenuSlots> & Required<Pick<MenuProps, 'hasCheckmarks' | 'hasIcons' | 'mountNode' | 'inline' | 'checkedValues' | 'onCheckedValueChange' | 'open' | 'openOnHover' | 'closeOnScroll' | 'hoverDelay' | 'openOnContext' | 'persistOnItemClick'>> & {
+export declare type MenuState = ComponentState<InternalMenuSlots> & Required<Pick<MenuProps, 'hasCheckmarks' | 'hasIcons' | 'mountNode' | 'inline' | 'checkedValues' | 'onCheckedValueChange' | 'open' | 'openOnHover' | 'closeOnScroll' | 'hoverDelay' | 'openOnContext' | 'persistOnItemClick' | 'unstable_disableAutoFocus'>> & {
     /**
      * Anchors the popper to the mouse click for context events
      */

package/lib/components/Menu/Menu.types.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/components/Menu/Menu.types.ts"],"sourcesContent":["import type * as React from 'react';\nimport type { PresenceMotionSlotProps } from '@fluentui/react-motion';\nimport type { PositioningVirtualElement, SetVirtualMouseTarget } from '@fluentui/react-positioning';\nimport type { PositioningShorthand } from '@fluentui/react-positioning';\nimport type { PortalProps } from '@fluentui/react-portal';\nimport type { ComponentProps, ComponentState, JSXElement, Slot } from '@fluentui/react-utilities';\nimport type { MenuContextValue } from '../../contexts/menuContext';\nimport type { MenuListProps } from '../MenuList/MenuList.types';\n\nexport type MenuSlots = {\n  /**\n   * Slot for the surface motion animation.\n   * For more information refer to the [Motion docs page](https://react.fluentui.dev/?path=/docs/motion-motion-slot--docs).\n   */\n  surfaceMotion: Slot<PresenceMotionSlotProps>;\n};\n\nexport type InternalMenuSlots = {\n  surfaceMotion: NonNullable<Slot<PresenceMotionSlotProps>>;\n};\n\n/**\n * Extends and drills down Menulist props to simplify API\n */\nexport type MenuProps = ComponentProps<Partial<MenuSlots>> &\n  Pick<PortalProps, 'mountNode'> &\n  Pick<\n    MenuListProps,\n    'checkedValues' | 'defaultCheckedValues' | 'hasCheckmarks' | 'hasIcons' | 'onCheckedValueChange'\n  > & {\n    /**\n     * Can contain two children including `MenuTrigger` and `MenuPopover`.\n     * Alternatively can only contain `MenuPopover` if using a custom `target`.\n     */\n    children: [JSXElement, JSXElement] | JSXElement;\n\n    /**\n     * Sets the delay for mouse open/close for the popover one mouse enter/leave\n     */\n    hoverDelay?: number;\n\n    /**\n     * Root menus are rendered out of DOM order on `document.body`, use this to render the menu in DOM order\n     * This option is disregarded for submenus\n     *\n     * @default false\n     */\n    inline?: boolean;\n\n    /**\n     * Call back when the component requests to change value\n     * The `open` value is used as a hint when directly controlling the component\n     */\n    // eslint-disable-next-line @nx/workspace-consistent-callback-type -- can't change type of existing callback\n    onOpenChange?: (e: MenuOpenEvent, data: MenuOpenChangeData) => void;\n\n    /**\n     * Whether the popup is open\n     *\n     * @default false\n     */\n    open?: boolean;\n\n    /**\n     * Whether the popup is open by default\n     *\n     * @default false\n     */\n    defaultOpen?: boolean;\n\n    /**\n     * Opens the menu on right click (context menu), removes all other menu open interactions\n     *\n     * @default false\n     */\n    openOnContext?: boolean;\n\n    /**\n     * Opens the menu on hover\n     *\n     * @default false\n     */\n    openOnHover?: boolean;\n\n    /**\n     * Do not dismiss the menu when a menu item is clicked\n     *\n     * @default false\n     */\n    persistOnItemClick?: boolean;\n\n    /**\n     * Configures the positioned menu\n     */\n    positioning?: PositioningShorthand;\n\n    /**\n     * Close when scroll outside of it\n     *\n     * @default false\n     */\n    closeOnScroll?: boolean;\n  };\n\nexport type MenuState = ComponentState<InternalMenuSlots> &\n  Required<\n    Pick<\n      MenuProps,\n      | 'hasCheckmarks'\n      | 'hasIcons'\n      | 'mountNode'\n      | 'inline'\n      | 'checkedValues'\n      | 'onCheckedValueChange'\n      | 'open'\n      | 'openOnHover'\n      | 'closeOnScroll'\n      | 'hoverDelay'\n      | 'openOnContext'\n      | 'persistOnItemClick'\n    >\n  > & {\n    /**\n     * Anchors the popper to the mouse click for context events\n     */\n    contextTarget?: PositioningVirtualElement;\n\n    /**\n     * Whether this menu is a submenu\n     */\n    isSubmenu: boolean;\n\n    /**\n     * Internal react node that just simplifies handling children\n     */\n    menuPopover: React.ReactNode;\n\n    /**\n     * The ref for the popup\n     */\n    // eslint-disable-next-line @typescript-eslint/no-deprecated\n    menuPopoverRef: React.MutableRefObject<HTMLElement | null>;\n\n    /**\n     * Internal react node that just simplifies handling children\n     */\n    menuTrigger: React.ReactNode;\n\n    /**\n     * A callback to set the target of the popper to the mouse click for context events\n     */\n    setContextTarget: SetVirtualMouseTarget;\n\n    /**\n     * Callback to open/close the popup\n     */\n    setOpen: (e: MenuOpenEvent, data: MenuOpenChangeData & { ignoreHoverDelay?: boolean }) => void;\n\n    /**\n     * Id for the MenuTrigger element for aria relationship\n     */\n    triggerId: string;\n\n    /**\n     * The ref for the MenuTrigger, used for popup positioning\n     */\n    // eslint-disable-next-line @typescript-eslint/no-deprecated\n    triggerRef: React.MutableRefObject<HTMLElement | null>;\n\n    /**\n     * Call back when the component requests to change value\n     * The `open` value is used as a hint when directly controlling the component\n     * @deprecated this property is not used internally anymore,\n     * the signature remains just to avoid breaking changes\n     */\n    onOpenChange?: (e: MenuOpenEvent, data: MenuOpenChangeData) => void;\n    /**\n     * Default values to be checked on mount\n     @deprecated this property is not used internally anymore,\n     * the signature remains just to avoid breaking changes\n     */\n    defaultCheckedValues?: Record<string, string[]>;\n\n    /**\n     * An optional safe zone area to be rendered around the menu\n     */\n    safeZone?: React.ReactElement | null;\n  };\n\nexport type MenuBaseProps = Omit<MenuProps, 'surfaceMotion'>;\n\nexport type MenuBaseState = Omit<MenuState, 'surfaceMotion' | 'components'>;\n\nexport type MenuContextValues = {\n  menu: MenuContextValue;\n};\n\n/**\n * The supported events that will trigger open/close of the menu\n */\nexport type MenuOpenEvent = MenuOpenChangeData['event'];\n/**\n * @deprecated use MenuOpenEvent instead\n */\nexport type MenuOpenEvents = MenuOpenEvent;\n\n/**\n * Data attached to open/close events\n */\nexport type MenuOpenChangeData = {\n  /**\n   * indicates whether the request for the open state was bubbled from a nested menu\n   */\n  bubble?: boolean;\n  /**\n   * Indicates whether the change of state was a keyboard interaction\n   * @deprecated\n   * This should not be used, since `Enter`, `Space` and click should be interpreted as the same thing as a click\n   */\n  keyboard?: boolean;\n  open: boolean;\n} & (\n  | {\n      type: 'menuTriggerContextMenu';\n      event: React.MouseEvent<HTMLElement>;\n    }\n  | {\n      type: 'menuTriggerClick';\n      event: React.MouseEvent<HTMLElement>;\n    }\n  | {\n      type: 'menuTriggerMouseEnter';\n      event: React.MouseEvent<HTMLElement>;\n    }\n  | {\n      type: 'menuSafeZoneMouseEnter';\n      event: React.MouseEvent;\n    }\n  | {\n      type: 'menuSafeZoneTimeout';\n      event: Event;\n    }\n  | {\n      type: 'menuTriggerMouseLeave';\n      event: React.MouseEvent<HTMLElement>;\n    }\n  | {\n      type: 'menuTriggerMouseMove';\n      event: React.MouseEvent<HTMLElement>;\n    }\n  | {\n      type: 'menuTriggerKeyDown';\n      event: React.KeyboardEvent<HTMLElement>;\n    }\n  | {\n      type: 'menuItemClick';\n      event: React.MouseEvent<HTMLElement>;\n    }\n  | {\n      type: 'menuPopoverMouseEnter';\n      event: React.MouseEvent<HTMLElement>;\n    }\n  | {\n      type: 'menuPopoverKeyDown';\n      event: React.KeyboardEvent<HTMLElement>;\n    }\n  | {\n      type: 'clickOutside';\n      event: MouseEvent | TouchEvent;\n    }\n  | {\n      type: 'scrollOutside';\n      event: MouseEvent | TouchEvent;\n    }\n  | {\n      type: 'menuMouseEnter';\n      event: MouseEvent | TouchEvent;\n    }\n);\n"],"names":[],"mappings":"AA8MA;;CAEC,GACD,WAqEE"}
+{"version":3,"sources":["../src/components/Menu/Menu.types.ts"],"sourcesContent":["import type * as React from 'react';\nimport type { PresenceMotionSlotProps } from '@fluentui/react-motion';\nimport type { PositioningVirtualElement, SetVirtualMouseTarget } from '@fluentui/react-positioning';\nimport type { PositioningShorthand } from '@fluentui/react-positioning';\nimport type { PortalProps } from '@fluentui/react-portal';\nimport type { ComponentProps, ComponentState, JSXElement, Slot } from '@fluentui/react-utilities';\nimport type { MenuContextValue } from '../../contexts/menuContext';\nimport type { MenuListProps } from '../MenuList/MenuList.types';\n\nexport type MenuSlots = {\n  /**\n   * Slot for the surface motion animation.\n   * For more information refer to the [Motion docs page](https://react.fluentui.dev/?path=/docs/motion-motion-slot--docs).\n   */\n  surfaceMotion: Slot<PresenceMotionSlotProps>;\n};\n\nexport type InternalMenuSlots = {\n  surfaceMotion: NonNullable<Slot<PresenceMotionSlotProps>>;\n};\n\n/**\n * Extends and drills down Menulist props to simplify API\n */\nexport type MenuProps = ComponentProps<Partial<MenuSlots>> &\n  Pick<PortalProps, 'mountNode'> &\n  Pick<\n    MenuListProps,\n    'checkedValues' | 'defaultCheckedValues' | 'hasCheckmarks' | 'hasIcons' | 'onCheckedValueChange'\n  > & {\n    /**\n     * Can contain two children including `MenuTrigger` and `MenuPopover`.\n     * Alternatively can only contain `MenuPopover` if using a custom `target`.\n     */\n    children: [JSXElement, JSXElement] | JSXElement;\n\n    /**\n     * Sets the delay for mouse open/close for the popover one mouse enter/leave\n     */\n    hoverDelay?: number;\n\n    /**\n     * Root menus are rendered out of DOM order on `document.body`, use this to render the menu in DOM order\n     * This option is disregarded for submenus\n     *\n     * @default false\n     */\n    inline?: boolean;\n\n    /**\n     * Call back when the component requests to change value\n     * The `open` value is used as a hint when directly controlling the component\n     */\n    // eslint-disable-next-line @nx/workspace-consistent-callback-type -- can't change type of existing callback\n    onOpenChange?: (e: MenuOpenEvent, data: MenuOpenChangeData) => void;\n\n    /**\n     * Whether the popup is open\n     *\n     * @default false\n     */\n    open?: boolean;\n\n    /**\n     * Whether the popup is open by default\n     *\n     * @default false\n     */\n    defaultOpen?: boolean;\n\n    /**\n     * Disables automatically focusing the first item when this menu opens.\n     * Does not affect focus restoration on close or autofocus in nested menus.\n     * The consumer is responsible for accessible trigger semantics, deliberate\n     * keyboard entry, and dismissal while focus remains outside the menu.\n     *\n     * @default false\n     */\n    // eslint-disable-next-line @typescript-eslint/naming-convention -- matches the unstable Popover API\n    unstable_disableAutoFocus?: boolean;\n\n    /**\n     * Opens the menu on right click (context menu), removes all other menu open interactions\n     *\n     * @default false\n     */\n    openOnContext?: boolean;\n\n    /**\n     * Opens the menu on hover\n     *\n     * @default false\n     */\n    openOnHover?: boolean;\n\n    /**\n     * Do not dismiss the menu when a menu item is clicked\n     *\n     * @default false\n     */\n    persistOnItemClick?: boolean;\n\n    /**\n     * Configures the positioned menu\n     */\n    positioning?: PositioningShorthand;\n\n    /**\n     * Close when scroll outside of it\n     *\n     * @default false\n     */\n    closeOnScroll?: boolean;\n  };\n\nexport type MenuState = ComponentState<InternalMenuSlots> &\n  Required<\n    Pick<\n      MenuProps,\n      | 'hasCheckmarks'\n      | 'hasIcons'\n      | 'mountNode'\n      | 'inline'\n      | 'checkedValues'\n      | 'onCheckedValueChange'\n      | 'open'\n      | 'openOnHover'\n      | 'closeOnScroll'\n      | 'hoverDelay'\n      | 'openOnContext'\n      | 'persistOnItemClick'\n      | 'unstable_disableAutoFocus'\n    >\n  > & {\n    /**\n     * Anchors the popper to the mouse click for context events\n     */\n    contextTarget?: PositioningVirtualElement;\n\n    /**\n     * Whether this menu is a submenu\n     */\n    isSubmenu: boolean;\n\n    /**\n     * Internal react node that just simplifies handling children\n     */\n    menuPopover: React.ReactNode;\n\n    /**\n     * The ref for the popup\n     */\n    // eslint-disable-next-line @typescript-eslint/no-deprecated\n    menuPopoverRef: React.MutableRefObject<HTMLElement | null>;\n\n    /**\n     * Internal react node that just simplifies handling children\n     */\n    menuTrigger: React.ReactNode;\n\n    /**\n     * A callback to set the target of the popper to the mouse click for context events\n     */\n    setContextTarget: SetVirtualMouseTarget;\n\n    /**\n     * Callback to open/close the popup\n     */\n    setOpen: (e: MenuOpenEvent, data: MenuOpenChangeData & { ignoreHoverDelay?: boolean }) => void;\n\n    /**\n     * Id for the MenuTrigger element for aria relationship\n     */\n    triggerId: string;\n\n    /**\n     * The ref for the MenuTrigger, used for popup positioning\n     */\n    // eslint-disable-next-line @typescript-eslint/no-deprecated\n    triggerRef: React.MutableRefObject<HTMLElement | null>;\n\n    /**\n     * Call back when the component requests to change value\n     * The `open` value is used as a hint when directly controlling the component\n     * @deprecated this property is not used internally anymore,\n     * the signature remains just to avoid breaking changes\n     */\n    onOpenChange?: (e: MenuOpenEvent, data: MenuOpenChangeData) => void;\n    /**\n     * Default values to be checked on mount\n     @deprecated this property is not used internally anymore,\n     * the signature remains just to avoid breaking changes\n     */\n    defaultCheckedValues?: Record<string, string[]>;\n\n    /**\n     * An optional safe zone area to be rendered around the menu\n     */\n    safeZone?: React.ReactElement | null;\n  };\n\nexport type MenuBaseProps = Omit<MenuProps, 'surfaceMotion'>;\n\nexport type MenuBaseState = Omit<MenuState, 'surfaceMotion' | 'components'>;\n\nexport type MenuContextValues = {\n  menu: MenuContextValue;\n};\n\n/**\n * The supported events that will trigger open/close of the menu\n */\nexport type MenuOpenEvent = MenuOpenChangeData['event'];\n/**\n * @deprecated use MenuOpenEvent instead\n */\nexport type MenuOpenEvents = MenuOpenEvent;\n\n/**\n * Data attached to open/close events\n */\nexport type MenuOpenChangeData = {\n  /**\n   * indicates whether the request for the open state was bubbled from a nested menu\n   */\n  bubble?: boolean;\n  /**\n   * Indicates whether the change of state was a keyboard interaction\n   * @deprecated\n   * This should not be used, since `Enter`, `Space` and click should be interpreted as the same thing as a click\n   */\n  keyboard?: boolean;\n  open: boolean;\n} & (\n  | {\n      type: 'menuTriggerContextMenu';\n      event: React.MouseEvent<HTMLElement>;\n    }\n  | {\n      type: 'menuTriggerClick';\n      event: React.MouseEvent<HTMLElement>;\n    }\n  | {\n      type: 'menuTriggerMouseEnter';\n      event: React.MouseEvent<HTMLElement>;\n    }\n  | {\n      type: 'menuSafeZoneMouseEnter';\n      event: React.MouseEvent;\n    }\n  | {\n      type: 'menuSafeZoneTimeout';\n      event: Event;\n    }\n  | {\n      type: 'menuTriggerMouseLeave';\n      event: React.MouseEvent<HTMLElement>;\n    }\n  | {\n      type: 'menuTriggerMouseMove';\n      event: React.MouseEvent<HTMLElement>;\n    }\n  | {\n      type: 'menuTriggerKeyDown';\n      event: React.KeyboardEvent<HTMLElement>;\n    }\n  | {\n      type: 'menuItemClick';\n      event: React.MouseEvent<HTMLElement>;\n    }\n  | {\n      type: 'menuPopoverMouseEnter';\n      event: React.MouseEvent<HTMLElement>;\n    }\n  | {\n      type: 'menuPopoverKeyDown';\n      event: React.KeyboardEvent<HTMLElement>;\n    }\n  | {\n      type: 'clickOutside';\n      event: MouseEvent | TouchEvent;\n    }\n  | {\n      type: 'scrollOutside';\n      event: MouseEvent | TouchEvent;\n    }\n  | {\n      type: 'menuMouseEnter';\n      event: MouseEvent | TouchEvent;\n    }\n);\n"],"names":[],"mappings":"AA0NA;;CAEC,GACD,WAqEE"}

package/lib/components/Menu/useMenu.js

@@ -2,7 +2,7 @@
 import * as React from "react";
 import { resolvePositioningShorthand, usePositioningMouseTarget, usePositioning, useSafeZoneArea, usePositioningSlideDirection } from "@fluentui/react-positioning";
 import { presenceMotionSlot } from "@fluentui/react-motion";
-import { useControllableState, useId, useOnClickOutside, useEventCallback, useOnScrollOutside, elementContains, useTimeout, useFirstMount, useMergedRefs } from "@fluentui/react-utilities";
+import { useControllableState, useId, useOnClickOutside, useEventCallback, useOnScrollOutside, elementContains, useTimeout, useMergedRefs } from "@fluentui/react-utilities";
 import { useFluent_unstable as useFluent } from "@fluentui/react-shared-contexts";
 import { useFocusFinders } from "@fluentui/react-tabster";
 import { useMenuContext_unstable } from "../../contexts/menuContext.js";
@@ -51,7 +51,7 @@ const submenuFallbackPositions = [
  * @param props - props from this instance of Menu
  */ export const useMenuBase_unstable = (props)=>{
     const isSubmenu = useIsSubmenu();
-    const { hoverDelay = 500, inline = false, hasCheckmarks = false, hasIcons = false, closeOnScroll = false, openOnContext = false, persistOnItemClick = false, openOnHover = isSubmenu, defaultCheckedValues, mountNode = null, safeZone } = props;
+    const { hoverDelay = 500, inline = false, hasCheckmarks = false, hasIcons = false, closeOnScroll = false, openOnContext = false, persistOnItemClick = false, unstable_disableAutoFocus: disableAutoFocus = false, openOnHover = isSubmenu, defaultCheckedValues, mountNode = null, safeZone } = props;
     const { targetDocument } = useFluent();
     const triggerId = useId('menu');
     const [contextTarget, setContextTarget] = usePositioningMouseTarget();
@@ -147,7 +147,8 @@ const submenuFallbackPositions = [
         open: props.open,
         defaultOpen: props.defaultOpen,
         onOpenChange: props.onOpenChange,
-        openOnContext
+        openOnContext,
+        disableAutoFocus
     });
     const [checkedValues, onCheckedValueChange] = useMenuSelectableState({
         checkedValues: props.checkedValues,
@@ -176,6 +177,8 @@ const submenuFallbackPositions = [
         checkedValues,
         onCheckedValueChange,
         persistOnItemClick,
+        // eslint-disable-next-line @typescript-eslint/naming-convention -- matches the unstable Popover API
+        unstable_disableAutoFocus: disableAutoFocus,
         safeZone: safeZoneHandle.elementToRender
     };
 };
@@ -310,14 +313,17 @@ const useMenuOpenState = (state)=>{
         findFirstFocusable,
         state.menuPopoverRef
     ]);
-    const firstMount = useFirstMount();
+    const previousOpenRef = React.useRef(open);
     React.useEffect(()=>{
+        const wasOpen = previousOpenRef.current;
+        previousOpenRef.current = open;
         if (open) {
-            focusFirst();
+            if (!state.disableAutoFocus) {
+                focusFirst();
+            }
         } else {
-            // Skip the initial render — focus should only be restored when the menu
-            // transitions from open → closed, not on mount.
-            if (!firstMount) {
+            // Restore only on an open -> closed transition, not on unrelated option changes.
+            if (wasOpen) {
                 var // The surfaceMotion presence component delays unmounting the popover
                 // (e.g. during an exit animation), so focus may still be inside the
                 // popover even though `open` is already false. Proactively move it
@@ -338,11 +344,10 @@ const useMenuOpenState = (state)=>{
                 }
             }
         }
-    // firstMount change should not re-run this effect
-    // eslint-disable-next-line react-hooks/exhaustive-deps
     }, [
         state.triggerRef,
         state.isSubmenu,
+        state.disableAutoFocus,
         open,
         focusFirst,
         targetDocument,

package/lib/components/Menu/useMenu.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/components/Menu/useMenu.tsx"],"sourcesContent":["'use client';\n\nimport * as React from 'react';\nimport {\n  resolvePositioningShorthand,\n  usePositioningMouseTarget,\n  usePositioning,\n  useSafeZoneArea,\n  usePositioningSlideDirection,\n  type PositioningShorthandValue,\n} from '@fluentui/react-positioning';\nimport { presenceMotionSlot } from '@fluentui/react-motion';\nimport {\n  useControllableState,\n  useId,\n  useOnClickOutside,\n  useEventCallback,\n  useOnScrollOutside,\n  elementContains,\n  useTimeout,\n  useFirstMount,\n  useMergedRefs,\n} from '@fluentui/react-utilities';\nimport { useFluent_unstable as useFluent } from '@fluentui/react-shared-contexts';\nimport { useFocusFinders } from '@fluentui/react-tabster';\n\nimport { useMenuContext_unstable } from '../../contexts/menuContext';\nimport { MENU_SAFEZONE_TIMEOUT_EVENT, MENU_ENTER_EVENT, useOnMenuMouseEnter, useIsSubmenu } from '../../utils';\nimport { menuItemClassNames } from '../MenuItem/useMenuItemStyles.styles';\nimport type {\n  MenuBaseProps,\n  MenuBaseState,\n  MenuOpenChangeData,\n  MenuOpenEvent,\n  MenuProps,\n  MenuState,\n} from './Menu.types';\nimport { MenuSurfaceMotion } from './MenuSurfaceMotion';\n\n// If it's not possible to position the submenu in smaller viewports, try\n// and fallback to this order of positions\nconst submenuFallbackPositions: PositioningShorthandValue[] = [\n  'after',\n  'after-bottom',\n  'before-top',\n  'before',\n  'before-bottom',\n  'above',\n];\n\n/**\n * Create the state required to render Menu.\n *\n * The returned state can be modified with hooks such as useMenuStyles,\n * before being passed to renderMenu_unstable.\n *\n * @param props - props from this instance of Menu\n */\nexport const useMenu_unstable = (props: MenuProps & { safeZone?: boolean | { timeout?: number } }): MenuState => {\n  const { surfaceMotion, ...baseProps } = props;\n  const baseState = useMenuBase_unstable(baseProps);\n\n  return {\n    ...baseState,\n    components: {\n      surfaceMotion: MenuSurfaceMotion,\n    },\n    surfaceMotion: presenceMotionSlot(surfaceMotion, {\n      elementType: MenuSurfaceMotion,\n      defaultProps: {\n        visible: baseState.open,\n        appear: true,\n        unmountOnExit: true,\n      },\n    }),\n  };\n};\n\n/**\n * Base hook for Menu component, produces state required to render the component.\n * It doesn't set any design-related slots specific to Menu such as `surfaceMotion`.\n *\n * @param props - props from this instance of Menu\n */\nexport const useMenuBase_unstable = (\n  props: MenuBaseProps & { safeZone?: boolean | { timeout?: number } },\n): MenuBaseState => {\n  const isSubmenu = useIsSubmenu();\n  const {\n    hoverDelay = 500,\n    inline = false,\n    hasCheckmarks = false,\n    hasIcons = false,\n    closeOnScroll = false,\n    openOnContext = false,\n    persistOnItemClick = false,\n    openOnHover = isSubmenu,\n    defaultCheckedValues,\n    mountNode = null,\n    safeZone,\n  } = props;\n\n  const { targetDocument } = useFluent();\n  const triggerId = useId('menu');\n  const [contextTarget, setContextTarget] = usePositioningMouseTarget();\n\n  const resolvedPositioning = resolvePositioningShorthand(props.positioning);\n  const handlePositionEnd = usePositioningSlideDirection({\n    targetDocument,\n    onPositioningEnd: resolvedPositioning.onPositioningEnd,\n  });\n\n  const positioningOptions = {\n    position: isSubmenu ? 'after' : 'below',\n    align: isSubmenu ? 'top' : 'start',\n    target: props.openOnContext ? contextTarget : undefined,\n    fallbackPositions: isSubmenu ? submenuFallbackPositions : undefined,\n    ...resolvedPositioning,\n    onPositioningEnd: handlePositionEnd,\n  } as const;\n\n  const children = React.Children.toArray(props.children) as React.ReactElement[];\n\n  if (process.env.NODE_ENV !== 'production') {\n    if (children.length === 0) {\n      // eslint-disable-next-line no-console\n      console.warn('Menu must contain at least one child');\n    }\n\n    if (children.length > 2) {\n      // eslint-disable-next-line no-console\n      console.warn('Menu must contain at most two children');\n    }\n  }\n\n  let menuTrigger: React.ReactElement | undefined = undefined;\n  let menuPopover: React.ReactElement | undefined = undefined;\n  if (children.length === 2) {\n    menuTrigger = children[0];\n    menuPopover = children[1];\n  } else if (children.length === 1) {\n    menuPopover = children[0];\n  }\n\n  const { targetRef, containerRef } = usePositioning(positioningOptions);\n\n  const enableSafeZone = safeZone && openOnHover;\n  const safeZoneDescriptorRef = React.useRef({\n    isInside: false,\n    mouseCoordinates: { x: 0, y: 0 },\n  });\n\n  const safeZoneHandle = useSafeZoneArea({\n    disabled: !enableSafeZone,\n    timeout: typeof safeZone === 'object' ? safeZone.timeout : 300,\n\n    onSafeZoneEnter: e => {\n      setOpen(e, { open: true, keyboard: false, type: 'menuSafeZoneMouseEnter', event: e });\n      safeZoneDescriptorRef.current.isInside = true;\n    },\n    onSafeZoneLeave: () => {\n      safeZoneDescriptorRef.current.isInside = false;\n    },\n    onSafeZoneMove: e => {\n      safeZoneDescriptorRef.current.mouseCoordinates = {\n        x: e.clientX,\n        y: e.clientY,\n      };\n    },\n    onSafeZoneTimeout: () => {\n      const event = new CustomEvent(MENU_SAFEZONE_TIMEOUT_EVENT);\n\n      setOpen(event, { open: false, keyboard: false, type: 'menuSafeZoneTimeout', event });\n\n      if (safeZoneDescriptorRef.current.isInside && targetDocument) {\n        const elementsInPoint = targetDocument.elementsFromPoint(\n          safeZoneDescriptorRef.current.mouseCoordinates.x,\n          safeZoneDescriptorRef.current.mouseCoordinates.y,\n        );\n        const menuItemEl = elementsInPoint.find(el => {\n          return el.classList.contains(menuItemClassNames.root);\n        }) as HTMLElement | null;\n\n        menuItemEl?.dispatchEvent(event);\n      }\n    },\n  });\n\n  const triggerRef = useMergedRefs(targetRef, safeZoneHandle.targetRef);\n  const menuPopoverRef = useMergedRefs(containerRef, safeZoneHandle.containerRef);\n\n  // TODO Better way to narrow types ?\n  const [open, setOpen] = useMenuOpenState({\n    hoverDelay,\n    isSubmenu,\n    setContextTarget,\n    closeOnScroll,\n    menuPopoverRef,\n    triggerRef,\n    open: props.open,\n    defaultOpen: props.defaultOpen,\n    onOpenChange: props.onOpenChange,\n    openOnContext,\n  });\n\n  const [checkedValues, onCheckedValueChange] = useMenuSelectableState({\n    checkedValues: props.checkedValues,\n    defaultCheckedValues,\n    onCheckedValueChange: props.onCheckedValueChange,\n  });\n\n  return {\n    inline,\n    hoverDelay,\n    triggerId,\n    isSubmenu,\n    openOnHover,\n    contextTarget,\n    setContextTarget,\n    hasCheckmarks,\n    hasIcons,\n    closeOnScroll,\n    menuTrigger,\n    menuPopover,\n    mountNode,\n    triggerRef,\n    menuPopoverRef,\n    openOnContext,\n    open,\n    setOpen,\n    checkedValues,\n    onCheckedValueChange,\n    persistOnItemClick,\n    safeZone: safeZoneHandle.elementToRender,\n  };\n};\n\n/**\n * Adds appropriate state values and handlers for selectable items\n * i.e checkboxes and radios\n */\nconst useMenuSelectableState = (\n  props: Pick<MenuProps, 'checkedValues' | 'defaultCheckedValues' | 'onCheckedValueChange'>,\n) => {\n  const [checkedValues, setCheckedValues] = useControllableState({\n    state: props.checkedValues,\n    defaultState: props.defaultCheckedValues,\n    initialState: {},\n  });\n  const onCheckedValueChange: MenuState['onCheckedValueChange'] = useEventCallback((e, { name, checkedItems }) => {\n    props.onCheckedValueChange?.(e, { name, checkedItems });\n\n    setCheckedValues(currentValue => ({\n      ...currentValue,\n      [name]: checkedItems,\n    }));\n  });\n\n  return [checkedValues, onCheckedValueChange] as const;\n};\n\nconst useMenuOpenState = (\n  state: Pick<\n    MenuState,\n    | 'isSubmenu'\n    | 'menuPopoverRef'\n    | 'setContextTarget'\n    | 'triggerRef'\n    | 'openOnContext'\n    | 'closeOnScroll'\n    | 'hoverDelay'\n  > &\n    Pick<MenuProps, 'open' | 'defaultOpen' | 'onOpenChange'>,\n) => {\n  const { targetDocument } = useFluent();\n  const parentSetOpen = useMenuContext_unstable(context => context.setOpen);\n  const onOpenChange: MenuProps['onOpenChange'] = useEventCallback((e, data) => state.onOpenChange?.(e, data));\n\n  const enteringTriggerRef = React.useRef(false);\n\n  const [open, setOpenState] = useControllableState({\n    state: state.open,\n    defaultState: state.defaultOpen,\n    initialState: false,\n  });\n\n  const trySetOpen = useEventCallback((e: MenuOpenEvent, data: MenuOpenChangeData) => {\n    const event = e instanceof CustomEvent && e.type === MENU_ENTER_EVENT ? e.detail.nativeEvent : e;\n    onOpenChange?.(event, { ...data });\n    if (data.open && e.type === 'contextmenu') {\n      state.setContextTarget(e as React.MouseEvent);\n    }\n\n    if (!data.open) {\n      state.setContextTarget(undefined);\n    }\n\n    if (data.bubble) {\n      parentSetOpen(e, { ...data });\n    }\n\n    setOpenState(data.open);\n  });\n\n  const [setOpenTimeout, clearOpenTimeout] = useTimeout();\n\n  const setOpen = useEventCallback((e: MenuOpenEvent, data: MenuOpenChangeData & { ignoreHoverDelay?: boolean }) => {\n    clearOpenTimeout();\n    if (!(e instanceof Event) && e.persist) {\n      // < React 17 still uses pooled synthetic events\n      e.persist();\n    }\n\n    const shouldUseDelay =\n      !data.ignoreHoverDelay &&\n      (e.type === 'mouseleave' || e.type === 'mouseover' || e.type === 'mousemove' || e.type === MENU_ENTER_EVENT);\n\n    if (shouldUseDelay) {\n      if (state.triggerRef.current?.contains(e.target as HTMLElement)) {\n        enteringTriggerRef.current = e.type === 'mouseover' || e.type === 'mousemove';\n      }\n\n      setOpenTimeout(() => trySetOpen(e, data), state.hoverDelay);\n    } else {\n      trySetOpen(e, data);\n    }\n  });\n\n  useOnClickOutside({\n    contains: elementContains,\n    disabled: !open,\n    element: targetDocument,\n    refs: [state.menuPopoverRef, !state.openOnContext && state.triggerRef].filter(\n      Boolean,\n      // eslint-disable-next-line @typescript-eslint/no-deprecated\n    ) as React.MutableRefObject<HTMLElement | null>[],\n    callback: event => setOpen(event, { open: false, type: 'clickOutside', event }),\n  });\n\n  // only close on scroll for context, or when closeOnScroll is specified\n  const closeOnScroll = state.openOnContext || state.closeOnScroll;\n  useOnScrollOutside({\n    contains: elementContains,\n    element: targetDocument,\n    callback: event => setOpen(event, { open: false, type: 'scrollOutside', event }),\n    refs: [state.menuPopoverRef, !state.openOnContext && state.triggerRef].filter(\n      Boolean,\n      // eslint-disable-next-line @typescript-eslint/no-deprecated\n    ) as React.MutableRefObject<HTMLElement | null>[],\n    disabled: !open || !closeOnScroll,\n  });\n\n  useOnMenuMouseEnter({\n    element: targetDocument,\n    callback: event => {\n      // When moving from a menu directly back to its trigger, this handler can close the menu\n      // Explicitly check a flag to see if this situation happens\n      if (!enteringTriggerRef.current) {\n        setOpen(event, { open: false, type: 'menuMouseEnter', event });\n      }\n    },\n    disabled: !open,\n    refs: [state.menuPopoverRef],\n  });\n\n  // Manage focus for open state\n  const { findFirstFocusable } = useFocusFinders();\n  const focusFirst = React.useCallback(() => {\n    const firstFocusable = findFirstFocusable(state.menuPopoverRef.current);\n    firstFocusable?.focus();\n  }, [findFirstFocusable, state.menuPopoverRef]);\n\n  const firstMount = useFirstMount();\n  React.useEffect(() => {\n    if (open) {\n      focusFirst();\n    } else {\n      // Skip the initial render — focus should only be restored when the menu\n      // transitions from open → closed, not on mount.\n      if (!firstMount) {\n        if (\n          // Focus landed on <body> after the popover was removed from the DOM,\n          // meaning the user's focus has nowhere meaningful to go.\n          targetDocument?.activeElement === targetDocument?.body ||\n          // The surfaceMotion presence component delays unmounting the popover\n          // (e.g. during an exit animation), so focus may still be inside the\n          // popover even though `open` is already false. Proactively move it\n          // to the trigger before the DOM element is eventually removed.\n          state.menuPopoverRef.current?.contains(targetDocument?.activeElement ?? null)\n        ) {\n          // We know that React effects are sync so we focus the trigger here\n          // after any event handler (event handlers will update state and re-render).\n          // Since the browser only performs the default behaviour for the Tab key once\n          // keyboard events have fully bubbled up the window, the browser will move\n          // focus to the next tabbable element before/after the trigger if needed.\n          // If the Tab key was not pressed, focus will remain on the trigger as expected.\n          state.triggerRef.current?.focus();\n        }\n      }\n    }\n    // firstMount change should not re-run this effect\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [state.triggerRef, state.isSubmenu, open, focusFirst, targetDocument, state.menuPopoverRef]);\n\n  return [open, setOpen] as const;\n};\n"],"names":["React","resolvePositioningShorthand","usePositioningMouseTarget","usePositioning","useSafeZoneArea","usePositioningSlideDirection","presenceMotionSlot","useControllableState","useId","useOnClickOutside","useEventCallback","useOnScrollOutside","elementContains","useTimeout","useFirstMount","useMergedRefs","useFluent_unstable","useFluent","useFocusFinders","useMenuContext_unstable","MENU_SAFEZONE_TIMEOUT_EVENT","MENU_ENTER_EVENT","useOnMenuMouseEnter","useIsSubmenu","menuItemClassNames","MenuSurfaceMotion","submenuFallbackPositions","useMenu_unstable","props","surfaceMotion","baseProps","baseState","useMenuBase_unstable","components","elementType","defaultProps","visible","open","appear","unmountOnExit","isSubmenu","hoverDelay","inline","hasCheckmarks","hasIcons","closeOnScroll","openOnContext","persistOnItemClick","openOnHover","defaultCheckedValues","mountNode","safeZone","targetDocument","triggerId","contextTarget","setContextTarget","resolvedPositioning","positioning","handlePositionEnd","onPositioningEnd","positioningOptions","position","align","target","undefined","fallbackPositions","children","Children","toArray","process","env","NODE_ENV","length","console","warn","menuTrigger","menuPopover","targetRef","containerRef","enableSafeZone","safeZoneDescriptorRef","useRef","isInside","mouseCoordinates","x","y","safeZoneHandle","disabled","timeout","onSafeZoneEnter","e","setOpen","keyboard","type","event","current","onSafeZoneLeave","onSafeZoneMove","clientX","clientY","onSafeZoneTimeout","CustomEvent","elementsInPoint","elementsFromPoint","menuItemEl","find","el","classList","contains","root","dispatchEvent","triggerRef","menuPopoverRef","useMenuOpenState","defaultOpen","onOpenChange","checkedValues","onCheckedValueChange","useMenuSelectableState","elementToRender","setCheckedValues","state","defaultState","initialState","name","checkedItems","currentValue","parentSetOpen","context","data","enteringTriggerRef","setOpenState","trySetOpen","detail","nativeEvent","bubble","setOpenTimeout","clearOpenTimeout","Event","persist","shouldUseDelay","ignoreHoverDelay","element","refs","filter","Boolean","callback","findFirstFocusable","focusFirst","useCallback","firstFocusable","focus","firstMount","useEffect","activeElement","body"],"mappings":"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"}
+{"version":3,"sources":["../src/components/Menu/useMenu.tsx"],"sourcesContent":["'use client';\n\nimport * as React from 'react';\nimport {\n  resolvePositioningShorthand,\n  usePositioningMouseTarget,\n  usePositioning,\n  useSafeZoneArea,\n  usePositioningSlideDirection,\n  type PositioningShorthandValue,\n} from '@fluentui/react-positioning';\nimport { presenceMotionSlot } from '@fluentui/react-motion';\nimport {\n  useControllableState,\n  useId,\n  useOnClickOutside,\n  useEventCallback,\n  useOnScrollOutside,\n  elementContains,\n  useTimeout,\n  useMergedRefs,\n} from '@fluentui/react-utilities';\nimport { useFluent_unstable as useFluent } from '@fluentui/react-shared-contexts';\nimport { useFocusFinders } from '@fluentui/react-tabster';\n\nimport { useMenuContext_unstable } from '../../contexts/menuContext';\nimport { MENU_SAFEZONE_TIMEOUT_EVENT, MENU_ENTER_EVENT, useOnMenuMouseEnter, useIsSubmenu } from '../../utils';\nimport { menuItemClassNames } from '../MenuItem/useMenuItemStyles.styles';\nimport type {\n  MenuBaseProps,\n  MenuBaseState,\n  MenuOpenChangeData,\n  MenuOpenEvent,\n  MenuProps,\n  MenuState,\n} from './Menu.types';\nimport { MenuSurfaceMotion } from './MenuSurfaceMotion';\n\n// If it's not possible to position the submenu in smaller viewports, try\n// and fallback to this order of positions\nconst submenuFallbackPositions: PositioningShorthandValue[] = [\n  'after',\n  'after-bottom',\n  'before-top',\n  'before',\n  'before-bottom',\n  'above',\n];\n\n/**\n * Create the state required to render Menu.\n *\n * The returned state can be modified with hooks such as useMenuStyles,\n * before being passed to renderMenu_unstable.\n *\n * @param props - props from this instance of Menu\n */\nexport const useMenu_unstable = (props: MenuProps & { safeZone?: boolean | { timeout?: number } }): MenuState => {\n  const { surfaceMotion, ...baseProps } = props;\n  const baseState = useMenuBase_unstable(baseProps);\n\n  return {\n    ...baseState,\n    components: {\n      surfaceMotion: MenuSurfaceMotion,\n    },\n    surfaceMotion: presenceMotionSlot(surfaceMotion, {\n      elementType: MenuSurfaceMotion,\n      defaultProps: {\n        visible: baseState.open,\n        appear: true,\n        unmountOnExit: true,\n      },\n    }),\n  };\n};\n\n/**\n * Base hook for Menu component, produces state required to render the component.\n * It doesn't set any design-related slots specific to Menu such as `surfaceMotion`.\n *\n * @param props - props from this instance of Menu\n */\nexport const useMenuBase_unstable = (\n  props: MenuBaseProps & { safeZone?: boolean | { timeout?: number } },\n): MenuBaseState => {\n  const isSubmenu = useIsSubmenu();\n  const {\n    hoverDelay = 500,\n    inline = false,\n    hasCheckmarks = false,\n    hasIcons = false,\n    closeOnScroll = false,\n    openOnContext = false,\n    persistOnItemClick = false,\n    unstable_disableAutoFocus: disableAutoFocus = false,\n    openOnHover = isSubmenu,\n    defaultCheckedValues,\n    mountNode = null,\n    safeZone,\n  } = props;\n\n  const { targetDocument } = useFluent();\n  const triggerId = useId('menu');\n  const [contextTarget, setContextTarget] = usePositioningMouseTarget();\n\n  const resolvedPositioning = resolvePositioningShorthand(props.positioning);\n  const handlePositionEnd = usePositioningSlideDirection({\n    targetDocument,\n    onPositioningEnd: resolvedPositioning.onPositioningEnd,\n  });\n\n  const positioningOptions = {\n    position: isSubmenu ? 'after' : 'below',\n    align: isSubmenu ? 'top' : 'start',\n    target: props.openOnContext ? contextTarget : undefined,\n    fallbackPositions: isSubmenu ? submenuFallbackPositions : undefined,\n    ...resolvedPositioning,\n    onPositioningEnd: handlePositionEnd,\n  } as const;\n\n  const children = React.Children.toArray(props.children) as React.ReactElement[];\n\n  if (process.env.NODE_ENV !== 'production') {\n    if (children.length === 0) {\n      // eslint-disable-next-line no-console\n      console.warn('Menu must contain at least one child');\n    }\n\n    if (children.length > 2) {\n      // eslint-disable-next-line no-console\n      console.warn('Menu must contain at most two children');\n    }\n  }\n\n  let menuTrigger: React.ReactElement | undefined = undefined;\n  let menuPopover: React.ReactElement | undefined = undefined;\n  if (children.length === 2) {\n    menuTrigger = children[0];\n    menuPopover = children[1];\n  } else if (children.length === 1) {\n    menuPopover = children[0];\n  }\n\n  const { targetRef, containerRef } = usePositioning(positioningOptions);\n\n  const enableSafeZone = safeZone && openOnHover;\n  const safeZoneDescriptorRef = React.useRef({\n    isInside: false,\n    mouseCoordinates: { x: 0, y: 0 },\n  });\n\n  const safeZoneHandle = useSafeZoneArea({\n    disabled: !enableSafeZone,\n    timeout: typeof safeZone === 'object' ? safeZone.timeout : 300,\n\n    onSafeZoneEnter: e => {\n      setOpen(e, { open: true, keyboard: false, type: 'menuSafeZoneMouseEnter', event: e });\n      safeZoneDescriptorRef.current.isInside = true;\n    },\n    onSafeZoneLeave: () => {\n      safeZoneDescriptorRef.current.isInside = false;\n    },\n    onSafeZoneMove: e => {\n      safeZoneDescriptorRef.current.mouseCoordinates = {\n        x: e.clientX,\n        y: e.clientY,\n      };\n    },\n    onSafeZoneTimeout: () => {\n      const event = new CustomEvent(MENU_SAFEZONE_TIMEOUT_EVENT);\n\n      setOpen(event, { open: false, keyboard: false, type: 'menuSafeZoneTimeout', event });\n\n      if (safeZoneDescriptorRef.current.isInside && targetDocument) {\n        const elementsInPoint = targetDocument.elementsFromPoint(\n          safeZoneDescriptorRef.current.mouseCoordinates.x,\n          safeZoneDescriptorRef.current.mouseCoordinates.y,\n        );\n        const menuItemEl = elementsInPoint.find(el => {\n          return el.classList.contains(menuItemClassNames.root);\n        }) as HTMLElement | null;\n\n        menuItemEl?.dispatchEvent(event);\n      }\n    },\n  });\n\n  const triggerRef = useMergedRefs(targetRef, safeZoneHandle.targetRef);\n  const menuPopoverRef = useMergedRefs(containerRef, safeZoneHandle.containerRef);\n\n  // TODO Better way to narrow types ?\n  const [open, setOpen] = useMenuOpenState({\n    hoverDelay,\n    isSubmenu,\n    setContextTarget,\n    closeOnScroll,\n    menuPopoverRef,\n    triggerRef,\n    open: props.open,\n    defaultOpen: props.defaultOpen,\n    onOpenChange: props.onOpenChange,\n    openOnContext,\n    disableAutoFocus,\n  });\n\n  const [checkedValues, onCheckedValueChange] = useMenuSelectableState({\n    checkedValues: props.checkedValues,\n    defaultCheckedValues,\n    onCheckedValueChange: props.onCheckedValueChange,\n  });\n\n  return {\n    inline,\n    hoverDelay,\n    triggerId,\n    isSubmenu,\n    openOnHover,\n    contextTarget,\n    setContextTarget,\n    hasCheckmarks,\n    hasIcons,\n    closeOnScroll,\n    menuTrigger,\n    menuPopover,\n    mountNode,\n    triggerRef,\n    menuPopoverRef,\n    openOnContext,\n    open,\n    setOpen,\n    checkedValues,\n    onCheckedValueChange,\n    persistOnItemClick,\n    // eslint-disable-next-line @typescript-eslint/naming-convention -- matches the unstable Popover API\n    unstable_disableAutoFocus: disableAutoFocus,\n    safeZone: safeZoneHandle.elementToRender,\n  };\n};\n\n/**\n * Adds appropriate state values and handlers for selectable items\n * i.e checkboxes and radios\n */\nconst useMenuSelectableState = (\n  props: Pick<MenuProps, 'checkedValues' | 'defaultCheckedValues' | 'onCheckedValueChange'>,\n) => {\n  const [checkedValues, setCheckedValues] = useControllableState({\n    state: props.checkedValues,\n    defaultState: props.defaultCheckedValues,\n    initialState: {},\n  });\n  const onCheckedValueChange: MenuState['onCheckedValueChange'] = useEventCallback((e, { name, checkedItems }) => {\n    props.onCheckedValueChange?.(e, { name, checkedItems });\n\n    setCheckedValues(currentValue => ({\n      ...currentValue,\n      [name]: checkedItems,\n    }));\n  });\n\n  return [checkedValues, onCheckedValueChange] as const;\n};\n\nconst useMenuOpenState = (\n  state: Pick<\n    MenuState,\n    | 'isSubmenu'\n    | 'menuPopoverRef'\n    | 'setContextTarget'\n    | 'triggerRef'\n    | 'openOnContext'\n    | 'closeOnScroll'\n    | 'hoverDelay'\n  > & { disableAutoFocus: boolean } & Pick<MenuProps, 'open' | 'defaultOpen' | 'onOpenChange'>,\n) => {\n  const { targetDocument } = useFluent();\n  const parentSetOpen = useMenuContext_unstable(context => context.setOpen);\n  const onOpenChange: MenuProps['onOpenChange'] = useEventCallback((e, data) => state.onOpenChange?.(e, data));\n\n  const enteringTriggerRef = React.useRef(false);\n\n  const [open, setOpenState] = useControllableState({\n    state: state.open,\n    defaultState: state.defaultOpen,\n    initialState: false,\n  });\n\n  const trySetOpen = useEventCallback((e: MenuOpenEvent, data: MenuOpenChangeData) => {\n    const event = e instanceof CustomEvent && e.type === MENU_ENTER_EVENT ? e.detail.nativeEvent : e;\n    onOpenChange?.(event, { ...data });\n    if (data.open && e.type === 'contextmenu') {\n      state.setContextTarget(e as React.MouseEvent);\n    }\n\n    if (!data.open) {\n      state.setContextTarget(undefined);\n    }\n\n    if (data.bubble) {\n      parentSetOpen(e, { ...data });\n    }\n\n    setOpenState(data.open);\n  });\n\n  const [setOpenTimeout, clearOpenTimeout] = useTimeout();\n\n  const setOpen = useEventCallback((e: MenuOpenEvent, data: MenuOpenChangeData & { ignoreHoverDelay?: boolean }) => {\n    clearOpenTimeout();\n    if (!(e instanceof Event) && e.persist) {\n      // < React 17 still uses pooled synthetic events\n      e.persist();\n    }\n\n    const shouldUseDelay =\n      !data.ignoreHoverDelay &&\n      (e.type === 'mouseleave' || e.type === 'mouseover' || e.type === 'mousemove' || e.type === MENU_ENTER_EVENT);\n\n    if (shouldUseDelay) {\n      if (state.triggerRef.current?.contains(e.target as HTMLElement)) {\n        enteringTriggerRef.current = e.type === 'mouseover' || e.type === 'mousemove';\n      }\n\n      setOpenTimeout(() => trySetOpen(e, data), state.hoverDelay);\n    } else {\n      trySetOpen(e, data);\n    }\n  });\n\n  useOnClickOutside({\n    contains: elementContains,\n    disabled: !open,\n    element: targetDocument,\n    refs: [state.menuPopoverRef, !state.openOnContext && state.triggerRef].filter(\n      Boolean,\n      // eslint-disable-next-line @typescript-eslint/no-deprecated\n    ) as React.MutableRefObject<HTMLElement | null>[],\n    callback: event => setOpen(event, { open: false, type: 'clickOutside', event }),\n  });\n\n  // only close on scroll for context, or when closeOnScroll is specified\n  const closeOnScroll = state.openOnContext || state.closeOnScroll;\n  useOnScrollOutside({\n    contains: elementContains,\n    element: targetDocument,\n    callback: event => setOpen(event, { open: false, type: 'scrollOutside', event }),\n    refs: [state.menuPopoverRef, !state.openOnContext && state.triggerRef].filter(\n      Boolean,\n      // eslint-disable-next-line @typescript-eslint/no-deprecated\n    ) as React.MutableRefObject<HTMLElement | null>[],\n    disabled: !open || !closeOnScroll,\n  });\n\n  useOnMenuMouseEnter({\n    element: targetDocument,\n    callback: event => {\n      // When moving from a menu directly back to its trigger, this handler can close the menu\n      // Explicitly check a flag to see if this situation happens\n      if (!enteringTriggerRef.current) {\n        setOpen(event, { open: false, type: 'menuMouseEnter', event });\n      }\n    },\n    disabled: !open,\n    refs: [state.menuPopoverRef],\n  });\n\n  // Manage focus for open state\n  const { findFirstFocusable } = useFocusFinders();\n  const focusFirst = React.useCallback(() => {\n    const firstFocusable = findFirstFocusable(state.menuPopoverRef.current);\n    firstFocusable?.focus();\n  }, [findFirstFocusable, state.menuPopoverRef]);\n\n  const previousOpenRef = React.useRef(open);\n  React.useEffect(() => {\n    const wasOpen = previousOpenRef.current;\n    previousOpenRef.current = open;\n    if (open) {\n      if (!state.disableAutoFocus) {\n        focusFirst();\n      }\n    } else {\n      // Restore only on an open -> closed transition, not on unrelated option changes.\n      if (wasOpen) {\n        if (\n          // Focus landed on <body> after the popover was removed from the DOM,\n          // meaning the user's focus has nowhere meaningful to go.\n          targetDocument?.activeElement === targetDocument?.body ||\n          // The surfaceMotion presence component delays unmounting the popover\n          // (e.g. during an exit animation), so focus may still be inside the\n          // popover even though `open` is already false. Proactively move it\n          // to the trigger before the DOM element is eventually removed.\n          state.menuPopoverRef.current?.contains(targetDocument?.activeElement ?? null)\n        ) {\n          // We know that React effects are sync so we focus the trigger here\n          // after any event handler (event handlers will update state and re-render).\n          // Since the browser only performs the default behaviour for the Tab key once\n          // keyboard events have fully bubbled up the window, the browser will move\n          // focus to the next tabbable element before/after the trigger if needed.\n          // If the Tab key was not pressed, focus will remain on the trigger as expected.\n          state.triggerRef.current?.focus();\n        }\n      }\n    }\n  }, [\n    state.triggerRef,\n    state.isSubmenu,\n    state.disableAutoFocus,\n    open,\n    focusFirst,\n    targetDocument,\n    state.menuPopoverRef,\n  ]);\n\n  return [open, setOpen] as const;\n};\n"],"names":["React","resolvePositioningShorthand","usePositioningMouseTarget","usePositioning","useSafeZoneArea","usePositioningSlideDirection","presenceMotionSlot","useControllableState","useId","useOnClickOutside","useEventCallback","useOnScrollOutside","elementContains","useTimeout","useMergedRefs","useFluent_unstable","useFluent","useFocusFinders","useMenuContext_unstable","MENU_SAFEZONE_TIMEOUT_EVENT","MENU_ENTER_EVENT","useOnMenuMouseEnter","useIsSubmenu","menuItemClassNames","MenuSurfaceMotion","submenuFallbackPositions","useMenu_unstable","props","surfaceMotion","baseProps","baseState","useMenuBase_unstable","components","elementType","defaultProps","visible","open","appear","unmountOnExit","isSubmenu","hoverDelay","inline","hasCheckmarks","hasIcons","closeOnScroll","openOnContext","persistOnItemClick","unstable_disableAutoFocus","disableAutoFocus","openOnHover","defaultCheckedValues","mountNode","safeZone","targetDocument","triggerId","contextTarget","setContextTarget","resolvedPositioning","positioning","handlePositionEnd","onPositioningEnd","positioningOptions","position","align","target","undefined","fallbackPositions","children","Children","toArray","process","env","NODE_ENV","length","console","warn","menuTrigger","menuPopover","targetRef","containerRef","enableSafeZone","safeZoneDescriptorRef","useRef","isInside","mouseCoordinates","x","y","safeZoneHandle","disabled","timeout","onSafeZoneEnter","e","setOpen","keyboard","type","event","current","onSafeZoneLeave","onSafeZoneMove","clientX","clientY","onSafeZoneTimeout","CustomEvent","elementsInPoint","elementsFromPoint","menuItemEl","find","el","classList","contains","root","dispatchEvent","triggerRef","menuPopoverRef","useMenuOpenState","defaultOpen","onOpenChange","checkedValues","onCheckedValueChange","useMenuSelectableState","elementToRender","setCheckedValues","state","defaultState","initialState","name","checkedItems","currentValue","parentSetOpen","context","data","enteringTriggerRef","setOpenState","trySetOpen","detail","nativeEvent","bubble","setOpenTimeout","clearOpenTimeout","Event","persist","shouldUseDelay","ignoreHoverDelay","element","refs","filter","Boolean","callback","findFirstFocusable","focusFirst","useCallback","firstFocusable","focus","previousOpenRef","useEffect","wasOpen","activeElement","body"],"mappings":"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"}

package/lib/components/Menu/useMenuContextValues.js

@@ -1,7 +1,7 @@
 'use client';
 import * as React from "react";
 export function useMenuContextValues_unstable(state) {
-    const { checkedValues, hasCheckmarks, hasIcons, inline, isSubmenu, menuPopoverRef, mountNode, onCheckedValueChange, open, openOnContext, openOnHover, persistOnItemClick, safeZone, setOpen, triggerId, triggerRef } = state;
+    const { checkedValues, hasCheckmarks, hasIcons, inline, isSubmenu, menuPopoverRef, mountNode, onCheckedValueChange, open, openOnContext, openOnHover, persistOnItemClick, safeZone, setOpen, triggerId, triggerRef, unstable_disableAutoFocus: disableAutoFocus } = state;
     const menu = React.useMemo(()=>({
             checkedValues,
             hasCheckmarks,
@@ -18,7 +18,9 @@ export function useMenuContextValues_unstable(state) {
             safeZone,
             setOpen,
             triggerId,
-            triggerRef
+            triggerRef,
+            // eslint-disable-next-line @typescript-eslint/naming-convention -- matches the unstable Popover API
+            unstable_disableAutoFocus: disableAutoFocus
         }), [
         checkedValues,
         hasCheckmarks,
@@ -35,7 +37,8 @@ export function useMenuContextValues_unstable(state) {
         safeZone,
         setOpen,
         triggerId,
-        triggerRef
+        triggerRef,
+        disableAutoFocus
     ]);
     return {
         menu

package/lib/components/Menu/useMenuContextValues.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/components/Menu/useMenuContextValues.ts"],"sourcesContent":["'use client';\n\nimport * as React from 'react';\nimport type { MenuContextValues, MenuState } from './Menu.types';\n\nexport function useMenuContextValues_unstable(state: MenuState): MenuContextValues {\n  const {\n    checkedValues,\n    hasCheckmarks,\n    hasIcons,\n    inline,\n    isSubmenu,\n    menuPopoverRef,\n    mountNode,\n    onCheckedValueChange,\n    open,\n    openOnContext,\n    openOnHover,\n    persistOnItemClick,\n    safeZone,\n    setOpen,\n    triggerId,\n    triggerRef,\n  } = state;\n\n  const menu = React.useMemo(\n    () => ({\n      checkedValues,\n      hasCheckmarks,\n      hasIcons,\n      inline,\n      isSubmenu,\n      menuPopoverRef,\n      mountNode,\n      onCheckedValueChange,\n      open,\n      openOnContext,\n      openOnHover,\n      persistOnItemClick,\n      safeZone,\n      setOpen,\n      triggerId,\n      triggerRef,\n    }),\n    [\n      checkedValues,\n      hasCheckmarks,\n      hasIcons,\n      inline,\n      isSubmenu,\n      menuPopoverRef,\n      mountNode,\n      onCheckedValueChange,\n      open,\n      openOnContext,\n      openOnHover,\n      persistOnItemClick,\n      safeZone,\n      setOpen,\n      triggerId,\n      triggerRef,\n    ],\n  );\n\n  return { menu };\n}\n"],"names":["React","useMenuContextValues_unstable","state","checkedValues","hasCheckmarks","hasIcons","inline","isSubmenu","menuPopoverRef","mountNode","onCheckedValueChange","open","openOnContext","openOnHover","persistOnItemClick","safeZone","setOpen","triggerId","triggerRef","menu","useMemo"],"mappings":"AAAA;AAEA,YAAYA,WAAW,QAAQ;AAG/B,OAAO,SAASC,8BAA8BC,KAAgB;IAC5D,MAAM,EACJC,aAAa,EACbC,aAAa,EACbC,QAAQ,EACRC,MAAM,EACNC,SAAS,EACTC,cAAc,EACdC,SAAS,EACTC,oBAAoB,EACpBC,IAAI,EACJC,aAAa,EACbC,WAAW,EACXC,kBAAkB,EAClBC,QAAQ,EACRC,OAAO,EACPC,SAAS,EACTC,UAAU,EACX,GAAGhB;IAEJ,MAAMiB,OAAOnB,MAAMoB,OAAO,CACxB,IAAO,CAAA;YACLjB;YACAC;YACAC;YACAC;YACAC;YACAC;YACAC;YACAC;YACAC;YACAC;YACAC;YACAC;YACAC;YACAC;YACAC;YACAC;QACF,CAAA,GACA;QACEf;QACAC;QACAC;QACAC;QACAC;QACAC;QACAC;QACAC;QACAC;QACAC;QACAC;QACAC;QACAC;QACAC;QACAC;QACAC;KACD;IAGH,OAAO;QAAEC;IAAK;AAChB"}
+{"version":3,"sources":["../src/components/Menu/useMenuContextValues.ts"],"sourcesContent":["'use client';\n\nimport * as React from 'react';\nimport type { MenuContextValues, MenuState } from './Menu.types';\n\nexport function useMenuContextValues_unstable(state: MenuState): MenuContextValues {\n  const {\n    checkedValues,\n    hasCheckmarks,\n    hasIcons,\n    inline,\n    isSubmenu,\n    menuPopoverRef,\n    mountNode,\n    onCheckedValueChange,\n    open,\n    openOnContext,\n    openOnHover,\n    persistOnItemClick,\n    safeZone,\n    setOpen,\n    triggerId,\n    triggerRef,\n    unstable_disableAutoFocus: disableAutoFocus,\n  } = state;\n\n  const menu = React.useMemo(\n    () => ({\n      checkedValues,\n      hasCheckmarks,\n      hasIcons,\n      inline,\n      isSubmenu,\n      menuPopoverRef,\n      mountNode,\n      onCheckedValueChange,\n      open,\n      openOnContext,\n      openOnHover,\n      persistOnItemClick,\n      safeZone,\n      setOpen,\n      triggerId,\n      triggerRef,\n      // eslint-disable-next-line @typescript-eslint/naming-convention -- matches the unstable Popover API\n      unstable_disableAutoFocus: disableAutoFocus,\n    }),\n    [\n      checkedValues,\n      hasCheckmarks,\n      hasIcons,\n      inline,\n      isSubmenu,\n      menuPopoverRef,\n      mountNode,\n      onCheckedValueChange,\n      open,\n      openOnContext,\n      openOnHover,\n      persistOnItemClick,\n      safeZone,\n      setOpen,\n      triggerId,\n      triggerRef,\n      disableAutoFocus,\n    ],\n  );\n\n  return { menu };\n}\n"],"names":["React","useMenuContextValues_unstable","state","checkedValues","hasCheckmarks","hasIcons","inline","isSubmenu","menuPopoverRef","mountNode","onCheckedValueChange","open","openOnContext","openOnHover","persistOnItemClick","safeZone","setOpen","triggerId","triggerRef","unstable_disableAutoFocus","disableAutoFocus","menu","useMemo"],"mappings":"AAAA;AAEA,YAAYA,WAAW,QAAQ;AAG/B,OAAO,SAASC,8BAA8BC,KAAgB;IAC5D,MAAM,EACJC,aAAa,EACbC,aAAa,EACbC,QAAQ,EACRC,MAAM,EACNC,SAAS,EACTC,cAAc,EACdC,SAAS,EACTC,oBAAoB,EACpBC,IAAI,EACJC,aAAa,EACbC,WAAW,EACXC,kBAAkB,EAClBC,QAAQ,EACRC,OAAO,EACPC,SAAS,EACTC,UAAU,EACVC,2BAA2BC,gBAAgB,EAC5C,GAAGlB;IAEJ,MAAMmB,OAAOrB,MAAMsB,OAAO,CACxB,IAAO,CAAA;YACLnB;YACAC;YACAC;YACAC;YACAC;YACAC;YACAC;YACAC;YACAC;YACAC;YACAC;YACAC;YACAC;YACAC;YACAC;YACAC;YACA,oGAAoG;YACpGC,2BAA2BC;QAC7B,CAAA,GACA;QACEjB;QACAC;QACAC;QACAC;QACAC;QACAC;QACAC;QACAC;QACAC;QACAC;QACAC;QACAC;QACAC;QACAC;QACAC;QACAC;QACAE;KACD;IAGH,OAAO;QAAEC;IAAK;AAChB"}

package/lib/contexts/menuContext.js

@@ -22,7 +22,9 @@ const menuContextDefaultValue = {
     hasIcons: false,
     hasCheckmarks: false,
     inline: false,
-    persistOnItemClick: false
+    persistOnItemClick: false,
+    // eslint-disable-next-line @typescript-eslint/naming-convention -- matches the unstable Popover API
+    unstable_disableAutoFocus: false
 };
 export const MenuProvider = MenuContext.Provider;
 export const useMenuContext_unstable = (selector)=>useContextSelector(MenuContext, (ctx = menuContextDefaultValue)=>selector(ctx));

package/lib/contexts/menuContext.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/contexts/menuContext.ts"],"sourcesContent":["'use client';\n\nimport type * as React from 'react';\nimport { createContext, useContextSelector } from '@fluentui/react-context-selector';\nimport type { ContextSelector, Context } from '@fluentui/react-context-selector';\nimport type { MenuState } from '../components/Menu/index';\n\nexport const MenuContext: Context<MenuContextValue> = createContext<MenuContextValue | undefined>(\n  undefined,\n) as Context<MenuContextValue>;\n\nconst menuContextDefaultValue: MenuContextValue = {\n  open: false,\n  setOpen: () => false,\n  checkedValues: {},\n  onCheckedValueChange: () => null,\n  isSubmenu: false,\n  // eslint-disable-next-line @typescript-eslint/no-deprecated\n  triggerRef: { current: null } as unknown as React.MutableRefObject<HTMLElement | null>,\n  // eslint-disable-next-line @typescript-eslint/no-deprecated\n  menuPopoverRef: { current: null } as unknown as React.MutableRefObject<HTMLElement | null>,\n  mountNode: null,\n  triggerId: '',\n  openOnContext: false,\n  openOnHover: false,\n  hasIcons: false,\n  hasCheckmarks: false,\n  inline: false,\n  persistOnItemClick: false,\n};\n\n/**\n * Context shared between Menu and its children components\n *\n * Extends and drills down MenuList props to simplify API\n */\nexport type MenuContextValue = Pick<\n  MenuState,\n  | 'openOnHover'\n  | 'openOnContext'\n  | 'triggerRef'\n  | 'menuPopoverRef'\n  | 'setOpen'\n  | 'isSubmenu'\n  | 'mountNode'\n  | 'triggerId'\n  | 'hasIcons'\n  | 'hasCheckmarks'\n  | 'persistOnItemClick'\n  | 'inline'\n  | 'checkedValues'\n  | 'onCheckedValueChange'\n  | 'safeZone'\n> & {\n  open: boolean;\n  triggerId: string;\n  /**\n   * Default values to be checked on mount\n   * @deprecated this property is not used internally anymore,\n   * the signature remains just to avoid breaking changes\n   */\n  defaultCheckedValues?: Record<string, string[]>;\n};\n\nexport const MenuProvider = MenuContext.Provider;\n\nexport const useMenuContext_unstable = <T>(selector: ContextSelector<MenuContextValue, T>): T =>\n  useContextSelector(MenuContext, (ctx = menuContextDefaultValue) => selector(ctx));\n"],"names":["createContext","useContextSelector","MenuContext","undefined","menuContextDefaultValue","open","setOpen","checkedValues","onCheckedValueChange","isSubmenu","triggerRef","current","menuPopoverRef","mountNode","triggerId","openOnContext","openOnHover","hasIcons","hasCheckmarks","inline","persistOnItemClick","MenuProvider","Provider","useMenuContext_unstable","selector","ctx"],"mappings":"AAAA;AAGA,SAASA,aAAa,EAAEC,kBAAkB,QAAQ,mCAAmC;AAIrF,OAAO,MAAMC,cAAyCF,cACpDG,WAC6B;AAE/B,MAAMC,0BAA4C;IAChDC,MAAM;IACNC,SAAS,IAAM;IACfC,eAAe,CAAC;IAChBC,sBAAsB,IAAM;IAC5BC,WAAW;IACX,4DAA4D;IAC5DC,YAAY;QAAEC,SAAS;IAAK;IAC5B,4DAA4D;IAC5DC,gBAAgB;QAAED,SAAS;IAAK;IAChCE,WAAW;IACXC,WAAW;IACXC,eAAe;IACfC,aAAa;IACbC,UAAU;IACVC,eAAe;IACfC,QAAQ;IACRC,oBAAoB;AACtB;AAmCA,OAAO,MAAMC,eAAenB,YAAYoB,QAAQ,CAAC;AAEjD,OAAO,MAAMC,0BAA0B,CAAIC,WACzCvB,mBAAmBC,aAAa,CAACuB,MAAMrB,uBAAuB,GAAKoB,SAASC,MAAM"}
+{"version":3,"sources":["../src/contexts/menuContext.ts"],"sourcesContent":["'use client';\n\nimport type * as React from 'react';\nimport { createContext, useContextSelector } from '@fluentui/react-context-selector';\nimport type { ContextSelector, Context } from '@fluentui/react-context-selector';\nimport type { MenuProps, MenuState } from '../components/Menu/index';\n\nexport const MenuContext: Context<MenuContextValue> = createContext<MenuContextValue | undefined>(\n  undefined,\n) as Context<MenuContextValue>;\n\nconst menuContextDefaultValue: MenuContextValue = {\n  open: false,\n  setOpen: () => false,\n  checkedValues: {},\n  onCheckedValueChange: () => null,\n  isSubmenu: false,\n  // eslint-disable-next-line @typescript-eslint/no-deprecated\n  triggerRef: { current: null } as unknown as React.MutableRefObject<HTMLElement | null>,\n  // eslint-disable-next-line @typescript-eslint/no-deprecated\n  menuPopoverRef: { current: null } as unknown as React.MutableRefObject<HTMLElement | null>,\n  mountNode: null,\n  triggerId: '',\n  openOnContext: false,\n  openOnHover: false,\n  hasIcons: false,\n  hasCheckmarks: false,\n  inline: false,\n  persistOnItemClick: false,\n  // eslint-disable-next-line @typescript-eslint/naming-convention -- matches the unstable Popover API\n  unstable_disableAutoFocus: false,\n};\n\n/**\n * Context shared between Menu and its children components\n *\n * Extends and drills down MenuList props to simplify API\n */\nexport type MenuContextValue = Pick<\n  MenuState,\n  | 'openOnHover'\n  | 'openOnContext'\n  | 'triggerRef'\n  | 'menuPopoverRef'\n  | 'setOpen'\n  | 'isSubmenu'\n  | 'mountNode'\n  | 'triggerId'\n  | 'hasIcons'\n  | 'hasCheckmarks'\n  | 'persistOnItemClick'\n  | 'inline'\n  | 'checkedValues'\n  | 'onCheckedValueChange'\n  | 'safeZone'\n> &\n  Pick<MenuProps, 'unstable_disableAutoFocus'> & {\n    open: boolean;\n    triggerId: string;\n    /**\n     * Default values to be checked on mount\n     * @deprecated this property is not used internally anymore,\n     * the signature remains just to avoid breaking changes\n     */\n    defaultCheckedValues?: Record<string, string[]>;\n  };\n\nexport const MenuProvider = MenuContext.Provider;\n\nexport const useMenuContext_unstable = <T>(selector: ContextSelector<MenuContextValue, T>): T =>\n  useContextSelector(MenuContext, (ctx = menuContextDefaultValue) => selector(ctx));\n"],"names":["createContext","useContextSelector","MenuContext","undefined","menuContextDefaultValue","open","setOpen","checkedValues","onCheckedValueChange","isSubmenu","triggerRef","current","menuPopoverRef","mountNode","triggerId","openOnContext","openOnHover","hasIcons","hasCheckmarks","inline","persistOnItemClick","unstable_disableAutoFocus","MenuProvider","Provider","useMenuContext_unstable","selector","ctx"],"mappings":"AAAA;AAGA,SAASA,aAAa,EAAEC,kBAAkB,QAAQ,mCAAmC;AAIrF,OAAO,MAAMC,cAAyCF,cACpDG,WAC6B;AAE/B,MAAMC,0BAA4C;IAChDC,MAAM;IACNC,SAAS,IAAM;IACfC,eAAe,CAAC;IAChBC,sBAAsB,IAAM;IAC5BC,WAAW;IACX,4DAA4D;IAC5DC,YAAY;QAAEC,SAAS;IAAK;IAC5B,4DAA4D;IAC5DC,gBAAgB;QAAED,SAAS;IAAK;IAChCE,WAAW;IACXC,WAAW;IACXC,eAAe;IACfC,aAAa;IACbC,UAAU;IACVC,eAAe;IACfC,QAAQ;IACRC,oBAAoB;IACpB,oGAAoG;IACpGC,2BAA2B;AAC7B;AAoCA,OAAO,MAAMC,eAAepB,YAAYqB,QAAQ,CAAC;AAEjD,OAAO,MAAMC,0BAA0B,CAAIC,WACzCxB,mBAAmBC,aAAa,CAACwB,MAAMtB,uBAAuB,GAAKqB,SAASC,MAAM"}

package/lib-commonjs/components/Menu/Menu.types.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/components/Menu/Menu.types.ts"],"sourcesContent":["import type * as React from 'react';\nimport type { PresenceMotionSlotProps } from '@fluentui/react-motion';\nimport type { PositioningVirtualElement, SetVirtualMouseTarget } from '@fluentui/react-positioning';\nimport type { PositioningShorthand } from '@fluentui/react-positioning';\nimport type { PortalProps } from '@fluentui/react-portal';\nimport type { ComponentProps, ComponentState, JSXElement, Slot } from '@fluentui/react-utilities';\nimport type { MenuContextValue } from '../../contexts/menuContext';\nimport type { MenuListProps } from '../MenuList/MenuList.types';\n\nexport type MenuSlots = {\n  /**\n   * Slot for the surface motion animation.\n   * For more information refer to the [Motion docs page](https://react.fluentui.dev/?path=/docs/motion-motion-slot--docs).\n   */\n  surfaceMotion: Slot<PresenceMotionSlotProps>;\n};\n\nexport type InternalMenuSlots = {\n  surfaceMotion: NonNullable<Slot<PresenceMotionSlotProps>>;\n};\n\n/**\n * Extends and drills down Menulist props to simplify API\n */\nexport type MenuProps = ComponentProps<Partial<MenuSlots>> &\n  Pick<PortalProps, 'mountNode'> &\n  Pick<\n    MenuListProps,\n    'checkedValues' | 'defaultCheckedValues' | 'hasCheckmarks' | 'hasIcons' | 'onCheckedValueChange'\n  > & {\n    /**\n     * Can contain two children including `MenuTrigger` and `MenuPopover`.\n     * Alternatively can only contain `MenuPopover` if using a custom `target`.\n     */\n    children: [JSXElement, JSXElement] | JSXElement;\n\n    /**\n     * Sets the delay for mouse open/close for the popover one mouse enter/leave\n     */\n    hoverDelay?: number;\n\n    /**\n     * Root menus are rendered out of DOM order on `document.body`, use this to render the menu in DOM order\n     * This option is disregarded for submenus\n     *\n     * @default false\n     */\n    inline?: boolean;\n\n    /**\n     * Call back when the component requests to change value\n     * The `open` value is used as a hint when directly controlling the component\n     */\n    // eslint-disable-next-line @nx/workspace-consistent-callback-type -- can't change type of existing callback\n    onOpenChange?: (e: MenuOpenEvent, data: MenuOpenChangeData) => void;\n\n    /**\n     * Whether the popup is open\n     *\n     * @default false\n     */\n    open?: boolean;\n\n    /**\n     * Whether the popup is open by default\n     *\n     * @default false\n     */\n    defaultOpen?: boolean;\n\n    /**\n     * Opens the menu on right click (context menu), removes all other menu open interactions\n     *\n     * @default false\n     */\n    openOnContext?: boolean;\n\n    /**\n     * Opens the menu on hover\n     *\n     * @default false\n     */\n    openOnHover?: boolean;\n\n    /**\n     * Do not dismiss the menu when a menu item is clicked\n     *\n     * @default false\n     */\n    persistOnItemClick?: boolean;\n\n    /**\n     * Configures the positioned menu\n     */\n    positioning?: PositioningShorthand;\n\n    /**\n     * Close when scroll outside of it\n     *\n     * @default false\n     */\n    closeOnScroll?: boolean;\n  };\n\nexport type MenuState = ComponentState<InternalMenuSlots> &\n  Required<\n    Pick<\n      MenuProps,\n      | 'hasCheckmarks'\n      | 'hasIcons'\n      | 'mountNode'\n      | 'inline'\n      | 'checkedValues'\n      | 'onCheckedValueChange'\n      | 'open'\n      | 'openOnHover'\n      | 'closeOnScroll'\n      | 'hoverDelay'\n      | 'openOnContext'\n      | 'persistOnItemClick'\n    >\n  > & {\n    /**\n     * Anchors the popper to the mouse click for context events\n     */\n    contextTarget?: PositioningVirtualElement;\n\n    /**\n     * Whether this menu is a submenu\n     */\n    isSubmenu: boolean;\n\n    /**\n     * Internal react node that just simplifies handling children\n     */\n    menuPopover: React.ReactNode;\n\n    /**\n     * The ref for the popup\n     */\n    // eslint-disable-next-line @typescript-eslint/no-deprecated\n    menuPopoverRef: React.MutableRefObject<HTMLElement | null>;\n\n    /**\n     * Internal react node that just simplifies handling children\n     */\n    menuTrigger: React.ReactNode;\n\n    /**\n     * A callback to set the target of the popper to the mouse click for context events\n     */\n    setContextTarget: SetVirtualMouseTarget;\n\n    /**\n     * Callback to open/close the popup\n     */\n    setOpen: (e: MenuOpenEvent, data: MenuOpenChangeData & { ignoreHoverDelay?: boolean }) => void;\n\n    /**\n     * Id for the MenuTrigger element for aria relationship\n     */\n    triggerId: string;\n\n    /**\n     * The ref for the MenuTrigger, used for popup positioning\n     */\n    // eslint-disable-next-line @typescript-eslint/no-deprecated\n    triggerRef: React.MutableRefObject<HTMLElement | null>;\n\n    /**\n     * Call back when the component requests to change value\n     * The `open` value is used as a hint when directly controlling the component\n     * @deprecated this property is not used internally anymore,\n     * the signature remains just to avoid breaking changes\n     */\n    onOpenChange?: (e: MenuOpenEvent, data: MenuOpenChangeData) => void;\n    /**\n     * Default values to be checked on mount\n     @deprecated this property is not used internally anymore,\n     * the signature remains just to avoid breaking changes\n     */\n    defaultCheckedValues?: Record<string, string[]>;\n\n    /**\n     * An optional safe zone area to be rendered around the menu\n     */\n    safeZone?: React.ReactElement | null;\n  };\n\nexport type MenuBaseProps = Omit<MenuProps, 'surfaceMotion'>;\n\nexport type MenuBaseState = Omit<MenuState, 'surfaceMotion' | 'components'>;\n\nexport type MenuContextValues = {\n  menu: MenuContextValue;\n};\n\n/**\n * The supported events that will trigger open/close of the menu\n */\nexport type MenuOpenEvent = MenuOpenChangeData['event'];\n/**\n * @deprecated use MenuOpenEvent instead\n */\nexport type MenuOpenEvents = MenuOpenEvent;\n\n/**\n * Data attached to open/close events\n */\nexport type MenuOpenChangeData = {\n  /**\n   * indicates whether the request for the open state was bubbled from a nested menu\n   */\n  bubble?: boolean;\n  /**\n   * Indicates whether the change of state was a keyboard interaction\n   * @deprecated\n   * This should not be used, since `Enter`, `Space` and click should be interpreted as the same thing as a click\n   */\n  keyboard?: boolean;\n  open: boolean;\n} & (\n  | {\n      type: 'menuTriggerContextMenu';\n      event: React.MouseEvent<HTMLElement>;\n    }\n  | {\n      type: 'menuTriggerClick';\n      event: React.MouseEvent<HTMLElement>;\n    }\n  | {\n      type: 'menuTriggerMouseEnter';\n      event: React.MouseEvent<HTMLElement>;\n    }\n  | {\n      type: 'menuSafeZoneMouseEnter';\n      event: React.MouseEvent;\n    }\n  | {\n      type: 'menuSafeZoneTimeout';\n      event: Event;\n    }\n  | {\n      type: 'menuTriggerMouseLeave';\n      event: React.MouseEvent<HTMLElement>;\n    }\n  | {\n      type: 'menuTriggerMouseMove';\n      event: React.MouseEvent<HTMLElement>;\n    }\n  | {\n      type: 'menuTriggerKeyDown';\n      event: React.KeyboardEvent<HTMLElement>;\n    }\n  | {\n      type: 'menuItemClick';\n      event: React.MouseEvent<HTMLElement>;\n    }\n  | {\n      type: 'menuPopoverMouseEnter';\n      event: React.MouseEvent<HTMLElement>;\n    }\n  | {\n      type: 'menuPopoverKeyDown';\n      event: React.KeyboardEvent<HTMLElement>;\n    }\n  | {\n      type: 'clickOutside';\n      event: MouseEvent | TouchEvent;\n    }\n  | {\n      type: 'scrollOutside';\n      event: MouseEvent | TouchEvent;\n    }\n  | {\n      type: 'menuMouseEnter';\n      event: MouseEvent | TouchEvent;\n    }\n);\n"],"names":[],"mappings":"AA8MA;;CAEC,GACD,WAqEE"}
+{"version":3,"sources":["../src/components/Menu/Menu.types.ts"],"sourcesContent":["import type * as React from 'react';\nimport type { PresenceMotionSlotProps } from '@fluentui/react-motion';\nimport type { PositioningVirtualElement, SetVirtualMouseTarget } from '@fluentui/react-positioning';\nimport type { PositioningShorthand } from '@fluentui/react-positioning';\nimport type { PortalProps } from '@fluentui/react-portal';\nimport type { ComponentProps, ComponentState, JSXElement, Slot } from '@fluentui/react-utilities';\nimport type { MenuContextValue } from '../../contexts/menuContext';\nimport type { MenuListProps } from '../MenuList/MenuList.types';\n\nexport type MenuSlots = {\n  /**\n   * Slot for the surface motion animation.\n   * For more information refer to the [Motion docs page](https://react.fluentui.dev/?path=/docs/motion-motion-slot--docs).\n   */\n  surfaceMotion: Slot<PresenceMotionSlotProps>;\n};\n\nexport type InternalMenuSlots = {\n  surfaceMotion: NonNullable<Slot<PresenceMotionSlotProps>>;\n};\n\n/**\n * Extends and drills down Menulist props to simplify API\n */\nexport type MenuProps = ComponentProps<Partial<MenuSlots>> &\n  Pick<PortalProps, 'mountNode'> &\n  Pick<\n    MenuListProps,\n    'checkedValues' | 'defaultCheckedValues' | 'hasCheckmarks' | 'hasIcons' | 'onCheckedValueChange'\n  > & {\n    /**\n     * Can contain two children including `MenuTrigger` and `MenuPopover`.\n     * Alternatively can only contain `MenuPopover` if using a custom `target`.\n     */\n    children: [JSXElement, JSXElement] | JSXElement;\n\n    /**\n     * Sets the delay for mouse open/close for the popover one mouse enter/leave\n     */\n    hoverDelay?: number;\n\n    /**\n     * Root menus are rendered out of DOM order on `document.body`, use this to render the menu in DOM order\n     * This option is disregarded for submenus\n     *\n     * @default false\n     */\n    inline?: boolean;\n\n    /**\n     * Call back when the component requests to change value\n     * The `open` value is used as a hint when directly controlling the component\n     */\n    // eslint-disable-next-line @nx/workspace-consistent-callback-type -- can't change type of existing callback\n    onOpenChange?: (e: MenuOpenEvent, data: MenuOpenChangeData) => void;\n\n    /**\n     * Whether the popup is open\n     *\n     * @default false\n     */\n    open?: boolean;\n\n    /**\n     * Whether the popup is open by default\n     *\n     * @default false\n     */\n    defaultOpen?: boolean;\n\n    /**\n     * Disables automatically focusing the first item when this menu opens.\n     * Does not affect focus restoration on close or autofocus in nested menus.\n     * The consumer is responsible for accessible trigger semantics, deliberate\n     * keyboard entry, and dismissal while focus remains outside the menu.\n     *\n     * @default false\n     */\n    // eslint-disable-next-line @typescript-eslint/naming-convention -- matches the unstable Popover API\n    unstable_disableAutoFocus?: boolean;\n\n    /**\n     * Opens the menu on right click (context menu), removes all other menu open interactions\n     *\n     * @default false\n     */\n    openOnContext?: boolean;\n\n    /**\n     * Opens the menu on hover\n     *\n     * @default false\n     */\n    openOnHover?: boolean;\n\n    /**\n     * Do not dismiss the menu when a menu item is clicked\n     *\n     * @default false\n     */\n    persistOnItemClick?: boolean;\n\n    /**\n     * Configures the positioned menu\n     */\n    positioning?: PositioningShorthand;\n\n    /**\n     * Close when scroll outside of it\n     *\n     * @default false\n     */\n    closeOnScroll?: boolean;\n  };\n\nexport type MenuState = ComponentState<InternalMenuSlots> &\n  Required<\n    Pick<\n      MenuProps,\n      | 'hasCheckmarks'\n      | 'hasIcons'\n      | 'mountNode'\n      | 'inline'\n      | 'checkedValues'\n      | 'onCheckedValueChange'\n      | 'open'\n      | 'openOnHover'\n      | 'closeOnScroll'\n      | 'hoverDelay'\n      | 'openOnContext'\n      | 'persistOnItemClick'\n      | 'unstable_disableAutoFocus'\n    >\n  > & {\n    /**\n     * Anchors the popper to the mouse click for context events\n     */\n    contextTarget?: PositioningVirtualElement;\n\n    /**\n     * Whether this menu is a submenu\n     */\n    isSubmenu: boolean;\n\n    /**\n     * Internal react node that just simplifies handling children\n     */\n    menuPopover: React.ReactNode;\n\n    /**\n     * The ref for the popup\n     */\n    // eslint-disable-next-line @typescript-eslint/no-deprecated\n    menuPopoverRef: React.MutableRefObject<HTMLElement | null>;\n\n    /**\n     * Internal react node that just simplifies handling children\n     */\n    menuTrigger: React.ReactNode;\n\n    /**\n     * A callback to set the target of the popper to the mouse click for context events\n     */\n    setContextTarget: SetVirtualMouseTarget;\n\n    /**\n     * Callback to open/close the popup\n     */\n    setOpen: (e: MenuOpenEvent, data: MenuOpenChangeData & { ignoreHoverDelay?: boolean }) => void;\n\n    /**\n     * Id for the MenuTrigger element for aria relationship\n     */\n    triggerId: string;\n\n    /**\n     * The ref for the MenuTrigger, used for popup positioning\n     */\n    // eslint-disable-next-line @typescript-eslint/no-deprecated\n    triggerRef: React.MutableRefObject<HTMLElement | null>;\n\n    /**\n     * Call back when the component requests to change value\n     * The `open` value is used as a hint when directly controlling the component\n     * @deprecated this property is not used internally anymore,\n     * the signature remains just to avoid breaking changes\n     */\n    onOpenChange?: (e: MenuOpenEvent, data: MenuOpenChangeData) => void;\n    /**\n     * Default values to be checked on mount\n     @deprecated this property is not used internally anymore,\n     * the signature remains just to avoid breaking changes\n     */\n    defaultCheckedValues?: Record<string, string[]>;\n\n    /**\n     * An optional safe zone area to be rendered around the menu\n     */\n    safeZone?: React.ReactElement | null;\n  };\n\nexport type MenuBaseProps = Omit<MenuProps, 'surfaceMotion'>;\n\nexport type MenuBaseState = Omit<MenuState, 'surfaceMotion' | 'components'>;\n\nexport type MenuContextValues = {\n  menu: MenuContextValue;\n};\n\n/**\n * The supported events that will trigger open/close of the menu\n */\nexport type MenuOpenEvent = MenuOpenChangeData['event'];\n/**\n * @deprecated use MenuOpenEvent instead\n */\nexport type MenuOpenEvents = MenuOpenEvent;\n\n/**\n * Data attached to open/close events\n */\nexport type MenuOpenChangeData = {\n  /**\n   * indicates whether the request for the open state was bubbled from a nested menu\n   */\n  bubble?: boolean;\n  /**\n   * Indicates whether the change of state was a keyboard interaction\n   * @deprecated\n   * This should not be used, since `Enter`, `Space` and click should be interpreted as the same thing as a click\n   */\n  keyboard?: boolean;\n  open: boolean;\n} & (\n  | {\n      type: 'menuTriggerContextMenu';\n      event: React.MouseEvent<HTMLElement>;\n    }\n  | {\n      type: 'menuTriggerClick';\n      event: React.MouseEvent<HTMLElement>;\n    }\n  | {\n      type: 'menuTriggerMouseEnter';\n      event: React.MouseEvent<HTMLElement>;\n    }\n  | {\n      type: 'menuSafeZoneMouseEnter';\n      event: React.MouseEvent;\n    }\n  | {\n      type: 'menuSafeZoneTimeout';\n      event: Event;\n    }\n  | {\n      type: 'menuTriggerMouseLeave';\n      event: React.MouseEvent<HTMLElement>;\n    }\n  | {\n      type: 'menuTriggerMouseMove';\n      event: React.MouseEvent<HTMLElement>;\n    }\n  | {\n      type: 'menuTriggerKeyDown';\n      event: React.KeyboardEvent<HTMLElement>;\n    }\n  | {\n      type: 'menuItemClick';\n      event: React.MouseEvent<HTMLElement>;\n    }\n  | {\n      type: 'menuPopoverMouseEnter';\n      event: React.MouseEvent<HTMLElement>;\n    }\n  | {\n      type: 'menuPopoverKeyDown';\n      event: React.KeyboardEvent<HTMLElement>;\n    }\n  | {\n      type: 'clickOutside';\n      event: MouseEvent | TouchEvent;\n    }\n  | {\n      type: 'scrollOutside';\n      event: MouseEvent | TouchEvent;\n    }\n  | {\n      type: 'menuMouseEnter';\n      event: MouseEvent | TouchEvent;\n    }\n);\n"],"names":[],"mappings":"AA0NA;;CAEC,GACD,WAqEE"}

package/lib-commonjs/components/Menu/useMenu.cjs

@@ -58,7 +58,7 @@ const useMenu_unstable = (props)=>{
 };
 const useMenuBase_unstable = (props)=>{
     const isSubmenu = (0, _index.useIsSubmenu)();
-    const { hoverDelay = 500, inline = false, hasCheckmarks = false, hasIcons = false, closeOnScroll = false, openOnContext = false, persistOnItemClick = false, openOnHover = isSubmenu, defaultCheckedValues, mountNode = null, safeZone } = props;
+    const { hoverDelay = 500, inline = false, hasCheckmarks = false, hasIcons = false, closeOnScroll = false, openOnContext = false, persistOnItemClick = false, unstable_disableAutoFocus: disableAutoFocus = false, openOnHover = isSubmenu, defaultCheckedValues, mountNode = null, safeZone } = props;
     const { targetDocument } = (0, _reactsharedcontexts.useFluent_unstable)();
     const triggerId = (0, _reactutilities.useId)('menu');
     const [contextTarget, setContextTarget] = (0, _reactpositioning.usePositioningMouseTarget)();
@@ -154,7 +154,8 @@ const useMenuBase_unstable = (props)=>{
         open: props.open,
         defaultOpen: props.defaultOpen,
         onOpenChange: props.onOpenChange,
-        openOnContext
+        openOnContext,
+        disableAutoFocus
     });
     const [checkedValues, onCheckedValueChange] = useMenuSelectableState({
         checkedValues: props.checkedValues,
@@ -183,6 +184,8 @@ const useMenuBase_unstable = (props)=>{
         checkedValues,
         onCheckedValueChange,
         persistOnItemClick,
+        // eslint-disable-next-line @typescript-eslint/naming-convention -- matches the unstable Popover API
+        unstable_disableAutoFocus: disableAutoFocus,
         safeZone: safeZoneHandle.elementToRender
     };
 };
@@ -317,14 +320,17 @@ const useMenuOpenState = (state)=>{
         findFirstFocusable,
         state.menuPopoverRef
     ]);
-    const firstMount = (0, _reactutilities.useFirstMount)();
+    const previousOpenRef = _react.useRef(open);
     _react.useEffect(()=>{
+        const wasOpen = previousOpenRef.current;
+        previousOpenRef.current = open;
         if (open) {
-            focusFirst();
+            if (!state.disableAutoFocus) {
+                focusFirst();
+            }
         } else {
-            // Skip the initial render — focus should only be restored when the menu
-            // transitions from open → closed, not on mount.
-            if (!firstMount) {
+            // Restore only on an open -> closed transition, not on unrelated option changes.
+            if (wasOpen) {
                 var // (e.g. during an exit animation), so focus may still be inside the
                 // popover even though `open` is already false. Proactively move it
                 // to the trigger before the DOM element is eventually removed.
@@ -342,11 +348,10 @@ const useMenuOpenState = (state)=>{
                 }
             }
         }
-    // firstMount change should not re-run this effect
-    // eslint-disable-next-line react-hooks/exhaustive-deps
     }, [
         state.triggerRef,
         state.isSubmenu,
+        state.disableAutoFocus,
         open,
         focusFirst,
         targetDocument,