@accelint/design-toolkit 9.3.0 → 9.4.0

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["className"],"sources":["../../../src/components/list/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'use client';\n\nimport 'client-only';\nimport { clsx } from '@accelint/design-foundation/lib/utils';\nimport {\n  composeRenderProps,\n  GridList,\n  useContextProps,\n} from 'react-aria-components';\nimport { IconProvider } from '../icon/context';\nimport { ListContext } from './context';\nimport styles from './styles.module.css';\nimport type { ListProps } from './types';\n\n/**\n * List - A flexible grid list component for selectable items with rich content\n *\n * Provides accessible grid list functionality with support for selection,\n * and rich item content including labels, descriptions, icons, and actions. Perfect for\n * data tables, file lists, or any selectable grid interface.\n *\n * @example\n * // Basic list view with sizing\n * <div className='h-[400px] w-[300px]'>\n *   <List className='h-full' aria-label='Items'>\n *     <ListItem>\n *       <ListItemContent>\n *         <ListItemTitle>Item 1</ListItemTitle>\n *       </ListItemContent>\n *     </ListItem>\n *   </List>\n * </div>\n */\nexport function List<T extends object>({ ref, ...props }: ListProps<T>) {\n  [props, ref] = useContextProps(props, ref ?? null, ListContext);\n\n  const { children, className, variant, ...rest } = props;\n\n  return (\n    <ListContext.Provider value={{ variant }}>\n      <IconProvider size={variant === 'cozy' ? 'large' : 'small'}>\n        <GridList<T>\n          {...rest}\n          ref={ref}\n          className={composeRenderProps(className, (className) =>\n            clsx('group/list', styles.list, className),\n          )}\n        >\n          {children}\n        </GridList>\n      </IconProvider>\n    </ListContext.Provider>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA4CA,SAAgB,KAAuB,EAAE,KAAK,GAAG,SAAuB;AACtE,EAAC,OAAO,OAAO,gBAAgB,OAAO,OAAO,MAAM,YAAY;CAE/D,MAAM,EAAE,UAAU,WAAW,SAAS,GAAG,SAAS;AAElD,QACE,oBAAC,YAAY;EAAS,OAAO,EAAE,SAAS;YACtC,oBAAC;GAAa,MAAM,YAAY,SAAS,UAAU;aACjD,oBAAC;IACC,GAAI;IACC;IACL,WAAW,mBAAmB,YAAY,gBACxC,KAAK,cAAc,OAAO,MAAMA,YAAU,CAC3C;IAEA;KACQ;IACE;GACM"}
+{"version":3,"file":"index.js","names":["className"],"sources":["../../../src/components/list/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'use client';\n\nimport 'client-only';\nimport { clsx } from '@accelint/design-foundation/lib/utils';\nimport {\n  composeRenderProps,\n  GridList,\n  useContextProps,\n} from 'react-aria-components';\nimport { IconProvider } from '../icon/context';\nimport { ListContext } from './context';\nimport styles from './styles.module.css';\nimport type { ListProps } from './types';\n\n/**\n * List - A flexible grid list component for selectable items with rich content\n *\n * Provides accessible grid list functionality with support for selection,\n * and rich item content including labels, descriptions, icons, and actions. Perfect for\n * data tables, file lists, or any selectable grid interface.\n *\n * @example\n * ```tsx\n * // Basic list view with sizing\n * <div className='h-[400px] w-[300px]'>\n *   <List className='h-full' aria-label='Items'>\n *     <ListItem>\n *       <ListItemContent>\n *         <ListItemTitle>Item 1</ListItemTitle>\n *       </ListItemContent>\n *     </ListItem>\n *   </List>\n * </div>\n * ```\n *\n * @param props - {@link ListProps}\n * @param props.ref - Forwarded ref to the underlying GridList element.\n * @param props.children - List item elements to render.\n * @param props.className - Optional CSS class name.\n * @param props.variant - Visual density variant for list items.\n * @returns The rendered List component.\n */\nexport function List<T extends object>({ ref, ...props }: ListProps<T>) {\n  [props, ref] = useContextProps(props, ref ?? null, ListContext);\n\n  const { children, className, variant, ...rest } = props;\n\n  return (\n    <ListContext.Provider value={{ variant }}>\n      <IconProvider size={variant === 'cozy' ? 'large' : 'small'}>\n        <GridList<T>\n          {...rest}\n          ref={ref}\n          className={composeRenderProps(className, (className) =>\n            clsx('group/list', styles.list, className),\n          )}\n        >\n          {children}\n        </GridList>\n      </IconProvider>\n    </ListContext.Provider>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAqDA,SAAgB,KAAuB,EAAE,KAAK,GAAG,SAAuB;AACtE,EAAC,OAAO,OAAO,gBAAgB,OAAO,OAAO,MAAM,YAAY;CAE/D,MAAM,EAAE,UAAU,WAAW,SAAS,GAAG,SAAS;AAElD,QACE,oBAAC,YAAY;EAAS,OAAO,EAAE,SAAS;YACtC,oBAAC;GAAa,MAAM,YAAY,SAAS,UAAU;aACjD,oBAAC;IACC,GAAI;IACC;IACL,WAAW,mBAAmB,YAAY,gBACxC,KAAK,cAAc,OAAO,MAAMA,YAAU,CAC3C;IAEA;KACQ;IACE;GACM"}

package/dist/components/list/item-content.d.ts

@@ -12,9 +12,10 @@
 
 import { ListItemContentProps } from "./types.js";
 import "client-only";
-import * as react_jsx_runtime100 from "react/jsx-runtime";
+import * as react_jsx_runtime97 from "react/jsx-runtime";
 
 //#region src/components/list/item-content.d.ts
+
 /**
  * ListItemContent - Container for list item title and description
  *
@@ -22,15 +23,21 @@ import * as react_jsx_runtime100 from "react/jsx-runtime";
  * Should contain ListItemTitle and optionally ListItemDescription components.
  *
  * @example
+ * ```tsx
  * <ListItemContent>
  *   <ListItemTitle>Item Title</ListItemTitle>
  *   <ListItemDescription>Optional description text</ListItemDescription>
  * </ListItemContent>
+ * ```
+ *
+ * @param props - {@link ListItemContentProps}
+ * @param props.className - Optional CSS class name.
+ * @returns The rendered ListItemContent component.
  */
 declare function ListItemContent({
   className,
   ...rest
-}: ListItemContentProps): react_jsx_runtime100.JSX.Element;
+}: ListItemContentProps): react_jsx_runtime97.JSX.Element;
 //#endregion
 export { ListItemContent };
 //# sourceMappingURL=item-content.d.ts.map

package/dist/components/list/item-content.js

@@ -26,10 +26,16 @@ import styles from "./styles.module.css";
 * Should contain ListItemTitle and optionally ListItemDescription components.
 *
 * @example
+* ```tsx
 * <ListItemContent>
 *   <ListItemTitle>Item Title</ListItemTitle>
 *   <ListItemDescription>Optional description text</ListItemDescription>
 * </ListItemContent>
+* ```
+*
+* @param props - {@link ListItemContentProps}
+* @param props.className - Optional CSS class name.
+* @returns The rendered ListItemContent component.
 */
 function ListItemContent({ className, ...rest }) {
 	return /* @__PURE__ */ jsx("div", {

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

@@ -1 +1 @@
-{"version":3,"file":"item-content.js","names":[],"sources":["../../../src/components/list/item-content.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 styles from './styles.module.css';\nimport type { ListItemContentProps } from './types';\n\n/**\n * ListItemContent - Container for list item title and description\n *\n * Provides consistent spacing and layout for text content within list items.\n * Should contain ListItemTitle and optionally ListItemDescription components.\n *\n * @example\n * <ListItemContent>\n *   <ListItemTitle>Item Title</ListItemTitle>\n *   <ListItemDescription>Optional description text</ListItemDescription>\n * </ListItemContent>\n */\nexport function ListItemContent({ className, ...rest }: ListItemContentProps) {\n  return <div {...rest} className={clsx(styles.content, className)} />;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA8BA,SAAgB,gBAAgB,EAAE,WAAW,GAAG,QAA8B;AAC5E,QAAO,oBAAC;EAAI,GAAI;EAAM,WAAW,KAAK,OAAO,SAAS,UAAU;GAAI"}
+{"version":3,"file":"item-content.js","names":[],"sources":["../../../src/components/list/item-content.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 styles from './styles.module.css';\nimport type { ListItemContentProps } from './types';\n\n/**\n * ListItemContent - Container for list item title and description\n *\n * Provides consistent spacing and layout for text content within list items.\n * Should contain ListItemTitle and optionally ListItemDescription components.\n *\n * @example\n * ```tsx\n * <ListItemContent>\n *   <ListItemTitle>Item Title</ListItemTitle>\n *   <ListItemDescription>Optional description text</ListItemDescription>\n * </ListItemContent>\n * ```\n *\n * @param props - {@link ListItemContentProps}\n * @param props.className - Optional CSS class name.\n * @returns The rendered ListItemContent component.\n */\nexport function ListItemContent({ className, ...rest }: ListItemContentProps) {\n  return <div {...rest} className={clsx(styles.content, className)} />;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAoCA,SAAgB,gBAAgB,EAAE,WAAW,GAAG,QAA8B;AAC5E,QAAO,oBAAC;EAAI,GAAI;EAAM,WAAW,KAAK,OAAO,SAAS,UAAU;GAAI"}

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

@@ -12,7 +12,7 @@
 
 import { ListItemDescriptionProps } from "./types.js";
 import "client-only";
-import * as react_jsx_runtime92 from "react/jsx-runtime";
+import * as react_jsx_runtime99 from "react/jsx-runtime";
 
 //#region src/components/list/item-description.d.ts
 /**
@@ -22,13 +22,20 @@ import * as react_jsx_runtime92 from "react/jsx-runtime";
  * Automatically adjusts font size for cozy (body-s) and compact (body-xs) variants.
  *
  * @example
+ * ```tsx
  * <ListItemDescription>Software Engineer</ListItemDescription>
+ * ```
+ *
+ * @param props - {@link ListItemDescriptionProps}
+ * @param props.children - Description text content.
+ * @param props.className - Optional CSS class name.
+ * @returns The rendered ListItemDescription component.
  */
 declare function ListItemDescription({
   children,
   className,
   ...rest
-}: ListItemDescriptionProps): react_jsx_runtime92.JSX.Element;
+}: ListItemDescriptionProps): react_jsx_runtime99.JSX.Element;
 //#endregion
 export { ListItemDescription };
 //# sourceMappingURL=item-description.d.ts.map

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

@@ -27,7 +27,14 @@ import styles from "./styles.module.css";
 * Automatically adjusts font size for cozy (body-s) and compact (body-xs) variants.
 *
 * @example
+* ```tsx
 * <ListItemDescription>Software Engineer</ListItemDescription>
+* ```
+*
+* @param props - {@link ListItemDescriptionProps}
+* @param props.children - Description text content.
+* @param props.className - Optional CSS class name.
+* @returns The rendered ListItemDescription component.
 */
 function ListItemDescription({ children, className, ...rest }) {
 	const variant = useListItemVariant();

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

@@ -1 +1 @@
-{"version":3,"file":"item-description.js","names":[],"sources":["../../../src/components/list/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'use client';\n\nimport 'client-only';\nimport { clsx } from '@accelint/design-foundation/lib/utils';\nimport { useListItemVariant } from './context';\nimport styles from './styles.module.css';\nimport type { ListItemDescriptionProps } from './types';\n\n/**\n * ListItemDescription - Secondary descriptive text for list items\n *\n * Renders supplementary information below the title with muted styling.\n * Automatically adjusts font size for cozy (body-s) and compact (body-xs) variants.\n *\n * @example\n * <ListItemDescription>Software Engineer</ListItemDescription>\n */\nexport function ListItemDescription({\n  children,\n  className,\n  ...rest\n}: ListItemDescriptionProps) {\n  const variant = useListItemVariant();\n\n  return (\n    <div\n      {...rest}\n      className={clsx(styles.description, styles[variant], className)}\n    >\n      {children}\n    </div>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA4BA,SAAgB,oBAAoB,EAClC,UACA,WACA,GAAG,QACwB;CAC3B,MAAM,UAAU,oBAAoB;AAEpC,QACE,oBAAC;EACC,GAAI;EACJ,WAAW,KAAK,OAAO,aAAa,OAAO,UAAU,UAAU;EAE9D;GACG"}
+{"version":3,"file":"item-description.js","names":[],"sources":["../../../src/components/list/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'use client';\n\nimport 'client-only';\nimport { clsx } from '@accelint/design-foundation/lib/utils';\nimport { useListItemVariant } from './context';\nimport styles from './styles.module.css';\nimport type { ListItemDescriptionProps } from './types';\n\n/**\n * ListItemDescription - Secondary descriptive text for list items\n *\n * Renders supplementary information below the title with muted styling.\n * Automatically adjusts font size for cozy (body-s) and compact (body-xs) variants.\n *\n * @example\n * ```tsx\n * <ListItemDescription>Software Engineer</ListItemDescription>\n * ```\n *\n * @param props - {@link ListItemDescriptionProps}\n * @param props.children - Description text content.\n * @param props.className - Optional CSS class name.\n * @returns The rendered ListItemDescription component.\n */\nexport function ListItemDescription({\n  children,\n  className,\n  ...rest\n}: ListItemDescriptionProps) {\n  const variant = useListItemVariant();\n\n  return (\n    <div\n      {...rest}\n      className={clsx(styles.description, styles[variant], className)}\n    >\n      {children}\n    </div>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmCA,SAAgB,oBAAoB,EAClC,UACA,WACA,GAAG,QACwB;CAC3B,MAAM,UAAU,oBAAoB;AAEpC,QACE,oBAAC;EACC,GAAI;EACJ,WAAW,KAAK,OAAO,aAAa,OAAO,UAAU,UAAU;EAE9D;GACG"}

package/dist/components/list/item-title.d.ts

@@ -12,7 +12,7 @@
 
 import { ListItemTitleProps } from "./types.js";
 import "client-only";
-import * as react_jsx_runtime96 from "react/jsx-runtime";
+import * as react_jsx_runtime135 from "react/jsx-runtime";
 
 //#region src/components/list/item-title.d.ts
 /**
@@ -22,13 +22,20 @@ import * as react_jsx_runtime96 from "react/jsx-runtime";
  * Automatically adjusts font size for cozy (header-m) and compact (header-s) variants.
  *
  * @example
+ * ```tsx
  * <ListItemTitle>John Doe</ListItemTitle>
+ * ```
+ *
+ * @param props - {@link ListItemTitleProps}
+ * @param props.children - Title text content.
+ * @param props.className - Optional CSS class name.
+ * @returns The rendered ListItemTitle component.
  */
 declare function ListItemTitle({
   children,
   className,
   ...rest
-}: ListItemTitleProps): react_jsx_runtime96.JSX.Element;
+}: ListItemTitleProps): react_jsx_runtime135.JSX.Element;
 //#endregion
 export { ListItemTitle };
 //# sourceMappingURL=item-title.d.ts.map

package/dist/components/list/item-title.js

@@ -27,7 +27,14 @@ import styles from "./styles.module.css";
 * Automatically adjusts font size for cozy (header-m) and compact (header-s) variants.
 *
 * @example
+* ```tsx
 * <ListItemTitle>John Doe</ListItemTitle>
+* ```
+*
+* @param props - {@link ListItemTitleProps}
+* @param props.children - Title text content.
+* @param props.className - Optional CSS class name.
+* @returns The rendered ListItemTitle component.
 */
 function ListItemTitle({ children, className, ...rest }) {
 	const variant = useListItemVariant();

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

@@ -1 +1 @@
-{"version":3,"file":"item-title.js","names":[],"sources":["../../../src/components/list/item-title.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 { useListItemVariant } from './context';\nimport styles from './styles.module.css';\nimport type { ListItemTitleProps } from './types';\n\n/**\n * ListItemTitle - Primary text label for list items\n *\n * Renders the main title text with appropriate typography based on the list variant.\n * Automatically adjusts font size for cozy (header-m) and compact (header-s) variants.\n *\n * @example\n * <ListItemTitle>John Doe</ListItemTitle>\n */\nexport function ListItemTitle({\n  children,\n  className,\n  ...rest\n}: ListItemTitleProps) {\n  const variant = useListItemVariant();\n\n  return (\n    <div {...rest} className={clsx(styles.title, styles[variant], className)}>\n      {children}\n    </div>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA4BA,SAAgB,cAAc,EAC5B,UACA,WACA,GAAG,QACkB;CACrB,MAAM,UAAU,oBAAoB;AAEpC,QACE,oBAAC;EAAI,GAAI;EAAM,WAAW,KAAK,OAAO,OAAO,OAAO,UAAU,UAAU;EACrE;GACG"}
+{"version":3,"file":"item-title.js","names":[],"sources":["../../../src/components/list/item-title.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 { useListItemVariant } from './context';\nimport styles from './styles.module.css';\nimport type { ListItemTitleProps } from './types';\n\n/**\n * ListItemTitle - Primary text label for list items\n *\n * Renders the main title text with appropriate typography based on the list variant.\n * Automatically adjusts font size for cozy (header-m) and compact (header-s) variants.\n *\n * @example\n * ```tsx\n * <ListItemTitle>John Doe</ListItemTitle>\n * ```\n *\n * @param props - {@link ListItemTitleProps}\n * @param props.children - Title text content.\n * @param props.className - Optional CSS class name.\n * @returns The rendered ListItemTitle component.\n */\nexport function ListItemTitle({\n  children,\n  className,\n  ...rest\n}: ListItemTitleProps) {\n  const variant = useListItemVariant();\n\n  return (\n    <div {...rest} className={clsx(styles.title, styles[variant], className)}>\n      {children}\n    </div>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmCA,SAAgB,cAAc,EAC5B,UACA,WACA,GAAG,QACkB;CACrB,MAAM,UAAU,oBAAoB;AAEpC,QACE,oBAAC;EAAI,GAAI;EAAM,WAAW,KAAK,OAAO,OAAO,OAAO,UAAU,UAAU;EACrE;GACG"}

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

@@ -12,7 +12,7 @@
 
 import { ListItemProps } from "./types.js";
 import "client-only";
-import * as react_jsx_runtime189 from "react/jsx-runtime";
+import * as react_jsx_runtime138 from "react/jsx-runtime";
 
 //#region src/components/list/item.d.ts
 
@@ -25,6 +25,7 @@ import * as react_jsx_runtime189 from "react/jsx-runtime";
  * wrapped in a ListItemTitle.
  *
  * @example
+ * ```tsx
  * <ListItem textValue="User item">
  *   <Icon><Avatar /></Icon>
  *   <ListItemContent>
@@ -32,13 +33,20 @@ import * as react_jsx_runtime189 from "react/jsx-runtime";
  *     <ListItemDescription>Software Engineer</ListItemDescription>
  *   </ListItemContent>
  * </ListItem>
+ * ```
+ *
+ * @param props - {@link ListItemProps}
+ * @param props.children - Content to render inside the list item.
+ * @param props.classNames - CSS class names for list item elements.
+ * @param props.textValue - Accessible text value for the item.
+ * @returns The rendered ListItem component.
  */
 declare function ListItem<T extends object>({
   children,
   classNames,
   textValue,
   ...rest
-}: ListItemProps<T>): react_jsx_runtime189.JSX.Element;
+}: ListItemProps<T>): react_jsx_runtime138.JSX.Element;
 //#endregion
 export { ListItem };
 //# sourceMappingURL=item.d.ts.map

package/dist/components/list/item.js

@@ -30,6 +30,7 @@ import styles from "./styles.module.css";
 * wrapped in a ListItemTitle.
 *
 * @example
+* ```tsx
 * <ListItem textValue="User item">
 *   <Icon><Avatar /></Icon>
 *   <ListItemContent>
@@ -37,6 +38,13 @@ import styles from "./styles.module.css";
 *     <ListItemDescription>Software Engineer</ListItemDescription>
 *   </ListItemContent>
 * </ListItem>
+* ```
+*
+* @param props - {@link ListItemProps}
+* @param props.children - Content to render inside the list item.
+* @param props.classNames - CSS class names for list item elements.
+* @param props.textValue - Accessible text value for the item.
+* @returns The rendered ListItem component.
 */
 function ListItem({ children, classNames, textValue = typeof children === "string" ? children : "", ...rest }) {
 	return /* @__PURE__ */ jsx(GridListItem, {

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 react30 from "react";
+import * as react33 from "react";
 import { ContextValue } from "react-aria-components";
 
 //#region src/components/menu/context.d.ts
-declare const MenuContext: react30.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_runtime103 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_runtime103 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_runtime103 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_runtime103 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_runtime103 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_runtime103 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_runtime103 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_runtime103 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_runtime103.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_runtime105 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_runtime105.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"}