Menu

type MenuTheme = Partial<
  Record<
    | 'active'
    | 'bottomLeft'
    | 'bottomRight'
    | 'caption'
    | 'disabled'
    | 'icon'
    | 'iconMenu'
    | 'menu'
    | 'menuDivider'
    | 'menuInner'
    | 'menuItem'
    | 'outline'
    | 'ripple'
    | 'rippled'
    | 'selected'
    | 'shortcut'
    | 'static'
    | 'topLeft'
    | 'topRight',
    string
  >
>;

type MenuClassNames = MenuTheme;

type MenuPosition = 'auto' | 'static' | 'topLeft' | 'topRight' | 'bottomLeft' | 'bottomRight';

interface MenuHandle {
  show(): void;
  hide(): void;
  readonly node: HTMLDivElement | null;
}

interface MenuProps<Value = unknown> extends Omit<HTMLAttributes<HTMLDivElement>, 'onSelect' | 'onKeyDown'> {
  active?: boolean;
  initialFocus?: 'first' | 'last';
  onHide?: () => void;
  onSelect?: (value: Value | undefined) => void;
  onShow?: () => void;
  onKeyDown?: (event: KeyboardEvent<HTMLUListElement>) => void;
  outline?: boolean;
  position?: MenuPosition;
  ripple?: boolean;
  selectable?: boolean;
  selected?: Value;
  /** Classes for the component's rendered parts. Applied after legacy theme overrides. */
  classNames?: MenuTheme;
  /** @deprecated Use classNames for style slots; use ThemeProvider for design tokens. */
  theme?: MenuTheme;
  ref?: Ref<MenuHandle>;
}

type MenuItemTheme = MenuTheme;

type MenuItemEvent = MouseEvent<HTMLLIElement> | KeyboardEvent<HTMLLIElement>;

interface MenuItemHandle<Value = unknown> {
  readonly node: HTMLLIElement | null;
  readonly value: Value | undefined;
}

interface MenuItemProps<Value = unknown> extends Omit<HTMLAttributes<HTMLLIElement>, 'onClick'> {
  caption?: ReactNode;
  disabled?: boolean;
  icon?: ReactNode;
  selected?: boolean;
  shortcut?: ReactNode;
  value?: Value;
  ripple?: boolean;
  onClick?: (event: MenuItemEvent, item: MenuItemHandle<Value>) => void;
  /** Classes for the component's rendered parts. Applied after legacy theme overrides. */
  classNames?: MenuItemTheme;
  /** @deprecated Use classNames for style slots; use ThemeProvider for design tokens. */
  theme?: MenuItemTheme;
  ref?: Ref<MenuItemHandle<Value>>;
}

type MenuItemClassNames = MenuItemTheme;

type MenuDividerTheme = MenuTheme;

interface MenuDividerProps extends HTMLAttributes<HTMLHRElement> {
  /** Classes for the component's rendered parts. Applied after legacy theme overrides. */
  classNames?: MenuDividerTheme;
  /** @deprecated Use classNames for style slots; use ThemeProvider for design tokens. */
  theme?: MenuDividerTheme;
  ref?: Ref<HTMLHRElement>;
}

type MenuDividerClassNames = MenuDividerTheme;

type IconMenuTheme = MenuTheme;

interface IconMenuHandle {
  open(): void;
  close(): void;
  readonly node: HTMLDivElement | null;
}

interface IconMenuProps<Value = unknown> extends Omit<HTMLAttributes<HTMLDivElement>, 'onSelect' | 'onClick'> {
  active?: boolean;
  icon?: ReactNode;
  iconRipple?: boolean;
  inverse?: boolean;
  menuRipple?: boolean;
  onClick?: React.MouseEventHandler<HTMLElement>;
  onHide?: () => void;
  onSelect?: MenuProps<Value>['onSelect'];
  onShow?: () => void;
  position?: MenuPosition;
  selectable?: boolean;
  selected?: Value;
  /** Classes for the component's rendered parts. Applied after legacy theme overrides. */
  classNames?: IconMenuTheme;
  /** @deprecated Use classNames for style slots; use ThemeProvider for design tokens. */
  theme?: IconMenuTheme;
  ref?: Ref<IconMenuHandle>;
}

type IconMenuClassNames = IconMenuTheme;