Skip to content

Menu 1.0.0 — native React menus

Choose a tag to compare

@RentnerKev RentnerKev released this 29 Oct 19:22
· 22 commits to main since this release

RentnerMenu release banner

First stable release of @rentnerkev/menu: native React dropdown and context menus with a shared typed item model, keyboard navigation and RentnerKev styling.

Included

  • Actions, native links, downloads, checkbox and radio entries, mixed checkbox states, labels, separators and nested submenus.
  • Keyboard navigation, typeahead, LTR/RTL, touch long press, diagonal submenu pointer paths and focus restoration.
  • Controlled or uncontrolled state, custom button triggers through asChild, providers, theme tokens and portal containers.
  • Optional modal behavior with background isolation, scroll locking, dialog/shadow-root support and precise cleanup.
  • Cached navigation, memoized entries and frame-batched positioning. Pure focus changes do not trigger React commits.
  • Read-only installed-version documentation and API helpers through @rentnerkev/menu/ai, plus hosted MCP/JSON/Markdown discovery.

Install

npm install @rentnerkev/menu@1.0.0 react@^19 react-dom@^19

Import @rentnerkev/menu/tailwind.css in a Tailwind CSS 4 application. React and React DOM are the only runtime peers; no Radix, Motion or positioning-library dependency is required.

Links

The matching seventh package card, localized manuals and playground are prepared in RentnerPackages; their public availability follows that site's deployment.

Upgrading from 0.1.x

Existing component usage remains supported. Public types now include MenuLinkItem (type: 'link') and checked: boolean | 'indeterminate'; exhaustive application switches or Boolean-only reads should handle those cases. Checkbox change callbacks still emit booleans. Selection cancellation also cancels native link navigation. Shortcut labels are display hints and do not register global hotkeys. Default behavior remains nonmodal; asChild requires exactly one native button with forwarded props and ref.

Validation

The exact source passed full checks, packed-consumer Node ESM/SSR/TypeScript checks, React 19.0.0/19.3.1 compatibility and Chromium/Firefox/WebKit browser scenarios, including accessibility, links, downloads, immediate Escape, pointer paths, Tab and modal cleanup. Release automation rechecks the tagged source and publishes with npm Trusted Publishing and provenance.

Measured dropdown bundle: approximately 10 kB gzip with shared React external, versus 32 kB in the comparable Radix fixture. This is a bundle-size comparison, not a universal runtime speed claim. Reproduce the version-pinned performance comparison with bun run benchmark; see implementation and benchmark details.

Release · v1.0.0

Stable Release · Published on 29 October 2026

Changelog

v0.1.1...v1.0.0

🌟 Features

  • extend native menu interactions and accessibility (#3) (9d29d62)

📝 Docs

  • prepare Menu 1.0.0 documentation and package links (f0e4be8)