react-aria-menubutton 7.0.3 → 8.0.0

package/README.md

@@ -1,6 +1,6 @@
-# react-aria-menubutton [![Build Status](https://travis-ci.org/davidtheclark/react-aria-menubutton.svg?branch=master)](https://travis-ci.org/davidtheclark/react-aria-menubutton)
+# react-aria-menubutton [![Build Status](https://github.com/davidtheclark/react-aria-menubutton/actions/workflows/build.yml/badge.svg)](https://github.com/davidtheclark/react-aria-menubutton/actions)
 
-A React component (set of components, really) that will help you build accessible menu buttons by providing keyboard interactions and ARIA attributes aligned with [the WAI-ARIA Menu Button Design Pattern](http://www.w3.org/TR/wai-aria-practices/#menubutton).
+A fully accessible, flexible React menu button component with built-in **TypeScript support**. Provides keyboard interactions and ARIA attributes aligned with [the WAI-ARIA Menu Button Design Pattern](http://www.w3.org/TR/wai-aria-practices/#menubutton).
 
 Please check out [the demo](https://davidtheclark.github.io/react-aria-menubutton/demo/).
 
@@ -58,25 +58,27 @@ It does not provide any classes or a stylesheet that you'll have to figure out h
 npm install react-aria-menubutton
 ```
 
-The modular approach of this library means you're much better off building it into your code with a module bundling system like browserify or webpack.
+**TypeScript users:** This library is written in TypeScript and ships with built-in type declarations. No need to install `@types` packages!
 
-But if you need a UMD version (which will include `focus-group` and `teeny-tap` in the bundle, but of course not `React` or `ReactDOM`), you can get it via npmcdm at `https://unpkg.com/react-aria-menubutton@[version-of-choice]/umd/ReactAriaMenuButton.js`.
-If you don't know about unpkg, [read about it here](https://unpkg.com).
+The modular approach of this library means you're much better off building it into your code with a module bundling system like Vite, webpack, or similar.
 
 ## Browser Support
 
-Basically IE9+.
+Modern browsers (ES2020+). For older browser support, you may need to transpile the library.
 
 ## Usage
 
-```js
-const AriaMenuButton = require('react-aria-menubutton');
-
-// Now use AriaMenuButton.Wrapper, AriaMenuButton.Button,
-// AriaMenuButton.Menu, and AriaMenuButton.MenuItem ...
+```tsx
+import { Wrapper, Button, Menu, MenuItem } from 'react-aria-menubutton';
 
-// ... or with es2015
-import { Button, Wrapper, Menu, MenuItem } from 'react-aria-menubutton';
+// TypeScript: You can also import types
+import type { 
+  WrapperProps, 
+  ButtonProps, 
+  MenuProps, 
+  MenuItemProps,
+  MenuChildrenState 
+} from 'react-aria-menubutton';
 ```
 
 ## Examples
@@ -85,128 +87,114 @@ For details about why the examples work, read the API documentation below.
 
 You can also see more examples by looking in `demo/`.
 
-```js
-// Very simple ES2015 example
+### Basic Example (TypeScript)
 
-import React from 'react';
+```tsx
+import { useState } from 'react';
 import { Wrapper, Button, Menu, MenuItem } from 'react-aria-menubutton';
 
 const menuItemWords = ['foo', 'bar', 'baz'];
 
-class MyMenuButton extends React.Component {
-  render() {
-    const menuItems = menuItemWords.map((word, i) => {
-      return (
-        <li key={i}>
-          <MenuItem className='MyMenuButton-menuItem'>
-            {word}
-          </MenuItem>
-        </li>
-      );
-    });
+function MyMenuButton() {
+  const [selected, setSelected] = useState('');
 
-    return (
-      <Wrapper
-        className='MyMenuButton'
-        onSelection={handleSelection}
-      >
-        <Button className='MyMenuButton-button'>
-          click me
-        </Button>
-        <Menu className='MyMenuButton-menu'>
+  const handleSelection = (value: unknown) => {
+    setSelected(value as string);
+  };
+
+  const menuItems = menuItemWords.map((word, i) => (
+    <li key={i}>
+      <MenuItem className="MyMenuButton-menuItem">{word}</MenuItem>
+    </li>
+  ));
+
+  return (
+    <div>
+      <Wrapper className="MyMenuButton" onSelection={handleSelection}>
+        <Button className="MyMenuButton-button">click me</Button>
+        <Menu className="MyMenuButton-menu">
           <ul>{menuItems}</ul>
         </Menu>
       </Wrapper>
-    );
-  }
+      <p>Selected: {selected}</p>
+    </div>
+  );
 }
+```
 
-function handleSelection(value, event) { .. }
+### Advanced Example with Typed Values
+
+```tsx
+import { useState } from 'react';
+import { 
+  Wrapper, 
+  Button, 
+  Menu, 
+  MenuItem,
+  type MenuChildrenState 
+} from 'react-aria-menubutton';
+
+interface Person {
+  name: string;
+  id: number;
+}
+
+const people: Person[] = [
+  { name: 'Charles Choo-Choo', id: 1242 },
+  { name: 'Mina Meowmers', id: 8372 },
+  { name: 'Susan Sailor', id: 2435 },
+];
+
+function PeopleMenu() {
+  const [selectedId, setSelectedId] = useState<number | null>(null);
+
+  const handleSelection = (value: unknown) => {
+    setSelectedId(value as number);
+  };
+
+  const menuItems = people.map((person) => (
+    <MenuItem
+      key={person.id}
+      tag="li"
+      value={person.id}
+      text={person.name}
+      className="PeopleMenu-person"
+    >
+      <div className="PeopleMenu-personName">{person.name}</div>
+    </MenuItem>
+  ));
+
+  // Using function children with typed state
+  const menuContent = (menuState: MenuChildrenState) => {
+    if (!menuState.isOpen) return null;
+    return <ul className="PeopleMenu-menu">{menuItems}</ul>;
+  };
+
+  return (
+    <Wrapper className="PeopleMenu" onSelection={handleSelection}>
+      <Button className="PeopleMenu-trigger">Select a person</Button>
+      <Menu>{menuContent}</Menu>
+    </Wrapper>
+  );
+}
 ```
 
-```js
-// Slightly more complex, ES5 example:
-// - MenuItems have hidden values that are passed
-//   to the selection handler
-// - User can navigate the MenuItems by typing the
-//   first letter of a person's name, even though
-//   each MenuItem's child is not simple text
-// - Menu has a function for a child
-// - React's CSSTransitionGroup is used for open-close animation
-
-var React = require('react');
-var CSSTransitionGroup = require('react-transition-group/CSSTransitionGroup');
-var AriaMenuButton = require('react-aria-menubutton');
-
-var people = [{
-  name: 'Charles Choo-Choo',
-  id: 1242
-}, {
-  name: 'Mina Meowmers',
-  id: 8372
-}, {
-  name: 'Susan Sailor',
-  id: 2435
-}];
-
-var MyMenuButton = React.createClass({
-  render: function() {
-    var peopleMenuItems = people.map(function(person, i) {
-      return (
-        <AriaMenuButton.MenuItem
-          key={i}
-          tag='li'
-          value={person.id}
-          text={person.name}
-          className='PeopleMenu-person'
-        >
-          <div className='PeopleMenu-personPhoto'>
-            <img src={'/people/pictures/' + person.id + '.jpg'}/ >
-          </div>
-          <div className='PeopleMenu-personName'>
-            {person.name}
-          </div>
-        </AriaMenuButton.MenuItem>
-      );
-    });
-
-    var peopleMenuInnards = function(menuState) {
-      var menu = (!menuState.isOpen) ? false : (
-        <div
-          className='PeopleMenu-menu'
-          key='menu'
-        >
-          {peopleMenuItems}
-        </div>
-      );
-      return (
-        <CSSTransitionGroup transitionName='people'>
-          {menu}
-        </CSSTransitionGroup>
-      );
-    };
+### Programmatic Control
 
-    return (
-      <AriaMenuButton.Wrapper
-        className='PeopleMenu'
-        onSelection={handleSelection}
-        style={{ marginTop: 20 }}
-      >
-        <AriaMenuButton.Button className='PeopleMenu-trigger'>
-          <span className='PeopleMenu-triggerText'>
-            Select a person
-          </span>
-          <span className='PeopleMenu-triggerIcon' />
-        </AriaMenuButton.Button>
-        <AriaMenuButton.Menu>
-          {peopleMenuInnards}
-        </AriaMenuButton.Menu>
-      </AriaMenuButton.Wrapper>
-    );
-  }
-});
+```tsx
+import { openMenu, closeMenu } from 'react-aria-menubutton';
+
+// Open menu with id "my-menu"
+openMenu('my-menu');
+
+// Open without focusing the first item
+openMenu('my-menu', { focusMenu: false });
 
-function handleSelection(value, event) { .. }
+// Close menu
+closeMenu('my-menu');
+
+// Close and focus the button
+closeMenu('my-menu', { focusButton: true });
 ```
 
 ## API
@@ -373,10 +361,40 @@ These are the `closeOptions`:
 
 - **focusButton** { Boolean }: If `true`, the widget's button will receive focus when the menu closes. Default: `false`.
 
+## TypeScript
+
+This library is written in TypeScript and provides built-in type declarations.
+
+### Exported Types
+
+```tsx
+import type {
+  // Component Props
+  WrapperProps,
+  ButtonProps,
+  MenuProps,
+  MenuItemProps,
+  
+  // Menu children function state
+  MenuChildren,
+  MenuChildrenState,
+  
+  // Programmatic control options
+  OpenMenuOptions,
+  CloseMenuOptions,
+} from 'react-aria-menubutton';
+```
+
 ## Contributing & Development
 
 Please note that this project is released with a Contributor Code of Conduct. By participating in this project you agree to abide by its terms.
 
-Lint with `npm run lint`.
+### Scripts
 
-Test with `npm run test-dev`. A browser should open; look at the console log for TAP output.
+- `npm run typecheck` - Type check with TypeScript
+- `npm run lint` - Lint with ESLint
+- `npm run format` - Format with Prettier
+- `npm run format:check` - Check formatting
+- `npm test` - Run tests
+- `npm run build` - Build the library
+- `npm start` - Start the demo dev server

package/dist/index.d.ts

@@ -0,0 +1,59 @@
+import { ForwardRefExoticComponent } from 'react';
+import { RefAttributes } from 'react';
+
+export declare const Button: ForwardRefExoticComponent<ButtonProps & RefAttributes<HTMLElement>>;
+
+export declare interface ButtonProps extends React.HTMLAttributes<HTMLElement> {
+    children: React.ReactNode;
+    disabled?: boolean;
+    tag?: keyof React.JSX.IntrinsicElements;
+}
+
+export declare function closeMenu(menuId: string, closeOptions?: CloseMenuOptions): void;
+
+export declare interface CloseMenuOptions {
+    focusButton?: boolean;
+}
+
+export declare const Menu: ForwardRefExoticComponent<MenuProps & RefAttributes<HTMLElement>>;
+
+export declare type MenuChildren = React.ReactNode | ((state: MenuChildrenState) => React.ReactNode);
+
+export declare interface MenuChildrenState {
+    isOpen: boolean;
+}
+
+export declare const MenuItem: ForwardRefExoticComponent<MenuItemProps & RefAttributes<HTMLElement>>;
+
+export declare interface MenuItemProps extends React.HTMLAttributes<HTMLElement> {
+    children: React.ReactNode;
+    tag?: keyof React.JSX.IntrinsicElements;
+    text?: string;
+    value?: unknown;
+}
+
+export declare interface MenuProps extends Omit<React.HTMLAttributes<HTMLElement>, "children"> {
+    children: MenuChildren;
+    tag?: keyof React.JSX.IntrinsicElements;
+}
+
+export declare function openMenu(menuId: string, openOptions?: OpenMenuOptions): void;
+
+export declare interface OpenMenuOptions {
+    focusMenu?: boolean;
+}
+
+export declare const Wrapper: ForwardRefExoticComponent<WrapperProps & RefAttributes<HTMLElement>>;
+
+export declare interface WrapperProps extends Omit<React.HTMLAttributes<HTMLElement>, "onSelect"> {
+    children: React.ReactNode;
+    onMenuToggle?: (state: {
+        isOpen: boolean;
+    }) => void;
+    onSelection?: (value: unknown, event: React.SyntheticEvent) => void;
+    closeOnSelection?: boolean;
+    closeOnBlur?: boolean;
+    tag?: keyof React.JSX.IntrinsicElements;
+}
+
+export { }

package/dist/react-aria-menubutton.cjs.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const y=require("react/jsx-runtime"),u=require("react"),_=new Map,k="a menu outside a mounted Wrapper with an id, or a menu that does not exist";function B(e,r){_.set(e,r)}function K(e){_.delete(e)}function M(e,r){const s=_.get(e);if(!s)throw new Error("Cannot open "+k);s.openMenu(r)}function L(e,r){const s=_.get(e);if(!s)throw new Error("Cannot close "+k);s.closeMenu(r)}function x(e){return e&&e.__esModule&&Object.prototype.hasOwnProperty.call(e,"default")?e.default:e}var w,b;function F(){if(b)return w;b=1;function e(t){t=t||{};var n=t.keybindings||{};this._settings={keybindings:{next:n.next||{keyCode:40},prev:n.prev||{keyCode:38},first:n.first,last:n.last},wrap:t.wrap,stringSearch:t.stringSearch,stringSearchDelay:800},this._keybindingsLookup=[];var o,c;for(o in this._settings.keybindings)c=this._settings.keybindings[o],c&&[].concat(c).forEach((function(a){a.metaKey=a.metaKey||!1,a.ctrlKey=a.ctrlKey||!1,a.altKey=a.altKey||!1,a.shiftKey=a.shiftKey||!1,this._keybindingsLookup.push({action:o,eventMatcher:a})}).bind(this));this._searchString="",this._members=[],t.members&&this.setMembers(t.members),this._boundHandleKeydownEvent=this._handleKeydownEvent.bind(this)}e.prototype.activate=function(){return document.addEventListener("keydown",this._boundHandleKeydownEvent,!0),this},e.prototype.deactivate=function(){return document.removeEventListener("keydown",this._boundHandleKeydownEvent,!0),this._clearSearchStringRefreshTimer(),this},e.prototype._handleKeydownEvent=function(t){var n=this._getActiveElementIndex();if(n!==-1){var o=!1;this._keybindingsLookup.forEach((function(c){if(r(c.eventMatcher,t))switch(o=!0,t.preventDefault(),c.action){case"next":this.moveFocusForward();break;case"prev":this.moveFocusBack();break;case"first":this.moveFocusToFirst();break;case"last":this.moveFocusToLast();break;default:return}}).bind(this)),o||this._handleUnboundKey(t)}},e.prototype.moveFocusForward=function(){var t=this._getActiveElementIndex(),n;return t<this._members.length-1?n=t+1:this._settings.wrap?n=0:n=t,this.focusNodeAtIndex(n),n},e.prototype.moveFocusBack=function(){var t=this._getActiveElementIndex(),n;return t>0?n=t-1:this._settings.wrap?n=this._members.length-1:n=t,this.focusNodeAtIndex(n),n},e.prototype.moveFocusToFirst=function(){this.focusNodeAtIndex(0)},e.prototype.moveFocusToLast=function(){this.focusNodeAtIndex(this._members.length-1)},e.prototype._handleUnboundKey=function(t){if(this._settings.stringSearch){if(this._searchString!==""&&(t.key===" "||t.keyCode===32))return t.preventDefault(),-1;if(!s(t.keyCode)||t.ctrlKey||t.metaKey||t.altKey)return-1;t.preventDefault(),this._addToSearchString(String.fromCharCode(t.keyCode)),this._runStringSearch()}},e.prototype._clearSearchString=function(){this._searchString=""},e.prototype._addToSearchString=function(t){this._searchString+=t.toLowerCase()},e.prototype._startSearchStringRefreshTimer=function(){var t=this;this._clearSearchStringRefreshTimer(),this._stringSearchTimer=setTimeout(function(){t._clearSearchString()},this._settings.stringSearchDelay)},e.prototype._clearSearchStringRefreshTimer=function(){clearTimeout(this._stringSearchTimer)},e.prototype._runStringSearch=function(){this._startSearchStringRefreshTimer(),this.moveFocusByString(this._searchString)},e.prototype.moveFocusByString=function(t){for(var n,o=0,c=this._members.length;o<c;o++)if(n=this._members[o],!!n.text&&n.text.indexOf(t)===0)return i(n.node)},e.prototype._findIndexOfNode=function(t){for(var n=0,o=this._members.length;n<o;n++)if(this._members[n].node===t)return n;return-1},e.prototype._getActiveElementIndex=function(){return this._findIndexOfNode(document.activeElement)},e.prototype.focusNodeAtIndex=function(t){var n=this._members[t];return n&&i(n.node),this},e.prototype.addMember=function(t,n){var o=t.node||t,c=t.text||o.getAttribute("data-focus-group-text")||o.textContent||"";this._checkNode(o);var a=c.replace(/[\W_]/g,"").toLowerCase(),h={node:o,text:a};return n!=null?this._members.splice(n,0,h):this._members.push(h),this},e.prototype.removeMember=function(t){var n=typeof t=="number"?t:this._findIndexOfNode(t);if(n!==-1)return this._members.splice(n,1),this},e.prototype.clearMembers=function(){return this._members=[],this},e.prototype.setMembers=function(t){this.clearMembers();for(var n=0,o=t.length;n<o;n++)this.addMember(t[n]);return this},e.prototype.getMembers=function(){return this._members},e.prototype._checkNode=function(t){if(!t.nodeType||t.nodeType!==window.Node.ELEMENT_NODE)throw new Error("focus-group: only DOM nodes allowed");return t};function r(t,n){for(var o in t)if(n[o]!==void 0&&t[o]!==n[o])return!1;return!0}function s(t){return t>=65&&t<=90}function i(t){!t||!t.focus||(t.focus(),t.tagName.toLowerCase()==="input"&&t.select())}return w=function(n){return new e(n)},w}var C=F();const N=x(C),R={wrap:!0,stringSearch:!0},D={options:{closeOnSelection:!0,closeOnBlur:!0},isOpen:!1,button:null,menu:null,focusGroup:null,blurTimer:void 0,moveFocusTimer:void 0,init(e){this.updateOptions(e),this.handleBlur=A.bind(this),this.handleSelection=G.bind(this),this.handleMenuKey=j.bind(this),this.focusGroup=N(R),this.button=null,this.menu=null,this.isOpen=!1},updateOptions(e){const r=this.options;this.options={...e,closeOnSelection:e?.closeOnSelection??!0,closeOnBlur:e?.closeOnBlur??!0},this.options.id&&B(this.options.id,this),r.id&&r.id!==this.options.id&&K(r.id)},focusItem(e){this.focusGroup.focusNodeAtIndex(e)},addItem(e){this.focusGroup.addMember(e)},clearItems(){this.focusGroup.clearMembers()},handleButtonNonArrowKey(e){this.focusGroup._handleUnboundKey(e)},destroy(){this.button=null,this.menu=null,this.focusGroup.deactivate(),clearTimeout(this.blurTimer),clearTimeout(this.moveFocusTimer)},update(){this.menu?.setState?.({isOpen:this.isOpen}),this.button?.setState?.({menuOpen:this.isOpen}),this.options.onMenuToggle?.({isOpen:this.isOpen})},openMenu(e){if(this.isOpen)return;const s=(e??{}).focusMenu??!0;this.isOpen=!0,this.update(),this.focusGroup.activate(),s&&(this.moveFocusTimer=setTimeout(()=>{this.focusItem(0)},0))},closeMenu(e){if(!this.isOpen)return;const r=e??{};this.isOpen=!1,this.update(),r.focusButton&&this.button?.ref.current?.focus()},toggleMenu(e,r){const s=e??{},i=r??{};this.isOpen?this.closeMenu(s):this.openMenu(i)},handleBlur(){},handleSelection(e,r){},handleMenuKey(e){}};function A(){this.blurTimer=setTimeout(()=>{if(!this.button)return;const e=this.button.ref.current;if(!e)return;const r=e.ownerDocument.activeElement;if(r===e)return;const s=this.menu?.ref.current;if(s===r){this.focusItem(0);return}s?.contains(r)||this.isOpen&&this.closeMenu({focusButton:!1})},0)}function G(e,r){this.options.closeOnSelection&&this.closeMenu({focusButton:!0}),this.options.onSelection?.(e,r)}function j(e){if(this.isOpen)switch(e.key){case"Escape":e.preventDefault(),this.closeMenu({focusButton:!0});break;case"Home":e.preventDefault(),this.focusGroup.moveFocusToFirst();break;case"End":e.preventDefault(),this.focusGroup.moveFocusToLast();break}}function W(e){const r=Object.create(D);return r.init(e),r}const g=u.createContext(null);function O(e,r,s){const i=s??{};for(const t in r)Object.prototype.hasOwnProperty.call(r,t)&&(i[t]||(e[t]=r[t]))}const P={children:!0,onMenuToggle:!0,onSelection:!0,closeOnSelection:!0,closeOnBlur:!0,tag:!0};function E(e){return{onMenuToggle:e.onMenuToggle,onSelection:e.onSelection,closeOnSelection:e.closeOnSelection,closeOnBlur:e.closeOnBlur,id:e.id}}const q=u.forwardRef(function({children:r,onMenuToggle:s,onSelection:i,closeOnSelection:t,closeOnBlur:n,tag:o="div",...c},a){const h=u.useMemo(()=>W(E({onMenuToggle:s,onSelection:i,closeOnSelection:t,closeOnBlur:n,id:c.id})),[]);u.useEffect(()=>{h.updateOptions(E({onMenuToggle:s,onSelection:i,closeOnSelection:t,closeOnBlur:n,id:c.id}))},[h,s,i,t,n,c.id,r]);const l={};return O(l,c,P),y.jsx(g.Provider,{value:h,children:u.createElement(o,l,r)})}),H=["button","fieldset","input","optgroup","option","select","textarea"],U={ambManager:!0,children:!0,disabled:!0,tag:!0};function X({ambManager:e,children:r,disabled:s=!1,tag:i="span",...t}){const n=u.useRef(null),[,o]=u.useState(e.isOpen);u.useEffect(()=>(e.button={ref:n,setState:f=>{o(f.menuOpen)}},()=>{e.destroy()}),[e]);const c=u.useCallback(f=>{if(!s)switch(f.key){case"ArrowDown":f.preventDefault(),e.isOpen?e.focusItem(0):e.openMenu();break;case"Enter":case" ":f.preventDefault(),e.toggleMenu();break;case"Escape":e.handleMenuKey(f);break;default:e.handleButtonNonArrowKey(f.nativeEvent)}},[e,s]),a=u.useCallback(f=>{s||e.toggleMenu({},{focusMenu:!1})},[e,s]),h=u.useCallback(f=>{n.current=f},[]),l={role:"button",tabIndex:s?-1:0,"aria-haspopup":!0,"aria-expanded":e.isOpen,"aria-disabled":s,onKeyDown:c,onClick:a,ref:h};return H.includes(i)&&(l.disabled=s),e.options.closeOnBlur&&(l.onBlur=f=>{e.handleBlur()}),O(l,t,U),u.createElement(i,l,r)}const Y=u.forwardRef(function(r,s){const i=u.useContext(g);if(!i)throw new Error("Button must be used within a Wrapper component");return y.jsx(X,{...r,ambManager:i})});var S,T;function $(){return T||(T=1,S=function(r,s,i){var t=0,n=0,o=!1,c=!1,a=!1;r.addEventListener("click",h,i),r.addEventListener("touchstart",l,i);function h(p){a||s(p)}function l(p){a=!0,!o&&(o=!0,r.addEventListener("touchmove",f,i),r.addEventListener("touchend",d,i),r.addEventListener("touchcancel",v,i),c=!1,t=p.touches[0].clientX,n=p.touches[0].clientY)}function f(p){c||Math.abs(p.touches[0].clientX-t)<=10&&Math.abs(p.touches[0].clientY-n)<=10||(c=!0)}function d(p){o=!1,m(),c||s(p)}function v(){o=!1,c=!1,t=0,n=0}function m(){r.removeEventListener("touchmove",f,i),r.removeEventListener("touchend",d,i),r.removeEventListener("touchcancel",v,i)}function I(){r.removeEventListener("click",h,i),r.removeEventListener("touchstart",l,i),m()}return{remove:I}}),S}var V=$();const z=x(V),J={ambManager:!0,children:!0,tag:!0};function Q({ambManager:e,children:r,tag:s="div",...i}){const t=u.useRef(null),n=u.useRef(null),o=u.useRef(null),[,c]=u.useState(e.isOpen),a=u.useCallback(()=>{const d=t.current;if(!d)return;const v=m=>{t.current?.contains(m.target)||e.button?.ref.current?.contains(m.target)||e.closeMenu()};n.current=z(d.ownerDocument.documentElement,v)},[e]);u.useEffect(()=>(e.menu={ref:t,setState:d=>{c(d.isOpen)}},()=>{n.current&&n.current.remove(),o.current&&clearTimeout(o.current),e.destroy()}),[e]),u.useEffect(()=>{e.options.closeOnBlur&&(e.isOpen&&!n.current?o.current=setTimeout(()=>{a(),o.current=null},0):!e.isOpen&&n.current&&(n.current.remove(),n.current=null),e.isOpen||e.clearItems())},[e,e.isOpen,a]);const h=u.useCallback(d=>{t.current=d},[]),l=typeof r=="function"?r({isOpen:e.isOpen}):e.isOpen?r:null;if(!l)return null;const f={onKeyDown:d=>{e.handleMenuKey(d)},role:"menu",tabIndex:-1,ref:h};return e.options.closeOnBlur&&(f.onBlur=d=>{e.handleBlur()}),O(f,i,J),u.createElement(s,f,l)}const Z=u.forwardRef(function(r,s){const i=u.useContext(g);if(!i)throw new Error("Menu must be used within a Wrapper component");return y.jsx(Q,{...r,ambManager:i})}),ee={ambManager:!0,children:!0,tag:!0,text:!0,value:!0};function te({ambManager:e,children:r,tag:s="div",text:i,value:t,...n}){const o=u.useRef(null);u.useEffect(()=>{o.current&&e.addItem({node:o.current,text:i})},[e,i]);const c=u.useCallback(f=>{const d=t!==void 0?t:r;e.handleSelection(d,f)},[e,t,r]),a=u.useCallback(f=>{f.key!=="Enter"&&f.key!==" "||s==="a"&&"href"in n&&n.href!==void 0||(f.preventDefault(),c(f))},[s,n,c]),h=u.useCallback(f=>{o.current=f},[]),l={onClick:c,onKeyDown:a,role:"menuitem",tabIndex:-1,ref:h};return O(l,n,ee),u.createElement(s,l,r)}const ne=u.forwardRef(function(r,s){const i=u.useContext(g);if(!i)throw new Error("MenuItem must be used within a Wrapper component");return y.jsx(te,{...r,ambManager:i})});exports.Button=Y;exports.Menu=Z;exports.MenuItem=ne;exports.Wrapper=q;exports.closeMenu=L;exports.openMenu=M;