@alneas/appkit-react 0.1.0 → 0.3.0

package/dist/ui/components/ui/menubar.d.cts

@@ -3,74 +3,278 @@ import { Menubar as MenubarPrimitive } from '@base-ui/react/menubar';
 import { DropdownMenu, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger } from './dropdown-menu.cjs';
 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 Menubar composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Place each trigger/content pair inside MenubarMenu under Menubar. Menubar uses the Base UI Menubar root and DropdownMenu wrappers for menus; these supply popup context. Items/labels/radio/submenu parts require the corresponding menu/group contexts. Shortcut text does not register handlers; actions belong to the host.
+ * @example
+ * ```tsx
+ * import { Menubar, MenubarMenu, MenubarTrigger, MenubarContent, MenubarItem } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<Menubar><MenubarMenu><MenubarTrigger>File</MenubarTrigger><MenubarContent><MenubarItem>Open</MenubarItem></MenubarContent></MenubarMenu></Menubar>);
+ * }
+ * ```
  */
 declare function Menubar({ className, ...props }: MenubarPrimitive.Props): React.JSX.Element;
 /**
- * メニューバー内の個々のメニューを管理するコンポーネント。
+ * Provides one dropdown-menu root within a menubar.
+ * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling.
+ * @returns The rendered MenubarMenu composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Place each trigger/content pair inside MenubarMenu under Menubar. Menubar uses the Base UI Menubar root and DropdownMenu wrappers for menus; these supply popup context. Items/labels/radio/submenu parts require the corresponding menu/group contexts. Shortcut text does not register handlers; actions belong to the host.
+ * @example
+ * ```tsx
+ * import { Menubar, MenubarMenu, MenubarTrigger, MenubarContent, MenubarItem } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<Menubar><MenubarMenu><MenubarTrigger>File</MenubarTrigger><MenubarContent><MenubarItem>Open</MenubarItem></MenubarContent></MenubarMenu></Menubar>);
+ * }
+ * ```
  */
 declare function MenubarMenu({ ...props }: React.ComponentProps<typeof DropdownMenu>): React.JSX.Element;
 /**
- * メニュー項目をグループ化するためのコンポーネント。
+ * 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 MenubarGroup composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Place each trigger/content pair inside MenubarMenu under Menubar. Menubar uses the Base UI Menubar root and DropdownMenu wrappers for menus; these supply popup context. Items/labels/radio/submenu parts require the corresponding menu/group contexts. Shortcut text does not register handlers; actions belong to the host.
+ * @example
+ * ```tsx
+ * import { Menubar, MenubarMenu, MenubarTrigger, MenubarContent, MenubarItem } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<Menubar><MenubarMenu><MenubarTrigger>File</MenubarTrigger><MenubarContent><MenubarItem>Open</MenubarItem></MenubarContent></MenubarMenu></Menubar>);
+ * }
+ * ```
  */
 declare function MenubarGroup({ ...props }: React.ComponentProps<typeof DropdownMenuGroup>): React.JSX.Element;
 /**
- * メニューバーのメニュー項目をポータル経由でレンダリングするためのコンポーネント。
+ * 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 MenubarPortal composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Place each trigger/content pair inside MenubarMenu under Menubar. Menubar uses the Base UI Menubar root and DropdownMenu wrappers for menus; these supply popup context. Items/labels/radio/submenu parts require the corresponding menu/group contexts. Shortcut text does not register handlers; actions belong to the host.
+ * @example
+ * ```tsx
+ * import { Menubar, MenubarMenu, MenubarTrigger, MenubarContent, MenubarItem } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<Menubar><MenubarMenu><MenubarTrigger>File</MenubarTrigger><MenubarContent><MenubarItem>Open</MenubarItem></MenubarContent></MenubarMenu></Menubar>);
+ * }
+ * ```
  */
 declare function MenubarPortal({ ...props }: React.ComponentProps<typeof DropdownMenuPortal>): 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 MenubarTrigger composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Place each trigger/content pair inside MenubarMenu under Menubar. Menubar uses the Base UI Menubar root and DropdownMenu wrappers for menus; these supply popup context. Items/labels/radio/submenu parts require the corresponding menu/group contexts. Shortcut text does not register handlers; actions belong to the host.
+ * @example
+ * ```tsx
+ * import { Menubar, MenubarMenu, MenubarTrigger, MenubarContent, MenubarItem } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<Menubar><MenubarMenu><MenubarTrigger>File</MenubarTrigger><MenubarContent><MenubarItem>Open</MenubarItem></MenubarContent></MenubarMenu></Menubar>);
+ * }
+ * ```
  */
 declare function MenubarTrigger({ className, ...props }: React.ComponentProps<typeof DropdownMenuTrigger>): React.JSX.Element;
 /**
- * メニューバーのトリガーによって展開されるコンテンツのコンテナ。
+ * 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, sideOffset=8.
+ * @returns The rendered MenubarContent composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Place each trigger/content pair inside MenubarMenu under Menubar. Menubar uses the Base UI Menubar root and DropdownMenu wrappers for menus; these supply popup context. Items/labels/radio/submenu parts require the corresponding menu/group contexts. Shortcut text does not register handlers; actions belong to the host.
+ * @example
+ * ```tsx
+ * import { Menubar, MenubarMenu, MenubarTrigger, MenubarContent, MenubarItem } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<Menubar><MenubarMenu><MenubarTrigger>File</MenubarTrigger><MenubarContent><MenubarItem>Open</MenubarItem></MenubarContent></MenubarMenu></Menubar>);
+ * }
+ * ```
  */
 declare function MenubarContent({ className, align, alignOffset, sideOffset, ...props }: React.ComponentProps<typeof DropdownMenuContent>): React.JSX.Element;
 /**
- * メニュー内の個々の通常のメニュー項目。
+ * 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 MenubarItem composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Place each trigger/content pair inside MenubarMenu under Menubar. Menubar uses the Base UI Menubar root and DropdownMenu wrappers for menus; these supply popup context. Items/labels/radio/submenu parts require the corresponding menu/group contexts. Shortcut text does not register handlers; actions belong to the host.
+ * @example
+ * ```tsx
+ * import { Menubar, MenubarMenu, MenubarTrigger, MenubarContent, MenubarItem } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<Menubar><MenubarMenu><MenubarTrigger>File</MenubarTrigger><MenubarContent><MenubarItem>Open</MenubarItem></MenubarContent></MenubarMenu></Menubar>);
+ * }
+ * ```
  */
 declare function MenubarItem({ className, inset, variant, ...props }: React.ComponentProps<typeof DropdownMenuItem> & {
+    /**
+     * 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';
 }): React.JSX.Element;
 /**
- * チェックボックスの選択状態を持つメニュー項目。
+ * 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 MenubarCheckboxItem composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Place each trigger/content pair inside MenubarMenu under Menubar. Menubar uses the Base UI Menubar root and DropdownMenu wrappers for menus; these supply popup context. Items/labels/radio/submenu parts require the corresponding menu/group contexts. Shortcut text does not register handlers; actions belong to the host.
+ * @example
+ * ```tsx
+ * import { Menubar, MenubarMenu, MenubarTrigger, MenubarContent, MenubarItem } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<Menubar><MenubarMenu><MenubarTrigger>File</MenubarTrigger><MenubarContent><MenubarItem>Open</MenubarItem></MenubarContent></MenubarMenu></Menubar>);
+ * }
+ * ```
  */
 declare function MenubarCheckboxItem({ className, children, checked, ...props }: MenuPrimitive.CheckboxItem.Props): React.JSX.Element;
 /**
- * ラジオボタン形式のメニュー項目をグループ化するコンポーネント。
+ * 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 MenubarRadioGroup composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Place each trigger/content pair inside MenubarMenu under Menubar. Menubar uses the Base UI Menubar root and DropdownMenu wrappers for menus; these supply popup context. Items/labels/radio/submenu parts require the corresponding menu/group contexts. Shortcut text does not register handlers; actions belong to the host.
+ * @example
+ * ```tsx
+ * import { Menubar, MenubarMenu, MenubarTrigger, MenubarContent, MenubarItem } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<Menubar><MenubarMenu><MenubarTrigger>File</MenubarTrigger><MenubarContent><MenubarItem>Open</MenubarItem></MenubarContent></MenubarMenu></Menubar>);
+ * }
+ * ```
  */
 declare function MenubarRadioGroup({ ...props }: React.ComponentProps<typeof DropdownMenuRadioGroup>): React.JSX.Element;
 /**
- * 単一選択（ラジオ）形式のメニュー項目。
+ * 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 MenubarRadioItem composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Place each trigger/content pair inside MenubarMenu under Menubar. Menubar uses the Base UI Menubar root and DropdownMenu wrappers for menus; these supply popup context. Items/labels/radio/submenu parts require the corresponding menu/group contexts. Shortcut text does not register handlers; actions belong to the host.
+ * @example
+ * ```tsx
+ * import { Menubar, MenubarMenu, MenubarTrigger, MenubarContent, MenubarItem } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<Menubar><MenubarMenu><MenubarTrigger>File</MenubarTrigger><MenubarContent><MenubarItem>Open</MenubarItem></MenubarContent></MenubarMenu></Menubar>);
+ * }
+ * ```
  */
 declare function MenubarRadioItem({ className, children, ...props }: MenuPrimitive.RadioItem.Props): React.JSX.Element;
 /**
- * メニュー内のヘッダーや見出しを定義するラベルコンポーネント。
+ * 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 MenubarLabel composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Place each trigger/content pair inside MenubarMenu under Menubar. Menubar uses the Base UI Menubar root and DropdownMenu wrappers for menus; these supply popup context. Items/labels/radio/submenu parts require the corresponding menu/group contexts. Shortcut text does not register handlers; actions belong to the host.
+ * @example
+ * ```tsx
+ * import { Menubar, MenubarMenu, MenubarTrigger, MenubarContent, MenubarItem } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<Menubar><MenubarMenu><MenubarTrigger>File</MenubarTrigger><MenubarContent><MenubarItem>Open</MenubarItem></MenubarContent></MenubarMenu></Menubar>);
+ * }
+ * ```
  */
 declare function MenubarLabel({ className, inset, ...props }: React.ComponentProps<typeof DropdownMenuLabel> & {
+    /**
+     * Adds left inset spacing when true; omitted/false uses normal alignment.
+     */
     inset?: boolean;
 }): React.JSX.Element;
 /**
- * メニュー項目を区切るためのセパレーター（区切り線）。
+ * 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 MenubarSeparator composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Place each trigger/content pair inside MenubarMenu under Menubar. Menubar uses the Base UI Menubar root and DropdownMenu wrappers for menus; these supply popup context. Items/labels/radio/submenu parts require the corresponding menu/group contexts. Shortcut text does not register handlers; actions belong to the host.
+ * @example
+ * ```tsx
+ * import { Menubar, MenubarMenu, MenubarTrigger, MenubarContent, MenubarItem } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<Menubar><MenubarMenu><MenubarTrigger>File</MenubarTrigger><MenubarContent><MenubarItem>Open</MenubarItem></MenubarContent></MenubarMenu></Menubar>);
+ * }
+ * ```
  */
 declare function MenubarSeparator({ className, ...props }: React.ComponentProps<typeof DropdownMenuSeparator>): React.JSX.Element;
 /**
- * メニューアイテムの右側に表示されるキーボードショートカット用のコンポーネント。
+ * 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 MenubarShortcut composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Place each trigger/content pair inside MenubarMenu under Menubar. Menubar uses the Base UI Menubar root and DropdownMenu wrappers for menus; these supply popup context. Items/labels/radio/submenu parts require the corresponding menu/group contexts. Shortcut text does not register handlers; actions belong to the host.
+ * @example
+ * ```tsx
+ * import { Menubar, MenubarMenu, MenubarTrigger, MenubarContent, MenubarItem } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<Menubar><MenubarMenu><MenubarTrigger>File</MenubarTrigger><MenubarContent><MenubarItem>Open</MenubarItem></MenubarContent></MenubarMenu></Menubar>);
+ * }
+ * ```
  */
 declare function MenubarShortcut({ className, ...props }: React.ComponentProps<typeof DropdownMenuShortcut>): React.JSX.Element;
 /**
- * サブメニュー（入れ子にされたメニュー）を定義するためのコンポーネント。
+ * 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 MenubarSub composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Place each trigger/content pair inside MenubarMenu under Menubar. Menubar uses the Base UI Menubar root and DropdownMenu wrappers for menus; these supply popup context. Items/labels/radio/submenu parts require the corresponding menu/group contexts. Shortcut text does not register handlers; actions belong to the host.
+ * @example
+ * ```tsx
+ * import { Menubar, MenubarMenu, MenubarTrigger, MenubarContent, MenubarItem } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<Menubar><MenubarMenu><MenubarTrigger>File</MenubarTrigger><MenubarContent><MenubarItem>Open</MenubarItem></MenubarContent></MenubarMenu></Menubar>);
+ * }
+ * ```
  */
 declare function MenubarSub({ ...props }: React.ComponentProps<typeof DropdownMenuSub>): React.JSX.Element;
 /**
- * サブメニューを展開するためのトリガー項目。
+ * 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 MenubarSubTrigger composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Place each trigger/content pair inside MenubarMenu under Menubar. Menubar uses the Base UI Menubar root and DropdownMenu wrappers for menus; these supply popup context. Items/labels/radio/submenu parts require the corresponding menu/group contexts. Shortcut text does not register handlers; actions belong to the host.
+ * @example
+ * ```tsx
+ * import { Menubar, MenubarMenu, MenubarTrigger, MenubarContent, MenubarItem } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<Menubar><MenubarMenu><MenubarTrigger>File</MenubarTrigger><MenubarContent><MenubarItem>Open</MenubarItem></MenubarContent></MenubarMenu></Menubar>);
+ * }
+ * ```
  */
 declare function MenubarSubTrigger({ className, inset, ...props }: React.ComponentProps<typeof DropdownMenuSubTrigger> & {
+    /**
+     * Adds left inset spacing when true; omitted/false uses normal alignment.
+     */
     inset?: boolean;
 }): React.JSX.Element;
 /**
- * サブメニューの中に表示されるコンテンツのコンテナ。
+ * 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 MenubarSubContent composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Place each trigger/content pair inside MenubarMenu under Menubar. Menubar uses the Base UI Menubar root and DropdownMenu wrappers for menus; these supply popup context. Items/labels/radio/submenu parts require the corresponding menu/group contexts. Shortcut text does not register handlers; actions belong to the host.
+ * @example
+ * ```tsx
+ * import { Menubar, MenubarMenu, MenubarTrigger, MenubarContent, MenubarItem } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<Menubar><MenubarMenu><MenubarTrigger>File</MenubarTrigger><MenubarContent><MenubarItem>Open</MenubarItem></MenubarContent></MenubarMenu></Menubar>);
+ * }
+ * ```
  */
 declare function MenubarSubContent({ className, ...props }: React.ComponentProps<typeof DropdownMenuSubContent>): React.JSX.Element;
 export { Menubar, MenubarPortal, MenubarMenu, MenubarTrigger, MenubarContent, MenubarGroup, MenubarSeparator, MenubarLabel, MenubarItem, MenubarShortcut, MenubarCheckboxItem, MenubarRadioGroup, MenubarRadioItem, MenubarSub, MenubarSubTrigger, MenubarSubContent, };

package/dist/ui/components/ui/menubar.d.ts

@@ -3,74 +3,278 @@ import { Menubar as MenubarPrimitive } from '@base-ui/react/menubar';
 import { DropdownMenu, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger } from './dropdown-menu.js';
 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 Menubar composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Place each trigger/content pair inside MenubarMenu under Menubar. Menubar uses the Base UI Menubar root and DropdownMenu wrappers for menus; these supply popup context. Items/labels/radio/submenu parts require the corresponding menu/group contexts. Shortcut text does not register handlers; actions belong to the host.
+ * @example
+ * ```tsx
+ * import { Menubar, MenubarMenu, MenubarTrigger, MenubarContent, MenubarItem } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<Menubar><MenubarMenu><MenubarTrigger>File</MenubarTrigger><MenubarContent><MenubarItem>Open</MenubarItem></MenubarContent></MenubarMenu></Menubar>);
+ * }
+ * ```
  */
 declare function Menubar({ className, ...props }: MenubarPrimitive.Props): React.JSX.Element;
 /**
- * メニューバー内の個々のメニューを管理するコンポーネント。
+ * Provides one dropdown-menu root within a menubar.
+ * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling.
+ * @returns The rendered MenubarMenu composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Place each trigger/content pair inside MenubarMenu under Menubar. Menubar uses the Base UI Menubar root and DropdownMenu wrappers for menus; these supply popup context. Items/labels/radio/submenu parts require the corresponding menu/group contexts. Shortcut text does not register handlers; actions belong to the host.
+ * @example
+ * ```tsx
+ * import { Menubar, MenubarMenu, MenubarTrigger, MenubarContent, MenubarItem } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<Menubar><MenubarMenu><MenubarTrigger>File</MenubarTrigger><MenubarContent><MenubarItem>Open</MenubarItem></MenubarContent></MenubarMenu></Menubar>);
+ * }
+ * ```
  */
 declare function MenubarMenu({ ...props }: React.ComponentProps<typeof DropdownMenu>): React.JSX.Element;
 /**
- * メニュー項目をグループ化するためのコンポーネント。
+ * 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 MenubarGroup composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Place each trigger/content pair inside MenubarMenu under Menubar. Menubar uses the Base UI Menubar root and DropdownMenu wrappers for menus; these supply popup context. Items/labels/radio/submenu parts require the corresponding menu/group contexts. Shortcut text does not register handlers; actions belong to the host.
+ * @example
+ * ```tsx
+ * import { Menubar, MenubarMenu, MenubarTrigger, MenubarContent, MenubarItem } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<Menubar><MenubarMenu><MenubarTrigger>File</MenubarTrigger><MenubarContent><MenubarItem>Open</MenubarItem></MenubarContent></MenubarMenu></Menubar>);
+ * }
+ * ```
  */
 declare function MenubarGroup({ ...props }: React.ComponentProps<typeof DropdownMenuGroup>): React.JSX.Element;
 /**
- * メニューバーのメニュー項目をポータル経由でレンダリングするためのコンポーネント。
+ * 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 MenubarPortal composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Place each trigger/content pair inside MenubarMenu under Menubar. Menubar uses the Base UI Menubar root and DropdownMenu wrappers for menus; these supply popup context. Items/labels/radio/submenu parts require the corresponding menu/group contexts. Shortcut text does not register handlers; actions belong to the host.
+ * @example
+ * ```tsx
+ * import { Menubar, MenubarMenu, MenubarTrigger, MenubarContent, MenubarItem } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<Menubar><MenubarMenu><MenubarTrigger>File</MenubarTrigger><MenubarContent><MenubarItem>Open</MenubarItem></MenubarContent></MenubarMenu></Menubar>);
+ * }
+ * ```
  */
 declare function MenubarPortal({ ...props }: React.ComponentProps<typeof DropdownMenuPortal>): 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 MenubarTrigger composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Place each trigger/content pair inside MenubarMenu under Menubar. Menubar uses the Base UI Menubar root and DropdownMenu wrappers for menus; these supply popup context. Items/labels/radio/submenu parts require the corresponding menu/group contexts. Shortcut text does not register handlers; actions belong to the host.
+ * @example
+ * ```tsx
+ * import { Menubar, MenubarMenu, MenubarTrigger, MenubarContent, MenubarItem } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<Menubar><MenubarMenu><MenubarTrigger>File</MenubarTrigger><MenubarContent><MenubarItem>Open</MenubarItem></MenubarContent></MenubarMenu></Menubar>);
+ * }
+ * ```
  */
 declare function MenubarTrigger({ className, ...props }: React.ComponentProps<typeof DropdownMenuTrigger>): React.JSX.Element;
 /**
- * メニューバーのトリガーによって展開されるコンテンツのコンテナ。
+ * 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, sideOffset=8.
+ * @returns The rendered MenubarContent composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Place each trigger/content pair inside MenubarMenu under Menubar. Menubar uses the Base UI Menubar root and DropdownMenu wrappers for menus; these supply popup context. Items/labels/radio/submenu parts require the corresponding menu/group contexts. Shortcut text does not register handlers; actions belong to the host.
+ * @example
+ * ```tsx
+ * import { Menubar, MenubarMenu, MenubarTrigger, MenubarContent, MenubarItem } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<Menubar><MenubarMenu><MenubarTrigger>File</MenubarTrigger><MenubarContent><MenubarItem>Open</MenubarItem></MenubarContent></MenubarMenu></Menubar>);
+ * }
+ * ```
  */
 declare function MenubarContent({ className, align, alignOffset, sideOffset, ...props }: React.ComponentProps<typeof DropdownMenuContent>): React.JSX.Element;
 /**
- * メニュー内の個々の通常のメニュー項目。
+ * 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 MenubarItem composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Place each trigger/content pair inside MenubarMenu under Menubar. Menubar uses the Base UI Menubar root and DropdownMenu wrappers for menus; these supply popup context. Items/labels/radio/submenu parts require the corresponding menu/group contexts. Shortcut text does not register handlers; actions belong to the host.
+ * @example
+ * ```tsx
+ * import { Menubar, MenubarMenu, MenubarTrigger, MenubarContent, MenubarItem } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<Menubar><MenubarMenu><MenubarTrigger>File</MenubarTrigger><MenubarContent><MenubarItem>Open</MenubarItem></MenubarContent></MenubarMenu></Menubar>);
+ * }
+ * ```
  */
 declare function MenubarItem({ className, inset, variant, ...props }: React.ComponentProps<typeof DropdownMenuItem> & {
+    /**
+     * 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';
 }): React.JSX.Element;
 /**
- * チェックボックスの選択状態を持つメニュー項目。
+ * 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 MenubarCheckboxItem composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Place each trigger/content pair inside MenubarMenu under Menubar. Menubar uses the Base UI Menubar root and DropdownMenu wrappers for menus; these supply popup context. Items/labels/radio/submenu parts require the corresponding menu/group contexts. Shortcut text does not register handlers; actions belong to the host.
+ * @example
+ * ```tsx
+ * import { Menubar, MenubarMenu, MenubarTrigger, MenubarContent, MenubarItem } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<Menubar><MenubarMenu><MenubarTrigger>File</MenubarTrigger><MenubarContent><MenubarItem>Open</MenubarItem></MenubarContent></MenubarMenu></Menubar>);
+ * }
+ * ```
  */
 declare function MenubarCheckboxItem({ className, children, checked, ...props }: MenuPrimitive.CheckboxItem.Props): React.JSX.Element;
 /**
- * ラジオボタン形式のメニュー項目をグループ化するコンポーネント。
+ * 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 MenubarRadioGroup composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Place each trigger/content pair inside MenubarMenu under Menubar. Menubar uses the Base UI Menubar root and DropdownMenu wrappers for menus; these supply popup context. Items/labels/radio/submenu parts require the corresponding menu/group contexts. Shortcut text does not register handlers; actions belong to the host.
+ * @example
+ * ```tsx
+ * import { Menubar, MenubarMenu, MenubarTrigger, MenubarContent, MenubarItem } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<Menubar><MenubarMenu><MenubarTrigger>File</MenubarTrigger><MenubarContent><MenubarItem>Open</MenubarItem></MenubarContent></MenubarMenu></Menubar>);
+ * }
+ * ```
  */
 declare function MenubarRadioGroup({ ...props }: React.ComponentProps<typeof DropdownMenuRadioGroup>): React.JSX.Element;
 /**
- * 単一選択（ラジオ）形式のメニュー項目。
+ * 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 MenubarRadioItem composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Place each trigger/content pair inside MenubarMenu under Menubar. Menubar uses the Base UI Menubar root and DropdownMenu wrappers for menus; these supply popup context. Items/labels/radio/submenu parts require the corresponding menu/group contexts. Shortcut text does not register handlers; actions belong to the host.
+ * @example
+ * ```tsx
+ * import { Menubar, MenubarMenu, MenubarTrigger, MenubarContent, MenubarItem } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<Menubar><MenubarMenu><MenubarTrigger>File</MenubarTrigger><MenubarContent><MenubarItem>Open</MenubarItem></MenubarContent></MenubarMenu></Menubar>);
+ * }
+ * ```
  */
 declare function MenubarRadioItem({ className, children, ...props }: MenuPrimitive.RadioItem.Props): React.JSX.Element;
 /**
- * メニュー内のヘッダーや見出しを定義するラベルコンポーネント。
+ * 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 MenubarLabel composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Place each trigger/content pair inside MenubarMenu under Menubar. Menubar uses the Base UI Menubar root and DropdownMenu wrappers for menus; these supply popup context. Items/labels/radio/submenu parts require the corresponding menu/group contexts. Shortcut text does not register handlers; actions belong to the host.
+ * @example
+ * ```tsx
+ * import { Menubar, MenubarMenu, MenubarTrigger, MenubarContent, MenubarItem } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<Menubar><MenubarMenu><MenubarTrigger>File</MenubarTrigger><MenubarContent><MenubarItem>Open</MenubarItem></MenubarContent></MenubarMenu></Menubar>);
+ * }
+ * ```
  */
 declare function MenubarLabel({ className, inset, ...props }: React.ComponentProps<typeof DropdownMenuLabel> & {
+    /**
+     * Adds left inset spacing when true; omitted/false uses normal alignment.
+     */
     inset?: boolean;
 }): React.JSX.Element;
 /**
- * メニュー項目を区切るためのセパレーター（区切り線）。
+ * 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 MenubarSeparator composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Place each trigger/content pair inside MenubarMenu under Menubar. Menubar uses the Base UI Menubar root and DropdownMenu wrappers for menus; these supply popup context. Items/labels/radio/submenu parts require the corresponding menu/group contexts. Shortcut text does not register handlers; actions belong to the host.
+ * @example
+ * ```tsx
+ * import { Menubar, MenubarMenu, MenubarTrigger, MenubarContent, MenubarItem } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<Menubar><MenubarMenu><MenubarTrigger>File</MenubarTrigger><MenubarContent><MenubarItem>Open</MenubarItem></MenubarContent></MenubarMenu></Menubar>);
+ * }
+ * ```
  */
 declare function MenubarSeparator({ className, ...props }: React.ComponentProps<typeof DropdownMenuSeparator>): React.JSX.Element;
 /**
- * メニューアイテムの右側に表示されるキーボードショートカット用のコンポーネント。
+ * 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 MenubarShortcut composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Place each trigger/content pair inside MenubarMenu under Menubar. Menubar uses the Base UI Menubar root and DropdownMenu wrappers for menus; these supply popup context. Items/labels/radio/submenu parts require the corresponding menu/group contexts. Shortcut text does not register handlers; actions belong to the host.
+ * @example
+ * ```tsx
+ * import { Menubar, MenubarMenu, MenubarTrigger, MenubarContent, MenubarItem } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<Menubar><MenubarMenu><MenubarTrigger>File</MenubarTrigger><MenubarContent><MenubarItem>Open</MenubarItem></MenubarContent></MenubarMenu></Menubar>);
+ * }
+ * ```
  */
 declare function MenubarShortcut({ className, ...props }: React.ComponentProps<typeof DropdownMenuShortcut>): React.JSX.Element;
 /**
- * サブメニュー（入れ子にされたメニュー）を定義するためのコンポーネント。
+ * 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 MenubarSub composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Place each trigger/content pair inside MenubarMenu under Menubar. Menubar uses the Base UI Menubar root and DropdownMenu wrappers for menus; these supply popup context. Items/labels/radio/submenu parts require the corresponding menu/group contexts. Shortcut text does not register handlers; actions belong to the host.
+ * @example
+ * ```tsx
+ * import { Menubar, MenubarMenu, MenubarTrigger, MenubarContent, MenubarItem } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<Menubar><MenubarMenu><MenubarTrigger>File</MenubarTrigger><MenubarContent><MenubarItem>Open</MenubarItem></MenubarContent></MenubarMenu></Menubar>);
+ * }
+ * ```
  */
 declare function MenubarSub({ ...props }: React.ComponentProps<typeof DropdownMenuSub>): React.JSX.Element;
 /**
- * サブメニューを展開するためのトリガー項目。
+ * 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 MenubarSubTrigger composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Place each trigger/content pair inside MenubarMenu under Menubar. Menubar uses the Base UI Menubar root and DropdownMenu wrappers for menus; these supply popup context. Items/labels/radio/submenu parts require the corresponding menu/group contexts. Shortcut text does not register handlers; actions belong to the host.
+ * @example
+ * ```tsx
+ * import { Menubar, MenubarMenu, MenubarTrigger, MenubarContent, MenubarItem } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<Menubar><MenubarMenu><MenubarTrigger>File</MenubarTrigger><MenubarContent><MenubarItem>Open</MenubarItem></MenubarContent></MenubarMenu></Menubar>);
+ * }
+ * ```
  */
 declare function MenubarSubTrigger({ className, inset, ...props }: React.ComponentProps<typeof DropdownMenuSubTrigger> & {
+    /**
+     * Adds left inset spacing when true; omitted/false uses normal alignment.
+     */
     inset?: boolean;
 }): React.JSX.Element;
 /**
- * サブメニューの中に表示されるコンテンツのコンテナ。
+ * 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 MenubarSubContent composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Place each trigger/content pair inside MenubarMenu under Menubar. Menubar uses the Base UI Menubar root and DropdownMenu wrappers for menus; these supply popup context. Items/labels/radio/submenu parts require the corresponding menu/group contexts. Shortcut text does not register handlers; actions belong to the host.
+ * @example
+ * ```tsx
+ * import { Menubar, MenubarMenu, MenubarTrigger, MenubarContent, MenubarItem } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<Menubar><MenubarMenu><MenubarTrigger>File</MenubarTrigger><MenubarContent><MenubarItem>Open</MenubarItem></MenubarContent></MenubarMenu></Menubar>);
+ * }
+ * ```
  */
 declare function MenubarSubContent({ className, ...props }: React.ComponentProps<typeof DropdownMenuSubContent>): React.JSX.Element;
 export { Menubar, MenubarPortal, MenubarMenu, MenubarTrigger, MenubarContent, MenubarGroup, MenubarSeparator, MenubarLabel, MenubarItem, MenubarShortcut, MenubarCheckboxItem, MenubarRadioGroup, MenubarRadioItem, MenubarSub, MenubarSubTrigger, MenubarSubContent, };