@mks2508/mks-ui 0.1.3 → 0.2.0

package/dist/react/ui/Menu/Menu.types.d.ts

@@ -0,0 +1,328 @@
+/**
+ * Type definitions for the Menu component.
+ *
+ * All interfaces use the IPrefix convention. Type aliases do not.
+ * This module re-exports relevant types from base-ui and motion
+ * combined with the v0.2.0 SlotOverrides/IBaseConfig pattern.
+ *
+ * @module @mks2508/mks-ui/react/ui/Menu/Menu.types
+ */
+import type * as React from '../../../react';
+import type { Menu as MenuPrimitive } from '@base-ui/react/menu';
+import type { HTMLMotionProps, Transition } from 'motion/react';
+import type { IBaseConfig, SlotOverrides } from '../../../core/types';
+import type { IHighlightProps, IHighlightItemProps } from '../../../react/primitives/Highlight';
+import type { MenuSlot } from './Menu.styles';
+/**
+ * Configuration interface for Menu behavior and animation.
+ *
+ * @example
+ * ```tsx
+ * const config: IMenuConfig = {
+ *   animation: { duration: 0.2, easing: 'ease-out' },
+ * };
+ * ```
+ */
+export interface IMenuConfig extends IBaseConfig {
+    /** Default motion transition for the popup entrance/exit. */
+    popupTransition?: Transition;
+}
+/**
+ * Internal context carrying the highlighted (focused) item value.
+ *
+ * @example
+ * ```typescript
+ * const ctx: MenuActiveValueContextType = {
+ *   highlightedValue: 'edit',
+ *   setHighlightedValue: (v) => {},
+ * };
+ * ```
+ */
+export type MenuActiveValueContextType = {
+    /** Currently highlighted item value, or null if none. */
+    highlightedValue: string | null;
+    /** Setter for the highlighted item value. */
+    setHighlightedValue: (value: string | null) => void;
+};
+/**
+ * Internal context for Menu open/close state.
+ *
+ * @example
+ * ```typescript
+ * const ctx: MenuContextType = { isOpen: true, setIsOpen: (v) => {} };
+ * ```
+ */
+export type MenuContextType = {
+    /** Whether the menu is open. */
+    isOpen: boolean | undefined;
+    /** Setter for open state, matching base-ui's onOpenChange signature. */
+    setIsOpen: IMenuProps['onOpenChange'];
+};
+/**
+ * Props for the root Menu component.
+ * Extends base-ui Menu.Root props with slot overrides and config.
+ *
+ * @example
+ * ```tsx
+ * <Menu slots={{ popup: 'bg-zinc-900' }} config={{ popupTransition: { duration: 0.3 } }}>
+ *   ...
+ * </Menu>
+ * ```
+ */
+export interface IMenuProps extends React.ComponentProps<typeof MenuPrimitive.Root> {
+    /** Partial class overrides per slot. */
+    slots?: SlotOverrides<MenuSlot>;
+    /** Menu behavior / animation configuration. */
+    config?: IMenuConfig;
+}
+/**
+ * Props for MenuTrigger -- the element that opens the menu.
+ *
+ * @example
+ * ```tsx
+ * <MenuTrigger className="px-3 py-2">Open</MenuTrigger>
+ * ```
+ */
+export interface IMenuTriggerProps extends React.ComponentProps<typeof MenuPrimitive.Trigger> {
+    /** Partial class overrides per slot. */
+    slots?: SlotOverrides<MenuSlot>;
+}
+/**
+ * Props for MenuPortal. Wraps AnimatePresence for enter/exit transitions.
+ * The `keepMounted` prop is managed internally.
+ *
+ * @example
+ * ```tsx
+ * <MenuPortal>
+ *   <MenuPositioner>...</MenuPositioner>
+ * </MenuPortal>
+ * ```
+ */
+export interface IMenuPortalProps extends Omit<React.ComponentProps<typeof MenuPrimitive.Portal>, 'keepMounted'> {
+}
+/**
+ * Props for MenuGroup -- groups related items with a label.
+ *
+ * @example
+ * ```tsx
+ * <MenuGroup>
+ *   <MenuGroupLabel>Actions</MenuGroupLabel>
+ *   <MenuItem>Edit</MenuItem>
+ * </MenuGroup>
+ * ```
+ */
+export interface IMenuGroupProps extends React.ComponentProps<typeof MenuPrimitive.Group> {
+    /** Partial class overrides per slot. */
+    slots?: SlotOverrides<MenuSlot>;
+}
+/**
+ * Props for MenuGroupLabel -- the label rendered above a group.
+ *
+ * @example
+ * ```tsx
+ * <MenuGroupLabel className="text-xs uppercase">Section</MenuGroupLabel>
+ * ```
+ */
+export interface IMenuGroupLabelProps extends React.ComponentProps<typeof MenuPrimitive.GroupLabel> {
+    /** Partial class overrides per slot. */
+    slots?: SlotOverrides<MenuSlot>;
+}
+/**
+ * Props for MenuSubmenu -- a nested menu with its own open state.
+ *
+ * @example
+ * ```tsx
+ * <MenuSubmenu>
+ *   <MenuSubmenuTrigger>More...</MenuSubmenuTrigger>
+ *   <MenuPortal>...</MenuPortal>
+ * </MenuSubmenu>
+ * ```
+ */
+export interface IMenuSubmenuProps extends React.ComponentProps<typeof MenuPrimitive.SubmenuRoot> {
+}
+/**
+ * Props for MenuSubmenuTrigger -- the item that opens a submenu.
+ * Combines base-ui's SubmenuTrigger props with motion HTML props.
+ *
+ * @example
+ * ```tsx
+ * <MenuSubmenuTrigger id="more-actions">More...</MenuSubmenuTrigger>
+ * ```
+ */
+export interface IMenuSubmenuTriggerProps extends Omit<Omit<React.ComponentProps<typeof MenuPrimitive.SubmenuTrigger>, 'render'>, keyof HTMLMotionProps<'div'>>, HTMLMotionProps<'div'> {
+    /** Whether the trigger is disabled. */
+    disabled?: boolean;
+    /** Partial class overrides per slot. */
+    slots?: SlotOverrides<MenuSlot>;
+}
+/**
+ * Props for MenuHighlight -- animated background that follows the focused item.
+ * Wraps the Highlight primitive with menu-specific defaults.
+ *
+ * @example
+ * ```tsx
+ * <MenuHighlight className="rounded-md bg-white/10" />
+ * ```
+ */
+export interface IMenuHighlightProps extends Omit<IHighlightProps, 'controlledItems' | 'enabled' | 'hover'> {
+    /** Whether to animate on hover. */
+    animateOnHover?: boolean;
+    /** Partial class overrides per slot. */
+    slots?: SlotOverrides<MenuSlot>;
+}
+/**
+ * Props for MenuHighlightItem -- wraps a menu item for highlight tracking.
+ *
+ * @example
+ * ```tsx
+ * <MenuHighlightItem>
+ *   <MenuItem>Edit</MenuItem>
+ * </MenuHighlightItem>
+ * ```
+ */
+export interface IMenuHighlightItemProps extends IHighlightItemProps {
+    /** Partial class overrides per slot. */
+    slots?: SlotOverrides<MenuSlot>;
+}
+/**
+ * Props for MenuPositioner -- positions the popup relative to the trigger.
+ *
+ * @example
+ * ```tsx
+ * <MenuPositioner sideOffset={8} align="start">
+ *   <MenuPopup>...</MenuPopup>
+ * </MenuPositioner>
+ * ```
+ */
+export interface IMenuPositionerProps extends React.ComponentProps<typeof MenuPrimitive.Positioner> {
+}
+/**
+ * Props for MenuPopup -- the visible flyout container.
+ * Combines base-ui Popup with motion HTML props for animated entrance.
+ *
+ * @example
+ * ```tsx
+ * <MenuPopup className="rounded-lg border shadow-lg">
+ *   <MenuItem>Edit</MenuItem>
+ * </MenuPopup>
+ * ```
+ */
+export interface IMenuPopupProps extends Omit<Omit<React.ComponentProps<typeof MenuPrimitive.Popup>, 'render'>, keyof HTMLMotionProps<'div'>>, HTMLMotionProps<'div'> {
+    /** Partial class overrides per slot. */
+    slots?: SlotOverrides<MenuSlot>;
+}
+/**
+ * Props for MenuItem -- a single actionable row in the menu.
+ * Combines base-ui Item with motion HTML props.
+ *
+ * @example
+ * ```tsx
+ * <MenuItem id="edit" label="Edit">
+ *   <PencilIcon /> Edit
+ * </MenuItem>
+ * ```
+ */
+export interface IMenuItemProps extends Omit<Omit<React.ComponentProps<typeof MenuPrimitive.Item>, 'render'>, keyof HTMLMotionProps<'div'>>, HTMLMotionProps<'div'> {
+    /** Partial class overrides per slot. */
+    slots?: SlotOverrides<MenuSlot>;
+}
+/**
+ * Props for MenuCheckboxItem -- a toggleable checkbox menu item.
+ *
+ * @example
+ * ```tsx
+ * <MenuCheckboxItem checked={showGrid} onCheckedChange={setShowGrid}>
+ *   Show Grid
+ * </MenuCheckboxItem>
+ * ```
+ */
+export interface IMenuCheckboxItemProps extends Omit<React.ComponentProps<typeof MenuPrimitive.CheckboxItem>, 'render'> {
+    /** Partial class overrides per slot. */
+    slots?: SlotOverrides<MenuSlot>;
+}
+/**
+ * Props for MenuCheckboxItemIndicator -- the check/indeterminate indicator.
+ * Combines base-ui CheckboxItemIndicator with motion HTML props.
+ *
+ * @example
+ * ```tsx
+ * <MenuCheckboxItemIndicator>
+ *   <CheckIcon />
+ * </MenuCheckboxItemIndicator>
+ * ```
+ */
+export interface IMenuCheckboxItemIndicatorProps extends Omit<Omit<React.ComponentProps<typeof MenuPrimitive.CheckboxItemIndicator>, 'render'>, keyof HTMLMotionProps<'div'>>, HTMLMotionProps<'div'> {
+}
+/**
+ * Props for MenuRadioGroup -- groups radio items for single-selection.
+ *
+ * @example
+ * ```tsx
+ * <MenuRadioGroup value={sortBy} onValueChange={setSortBy}>
+ *   <MenuRadioItem value="name">Name</MenuRadioItem>
+ *   <MenuRadioItem value="date">Date</MenuRadioItem>
+ * </MenuRadioGroup>
+ * ```
+ */
+export interface IMenuRadioGroupProps extends React.ComponentProps<typeof MenuPrimitive.RadioGroup> {
+}
+/**
+ * Props for MenuRadioItem -- a single option within a radio group.
+ *
+ * @example
+ * ```tsx
+ * <MenuRadioItem value="name">Sort by Name</MenuRadioItem>
+ * ```
+ */
+export interface IMenuRadioItemProps extends Omit<React.ComponentProps<typeof MenuPrimitive.RadioItem>, 'render'> {
+    /** Partial class overrides per slot. */
+    slots?: SlotOverrides<MenuSlot>;
+}
+/**
+ * Props for MenuRadioItemIndicator -- the selection indicator dot/icon.
+ * Combines base-ui RadioItemIndicator with motion HTML props.
+ *
+ * @example
+ * ```tsx
+ * <MenuRadioItemIndicator>
+ *   <DotIcon />
+ * </MenuRadioItemIndicator>
+ * ```
+ */
+export interface IMenuRadioItemIndicatorProps extends Omit<Omit<React.ComponentProps<typeof MenuPrimitive.RadioItemIndicator>, 'render'>, keyof HTMLMotionProps<'div'>>, HTMLMotionProps<'div'> {
+}
+/**
+ * Props for MenuShortcut -- displays a keyboard shortcut hint.
+ *
+ * @example
+ * ```tsx
+ * <MenuShortcut>Ctrl+C</MenuShortcut>
+ * ```
+ */
+export interface IMenuShortcutProps extends React.ComponentProps<'span'> {
+    /** Partial class overrides per slot. */
+    slots?: SlotOverrides<MenuSlot>;
+}
+/**
+ * Props for MenuArrow -- the directional arrow/caret of the popup.
+ *
+ * @example
+ * ```tsx
+ * <MenuArrow className="fill-zinc-800" />
+ * ```
+ */
+export interface IMenuArrowProps extends React.ComponentProps<typeof MenuPrimitive.Arrow> {
+}
+/**
+ * Props for MenuSeparator -- a horizontal divider between items.
+ *
+ * @example
+ * ```tsx
+ * <MenuSeparator className="my-1 border-white/10" />
+ * ```
+ */
+export interface IMenuSeparatorProps extends React.ComponentProps<typeof MenuPrimitive.Separator> {
+    /** Partial class overrides per slot. */
+    slots?: SlotOverrides<MenuSlot>;
+}
+//# sourceMappingURL=Menu.types.d.ts.map

package/dist/react/ui/Menu/Menu.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Menu.types.d.ts","sourceRoot":"","sources":["../../../../src/react/ui/Menu/Menu.types.ts"],"names":[],"mappings":"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"}

package/dist/react/ui/Menu/index.d.ts

@@ -0,0 +1,354 @@
+import type { MenuActiveValueContextType, MenuContextType, IMenuProps, IMenuTriggerProps, IMenuPortalProps, IMenuGroupProps, IMenuGroupLabelProps, IMenuSubmenuProps, IMenuSubmenuTriggerProps, IMenuHighlightProps, IMenuHighlightItemProps, IMenuPositionerProps, IMenuPopupProps, IMenuItemProps, IMenuCheckboxItemProps, IMenuCheckboxItemIndicatorProps, IMenuRadioGroupProps, IMenuRadioItemProps, IMenuRadioItemIndicatorProps, IMenuShortcutProps, IMenuArrowProps, IMenuSeparatorProps } from './Menu.types';
+declare const useMenuActiveValue: () => MenuActiveValueContextType;
+declare const useMenu: () => MenuContextType;
+/**
+ * Root Menu component -- provides open/close state and highlighted-value context.
+ * Wraps base-ui Menu.Root with controlled state management.
+ *
+ * @param open - Controlled open state
+ * @param defaultOpen - Uncontrolled initial open state
+ * @param onOpenChange - Callback when open state changes
+ * @param slots - Partial class overrides per slot
+ * @param config - Menu behavior / animation configuration
+ *
+ * @example
+ * ```tsx
+ * <Menu slots={{ popup: 'bg-zinc-900' }}>
+ *   <MenuTrigger>Actions</MenuTrigger>
+ *   <MenuPortal>...</MenuPortal>
+ * </Menu>
+ * ```
+ */
+declare function Menu({ slots, config, ...props }: IMenuProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * MenuTrigger -- the interactive element that toggles the menu open/closed.
+ * Renders a base-ui Menu.Trigger with the `trigger` slot classes.
+ *
+ * @param slots - Partial class overrides per slot
+ * @param className - Additional class names
+ *
+ * @example
+ * ```tsx
+ * <MenuTrigger className="rounded-md px-3 py-1.5">
+ *   Open Menu
+ * </MenuTrigger>
+ * ```
+ */
+declare function MenuTrigger({ slots, className, ...props }: IMenuTriggerProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * MenuPortal -- wraps menu content in a portal with AnimatePresence.
+ * Internally keeps the portal mounted and uses AnimatePresence for
+ * smooth enter/exit transitions of children.
+ *
+ * @example
+ * ```tsx
+ * <MenuPortal>
+ *   <MenuPositioner>
+ *     <MenuPopup>...</MenuPopup>
+ *   </MenuPositioner>
+ * </MenuPortal>
+ * ```
+ */
+declare function MenuPortal(props: IMenuPortalProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * MenuGroup -- logical grouping of related menu items.
+ * Renders a base-ui Menu.Group with the `group` slot classes.
+ *
+ * @param slots - Partial class overrides per slot
+ * @param className - Additional class names
+ *
+ * @example
+ * ```tsx
+ * <MenuGroup>
+ *   <MenuGroupLabel>Editing</MenuGroupLabel>
+ *   <MenuItem id="cut">Cut</MenuItem>
+ *   <MenuItem id="copy">Copy</MenuItem>
+ * </MenuGroup>
+ * ```
+ */
+declare function MenuGroup({ slots, className, ...props }: IMenuGroupProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * MenuGroupLabel -- heading text for a MenuGroup.
+ * Renders a base-ui Menu.GroupLabel with the `groupLabel` slot classes.
+ *
+ * @param slots - Partial class overrides per slot
+ * @param className - Additional class names
+ *
+ * @example
+ * ```tsx
+ * <MenuGroupLabel className="text-xs font-medium uppercase tracking-wider">
+ *   Navigation
+ * </MenuGroupLabel>
+ * ```
+ */
+declare function MenuGroupLabel({ slots, className, ...props }: IMenuGroupLabelProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * MenuSubmenu -- a nested sub-menu with its own open/close state.
+ * Wraps base-ui Menu.SubmenuRoot and provides a scoped MenuProvider.
+ *
+ * @param open - Controlled open state
+ * @param defaultOpen - Uncontrolled initial open state
+ * @param onOpenChange - Callback when open state changes
+ *
+ * @example
+ * ```tsx
+ * <MenuSubmenu>
+ *   <MenuSubmenuTrigger>More Actions</MenuSubmenuTrigger>
+ *   <MenuPortal>
+ *     <MenuPositioner>
+ *       <MenuPopup>
+ *         <MenuItem id="archive">Archive</MenuItem>
+ *       </MenuPopup>
+ *     </MenuPositioner>
+ *   </MenuPortal>
+ * </MenuSubmenu>
+ * ```
+ */
+declare function MenuSubmenu(props: IMenuSubmenuProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * MenuSubmenuTrigger -- the item that opens a submenu on hover/focus.
+ * Tracks its own highlighted state via useDataState for highlight integration.
+ *
+ * @param label - Accessible label for the trigger
+ * @param id - Unique identifier used for highlight tracking
+ * @param disabled - Whether the trigger is disabled
+ * @param slots - Partial class overrides per slot
+ * @param className - Additional class names
+ *
+ * @example
+ * ```tsx
+ * <MenuSubmenuTrigger id="more" label="More actions">
+ *   More...
+ * </MenuSubmenuTrigger>
+ * ```
+ */
+declare function MenuSubmenuTrigger({ label, id, nativeButton, slots, className, ...props }: IMenuSubmenuTriggerProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * MenuHighlight -- animated background that follows the currently
+ * focused/highlighted menu item. Wraps the Highlight primitive with
+ * menu-specific defaults (spring transition, no click activation).
+ *
+ * @param transition - Motion transition config (default: spring 350/35)
+ * @param animateOnHover - Whether to activate on hover
+ * @param slots - Partial class overrides per slot
+ * @param className - Additional class names
+ *
+ * @example
+ * ```tsx
+ * <MenuHighlight className="rounded-md bg-white/10" />
+ * ```
+ */
+declare function MenuHighlight({ transition, slots, className, ...props }: IMenuHighlightProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * MenuHighlightItem -- wraps a MenuItem for highlight position tracking.
+ * Must be placed inside a MenuHighlight context.
+ *
+ * @param slots - Partial class overrides per slot
+ *
+ * @example
+ * ```tsx
+ * <MenuHighlight className="rounded bg-white/10">
+ *   <MenuHighlightItem>
+ *     <MenuItem id="edit">Edit</MenuItem>
+ *   </MenuHighlightItem>
+ * </MenuHighlight>
+ * ```
+ */
+declare function MenuHighlightItem({ slots, ...props }: IMenuHighlightItemProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * MenuPositioner -- positions the popup relative to the trigger element.
+ * Thin wrapper over base-ui Menu.Positioner.
+ *
+ * @param sideOffset - Gap between trigger and popup
+ * @param align - Alignment along the trigger edge
+ *
+ * @example
+ * ```tsx
+ * <MenuPositioner sideOffset={8} align="start">
+ *   <MenuPopup>...</MenuPopup>
+ * </MenuPositioner>
+ * ```
+ */
+declare function MenuPositioner(props: IMenuPositionerProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * MenuPopup -- the visible flyout surface containing menu items.
+ * Uses Motion for animated entrance (scale + opacity) and exit.
+ *
+ * @param transition - Motion transition config (default: 0.2s duration)
+ * @param slots - Partial class overrides per slot
+ * @param className - Additional class names
+ * @param style - Inline styles merged with will-change hint
+ *
+ * @example
+ * ```tsx
+ * <MenuPopup className="min-w-[180px] rounded-lg border bg-zinc-900 p-1 shadow-xl">
+ *   <MenuItem id="edit">Edit</MenuItem>
+ *   <MenuItem id="delete">Delete</MenuItem>
+ * </MenuPopup>
+ * ```
+ */
+declare function MenuPopup({ finalFocus, id, transition, style, slots, className, ...props }: IMenuPopupProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * MenuItem -- a single actionable row within the menu.
+ * Tracks highlight state via useDataState for animated highlight integration.
+ *
+ * @param id - Unique identifier, also used as highlight tracking value
+ * @param label - Accessible label
+ * @param disabled - Whether the item is disabled
+ * @param closeOnClick - Close menu when this item is clicked
+ * @param slots - Partial class overrides per slot
+ * @param className - Additional class names
+ *
+ * @example
+ * ```tsx
+ * <MenuItem id="edit" label="Edit document">
+ *   <PencilIcon className="mr-2 size-4" />
+ *   Edit
+ *   <MenuShortcut>Ctrl+E</MenuShortcut>
+ * </MenuItem>
+ * ```
+ */
+declare function MenuItem({ disabled, label, closeOnClick, nativeButton, id, slots, className, ...props }: IMenuItemProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * MenuCheckboxItem -- a toggleable checkbox item within the menu.
+ * Tracks highlight state for animated highlight integration.
+ *
+ * @param checked - Controlled checked state
+ * @param defaultChecked - Uncontrolled initial checked state
+ * @param onCheckedChange - Callback when checked state changes
+ * @param disabled - Whether the item is disabled
+ * @param slots - Partial class overrides per slot
+ * @param className - Additional class names
+ *
+ * @example
+ * ```tsx
+ * <MenuCheckboxItem checked={showGrid} onCheckedChange={setShowGrid}>
+ *   <MenuCheckboxItemIndicator>
+ *     <CheckIcon />
+ *   </MenuCheckboxItemIndicator>
+ *   Show Grid
+ * </MenuCheckboxItem>
+ * ```
+ */
+declare function MenuCheckboxItem({ label, defaultChecked, checked, onCheckedChange, disabled, closeOnClick, nativeButton, id, slots, className, ...props }: IMenuCheckboxItemProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * MenuCheckboxItemIndicator -- the visual check/indeterminate icon.
+ * Renders via a motion.div for animated enter/exit transitions.
+ *
+ * @param keepMounted - Keep in DOM when unchecked (for exit animations)
+ *
+ * @example
+ * ```tsx
+ * <MenuCheckboxItemIndicator
+ *   initial={{ opacity: 0, scale: 0.8 }}
+ *   animate={{ opacity: 1, scale: 1 }}
+ * >
+ *   <CheckIcon className="size-4" />
+ * </MenuCheckboxItemIndicator>
+ * ```
+ */
+declare function MenuCheckboxItemIndicator({ keepMounted, ...props }: IMenuCheckboxItemIndicatorProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * MenuRadioGroup -- groups radio items for single-selection within a menu.
+ * Wraps base-ui Menu.RadioGroup.
+ *
+ * @param value - Controlled selected value
+ * @param defaultValue - Uncontrolled initial selected value
+ * @param onValueChange - Callback when selection changes
+ *
+ * @example
+ * ```tsx
+ * <MenuRadioGroup value={sortBy} onValueChange={setSortBy}>
+ *   <MenuRadioItem value="name">Name</MenuRadioItem>
+ *   <MenuRadioItem value="date">Date</MenuRadioItem>
+ *   <MenuRadioItem value="size">Size</MenuRadioItem>
+ * </MenuRadioGroup>
+ * ```
+ */
+declare function MenuRadioGroup(props: IMenuRadioGroupProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * MenuRadioItem -- a single option within a MenuRadioGroup.
+ * Tracks highlight state for animated highlight integration.
+ *
+ * @param value - The value this item represents
+ * @param disabled - Whether the item is disabled
+ * @param label - Accessible label
+ * @param slots - Partial class overrides per slot
+ * @param className - Additional class names
+ *
+ * @example
+ * ```tsx
+ * <MenuRadioItem value="name">
+ *   <MenuRadioItemIndicator>
+ *     <DotIcon />
+ *   </MenuRadioItemIndicator>
+ *   Sort by Name
+ * </MenuRadioItem>
+ * ```
+ */
+declare function MenuRadioItem({ value, disabled, label, closeOnClick, nativeButton, id, slots, className, ...props }: IMenuRadioItemProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * MenuRadioItemIndicator -- the selection dot/icon for a radio item.
+ * Renders via a motion.div for animated enter/exit transitions.
+ *
+ * @param keepMounted - Keep in DOM when unselected (for exit animations)
+ *
+ * @example
+ * ```tsx
+ * <MenuRadioItemIndicator
+ *   initial={{ opacity: 0 }}
+ *   animate={{ opacity: 1 }}
+ * >
+ *   <DotFilledIcon className="size-4" />
+ * </MenuRadioItemIndicator>
+ * ```
+ */
+declare function MenuRadioItemIndicator({ keepMounted, ...props }: IMenuRadioItemIndicatorProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * MenuShortcut -- displays a keyboard shortcut hint aligned to the right.
+ * Renders a plain `<span>` with the `shortcut` slot classes.
+ *
+ * @param slots - Partial class overrides per slot
+ * @param className - Additional class names
+ *
+ * @example
+ * ```tsx
+ * <MenuItem id="copy">
+ *   Copy
+ *   <MenuShortcut>Ctrl+C</MenuShortcut>
+ * </MenuItem>
+ * ```
+ */
+declare function MenuShortcut({ slots, className, ...props }: IMenuShortcutProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * MenuArrow -- the directional caret/arrow on the popup edge.
+ * Wraps base-ui Menu.Arrow.
+ *
+ * @example
+ * ```tsx
+ * <MenuPopup>
+ *   <MenuArrow className="fill-zinc-800" />
+ *   <MenuItem id="edit">Edit</MenuItem>
+ * </MenuPopup>
+ * ```
+ */
+declare function MenuArrow(props: IMenuArrowProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * MenuSeparator -- a horizontal divider between menu items or groups.
+ * Renders a base-ui Menu.Separator with the `separator` slot classes.
+ *
+ * @param slots - Partial class overrides per slot
+ * @param className - Additional class names
+ *
+ * @example
+ * ```tsx
+ * <MenuItem id="edit">Edit</MenuItem>
+ * <MenuSeparator className="my-1 h-px bg-white/10" />
+ * <MenuItem id="delete">Delete</MenuItem>
+ * ```
+ */
+declare function MenuSeparator({ slots, className, ...props }: IMenuSeparatorProps): import("react/jsx-runtime").JSX.Element;
+export { Menu, MenuTrigger, MenuPortal, MenuPositioner, MenuPopup, MenuArrow, MenuItem, MenuCheckboxItem, MenuCheckboxItemIndicator, MenuRadioGroup, MenuRadioItem, MenuRadioItemIndicator, MenuGroup, MenuGroupLabel, MenuSeparator, MenuShortcut, MenuHighlight, MenuHighlightItem, MenuSubmenu, MenuSubmenuTrigger, useMenuActiveValue, useMenu, };
+export type { IMenuProps, IMenuTriggerProps, IMenuPortalProps, IMenuPositionerProps, IMenuPopupProps, IMenuArrowProps, IMenuItemProps, IMenuCheckboxItemProps, IMenuCheckboxItemIndicatorProps, IMenuRadioItemProps, IMenuRadioItemIndicatorProps, IMenuRadioGroupProps, IMenuGroupProps, IMenuGroupLabelProps, IMenuSeparatorProps, IMenuShortcutProps, IMenuHighlightProps, IMenuHighlightItemProps, IMenuSubmenuProps, IMenuSubmenuTriggerProps, IMenuConfig, MenuActiveValueContextType, MenuContextType, } from './Menu.types';
+export type { MenuSlot } from './Menu.styles';
+//# sourceMappingURL=index.d.ts.map