@ryvora/react-menu/README.md

🍽️ The engine for interactive menus in React. Handles selection, navigation, and open state!

# Menu 🍽️

Welcome, Menu Architect! 🏗️

The `menu` module is a foundational building block for creating interactive menus, like those found in `DropdownMenu`, `ContextMenu`, or `Select` components. It handles the core logic for item selection, keyboard navigation, and managing the open state.

Think of it as the engine ⚙️ that powers various menu-like components, providing the smarts behind the scenes!

## Core Responsibilities

- Managing a collection of menu items.
- Handling keyboard navigation (arrow keys, Home, End, type-ahead).
- Managing item selection and activation.
- Controlling the open/closed state of the menu content.
- Integrating with `@ryvora/react-popper` for positioning.
- Often used with `@ryvora/react-dismissable-layer` for closing behavior.

## Conceptual Structure (How it's typically used by other components)

```tsx
// This is a simplified view, often abstracted by DropdownMenu, Select, etc.
import * as MenuPrimitive from '@ryvora/react-menu';
import * as PopperPrimitive from '@ryvora/react-popper';

function MyCustomMenu() {
  // ... state for open, onOpenChange ...
  return (
    <PopperPrimitive.Root>
      <MenuPrimitive.Root open={isOpen} onOpenChange={setIsOpen}>
        <PopperPrimitive.Anchor asChild>
          <MenuPrimitive.Anchor asChild> {/* Or directly use PopperPrimitive.Anchor */}
            <button>Trigger</button>
          </MenuPrimitive.Anchor>
        </PopperPrimitive.Anchor>

        <MenuPrimitive.Portal>
          <PopperPrimitive.Content>
            <MenuPrimitive.Content>
              <MenuPrimitive.Item onSelect={...}>Item 1</MenuPrimitive.Item>
              <MenuPrimitive.Item onSelect={...}>Item 2</MenuPrimitive.Item>
            </MenuPrimitive.Content>
          </PopperPrimitive.Content>
        </MenuPrimitive.Portal>
      </MenuPrimitive.Root>
    </PopperPrimitive.Root>
  );
}
```

This module is the chef's secret ingredient for delicious interactive menus! 👨‍🍳