@bug-on/m3-expressive 1.3.1 → 1.3.2

package/dist/{md3-D0_Z7IXj.d.mts → md3-BQhRygSi.d.mts}

@@ -28,4 +28,4 @@ type PolymorphicProps<C extends ElementType, Props = object> = Props & Omit<Comp
     children?: ReactNode;
 };
 
-export type { MD3SlotWidth as M, PolymorphicProps as P, MD3ColorStyle as a, MD3Shape as b, MD3Size as c, PolymorphicRef as d };
+export type { MD3ColorStyle as M, PolymorphicProps as P, MD3Shape as a, MD3Size as b, PolymorphicRef as c, MD3SlotWidth as d };

package/dist/{md3-D0_Z7IXj.d.ts → md3-BQhRygSi.d.ts}

@@ -28,4 +28,4 @@ type PolymorphicProps<C extends ElementType, Props = object> = Props & Omit<Comp
     children?: ReactNode;
 };
 
-export type { MD3SlotWidth as M, PolymorphicProps as P, MD3ColorStyle as a, MD3Shape as b, MD3Size as c, PolymorphicRef as d };
+export type { MD3ColorStyle as M, PolymorphicProps as P, MD3Shape as a, MD3Size as b, PolymorphicRef as c, MD3SlotWidth as d };

package/dist/menu-types-rZNQFO7Y.d.mts

@@ -0,0 +1,315 @@
+import * as React from 'react';
+
+/** Color variant of the menu — standard (surface-based) or vibrant (tertiary-based). */
+type MenuColorVariant = "standard" | "vibrant";
+/** Visual variant of the menu. */
+type MenuVariant = "baseline" | "expressive";
+/** Layout density for menu items: 0 (default: 48dp), -2 (40dp), -4 (32dp). */
+type MenuDensity = 0 | -2 | -4;
+/**
+ * Which Radix primitive family drives this menu:
+ * - `dropdown` → @radix-ui/react-dropdown-menu (button, text field, icon trigger)
+ * - `context`  → @radix-ui/react-context-menu (right-click / long-press trigger)
+ * - `static`   → plain HTML via Slot (VerticalMenu — always-visible)
+ */
+type MenuPrimitive = "dropdown" | "context" | "static";
+/**
+ * Position of a MenuItem within its group or menu.
+ * Controls the shape morphing (border-radius) applied to each item.
+ *
+ * - `leading`    → first item: top corners rounded more (CornerMedium top, CornerExtraSmall bottom)
+ * - `middle`     → middle items: CornerExtraSmall all corners
+ * - `trailing`   → last item: bottom corners rounded more (CornerExtraSmall top, CornerMedium bottom)
+ * - `standalone` → only item in group: CornerExtraSmall (same as middle, but semantically distinct)
+ */
+type MenuItemPosition = "standalone" | "leading" | "middle" | "trailing";
+/**
+ * Position of a MenuGroup within the popup container.
+ * Controls the container's border-radius shape morphing.
+ */
+type MenuGroupPosition = "standalone" | "leading" | "middle" | "trailing";
+interface MenuProps {
+    /** Menu items and groups */
+    children: React.ReactNode;
+    /**
+     * Color variant of the menu.
+     * Only applies when `variant="expressive"`. Baseline menus always use baseline colors.
+     * - `standard`: surface-container-low background
+     * - `vibrant`: tertiary-container background (use sparingly, high emphasis)
+     */
+    colorVariant?: MenuColorVariant;
+    /**
+     * Layout density of menu items: 0 (48dp), -2 (40dp), -4 (32dp).
+     * @default 0
+     */
+    density?: MenuDensity;
+    /**
+     * Visual variant of the menu.
+     * - `baseline`: original M3 specs (4dp corners, no shape morphing)
+     * - `expressive`: M3 Expressive specs (shape morphing, rounded groups)
+     * @default "baseline"
+     */
+    variant?: MenuVariant;
+    /**
+     * @deprecated Use `variant` instead. Will be removed in next major version.
+     */
+    menuVariant?: MenuVariant;
+    /**
+     * Controlled open state. When provided, the menu acts as a controlled component.
+     * Pair with `onOpenChange` to manage state externally.
+     */
+    open?: boolean;
+    /**
+     * Called when the menu's open state changes (both controlled and uncontrolled).
+     * Required when using `open` for controlled mode.
+     */
+    onOpenChange?: (open: boolean) => void;
+    /** Additional className for the root element */
+    className?: string;
+}
+interface MenuTriggerProps {
+    children: React.ReactNode;
+    /** If true, merges props with the child element instead of wrapping */
+    asChild?: boolean;
+    className?: string;
+}
+interface MenuContentProps {
+    children: React.ReactNode;
+    /** Gap between menu and anchor in pixels. Default: 6 */
+    sideOffset?: number;
+    /** Preferred side of the anchor to render the menu. */
+    side?: "top" | "bottom" | "left" | "right";
+    /** Preferred alignment relative to the anchor. */
+    align?: "start" | "center" | "end";
+    /**
+     * When true, disables overflow-hidden on the container so nested SubMenus
+     * can escape the bounds. Required when using SubMenu.
+     */
+    hasOverflow?: boolean;
+    /** Override colorVariant from MenuContext (only for expressive variant) */
+    colorVariant?: MenuColorVariant;
+    /**
+     * Separation style between groups (only applies when variant="expressive").
+     * - `gap`     → 2dp visual gap, transparent container
+     * - `divider` → solid container, no gap
+     * Default: "gap"
+     */
+    separatorStyle?: VerticalMenuSeparatorStyle;
+    /**
+     * When true, automatically sets the menu popover width to match the trigger width
+     * using Radix CSS variable `--radix-dropdown-menu-trigger-width`.
+     */
+    matchTriggerWidth?: boolean;
+    /**
+     * Maximum height of the scrollable content area inside the menu.
+     * When content exceeds this height, a ScrollArea scrollbar is activated.
+     * Set to undefined to disable.
+     * @default "360px"
+     */
+    maxHeight?: string;
+    /**
+     * Ref attached to the inner scrolling viewport element (ScrollArea.Viewport).
+     * Useful for virtualization hooks (e.g. passing as root for IntersectionObserver).
+     */
+    viewportRef?: React.Ref<HTMLDivElement>;
+    /**
+     * Callback providing the inner scrolling viewport element when mounted.
+     */
+    onViewportRef?: (node: HTMLDivElement | null) => void;
+    className?: string;
+}
+interface MenuItemProps {
+    /** Primary label text of the item */
+    children: React.ReactNode;
+    /** Callback when the item is clicked */
+    onClick?: React.MouseEventHandler<HTMLDivElement>;
+    /**
+     * Optional leading icon (20dp).
+     * For unselected state in selectable items; replaced by check icon when selected.
+     */
+    leadingIcon?: React.ReactNode;
+    /** Optional trailing icon (20dp) or chevron for submenus */
+    trailingIcon?: React.ReactNode;
+    /** Supporting text below the primary label (body-medium) */
+    supportingText?: React.ReactNode;
+    /** Trailing keyboard shortcut text e.g. "Ctrl+C", "⌘C" */
+    trailingText?: string;
+    /**
+     * Whether this item is selected/checked.
+     * When true: shows check icon (leading slot) and applies selected container color.
+     * Overrides itemPosition shape with `rounded-m3-md`.
+     */
+    selected?: boolean;
+    /** Whether this item is disabled */
+    disabled?: boolean;
+    /**
+     * Controls shape morphing based on position within its group.
+     * Automatically injected by MenuGroup via React.cloneElement when grouping is used.
+     */
+    itemPosition?: MenuItemPosition;
+    /** Override colorVariant from MenuContext */
+    colorVariant?: MenuColorVariant;
+    /** Layout density of this menu item: 0 (48dp), -2 (40dp), -4 (32dp). */
+    density?: MenuDensity;
+    /** If true, keeps the menu open after clicking (e.g. for multi-select items) */
+    keepOpen?: boolean;
+    className?: string;
+    /** Optional value for radio items. Required when role='menuitemradio'. */
+    value?: string;
+    /** Internal flag used by SubMenu to render this item as a SubTrigger primitive. */
+    isSubTrigger?: boolean;
+    /** ARIA role override. Defaults to 'menuitem', 'menuitemcheckbox', or 'menuitemradio' based on selected prop. */
+    role?: string;
+    /** Internal flag: true if rendered inside a gap-variant expressive menu */
+    isGapVariant?: boolean;
+}
+interface MenuGroupProps {
+    /** MenuItem children — itemPosition is auto-injected */
+    children: React.ReactNode;
+    /**
+     * Optional label displayed at the top of the group.
+     * Uses labelLarge typography with 12dp horizontal padding.
+     */
+    label?: string;
+    /**
+     * Zero-based index of this group in the parent menu.
+     * Used to determine shape (leading/middle/trailing/standalone).
+     * Auto-provided when using MenuContent's grouping utilities.
+     */
+    index?: number;
+    /**
+     * Total number of groups in the parent menu.
+     * Used together with index to determine shape.
+     */
+    count?: number;
+    /** Override colorVariant from MenuContext */
+    colorVariant?: MenuColorVariant;
+    /** Internal flag: true if rendered inside a gap-variant vertical menu (to adjust padding) */
+    isGapVariant?: boolean;
+    /** Optionally injected when nested inside another MenuGroup */
+    itemPosition?: MenuItemPosition;
+    className?: string;
+}
+interface MenuDividerProps {
+    className?: string;
+    isGapVariant?: boolean;
+}
+interface SubMenuProps {
+    /** The SubMenu children (another MenuContent) */
+    children: React.ReactNode;
+    /** The trigger element (typically a MenuItem with trailing chevron) */
+    trigger: React.ReactNode;
+    /** Preferred side to open the submenu. Default: 'right' */
+    side?: "left" | "right";
+    /** Override colorVariant from MenuContext */
+    colorVariant?: MenuColorVariant;
+    /** Delay in ms before submenu opens on hover. Default: 200 */
+    hoverOpenDelay?: number;
+    /** Delay in ms before submenu closes on pointer-leave. Default: 300 */
+    hoverCloseDelay?: number;
+}
+/**
+ * How groups within a VerticalMenuContent are separated.
+ * - `gap`     → 2dp gap between groups (SegmentedMenuTokens.SegmentedGap)
+ * - `divider` → outline-variant horizontal rule between groups (MenuDefaults.HorizontalDividerPadding)
+ * - `none`    → solid container without dividers between groups/items
+ */
+type VerticalMenuSeparatorStyle = "gap" | "divider" | "none";
+/**
+ * Root of an always-visible vertical menu (no trigger, no popup).
+ * Provides `MenuContext` with `colorVariant` to all descendants.
+ */
+interface VerticalMenuProps {
+    children: React.ReactNode;
+    /**
+     * Color variant of the menu.
+     * - `standard`: surface-container-low background (default)
+     * - `vibrant`: tertiary-container background
+     */
+    colorVariant?: MenuColorVariant;
+    className?: string;
+}
+/**
+ * Container that renders VerticalMenuGroup children in a vertical list.
+ * Handles separator injection (gap or divider) and auto-injects `index`/`count` into groups.
+ */
+interface VerticalMenuContentProps {
+    children: React.ReactNode;
+    /**
+     * Separation style between groups.
+     * - `gap`     → 2dp visual gap (default, matches MD3 Expressive spec image 1 left)
+     * - `divider` → horizontal `outline-variant` rule (matches MD3 Expressive spec image 1 right)
+     */
+    separatorStyle?: VerticalMenuSeparatorStyle;
+    /** Override colorVariant from VerticalMenu root */
+    colorVariant?: MenuColorVariant;
+    className?: string;
+}
+/** A group within a VerticalMenu. Alias of MenuGroupProps. */
+interface VerticalMenuGroupProps extends MenuGroupProps {
+}
+/** A plain horizontal divider for use between groups in a VerticalMenuContent with `separatorStyle="divider"`. */
+interface VerticalMenuDividerProps {
+    className?: string;
+    /** Optionally injected by VerticalMenuContent */
+    index?: number;
+    /** Optionally injected by VerticalMenuContent */
+    count?: number;
+    /** Optionally injected by VerticalMenuContent */
+    isGapVariant?: boolean;
+}
+/**
+ * Root of a context menu (right-click / long-press triggered popup).
+ *
+ * Wraps @radix-ui/react-context-menu Root and provides MenuContext with
+ * `menuPrimitive="context"` so MenuItem automatically uses ContextMenu primitives.
+ */
+interface ContextMenuProps {
+    children: React.ReactNode;
+    /**
+     * Visual variant of the context menu.
+     * - `baseline`: original M3 specs (4dp corners, no shape morphing)
+     * - `expressive`: M3 Expressive specs (shape morphing, rounded groups)
+     * @default "baseline"
+     */
+    variant?: MenuVariant;
+    /** Color variant. Only applies when `variant="expressive"`. */
+    colorVariant?: MenuColorVariant;
+    /** Additional className */
+    className?: string;
+}
+interface ContextMenuTriggerProps {
+    children: React.ReactNode;
+    /** If true, merges props with the child element instead of wrapping */
+    asChild?: boolean;
+    className?: string;
+}
+interface ContextMenuContentProps {
+    children: React.ReactNode;
+    /** Override colorVariant from ContextMenuContext */
+    colorVariant?: MenuColorVariant;
+    /**
+     * When true, disables overflow-hidden so nested SubMenus can escape bounds.
+     * Required when using SubMenu inside ContextMenu.
+     */
+    hasOverflow?: boolean;
+    /**
+     * Separation style between groups (only applies when variant="expressive").
+     * - `gap`     → 2dp visual gap, transparent container
+     * - `divider` → solid container, no gap
+     * Default: "gap"
+     */
+    separatorStyle?: VerticalMenuSeparatorStyle;
+    /**
+     * Maximum height of the scrollable content area inside the context menu.
+     * @default "360px"
+     */
+    maxHeight?: string;
+    /** Ref attached to the inner scrolling viewport element. */
+    viewportRef?: React.Ref<HTMLDivElement>;
+    /** Callback providing the inner scrolling viewport element when mounted. */
+    onViewportRef?: (node: HTMLDivElement | null) => void;
+    className?: string;
+}
+
+export type { ContextMenuContentProps as C, MenuColorVariant as M, SubMenuProps as S, VerticalMenuContentProps as V, ContextMenuProps as a, ContextMenuTriggerProps as b, MenuContentProps as c, MenuDividerProps as d, MenuGroupPosition as e, MenuGroupProps as f, MenuItemPosition as g, MenuItemProps as h, MenuPrimitive as i, MenuProps as j, MenuTriggerProps as k, MenuVariant as l, VerticalMenuDividerProps as m, VerticalMenuGroupProps as n, VerticalMenuProps as o, VerticalMenuSeparatorStyle as p, MenuDensity as q };

package/dist/menu-types-rZNQFO7Y.d.ts

@@ -0,0 +1,315 @@
+import * as React from 'react';
+
+/** Color variant of the menu — standard (surface-based) or vibrant (tertiary-based). */
+type MenuColorVariant = "standard" | "vibrant";
+/** Visual variant of the menu. */
+type MenuVariant = "baseline" | "expressive";
+/** Layout density for menu items: 0 (default: 48dp), -2 (40dp), -4 (32dp). */
+type MenuDensity = 0 | -2 | -4;
+/**
+ * Which Radix primitive family drives this menu:
+ * - `dropdown` → @radix-ui/react-dropdown-menu (button, text field, icon trigger)
+ * - `context`  → @radix-ui/react-context-menu (right-click / long-press trigger)
+ * - `static`   → plain HTML via Slot (VerticalMenu — always-visible)
+ */
+type MenuPrimitive = "dropdown" | "context" | "static";
+/**
+ * Position of a MenuItem within its group or menu.
+ * Controls the shape morphing (border-radius) applied to each item.
+ *
+ * - `leading`    → first item: top corners rounded more (CornerMedium top, CornerExtraSmall bottom)
+ * - `middle`     → middle items: CornerExtraSmall all corners
+ * - `trailing`   → last item: bottom corners rounded more (CornerExtraSmall top, CornerMedium bottom)
+ * - `standalone` → only item in group: CornerExtraSmall (same as middle, but semantically distinct)
+ */
+type MenuItemPosition = "standalone" | "leading" | "middle" | "trailing";
+/**
+ * Position of a MenuGroup within the popup container.
+ * Controls the container's border-radius shape morphing.
+ */
+type MenuGroupPosition = "standalone" | "leading" | "middle" | "trailing";
+interface MenuProps {
+    /** Menu items and groups */
+    children: React.ReactNode;
+    /**
+     * Color variant of the menu.
+     * Only applies when `variant="expressive"`. Baseline menus always use baseline colors.
+     * - `standard`: surface-container-low background
+     * - `vibrant`: tertiary-container background (use sparingly, high emphasis)
+     */
+    colorVariant?: MenuColorVariant;
+    /**
+     * Layout density of menu items: 0 (48dp), -2 (40dp), -4 (32dp).
+     * @default 0
+     */
+    density?: MenuDensity;
+    /**
+     * Visual variant of the menu.
+     * - `baseline`: original M3 specs (4dp corners, no shape morphing)
+     * - `expressive`: M3 Expressive specs (shape morphing, rounded groups)
+     * @default "baseline"
+     */
+    variant?: MenuVariant;
+    /**
+     * @deprecated Use `variant` instead. Will be removed in next major version.
+     */
+    menuVariant?: MenuVariant;
+    /**
+     * Controlled open state. When provided, the menu acts as a controlled component.
+     * Pair with `onOpenChange` to manage state externally.
+     */
+    open?: boolean;
+    /**
+     * Called when the menu's open state changes (both controlled and uncontrolled).
+     * Required when using `open` for controlled mode.
+     */
+    onOpenChange?: (open: boolean) => void;
+    /** Additional className for the root element */
+    className?: string;
+}
+interface MenuTriggerProps {
+    children: React.ReactNode;
+    /** If true, merges props with the child element instead of wrapping */
+    asChild?: boolean;
+    className?: string;
+}
+interface MenuContentProps {
+    children: React.ReactNode;
+    /** Gap between menu and anchor in pixels. Default: 6 */
+    sideOffset?: number;
+    /** Preferred side of the anchor to render the menu. */
+    side?: "top" | "bottom" | "left" | "right";
+    /** Preferred alignment relative to the anchor. */
+    align?: "start" | "center" | "end";
+    /**
+     * When true, disables overflow-hidden on the container so nested SubMenus
+     * can escape the bounds. Required when using SubMenu.
+     */
+    hasOverflow?: boolean;
+    /** Override colorVariant from MenuContext (only for expressive variant) */
+    colorVariant?: MenuColorVariant;
+    /**
+     * Separation style between groups (only applies when variant="expressive").
+     * - `gap`     → 2dp visual gap, transparent container
+     * - `divider` → solid container, no gap
+     * Default: "gap"
+     */
+    separatorStyle?: VerticalMenuSeparatorStyle;
+    /**
+     * When true, automatically sets the menu popover width to match the trigger width
+     * using Radix CSS variable `--radix-dropdown-menu-trigger-width`.
+     */
+    matchTriggerWidth?: boolean;
+    /**
+     * Maximum height of the scrollable content area inside the menu.
+     * When content exceeds this height, a ScrollArea scrollbar is activated.
+     * Set to undefined to disable.
+     * @default "360px"
+     */
+    maxHeight?: string;
+    /**
+     * Ref attached to the inner scrolling viewport element (ScrollArea.Viewport).
+     * Useful for virtualization hooks (e.g. passing as root for IntersectionObserver).
+     */
+    viewportRef?: React.Ref<HTMLDivElement>;
+    /**
+     * Callback providing the inner scrolling viewport element when mounted.
+     */
+    onViewportRef?: (node: HTMLDivElement | null) => void;
+    className?: string;
+}
+interface MenuItemProps {
+    /** Primary label text of the item */
+    children: React.ReactNode;
+    /** Callback when the item is clicked */
+    onClick?: React.MouseEventHandler<HTMLDivElement>;
+    /**
+     * Optional leading icon (20dp).
+     * For unselected state in selectable items; replaced by check icon when selected.
+     */
+    leadingIcon?: React.ReactNode;
+    /** Optional trailing icon (20dp) or chevron for submenus */
+    trailingIcon?: React.ReactNode;
+    /** Supporting text below the primary label (body-medium) */
+    supportingText?: React.ReactNode;
+    /** Trailing keyboard shortcut text e.g. "Ctrl+C", "⌘C" */
+    trailingText?: string;
+    /**
+     * Whether this item is selected/checked.
+     * When true: shows check icon (leading slot) and applies selected container color.
+     * Overrides itemPosition shape with `rounded-m3-md`.
+     */
+    selected?: boolean;
+    /** Whether this item is disabled */
+    disabled?: boolean;
+    /**
+     * Controls shape morphing based on position within its group.
+     * Automatically injected by MenuGroup via React.cloneElement when grouping is used.
+     */
+    itemPosition?: MenuItemPosition;
+    /** Override colorVariant from MenuContext */
+    colorVariant?: MenuColorVariant;
+    /** Layout density of this menu item: 0 (48dp), -2 (40dp), -4 (32dp). */
+    density?: MenuDensity;
+    /** If true, keeps the menu open after clicking (e.g. for multi-select items) */
+    keepOpen?: boolean;
+    className?: string;
+    /** Optional value for radio items. Required when role='menuitemradio'. */
+    value?: string;
+    /** Internal flag used by SubMenu to render this item as a SubTrigger primitive. */
+    isSubTrigger?: boolean;
+    /** ARIA role override. Defaults to 'menuitem', 'menuitemcheckbox', or 'menuitemradio' based on selected prop. */
+    role?: string;
+    /** Internal flag: true if rendered inside a gap-variant expressive menu */
+    isGapVariant?: boolean;
+}
+interface MenuGroupProps {
+    /** MenuItem children — itemPosition is auto-injected */
+    children: React.ReactNode;
+    /**
+     * Optional label displayed at the top of the group.
+     * Uses labelLarge typography with 12dp horizontal padding.
+     */
+    label?: string;
+    /**
+     * Zero-based index of this group in the parent menu.
+     * Used to determine shape (leading/middle/trailing/standalone).
+     * Auto-provided when using MenuContent's grouping utilities.
+     */
+    index?: number;
+    /**
+     * Total number of groups in the parent menu.
+     * Used together with index to determine shape.
+     */
+    count?: number;
+    /** Override colorVariant from MenuContext */
+    colorVariant?: MenuColorVariant;
+    /** Internal flag: true if rendered inside a gap-variant vertical menu (to adjust padding) */
+    isGapVariant?: boolean;
+    /** Optionally injected when nested inside another MenuGroup */
+    itemPosition?: MenuItemPosition;
+    className?: string;
+}
+interface MenuDividerProps {
+    className?: string;
+    isGapVariant?: boolean;
+}
+interface SubMenuProps {
+    /** The SubMenu children (another MenuContent) */
+    children: React.ReactNode;
+    /** The trigger element (typically a MenuItem with trailing chevron) */
+    trigger: React.ReactNode;
+    /** Preferred side to open the submenu. Default: 'right' */
+    side?: "left" | "right";
+    /** Override colorVariant from MenuContext */
+    colorVariant?: MenuColorVariant;
+    /** Delay in ms before submenu opens on hover. Default: 200 */
+    hoverOpenDelay?: number;
+    /** Delay in ms before submenu closes on pointer-leave. Default: 300 */
+    hoverCloseDelay?: number;
+}
+/**
+ * How groups within a VerticalMenuContent are separated.
+ * - `gap`     → 2dp gap between groups (SegmentedMenuTokens.SegmentedGap)
+ * - `divider` → outline-variant horizontal rule between groups (MenuDefaults.HorizontalDividerPadding)
+ * - `none`    → solid container without dividers between groups/items
+ */
+type VerticalMenuSeparatorStyle = "gap" | "divider" | "none";
+/**
+ * Root of an always-visible vertical menu (no trigger, no popup).
+ * Provides `MenuContext` with `colorVariant` to all descendants.
+ */
+interface VerticalMenuProps {
+    children: React.ReactNode;
+    /**
+     * Color variant of the menu.
+     * - `standard`: surface-container-low background (default)
+     * - `vibrant`: tertiary-container background
+     */
+    colorVariant?: MenuColorVariant;
+    className?: string;
+}
+/**
+ * Container that renders VerticalMenuGroup children in a vertical list.
+ * Handles separator injection (gap or divider) and auto-injects `index`/`count` into groups.
+ */
+interface VerticalMenuContentProps {
+    children: React.ReactNode;
+    /**
+     * Separation style between groups.
+     * - `gap`     → 2dp visual gap (default, matches MD3 Expressive spec image 1 left)
+     * - `divider` → horizontal `outline-variant` rule (matches MD3 Expressive spec image 1 right)
+     */
+    separatorStyle?: VerticalMenuSeparatorStyle;
+    /** Override colorVariant from VerticalMenu root */
+    colorVariant?: MenuColorVariant;
+    className?: string;
+}
+/** A group within a VerticalMenu. Alias of MenuGroupProps. */
+interface VerticalMenuGroupProps extends MenuGroupProps {
+}
+/** A plain horizontal divider for use between groups in a VerticalMenuContent with `separatorStyle="divider"`. */
+interface VerticalMenuDividerProps {
+    className?: string;
+    /** Optionally injected by VerticalMenuContent */
+    index?: number;
+    /** Optionally injected by VerticalMenuContent */
+    count?: number;
+    /** Optionally injected by VerticalMenuContent */
+    isGapVariant?: boolean;
+}
+/**
+ * Root of a context menu (right-click / long-press triggered popup).
+ *
+ * Wraps @radix-ui/react-context-menu Root and provides MenuContext with
+ * `menuPrimitive="context"` so MenuItem automatically uses ContextMenu primitives.
+ */
+interface ContextMenuProps {
+    children: React.ReactNode;
+    /**
+     * Visual variant of the context menu.
+     * - `baseline`: original M3 specs (4dp corners, no shape morphing)
+     * - `expressive`: M3 Expressive specs (shape morphing, rounded groups)
+     * @default "baseline"
+     */
+    variant?: MenuVariant;
+    /** Color variant. Only applies when `variant="expressive"`. */
+    colorVariant?: MenuColorVariant;
+    /** Additional className */
+    className?: string;
+}
+interface ContextMenuTriggerProps {
+    children: React.ReactNode;
+    /** If true, merges props with the child element instead of wrapping */
+    asChild?: boolean;
+    className?: string;
+}
+interface ContextMenuContentProps {
+    children: React.ReactNode;
+    /** Override colorVariant from ContextMenuContext */
+    colorVariant?: MenuColorVariant;
+    /**
+     * When true, disables overflow-hidden so nested SubMenus can escape bounds.
+     * Required when using SubMenu inside ContextMenu.
+     */
+    hasOverflow?: boolean;
+    /**
+     * Separation style between groups (only applies when variant="expressive").
+     * - `gap`     → 2dp visual gap, transparent container
+     * - `divider` → solid container, no gap
+     * Default: "gap"
+     */
+    separatorStyle?: VerticalMenuSeparatorStyle;
+    /**
+     * Maximum height of the scrollable content area inside the context menu.
+     * @default "360px"
+     */
+    maxHeight?: string;
+    /** Ref attached to the inner scrolling viewport element. */
+    viewportRef?: React.Ref<HTMLDivElement>;
+    /** Callback providing the inner scrolling viewport element when mounted. */
+    onViewportRef?: (node: HTMLDivElement | null) => void;
+    className?: string;
+}
+
+export type { ContextMenuContentProps as C, MenuColorVariant as M, SubMenuProps as S, VerticalMenuContentProps as V, ContextMenuProps as a, ContextMenuTriggerProps as b, MenuContentProps as c, MenuDividerProps as d, MenuGroupPosition as e, MenuGroupProps as f, MenuItemPosition as g, MenuItemProps as h, MenuPrimitive as i, MenuProps as j, MenuTriggerProps as k, MenuVariant as l, VerticalMenuDividerProps as m, VerticalMenuGroupProps as n, VerticalMenuProps as o, VerticalMenuSeparatorStyle as p, MenuDensity as q };