{
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
  "name": "menu",
  "type": "registry:ui",
  "title": "Menu",
  "description": "Menu is a compact command surface for contextual actions — distinct from Select (form values) and Popover (supplementary content).",
  "author": "Skrewww",
  "dependencies": [],
  "registryDependencies": [
    "@skrewww/popover",
    "@skrewww/foundation"
  ],
  "docs": "Host requirements (assumed already present, not installed by this command): react, react-dom.",
  "files": [
    {
      "path": "components/ui/Menu.tsx",
      "content": "/** @skrewww-component menu */\n\"use client\";\n\nimport {\n  createContext,\n  useCallback,\n  useContext,\n  useEffect,\n  useId,\n  useLayoutEffect,\n  useMemo,\n  useRef,\n  cloneElement,\n  isValidElement,\n  type KeyboardEvent,\n  type MouseEvent,\n  type ReactNode,\n  type RefObject,\n  type MutableRefObject,\n} from \"react\";\nimport { cn } from \"@/lib/cn\";\nimport {\n  Popover,\n  PopoverBody,\n  PopoverContent,\n  PopoverTrigger,\n  usePopoverOpen,\n  usePopoverRequestClose,\n  usePopoverSetOpen,\n} from \"@/components/ui/Popover\";\nimport type { PopoverAlign, PopoverPlacement } from \"@/components/ui/internal/popover-position\";\nimport { createMenuTypeahead } from \"@/components/ui/internal/menu-typeahead\";\nimport styles from \"@/components/ui/menu.module.css\";\n\ntype MenuFocusTarget = \"first\" | \"last\";\n\ntype RegisteredMenuItem = {\n  id: string;\n  ref: RefObject<HTMLElement | null>;\n  text: string;\n  disabled: boolean;\n  activate: () => void;\n};\n\ntype MenuContextValue = {\n  menuId: string;\n  triggerId: string;\n  loop: boolean;\n  closeOnSelect: boolean;\n  disabled: boolean;\n  registerItem: (item: RegisteredMenuItem) => void;\n  unregisterItem: (id: string) => void;\n  getItems: () => RegisteredMenuItem[];\n  setPendingFocus: (target: MenuFocusTarget | null) => void;\n  consumePendingFocus: () => MenuFocusTarget | null;\n  requestItemClose: (shouldClose?: boolean) => void;\n};\n\nconst MenuContext = createContext<MenuContextValue | null>(null);\n\nfunction useMenuContext(component: string): MenuContextValue {\n  const context = useContext(MenuContext);\n  if (!context) {\n    throw new Error(`${component} must be used within Menu`);\n  }\n  return context;\n}\n\nfunction getEnabledItems(items: RegisteredMenuItem[]): RegisteredMenuItem[] {\n  return items.filter((item) => !item.disabled);\n}\n\nfunction focusMenuItem(item: RegisteredMenuItem) {\n  const node = item.ref.current;\n  if (!node) return;\n  node.focus({ preventScroll: true });\n  if (typeof node.scrollIntoView === \"function\") {\n    node.scrollIntoView({ block: \"nearest\" });\n  }\n}\n\nfunction extractTextContent(node: ReactNode): string {\n  if (typeof node === \"string\" || typeof node === \"number\") return String(node);\n  if (Array.isArray(node)) return node.map(extractTextContent).join(\"\");\n  return \"\";\n}\n\nexport type MenuProps = {\n  open?: boolean;\n  defaultOpen?: boolean;\n  onOpenChange?: (open: boolean) => void;\n  placement?: PopoverPlacement;\n  align?: PopoverAlign;\n  loop?: boolean;\n  closeOnSelect?: boolean;\n  disabled?: boolean;\n  children: ReactNode;\n};\n\nexport function Menu({\n  open,\n  defaultOpen = false,\n  onOpenChange,\n  placement = \"bottom\",\n  align = \"start\",\n  loop = false,\n  closeOnSelect = true,\n  disabled = false,\n  children,\n}: MenuProps) {\n  const menuId = useId();\n  const triggerId = useId();\n  const itemsRef = useRef<Map<string, RegisteredMenuItem>>(new Map());\n  const pendingFocusRef = useRef<MenuFocusTarget | null>(null);\n  const requestCloseRef = useRef<(options?: { restoreFocus?: boolean }) => void>(() => {});\n\n  const registerItem = useCallback((item: RegisteredMenuItem) => {\n    itemsRef.current.set(item.id, item);\n  }, []);\n\n  const unregisterItem = useCallback((id: string) => {\n    itemsRef.current.delete(id);\n  }, []);\n\n  const getItems = useCallback(() => Array.from(itemsRef.current.values()), []);\n\n  const setPendingFocus = useCallback((target: MenuFocusTarget | null) => {\n    pendingFocusRef.current = target;\n  }, []);\n\n  const consumePendingFocus = useCallback(() => {\n    const next = pendingFocusRef.current;\n    pendingFocusRef.current = null;\n    return next;\n  }, []);\n\n  const requestItemClose = useCallback(\n    (shouldClose = closeOnSelect) => {\n      if (shouldClose) {\n        requestCloseRef.current({ restoreFocus: true });\n      }\n    },\n    [closeOnSelect],\n  );\n\n  const value = useMemo(\n    () => ({\n      menuId,\n      triggerId,\n      loop,\n      closeOnSelect,\n      disabled,\n      registerItem,\n      unregisterItem,\n      getItems,\n      setPendingFocus,\n      consumePendingFocus,\n      requestItemClose,\n    }),\n    [\n      closeOnSelect,\n      consumePendingFocus,\n      disabled,\n      getItems,\n      loop,\n      menuId,\n      registerItem,\n      requestItemClose,\n      setPendingFocus,\n      triggerId,\n      unregisterItem,\n    ],\n  );\n\n  return (\n    <Popover\n      open={open}\n      defaultOpen={defaultOpen}\n      onOpenChange={onOpenChange}\n      placement={placement}\n      align={align}\n      focusMode=\"trigger\"\n      showArrow={false}\n    >\n      <MenuContext.Provider value={value}>\n        <MenuCloseBridge requestCloseRef={requestCloseRef} />\n        {children}\n      </MenuContext.Provider>\n    </Popover>\n  );\n}\n\nfunction MenuCloseBridge({\n  requestCloseRef,\n}: {\n  requestCloseRef: MutableRefObject<(options?: { restoreFocus?: boolean }) => void>;\n}) {\n  const requestClose = usePopoverRequestClose();\n  useLayoutEffect(() => {\n    requestCloseRef.current = requestClose;\n  }, [requestClose, requestCloseRef]);\n  return null;\n}\n\nexport type MenuTriggerProps = {\n  children: React.ReactElement<{\n    id?: string;\n    disabled?: boolean;\n    onClick?: (event: MouseEvent<HTMLElement>) => void;\n    onKeyDown?: (event: KeyboardEvent<HTMLElement>) => void;\n    \"aria-controls\"?: string;\n    \"aria-expanded\"?: boolean;\n    \"aria-haspopup\"?: string | boolean;\n    type?: \"button\" | \"submit\" | \"reset\";\n  }>;\n};\n\nexport function MenuTrigger({ children }: MenuTriggerProps) {\n  const { menuId, triggerId, disabled: menuDisabled, setPendingFocus } = useMenuContext(\"MenuTrigger\");\n  const open = usePopoverOpen();\n  const setOpen = usePopoverSetOpen();\n\n  if (!isValidElement(children)) return children;\n\n  const childDisabled = Boolean(children.props.disabled) || menuDisabled;\n\n  const enhanced = cloneElement(children, {\n    id: children.props.id ?? triggerId,\n    type: children.props.type ?? \"button\",\n    disabled: childDisabled,\n    \"aria-haspopup\": \"menu\",\n    \"aria-controls\": open ? menuId : children.props[\"aria-controls\"],\n    onKeyDown: (event: KeyboardEvent<HTMLElement>) => {\n      children.props.onKeyDown?.(event);\n      if (event.defaultPrevented || childDisabled) return;\n      if (!open && event.key === \"ArrowDown\") {\n        event.preventDefault();\n        setPendingFocus(\"first\");\n        setOpen(true);\n      } else if (!open && event.key === \"ArrowUp\") {\n        event.preventDefault();\n        setPendingFocus(\"last\");\n        setOpen(true);\n      }\n    },\n  });\n\n  return <PopoverTrigger>{enhanced}</PopoverTrigger>;\n}\n\nexport type MenuContentProps = {\n  children: ReactNode;\n  className?: string;\n  \"aria-label\"?: string;\n};\n\nexport function MenuContent({ children, className, \"aria-label\": ariaLabel }: MenuContentProps) {\n  const {\n    menuId,\n    triggerId,\n    loop,\n    getItems,\n    consumePendingFocus,\n  } = useMenuContext(\"MenuContent\");\n  const open = usePopoverOpen();\n  const requestClose = usePopoverRequestClose();\n  const menuRef = useRef<HTMLDivElement | null>(null);\n  const typeaheadRef = useRef(createMenuTypeahead({ getItems: () => [], onMatch: () => {} }));\n\n  useLayoutEffect(() => {\n    typeaheadRef.current = createMenuTypeahead({\n      getItems: () =>\n        getItems().map((item) => ({ id: item.id, text: item.text, disabled: item.disabled })),\n      onMatch: (id) => {\n        const item = getItems().find((entry) => entry.id === id);\n        if (item) focusMenuItem(item);\n      },\n    });\n  }, [getItems, open]);\n\n  useLayoutEffect(() => {\n    if (!open) {\n      typeaheadRef.current.reset();\n      return;\n    }\n\n    const frame = window.requestAnimationFrame(() => {\n      const enabled = getEnabledItems(getItems());\n      if (enabled.length === 0) return;\n      const pending = consumePendingFocus();\n      const target = pending === \"last\" ? enabled[enabled.length - 1] : enabled[0];\n      focusMenuItem(target);\n    });\n\n    return () => window.cancelAnimationFrame(frame);\n  }, [consumePendingFocus, getItems, open]);\n\n  useEffect(() => {\n    if (!open) return;\n    function handleTabClose(event: globalThis.KeyboardEvent) {\n      if (event.key === \"Tab\") {\n        requestClose({ restoreFocus: false });\n      }\n    }\n    document.addEventListener(\"keydown\", handleTabClose);\n    return () => document.removeEventListener(\"keydown\", handleTabClose);\n  }, [open, requestClose]);\n\n  const moveFocus = useCallback(\n    (direction: 1 | -1) => {\n      const enabled = getEnabledItems(getItems());\n      if (enabled.length === 0) return;\n      const activeIndex = enabled.findIndex((item) => item.ref.current === document.activeElement);\n      let nextIndex = activeIndex + direction;\n      if (activeIndex === -1) {\n        nextIndex = direction === 1 ? 0 : enabled.length - 1;\n      } else if (loop) {\n        nextIndex = (nextIndex + enabled.length) % enabled.length;\n      } else {\n        nextIndex = Math.max(0, Math.min(enabled.length - 1, nextIndex));\n      }\n      focusMenuItem(enabled[nextIndex]);\n    },\n    [getItems, loop],\n  );\n\n  const handleKeyDown = useCallback(\n    (event: KeyboardEvent<HTMLDivElement>) => {\n      const enabled = getEnabledItems(getItems());\n      const activeItem = enabled.find((item) => item.ref.current === document.activeElement);\n\n      if (event.key === \"ArrowDown\") {\n        event.preventDefault();\n        moveFocus(1);\n      } else if (event.key === \"ArrowUp\") {\n        event.preventDefault();\n        moveFocus(-1);\n      } else if (event.key === \"Home\") {\n        event.preventDefault();\n        if (enabled[0]) focusMenuItem(enabled[0]);\n      } else if (event.key === \"End\") {\n        event.preventDefault();\n        if (enabled[enabled.length - 1]) focusMenuItem(enabled[enabled.length - 1]);\n      } else if (event.key === \"Enter\" || event.key === \" \") {\n        if (activeItem) {\n          event.preventDefault();\n          activeItem.activate();\n        }\n      } else if (event.key === \"Tab\") {\n        requestClose({ restoreFocus: false });\n      } else if (event.key.length === 1 && !event.ctrlKey && !event.metaKey && !event.altKey) {\n        if (typeaheadRef.current.handleKey(event.key)) {\n          event.preventDefault();\n        }\n      }\n    },\n    [getItems, moveFocus, requestClose],\n  );\n\n  return (\n    <PopoverContent className={cn(styles.content, className)}>\n      <PopoverBody className={styles.body}>\n        <div\n          ref={menuRef}\n          id={menuId}\n          role=\"menu\"\n          aria-label={ariaLabel}\n          aria-labelledby={ariaLabel ? undefined : triggerId}\n          className={styles.menu}\n          onKeyDown={handleKeyDown}\n        >\n          {children}\n        </div>\n      </PopoverBody>\n    </PopoverContent>\n  );\n}\n\nexport type MenuItemProps = {\n  children: ReactNode;\n  onSelect?: (event: Event) => void;\n  disabled?: boolean;\n  destructive?: boolean;\n  icon?: ReactNode;\n  shortcut?: string;\n  textValue?: string;\n  closeOnSelect?: boolean;\n  href?: string;\n  /** Anchor target, e.g. \"_blank\" for an external destination. Only meaningful alongside `href`. */\n  target?: string;\n  /** Anchor rel — pass \"noopener noreferrer\" with target=\"_blank\" for a real external link, matching the site's other external-link usage. */\n  rel?: string;\n  className?: string;\n};\n\nexport function MenuItem({\n  children,\n  onSelect,\n  disabled = false,\n  destructive = false,\n  icon,\n  shortcut,\n  textValue,\n  closeOnSelect,\n  href,\n  target,\n  rel,\n  className,\n}: MenuItemProps) {\n  const itemId = useId();\n  const itemRef = useRef<HTMLElement | null>(null);\n  const { disabled: menuDisabled, registerItem, unregisterItem, requestItemClose } =\n    useMenuContext(\"MenuItem\");\n  const isDisabled = disabled || menuDisabled;\n  const resolvedText = textValue ?? extractTextContent(children);\n\n  const activate = useCallback(\n    (event?: Event) => {\n      if (isDisabled) return;\n      if (event) onSelect?.(event);\n      else onSelect?.(new Event(\"select\"));\n      requestItemClose(closeOnSelect);\n    },\n    [closeOnSelect, isDisabled, onSelect, requestItemClose],\n  );\n\n  useLayoutEffect(() => {\n    registerItem({\n      id: itemId,\n      ref: itemRef,\n      text: resolvedText,\n      disabled: isDisabled,\n      activate,\n    });\n    return () => unregisterItem(itemId);\n  }, [activate, isDisabled, itemId, registerItem, resolvedText, unregisterItem]);\n\n  const classes = cn(\n    styles.item,\n    destructive && styles.itemDestructive,\n    isDisabled && styles.itemDisabled,\n    className,\n  );\n\n  const content = (\n    <>\n      {icon ? (\n        <span className={styles.itemIcon} aria-hidden=\"true\">\n          {icon}\n        </span>\n      ) : null}\n      <span className={styles.itemLabel}>{children}</span>\n      {shortcut ? <span className={styles.itemShortcut}>{shortcut}</span> : null}\n    </>\n  );\n\n  if (href && !isDisabled) {\n    return (\n      <a\n        href={href}\n        target={target}\n        rel={rel}\n        role=\"menuitem\"\n        ref={itemRef as RefObject<HTMLAnchorElement>}\n        className={classes}\n        onClick={(event) => {\n          activate(event.nativeEvent);\n        }}\n      >\n        {content}\n      </a>\n    );\n  }\n\n  return (\n    <div\n      ref={itemRef as RefObject<HTMLDivElement>}\n      role=\"menuitem\"\n      tabIndex={-1}\n      aria-disabled={isDisabled || undefined}\n      className={classes}\n      onClick={(event) => {\n        if (isDisabled) return;\n        activate(event.nativeEvent);\n      }}\n    >\n      {content}\n    </div>\n  );\n}\n\nexport type MenuSeparatorProps = {\n  className?: string;\n};\n\nexport function MenuSeparator({ className }: MenuSeparatorProps) {\n  return <div role=\"separator\" className={cn(styles.separator, className)} />;\n}\n\nexport type MenuLabelProps = {\n  children: ReactNode;\n  className?: string;\n  id?: string;\n};\n\nexport function MenuLabel({ children, className, id: idProp }: MenuLabelProps) {\n  const generatedId = useId();\n  return (\n    <div id={idProp ?? generatedId} className={cn(styles.label, className)}>\n      {children}\n    </div>\n  );\n}\n\nexport type MenuGroupProps = {\n  children: ReactNode;\n  label?: string;\n  className?: string;\n};\n\nexport function MenuGroup({ children, label, className }: MenuGroupProps) {\n  const labelId = useId();\n  return (\n    <div\n      role=\"group\"\n      aria-labelledby={label ? labelId : undefined}\n      className={cn(styles.group, className)}\n    >\n      {label ? (\n        <MenuLabel id={labelId}>{label}</MenuLabel>\n      ) : null}\n      {children}\n    </div>\n  );\n}\n\nexport type MenuShortcutProps = {\n  children: ReactNode;\n  className?: string;\n};\n\nexport function MenuShortcut({ children, className }: MenuShortcutProps) {\n  return <span className={cn(styles.itemShortcut, className)}>{children}</span>;\n}\n",
      "type": "registry:ui",
      "target": "~/components/ui/Menu.tsx"
    },
    {
      "path": "components/ui/menu.module.css",
      "content": "/* Double class beats shared Popover `.popover` elevation/background. */\n.content.content {\n  box-sizing: border-box;\n  padding: 0;\n  overflow: hidden;\n  width: max-content;\n  min-width: var(--menu-min-width);\n  max-width: min(var(--menu-max-width), calc(100vw - var(--menu-viewport-padding) * 2));\n  background-color: var(--menu-surface);\n  background-image: var(--component-surface-gradient-overlay);\n  border: 1px solid var(--menu-border);\n  border-radius: var(--menu-radius);\n  box-shadow: var(--menu-elevation);\n  /* Flat/Gradient: none. Glass: remapped --menu-backdrop-filter → lg 16px. */\n  backdrop-filter: var(--menu-backdrop-filter);\n  color: var(--menu-item-text);\n  animation: none;\n}\n\n[data-skrewww-surface=\"gradient\"] .content.content {\n  background-image: var(--component-surface-gradient-overlay);\n}\n\n/*\n * MenuContent shares the Popover root DOM node (.popover + .content).\n * Popover Glass still uses color-mix + md/12px blur for generic popovers —\n * beat that recipe here only so Menu matches Figma panel 12%/24%/16px\n * without mutating global Popover Glass.\n * Declare backdrop-filter once (no manual -webkit) so the CSS pipeline keeps\n * the standard property — hand-writing both was dropping the unprefixed rule\n * and leaving Popover's blur(12px) as the computed winner.\n */\n:global([data-skrewww-surface=\"glass\"]) .content.content {\n  background: var(--menu-surface);\n  background-image: none;\n  border: 1px solid var(--menu-border);\n  box-shadow: var(--menu-elevation);\n  backdrop-filter: var(--glass-backdrop-filter-lg);\n}\n\n.body {\n  padding: var(--menu-padding);\n  overflow: hidden;\n}\n\n.menu {\n  display: flex;\n  flex-direction: column;\n  gap: var(--menu-item-gap);\n  max-height: var(--menu-max-height);\n  overflow-y: auto;\n  outline: none;\n}\n\n.group {\n  display: flex;\n  flex-direction: column;\n  gap: var(--menu-item-gap);\n}\n\n.label {\n  padding: var(--menu-label-padding);\n  color: var(--menu-label-text);\n  font-size: 0.6875rem;\n  font-weight: 600;\n  letter-spacing: 0.04em;\n  text-transform: uppercase;\n}\n\n.separator {\n  height: 1px;\n  margin: var(--menu-separator-margin);\n  background: var(--menu-separator-color);\n  border: 0;\n}\n\n.item {\n  display: flex;\n  align-items: center;\n  gap: var(--menu-item-gap);\n  min-height: var(--menu-item-height);\n  padding: var(--menu-item-padding);\n  border: 0;\n  border-radius: var(--menu-item-radius);\n  background: transparent;\n  color: var(--menu-item-text);\n  font: inherit;\n  text-align: left;\n  text-decoration: none;\n  cursor: pointer;\n  outline: none;\n}\n\n.item:hover:not(.itemDisabled) {\n  background: var(--menu-item-hover-surface);\n}\n\n.item:focus-visible {\n  outline: 2px solid var(--semantic-focus-ring);\n  outline-offset: -2px;\n  background: var(--menu-item-focused-surface);\n}\n\n.itemDisabled {\n  color: var(--menu-item-disabled-text);\n  cursor: not-allowed;\n}\n\n/* Enabled-only: disabled must win over destructive when both classes apply. */\n.itemDestructive:not(.itemDisabled) {\n  color: var(--menu-item-destructive-text);\n}\n\n.itemDestructive:hover:not(.itemDisabled) {\n  background: var(--menu-item-destructive-hover-surface);\n}\n\n.itemIcon {\n  display: inline-flex;\n  flex-shrink: 0;\n  color: var(--menu-item-icon);\n}\n\n.itemLabel {\n  flex: 1;\n  min-width: 0;\n  overflow: hidden;\n  text-overflow: ellipsis;\n  white-space: nowrap;\n}\n\n.itemShortcut {\n  margin-left: auto;\n  padding-left: 1rem;\n  color: var(--menu-shortcut-text);\n  font-size: 0.75rem;\n  letter-spacing: 0.02em;\n}\n\n.itemDisabled .itemShortcut {\n  color: var(--semantic-text-disabled);\n}\n\n@media (prefers-reduced-motion: reduce) {\n  .item {\n    transition: none;\n  }\n}\n",
      "type": "registry:ui",
      "target": "~/components/ui/menu.module.css"
    },
    {
      "path": "lib/cn.ts",
      "content": "export function cn(...classes: Array<string | false | null | undefined>): string {\n  return classes.filter(Boolean).join(\" \");\n}\n",
      "type": "registry:lib",
      "target": "~/lib/cn.ts"
    },
    {
      "path": "components/ui/internal/menu-typeahead.ts",
      "content": "export type MenuTypeaheadItem = {\n  id: string;\n  text: string;\n  disabled?: boolean;\n};\n\nexport type MenuTypeaheadController = {\n  handleKey: (key: string) => boolean;\n  reset: () => void;\n};\n\nexport function createMenuTypeahead({\n  getItems,\n  onMatch,\n  timeoutMs = 500,\n}: {\n  getItems: () => MenuTypeaheadItem[];\n  onMatch: (id: string) => void;\n  timeoutMs?: number;\n}): MenuTypeaheadController {\n  let buffer = \"\";\n  let timer: ReturnType<typeof setTimeout> | null = null;\n  let lastChar = \"\";\n  let cycleIndex = 0;\n\n  function reset() {\n    buffer = \"\";\n    lastChar = \"\";\n    cycleIndex = 0;\n    if (timer) {\n      clearTimeout(timer);\n      timer = null;\n    }\n  }\n\n  function scheduleReset() {\n    if (timer) clearTimeout(timer);\n    timer = setTimeout(reset, timeoutMs);\n  }\n\n  function handleKey(key: string): boolean {\n    if (key.length !== 1 || key === \" \") return false;\n\n    const enabledItems = getItems().filter((item) => !item.disabled);\n    const lowerKey = key.toLowerCase();\n\n    if (lowerKey === lastChar.toLowerCase()) {\n      const matches = enabledItems.filter((item) =>\n        item.text.toLowerCase().startsWith(lowerKey),\n      );\n      if (matches.length === 0) return false;\n      cycleIndex = (cycleIndex + 1) % matches.length;\n      onMatch(matches[cycleIndex].id);\n      scheduleReset();\n      return true;\n    }\n\n    buffer += lowerKey;\n    lastChar = key;\n    const matches = enabledItems.filter((item) => item.text.toLowerCase().startsWith(buffer));\n    if (matches.length === 0) {\n      buffer = lowerKey;\n      const single = enabledItems.filter((item) => item.text.toLowerCase().startsWith(buffer));\n      if (single.length === 0) {\n        reset();\n        return false;\n      }\n      cycleIndex = 0;\n      onMatch(single[0].id);\n      scheduleReset();\n      return true;\n    }\n\n    cycleIndex = 0;\n    onMatch(matches[0].id);\n    scheduleReset();\n    return true;\n  }\n\n  return { handleKey, reset };\n}\n",
      "type": "registry:lib",
      "target": "~/components/ui/internal/menu-typeahead.ts"
    }
  ]
}
