@skdx/react 0.26.0

package/dist/dropdown-menu/DropdownMenu.d.cts

@@ -0,0 +1,52 @@
+import * as React from 'react';
+import type { PrimitivePropsWithRef } from '../utils/primitive.cjs';
+import type { DropdownMenuContextValue, DropdownMenuProps } from './types.cjs';
+/** @internal Selects focusable, non-disabled menu items within the content for roving-focus navigation. */
+export declare const ITEM_SELECTOR = "[role^=\"menuitem\"]:not([data-disabled])";
+export declare const DropdownMenuProvider: {
+    (props: DropdownMenuContextValue & {
+        children: React.ReactNode;
+    }): React.JSX.Element;
+    displayName: string;
+}, useDropdownMenuContext: (consumerName: string) => DropdownMenuContextValue;
+/**
+ * Root of a dropdown menu triggered by a button: owns open state and hands
+ * it down to `DropdownMenuTrigger` / `DropdownMenuPortal` /
+ * `DropdownMenuContent` / item parts / `DropdownMenuArrow` via context.
+ * Wraps children in the shared popper positioning root. Renders no DOM
+ * element itself.
+ *
+ * Works controlled (`open` + `onOpenChange`) or uncontrolled (`defaultOpen`).
+ *
+ * @example
+ * ```tsx
+ * <DropdownMenu>
+ *   <DropdownMenuTrigger>Options</DropdownMenuTrigger>
+ *   <DropdownMenuPortal>
+ *     <DropdownMenuContent>
+ *       <DropdownMenuItem onSelect={() => console.log('Edit')}>Edit</DropdownMenuItem>
+ *       <DropdownMenuSeparator />
+ *       <DropdownMenuItem onSelect={() => console.log('Delete')}>Delete</DropdownMenuItem>
+ *     </DropdownMenuContent>
+ *   </DropdownMenuPortal>
+ * </DropdownMenu>
+ * ```
+ */
+export declare function DropdownMenu({ children, open: openProp, defaultOpen, onOpenChange, onOpenChangeComplete, }: DropdownMenuProps): React.JSX.Element;
+export declare namespace DropdownMenu {
+    var displayName: string;
+}
+/**
+ * Optional visual arrow pointing from `DropdownMenuContent` back at the
+ * trigger. Must be rendered inside `DropdownMenuContent`; self-positions
+ * based on the resolved `side`.
+ *
+ * @example
+ * ```tsx
+ * <DropdownMenuContent>
+ *   <DropdownMenuItem>Edit</DropdownMenuItem>
+ *   <DropdownMenuArrow />
+ * </DropdownMenuContent>
+ * ```
+ */
+export declare const DropdownMenuArrow: React.ForwardRefExoticComponent<Omit<PrimitivePropsWithRef<"span">, "ref"> & React.RefAttributes<HTMLSpanElement>>;

package/dist/dropdown-menu/DropdownMenu.d.ts

@@ -0,0 +1,52 @@
+import * as React from 'react';
+import type { PrimitivePropsWithRef } from '../utils/primitive.js';
+import type { DropdownMenuContextValue, DropdownMenuProps } from './types.js';
+/** @internal Selects focusable, non-disabled menu items within the content for roving-focus navigation. */
+export declare const ITEM_SELECTOR = "[role^=\"menuitem\"]:not([data-disabled])";
+export declare const DropdownMenuProvider: {
+    (props: DropdownMenuContextValue & {
+        children: React.ReactNode;
+    }): React.JSX.Element;
+    displayName: string;
+}, useDropdownMenuContext: (consumerName: string) => DropdownMenuContextValue;
+/**
+ * Root of a dropdown menu triggered by a button: owns open state and hands
+ * it down to `DropdownMenuTrigger` / `DropdownMenuPortal` /
+ * `DropdownMenuContent` / item parts / `DropdownMenuArrow` via context.
+ * Wraps children in the shared popper positioning root. Renders no DOM
+ * element itself.
+ *
+ * Works controlled (`open` + `onOpenChange`) or uncontrolled (`defaultOpen`).
+ *
+ * @example
+ * ```tsx
+ * <DropdownMenu>
+ *   <DropdownMenuTrigger>Options</DropdownMenuTrigger>
+ *   <DropdownMenuPortal>
+ *     <DropdownMenuContent>
+ *       <DropdownMenuItem onSelect={() => console.log('Edit')}>Edit</DropdownMenuItem>
+ *       <DropdownMenuSeparator />
+ *       <DropdownMenuItem onSelect={() => console.log('Delete')}>Delete</DropdownMenuItem>
+ *     </DropdownMenuContent>
+ *   </DropdownMenuPortal>
+ * </DropdownMenu>
+ * ```
+ */
+export declare function DropdownMenu({ children, open: openProp, defaultOpen, onOpenChange, onOpenChangeComplete, }: DropdownMenuProps): React.JSX.Element;
+export declare namespace DropdownMenu {
+    var displayName: string;
+}
+/**
+ * Optional visual arrow pointing from `DropdownMenuContent` back at the
+ * trigger. Must be rendered inside `DropdownMenuContent`; self-positions
+ * based on the resolved `side`.
+ *
+ * @example
+ * ```tsx
+ * <DropdownMenuContent>
+ *   <DropdownMenuItem>Edit</DropdownMenuItem>
+ *   <DropdownMenuArrow />
+ * </DropdownMenuContent>
+ * ```
+ */
+export declare const DropdownMenuArrow: React.ForwardRefExoticComponent<Omit<PrimitivePropsWithRef<"span">, "ref"> & React.RefAttributes<HTMLSpanElement>>;

package/dist/dropdown-menu/DropdownMenu.js

@@ -0,0 +1 @@
+import*as s from"react";import{createSafeContext as Q}from"../utils/createContext.js";import{skdxPart as X}from"../utils/part.js";import{PopperArrow as Y,PopperRoot as Z}from"../utils/popper.js";import{useControllableState as j}from"../utils/useControllableState.js";import{useOpenChangeComplete as oo}from"../utils/useOpenChangeComplete.js";import{jsx as R}from"react/jsx-runtime";var x='[role^="menuitem"]:not([data-disabled])',[eo,u]=Q("DropdownMenu");function ro({children:o,open:e,defaultOpen:r=!1,onOpenChange:n,onOpenChangeComplete:p}){let i=s.useRef(null),d=s.useRef(null),[m=!1,c]=j({prop:e,defaultProp:r,onChange:n});return oo(m,d,p),R(Z,{children:R(eo,{triggerRef:i,contentRef:d,contentId:s.useId(),open:m,onOpenChange:c,children:o})})}ro.displayName="DropdownMenu";var no=s.forwardRef((o,e)=>R(Y,{...o,...X("dropdown-menu","arrow",o.className),ref:e}));no.displayName="DropdownMenuArrow";import*as g from"react";import{useComposedRefs as to}from"../utils/composeRefs.js";import{skdxPart as po}from"../utils/part.js";import{PopperAnchor as ao}from"../utils/popper.js";import{composeEventHandlers as C,Primitive as mo}from"../utils/primitive.js";import{jsx as I}from"react/jsx-runtime";var y=g.forwardRef((o,e)=>{let r=u("DropdownMenuTrigger"),n=to(e,r.triggerRef);return I(ao,{asChild:!0,children:I(mo.button,{type:"button","aria-haspopup":"menu","aria-expanded":r.open,"aria-controls":r.contentId,"data-state":r.open?"open":"closed","data-disabled":o.disabled?"":void 0,...o,...po("dropdown-menu","trigger",o.className),ref:n,onClick:C(o.onClick,()=>{o.disabled||r.onOpenChange(!r.open)}),onKeyDown:C(o.onKeyDown,p=>{o.disabled||["ArrowDown","ArrowUp"].includes(p.key)&&(p.preventDefault(),r.onOpenChange(!0))})})})});y.displayName="DropdownMenuTrigger";import{Portal as io}from"../utils/portal.js";import{jsx as uo}from"react/jsx-runtime";var v=({forceMount:o,children:e,...r})=>{let n=u("DropdownMenuPortal");return o||n.open?uo(io,{...r,children:e}):null};v.displayName="DropdownMenuPortal";import*as w from"react";import{useComposedRefs as so}from"../utils/composeRefs.js";import{MENU_BRANCH_ATTRIBUTE as fo}from"../utils/menuSub.js";import{skdxPart as co}from"../utils/part.js";import{PopperContent as lo}from"../utils/popper.js";import{composeEventHandlers as wo}from"../utils/primitive.js";import{useDismiss as Mo}from"../utils/useDismiss.js";import{useRovingFocus as Do}from"../utils/useRovingFocus.js";import{jsx as Po}from"react/jsx-runtime";var b=w.forwardRef(({forceMount:o,loop:e=!0,onEscapeKeyDown:r,onPointerDownOutside:n,onFocusOutside:p,onInteractOutside:i,side:d="bottom",align:m="start",sideOffset:c=4,...P},z)=>{let t=u("DropdownMenuContent"),$=so(z,t.contentRef),J=Do({orientation:"vertical",loop:e,itemSelector:x,typeahead:!0});return Mo({enabled:t.open,insideSelector:`[${fo}]`,onEscapeKeyDown:a=>{r?.(a),a.defaultPrevented||(t.onOpenChange(!1),t.triggerRef.current?.focus())},onInteractOutside:i,onPointerDownOutside:a=>{n?.(a),a.defaultPrevented||t.onOpenChange(!1)},onFocusOutside:a=>{p?.(a),a.defaultPrevented||t.onOpenChange(!1)}},[t.contentRef,t.triggerRef]),w.useEffect(()=>{if(!t.open)return;let a=requestAnimationFrame(()=>{(t.contentRef.current?.querySelector(x)??t.contentRef.current)?.focus()});return()=>cancelAnimationFrame(a)},[t.open,t.contentRef]),o||t.open?Po(lo,{component:"dropdown-menu",role:"menu","aria-orientation":"vertical",id:t.contentId,"data-state":t.open?"open":"closed",tabIndex:-1,side:d,align:m,sideOffset:c,...P,...co("dropdown-menu","content",P.className),ref:$,onKeyDown:wo(P.onKeyDown,a=>{J(a),a.key==="Tab"&&(a.preventDefault(),t.onOpenChange(!1),t.triggerRef.current?.focus())})}):null});b.displayName="DropdownMenuContent";import*as M from"react";import{skdxPart as Ro}from"../utils/part.js";import{Primitive as xo}from"../utils/primitive.js";import{useMenuItem as Co}from"../utils/useMenuItem.js";import{jsx as Io}from"react/jsx-runtime";var f=M.createContext(!1);function l({disabled:o,onSelect:e,props:r}){let n=u("DropdownMenuItem");return Co({disabled:o,onSelect:e,onSelected:()=>{n.onOpenChange(!1),n.triggerRef.current?.focus()},contentRef:n.contentRef,props:r})}var h=M.forwardRef(({disabled:o,onSelect:e,...r},n)=>{let p=l({disabled:o,onSelect:e,props:r});return Io(xo.div,{role:"menuitem",...r,...p,...Ro("dropdown-menu","item",r.className),ref:n})});h.displayName="DropdownMenuItem";import*as T from"react";import{skdxPart as go}from"../utils/part.js";import{Primitive as yo}from"../utils/primitive.js";import{jsx as S}from"react/jsx-runtime";var k=T.forwardRef(({checked:o=!1,onCheckedChange:e,disabled:r,onSelect:n,...p},i)=>{let d=l({disabled:r,onSelect:m=>{e?.(!o),n?.(m),m.preventDefault()},props:p});return S(f.Provider,{value:o,children:S(yo.div,{role:"menuitemcheckbox","aria-checked":o,"data-state":o?"checked":"unchecked",...p,...d,...go("dropdown-menu","checkbox-item",p.className),ref:i})})});k.displayName="DropdownMenuCheckboxItem";import*as N from"react";import{createSafeContext as vo}from"../utils/createContext.js";import{skdxPart as bo}from"../utils/part.js";import{Primitive as ho}from"../utils/primitive.js";import{jsx as E}from"react/jsx-runtime";var[So,L]=vo("DropdownMenuRadioGroup"),G=N.forwardRef(({value:o,onValueChange:e,...r},n)=>E(So,{value:o,onValueChange:e,children:E(ho.div,{role:"group",...r,...bo("dropdown-menu","radio-group",r.className),ref:n})}));G.displayName="DropdownMenuRadioGroup";import*as O from"react";import{skdxPart as To}from"../utils/part.js";import{Primitive as ko}from"../utils/primitive.js";import{jsx as H}from"react/jsx-runtime";var A=O.forwardRef(({value:o,disabled:e,onSelect:r,...n},p)=>{let i=L("DropdownMenuRadioItem"),d=i.value===o,m=l({disabled:e,onSelect:c=>{i.onValueChange?.(o),r?.(c)},props:n});return H(f.Provider,{value:d,children:H(ko.div,{role:"menuitemradio","aria-checked":d,"data-state":d?"checked":"unchecked",...n,...m,...To("dropdown-menu","radio-item",n.className),ref:p})})});A.displayName="DropdownMenuRadioItem";import*as D from"react";import{skdxPart as Eo}from"../utils/part.js";import{Primitive as No}from"../utils/primitive.js";import{jsx as Lo}from"react/jsx-runtime";var K=D.forwardRef(({forceMount:o,...e},r)=>{let n=D.useContext(f);return o||n?Lo(No.span,{"data-state":n?"checked":"unchecked",...e,...Eo("dropdown-menu","item-indicator",e.className),ref:r}):null});K.displayName="DropdownMenuItemIndicator";import*as V from"react";import{skdxPart as Go}from"../utils/part.js";import{Primitive as Ho}from"../utils/primitive.js";import{jsx as Oo}from"react/jsx-runtime";var B=V.forwardRef((o,e)=>Oo(Ho.div,{role:"group",...o,...Go("dropdown-menu","group",o.className),ref:e}));B.displayName="DropdownMenuGroup";import*as F from"react";import{skdxPart as Ao}from"../utils/part.js";import{Primitive as Ko}from"../utils/primitive.js";import{jsx as Vo}from"react/jsx-runtime";var _=F.forwardRef((o,e)=>Vo(Ko.div,{...o,...Ao("dropdown-menu","label",o.className),ref:e}));_.displayName="DropdownMenuLabel";import*as U from"react";import{skdxPart as Bo}from"../utils/part.js";import{Primitive as Fo}from"../utils/primitive.js";import{jsx as _o}from"react/jsx-runtime";var q=U.forwardRef((o,e)=>_o(Fo.div,{role:"separator","aria-orientation":"horizontal",...o,...Bo("dropdown-menu","separator",o.className),ref:e}));q.displayName="DropdownMenuSeparator";import{MenuSub as Uo,MenuSubContent as qo,MenuSubTrigger as Wo}from"../utils/menuSub.js";import{jsx as Jo}from"react/jsx-runtime";function W(o){return Jo(Uo,{family:"dropdown-menu",...o})}W.displayName="DropdownMenuSub";var zo=Wo,$o=qo;export{ro as DropdownMenu,no as DropdownMenuArrow,k as DropdownMenuCheckboxItem,b as DropdownMenuContent,B as DropdownMenuGroup,h as DropdownMenuItem,K as DropdownMenuItemIndicator,_ as DropdownMenuLabel,v as DropdownMenuPortal,eo as DropdownMenuProvider,G as DropdownMenuRadioGroup,A as DropdownMenuRadioItem,q as DropdownMenuSeparator,W as DropdownMenuSub,$o as DropdownMenuSubContent,zo as DropdownMenuSubTrigger,y as DropdownMenuTrigger,x as ITEM_SELECTOR,u as useDropdownMenuContext};

package/dist/dropdown-menu/DropdownMenuCheckboxItem.d.cts

@@ -0,0 +1,20 @@
+import * as React from 'react';
+import type { DropdownMenuCheckboxItemProps } from './types.cjs';
+/**
+ * A toggleable menu item: `role="menuitemcheckbox"` with `aria-checked` and
+ * `data-state` (`checked`/`unchecked`) reflecting `checked`. Selecting it
+ * (click or Enter/Space) toggles `checked` via `onCheckedChange` and, unlike
+ * `DropdownMenuItem`, keeps the menu open by default (call
+ * `event.preventDefault()` in `onSelect` to opt out). Wrap a
+ * `DropdownMenuItemIndicator` inside it to render a check glyph only when
+ * checked.
+ *
+ * @example
+ * ```tsx
+ * <DropdownMenuCheckboxItem checked={showToolbar} onCheckedChange={setShowToolbar}>
+ *   <DropdownMenuItemIndicator>✓</DropdownMenuItemIndicator>
+ *   Show toolbar
+ * </DropdownMenuCheckboxItem>
+ * ```
+ */
+export declare const DropdownMenuCheckboxItem: React.ForwardRefExoticComponent<Omit<DropdownMenuCheckboxItemProps, "ref"> & React.RefAttributes<HTMLDivElement>>;

package/dist/dropdown-menu/DropdownMenuCheckboxItem.d.ts

@@ -0,0 +1,20 @@
+import * as React from 'react';
+import type { DropdownMenuCheckboxItemProps } from './types.js';
+/**
+ * A toggleable menu item: `role="menuitemcheckbox"` with `aria-checked` and
+ * `data-state` (`checked`/`unchecked`) reflecting `checked`. Selecting it
+ * (click or Enter/Space) toggles `checked` via `onCheckedChange` and, unlike
+ * `DropdownMenuItem`, keeps the menu open by default (call
+ * `event.preventDefault()` in `onSelect` to opt out). Wrap a
+ * `DropdownMenuItemIndicator` inside it to render a check glyph only when
+ * checked.
+ *
+ * @example
+ * ```tsx
+ * <DropdownMenuCheckboxItem checked={showToolbar} onCheckedChange={setShowToolbar}>
+ *   <DropdownMenuItemIndicator>✓</DropdownMenuItemIndicator>
+ *   Show toolbar
+ * </DropdownMenuCheckboxItem>
+ * ```
+ */
+export declare const DropdownMenuCheckboxItem: React.ForwardRefExoticComponent<Omit<DropdownMenuCheckboxItemProps, "ref"> & React.RefAttributes<HTMLDivElement>>;

package/dist/dropdown-menu/DropdownMenuContent.d.cts

@@ -0,0 +1,33 @@
+import * as React from 'react';
+import type { DropdownMenuContentProps } from './types.cjs';
+/**
+ * The menu's floating panel: `role="menu"` with `aria-orientation="vertical"`
+ * and `data-state` (`open`/`closed`), positioned via the shared popper layer
+ * against the trigger using `side` (defaults to `'bottom'`) / `align`
+ * (defaults to `'start'`) / `sideOffset` (defaults to `4`) / `alignOffset`,
+ * flipping/shifting to avoid viewport collisions unless `avoidCollisions` is
+ * `false`. Also exposes `data-side`/`data-align` reflecting the resolved
+ * placement.
+ *
+ * Provides roving-focus Up/Down arrow navigation (wrapping unless `loop` is
+ * `false`) with typeahead, focuses the first item on open, and closes on
+ * Escape, Tab (per the WAI-ARIA menu pattern), or an outside interaction:
+ * pointer-down outside or focus moving outside, each reported to
+ * `onPointerDownOutside`/`onFocusOutside` and, just before them and with the
+ * same event, to `onInteractOutside`. Any of those (or `onEscapeKeyDown`)
+ * calling `event.preventDefault()` keeps it open. Mounts only while open
+ * unless `forceMount` is set.
+ *
+ * @example
+ * ```tsx
+ * <DropdownMenuPortal>
+ *   <DropdownMenuContent side="bottom" align="start" sideOffset={4}>
+ *     <DropdownMenuItem>Edit</DropdownMenuItem>
+ *     <DropdownMenuItem>Duplicate</DropdownMenuItem>
+ *     <DropdownMenuSeparator />
+ *     <DropdownMenuItem disabled>Delete</DropdownMenuItem>
+ *   </DropdownMenuContent>
+ * </DropdownMenuPortal>
+ * ```
+ */
+export declare const DropdownMenuContent: React.ForwardRefExoticComponent<Omit<DropdownMenuContentProps, "ref"> & React.RefAttributes<HTMLDivElement>>;

package/dist/dropdown-menu/DropdownMenuContent.d.ts

@@ -0,0 +1,33 @@
+import * as React from 'react';
+import type { DropdownMenuContentProps } from './types.js';
+/**
+ * The menu's floating panel: `role="menu"` with `aria-orientation="vertical"`
+ * and `data-state` (`open`/`closed`), positioned via the shared popper layer
+ * against the trigger using `side` (defaults to `'bottom'`) / `align`
+ * (defaults to `'start'`) / `sideOffset` (defaults to `4`) / `alignOffset`,
+ * flipping/shifting to avoid viewport collisions unless `avoidCollisions` is
+ * `false`. Also exposes `data-side`/`data-align` reflecting the resolved
+ * placement.
+ *
+ * Provides roving-focus Up/Down arrow navigation (wrapping unless `loop` is
+ * `false`) with typeahead, focuses the first item on open, and closes on
+ * Escape, Tab (per the WAI-ARIA menu pattern), or an outside interaction:
+ * pointer-down outside or focus moving outside, each reported to
+ * `onPointerDownOutside`/`onFocusOutside` and, just before them and with the
+ * same event, to `onInteractOutside`. Any of those (or `onEscapeKeyDown`)
+ * calling `event.preventDefault()` keeps it open. Mounts only while open
+ * unless `forceMount` is set.
+ *
+ * @example
+ * ```tsx
+ * <DropdownMenuPortal>
+ *   <DropdownMenuContent side="bottom" align="start" sideOffset={4}>
+ *     <DropdownMenuItem>Edit</DropdownMenuItem>
+ *     <DropdownMenuItem>Duplicate</DropdownMenuItem>
+ *     <DropdownMenuSeparator />
+ *     <DropdownMenuItem disabled>Delete</DropdownMenuItem>
+ *   </DropdownMenuContent>
+ * </DropdownMenuPortal>
+ * ```
+ */
+export declare const DropdownMenuContent: React.ForwardRefExoticComponent<Omit<DropdownMenuContentProps, "ref"> & React.RefAttributes<HTMLDivElement>>;

package/dist/dropdown-menu/DropdownMenuGroup.d.cts

@@ -0,0 +1,16 @@
+import * as React from 'react';
+import type { DropdownMenuGroupProps } from './types.cjs';
+/**
+ * Semantic grouping of related items: renders a `<div role="group">`.
+ * Pair with a preceding `DropdownMenuLabel` to caption the group.
+ *
+ * @example
+ * ```tsx
+ * <DropdownMenuGroup>
+ *   <DropdownMenuLabel>Actions</DropdownMenuLabel>
+ *   <DropdownMenuItem>Edit</DropdownMenuItem>
+ *   <DropdownMenuItem>Duplicate</DropdownMenuItem>
+ * </DropdownMenuGroup>
+ * ```
+ */
+export declare const DropdownMenuGroup: React.ForwardRefExoticComponent<Omit<DropdownMenuGroupProps, "ref"> & React.RefAttributes<HTMLDivElement>>;

package/dist/dropdown-menu/DropdownMenuGroup.d.ts

@@ -0,0 +1,16 @@
+import * as React from 'react';
+import type { DropdownMenuGroupProps } from './types.js';
+/**
+ * Semantic grouping of related items: renders a `<div role="group">`.
+ * Pair with a preceding `DropdownMenuLabel` to caption the group.
+ *
+ * @example
+ * ```tsx
+ * <DropdownMenuGroup>
+ *   <DropdownMenuLabel>Actions</DropdownMenuLabel>
+ *   <DropdownMenuItem>Edit</DropdownMenuItem>
+ *   <DropdownMenuItem>Duplicate</DropdownMenuItem>
+ * </DropdownMenuGroup>
+ * ```
+ */
+export declare const DropdownMenuGroup: React.ForwardRefExoticComponent<Omit<DropdownMenuGroupProps, "ref"> & React.RefAttributes<HTMLDivElement>>;

package/dist/dropdown-menu/DropdownMenuItem.d.cts

@@ -0,0 +1,31 @@
+import * as React from 'react';
+import type { DropdownMenuItemProps } from './types.cjs';
+/** @internal True inside a checkbox/radio item so its `ItemIndicator` knows whether the item is checked. */
+export declare const ItemIndicatorContext: React.Context<boolean>;
+/** @internal Wires a {@link DropdownMenuItem} into the shared menu-item interactions, closing the menu and refocusing the trigger on selection. */
+export declare function useMenuItem({ disabled, onSelect, props, }: {
+    disabled?: boolean;
+    onSelect?: (event: Event) => void;
+    props: DropdownMenuItemProps;
+}): {
+    'data-disabled': string | undefined;
+    'aria-disabled': true | undefined;
+    tabIndex: number | undefined;
+    onClick: (event: React.MouseEvent<HTMLDivElement, MouseEvent>) => void;
+    onKeyDown: (event: React.KeyboardEvent<HTMLDivElement>) => void;
+    onPointerEnter: (event: React.PointerEvent<HTMLDivElement>) => void;
+    onPointerLeave: (event: React.PointerEvent<HTMLDivElement>) => void;
+};
+/**
+ * A single selectable menu item: `role="menuitem"`, participates in the
+ * content's roving-focus/typeahead navigation. Selecting it (click,
+ * Enter, or Space) fires `onSelect` and closes the menu, returning focus to
+ * the trigger, unless `onSelect` calls `event.preventDefault()`. Set
+ * `disabled` to exclude it from navigation and selection.
+ *
+ * @example
+ * ```tsx
+ * <DropdownMenuItem onSelect={() => console.log('Edit')}>Edit</DropdownMenuItem>
+ * ```
+ */
+export declare const DropdownMenuItem: React.ForwardRefExoticComponent<Omit<DropdownMenuItemProps, "ref"> & React.RefAttributes<HTMLDivElement>>;

package/dist/dropdown-menu/DropdownMenuItem.d.ts

@@ -0,0 +1,31 @@
+import * as React from 'react';
+import type { DropdownMenuItemProps } from './types.js';
+/** @internal True inside a checkbox/radio item so its `ItemIndicator` knows whether the item is checked. */
+export declare const ItemIndicatorContext: React.Context<boolean>;
+/** @internal Wires a {@link DropdownMenuItem} into the shared menu-item interactions, closing the menu and refocusing the trigger on selection. */
+export declare function useMenuItem({ disabled, onSelect, props, }: {
+    disabled?: boolean;
+    onSelect?: (event: Event) => void;
+    props: DropdownMenuItemProps;
+}): {
+    'data-disabled': string | undefined;
+    'aria-disabled': true | undefined;
+    tabIndex: number | undefined;
+    onClick: (event: React.MouseEvent<HTMLDivElement, MouseEvent>) => void;
+    onKeyDown: (event: React.KeyboardEvent<HTMLDivElement>) => void;
+    onPointerEnter: (event: React.PointerEvent<HTMLDivElement>) => void;
+    onPointerLeave: (event: React.PointerEvent<HTMLDivElement>) => void;
+};
+/**
+ * A single selectable menu item: `role="menuitem"`, participates in the
+ * content's roving-focus/typeahead navigation. Selecting it (click,
+ * Enter, or Space) fires `onSelect` and closes the menu, returning focus to
+ * the trigger, unless `onSelect` calls `event.preventDefault()`. Set
+ * `disabled` to exclude it from navigation and selection.
+ *
+ * @example
+ * ```tsx
+ * <DropdownMenuItem onSelect={() => console.log('Edit')}>Edit</DropdownMenuItem>
+ * ```
+ */
+export declare const DropdownMenuItem: React.ForwardRefExoticComponent<Omit<DropdownMenuItemProps, "ref"> & React.RefAttributes<HTMLDivElement>>;

package/dist/dropdown-menu/DropdownMenuItemIndicator.d.cts

@@ -0,0 +1,17 @@
+import * as React from 'react';
+import type { DropdownMenuItemIndicatorProps } from './types.cjs';
+/**
+ * Renders its children (typically a check glyph) only while the enclosing
+ * `DropdownMenuCheckboxItem` or `DropdownMenuRadioItem` is checked. Exposes
+ * `data-state` (`checked`/`unchecked`). Mounts only while checked unless
+ * `forceMount` is set.
+ *
+ * @example
+ * ```tsx
+ * <DropdownMenuCheckboxItem checked={checked} onCheckedChange={setChecked}>
+ *   <DropdownMenuItemIndicator>✓</DropdownMenuItemIndicator>
+ *   Show toolbar
+ * </DropdownMenuCheckboxItem>
+ * ```
+ */
+export declare const DropdownMenuItemIndicator: React.ForwardRefExoticComponent<Omit<DropdownMenuItemIndicatorProps, "ref"> & React.RefAttributes<HTMLSpanElement>>;

package/dist/dropdown-menu/DropdownMenuItemIndicator.d.ts

@@ -0,0 +1,17 @@
+import * as React from 'react';
+import type { DropdownMenuItemIndicatorProps } from './types.js';
+/**
+ * Renders its children (typically a check glyph) only while the enclosing
+ * `DropdownMenuCheckboxItem` or `DropdownMenuRadioItem` is checked. Exposes
+ * `data-state` (`checked`/`unchecked`). Mounts only while checked unless
+ * `forceMount` is set.
+ *
+ * @example
+ * ```tsx
+ * <DropdownMenuCheckboxItem checked={checked} onCheckedChange={setChecked}>
+ *   <DropdownMenuItemIndicator>✓</DropdownMenuItemIndicator>
+ *   Show toolbar
+ * </DropdownMenuCheckboxItem>
+ * ```
+ */
+export declare const DropdownMenuItemIndicator: React.ForwardRefExoticComponent<Omit<DropdownMenuItemIndicatorProps, "ref"> & React.RefAttributes<HTMLSpanElement>>;

package/dist/dropdown-menu/DropdownMenuLabel.d.cts

@@ -0,0 +1,13 @@
+import * as React from 'react';
+import type { DropdownMenuLabelProps } from './types.cjs';
+/**
+ * Non-interactive heading for a group of items, typically preceding a
+ * `DropdownMenuGroup`. Renders a plain `<div>`.
+ *
+ * @example
+ * ```tsx
+ * <DropdownMenuLabel>Actions</DropdownMenuLabel>
+ * <DropdownMenuItem>Edit</DropdownMenuItem>
+ * ```
+ */
+export declare const DropdownMenuLabel: React.ForwardRefExoticComponent<Omit<DropdownMenuLabelProps, "ref"> & React.RefAttributes<HTMLDivElement>>;

package/dist/dropdown-menu/DropdownMenuLabel.d.ts

@@ -0,0 +1,13 @@
+import * as React from 'react';
+import type { DropdownMenuLabelProps } from './types.js';
+/**
+ * Non-interactive heading for a group of items, typically preceding a
+ * `DropdownMenuGroup`. Renders a plain `<div>`.
+ *
+ * @example
+ * ```tsx
+ * <DropdownMenuLabel>Actions</DropdownMenuLabel>
+ * <DropdownMenuItem>Edit</DropdownMenuItem>
+ * ```
+ */
+export declare const DropdownMenuLabel: React.ForwardRefExoticComponent<Omit<DropdownMenuLabelProps, "ref"> & React.RefAttributes<HTMLDivElement>>;

package/dist/dropdown-menu/DropdownMenuPortal.d.cts

@@ -0,0 +1,20 @@
+import type { DropdownMenuPortalProps } from './types.cjs';
+/**
+ * Teleports `DropdownMenuContent` to `document.body` (or a custom
+ * `container`), so the menu escapes any clipping/`overflow` ancestors.
+ * Mounts only while open unless `forceMount` is set.
+ *
+ * @example
+ * ```tsx
+ * <DropdownMenu>
+ *   <DropdownMenuTrigger>Options</DropdownMenuTrigger>
+ *   <DropdownMenuPortal>
+ *     <DropdownMenuContent>…</DropdownMenuContent>
+ *   </DropdownMenuPortal>
+ * </DropdownMenu>
+ * ```
+ */
+export declare const DropdownMenuPortal: {
+    ({ forceMount, children, ...props }: DropdownMenuPortalProps): import("react").JSX.Element | null;
+    displayName: string;
+};

package/dist/dropdown-menu/DropdownMenuPortal.d.ts

@@ -0,0 +1,20 @@
+import type { DropdownMenuPortalProps } from './types.js';
+/**
+ * Teleports `DropdownMenuContent` to `document.body` (or a custom
+ * `container`), so the menu escapes any clipping/`overflow` ancestors.
+ * Mounts only while open unless `forceMount` is set.
+ *
+ * @example
+ * ```tsx
+ * <DropdownMenu>
+ *   <DropdownMenuTrigger>Options</DropdownMenuTrigger>
+ *   <DropdownMenuPortal>
+ *     <DropdownMenuContent>…</DropdownMenuContent>
+ *   </DropdownMenuPortal>
+ * </DropdownMenu>
+ * ```
+ */
+export declare const DropdownMenuPortal: {
+    ({ forceMount, children, ...props }: DropdownMenuPortalProps): import("react").JSX.Element | null;
+    displayName: string;
+};

package/dist/dropdown-menu/DropdownMenuRadioGroup.d.cts

@@ -0,0 +1,22 @@
+import * as React from 'react';
+import type { DropdownMenuRadioGroupProps, MenuRadioGroupContextValue } from './types.cjs';
+export declare const MenuRadioGroupProvider: {
+    (props: MenuRadioGroupContextValue & {
+        children: React.ReactNode;
+    }): React.JSX.Element;
+    displayName: string;
+}, useMenuRadioGroupContext: (consumerName: string) => MenuRadioGroupContextValue;
+/**
+ * Container coordinating a set of mutually-exclusive `DropdownMenuRadioItem`s:
+ * renders a `<div role="group">` and distributes the selected `value` /
+ * `onValueChange` to its items via context.
+ *
+ * @example
+ * ```tsx
+ * <DropdownMenuRadioGroup value={sort} onValueChange={setSort}>
+ *   <DropdownMenuRadioItem value="asc">Ascending</DropdownMenuRadioItem>
+ *   <DropdownMenuRadioItem value="desc">Descending</DropdownMenuRadioItem>
+ * </DropdownMenuRadioGroup>
+ * ```
+ */
+export declare const DropdownMenuRadioGroup: React.ForwardRefExoticComponent<Omit<DropdownMenuRadioGroupProps, "ref"> & React.RefAttributes<HTMLDivElement>>;

package/dist/dropdown-menu/DropdownMenuRadioGroup.d.ts

@@ -0,0 +1,22 @@
+import * as React from 'react';
+import type { DropdownMenuRadioGroupProps, MenuRadioGroupContextValue } from './types.js';
+export declare const MenuRadioGroupProvider: {
+    (props: MenuRadioGroupContextValue & {
+        children: React.ReactNode;
+    }): React.JSX.Element;
+    displayName: string;
+}, useMenuRadioGroupContext: (consumerName: string) => MenuRadioGroupContextValue;
+/**
+ * Container coordinating a set of mutually-exclusive `DropdownMenuRadioItem`s:
+ * renders a `<div role="group">` and distributes the selected `value` /
+ * `onValueChange` to its items via context.
+ *
+ * @example
+ * ```tsx
+ * <DropdownMenuRadioGroup value={sort} onValueChange={setSort}>
+ *   <DropdownMenuRadioItem value="asc">Ascending</DropdownMenuRadioItem>
+ *   <DropdownMenuRadioItem value="desc">Descending</DropdownMenuRadioItem>
+ * </DropdownMenuRadioGroup>
+ * ```
+ */
+export declare const DropdownMenuRadioGroup: React.ForwardRefExoticComponent<Omit<DropdownMenuRadioGroupProps, "ref"> & React.RefAttributes<HTMLDivElement>>;

package/dist/dropdown-menu/DropdownMenuRadioItem.d.cts

@@ -0,0 +1,19 @@
+import * as React from 'react';
+import type { DropdownMenuRadioItemProps } from './types.cjs';
+/**
+ * A single option within a `DropdownMenuRadioGroup`: `role="menuitemradio"`
+ * with `aria-checked` and `data-state` (`checked`/`unchecked`) reflecting
+ * whether its `value` matches the group's selected value. Selecting it
+ * updates the group via `onValueChange` and closes the menu. Wrap a
+ * `DropdownMenuItemIndicator` inside it to render a dot/check glyph only
+ * when selected.
+ *
+ * @example
+ * ```tsx
+ * <DropdownMenuRadioItem value="asc">
+ *   <DropdownMenuItemIndicator>•</DropdownMenuItemIndicator>
+ *   Ascending
+ * </DropdownMenuRadioItem>
+ * ```
+ */
+export declare const DropdownMenuRadioItem: React.ForwardRefExoticComponent<Omit<DropdownMenuRadioItemProps, "ref"> & React.RefAttributes<HTMLDivElement>>;

package/dist/dropdown-menu/DropdownMenuRadioItem.d.ts

@@ -0,0 +1,19 @@
+import * as React from 'react';
+import type { DropdownMenuRadioItemProps } from './types.js';
+/**
+ * A single option within a `DropdownMenuRadioGroup`: `role="menuitemradio"`
+ * with `aria-checked` and `data-state` (`checked`/`unchecked`) reflecting
+ * whether its `value` matches the group's selected value. Selecting it
+ * updates the group via `onValueChange` and closes the menu. Wrap a
+ * `DropdownMenuItemIndicator` inside it to render a dot/check glyph only
+ * when selected.
+ *
+ * @example
+ * ```tsx
+ * <DropdownMenuRadioItem value="asc">
+ *   <DropdownMenuItemIndicator>•</DropdownMenuItemIndicator>
+ *   Ascending
+ * </DropdownMenuRadioItem>
+ * ```
+ */
+export declare const DropdownMenuRadioItem: React.ForwardRefExoticComponent<Omit<DropdownMenuRadioItemProps, "ref"> & React.RefAttributes<HTMLDivElement>>;

package/dist/dropdown-menu/DropdownMenuSeparator.d.cts

@@ -0,0 +1,14 @@
+import * as React from 'react';
+import type { DropdownMenuSeparatorProps } from './types.cjs';
+/**
+ * Visual divider between items or groups: renders a
+ * `<div role="separator" aria-orientation="horizontal">`.
+ *
+ * @example
+ * ```tsx
+ * <DropdownMenuItem>Edit</DropdownMenuItem>
+ * <DropdownMenuSeparator />
+ * <DropdownMenuItem>Delete</DropdownMenuItem>
+ * ```
+ */
+export declare const DropdownMenuSeparator: React.ForwardRefExoticComponent<Omit<DropdownMenuSeparatorProps, "ref"> & React.RefAttributes<HTMLDivElement>>;

package/dist/dropdown-menu/DropdownMenuSeparator.d.ts

@@ -0,0 +1,14 @@
+import * as React from 'react';
+import type { DropdownMenuSeparatorProps } from './types.js';
+/**
+ * Visual divider between items or groups: renders a
+ * `<div role="separator" aria-orientation="horizontal">`.
+ *
+ * @example
+ * ```tsx
+ * <DropdownMenuItem>Edit</DropdownMenuItem>
+ * <DropdownMenuSeparator />
+ * <DropdownMenuItem>Delete</DropdownMenuItem>
+ * ```
+ */
+export declare const DropdownMenuSeparator: React.ForwardRefExoticComponent<Omit<DropdownMenuSeparatorProps, "ref"> & React.RefAttributes<HTMLDivElement>>;

package/dist/dropdown-menu/DropdownMenuSub.d.cts

@@ -0,0 +1,40 @@
+import { type MenuSubProps } from '../utils/menuSub.cjs';
+/**
+ * Root of a nested submenu inside `DropdownMenuContent`: owns the submenu's
+ * own open state and provides the popper anchor context its
+ * `DropdownMenuSubTrigger` / `DropdownMenuSubContent` position against.
+ * Renders no DOM element itself.
+ *
+ * @example
+ * ```tsx
+ * <DropdownMenuContent>
+ *   <DropdownMenuItem>Edit</DropdownMenuItem>
+ *   <DropdownMenuSub>
+ *     <DropdownMenuSubTrigger>Share</DropdownMenuSubTrigger>
+ *     <DropdownMenuSubContent>
+ *       <DropdownMenuItem>Email</DropdownMenuItem>
+ *       <DropdownMenuItem>Copy link</DropdownMenuItem>
+ *     </DropdownMenuSubContent>
+ *   </DropdownMenuSub>
+ * </DropdownMenuContent>
+ * ```
+ */
+export declare function DropdownMenuSub(props: Omit<MenuSubProps, 'family'>): import("react").JSX.Element;
+export declare namespace DropdownMenuSub {
+    var displayName: string;
+}
+/**
+ * The parent-menu item that opens a submenu: `role="menuitem"` with
+ * `aria-haspopup="menu"`, `aria-expanded`, `aria-controls` and `data-state`.
+ * Opens on click, Enter, Space or ArrowRight — moving focus to the submenu's
+ * first item — and on hover, which leaves focus where it is.
+ */
+export declare const DropdownMenuSubTrigger: import("react").ForwardRefExoticComponent<Omit<import("../utils/menuSub.cjs").MenuSubTriggerProps, "ref"> & import("react").RefAttributes<HTMLDivElement>>;
+/**
+ * The submenu's floating panel: `role="menu"`, positioned against
+ * `DropdownMenuSubTrigger` (`side="end"`, `align="start"` by default) via
+ * the same popper layer as `DropdownMenuContent`. Owns its own vertical
+ * roving focus and typeahead; ArrowLeft and Escape close it and refocus the
+ * trigger, leaving the parent menu open.
+ */
+export declare const DropdownMenuSubContent: import("react").ForwardRefExoticComponent<Omit<import("../utils/menuSub.cjs").MenuSubContentProps, "ref"> & import("react").RefAttributes<HTMLDivElement>>;