unstale

npm / @radix-ui/react-navigation-menu

@radix-ui/react-navigation-menu

What changed in @radix-ui/react-navigation-menu 1, from its official release notes, upgrade guides and advisories. Sources checked 2026-10-20.

1 breaking4 new APIs and options1 performance1 tooling8 fixes and other

See which of these apply to your code, ranked, in your agent:

npx @unstale/cli init

@unstale/cli 0.2.1 on npm

@radix-ui/react-navigation-menu 115 changes

Breaking changes 1

  • Active content now renders inside the consumer's element alongside its existing children, rather than replacing them.

    1.3.0release notes

New APIs and options 4

  • Added a prop to choose automatic or manual trigger activation; automatic remains the default.

    1.3.0release notes

  • Added a prop to choose automatic or manual trigger activation; when omitted, the submenu inherits the parent root's value.

    1.3.0release notes

  • Added a prop controlling whether clicking an already-open submenu trigger keeps it open or toggles it closed; the default preserves existing behavior.

    1.3.0release notes

  • Added CSS custom properties for item indicators' translate values, allowing developers to use them in styling.

    1.2.18release notes

Performance 1

  • Bundlers can drop unused components more effectively, improving dead-code elimination.

    1.2.19release notes

Tooling 1

  • The package is republished through CI so it includes a provenance attestation, which developers can use when evaluating package provenance.

    1.2.20release notes

Fixes and other changes 8

  • Fixed a type regression so callback props declared as methods accept handlers whose parameter is narrower than the prop's.

    1.4.1release notes

  • The content element now has a data-state attribute when using NavigationMenu.Viewport.

    1.4.0release notes

  • Optional types now allow explicit undefined, making them compatible with TypeScript's exactOptionalPropertyTypes flag.

    1.4.0release notes

  • Fixed a bug where a submenu's defaultValue was reset when an external element was focused before the menu opened.

    1.3.0release notes

  • Reverted breaking changes that caused compatibility issues with React Server Components.

    1.2.22release notes

  • Fixed an infinite re-render loop in React 19 caused by unstable composed ref callback references.

    1.2.17release notes

  • Fixed errors that surfaced when consuming multiple packages together.

    1.2.16release notes

  • Triggers no longer reference a non-existent element via aria-controls when their content is removed from the DOM.

    1.2.15release notes