@alneas/appkit-react 0.1.0 → 0.3.0

package/dist/ui/components/ui/dropdown-menu.d.ts

@@ -1,43 +1,295 @@
 import { Menu as MenuPrimitive } from '@base-ui/react/menu';
 import * as React from 'react';
 /**
- * ドロップダウンメニューのルートコンポーネント。
+ * Coordinates popup menu state and focus behavior.
+ * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling.
+ * @returns The rendered DropdownMenu composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Items and popup parts require the matching DropdownMenu root. Put labels inside a Group and RadioItems inside RadioGroup. SubTrigger/SubContent require Sub under the parent menu. Content supplies its portal/positioner. inset adds left spacing when truthy; item variant defaults to default. Shortcut is presentational. Custom render composition follows Base UI; there is no asChild adapter.
+ * @example
+ * ```tsx
+ * import { DropdownMenu, DropdownMenuTrigger, DropdownMenuContent, DropdownMenuItem, DropdownMenuGroup, DropdownMenuLabel, DropdownMenuSeparator } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<DropdownMenu><DropdownMenuTrigger>Actions</DropdownMenuTrigger><DropdownMenuContent><DropdownMenuGroup><DropdownMenuLabel>Document</DropdownMenuLabel><DropdownMenuItem onClick={() => console.log("Open requested")}>Open</DropdownMenuItem></DropdownMenuGroup><DropdownMenuSeparator /><DropdownMenuItem disabled>Unavailable</DropdownMenuItem></DropdownMenuContent></DropdownMenu>);
+ * }
+ * ```
  */
 declare function DropdownMenu({ ...props }: MenuPrimitive.Root.Props): React.JSX.Element;
 /**
- * メニュー要素をポータル経由でDOMの別の場所に描画するためのコンポーネント。
+ * Mounts menu descendants in a separate DOM container.
+ * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling.
+ * @returns The rendered DropdownMenuPortal composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Items and popup parts require the matching DropdownMenu root. Put labels inside a Group and RadioItems inside RadioGroup. SubTrigger/SubContent require Sub under the parent menu. Content supplies its portal/positioner. inset adds left spacing when truthy; item variant defaults to default. Shortcut is presentational. Custom render composition follows Base UI; there is no asChild adapter.
+ * @example
+ * ```tsx
+ * import { DropdownMenu, DropdownMenuTrigger, DropdownMenuContent, DropdownMenuItem, DropdownMenuGroup, DropdownMenuLabel, DropdownMenuSeparator } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<DropdownMenu><DropdownMenuTrigger>Actions</DropdownMenuTrigger><DropdownMenuContent><DropdownMenuGroup><DropdownMenuLabel>Document</DropdownMenuLabel><DropdownMenuItem onClick={() => console.log("Open requested")}>Open</DropdownMenuItem></DropdownMenuGroup><DropdownMenuSeparator /><DropdownMenuItem disabled>Unavailable</DropdownMenuItem></DropdownMenuContent></DropdownMenu>);
+ * }
+ * ```
  */
 declare function DropdownMenuPortal({ ...props }: MenuPrimitive.Portal.Props): React.JSX.Element;
 /**
- * ドロップダウンメニューを開くためのトリガーボタン。
+ * Renders the control or context target that opens a menu.
+ * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling.
+ * @returns The rendered DropdownMenuTrigger composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Items and popup parts require the matching DropdownMenu root. Put labels inside a Group and RadioItems inside RadioGroup. SubTrigger/SubContent require Sub under the parent menu. Content supplies its portal/positioner. inset adds left spacing when truthy; item variant defaults to default. Shortcut is presentational. Custom render composition follows Base UI; there is no asChild adapter.
+ * @example
+ * ```tsx
+ * import { DropdownMenu, DropdownMenuTrigger, DropdownMenuContent, DropdownMenuItem, DropdownMenuGroup, DropdownMenuLabel, DropdownMenuSeparator } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<DropdownMenu><DropdownMenuTrigger>Actions</DropdownMenuTrigger><DropdownMenuContent><DropdownMenuGroup><DropdownMenuLabel>Document</DropdownMenuLabel><DropdownMenuItem onClick={() => console.log("Open requested")}>Open</DropdownMenuItem></DropdownMenuGroup><DropdownMenuSeparator /><DropdownMenuItem disabled>Unavailable</DropdownMenuItem></DropdownMenuContent></DropdownMenu>);
+ * }
+ * ```
  */
 declare function DropdownMenuTrigger({ children, ...props }: MenuPrimitive.Trigger.Props): React.JSX.Element;
-declare const DropdownMenuContent: React.ForwardRefExoticComponent<Omit<import('@base-ui/react').ContextMenuPopupProps & Pick<import('@base-ui/react').MenuPositionerProps, "side" | "align" | "sideOffset" | "alignOffset">, "ref"> & React.RefAttributes<HTMLDivElement>>;
 /**
- * メニューアイテムを論理的なグループにまとめるためのコンポーネント。
+ * Portals the menu popup through its positioned container.
+ * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling. Wrapper defaults: align='start', alignOffset=0, side='bottom', sideOffset=4.
+ * @returns The rendered DropdownMenuContent composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Items and popup parts require the matching DropdownMenu root. Put labels inside a Group and RadioItems inside RadioGroup. SubTrigger/SubContent require Sub under the parent menu. Content supplies its portal/positioner. inset adds left spacing when truthy; item variant defaults to default. Shortcut is presentational. Custom render composition follows Base UI; there is no asChild adapter. The ref prop forwards to the rendered control or container declared by the component ref type.
+ * @example
+ * ```tsx
+ * import { DropdownMenu, DropdownMenuTrigger, DropdownMenuContent, DropdownMenuItem, DropdownMenuGroup, DropdownMenuLabel, DropdownMenuSeparator } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<DropdownMenu><DropdownMenuTrigger>Actions</DropdownMenuTrigger><DropdownMenuContent><DropdownMenuGroup><DropdownMenuLabel>Document</DropdownMenuLabel><DropdownMenuItem onClick={() => console.log("Open requested")}>Open</DropdownMenuItem></DropdownMenuGroup><DropdownMenuSeparator /><DropdownMenuItem disabled>Unavailable</DropdownMenuItem></DropdownMenuContent></DropdownMenu>);
+ * }
+ * ```
+ */
+declare function DropdownMenuContent({ ref, className, align, alignOffset, side, sideOffset, ...props }: React.PropsWithoutRef<MenuPrimitive.Popup.Props & Pick<MenuPrimitive.Positioner.Props, 'align' | 'alignOffset' | 'side' | 'sideOffset'>> & React.RefAttributes<HTMLDivElement>): React.JSX.Element;
+declare namespace DropdownMenuContent {
+    var displayName: string | undefined;
+}
+/**
+ * Groups related menu actions.
+ * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling.
+ * @returns The rendered DropdownMenuGroup composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Items and popup parts require the matching DropdownMenu root. Put labels inside a Group and RadioItems inside RadioGroup. SubTrigger/SubContent require Sub under the parent menu. Content supplies its portal/positioner. inset adds left spacing when truthy; item variant defaults to default. Shortcut is presentational. Custom render composition follows Base UI; there is no asChild adapter.
+ * @example
+ * ```tsx
+ * import { DropdownMenu, DropdownMenuTrigger, DropdownMenuContent, DropdownMenuItem, DropdownMenuGroup, DropdownMenuLabel, DropdownMenuSeparator } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<DropdownMenu><DropdownMenuTrigger>Actions</DropdownMenuTrigger><DropdownMenuContent><DropdownMenuGroup><DropdownMenuLabel>Document</DropdownMenuLabel><DropdownMenuItem onClick={() => console.log("Open requested")}>Open</DropdownMenuItem></DropdownMenuGroup><DropdownMenuSeparator /><DropdownMenuItem disabled>Unavailable</DropdownMenuItem></DropdownMenuContent></DropdownMenu>);
+ * }
+ * ```
  */
 declare function DropdownMenuGroup({ ...props }: MenuPrimitive.Group.Props): React.JSX.Element;
-declare const DropdownMenuLabel: React.ForwardRefExoticComponent<Omit<import('@base-ui/react').ContextMenuGroupLabelProps & {
+/**
+ * Renders the accessible label of a menu group with optional inset spacing.
+ * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling.
+ * @returns The rendered DropdownMenuLabel composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Items and popup parts require the matching DropdownMenu root. Put labels inside a Group and RadioItems inside RadioGroup. SubTrigger/SubContent require Sub under the parent menu. Content supplies its portal/positioner. inset adds left spacing when truthy; item variant defaults to default. Shortcut is presentational. Custom render composition follows Base UI; there is no asChild adapter. The ref prop forwards to the rendered control or container declared by the component ref type.
+ * @example
+ * ```tsx
+ * import { DropdownMenu, DropdownMenuTrigger, DropdownMenuContent, DropdownMenuItem, DropdownMenuGroup, DropdownMenuLabel, DropdownMenuSeparator } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<DropdownMenu><DropdownMenuTrigger>Actions</DropdownMenuTrigger><DropdownMenuContent><DropdownMenuGroup><DropdownMenuLabel>Document</DropdownMenuLabel><DropdownMenuItem onClick={() => console.log("Open requested")}>Open</DropdownMenuItem></DropdownMenuGroup><DropdownMenuSeparator /><DropdownMenuItem disabled>Unavailable</DropdownMenuItem></DropdownMenuContent></DropdownMenu>);
+ * }
+ * ```
+ */
+declare function DropdownMenuLabel({ ref, className, inset, ...props }: React.PropsWithoutRef<MenuPrimitive.GroupLabel.Props & {
+    /**
+     * Adds left inset spacing when true; omitted/false uses normal alignment.
+     */
+    /**
+     * Adds left inset spacing when true; omitted/false uses normal alignment.
+     */
     inset?: boolean;
-}, "ref"> & React.RefAttributes<HTMLDivElement>>;
-declare const DropdownMenuItem: React.ForwardRefExoticComponent<Omit<import('@base-ui/react').ContextMenuItemProps & {
+}> & React.RefAttributes<HTMLDivElement>): React.JSX.Element;
+declare namespace DropdownMenuLabel {
+    var displayName: string | undefined;
+}
+/**
+ * Renders a menu action with optional destructive styling and inset spacing.
+ * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling. Wrapper defaults: variant='default'.
+ * @returns The rendered DropdownMenuItem composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Items and popup parts require the matching DropdownMenu root. Put labels inside a Group and RadioItems inside RadioGroup. SubTrigger/SubContent require Sub under the parent menu. Content supplies its portal/positioner. inset adds left spacing when truthy; item variant defaults to default. Shortcut is presentational. Custom render composition follows Base UI; there is no asChild adapter. The ref prop forwards to the rendered control or container declared by the component ref type.
+ * @example
+ * ```tsx
+ * import { DropdownMenu, DropdownMenuTrigger, DropdownMenuContent, DropdownMenuItem, DropdownMenuGroup, DropdownMenuLabel, DropdownMenuSeparator } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<DropdownMenu><DropdownMenuTrigger>Actions</DropdownMenuTrigger><DropdownMenuContent><DropdownMenuGroup><DropdownMenuLabel>Document</DropdownMenuLabel><DropdownMenuItem onClick={() => console.log("Open requested")}>Open</DropdownMenuItem></DropdownMenuGroup><DropdownMenuSeparator /><DropdownMenuItem disabled>Unavailable</DropdownMenuItem></DropdownMenuContent></DropdownMenu>);
+ * }
+ * ```
+ */
+declare function DropdownMenuItem({ ref, className, inset, variant, children, ...props }: React.PropsWithoutRef<MenuPrimitive.Item.Props & {
+    /**
+     * Adds left inset spacing when true; omitted/false uses normal alignment.
+     */
     inset?: boolean;
-    variant?: "default" | "destructive";
-}, "ref"> & React.RefAttributes<HTMLDivElement>>;
+    /**
+     * Visual treatment from the declared variant union; changing it does not alter host action semantics.
+     */
+    variant?: 'default' | 'destructive';
+}> & React.RefAttributes<HTMLDivElement>): React.JSX.Element;
+declare namespace DropdownMenuItem {
+    var displayName: string | undefined;
+}
 /**
- * サブメニュー（入れ子になったメニュー）用のルートコンポーネント。
+ * Coordinates a submenu nested inside a parent menu.
+ * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling.
+ * @returns The rendered DropdownMenuSub composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Items and popup parts require the matching DropdownMenu root. Put labels inside a Group and RadioItems inside RadioGroup. SubTrigger/SubContent require Sub under the parent menu. Content supplies its portal/positioner. inset adds left spacing when truthy; item variant defaults to default. Shortcut is presentational. Custom render composition follows Base UI; there is no asChild adapter.
+ * @example
+ * ```tsx
+ * import { DropdownMenu, DropdownMenuTrigger, DropdownMenuContent, DropdownMenuItem, DropdownMenuGroup, DropdownMenuLabel, DropdownMenuSeparator } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<DropdownMenu><DropdownMenuTrigger>Actions</DropdownMenuTrigger><DropdownMenuContent><DropdownMenuGroup><DropdownMenuLabel>Document</DropdownMenuLabel><DropdownMenuItem onClick={() => console.log("Open requested")}>Open</DropdownMenuItem></DropdownMenuGroup><DropdownMenuSeparator /><DropdownMenuItem disabled>Unavailable</DropdownMenuItem></DropdownMenuContent></DropdownMenu>);
+ * }
+ * ```
  */
 declare function DropdownMenuSub({ ...props }: MenuPrimitive.SubmenuRoot.Props): React.JSX.Element;
-declare const DropdownMenuSubTrigger: React.ForwardRefExoticComponent<Omit<import('@base-ui/react').ContextMenuSubmenuTriggerProps & {
+/**
+ * Renders a submenu opener with a trailing chevron.
+ * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling.
+ * @returns The rendered DropdownMenuSubTrigger composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Items and popup parts require the matching DropdownMenu root. Put labels inside a Group and RadioItems inside RadioGroup. SubTrigger/SubContent require Sub under the parent menu. Content supplies its portal/positioner. inset adds left spacing when truthy; item variant defaults to default. Shortcut is presentational. Custom render composition follows Base UI; there is no asChild adapter. The ref prop forwards to the rendered control or container declared by the component ref type.
+ * @example
+ * ```tsx
+ * import { DropdownMenu, DropdownMenuTrigger, DropdownMenuContent, DropdownMenuItem, DropdownMenuGroup, DropdownMenuLabel, DropdownMenuSeparator } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<DropdownMenu><DropdownMenuTrigger>Actions</DropdownMenuTrigger><DropdownMenuContent><DropdownMenuGroup><DropdownMenuLabel>Document</DropdownMenuLabel><DropdownMenuItem onClick={() => console.log("Open requested")}>Open</DropdownMenuItem></DropdownMenuGroup><DropdownMenuSeparator /><DropdownMenuItem disabled>Unavailable</DropdownMenuItem></DropdownMenuContent></DropdownMenu>);
+ * }
+ * ```
+ */
+declare function DropdownMenuSubTrigger({ ref, className, inset, children, ...props }: React.PropsWithoutRef<MenuPrimitive.SubmenuTrigger.Props & {
+    /**
+     * Adds left inset spacing when true; omitted/false uses normal alignment.
+     */
+    /**
+     * Adds left inset spacing when true; omitted/false uses normal alignment.
+     */
     inset?: boolean;
-}, "ref"> & React.RefAttributes<HTMLDivElement>>;
-declare const DropdownMenuSubContent: React.ForwardRefExoticComponent<Omit<Omit<import('@base-ui/react').ContextMenuPopupProps & Pick<import('@base-ui/react').MenuPositionerProps, "side" | "align" | "sideOffset" | "alignOffset">, "ref"> & React.RefAttributes<HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
-declare const DropdownMenuCheckboxItem: React.ForwardRefExoticComponent<Omit<import('@base-ui/react').ContextMenuCheckboxItemProps, "ref"> & React.RefAttributes<HTMLDivElement>>;
+}> & React.RefAttributes<HTMLDivElement>): React.JSX.Element;
+declare namespace DropdownMenuSubTrigger {
+    var displayName: string | undefined;
+}
+/**
+ * Renders a positioned submenu popup.
+ * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling. Wrapper defaults: align='start', alignOffset=-3, side='right', sideOffset=0.
+ * @returns The rendered DropdownMenuSubContent composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Items and popup parts require the matching DropdownMenu root. Put labels inside a Group and RadioItems inside RadioGroup. SubTrigger/SubContent require Sub under the parent menu. Content supplies its portal/positioner. inset adds left spacing when truthy; item variant defaults to default. Shortcut is presentational. Custom render composition follows Base UI; there is no asChild adapter. The ref prop forwards to the rendered control or container declared by the component ref type.
+ * @example
+ * ```tsx
+ * import { DropdownMenu, DropdownMenuTrigger, DropdownMenuContent, DropdownMenuItem, DropdownMenuGroup, DropdownMenuLabel, DropdownMenuSeparator } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<DropdownMenu><DropdownMenuTrigger>Actions</DropdownMenuTrigger><DropdownMenuContent><DropdownMenuGroup><DropdownMenuLabel>Document</DropdownMenuLabel><DropdownMenuItem onClick={() => console.log("Open requested")}>Open</DropdownMenuItem></DropdownMenuGroup><DropdownMenuSeparator /><DropdownMenuItem disabled>Unavailable</DropdownMenuItem></DropdownMenuContent></DropdownMenu>);
+ * }
+ * ```
+ */
+declare function DropdownMenuSubContent({ ref, className, align, alignOffset, side, sideOffset, ...props }: React.PropsWithoutRef<React.ComponentPropsWithoutRef<typeof DropdownMenuContent>> & React.RefAttributes<HTMLDivElement>): React.JSX.Element;
+declare namespace DropdownMenuSubContent {
+    var displayName: string;
+}
+/**
+ * Renders a checked menu action with a checkmark indicator.
+ * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling.
+ * @returns The rendered DropdownMenuCheckboxItem composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Items and popup parts require the matching DropdownMenu root. Put labels inside a Group and RadioItems inside RadioGroup. SubTrigger/SubContent require Sub under the parent menu. Content supplies its portal/positioner. inset adds left spacing when truthy; item variant defaults to default. Shortcut is presentational. Custom render composition follows Base UI; there is no asChild adapter. The ref prop forwards to the rendered control or container declared by the component ref type.
+ * @example
+ * ```tsx
+ * import { DropdownMenu, DropdownMenuTrigger, DropdownMenuContent, DropdownMenuItem, DropdownMenuGroup, DropdownMenuLabel, DropdownMenuSeparator } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<DropdownMenu><DropdownMenuTrigger>Actions</DropdownMenuTrigger><DropdownMenuContent><DropdownMenuGroup><DropdownMenuLabel>Document</DropdownMenuLabel><DropdownMenuItem onClick={() => console.log("Open requested")}>Open</DropdownMenuItem></DropdownMenuGroup><DropdownMenuSeparator /><DropdownMenuItem disabled>Unavailable</DropdownMenuItem></DropdownMenuContent></DropdownMenu>);
+ * }
+ * ```
+ */
+declare function DropdownMenuCheckboxItem({ ref, className, children, checked, ...props }: React.PropsWithoutRef<MenuPrimitive.CheckboxItem.Props> & React.RefAttributes<HTMLDivElement>): React.JSX.Element;
+declare namespace DropdownMenuCheckboxItem {
+    var displayName: string | undefined;
+}
 /**
- * 選択状態を共有し、単一選択（ラジオ）可能なアイテムをグループ化するコンポーネント。
+ * Coordinates mutually exclusive menu choices.
+ * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling.
+ * @returns The rendered DropdownMenuRadioGroup composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Items and popup parts require the matching DropdownMenu root. Put labels inside a Group and RadioItems inside RadioGroup. SubTrigger/SubContent require Sub under the parent menu. Content supplies its portal/positioner. inset adds left spacing when truthy; item variant defaults to default. Shortcut is presentational. Custom render composition follows Base UI; there is no asChild adapter.
+ * @example
+ * ```tsx
+ * import { DropdownMenu, DropdownMenuTrigger, DropdownMenuContent, DropdownMenuItem, DropdownMenuGroup, DropdownMenuLabel, DropdownMenuSeparator } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<DropdownMenu><DropdownMenuTrigger>Actions</DropdownMenuTrigger><DropdownMenuContent><DropdownMenuGroup><DropdownMenuLabel>Document</DropdownMenuLabel><DropdownMenuItem onClick={() => console.log("Open requested")}>Open</DropdownMenuItem></DropdownMenuGroup><DropdownMenuSeparator /><DropdownMenuItem disabled>Unavailable</DropdownMenuItem></DropdownMenuContent></DropdownMenu>);
+ * }
+ * ```
  */
 declare function DropdownMenuRadioGroup({ ...props }: MenuPrimitive.RadioGroup.Props): React.JSX.Element;
-declare const DropdownMenuRadioItem: React.ForwardRefExoticComponent<Omit<import('@base-ui/react').ContextMenuRadioItemProps, "ref"> & React.RefAttributes<HTMLDivElement>>;
-declare const DropdownMenuSeparator: React.ForwardRefExoticComponent<Omit<import('@base-ui/react').SeparatorProps, "ref"> & React.RefAttributes<HTMLDivElement>>;
-declare const DropdownMenuShortcut: React.ForwardRefExoticComponent<Omit<React.DetailedHTMLProps<React.HTMLAttributes<HTMLSpanElement>, HTMLSpanElement>, "ref"> & React.RefAttributes<HTMLSpanElement>>;
+/**
+ * Renders one value in a menu radio group.
+ * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling.
+ * @returns The rendered DropdownMenuRadioItem composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Items and popup parts require the matching DropdownMenu root. Put labels inside a Group and RadioItems inside RadioGroup. SubTrigger/SubContent require Sub under the parent menu. Content supplies its portal/positioner. inset adds left spacing when truthy; item variant defaults to default. Shortcut is presentational. Custom render composition follows Base UI; there is no asChild adapter. The ref prop forwards to the rendered control or container declared by the component ref type.
+ * @example
+ * ```tsx
+ * import { DropdownMenu, DropdownMenuTrigger, DropdownMenuContent, DropdownMenuItem, DropdownMenuGroup, DropdownMenuLabel, DropdownMenuSeparator } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<DropdownMenu><DropdownMenuTrigger>Actions</DropdownMenuTrigger><DropdownMenuContent><DropdownMenuGroup><DropdownMenuLabel>Document</DropdownMenuLabel><DropdownMenuItem onClick={() => console.log("Open requested")}>Open</DropdownMenuItem></DropdownMenuGroup><DropdownMenuSeparator /><DropdownMenuItem disabled>Unavailable</DropdownMenuItem></DropdownMenuContent></DropdownMenu>);
+ * }
+ * ```
+ */
+declare function DropdownMenuRadioItem({ ref, className, children, ...props }: React.PropsWithoutRef<MenuPrimitive.RadioItem.Props> & React.RefAttributes<HTMLDivElement>): React.JSX.Element;
+declare namespace DropdownMenuRadioItem {
+    var displayName: string | undefined;
+}
+/**
+ * Draws a divider between menu sections.
+ * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling.
+ * @returns The rendered DropdownMenuSeparator composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Items and popup parts require the matching DropdownMenu root. Put labels inside a Group and RadioItems inside RadioGroup. SubTrigger/SubContent require Sub under the parent menu. Content supplies its portal/positioner. inset adds left spacing when truthy; item variant defaults to default. Shortcut is presentational. Custom render composition follows Base UI; there is no asChild adapter. The ref prop forwards to the rendered control or container declared by the component ref type.
+ * @example
+ * ```tsx
+ * import { DropdownMenu, DropdownMenuTrigger, DropdownMenuContent, DropdownMenuItem, DropdownMenuGroup, DropdownMenuLabel, DropdownMenuSeparator } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<DropdownMenu><DropdownMenuTrigger>Actions</DropdownMenuTrigger><DropdownMenuContent><DropdownMenuGroup><DropdownMenuLabel>Document</DropdownMenuLabel><DropdownMenuItem onClick={() => console.log("Open requested")}>Open</DropdownMenuItem></DropdownMenuGroup><DropdownMenuSeparator /><DropdownMenuItem disabled>Unavailable</DropdownMenuItem></DropdownMenuContent></DropdownMenu>);
+ * }
+ * ```
+ */
+declare function DropdownMenuSeparator({ ref, className, ...props }: React.PropsWithoutRef<MenuPrimitive.Separator.Props> & React.RefAttributes<HTMLDivElement>): React.JSX.Element;
+declare namespace DropdownMenuSeparator {
+    var displayName: string | undefined;
+}
+/**
+ * Styles a shortcut hint without installing keyboard listeners.
+ * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling.
+ * @returns The rendered DropdownMenuShortcut composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Items and popup parts require the matching DropdownMenu root. Put labels inside a Group and RadioItems inside RadioGroup. SubTrigger/SubContent require Sub under the parent menu. Content supplies its portal/positioner. inset adds left spacing when truthy; item variant defaults to default. Shortcut is presentational. Custom render composition follows Base UI; there is no asChild adapter. The ref prop forwards to the rendered control or container declared by the component ref type.
+ * @example
+ * ```tsx
+ * import { DropdownMenu, DropdownMenuTrigger, DropdownMenuContent, DropdownMenuItem, DropdownMenuGroup, DropdownMenuLabel, DropdownMenuSeparator } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<DropdownMenu><DropdownMenuTrigger>Actions</DropdownMenuTrigger><DropdownMenuContent><DropdownMenuGroup><DropdownMenuLabel>Document</DropdownMenuLabel><DropdownMenuItem onClick={() => console.log("Open requested")}>Open</DropdownMenuItem></DropdownMenuGroup><DropdownMenuSeparator /><DropdownMenuItem disabled>Unavailable</DropdownMenuItem></DropdownMenuContent></DropdownMenu>);
+ * }
+ * ```
+ */
+declare function DropdownMenuShortcut({ ref, className, ...props }: React.PropsWithoutRef<React.ComponentProps<'span'>> & React.RefAttributes<HTMLSpanElement>): React.JSX.Element;
+declare namespace DropdownMenuShortcut {
+    var displayName: string;
+}
 export { DropdownMenu, DropdownMenuPortal, DropdownMenuTrigger, DropdownMenuContent, DropdownMenuGroup, DropdownMenuLabel, DropdownMenuItem, DropdownMenuCheckboxItem, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubTrigger, DropdownMenuSubContent, };

package/dist/ui/components/ui/dropdown-menu.js

@@ -2,139 +2,157 @@
 "use client";
 import { cn as e } from "../../lib/utils.js";
 import { jsx as t, jsxs as n } from "react/jsx-runtime";
-import * as r from "react";
-import { CheckIcon as i, ChevronRightIcon as a } from "lucide-react";
-import { Menu as o } from "@base-ui/react/menu";
+import "react";
+import { CheckIcon as r, ChevronRightIcon as i } from "lucide-react";
+import { Menu as a } from "@base-ui/react/menu";
 //#region src/ui/components/ui/dropdown-menu.tsx
-function s({ ...e }) {
-	return /* @__PURE__ */ t(o.Root, {
+function o({ ...e }) {
+	return /* @__PURE__ */ t(a.Root, {
 		"data-slot": "dropdown-menu",
 		...e
 	});
 }
-function c({ ...e }) {
-	return /* @__PURE__ */ t(o.Portal, {
+function s({ ...e }) {
+	return /* @__PURE__ */ t(a.Portal, {
 		"data-slot": "dropdown-menu-portal",
 		...e
 	});
 }
-function l({ children: e, ...n }) {
-	return /* @__PURE__ */ t(o.Trigger, {
+function c({ children: e, ...n }) {
+	return /* @__PURE__ */ t(a.Trigger, {
 		"data-slot": "dropdown-menu-trigger",
 		...n,
 		children: e
 	});
 }
-var u = r.forwardRef(({ className: n, align: r = "start", alignOffset: i = 0, side: a = "bottom", sideOffset: s = 4, ...c }, l) => /* @__PURE__ */ t(o.Portal, { children: /* @__PURE__ */ t(o.Positioner, {
-	className: "isolate z-50 outline-none",
-	align: r,
-	alignOffset: i,
-	side: a,
-	sideOffset: s,
-	children: /* @__PURE__ */ t(o.Popup, {
-		ref: l,
-		"data-slot": "dropdown-menu-content",
-		className: e("data-open:animate-in data-closed:animate-out data-closed:fade-out-0 data-open:fade-in-0 data-closed:zoom-out-95 data-open:zoom-in-95 data-[side=bottom]:slide-in-from-top-2 data-[side=left]:slide-in-from-right-2 data-[side=right]:slide-in-from-left-2 data-[side=top]:slide-in-from-bottom-2 ring-foreground/10 bg-popover text-popover-foreground min-w-32 rounded-lg p-1 shadow-md ring-1 duration-100 z-50 max-h-(--available-height) w-(--anchor-width) origin-(--transform-origin) overflow-x-hidden overflow-y-auto outline-none data-closed:overflow-hidden", n),
-		...c
-	})
-}) }));
-u.displayName = o.Popup.displayName;
-function d({ ...e }) {
-	return /* @__PURE__ */ t(o.Group, {
+function l({ ref: n, className: r, align: i = "start", alignOffset: o = 0, side: s = "bottom", sideOffset: c = 4, ...l }) {
+	return /* @__PURE__ */ t(a.Portal, { children: /* @__PURE__ */ t(a.Positioner, {
+		className: "isolate z-50 outline-none",
+		align: i,
+		alignOffset: o,
+		side: s,
+		sideOffset: c,
+		children: /* @__PURE__ */ t(a.Popup, {
+			ref: n,
+			"data-slot": "dropdown-menu-content",
+			className: e("data-open:animate-in data-closed:animate-out data-closed:fade-out-0 data-open:fade-in-0 data-closed:zoom-out-95 data-open:zoom-in-95 data-[side=bottom]:slide-in-from-top-2 data-[side=left]:slide-in-from-right-2 data-[side=right]:slide-in-from-left-2 data-[side=top]:slide-in-from-bottom-2 ring-foreground/10 bg-popover text-popover-foreground min-w-32 rounded-lg p-1 shadow-md ring-1 duration-100 z-50 max-h-(--available-height) w-(--anchor-width) origin-(--transform-origin) overflow-x-hidden overflow-y-auto outline-none data-closed:overflow-hidden", r),
+			...l
+		})
+	}) });
+}
+l.displayName = a.Popup.displayName;
+function u({ ...e }) {
+	return /* @__PURE__ */ t(a.Group, {
 		"data-slot": "dropdown-menu-group",
 		...e
 	});
 }
-var f = r.forwardRef(({ className: n, inset: r, ...i }, a) => /* @__PURE__ */ t(o.GroupLabel, {
-	ref: a,
-	"data-slot": "dropdown-menu-label",
-	"data-inset": r,
-	className: e("text-muted-foreground px-1.5 py-1 text-xs font-medium data-[inset]:pl-8", n),
-	...i
-}));
-f.displayName = o.GroupLabel.displayName;
-var p = r.forwardRef(({ className: n, inset: r, variant: i = "default", children: a, ...s }, c) => /* @__PURE__ */ t(o.Item, {
-	ref: c,
-	"data-slot": "dropdown-menu-item",
-	"data-inset": r,
-	"data-variant": i,
-	className: e("focus:bg-accent focus:text-accent-foreground data-[variant=destructive]:text-destructive data-[variant=destructive]:focus:bg-destructive/10 dark:data-[variant=destructive]:focus:bg-destructive/20 data-[variant=destructive]:focus:text-destructive data-[variant=destructive]:*:[svg]:text-destructive not-data-[variant=destructive]:focus:**:text-accent-foreground gap-1.5 rounded-md px-1.5 py-1 text-sm [&_svg:not([class*='size-'])]:size-4 group/dropdown-menu-item relative flex cursor-default items-center outline-hidden select-none data-disabled:pointer-events-none data-disabled:opacity-50 data-[inset]:pl-8 [&_svg]:pointer-events-none [&_svg]:shrink-0", n),
-	...s,
-	children: a
-}));
-p.displayName = o.Item.displayName;
-function m({ ...e }) {
-	return /* @__PURE__ */ t(o.SubmenuRoot, {
+function d({ ref: n, className: r, inset: i, ...o }) {
+	return /* @__PURE__ */ t(a.GroupLabel, {
+		ref: n,
+		"data-slot": "dropdown-menu-label",
+		"data-inset": i,
+		className: e("text-muted-foreground px-1.5 py-1 text-xs font-medium data-[inset]:pl-8", r),
+		...o
+	});
+}
+d.displayName = a.GroupLabel.displayName;
+function f({ ref: n, className: r, inset: i, variant: o = "default", children: s, ...c }) {
+	return /* @__PURE__ */ t(a.Item, {
+		ref: n,
+		"data-slot": "dropdown-menu-item",
+		"data-inset": i,
+		"data-variant": o,
+		className: e("focus:bg-accent focus:text-accent-foreground data-[variant=destructive]:text-destructive data-[variant=destructive]:focus:bg-destructive/10 dark:data-[variant=destructive]:focus:bg-destructive/20 data-[variant=destructive]:focus:text-destructive data-[variant=destructive]:*:[svg]:text-destructive not-data-[variant=destructive]:focus:**:text-accent-foreground gap-1.5 rounded-md px-1.5 py-1 text-sm [&_svg:not([class*='size-'])]:size-4 group/dropdown-menu-item relative flex cursor-default items-center outline-hidden select-none data-disabled:pointer-events-none data-disabled:opacity-50 data-[inset]:pl-8 [&_svg]:pointer-events-none [&_svg]:shrink-0", r),
+		...c,
+		children: s
+	});
+}
+f.displayName = a.Item.displayName;
+function p({ ...e }) {
+	return /* @__PURE__ */ t(a.SubmenuRoot, {
 		"data-slot": "dropdown-menu-sub",
 		...e
 	});
 }
-var h = r.forwardRef(({ className: r, inset: i, children: s, ...c }, l) => /* @__PURE__ */ n(o.SubmenuTrigger, {
-	ref: l,
-	"data-slot": "dropdown-menu-sub-trigger",
-	"data-inset": i,
-	className: e("focus:bg-accent focus:text-accent-foreground data-open:bg-accent data-open:text-accent-foreground not-data-[variant=destructive]:focus:**:text-accent-foreground gap-1.5 rounded-md px-1.5 py-1 text-sm [&_svg:not([class*='size-'])]:size-4 flex cursor-default items-center outline-hidden select-none data-[inset]:pl-8 [&_svg]:pointer-events-none [&_svg]:shrink-0", r),
-	...c,
-	children: [s, /* @__PURE__ */ t(a, { className: "ml-auto" })]
-}));
-h.displayName = o.SubmenuTrigger.displayName;
-var g = r.forwardRef(({ className: n, align: r = "start", alignOffset: i = -3, side: a = "right", sideOffset: o = 0, ...s }, c) => /* @__PURE__ */ t(u, {
-	ref: c,
-	"data-slot": "dropdown-menu-sub-content",
-	className: e("data-open:animate-in data-closed:animate-out data-closed:fade-out-0 data-open:fade-in-0 data-closed:zoom-out-95 data-open:zoom-in-95 data-[side=bottom]:slide-in-from-top-2 data-[side=left]:slide-in-from-right-2 data-[side=right]:slide-in-from-left-2 data-[side=top]:slide-in-from-bottom-2 ring-foreground/10 bg-popover text-popover-foreground min-w-[96px] rounded-md p-1 shadow-lg ring-1 duration-100 w-auto", n),
-	align: r,
-	alignOffset: i,
-	side: a,
-	sideOffset: o,
-	...s
-}));
-g.displayName = "DropdownMenuSubContent";
-var _ = r.forwardRef(({ className: r, children: a, checked: s, ...c }, l) => /* @__PURE__ */ n(o.CheckboxItem, {
-	ref: l,
-	"data-slot": "dropdown-menu-checkbox-item",
-	className: e("focus:bg-accent focus:text-accent-foreground focus:**:text-accent-foreground gap-1.5 rounded-md py-1 pr-8 pl-1.5 text-sm [&_svg:not([class*='size-'])]:size-4 relative flex cursor-default items-center outline-hidden select-none data-[disabled]:pointer-events-none data-[disabled]:opacity-50 [&_svg]:pointer-events-none [&_svg]:shrink-0", r),
-	checked: s,
-	...c,
-	children: [/* @__PURE__ */ t("span", {
-		className: "pointer-events-none absolute right-2 flex items-center justify-center pointer-events-none",
-		"data-slot": "dropdown-menu-checkbox-item-indicator",
-		children: /* @__PURE__ */ t(o.CheckboxItemIndicator, { children: /* @__PURE__ */ t(i, {}) })
-	}), a]
-}));
-_.displayName = o.CheckboxItem.displayName;
-function v({ ...e }) {
-	return /* @__PURE__ */ t(o.RadioGroup, {
+function m({ ref: r, className: o, inset: s, children: c, ...l }) {
+	return /* @__PURE__ */ n(a.SubmenuTrigger, {
+		ref: r,
+		"data-slot": "dropdown-menu-sub-trigger",
+		"data-inset": s,
+		className: e("focus:bg-accent focus:text-accent-foreground data-open:bg-accent data-open:text-accent-foreground not-data-[variant=destructive]:focus:**:text-accent-foreground gap-1.5 rounded-md px-1.5 py-1 text-sm [&_svg:not([class*='size-'])]:size-4 flex cursor-default items-center outline-hidden select-none data-[inset]:pl-8 [&_svg]:pointer-events-none [&_svg]:shrink-0", o),
+		...l,
+		children: [c, /* @__PURE__ */ t(i, { className: "ml-auto" })]
+	});
+}
+m.displayName = a.SubmenuTrigger.displayName;
+function h({ ref: n, className: r, align: i = "start", alignOffset: a = -3, side: o = "right", sideOffset: s = 0, ...c }) {
+	return /* @__PURE__ */ t(l, {
+		ref: n,
+		"data-slot": "dropdown-menu-sub-content",
+		className: e("data-open:animate-in data-closed:animate-out data-closed:fade-out-0 data-open:fade-in-0 data-closed:zoom-out-95 data-open:zoom-in-95 data-[side=bottom]:slide-in-from-top-2 data-[side=left]:slide-in-from-right-2 data-[side=right]:slide-in-from-left-2 data-[side=top]:slide-in-from-bottom-2 ring-foreground/10 bg-popover text-popover-foreground min-w-[96px] rounded-md p-1 shadow-lg ring-1 duration-100 w-auto", r),
+		align: i,
+		alignOffset: a,
+		side: o,
+		sideOffset: s,
+		...c
+	});
+}
+h.displayName = "DropdownMenuSubContent";
+function g({ ref: i, className: o, children: s, checked: c, ...l }) {
+	return /* @__PURE__ */ n(a.CheckboxItem, {
+		ref: i,
+		"data-slot": "dropdown-menu-checkbox-item",
+		className: e("focus:bg-accent focus:text-accent-foreground focus:**:text-accent-foreground gap-1.5 rounded-md py-1 pr-8 pl-1.5 text-sm [&_svg:not([class*='size-'])]:size-4 relative flex cursor-default items-center outline-hidden select-none data-[disabled]:pointer-events-none data-[disabled]:opacity-50 [&_svg]:pointer-events-none [&_svg]:shrink-0", o),
+		checked: c,
+		...l,
+		children: [/* @__PURE__ */ t("span", {
+			className: "pointer-events-none absolute right-2 flex items-center justify-center pointer-events-none",
+			"data-slot": "dropdown-menu-checkbox-item-indicator",
+			children: /* @__PURE__ */ t(a.CheckboxItemIndicator, { children: /* @__PURE__ */ t(r, {}) })
+		}), s]
+	});
+}
+g.displayName = a.CheckboxItem.displayName;
+function _({ ...e }) {
+	return /* @__PURE__ */ t(a.RadioGroup, {
 		"data-slot": "dropdown-menu-radio-group",
 		...e
 	});
 }
-var y = r.forwardRef(({ className: r, children: a, ...s }, c) => /* @__PURE__ */ n(o.RadioItem, {
-	ref: c,
-	"data-slot": "dropdown-menu-radio-item",
-	className: e("focus:bg-accent focus:text-accent-foreground focus:**:text-accent-foreground gap-1.5 rounded-md py-1 pr-8 pl-1.5 text-sm [&_svg:not([class*='size-'])]:size-4 relative flex cursor-default items-center outline-hidden select-none data-[disabled]:pointer-events-none data-[disabled]:opacity-50 [&_svg]:pointer-events-none [&_svg]:shrink-0", r),
-	...s,
-	children: [/* @__PURE__ */ t("span", {
-		className: "pointer-events-none absolute right-2 flex items-center justify-center pointer-events-none",
-		"data-slot": "dropdown-menu-radio-item-indicator",
-		children: /* @__PURE__ */ t(o.RadioItemIndicator, { children: /* @__PURE__ */ t(i, {}) })
-	}), a]
-}));
-y.displayName = o.RadioItem.displayName;
-var b = r.forwardRef(({ className: n, ...r }, i) => /* @__PURE__ */ t(o.Separator, {
-	ref: i,
-	"data-slot": "dropdown-menu-separator",
-	className: e("bg-border -mx-1 my-1 h-px", n),
-	...r
-}));
-b.displayName = o.Separator.displayName;
-var x = r.forwardRef(({ className: n, ...r }, i) => /* @__PURE__ */ t("span", {
-	ref: i,
-	"data-slot": "dropdown-menu-shortcut",
-	className: e("text-muted-foreground group-focus/dropdown-menu-item:text-accent-foreground ml-auto text-xs tracking-widest", n),
-	...r
-}));
-x.displayName = "DropdownMenuShortcut";
+function v({ ref: i, className: o, children: s, ...c }) {
+	return /* @__PURE__ */ n(a.RadioItem, {
+		ref: i,
+		"data-slot": "dropdown-menu-radio-item",
+		className: e("focus:bg-accent focus:text-accent-foreground focus:**:text-accent-foreground gap-1.5 rounded-md py-1 pr-8 pl-1.5 text-sm [&_svg:not([class*='size-'])]:size-4 relative flex cursor-default items-center outline-hidden select-none data-[disabled]:pointer-events-none data-[disabled]:opacity-50 [&_svg]:pointer-events-none [&_svg]:shrink-0", o),
+		...c,
+		children: [/* @__PURE__ */ t("span", {
+			className: "pointer-events-none absolute right-2 flex items-center justify-center pointer-events-none",
+			"data-slot": "dropdown-menu-radio-item-indicator",
+			children: /* @__PURE__ */ t(a.RadioItemIndicator, { children: /* @__PURE__ */ t(r, {}) })
+		}), s]
+	});
+}
+v.displayName = a.RadioItem.displayName;
+function y({ ref: n, className: r, ...i }) {
+	return /* @__PURE__ */ t(a.Separator, {
+		ref: n,
+		"data-slot": "dropdown-menu-separator",
+		className: e("bg-border -mx-1 my-1 h-px", r),
+		...i
+	});
+}
+y.displayName = a.Separator.displayName;
+function b({ ref: n, className: r, ...i }) {
+	return /* @__PURE__ */ t("span", {
+		ref: n,
+		"data-slot": "dropdown-menu-shortcut",
+		className: e("text-muted-foreground group-focus/dropdown-menu-item:text-accent-foreground ml-auto text-xs tracking-widest", r),
+		...i
+	});
+}
+b.displayName = "DropdownMenuShortcut";
 //#endregion
-export { s as DropdownMenu, _ as DropdownMenuCheckboxItem, u as DropdownMenuContent, d as DropdownMenuGroup, p as DropdownMenuItem, f as DropdownMenuLabel, c as DropdownMenuPortal, v as DropdownMenuRadioGroup, y as DropdownMenuRadioItem, b as DropdownMenuSeparator, x as DropdownMenuShortcut, m as DropdownMenuSub, g as DropdownMenuSubContent, h as DropdownMenuSubTrigger, l as DropdownMenuTrigger };
+export { o as DropdownMenu, g as DropdownMenuCheckboxItem, l as DropdownMenuContent, u as DropdownMenuGroup, f as DropdownMenuItem, d as DropdownMenuLabel, s as DropdownMenuPortal, _ as DropdownMenuRadioGroup, v as DropdownMenuRadioItem, y as DropdownMenuSeparator, b as DropdownMenuShortcut, p as DropdownMenuSub, h as DropdownMenuSubContent, m as DropdownMenuSubTrigger, c as DropdownMenuTrigger };
 
 //# sourceMappingURL=dropdown-menu.js.map