@alneas/appkit-react 0.1.0 → 0.2.0

package/dist/ui/components/ui/context-menu.d.cts

@@ -1,37 +1,268 @@
 import { ContextMenu as ContextMenuPrimitive } from '@base-ui/react/context-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 ContextMenu composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Items and popup parts require the matching ContextMenu 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 { ContextMenu, ContextMenuTrigger, ContextMenuContent, ContextMenuItem, ContextMenuGroup, ContextMenuLabel, ContextMenuSeparator } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<ContextMenu><ContextMenuTrigger>Right-click here</ContextMenuTrigger><ContextMenuContent><ContextMenuGroup><ContextMenuLabel>Document</ContextMenuLabel><ContextMenuItem onClick={() => console.log("Open requested")}>Open</ContextMenuItem></ContextMenuGroup><ContextMenuSeparator /><ContextMenuItem disabled>Unavailable</ContextMenuItem></ContextMenuContent></ContextMenu>);
+ * }
+ * ```
  */
 declare const ContextMenu: {
     (props: ContextMenuPrimitive.Root.Props): React.JSX.Element;
     displayName: string;
 };
+/**
+ * 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 ContextMenuPortal composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Items and popup parts require the matching ContextMenu 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 { ContextMenu, ContextMenuTrigger, ContextMenuContent, ContextMenuItem, ContextMenuGroup, ContextMenuLabel, ContextMenuSeparator } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<ContextMenu><ContextMenuTrigger>Right-click here</ContextMenuTrigger><ContextMenuContent><ContextMenuGroup><ContextMenuLabel>Document</ContextMenuLabel><ContextMenuItem onClick={() => console.log("Open requested")}>Open</ContextMenuItem></ContextMenuGroup><ContextMenuSeparator /><ContextMenuItem disabled>Unavailable</ContextMenuItem></ContextMenuContent></ContextMenu>);
+ * }
+ * ```
+ */
 declare const ContextMenuPortal: React.ForwardRefExoticComponent<Omit<import('@base-ui/react').ContextMenuPortalProps, "ref"> & React.RefAttributes<HTMLDivElement>>;
+/**
+ * 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 ContextMenuTrigger composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Items and popup parts require the matching ContextMenu 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 { ContextMenu, ContextMenuTrigger, ContextMenuContent, ContextMenuItem, ContextMenuGroup, ContextMenuLabel, ContextMenuSeparator } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<ContextMenu><ContextMenuTrigger>Right-click here</ContextMenuTrigger><ContextMenuContent><ContextMenuGroup><ContextMenuLabel>Document</ContextMenuLabel><ContextMenuItem onClick={() => console.log("Open requested")}>Open</ContextMenuItem></ContextMenuGroup><ContextMenuSeparator /><ContextMenuItem disabled>Unavailable</ContextMenuItem></ContextMenuContent></ContextMenu>);
+ * }
+ * ```
+ */
 declare const ContextMenuTrigger: React.ForwardRefExoticComponent<Omit<import('@base-ui/react').ContextMenuTriggerProps, "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=4, side='right', sideOffset=0.
+ * @returns The rendered ContextMenuContent composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Items and popup parts require the matching ContextMenu 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 { ContextMenu, ContextMenuTrigger, ContextMenuContent, ContextMenuItem, ContextMenuGroup, ContextMenuLabel, ContextMenuSeparator } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<ContextMenu><ContextMenuTrigger>Right-click here</ContextMenuTrigger><ContextMenuContent><ContextMenuGroup><ContextMenuLabel>Document</ContextMenuLabel><ContextMenuItem onClick={() => console.log("Open requested")}>Open</ContextMenuItem></ContextMenuGroup><ContextMenuSeparator /><ContextMenuItem disabled>Unavailable</ContextMenuItem></ContextMenuContent></ContextMenu>);
+ * }
+ * ```
+ */
 declare const ContextMenuContent: React.ForwardRefExoticComponent<Omit<import('@base-ui/react').ContextMenuPopupProps & Pick<import('@base-ui/react').ContextMenuPositionerProps, "side" | "align" | "sideOffset" | "alignOffset">, "ref"> & React.RefAttributes<HTMLDivElement>>;
+/**
+ * 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 ContextMenuGroup composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Items and popup parts require the matching ContextMenu 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 { ContextMenu, ContextMenuTrigger, ContextMenuContent, ContextMenuItem, ContextMenuGroup, ContextMenuLabel, ContextMenuSeparator } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<ContextMenu><ContextMenuTrigger>Right-click here</ContextMenuTrigger><ContextMenuContent><ContextMenuGroup><ContextMenuLabel>Document</ContextMenuLabel><ContextMenuItem onClick={() => console.log("Open requested")}>Open</ContextMenuItem></ContextMenuGroup><ContextMenuSeparator /><ContextMenuItem disabled>Unavailable</ContextMenuItem></ContextMenuContent></ContextMenu>);
+ * }
+ * ```
+ */
 declare const ContextMenuGroup: React.ForwardRefExoticComponent<Omit<import('@base-ui/react').ContextMenuGroupProps, "ref"> & React.RefAttributes<HTMLDivElement>>;
+/**
+ * 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 ContextMenuLabel composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Items and popup parts require the matching ContextMenu 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 { ContextMenu, ContextMenuTrigger, ContextMenuContent, ContextMenuItem, ContextMenuGroup, ContextMenuLabel, ContextMenuSeparator } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<ContextMenu><ContextMenuTrigger>Right-click here</ContextMenuTrigger><ContextMenuContent><ContextMenuGroup><ContextMenuLabel>Document</ContextMenuLabel><ContextMenuItem onClick={() => console.log("Open requested")}>Open</ContextMenuItem></ContextMenuGroup><ContextMenuSeparator /><ContextMenuItem disabled>Unavailable</ContextMenuItem></ContextMenuContent></ContextMenu>);
+ * }
+ * ```
+ */
 declare const ContextMenuLabel: React.ForwardRefExoticComponent<Omit<import('@base-ui/react').ContextMenuGroupLabelProps & {
+    /**
+     * Adds left inset spacing when true; omitted/false uses normal alignment.
+     */
     inset?: boolean;
 }, "ref"> & React.RefAttributes<HTMLDivElement>>;
+/**
+ * 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 ContextMenuItem composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Items and popup parts require the matching ContextMenu 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 { ContextMenu, ContextMenuTrigger, ContextMenuContent, ContextMenuItem, ContextMenuGroup, ContextMenuLabel, ContextMenuSeparator } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<ContextMenu><ContextMenuTrigger>Right-click here</ContextMenuTrigger><ContextMenuContent><ContextMenuGroup><ContextMenuLabel>Document</ContextMenuLabel><ContextMenuItem onClick={() => console.log("Open requested")}>Open</ContextMenuItem></ContextMenuGroup><ContextMenuSeparator /><ContextMenuItem disabled>Unavailable</ContextMenuItem></ContextMenuContent></ContextMenu>);
+ * }
+ * ```
+ */
 declare const ContextMenuItem: React.ForwardRefExoticComponent<Omit<import('@base-ui/react').ContextMenuItemProps & {
+    /**
+     * Adds left inset spacing when true; omitted/false uses normal alignment.
+     */
     inset?: boolean;
+    /**
+     * Visual treatment from the declared variant union; changing it does not alter host action semantics.
+     */
     variant?: "default" | "destructive";
 }, "ref"> & React.RefAttributes<HTMLDivElement>>;
 /**
- * コンテキストメニュー内でさらに深い階層のメニュー（サブメニュー）を作成するためのコンポーネント。
+ * 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 ContextMenuSub composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Items and popup parts require the matching ContextMenu 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 { ContextMenu, ContextMenuTrigger, ContextMenuContent, ContextMenuItem, ContextMenuGroup, ContextMenuLabel, ContextMenuSeparator } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<ContextMenu><ContextMenuTrigger>Right-click here</ContextMenuTrigger><ContextMenuContent><ContextMenuGroup><ContextMenuLabel>Document</ContextMenuLabel><ContextMenuItem onClick={() => console.log("Open requested")}>Open</ContextMenuItem></ContextMenuGroup><ContextMenuSeparator /><ContextMenuItem disabled>Unavailable</ContextMenuItem></ContextMenuContent></ContextMenu>);
+ * }
+ * ```
  */
 declare const ContextMenuSub: {
     (props: ContextMenuPrimitive.SubmenuRoot.Props): React.JSX.Element;
     displayName: string;
 };
+/**
+ * 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 ContextMenuSubTrigger composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Items and popup parts require the matching ContextMenu 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 { ContextMenu, ContextMenuTrigger, ContextMenuContent, ContextMenuItem, ContextMenuGroup, ContextMenuLabel, ContextMenuSeparator } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<ContextMenu><ContextMenuTrigger>Right-click here</ContextMenuTrigger><ContextMenuContent><ContextMenuGroup><ContextMenuLabel>Document</ContextMenuLabel><ContextMenuItem onClick={() => console.log("Open requested")}>Open</ContextMenuItem></ContextMenuGroup><ContextMenuSeparator /><ContextMenuItem disabled>Unavailable</ContextMenuItem></ContextMenuContent></ContextMenu>);
+ * }
+ * ```
+ */
 declare const ContextMenuSubTrigger: React.ForwardRefExoticComponent<Omit<import('@base-ui/react').ContextMenuSubmenuTriggerProps & {
+    /**
+     * Adds left inset spacing when true; omitted/false uses normal alignment.
+     */
     inset?: boolean;
 }, "ref"> & React.RefAttributes<HTMLDivElement>>;
+/**
+ * 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.
+ * @returns The rendered ContextMenuSubContent composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Items and popup parts require the matching ContextMenu 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 { ContextMenu, ContextMenuTrigger, ContextMenuContent, ContextMenuItem, ContextMenuGroup, ContextMenuLabel, ContextMenuSeparator } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<ContextMenu><ContextMenuTrigger>Right-click here</ContextMenuTrigger><ContextMenuContent><ContextMenuGroup><ContextMenuLabel>Document</ContextMenuLabel><ContextMenuItem onClick={() => console.log("Open requested")}>Open</ContextMenuItem></ContextMenuGroup><ContextMenuSeparator /><ContextMenuItem disabled>Unavailable</ContextMenuItem></ContextMenuContent></ContextMenu>);
+ * }
+ * ```
+ */
 declare const ContextMenuSubContent: React.ForwardRefExoticComponent<Omit<Omit<import('@base-ui/react').ContextMenuPopupProps & Pick<import('@base-ui/react').ContextMenuPositionerProps, "side" | "align" | "sideOffset" | "alignOffset">, "ref"> & React.RefAttributes<HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
+/**
+ * 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 ContextMenuCheckboxItem composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Items and popup parts require the matching ContextMenu 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 { ContextMenu, ContextMenuTrigger, ContextMenuContent, ContextMenuItem, ContextMenuGroup, ContextMenuLabel, ContextMenuSeparator } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<ContextMenu><ContextMenuTrigger>Right-click here</ContextMenuTrigger><ContextMenuContent><ContextMenuGroup><ContextMenuLabel>Document</ContextMenuLabel><ContextMenuItem onClick={() => console.log("Open requested")}>Open</ContextMenuItem></ContextMenuGroup><ContextMenuSeparator /><ContextMenuItem disabled>Unavailable</ContextMenuItem></ContextMenuContent></ContextMenu>);
+ * }
+ * ```
+ */
 declare const ContextMenuCheckboxItem: React.ForwardRefExoticComponent<Omit<import('@base-ui/react').ContextMenuCheckboxItemProps, "ref"> & React.RefAttributes<HTMLDivElement>>;
+/**
+ * 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 ContextMenuRadioGroup composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Items and popup parts require the matching ContextMenu 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 { ContextMenu, ContextMenuTrigger, ContextMenuContent, ContextMenuItem, ContextMenuGroup, ContextMenuLabel, ContextMenuSeparator } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<ContextMenu><ContextMenuTrigger>Right-click here</ContextMenuTrigger><ContextMenuContent><ContextMenuGroup><ContextMenuLabel>Document</ContextMenuLabel><ContextMenuItem onClick={() => console.log("Open requested")}>Open</ContextMenuItem></ContextMenuGroup><ContextMenuSeparator /><ContextMenuItem disabled>Unavailable</ContextMenuItem></ContextMenuContent></ContextMenu>);
+ * }
+ * ```
+ */
 declare const ContextMenuRadioGroup: React.ForwardRefExoticComponent<Omit<import('@base-ui/react').ContextMenuRadioGroupProps, "ref"> & React.RefAttributes<HTMLDivElement>>;
+/**
+ * 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 ContextMenuRadioItem composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Items and popup parts require the matching ContextMenu 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 { ContextMenu, ContextMenuTrigger, ContextMenuContent, ContextMenuItem, ContextMenuGroup, ContextMenuLabel, ContextMenuSeparator } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<ContextMenu><ContextMenuTrigger>Right-click here</ContextMenuTrigger><ContextMenuContent><ContextMenuGroup><ContextMenuLabel>Document</ContextMenuLabel><ContextMenuItem onClick={() => console.log("Open requested")}>Open</ContextMenuItem></ContextMenuGroup><ContextMenuSeparator /><ContextMenuItem disabled>Unavailable</ContextMenuItem></ContextMenuContent></ContextMenu>);
+ * }
+ * ```
+ */
 declare const ContextMenuRadioItem: React.ForwardRefExoticComponent<Omit<import('@base-ui/react').ContextMenuRadioItemProps, "ref"> & React.RefAttributes<HTMLDivElement>>;
+/**
+ * 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 ContextMenuSeparator composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Items and popup parts require the matching ContextMenu 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 { ContextMenu, ContextMenuTrigger, ContextMenuContent, ContextMenuItem, ContextMenuGroup, ContextMenuLabel, ContextMenuSeparator } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<ContextMenu><ContextMenuTrigger>Right-click here</ContextMenuTrigger><ContextMenuContent><ContextMenuGroup><ContextMenuLabel>Document</ContextMenuLabel><ContextMenuItem onClick={() => console.log("Open requested")}>Open</ContextMenuItem></ContextMenuGroup><ContextMenuSeparator /><ContextMenuItem disabled>Unavailable</ContextMenuItem></ContextMenuContent></ContextMenu>);
+ * }
+ * ```
+ */
 declare const ContextMenuSeparator: React.ForwardRefExoticComponent<Omit<import('@base-ui/react').SeparatorProps, "ref"> & React.RefAttributes<HTMLDivElement>>;
+/**
+ * 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 ContextMenuShortcut composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Items and popup parts require the matching ContextMenu 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 { ContextMenu, ContextMenuTrigger, ContextMenuContent, ContextMenuItem, ContextMenuGroup, ContextMenuLabel, ContextMenuSeparator } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<ContextMenu><ContextMenuTrigger>Right-click here</ContextMenuTrigger><ContextMenuContent><ContextMenuGroup><ContextMenuLabel>Document</ContextMenuLabel><ContextMenuItem onClick={() => console.log("Open requested")}>Open</ContextMenuItem></ContextMenuGroup><ContextMenuSeparator /><ContextMenuItem disabled>Unavailable</ContextMenuItem></ContextMenuContent></ContextMenu>);
+ * }
+ * ```
+ */
 declare const ContextMenuShortcut: React.ForwardRefExoticComponent<Omit<React.DetailedHTMLProps<React.HTMLAttributes<HTMLSpanElement>, HTMLSpanElement>, "ref"> & React.RefAttributes<HTMLSpanElement>>;
 export { ContextMenu, ContextMenuTrigger, ContextMenuContent, ContextMenuItem, ContextMenuCheckboxItem, ContextMenuRadioItem, ContextMenuLabel, ContextMenuSeparator, ContextMenuShortcut, ContextMenuGroup, ContextMenuPortal, ContextMenuSub, ContextMenuSubContent, ContextMenuSubTrigger, ContextMenuRadioGroup, };

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

@@ -1,37 +1,268 @@
 import { ContextMenu as ContextMenuPrimitive } from '@base-ui/react/context-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 ContextMenu composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Items and popup parts require the matching ContextMenu 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 { ContextMenu, ContextMenuTrigger, ContextMenuContent, ContextMenuItem, ContextMenuGroup, ContextMenuLabel, ContextMenuSeparator } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<ContextMenu><ContextMenuTrigger>Right-click here</ContextMenuTrigger><ContextMenuContent><ContextMenuGroup><ContextMenuLabel>Document</ContextMenuLabel><ContextMenuItem onClick={() => console.log("Open requested")}>Open</ContextMenuItem></ContextMenuGroup><ContextMenuSeparator /><ContextMenuItem disabled>Unavailable</ContextMenuItem></ContextMenuContent></ContextMenu>);
+ * }
+ * ```
  */
 declare const ContextMenu: {
     (props: ContextMenuPrimitive.Root.Props): React.JSX.Element;
     displayName: string;
 };
+/**
+ * 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 ContextMenuPortal composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Items and popup parts require the matching ContextMenu 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 { ContextMenu, ContextMenuTrigger, ContextMenuContent, ContextMenuItem, ContextMenuGroup, ContextMenuLabel, ContextMenuSeparator } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<ContextMenu><ContextMenuTrigger>Right-click here</ContextMenuTrigger><ContextMenuContent><ContextMenuGroup><ContextMenuLabel>Document</ContextMenuLabel><ContextMenuItem onClick={() => console.log("Open requested")}>Open</ContextMenuItem></ContextMenuGroup><ContextMenuSeparator /><ContextMenuItem disabled>Unavailable</ContextMenuItem></ContextMenuContent></ContextMenu>);
+ * }
+ * ```
+ */
 declare const ContextMenuPortal: React.ForwardRefExoticComponent<Omit<import('@base-ui/react').ContextMenuPortalProps, "ref"> & React.RefAttributes<HTMLDivElement>>;
+/**
+ * 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 ContextMenuTrigger composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Items and popup parts require the matching ContextMenu 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 { ContextMenu, ContextMenuTrigger, ContextMenuContent, ContextMenuItem, ContextMenuGroup, ContextMenuLabel, ContextMenuSeparator } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<ContextMenu><ContextMenuTrigger>Right-click here</ContextMenuTrigger><ContextMenuContent><ContextMenuGroup><ContextMenuLabel>Document</ContextMenuLabel><ContextMenuItem onClick={() => console.log("Open requested")}>Open</ContextMenuItem></ContextMenuGroup><ContextMenuSeparator /><ContextMenuItem disabled>Unavailable</ContextMenuItem></ContextMenuContent></ContextMenu>);
+ * }
+ * ```
+ */
 declare const ContextMenuTrigger: React.ForwardRefExoticComponent<Omit<import('@base-ui/react').ContextMenuTriggerProps, "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=4, side='right', sideOffset=0.
+ * @returns The rendered ContextMenuContent composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Items and popup parts require the matching ContextMenu 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 { ContextMenu, ContextMenuTrigger, ContextMenuContent, ContextMenuItem, ContextMenuGroup, ContextMenuLabel, ContextMenuSeparator } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<ContextMenu><ContextMenuTrigger>Right-click here</ContextMenuTrigger><ContextMenuContent><ContextMenuGroup><ContextMenuLabel>Document</ContextMenuLabel><ContextMenuItem onClick={() => console.log("Open requested")}>Open</ContextMenuItem></ContextMenuGroup><ContextMenuSeparator /><ContextMenuItem disabled>Unavailable</ContextMenuItem></ContextMenuContent></ContextMenu>);
+ * }
+ * ```
+ */
 declare const ContextMenuContent: React.ForwardRefExoticComponent<Omit<import('@base-ui/react').ContextMenuPopupProps & Pick<import('@base-ui/react').ContextMenuPositionerProps, "side" | "align" | "sideOffset" | "alignOffset">, "ref"> & React.RefAttributes<HTMLDivElement>>;
+/**
+ * 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 ContextMenuGroup composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Items and popup parts require the matching ContextMenu 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 { ContextMenu, ContextMenuTrigger, ContextMenuContent, ContextMenuItem, ContextMenuGroup, ContextMenuLabel, ContextMenuSeparator } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<ContextMenu><ContextMenuTrigger>Right-click here</ContextMenuTrigger><ContextMenuContent><ContextMenuGroup><ContextMenuLabel>Document</ContextMenuLabel><ContextMenuItem onClick={() => console.log("Open requested")}>Open</ContextMenuItem></ContextMenuGroup><ContextMenuSeparator /><ContextMenuItem disabled>Unavailable</ContextMenuItem></ContextMenuContent></ContextMenu>);
+ * }
+ * ```
+ */
 declare const ContextMenuGroup: React.ForwardRefExoticComponent<Omit<import('@base-ui/react').ContextMenuGroupProps, "ref"> & React.RefAttributes<HTMLDivElement>>;
+/**
+ * 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 ContextMenuLabel composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Items and popup parts require the matching ContextMenu 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 { ContextMenu, ContextMenuTrigger, ContextMenuContent, ContextMenuItem, ContextMenuGroup, ContextMenuLabel, ContextMenuSeparator } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<ContextMenu><ContextMenuTrigger>Right-click here</ContextMenuTrigger><ContextMenuContent><ContextMenuGroup><ContextMenuLabel>Document</ContextMenuLabel><ContextMenuItem onClick={() => console.log("Open requested")}>Open</ContextMenuItem></ContextMenuGroup><ContextMenuSeparator /><ContextMenuItem disabled>Unavailable</ContextMenuItem></ContextMenuContent></ContextMenu>);
+ * }
+ * ```
+ */
 declare const ContextMenuLabel: React.ForwardRefExoticComponent<Omit<import('@base-ui/react').ContextMenuGroupLabelProps & {
+    /**
+     * Adds left inset spacing when true; omitted/false uses normal alignment.
+     */
     inset?: boolean;
 }, "ref"> & React.RefAttributes<HTMLDivElement>>;
+/**
+ * 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 ContextMenuItem composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Items and popup parts require the matching ContextMenu 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 { ContextMenu, ContextMenuTrigger, ContextMenuContent, ContextMenuItem, ContextMenuGroup, ContextMenuLabel, ContextMenuSeparator } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<ContextMenu><ContextMenuTrigger>Right-click here</ContextMenuTrigger><ContextMenuContent><ContextMenuGroup><ContextMenuLabel>Document</ContextMenuLabel><ContextMenuItem onClick={() => console.log("Open requested")}>Open</ContextMenuItem></ContextMenuGroup><ContextMenuSeparator /><ContextMenuItem disabled>Unavailable</ContextMenuItem></ContextMenuContent></ContextMenu>);
+ * }
+ * ```
+ */
 declare const ContextMenuItem: React.ForwardRefExoticComponent<Omit<import('@base-ui/react').ContextMenuItemProps & {
+    /**
+     * Adds left inset spacing when true; omitted/false uses normal alignment.
+     */
     inset?: boolean;
+    /**
+     * Visual treatment from the declared variant union; changing it does not alter host action semantics.
+     */
     variant?: "default" | "destructive";
 }, "ref"> & React.RefAttributes<HTMLDivElement>>;
 /**
- * コンテキストメニュー内でさらに深い階層のメニュー（サブメニュー）を作成するためのコンポーネント。
+ * 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 ContextMenuSub composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Items and popup parts require the matching ContextMenu 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 { ContextMenu, ContextMenuTrigger, ContextMenuContent, ContextMenuItem, ContextMenuGroup, ContextMenuLabel, ContextMenuSeparator } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<ContextMenu><ContextMenuTrigger>Right-click here</ContextMenuTrigger><ContextMenuContent><ContextMenuGroup><ContextMenuLabel>Document</ContextMenuLabel><ContextMenuItem onClick={() => console.log("Open requested")}>Open</ContextMenuItem></ContextMenuGroup><ContextMenuSeparator /><ContextMenuItem disabled>Unavailable</ContextMenuItem></ContextMenuContent></ContextMenu>);
+ * }
+ * ```
  */
 declare const ContextMenuSub: {
     (props: ContextMenuPrimitive.SubmenuRoot.Props): React.JSX.Element;
     displayName: string;
 };
+/**
+ * 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 ContextMenuSubTrigger composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Items and popup parts require the matching ContextMenu 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 { ContextMenu, ContextMenuTrigger, ContextMenuContent, ContextMenuItem, ContextMenuGroup, ContextMenuLabel, ContextMenuSeparator } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<ContextMenu><ContextMenuTrigger>Right-click here</ContextMenuTrigger><ContextMenuContent><ContextMenuGroup><ContextMenuLabel>Document</ContextMenuLabel><ContextMenuItem onClick={() => console.log("Open requested")}>Open</ContextMenuItem></ContextMenuGroup><ContextMenuSeparator /><ContextMenuItem disabled>Unavailable</ContextMenuItem></ContextMenuContent></ContextMenu>);
+ * }
+ * ```
+ */
 declare const ContextMenuSubTrigger: React.ForwardRefExoticComponent<Omit<import('@base-ui/react').ContextMenuSubmenuTriggerProps & {
+    /**
+     * Adds left inset spacing when true; omitted/false uses normal alignment.
+     */
     inset?: boolean;
 }, "ref"> & React.RefAttributes<HTMLDivElement>>;
+/**
+ * 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.
+ * @returns The rendered ContextMenuSubContent composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Items and popup parts require the matching ContextMenu 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 { ContextMenu, ContextMenuTrigger, ContextMenuContent, ContextMenuItem, ContextMenuGroup, ContextMenuLabel, ContextMenuSeparator } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<ContextMenu><ContextMenuTrigger>Right-click here</ContextMenuTrigger><ContextMenuContent><ContextMenuGroup><ContextMenuLabel>Document</ContextMenuLabel><ContextMenuItem onClick={() => console.log("Open requested")}>Open</ContextMenuItem></ContextMenuGroup><ContextMenuSeparator /><ContextMenuItem disabled>Unavailable</ContextMenuItem></ContextMenuContent></ContextMenu>);
+ * }
+ * ```
+ */
 declare const ContextMenuSubContent: React.ForwardRefExoticComponent<Omit<Omit<import('@base-ui/react').ContextMenuPopupProps & Pick<import('@base-ui/react').ContextMenuPositionerProps, "side" | "align" | "sideOffset" | "alignOffset">, "ref"> & React.RefAttributes<HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
+/**
+ * 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 ContextMenuCheckboxItem composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Items and popup parts require the matching ContextMenu 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 { ContextMenu, ContextMenuTrigger, ContextMenuContent, ContextMenuItem, ContextMenuGroup, ContextMenuLabel, ContextMenuSeparator } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<ContextMenu><ContextMenuTrigger>Right-click here</ContextMenuTrigger><ContextMenuContent><ContextMenuGroup><ContextMenuLabel>Document</ContextMenuLabel><ContextMenuItem onClick={() => console.log("Open requested")}>Open</ContextMenuItem></ContextMenuGroup><ContextMenuSeparator /><ContextMenuItem disabled>Unavailable</ContextMenuItem></ContextMenuContent></ContextMenu>);
+ * }
+ * ```
+ */
 declare const ContextMenuCheckboxItem: React.ForwardRefExoticComponent<Omit<import('@base-ui/react').ContextMenuCheckboxItemProps, "ref"> & React.RefAttributes<HTMLDivElement>>;
+/**
+ * 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 ContextMenuRadioGroup composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Items and popup parts require the matching ContextMenu 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 { ContextMenu, ContextMenuTrigger, ContextMenuContent, ContextMenuItem, ContextMenuGroup, ContextMenuLabel, ContextMenuSeparator } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<ContextMenu><ContextMenuTrigger>Right-click here</ContextMenuTrigger><ContextMenuContent><ContextMenuGroup><ContextMenuLabel>Document</ContextMenuLabel><ContextMenuItem onClick={() => console.log("Open requested")}>Open</ContextMenuItem></ContextMenuGroup><ContextMenuSeparator /><ContextMenuItem disabled>Unavailable</ContextMenuItem></ContextMenuContent></ContextMenu>);
+ * }
+ * ```
+ */
 declare const ContextMenuRadioGroup: React.ForwardRefExoticComponent<Omit<import('@base-ui/react').ContextMenuRadioGroupProps, "ref"> & React.RefAttributes<HTMLDivElement>>;
+/**
+ * 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 ContextMenuRadioItem composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Items and popup parts require the matching ContextMenu 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 { ContextMenu, ContextMenuTrigger, ContextMenuContent, ContextMenuItem, ContextMenuGroup, ContextMenuLabel, ContextMenuSeparator } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<ContextMenu><ContextMenuTrigger>Right-click here</ContextMenuTrigger><ContextMenuContent><ContextMenuGroup><ContextMenuLabel>Document</ContextMenuLabel><ContextMenuItem onClick={() => console.log("Open requested")}>Open</ContextMenuItem></ContextMenuGroup><ContextMenuSeparator /><ContextMenuItem disabled>Unavailable</ContextMenuItem></ContextMenuContent></ContextMenu>);
+ * }
+ * ```
+ */
 declare const ContextMenuRadioItem: React.ForwardRefExoticComponent<Omit<import('@base-ui/react').ContextMenuRadioItemProps, "ref"> & React.RefAttributes<HTMLDivElement>>;
+/**
+ * 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 ContextMenuSeparator composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Items and popup parts require the matching ContextMenu 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 { ContextMenu, ContextMenuTrigger, ContextMenuContent, ContextMenuItem, ContextMenuGroup, ContextMenuLabel, ContextMenuSeparator } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<ContextMenu><ContextMenuTrigger>Right-click here</ContextMenuTrigger><ContextMenuContent><ContextMenuGroup><ContextMenuLabel>Document</ContextMenuLabel><ContextMenuItem onClick={() => console.log("Open requested")}>Open</ContextMenuItem></ContextMenuGroup><ContextMenuSeparator /><ContextMenuItem disabled>Unavailable</ContextMenuItem></ContextMenuContent></ContextMenu>);
+ * }
+ * ```
+ */
 declare const ContextMenuSeparator: React.ForwardRefExoticComponent<Omit<import('@base-ui/react').SeparatorProps, "ref"> & React.RefAttributes<HTMLDivElement>>;
+/**
+ * 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 ContextMenuShortcut composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Items and popup parts require the matching ContextMenu 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 { ContextMenu, ContextMenuTrigger, ContextMenuContent, ContextMenuItem, ContextMenuGroup, ContextMenuLabel, ContextMenuSeparator } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<ContextMenu><ContextMenuTrigger>Right-click here</ContextMenuTrigger><ContextMenuContent><ContextMenuGroup><ContextMenuLabel>Document</ContextMenuLabel><ContextMenuItem onClick={() => console.log("Open requested")}>Open</ContextMenuItem></ContextMenuGroup><ContextMenuSeparator /><ContextMenuItem disabled>Unavailable</ContextMenuItem></ContextMenuContent></ContextMenu>);
+ * }
+ * ```
+ */
 declare const ContextMenuShortcut: React.ForwardRefExoticComponent<Omit<React.DetailedHTMLProps<React.HTMLAttributes<HTMLSpanElement>, HTMLSpanElement>, "ref"> & React.RefAttributes<HTMLSpanElement>>;
 export { ContextMenu, ContextMenuTrigger, ContextMenuContent, ContextMenuItem, ContextMenuCheckboxItem, ContextMenuRadioItem, ContextMenuLabel, ContextMenuSeparator, ContextMenuShortcut, ContextMenuGroup, ContextMenuPortal, ContextMenuSub, ContextMenuSubContent, ContextMenuSubTrigger, ContextMenuRadioGroup, };