Repository navigation
Releases
v1.2.0
- Add optional onSelectAsync, pendingLabel, errorLabel and onActionError for action entries.
- Prevent duplicate execution, expose pending/error feedback, allow retries and close automatically only after success.
- Preserve synchronous callbacks and cancellation, and guard reopened sessions against stale completions.
- Restore keyboard focus correctly after pending completion in ShadowRoot portals.
Verified with typechecks, unit tests, Chromium/Firefox/WebKit, production builds and installed-package consumers.
Release · v1.2.0
Stable Release · Published on 17 November 2026
Changelog
🌟 Features
🐛 Fixes
- restrict autofix to supported formatter files (2a20a0b)
📦 Dependencies
- bump @testing-library/user-event (#18) (27823b5)
- bump the routine-updates group with 2 updates (#17) (83e0555)
🧹 Chores
- complete community and supply-chain automation (9bfeb6d)
@rentnerkev/menu 1.1.0
Context menus and customization
- Clicking outside the menu surfaces now dismisses a context menu even within its original target. Native actions and focus are preserved, and regular and embedded dropdown buttons continue to toggle correctly.
MenuProvider.menuandMenuProvider.contextMenuprovide separate positioning defaults. Unless overridden, pointer-opened context menus appear to the right in LTR and to the left in RTL; keyboard-opened menus remain anchored to the target rectangle. Local overrides and viewport collisions are respected.- Action icons, checkbox/radio indicators, and submenu arrows can be styled independently. Items with both an icon and a selection indicator retain aligned columns.
- New typed design tokens control spacing, borders, and radii without additional runtime dependencies.
- Long presses suppress unintended follow-up actions without blocking subsequent keyboard activation. Documentation, playground examples, and regression tests have been expanded.
- Development dependencies have been updated.
Upgrade notes
Existing props and classNames keys remain supported. Shared provider defaults still apply to both menu types; type-specific defaults can override them per property.
The indicator slot now styles selection marks only. Action icons inherit the action's text color by default; use classNames.icon to retain a previous icon color. The new classNames.submenuIndicator slot styles submenu arrows independently. The new pointer positioning defaults apply only when no explicit or inherited side is configured.
Implemented in PR #16, fixing Issue #15.
Release · v1.1.0
Stable Release · Published on 13 November 2026
Changelog
🐛 Fixes
📦 Dependencies
- bump the routine-updates group across 1 directory with 2 updates (#13) (1afe482)
- bump @testing-library/user-event (#14) (5a9fb10)
- bump oxlint from 1.92.0 to 1.93.0 in the routine-updates group (#12) (a673f58)
- bump the routine-updates group across 1 directory with 2 updates (#11) (6801631)
- bump the routine-updates group in /playground with 2 updates (#10) (7a82056)
@rentnerkev/menu 1.0.2
Wartungsrelease für Menü-Lebenszyklen und aktuelle React-Werkzeuge.
- Interne Zustandsverwaltung für Menüauswahl, Popup-Positionierung und Aufräumen an die aktuellen React-Prüfungen angepasst.
- Abhängigkeiten und Entwicklungswerkzeuge aktualisiert.
- CI und Release-Verifikation installieren Browser über die gesperrte Playwright-Version des Projekts.
Kompatibilität: Keine Änderungen an der öffentlichen Menü-API.
Release · v1.0.2
Stable Release · Published on 6 November 2026
Changelog
🐛 Fixes
- preserve menu lifecycle state with current React lint checks (9f223ac)
📦 Dependencies
- bump the routine-updates group across 1 directory with 3 updates (#6) (5b19a8d)
- bump @types/node (#5) (a6c70bd)
🤖 CI
v1.0.1 — Mouse hover menus
Mouse hover menus
Menu now supports opt-in mouse hover opening through openOnHover.
hoverOpenDelayMsdefaults to 100 ms andhoverCloseDelayMsto 150 ms.- Hover leaves the currently focused control in place, bridges the trigger/popup gap and cancels pending timers on departure, disable or unmount.
- Keyboard activation takes ownership from hover; Escape also dismisses a hovered popup while focus remains in another control.
- Click, touch, custom triggers and controlled state retain their existing behavior. Modal menus stay click and keyboard operated.
Includes packaged usage documentation, a bilingual playground example and regression coverage across Chromium, Firefox and WebKit. Existing menus remain click-only unless hover is explicitly enabled.
Full changes: #4
Release · v1.0.1
Stable Release · Published on 29 October 2026
Changelog
🌟 Features
Menu 1.0.0 — native React menus
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@^19Import @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
🌟 Features
📝 Docs
- prepare Menu 1.0.0 documentation and package links (f0e4be8)
v0.1.1
Accessible React action and context menus with nested submenus, keyboard navigation, checkbox and radio items, and shared RentnerKev styling.
This is the first automated npm release after the one-time package registration. GitHub Actions verifies the tagged source and publishes with npm Trusted Publishing and provenance.
Release · v0.1.1
Stable Release · Published on 28 October 2026
Changelog
🌟 Features
- add native dropdown and context menu package with playground (2a5fd28)
🐛 Fixes
- playground: simplify examples and align shared release banner (48248ee)
- ci: retain human approval for dependency pull requests (b795a77)
📝 Docs
- reflect configured npm trusted publishing (ee32917)
🧹 Chores
- align package documentation and Dependabot automation (265975b)





