@accelint/design-toolkit 9.2.0 → 9.4.0

package/dist/components/list/item.js.map

@@ -1 +1 @@
-{"version":3,"file":"item.js","names":["children"],"sources":["../../../src/components/list/item.tsx"],"sourcesContent":["/*\n * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n'use client';\n\nimport 'client-only';\nimport { clsx } from '@accelint/design-foundation/lib/utils';\nimport { composeRenderProps, GridListItem } from 'react-aria-components';\nimport { ListItemTitle } from './item-title';\nimport styles from './styles.module.css';\nimport type { ListItemProps } from './types';\n\n/**\n * ListItem - Individual selectable item within a List\n *\n * Represents a single row in the grid list with full interaction support including\n * selection, hover states, and keyboard navigation. Can contain icons, content,\n * indicators, and action elements. If children is a string, it will be automatically\n * wrapped in a ListItemTitle.\n *\n * @example\n * <ListItem textValue=\"User item\">\n *   <Icon><Avatar /></Icon>\n *   <ListItemContent>\n *     <ListItemTitle>John Doe</ListItemTitle>\n *     <ListItemDescription>Software Engineer</ListItemDescription>\n *   </ListItemContent>\n * </ListItem>\n */\nexport function ListItem<T extends object>({\n  children,\n  classNames,\n  textValue = typeof children === 'string' ? children : '',\n  ...rest\n}: ListItemProps<T>) {\n  return (\n    <GridListItem\n      className={composeRenderProps(classNames?.item, (className) =>\n        clsx('group/list-item', styles.item, className),\n      )}\n      textValue={textValue}\n      {...rest}\n    >\n      {composeRenderProps(children, (children) =>\n        typeof children === 'string' ? (\n          <ListItemTitle>{children}</ListItemTitle>\n        ) : (\n          children\n        ),\n      )}\n    </GridListItem>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAqCA,SAAgB,SAA2B,EACzC,UACA,YACA,YAAY,OAAO,aAAa,WAAW,WAAW,IACtD,GAAG,QACgB;AACnB,QACE,oBAAC;EACC,WAAW,mBAAmB,YAAY,OAAO,cAC/C,KAAK,mBAAmB,OAAO,MAAM,UAAU,CAChD;EACU;EACX,GAAI;YAEH,mBAAmB,WAAW,eAC7B,OAAOA,eAAa,WAClB,oBAAC,2BAAeA,aAAyB,GAEzCA,WAEH;GACY"}
+{"version":3,"file":"item.js","names":["children"],"sources":["../../../src/components/list/item.tsx"],"sourcesContent":["/*\n * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n'use client';\n\nimport 'client-only';\nimport { clsx } from '@accelint/design-foundation/lib/utils';\nimport { composeRenderProps, GridListItem } from 'react-aria-components';\nimport { ListItemTitle } from './item-title';\nimport styles from './styles.module.css';\nimport type { ListItemProps } from './types';\n\n/**\n * ListItem - Individual selectable item within a List\n *\n * Represents a single row in the grid list with full interaction support including\n * selection, hover states, and keyboard navigation. Can contain icons, content,\n * indicators, and action elements. If children is a string, it will be automatically\n * wrapped in a ListItemTitle.\n *\n * @example\n * ```tsx\n * <ListItem textValue=\"User item\">\n *   <Icon><Avatar /></Icon>\n *   <ListItemContent>\n *     <ListItemTitle>John Doe</ListItemTitle>\n *     <ListItemDescription>Software Engineer</ListItemDescription>\n *   </ListItemContent>\n * </ListItem>\n * ```\n *\n * @param props - {@link ListItemProps}\n * @param props.children - Content to render inside the list item.\n * @param props.classNames - CSS class names for list item elements.\n * @param props.textValue - Accessible text value for the item.\n * @returns The rendered ListItem component.\n */\nexport function ListItem<T extends object>({\n  children,\n  classNames,\n  textValue = typeof children === 'string' ? children : '',\n  ...rest\n}: ListItemProps<T>) {\n  return (\n    <GridListItem\n      className={composeRenderProps(classNames?.item, (className) =>\n        clsx('group/list-item', styles.item, className),\n      )}\n      textValue={textValue}\n      {...rest}\n    >\n      {composeRenderProps(children, (children) =>\n        typeof children === 'string' ? (\n          <ListItemTitle>{children}</ListItemTitle>\n        ) : (\n          children\n        ),\n      )}\n    </GridListItem>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6CA,SAAgB,SAA2B,EACzC,UACA,YACA,YAAY,OAAO,aAAa,WAAW,WAAW,IACtD,GAAG,QACgB;AACnB,QACE,oBAAC;EACC,WAAW,mBAAmB,YAAY,OAAO,cAC/C,KAAK,mBAAmB,OAAO,MAAM,UAAU,CAChD;EACU;EACX,GAAI;YAEH,mBAAmB,WAAW,eAC7B,OAAOA,eAAa,WAClB,oBAAC,2BAAeA,aAAyB,GAEzCA,WAEH;GACY"}

package/dist/components/list/types.d.ts

@@ -15,17 +15,39 @@ import { ComponentPropsWithRef, RefAttributes } from "react";
 import { GridListItemProps, GridListProps } from "react-aria-components";
 
 //#region src/components/list/types.d.ts
+/**
+ * Visual density variant for list items.
+ */
 type ListItemVariant = 'cozy' | 'compact';
+/**
+ * Props for the ListItem component.
+ */
 type ListItemProps<T extends object> = Omit<GridListItemProps<T>, 'className'> & {
+  /** CSS class names for list item elements. */
   classNames?: {
+    /** Class name for the list item container. */
     item?: GridListItemProps['className'];
+    /** Class name for the list item icon. */
     icon?: IconProps['className'];
   };
 };
+/**
+ * Props for the ListItemTitle component.
+ */
 type ListItemTitleProps = ComponentPropsWithRef<'div'>;
+/**
+ * Props for the ListItemDescription component.
+ */
 type ListItemDescriptionProps = ComponentPropsWithRef<'div'>;
+/**
+ * Props for the ListItemContent component.
+ */
 type ListItemContentProps = ComponentPropsWithRef<'div'>;
+/**
+ * Props for the List component.
+ */
 type ListProps<T> = Omit<GridListProps<T>, 'orientation' | 'layout' | 'dragAndDropHooks'> & RefAttributes<HTMLDivElement> & {
+  /** Visual density variant for list items. */
   variant?: ListItemVariant;
 };
 //#endregion

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

@@ -12,11 +12,15 @@
 
 import { MenuProps as MenuProps$1 } from "./types.js";
 import "client-only";
-import * as react31 from "react";
+import * as react33 from "react";
 import { ContextValue } from "react-aria-components";
 
 //#region src/components/menu/context.d.ts
-declare const MenuContext: react31.Context<ContextValue<MenuProps$1<unknown>, HTMLDivElement>>;
+/**
+ * Context for sharing Menu props across component tree.
+ * Used internally by Menu subcomponents for variant and state coordination.
+ */
+declare const MenuContext: react33.Context<ContextValue<MenuProps$1<unknown>, HTMLDivElement>>;
 //#endregion
 export { MenuContext };
 //# sourceMappingURL=context.d.ts.map

package/dist/components/menu/context.js

@@ -17,6 +17,10 @@ import "client-only";
 import { createContext } from "react";
 
 //#region src/components/menu/context.tsx
+/**
+* Context for sharing Menu props across component tree.
+* Used internally by Menu subcomponents for variant and state coordination.
+*/
 const MenuContext = createContext(null);
 
 //#endregion

package/dist/components/menu/context.js.map

@@ -1 +1 @@
-{"version":3,"file":"context.js","names":[],"sources":["../../../src/components/menu/context.tsx"],"sourcesContent":["/*\n * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\n'use client';\n\nimport 'client-only';\nimport { createContext } from 'react';\nimport type { ContextValue } from 'react-aria-components';\nimport type { MenuProps } from './types';\n\nexport const MenuContext =\n  createContext<ContextValue<MenuProps<unknown>, HTMLDivElement>>(null);\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAmBA,MAAa,cACX,cAAgE,KAAK"}
+{"version":3,"file":"context.js","names":[],"sources":["../../../src/components/menu/context.tsx"],"sourcesContent":["/*\n * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\n'use client';\n\nimport 'client-only';\nimport { createContext } from 'react';\nimport type { ContextValue } from 'react-aria-components';\nimport type { MenuProps } from './types';\n\n/**\n * Context for sharing Menu props across component tree.\n * Used internally by Menu subcomponents for variant and state coordination.\n */\nexport const MenuContext =\n  createContext<ContextValue<MenuProps<unknown>, HTMLDivElement>>(null);\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AAuBA,MAAa,cACX,cAAgE,KAAK"}

package/dist/components/menu/index.d.ts

@@ -12,7 +12,7 @@
 
 import { MenuProps } from "./types.js";
 import "client-only";
-import * as react_jsx_runtime129 from "react/jsx-runtime";
+import * as react_jsx_runtime180 from "react/jsx-runtime";
 
 //#region src/components/menu/index.d.ts
 
@@ -28,6 +28,7 @@ import * as react_jsx_runtime129 from "react/jsx-runtime";
  * other popover settings.
  *
  * @example
+ * ```tsx
  * // Basic menu with trigger
  * <MenuTrigger>
  *   <Button>Open Menu</Button>
@@ -37,8 +38,10 @@ import * as react_jsx_runtime129 from "react/jsx-runtime";
  *     <MenuItem>Delete</MenuItem>
  *   </Menu>
  * </MenuTrigger>
- *
+ * ```
+
  * @example
+ * ```tsx
  * // Menu with custom placement
  * <MenuTrigger>
  *   <Button>Open Menu</Button>
@@ -47,8 +50,10 @@ import * as react_jsx_runtime129 from "react/jsx-runtime";
  *     <MenuItem>Copy</MenuItem>
  *   </Menu>
  * </MenuTrigger>
+ * ```
  *
  * @example
+ * ```tsx
  * // Menu with action handler
  * <MenuTrigger>
  *   <Button>Actions</Button>
@@ -57,8 +62,10 @@ import * as react_jsx_runtime129 from "react/jsx-runtime";
  *     <MenuItem id="delete">Delete</MenuItem>
  *   </Menu>
  * </MenuTrigger>
+ * ```
  *
  * @example
+ * ```tsx
  * // Menu with sections and separators
  * <MenuTrigger>
  *   <Button>Open</Button>
@@ -73,8 +80,10 @@ import * as react_jsx_runtime129 from "react/jsx-runtime";
  *     <MenuItem>Settings</MenuItem>
  *   </Menu>
  * </MenuTrigger>
+ * ```
  *
  * @example
+ * ```tsx
  * // Menu with selection
  * <MenuTrigger>
  *   <Button>Group</Button>
@@ -83,8 +92,10 @@ import * as react_jsx_runtime129 from "react/jsx-runtime";
  *     <MenuItem>Option 2</MenuItem>
  *   </Menu>
  * </MenuTrigger>
+ * ```
  *
  * @example
+ * ```tsx
  * // Menu with submenu
  * <MenuTrigger>
  *   <Button>Actions</Button>
@@ -101,11 +112,21 @@ import * as react_jsx_runtime129 from "react/jsx-runtime";
  *     <MenuItem>Delete</MenuItem>
  *   </Menu>
  * </MenuTrigger>
+ * ```
+ *
+ * @param props - {@link MenuProps}
+ * @param props.ref - Forwarded ref to the underlying Menu element.
+ * @param props.children - Menu items and sections to render.
+ * @param props.classNames - CSS class names for menu elements.
+ * @param props.popoverProps - Props passed to the internal Popover component.
+ * @param props.selectionMode - Selection mode for menu items.
+ * @param props.variant - Visual density variant for the menu.
+ * @returns The rendered Menu component.
  */
 declare function Menu<T extends object>({
   ref,
   ...props
-}: MenuProps<T>): react_jsx_runtime129.JSX.Element;
+}: MenuProps<T>): react_jsx_runtime180.JSX.Element;
 //#endregion
 export { Menu };
 //# sourceMappingURL=index.d.ts.map

package/dist/components/menu/index.js

@@ -33,6 +33,7 @@ import styles from "./styles.module.css";
 * other popover settings.
 *
 * @example
+* ```tsx
 * // Basic menu with trigger
 * <MenuTrigger>
 *   <Button>Open Menu</Button>
@@ -42,8 +43,10 @@ import styles from "./styles.module.css";
 *     <MenuItem>Delete</MenuItem>
 *   </Menu>
 * </MenuTrigger>
-*
+* ```
+
 * @example
+* ```tsx
 * // Menu with custom placement
 * <MenuTrigger>
 *   <Button>Open Menu</Button>
@@ -52,8 +55,10 @@ import styles from "./styles.module.css";
 *     <MenuItem>Copy</MenuItem>
 *   </Menu>
 * </MenuTrigger>
+* ```
 *
 * @example
+* ```tsx
 * // Menu with action handler
 * <MenuTrigger>
 *   <Button>Actions</Button>
@@ -62,8 +67,10 @@ import styles from "./styles.module.css";
 *     <MenuItem id="delete">Delete</MenuItem>
 *   </Menu>
 * </MenuTrigger>
+* ```
 *
 * @example
+* ```tsx
 * // Menu with sections and separators
 * <MenuTrigger>
 *   <Button>Open</Button>
@@ -78,8 +85,10 @@ import styles from "./styles.module.css";
 *     <MenuItem>Settings</MenuItem>
 *   </Menu>
 * </MenuTrigger>
+* ```
 *
 * @example
+* ```tsx
 * // Menu with selection
 * <MenuTrigger>
 *   <Button>Group</Button>
@@ -88,8 +97,10 @@ import styles from "./styles.module.css";
 *     <MenuItem>Option 2</MenuItem>
 *   </Menu>
 * </MenuTrigger>
+* ```
 *
 * @example
+* ```tsx
 * // Menu with submenu
 * <MenuTrigger>
 *   <Button>Actions</Button>
@@ -106,6 +117,16 @@ import styles from "./styles.module.css";
 *     <MenuItem>Delete</MenuItem>
 *   </Menu>
 * </MenuTrigger>
+* ```
+*
+* @param props - {@link MenuProps}
+* @param props.ref - Forwarded ref to the underlying Menu element.
+* @param props.children - Menu items and sections to render.
+* @param props.classNames - CSS class names for menu elements.
+* @param props.popoverProps - Props passed to the internal Popover component.
+* @param props.selectionMode - Selection mode for menu items.
+* @param props.variant - Visual density variant for the menu.
+* @returns The rendered Menu component.
 */
 function Menu({ ref, ...props }) {
 	[props, ref] = useContextProps(props, ref ?? null, MenuContext);

package/dist/components/menu/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["AriaMenu"],"sources":["../../../src/components/menu/index.tsx"],"sourcesContent":["/*\n * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\n'use client';\n\nimport 'client-only';\nimport { clsx } from '@accelint/design-foundation/lib/utils';\nimport {\n  Menu as AriaMenu,\n  composeRenderProps,\n  Popover,\n  useContextProps,\n} from 'react-aria-components';\nimport { MenuContext } from './context';\nimport styles from './styles.module.css';\nimport type { MenuProps } from './types';\n\n/**\n * Menu - A dropdown menu component with keyboard navigation and selection\n *\n * Provides accessible dropdown menu functionality with support for single and\n * multiple selection modes. Includes sections, separators, and submenu support\n * with comprehensive keyboard navigation and ARIA compliance.\n *\n * IMPORTANT: Menu includes its own internal Popover. Do NOT wrap Menu in a\n * Popover component. Use the `popoverProps` prop to configure placement and\n * other popover settings.\n *\n * @example\n * // Basic menu with trigger\n * <MenuTrigger>\n *   <Button>Open Menu</Button>\n *   <Menu>\n *     <MenuItem>Edit</MenuItem>\n *     <MenuItem>Copy</MenuItem>\n *     <MenuItem>Delete</MenuItem>\n *   </Menu>\n * </MenuTrigger>\n *\n * @example\n * // Menu with custom placement\n * <MenuTrigger>\n *   <Button>Open Menu</Button>\n *   <Menu popoverProps={{ placement: 'top end' }}>\n *     <MenuItem>Edit</MenuItem>\n *     <MenuItem>Copy</MenuItem>\n *   </Menu>\n * </MenuTrigger>\n *\n * @example\n * // Menu with action handler\n * <MenuTrigger>\n *   <Button>Actions</Button>\n *   <Menu onAction={(key) => console.log(key)}>\n *     <MenuItem id=\"edit\">Edit</MenuItem>\n *     <MenuItem id=\"delete\">Delete</MenuItem>\n *   </Menu>\n * </MenuTrigger>\n *\n * @example\n * // Menu with sections and separators\n * <MenuTrigger>\n *   <Button>Open</Button>\n *   <Menu>\n *     <MenuSection>\n *       <MenuItem>New File</MenuItem>\n *       <MenuItem>Open File</MenuItem>\n *     </MenuSection>\n *\n *     <MenuSeparator />\n *\n *     <MenuItem>Settings</MenuItem>\n *   </Menu>\n * </MenuTrigger>\n *\n * @example\n * // Menu with selection\n * <MenuTrigger>\n *   <Button>Group</Button>\n *   <Menu selectionMode='multiple'>\n *     <MenuItem>Option 1</MenuItem>\n *     <MenuItem>Option 2</MenuItem>\n *   </Menu>\n * </MenuTrigger>\n *\n * @example\n * // Menu with submenu\n * <MenuTrigger>\n *   <Button>Actions</Button>\n *   <Menu>\n *     <MenuItem>New File</MenuItem>\n *     <MenuSubmenu>\n *       <MenuItem>Export</MenuItem>\n *       <Menu>\n *         <MenuItem>Export as PDF</MenuItem>\n *         <MenuItem>Export as CSV</MenuItem>\n *         <MenuItem>Export as JSON</MenuItem>\n *       </Menu>\n *     </MenuSubmenu>\n *     <MenuItem>Delete</MenuItem>\n *   </Menu>\n * </MenuTrigger>\n */\nexport function Menu<T extends object>({ ref, ...props }: MenuProps<T>) {\n  [props, ref] = useContextProps(props, ref ?? null, MenuContext);\n\n  const {\n    children,\n    classNames,\n    popoverProps,\n    selectionMode = 'single',\n    variant = 'cozy',\n    ...rest\n  } = props;\n\n  return (\n    <Popover\n      {...popoverProps}\n      className={composeRenderProps(classNames?.popover, (className) =>\n        clsx(styles.popover, className),\n      )}\n    >\n      <MenuContext.Provider value={{ variant }}>\n        <AriaMenu\n          {...rest}\n          ref={ref}\n          className={composeRenderProps(classNames?.menu, (className) =>\n            clsx('group/menu', styles.menu, styles[variant], className),\n          )}\n          selectionMode={selectionMode}\n        >\n          {children}\n        </AriaMenu>\n      </MenuContext.Provider>\n    </Popover>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAgHA,SAAgB,KAAuB,EAAE,KAAK,GAAG,SAAuB;AACtE,EAAC,OAAO,OAAO,gBAAgB,OAAO,OAAO,MAAM,YAAY;CAE/D,MAAM,EACJ,UACA,YACA,cACA,gBAAgB,UAChB,UAAU,QACV,GAAG,SACD;AAEJ,QACE,oBAAC;EACC,GAAI;EACJ,WAAW,mBAAmB,YAAY,UAAU,cAClD,KAAK,OAAO,SAAS,UAAU,CAChC;YAED,oBAAC,YAAY;GAAS,OAAO,EAAE,SAAS;aACtC,oBAACA;IACC,GAAI;IACC;IACL,WAAW,mBAAmB,YAAY,OAAO,cAC/C,KAAK,cAAc,OAAO,MAAM,OAAO,UAAU,UAAU,CAC5D;IACc;IAEd;KACQ;IACU;GACf"}
+{"version":3,"file":"index.js","names":["AriaMenu"],"sources":["../../../src/components/menu/index.tsx"],"sourcesContent":["/*\n * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\n'use client';\n\nimport 'client-only';\nimport { clsx } from '@accelint/design-foundation/lib/utils';\nimport {\n  Menu as AriaMenu,\n  composeRenderProps,\n  Popover,\n  useContextProps,\n} from 'react-aria-components';\nimport { MenuContext } from './context';\nimport styles from './styles.module.css';\nimport type { MenuProps } from './types';\n\n/**\n * Menu - A dropdown menu component with keyboard navigation and selection\n *\n * Provides accessible dropdown menu functionality with support for single and\n * multiple selection modes. Includes sections, separators, and submenu support\n * with comprehensive keyboard navigation and ARIA compliance.\n *\n * IMPORTANT: Menu includes its own internal Popover. Do NOT wrap Menu in a\n * Popover component. Use the `popoverProps` prop to configure placement and\n * other popover settings.\n *\n * @example\n * ```tsx\n * // Basic menu with trigger\n * <MenuTrigger>\n *   <Button>Open Menu</Button>\n *   <Menu>\n *     <MenuItem>Edit</MenuItem>\n *     <MenuItem>Copy</MenuItem>\n *     <MenuItem>Delete</MenuItem>\n *   </Menu>\n * </MenuTrigger>\n * ```\n\n * @example\n * ```tsx\n * // Menu with custom placement\n * <MenuTrigger>\n *   <Button>Open Menu</Button>\n *   <Menu popoverProps={{ placement: 'top end' }}>\n *     <MenuItem>Edit</MenuItem>\n *     <MenuItem>Copy</MenuItem>\n *   </Menu>\n * </MenuTrigger>\n * ```\n *\n * @example\n * ```tsx\n * // Menu with action handler\n * <MenuTrigger>\n *   <Button>Actions</Button>\n *   <Menu onAction={(key) => console.log(key)}>\n *     <MenuItem id=\"edit\">Edit</MenuItem>\n *     <MenuItem id=\"delete\">Delete</MenuItem>\n *   </Menu>\n * </MenuTrigger>\n * ```\n *\n * @example\n * ```tsx\n * // Menu with sections and separators\n * <MenuTrigger>\n *   <Button>Open</Button>\n *   <Menu>\n *     <MenuSection>\n *       <MenuItem>New File</MenuItem>\n *       <MenuItem>Open File</MenuItem>\n *     </MenuSection>\n *\n *     <MenuSeparator />\n *\n *     <MenuItem>Settings</MenuItem>\n *   </Menu>\n * </MenuTrigger>\n * ```\n *\n * @example\n * ```tsx\n * // Menu with selection\n * <MenuTrigger>\n *   <Button>Group</Button>\n *   <Menu selectionMode='multiple'>\n *     <MenuItem>Option 1</MenuItem>\n *     <MenuItem>Option 2</MenuItem>\n *   </Menu>\n * </MenuTrigger>\n * ```\n *\n * @example\n * ```tsx\n * // Menu with submenu\n * <MenuTrigger>\n *   <Button>Actions</Button>\n *   <Menu>\n *     <MenuItem>New File</MenuItem>\n *     <MenuSubmenu>\n *       <MenuItem>Export</MenuItem>\n *       <Menu>\n *         <MenuItem>Export as PDF</MenuItem>\n *         <MenuItem>Export as CSV</MenuItem>\n *         <MenuItem>Export as JSON</MenuItem>\n *       </Menu>\n *     </MenuSubmenu>\n *     <MenuItem>Delete</MenuItem>\n *   </Menu>\n * </MenuTrigger>\n * ```\n *\n * @param props - {@link MenuProps}\n * @param props.ref - Forwarded ref to the underlying Menu element.\n * @param props.children - Menu items and sections to render.\n * @param props.classNames - CSS class names for menu elements.\n * @param props.popoverProps - Props passed to the internal Popover component.\n * @param props.selectionMode - Selection mode for menu items.\n * @param props.variant - Visual density variant for the menu.\n * @returns The rendered Menu component.\n */\nexport function Menu<T extends object>({ ref, ...props }: MenuProps<T>) {\n  [props, ref] = useContextProps(props, ref ?? null, MenuContext);\n\n  const {\n    children,\n    classNames,\n    popoverProps,\n    selectionMode = 'single',\n    variant = 'cozy',\n    ...rest\n  } = props;\n\n  return (\n    <Popover\n      {...popoverProps}\n      className={composeRenderProps(classNames?.popover, (className) =>\n        clsx(styles.popover, className),\n      )}\n    >\n      <MenuContext.Provider value={{ variant }}>\n        <AriaMenu\n          {...rest}\n          ref={ref}\n          className={composeRenderProps(classNames?.menu, (className) =>\n            clsx('group/menu', styles.menu, styles[variant], className),\n          )}\n          selectionMode={selectionMode}\n        >\n          {children}\n        </AriaMenu>\n      </MenuContext.Provider>\n    </Popover>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAqIA,SAAgB,KAAuB,EAAE,KAAK,GAAG,SAAuB;AACtE,EAAC,OAAO,OAAO,gBAAgB,OAAO,OAAO,MAAM,YAAY;CAE/D,MAAM,EACJ,UACA,YACA,cACA,gBAAgB,UAChB,UAAU,QACV,GAAG,SACD;AAEJ,QACE,oBAAC;EACC,GAAI;EACJ,WAAW,mBAAmB,YAAY,UAAU,cAClD,KAAK,OAAO,SAAS,UAAU,CAChC;YAED,oBAAC,YAAY;GAAS,OAAO,EAAE,SAAS;aACtC,oBAACA;IACC,GAAI;IACC;IACL,WAAW,mBAAmB,YAAY,OAAO,cAC/C,KAAK,cAAc,OAAO,MAAM,OAAO,UAAU,UAAU,CAC5D;IACc;IAEd;KACQ;IACU;GACf"}

package/dist/components/menu/item-description.d.ts

@@ -12,14 +12,29 @@
 
 import "client-only";
 import { TextProps } from "react-aria-components";
-import * as react_jsx_runtime94 from "react/jsx-runtime";
+import * as react_jsx_runtime134 from "react/jsx-runtime";
 
 //#region src/components/menu/item-description.d.ts
+/**
+ * MenuItemDescription - Secondary descriptive text for menu items
+ *
+ * Renders as a Text component with the 'description' slot.
+ *
+ * @example
+ * ```tsx
+ * <MenuItemDescription>Open the document for editing</MenuItemDescription>
+ * ```
+ *
+ * @param props - TextProps from react-aria-components.
+ * @param props.children - Description text content.
+ * @param props.className - Optional CSS class name.
+ * @returns The rendered MenuItemDescription component.
+ */
 declare function MenuItemDescription({
   children,
   className,
   ...rest
-}: TextProps): react_jsx_runtime94.JSX.Element;
+}: TextProps): react_jsx_runtime134.JSX.Element;
 //#endregion
 export { MenuItemDescription };
 //# sourceMappingURL=item-description.d.ts.map

package/dist/components/menu/item-description.js

@@ -20,6 +20,21 @@ import { jsx } from "react/jsx-runtime";
 import styles from "./styles.module.css";
 
 //#region src/components/menu/item-description.tsx
+/**
+* MenuItemDescription - Secondary descriptive text for menu items
+*
+* Renders as a Text component with the 'description' slot.
+*
+* @example
+* ```tsx
+* <MenuItemDescription>Open the document for editing</MenuItemDescription>
+* ```
+*
+* @param props - TextProps from react-aria-components.
+* @param props.children - Description text content.
+* @param props.className - Optional CSS class name.
+* @returns The rendered MenuItemDescription component.
+*/
 function MenuItemDescription({ children, className, ...rest }) {
 	return /* @__PURE__ */ jsx(Text, {
 		...rest,

package/dist/components/menu/item-description.js.map

@@ -1 +1 @@
-{"version":3,"file":"item-description.js","names":[],"sources":["../../../src/components/menu/item-description.tsx"],"sourcesContent":["/*\n * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\n'use client';\n\nimport 'client-only';\nimport { clsx } from '@accelint/design-foundation/lib/utils';\nimport { Text, type TextProps } from 'react-aria-components';\nimport styles from './styles.module.css';\n\nexport function MenuItemDescription({\n  children,\n  className,\n  ...rest\n}: TextProps) {\n  return (\n    <Text\n      {...rest}\n      slot='description'\n      className={clsx(styles.description, className)}\n    >\n      {children}\n    </Text>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAmBA,SAAgB,oBAAoB,EAClC,UACA,WACA,GAAG,QACS;AACZ,QACE,oBAAC;EACC,GAAI;EACJ,MAAK;EACL,WAAW,KAAK,OAAO,aAAa,UAAU;EAE7C;GACI"}
+{"version":3,"file":"item-description.js","names":[],"sources":["../../../src/components/menu/item-description.tsx"],"sourcesContent":["/*\n * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\n'use client';\n\nimport 'client-only';\nimport { clsx } from '@accelint/design-foundation/lib/utils';\nimport { Text, type TextProps } from 'react-aria-components';\nimport styles from './styles.module.css';\n\n/**\n * MenuItemDescription - Secondary descriptive text for menu items\n *\n * Renders as a Text component with the 'description' slot.\n *\n * @example\n * ```tsx\n * <MenuItemDescription>Open the document for editing</MenuItemDescription>\n * ```\n *\n * @param props - TextProps from react-aria-components.\n * @param props.children - Description text content.\n * @param props.className - Optional CSS class name.\n * @returns The rendered MenuItemDescription component.\n */\nexport function MenuItemDescription({\n  children,\n  className,\n  ...rest\n}: TextProps) {\n  return (\n    <Text\n      {...rest}\n      slot='description'\n      className={clsx(styles.description, className)}\n    >\n      {children}\n    </Text>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAkCA,SAAgB,oBAAoB,EAClC,UACA,WACA,GAAG,QACS;AACZ,QACE,oBAAC;EACC,GAAI;EACJ,MAAK;EACL,WAAW,KAAK,OAAO,aAAa,UAAU;EAE7C;GACI"}

package/dist/components/menu/item-label.d.ts

@@ -12,14 +12,29 @@
 
 import "client-only";
 import { TextProps } from "react-aria-components";
-import * as react_jsx_runtime95 from "react/jsx-runtime";
+import * as react_jsx_runtime183 from "react/jsx-runtime";
 
 //#region src/components/menu/item-label.d.ts
+/**
+ * MenuItemLabel - Primary text label for menu items
+ *
+ * Renders as a Text component with the 'label' slot.
+ *
+ * @example
+ * ```tsx
+ * <MenuItemLabel>Edit Document</MenuItemLabel>
+ * ```
+ *
+ * @param props - TextProps from react-aria-components.
+ * @param props.children - Label text content.
+ * @param props.className - Optional CSS class name.
+ * @returns The rendered MenuItemLabel component.
+ */
 declare function MenuItemLabel({
   children,
   className,
   ...rest
-}: TextProps): react_jsx_runtime95.JSX.Element;
+}: TextProps): react_jsx_runtime183.JSX.Element;
 //#endregion
 export { MenuItemLabel };
 //# sourceMappingURL=item-label.d.ts.map

package/dist/components/menu/item-label.js

@@ -20,6 +20,21 @@ import { jsx } from "react/jsx-runtime";
 import styles from "./styles.module.css";
 
 //#region src/components/menu/item-label.tsx
+/**
+* MenuItemLabel - Primary text label for menu items
+*
+* Renders as a Text component with the 'label' slot.
+*
+* @example
+* ```tsx
+* <MenuItemLabel>Edit Document</MenuItemLabel>
+* ```
+*
+* @param props - TextProps from react-aria-components.
+* @param props.children - Label text content.
+* @param props.className - Optional CSS class name.
+* @returns The rendered MenuItemLabel component.
+*/
 function MenuItemLabel({ children, className, ...rest }) {
 	return /* @__PURE__ */ jsx(Text, {
 		...rest,

package/dist/components/menu/item-label.js.map

@@ -1 +1 @@
-{"version":3,"file":"item-label.js","names":[],"sources":["../../../src/components/menu/item-label.tsx"],"sourcesContent":["/*\n * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\n'use client';\n\nimport 'client-only';\nimport { clsx } from '@accelint/design-foundation/lib/utils';\nimport { Text, type TextProps } from 'react-aria-components';\nimport styles from './styles.module.css';\n\nexport function MenuItemLabel({ children, className, ...rest }: TextProps) {\n  return (\n    <Text {...rest} slot='label' className={clsx(styles.label, className)}>\n      {children}\n    </Text>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAmBA,SAAgB,cAAc,EAAE,UAAU,WAAW,GAAG,QAAmB;AACzE,QACE,oBAAC;EAAK,GAAI;EAAM,MAAK;EAAQ,WAAW,KAAK,OAAO,OAAO,UAAU;EAClE;GACI"}
+{"version":3,"file":"item-label.js","names":[],"sources":["../../../src/components/menu/item-label.tsx"],"sourcesContent":["/*\n * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\n'use client';\n\nimport 'client-only';\nimport { clsx } from '@accelint/design-foundation/lib/utils';\nimport { Text, type TextProps } from 'react-aria-components';\nimport styles from './styles.module.css';\n\n/**\n * MenuItemLabel - Primary text label for menu items\n *\n * Renders as a Text component with the 'label' slot.\n *\n * @example\n * ```tsx\n * <MenuItemLabel>Edit Document</MenuItemLabel>\n * ```\n *\n * @param props - TextProps from react-aria-components.\n * @param props.children - Label text content.\n * @param props.className - Optional CSS class name.\n * @returns The rendered MenuItemLabel component.\n */\nexport function MenuItemLabel({ children, className, ...rest }: TextProps) {\n  return (\n    <Text {...rest} slot='label' className={clsx(styles.label, className)}>\n      {children}\n    </Text>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAkCA,SAAgB,cAAc,EAAE,UAAU,WAAW,GAAG,QAAmB;AACzE,QACE,oBAAC;EAAK,GAAI;EAAM,MAAK;EAAQ,WAAW,KAAK,OAAO,OAAO,UAAU;EAClE;GACI"}

package/dist/components/menu/item.d.ts

@@ -12,15 +12,36 @@
 
 import { MenuItemProps } from "./types.js";
 import "client-only";
-import * as react_jsx_runtime97 from "react/jsx-runtime";
+import * as react_jsx_runtime130 from "react/jsx-runtime";
 
 //#region src/components/menu/item.d.ts
+
+/**
+ * MenuItem - Individual selectable item within a Menu
+ *
+ * Supports labels, descriptions, icons, hotkeys, and submenu indicators.
+ * String children are automatically wrapped in a Text label slot.
+ *
+ * @example
+ * ```tsx
+ * <MenuItem>
+ *   <MenuItemLabel>Edit</MenuItemLabel>
+ *   <MenuItemDescription>Modify the item</MenuItemDescription>
+ * </MenuItem>
+ * ```
+ *
+ * @param props - {@link MenuItemProps}
+ * @param props.children - Content to render inside the menu item.
+ * @param props.classNames - CSS class names for menu item elements.
+ * @param props.color - Color variant for the menu item.
+ * @returns The rendered MenuItem component.
+ */
 declare function MenuItem({
   children,
   classNames,
   color,
   ...rest
-}: MenuItemProps): react_jsx_runtime97.JSX.Element;
+}: MenuItemProps): react_jsx_runtime130.JSX.Element;
 //#endregion
 export { MenuItem };
 //# sourceMappingURL=item.d.ts.map

package/dist/components/menu/item.js

@@ -22,10 +22,30 @@ import { useContext } from "react";
 import { clsx } from "@accelint/design-foundation/lib/utils";
 import { DEFAULT_SLOT, KeyboardContext, MenuItem as MenuItem$1, Provider, Text, composeRenderProps } from "react-aria-components";
 import { jsx, jsxs } from "react/jsx-runtime";
-import styles from "./styles.module.css";
 import ChevronRight from "@accelint/icons/chevron-right";
+import styles from "./styles.module.css";
 
 //#region src/components/menu/item.tsx
+/**
+* MenuItem - Individual selectable item within a Menu
+*
+* Supports labels, descriptions, icons, hotkeys, and submenu indicators.
+* String children are automatically wrapped in a Text label slot.
+*
+* @example
+* ```tsx
+* <MenuItem>
+*   <MenuItemLabel>Edit</MenuItemLabel>
+*   <MenuItemDescription>Modify the item</MenuItemDescription>
+* </MenuItem>
+* ```
+*
+* @param props - {@link MenuItemProps}
+* @param props.children - Content to render inside the menu item.
+* @param props.classNames - CSS class names for menu item elements.
+* @param props.color - Color variant for the menu item.
+* @returns The rendered MenuItem component.
+*/
 function MenuItem({ children, classNames, color = "info", ...rest }) {
 	const context = useContext(MenuContext);
 	const variant = (isSlottedContextValue(context) ? void 0 : context?.variant) ?? "cozy";

package/dist/components/menu/item.js.map

@@ -1 +1 @@
-{"version":3,"file":"item.js","names":["AriaMenuItem","children"],"sources":["../../../src/components/menu/item.tsx"],"sourcesContent":["/*\n * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\n'use client';\n\nimport ChevronRight from '@accelint/icons/chevron-right';\nimport 'client-only';\nimport { clsx } from '@accelint/design-foundation/lib/utils';\nimport { useContext } from 'react';\nimport {\n  MenuItem as AriaMenuItem,\n  composeRenderProps,\n  DEFAULT_SLOT,\n  KeyboardContext,\n  Provider,\n  Text,\n} from 'react-aria-components';\nimport { isSlottedContextValue } from '../../lib/utils';\nimport { Icon } from '../icon';\nimport { IconContext } from '../icon/context';\nimport { MenuContext } from './context';\nimport styles from './styles.module.css';\nimport type { MenuItemProps } from './types';\n\nexport function MenuItem({\n  children,\n  classNames,\n  color = 'info',\n  ...rest\n}: MenuItemProps) {\n  const context = useContext(MenuContext);\n  const variant =\n    (isSlottedContextValue(context) ? undefined : context?.variant) ?? 'cozy';\n\n  return (\n    <AriaMenuItem\n      {...rest}\n      className={composeRenderProps(classNames?.item, (className) =>\n        clsx('group/menu-item', styles.item, styles[variant], className),\n      )}\n      data-color={color}\n    >\n      {composeRenderProps(children, (children, { hasSubmenu }) => (\n        <Provider\n          values={[\n            [\n              KeyboardContext,\n              { className: clsx(styles.hotkey, classNames?.hotkey) },\n            ],\n            [\n              IconContext,\n              {\n                slots: {\n                  [DEFAULT_SLOT]: {\n                    className: clsx(styles.icon, classNames?.icon),\n                  },\n                  submenu: { className: clsx(styles.more, classNames?.more) },\n                },\n              },\n            ],\n          ]}\n        >\n          {typeof children === 'string' ? (\n            <Text slot='label' className={classNames?.text}>\n              {children}\n            </Text>\n          ) : (\n            children\n          )}\n          {hasSubmenu && (\n            <Icon slot='submenu'>\n              <ChevronRight />\n            </Icon>\n          )}\n        </Provider>\n      ))}\n    </AriaMenuItem>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAiCA,SAAgB,SAAS,EACvB,UACA,YACA,QAAQ,QACR,GAAG,QACa;CAChB,MAAM,UAAU,WAAW,YAAY;CACvC,MAAM,WACH,sBAAsB,QAAQ,GAAG,SAAY,SAAS,YAAY;AAErE,QACE,oBAACA;EACC,GAAI;EACJ,WAAW,mBAAmB,YAAY,OAAO,cAC/C,KAAK,mBAAmB,OAAO,MAAM,OAAO,UAAU,UAAU,CACjE;EACD,cAAY;YAEX,mBAAmB,WAAW,YAAU,EAAE,iBACzC,qBAAC;GACC,QAAQ,CACN,CACE,iBACA,EAAE,WAAW,KAAK,OAAO,QAAQ,YAAY,OAAO,EAAE,CACvD,EACD,CACE,aACA,EACE,OAAO;KACJ,eAAe,EACd,WAAW,KAAK,OAAO,MAAM,YAAY,KAAK,EAC/C;IACD,SAAS,EAAE,WAAW,KAAK,OAAO,MAAM,YAAY,KAAK,EAAE;IAC5D,EACF,CACF,CACF;cAEA,OAAOC,eAAa,WACnB,oBAAC;IAAK,MAAK;IAAQ,WAAW,YAAY;cACvCA;KACI,GAEPA,YAED,cACC,oBAAC;IAAK,MAAK;cACT,oBAAC,iBAAe;KACX;IAEA,CACX;GACW"}
+{"version":3,"file":"item.js","names":["AriaMenuItem","children"],"sources":["../../../src/components/menu/item.tsx"],"sourcesContent":["/*\n * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\n'use client';\n\nimport ChevronRight from '@accelint/icons/chevron-right';\nimport 'client-only';\nimport { clsx } from '@accelint/design-foundation/lib/utils';\nimport { useContext } from 'react';\nimport {\n  MenuItem as AriaMenuItem,\n  composeRenderProps,\n  DEFAULT_SLOT,\n  KeyboardContext,\n  Provider,\n  Text,\n} from 'react-aria-components';\nimport { isSlottedContextValue } from '../../lib/utils';\nimport { Icon } from '../icon';\nimport { IconContext } from '../icon/context';\nimport { MenuContext } from './context';\nimport styles from './styles.module.css';\nimport type { MenuItemProps } from './types';\n\n/**\n * MenuItem - Individual selectable item within a Menu\n *\n * Supports labels, descriptions, icons, hotkeys, and submenu indicators.\n * String children are automatically wrapped in a Text label slot.\n *\n * @example\n * ```tsx\n * <MenuItem>\n *   <MenuItemLabel>Edit</MenuItemLabel>\n *   <MenuItemDescription>Modify the item</MenuItemDescription>\n * </MenuItem>\n * ```\n *\n * @param props - {@link MenuItemProps}\n * @param props.children - Content to render inside the menu item.\n * @param props.classNames - CSS class names for menu item elements.\n * @param props.color - Color variant for the menu item.\n * @returns The rendered MenuItem component.\n */\nexport function MenuItem({\n  children,\n  classNames,\n  color = 'info',\n  ...rest\n}: MenuItemProps) {\n  const context = useContext(MenuContext);\n  const variant =\n    (isSlottedContextValue(context) ? undefined : context?.variant) ?? 'cozy';\n\n  return (\n    <AriaMenuItem\n      {...rest}\n      className={composeRenderProps(classNames?.item, (className) =>\n        clsx('group/menu-item', styles.item, styles[variant], className),\n      )}\n      data-color={color}\n    >\n      {composeRenderProps(children, (children, { hasSubmenu }) => (\n        <Provider\n          values={[\n            [\n              KeyboardContext,\n              { className: clsx(styles.hotkey, classNames?.hotkey) },\n            ],\n            [\n              IconContext,\n              {\n                slots: {\n                  [DEFAULT_SLOT]: {\n                    className: clsx(styles.icon, classNames?.icon),\n                  },\n                  submenu: { className: clsx(styles.more, classNames?.more) },\n                },\n              },\n            ],\n          ]}\n        >\n          {typeof children === 'string' ? (\n            <Text slot='label' className={classNames?.text}>\n              {children}\n            </Text>\n          ) : (\n            children\n          )}\n          {hasSubmenu && (\n            <Icon slot='submenu'>\n              <ChevronRight />\n            </Icon>\n          )}\n        </Provider>\n      ))}\n    </AriaMenuItem>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAqDA,SAAgB,SAAS,EACvB,UACA,YACA,QAAQ,QACR,GAAG,QACa;CAChB,MAAM,UAAU,WAAW,YAAY;CACvC,MAAM,WACH,sBAAsB,QAAQ,GAAG,SAAY,SAAS,YAAY;AAErE,QACE,oBAACA;EACC,GAAI;EACJ,WAAW,mBAAmB,YAAY,OAAO,cAC/C,KAAK,mBAAmB,OAAO,MAAM,OAAO,UAAU,UAAU,CACjE;EACD,cAAY;YAEX,mBAAmB,WAAW,YAAU,EAAE,iBACzC,qBAAC;GACC,QAAQ,CACN,CACE,iBACA,EAAE,WAAW,KAAK,OAAO,QAAQ,YAAY,OAAO,EAAE,CACvD,EACD,CACE,aACA,EACE,OAAO;KACJ,eAAe,EACd,WAAW,KAAK,OAAO,MAAM,YAAY,KAAK,EAC/C;IACD,SAAS,EAAE,WAAW,KAAK,OAAO,MAAM,YAAY,KAAK,EAAE;IAC5D,EACF,CACF,CACF;cAEA,OAAOC,eAAa,WACnB,oBAAC;IAAK,MAAK;IAAQ,WAAW,YAAY;cACvCA;KACI,GAEPA,YAED,cACC,oBAAC;IAAK,MAAK;cACT,oBAAC,iBAAe;KACX;IAEA,CACX;GACW"}

package/dist/components/menu/section.d.ts

@@ -12,16 +12,37 @@
 
 import { MenuSectionProps } from "./types.js";
 import "client-only";
-import * as react_jsx_runtime96 from "react/jsx-runtime";
+import * as react_jsx_runtime143 from "react/jsx-runtime";
 
 //#region src/components/menu/section.d.ts
+
+/**
+ * MenuSection - Groups related menu items with an optional header
+ *
+ * Use to organize menu items into logical groups with visual separation.
+ *
+ * @example
+ * ```tsx
+ * <MenuSection title="File Actions">
+ *   <MenuItem>New</MenuItem>
+ *   <MenuItem>Open</MenuItem>
+ * </MenuSection>
+ * ```
+ *
+ * @param props - {@link MenuSectionProps}
+ * @param props.children - Menu items to render in the section.
+ * @param props.classNames - CSS class names for section elements.
+ * @param props.items - Collection of items for dynamic rendering.
+ * @param props.title - Title displayed in the section header.
+ * @returns The rendered MenuSection component.
+ */
 declare function MenuSection<T extends object>({
   children,
   classNames,
   items,
   title,
   ...rest
-}: MenuSectionProps<T>): react_jsx_runtime96.JSX.Element;
+}: MenuSectionProps<T>): react_jsx_runtime143.JSX.Element;
 //#endregion
 export { MenuSection };
 //# sourceMappingURL=section.d.ts.map

package/dist/components/menu/section.js

@@ -20,6 +20,26 @@ import { jsx, jsxs } from "react/jsx-runtime";
 import styles from "./styles.module.css";
 
 //#region src/components/menu/section.tsx
+/**
+* MenuSection - Groups related menu items with an optional header
+*
+* Use to organize menu items into logical groups with visual separation.
+*
+* @example
+* ```tsx
+* <MenuSection title="File Actions">
+*   <MenuItem>New</MenuItem>
+*   <MenuItem>Open</MenuItem>
+* </MenuSection>
+* ```
+*
+* @param props - {@link MenuSectionProps}
+* @param props.children - Menu items to render in the section.
+* @param props.classNames - CSS class names for section elements.
+* @param props.items - Collection of items for dynamic rendering.
+* @param props.title - Title displayed in the section header.
+* @returns The rendered MenuSection component.
+*/
 function MenuSection({ children, classNames, items, title, ...rest }) {
 	return /* @__PURE__ */ jsxs(MenuSection$1, {
 		...rest,

package/dist/components/menu/section.js.map

@@ -1 +1 @@
-{"version":3,"file":"section.js","names":["AriaMenuSection"],"sources":["../../../src/components/menu/section.tsx"],"sourcesContent":["/*\n * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\n'use client';\n\nimport 'client-only';\nimport { clsx } from '@accelint/design-foundation/lib/utils';\nimport {\n  MenuSection as AriaMenuSection,\n  Collection,\n  Header,\n} from 'react-aria-components';\nimport styles from './styles.module.css';\nimport type { MenuSectionProps } from './types';\n\nexport function MenuSection<T extends object>({\n  children,\n  classNames,\n  items,\n  title,\n  ...rest\n}: MenuSectionProps<T>) {\n  return (\n    <AriaMenuSection {...rest} className={classNames?.section}>\n      {title && (\n        <Header className={clsx(styles.header, classNames?.header)}>\n          {title}\n        </Header>\n      )}\n      <Collection items={items}>{children}</Collection>\n    </AriaMenuSection>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAwBA,SAAgB,YAA8B,EAC5C,UACA,YACA,OACA,OACA,GAAG,QACmB;AACtB,QACE,qBAACA;EAAgB,GAAI;EAAM,WAAW,YAAY;aAC/C,SACC,oBAAC;GAAO,WAAW,KAAK,OAAO,QAAQ,YAAY,OAAO;aACvD;IACM,EAEX,oBAAC;GAAkB;GAAQ;IAAsB;GACjC"}
+{"version":3,"file":"section.js","names":["AriaMenuSection"],"sources":["../../../src/components/menu/section.tsx"],"sourcesContent":["/*\n * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\n'use client';\n\nimport 'client-only';\nimport { clsx } from '@accelint/design-foundation/lib/utils';\nimport {\n  MenuSection as AriaMenuSection,\n  Collection,\n  Header,\n} from 'react-aria-components';\nimport styles from './styles.module.css';\nimport type { MenuSectionProps } from './types';\n\n/**\n * MenuSection - Groups related menu items with an optional header\n *\n * Use to organize menu items into logical groups with visual separation.\n *\n * @example\n * ```tsx\n * <MenuSection title=\"File Actions\">\n *   <MenuItem>New</MenuItem>\n *   <MenuItem>Open</MenuItem>\n * </MenuSection>\n * ```\n *\n * @param props - {@link MenuSectionProps}\n * @param props.children - Menu items to render in the section.\n * @param props.classNames - CSS class names for section elements.\n * @param props.items - Collection of items for dynamic rendering.\n * @param props.title - Title displayed in the section header.\n * @returns The rendered MenuSection component.\n */\nexport function MenuSection<T extends object>({\n  children,\n  classNames,\n  items,\n  title,\n  ...rest\n}: MenuSectionProps<T>) {\n  return (\n    <AriaMenuSection {...rest} className={classNames?.section}>\n      {title && (\n        <Header className={clsx(styles.header, classNames?.header)}>\n          {title}\n        </Header>\n      )}\n      <Collection items={items}>{children}</Collection>\n    </AriaMenuSection>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA4CA,SAAgB,YAA8B,EAC5C,UACA,YACA,OACA,OACA,GAAG,QACmB;AACtB,QACE,qBAACA;EAAgB,GAAI;EAAM,WAAW,YAAY;aAC/C,SACC,oBAAC;GAAO,WAAW,KAAK,OAAO,QAAQ,YAAY,OAAO;aACvD;IACM,EAEX,oBAAC;GAAkB;GAAQ;IAAsB;GACjC"}

package/dist/components/menu/separator.d.ts

@@ -12,13 +12,27 @@
 
 import "client-only";
 import { SeparatorProps } from "react-aria-components";
-import * as react_jsx_runtime98 from "react/jsx-runtime";
+import * as react_jsx_runtime189 from "react/jsx-runtime";
 
 //#region src/components/menu/separator.d.ts
+/**
+ * MenuSeparator - Visual divider between menu items or sections
+ *
+ * @example
+ * ```tsx
+ * <MenuItem>Copy</MenuItem>
+ * <MenuSeparator />
+ * <MenuItem>Delete</MenuItem>
+ * ```
+ *
+ * @param props - SeparatorProps from react-aria-components.
+ * @param props.className - Optional CSS class name.
+ * @returns The rendered MenuSeparator component.
+ */
 declare function MenuSeparator({
   className,
   ...rest
-}: SeparatorProps): react_jsx_runtime98.JSX.Element;
+}: SeparatorProps): react_jsx_runtime189.JSX.Element;
 //#endregion
 export { MenuSeparator };
 //# sourceMappingURL=separator.d.ts.map