@adgytec/adgytec-web-ui-components 2.3.0 → 2.4.0

package/dist/components/List/ListMedia/index.js

@@ -1,2 +1 @@
-import { a as e, i as t, n, o as r, r as i, s as a, t as o } from "../../../chunks/ListMedia";
-export { a as ListMedia, o as ListMediaImageHeight, n as ListMediaImageWidth, i as ListMediaLargeVideoHeight, t as ListMediaLargeVideoWidth, e as ListMediaVideoHeight, r as ListMediaVideoWidth };
+export { s as ListMedia, t as ListMediaImageHeight, n as ListMediaImageWidth, r as ListMediaLargeVideoHeight, i as ListMediaLargeVideoWidth, a as ListMediaVideoHeight, o as ListMediaVideoWidth } from "../../../chunks/ListMedia";

package/dist/components/List/ListMedia/types.d.ts

@@ -1,10 +1,42 @@
+/**
+ * Width in pixels for the `"image"` media variant (56px).
+ */
 export declare const ListMediaImageWidth = 56;
+/**
+ * Height in pixels for the `"image"` media variant (56px).
+ */
 export declare const ListMediaImageHeight = 56;
+/**
+ * Width in pixels for the standard `"video"` media variant (100px).
+ */
 export declare const ListMediaVideoWidth = 100;
+/**
+ * Height in pixels for the standard `"video"` media variant (56px).
+ */
 export declare const ListMediaVideoHeight = 56;
+/**
+ * Width in pixels for the `"large-video"` media variant (114px).
+ */
 export declare const ListMediaLargeVideoWidth = 114;
+/**
+ * Height in pixels for the `"large-video"` media variant (64px).
+ */
 export declare const ListMediaLargeVideoHeight = 64;
+/**
+ * Preset dimension variants for the [`ListMedia`](src/components/List/ListMedia/ListMedia.tsx) container:
+ * - `"image"`: 56px × 56px square thumbnail.
+ * - `"video"`: 100px × 56px 16:9 aspect video preview.
+ * - `"large-video"`: 114px × 64px enlarged video preview.
+ */
 export type ListMediaVariant = "image" | "video" | "large-video";
+/**
+ * Props for the [`ListMedia`](src/components/List/ListMedia/ListMedia.tsx) container component.
+ */
 export interface ListMediaProps extends React.ComponentPropsWithRef<"div"> {
+    /**
+     * Preset dimension variant for the media thumbnail container.
+     *
+     * @default "image"
+     */
     variant?: ListMediaVariant;
 }

package/dist/components/List/ListOverlineText/ListOverlineText.d.ts

@@ -1,2 +1,17 @@
 import { Text } from 'react-aria-components';
-export declare const ListOverlineText: React.FC<React.ComponentPropsWithRef<typeof Text>>;
+/**
+ * Props for the [`ListOverlineText`](src/components/List/ListOverlineText/ListOverlineText.tsx) component.
+ */
+export interface ListOverlineTextProps extends React.ComponentPropsWithRef<typeof Text> {
+}
+/**
+ * Eyebrow or overline category text component displayed above the label in a [`ListItem`](src/components/List/ListItem/ListItem.tsx).
+ *
+ * Styled with Material Design 3 `labelSmall` typography.
+ *
+ * @example
+ * ```tsx
+ * <ListOverlineText>Work</ListOverlineText>
+ * ```
+ */
+export declare const ListOverlineText: React.FC<ListOverlineTextProps>;

package/dist/components/List/ListOverlineText/index.js

@@ -1,2 +1 @@
-import { t as e } from "../../../chunks/ListOverlineText";
-export { e as ListOverlineText };
+export { t as ListOverlineText } from "../../../chunks/ListOverlineText";

package/dist/components/List/ListSupportingText/ListSupportingText.d.ts

@@ -1,2 +1,17 @@
 import { Text } from 'react-aria-components';
-export declare const ListSupportingText: React.FC<Omit<React.ComponentPropsWithRef<typeof Text>, "slot">>;
+/**
+ * Props for the [`ListSupportingText`](src/components/List/ListSupportingText/ListSupportingText.tsx) component.
+ */
+export interface ListSupportingTextProps extends Omit<React.ComponentPropsWithRef<typeof Text>, "slot"> {
+}
+/**
+ * Secondary descriptive text component placed beneath the label in a [`ListItem`](src/components/List/ListItem/ListItem.tsx).
+ *
+ * Automatically binds to `slot="description"` with Material Design 3 `bodyMedium` typography.
+ *
+ * @example
+ * ```tsx
+ * <ListSupportingText>Receive real-time alerts on your device.</ListSupportingText>
+ * ```
+ */
+export declare const ListSupportingText: React.FC<ListSupportingTextProps>;

package/dist/components/List/ListSupportingText/index.js

@@ -1,2 +1 @@
-import { t as e } from "../../../chunks/ListSupportingText";
-export { e as ListSupportingText };
+export { t as ListSupportingText } from "../../../chunks/ListSupportingText";

package/dist/components/List/ListTrailingText/ListTrailingText.d.ts

@@ -1,2 +1,17 @@
 import { Text } from 'react-aria-components';
-export declare const ListTrailingText: React.FC<React.ComponentPropsWithRef<typeof Text>>;
+/**
+ * Props for the [`ListTrailingText`](src/components/List/ListTrailingText/ListTrailingText.tsx) component.
+ */
+export interface ListTrailingTextProps extends React.ComponentPropsWithRef<typeof Text> {
+}
+/**
+ * Trailing metadata or timestamp text component placed at the end of a [`ListItem`](src/components/List/ListItem/ListItem.tsx).
+ *
+ * Styled with Material Design 3 `labelSmall` typography.
+ *
+ * @example
+ * ```tsx
+ * <ListTrailingText>10:45 AM</ListTrailingText>
+ * ```
+ */
+export declare const ListTrailingText: React.FC<ListTrailingTextProps>;

package/dist/components/List/ListTrailingText/index.d.ts

@@ -1 +1 @@
-export {};
+export * from './ListTrailingText';

package/dist/components/List/ListTrailingText/index.js

@@ -0,0 +1 @@
+export { t as ListTrailingText } from "../../../chunks/ListTrailingText";

package/dist/components/List/core/context.d.ts

@@ -0,0 +1,18 @@
+import { SelectionIndicator } from './selectionIndicator';
+/**
+ * Configuration context value passed down from [`ListBox`](src/components/List/ListBox/ListBox.tsx) to child items.
+ */
+export type ListBoxConfigContextValue = {
+    /**
+     * Placement of the selection check indicator across list items.
+     */
+    selectionIndicator?: SelectionIndicator;
+};
+/**
+ * Context that propagates [`ListBox`](src/components/List/ListBox/ListBox.tsx) configuration options to nested list items.
+ */
+export declare const ListBoxConfigContext: import('react').Context<ListBoxConfigContextValue>;
+/**
+ * Hook to access [`ListBox`](src/components/List/ListBox/ListBox.tsx) configuration within a [`ListItem`](src/components/List/ListItem/ListItem.tsx).
+ */
+export declare function useListBoxConfig(): ListBoxConfigContextValue;

package/dist/components/List/core/index.d.ts

@@ -0,0 +1,2 @@
+export * from './context';
+export * from './selectionIndicator';

package/dist/components/List/core/index.js

@@ -0,0 +1,9 @@
+import { createContext as e, useContext as t } from "react";
+// src/components/List/core/context.ts
+var n = e({});
+function r() {
+	return t(n);
+}
+export { n as ListBoxConfigContext, r as useListBoxConfig };
+
+//# sourceMappingURL=index.js.map

package/dist/components/List/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["ListBoxConfigContext","createContext","useListBoxConfig","useContext"],"sources":["../../../../src/components/List/core/context.ts"],"sourcesContent":["import { createContext, useContext } from \"react\";\nimport type { SelectionIndicator } from \"./selectionIndicator\";\n\n/**\n * Configuration context value passed down from [`ListBox`](src/components/List/ListBox/ListBox.tsx) to child items.\n */\nexport type ListBoxConfigContextValue = {\n    /**\n     * Placement of the selection check indicator across list items.\n     */\n    selectionIndicator?: SelectionIndicator;\n};\n\n/**\n * Context that propagates [`ListBox`](src/components/List/ListBox/ListBox.tsx) configuration options to nested list items.\n */\nexport const ListBoxConfigContext = createContext<ListBoxConfigContextValue>(\n    {}\n);\n\n/**\n * Hook to access [`ListBox`](src/components/List/ListBox/ListBox.tsx) configuration within a [`ListItem`](src/components/List/ListItem/ListItem.tsx).\n */\nexport function useListBoxConfig() {\n    return useContext(ListBoxConfigContext);\n}\n"],"mappings":";;AAgBA,IAAaA,IAAuBC,EAChC,CAAC,CACL;AAKA,SAAOC,IAAA;CAAA,OACIC,EAAWH,CAAoB;AAAC"}

package/dist/components/List/core/selectionIndicator.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Position where the selection check indicator is displayed when a list item is selected.
+ *
+ * - `"leading"`: Replaces the item's leading element with a check icon when selected.
+ * - `"trailing"`: Replaces the item's trailing element with a check icon when selected.
+ * - `"none"`: No automatic check icon replacement (default).
+ */
+export type SelectionIndicator = "leading" | "trailing" | "none";

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

@@ -1,3 +1,4 @@
+export * from './core';
 export * from './ListAction';
 export * from './ListAvatar';
 export * from './ListBox';

package/dist/components/List/index.js

@@ -1,9 +1,12 @@
-import { t as e } from "../../chunks/ListAvatar";
-import { t } from "../../chunks/ListBox";
-import { t as n } from "../../chunks/ListIcon";
-import { t as r } from "../../chunks/ListItem";
-import { t as i } from "../../chunks/ListLabelText";
-import { a, i as o, n as s, o as c, r as l, s as u, t as d } from "../../chunks/ListMedia";
-import { t as f } from "../../chunks/ListOverlineText";
-import { t as p } from "../../chunks/ListSupportingText";
-export { e as ListAvatar, t as ListBox, n as ListIcon, r as ListItem, i as ListLabelText, u as ListMedia, d as ListMediaImageHeight, s as ListMediaImageWidth, l as ListMediaLargeVideoHeight, o as ListMediaLargeVideoWidth, a as ListMediaVideoHeight, c as ListMediaVideoWidth, f as ListOverlineText, p as ListSupportingText };
+import { ListBoxConfigContext as e, useListBoxConfig as t } from "./core/index.js";
+import { t as n } from "../../chunks/ListAction";
+import { t as r } from "../../chunks/ListAvatar";
+import { t as i } from "../../chunks/ListBox";
+import { t as a } from "../../chunks/ListIcon";
+import { t as o } from "../../chunks/ListItem";
+import { t as s } from "../../chunks/ListLabelText";
+import { a as c, i as l, n as u, o as d, r as f, s as p, t as m } from "../../chunks/ListMedia";
+import { t as h } from "../../chunks/ListOverlineText";
+import { t as g } from "../../chunks/ListSupportingText";
+import { t as _ } from "../../chunks/ListTrailingText";
+export { n as ListAction, r as ListAvatar, i as ListBox, e as ListBoxConfigContext, a as ListIcon, o as ListItem, s as ListLabelText, p as ListMedia, m as ListMediaImageHeight, u as ListMediaImageWidth, f as ListMediaLargeVideoHeight, l as ListMediaLargeVideoWidth, c as ListMediaVideoHeight, d as ListMediaVideoWidth, h as ListOverlineText, g as ListSupportingText, _ as ListTrailingText, t as useListBoxConfig };

package/dist/components/Loader/Loader.d.ts

@@ -1,2 +1,27 @@
 import { Icon } from '../Icon';
-export declare const Loader: React.FC<Omit<React.ComponentPropsWithRef<typeof Icon>, "icon" | "className">>;
+/**
+ * Props for the [`Loader`](src/components/Loader/Loader.tsx) component.
+ *
+ * Extends all properties from [`Icon`](src/components/Icon/Icon.tsx)
+ * while omitting `icon` (which is fixed to `LoaderCircle`) and internal `className`.
+ */
+export interface LoaderProps extends Omit<React.ComponentPropsWithRef<typeof Icon>, "icon" | "className"> {
+}
+/**
+ * Circular spinning progress and activity indicator component.
+ *
+ * Built using Lucide's `LoaderCircle` icon with continuous 360-degree rotation animation
+ * to signal ongoing processes or background loading operations.
+ *
+ * @example
+ * ```tsx
+ * import { Loader } from "@adgytec/web-ui-components";
+ *
+ * // Default loader
+ * <Loader />
+ *
+ * // Custom size and color
+ * <Loader size={32} color="var(--md-sys-color-primary)" />
+ * ```
+ */
+export declare const Loader: React.FC<LoaderProps>;

package/dist/components/Loader/index.js

@@ -1,2 +1 @@
-import { t as e } from "../../chunks/Loader";
-export { e as Loader };
+export { t as Loader } from "../../chunks/Loader";

package/dist/components/Menu/Menu/Menu.d.ts

@@ -1,2 +1,32 @@
 import { MenuProps } from './types';
-export declare const Menu: <T extends object>({ color, layout, className, ...props }: MenuProps<T>) => import("react").JSX.Element;
+/**
+ * Material Design 3 Menu component.
+ *
+ * Displays a list of choices on a temporary surface when users interact with a button,
+ * action, or other control. Supports single/multiple selection, submenus, keyboard navigation,
+ * and customizable color schemes and layout densities.
+ *
+ * @example
+ * ```tsx
+ * import {
+ *     MenuTrigger,
+ *     MenuPopover,
+ *     Menu,
+ *     MenuItem,
+ *     Button,
+ * } from "@adgytec/web-ui-components";
+ * import { Settings, User, LogOut } from "lucide-react";
+ *
+ * <MenuTrigger>
+ *     <Button label="Actions" />
+ *     <MenuPopover>
+ *         <Menu onAction={(key) => console.log(key)}>
+ *             <MenuItem id="profile" label="Profile" leadingIcon={User} />
+ *             <MenuItem id="settings" label="Settings" leadingIcon={Settings} />
+ *             <MenuItem id="logout" label="Logout" leadingIcon={LogOut} />
+ *         </Menu>
+ *     </MenuPopover>
+ * </MenuTrigger>
+ * ```
+ */
+export declare const Menu: <T extends object>({ color, layout, className, ...props }: MenuProps<T>) => import('react').JSX.Element;

package/dist/components/Menu/Menu/index.js

@@ -5,7 +5,7 @@ import s from "clsx";
 import { useContext as c } from "react";
 import { jsx as l } from "react/jsx-runtime";
 import { Menu as u } from "react-aria-components";
-//#region src/components/Menu/Menu/Menu.tsx
+// src/components/Menu/Menu/Menu.tsx
 var d = e(), f = (e) => {
 	let f = (0, d.c)(13), p, m, h, g;
 	f[0] === e ? (p = f[1], m = f[2], h = f[3], g = f[4]) : ({color: m, layout: h, className: p, ...g} = e, f[0] = e, f[1] = p, f[2] = m, f[3] = h, f[4] = g);
@@ -19,7 +19,6 @@ var d = e(), f = (e) => {
 		"data-menu": !0
 	}), f[9] = h, f[10] = g, f[11] = x, f[12] = S) : S = f[12], S;
 };
-//#endregion
 export { f as Menu };
 
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["layout"],"sources":["../../../../src/components/Menu/Menu/Menu.tsx"],"sourcesContent":["import clsx from \"clsx\";\nimport { useContext } from \"react\";\nimport { Menu as AriaMenu } from \"react-aria-components\";\nimport { MenuConfigContext } from \"../context\";\nimport {\n    MenuBaseLayout,\n    MenuStyles,\n    menuBaseColor,\n    menuColorConfig,\n    menuLayoutConfig,\n} from \"../core\";\nimport type { MenuProps } from \"./types\";\n\nexport const Menu = <T extends object>({\n    color,\n    layout,\n    className,\n    ...props\n}: MenuProps<T>) => {\n    const { color: configColor, layout: configLayout } =\n        useContext(MenuConfigContext);\n    const menuColor = color ?? configColor ?? \"standard\";\n    const menuLayout = layout ?? configLayout ?? \"standard\";\n\n    return (\n        <AriaMenu\n            className={(renderProps) =>\n                clsx(\n                    menuColorConfig(menuColor),\n                    menuBaseColor,\n                    MenuBaseLayout,\n                    menuLayoutConfig(menuLayout),\n                    MenuStyles,\n                    typeof className === \"function\"\n                        ? className(renderProps)\n                        : className\n                )\n            }\n            {...props}\n            data-layout={layout}\n            data-menu\n        />\n    );\n};\n"],"mappings":";;;;;;;;aAaa,KAAO,MAAA;CAAA,IAAA,KAAA,GAAA,EAAA,EAAA,CAAA,EAAA,GAAA,GAAA,GAAA,GAAA;CAAA,AAAA,EAAA,OAAA,KAKL,IAAA,EAAA,IAAA,IAAA,EAAA,IAAA,IAAA,EAAA,IAAA,IAAA,EAAA,OALwB,uCAAA,KAAA,GAKxB,EAAA,KAAA,GAAA,EAAA,KAAA,GAAA,EAAA,KAAA,GAAA,EAAA,KAAA,GAAA,EAAA,KAAA;CACX,IAAA,EAAA,OAAA,GAAA,QAAA,MACI,EAAW,CAAiB,GAChC,IAAkB,KAAA,KAAA,YAClB,IAAmB,KAAA,KAAA,YAAqC;CAAA,AAAA,EAAA,OAAA,KAAA,EAAA,OAAA,KAAA,EAAA,OAAA,KAIrC,KAAA,MACP,EACI,EAAgB,CAAS,GACzB,GACA,GACA,EAAiB,CAAU,GAC3B,GACA,OAAO,KAAc,aACf,EAAU,CACF,IAFd,CAGJ,GAAC,EAAA,KAAA,GAAA,EAAA,KAAA,GAAA,EAAA,KAAA,GAAA,EAAA,KAAA,KAAA,IAAA,EAAA;CAAA,IAAA;CAKP,OALO,EAAA,OAAA,KAAA,EAAA,QAAA,KAAA,EAAA,QAAA,KAXT,IAAA,kBAAC,GAAD;EACe,WAAA;EAUN,GAED;EACSA,eAAA;EACb,aAAA;CAAS,CAAA,GACX,EAAA,KAAA,GAAA,EAAA,MAAA,GAAA,EAAA,MAAA,GAAA,EAAA,MAAA,KAAA,IAAA,EAAA,KAhBF;AAgBE"}
+{"version":3,"file":"index.js","names":["layout","_c","clsx","AriaMenu","require_compiler_runtime","menuColorConfig","menuLayoutConfig","MenuStyles","MenuBaseLayout","menuBaseColor","clsx$1","Menu$1","import_compiler_runtime","Menu","$","className","color","layout","props","t0","configColor","configLayout","useContext","MenuConfigContext","menuColor","menuLayout","t1","renderProps","t2"],"sources":["../../../../src/components/Menu/Menu/Menu.tsx"],"sourcesContent":["import clsx from \"clsx\";\nimport { useContext } from \"react\";\nimport { Menu as AriaMenu } from \"react-aria-components\";\nimport { MenuConfigContext } from \"../context\";\nimport {\n    MenuBaseLayout,\n    MenuStyles,\n    menuBaseColor,\n    menuColorConfig,\n    menuLayoutConfig,\n} from \"../core\";\nimport type { MenuProps } from \"./types\";\n\n/**\n * Material Design 3 Menu component.\n *\n * Displays a list of choices on a temporary surface when users interact with a button,\n * action, or other control. Supports single/multiple selection, submenus, keyboard navigation,\n * and customizable color schemes and layout densities.\n *\n * @example\n * ```tsx\n * import {\n *     MenuTrigger,\n *     MenuPopover,\n *     Menu,\n *     MenuItem,\n *     Button,\n * } from \"@adgytec/web-ui-components\";\n * import { Settings, User, LogOut } from \"lucide-react\";\n *\n * <MenuTrigger>\n *     <Button label=\"Actions\" />\n *     <MenuPopover>\n *         <Menu onAction={(key) => console.log(key)}>\n *             <MenuItem id=\"profile\" label=\"Profile\" leadingIcon={User} />\n *             <MenuItem id=\"settings\" label=\"Settings\" leadingIcon={Settings} />\n *             <MenuItem id=\"logout\" label=\"Logout\" leadingIcon={LogOut} />\n *         </Menu>\n *     </MenuPopover>\n * </MenuTrigger>\n * ```\n */\nexport const Menu = <T extends object>({\n    color,\n    layout,\n    className,\n    ...props\n}: MenuProps<T>) => {\n    const { color: configColor, layout: configLayout } =\n        useContext(MenuConfigContext);\n    const menuColor = color ?? configColor ?? \"standard\";\n    const menuLayout = layout ?? configLayout ?? \"standard\";\n\n    return (\n        <AriaMenu\n            className={(renderProps) =>\n                clsx(\n                    menuColorConfig(menuColor),\n                    menuBaseColor,\n                    MenuBaseLayout,\n                    menuLayoutConfig(menuLayout),\n                    MenuStyles,\n                    typeof className === \"function\"\n                        ? className(renderProps)\n                        : className\n                )\n            }\n            {...props}\n            data-layout={layout}\n            data-menu\n        />\n    );\n};\n"],"mappings":";;;;;;;;A,aA2Caa,KAAO,MAAA;CAAA,IAAAC,KAAA,GAAAb,EAAAA,EAAAA,CAAA,EAAA,GAAAc,GAAAC,GAAAC,GAAAC;CAAA,AAAAJ,EAAA,OAAAK,KAKL,IAAAL,EAAA,IAAA,IAAAA,EAAA,IAAA,IAAAA,EAAA,IAAA,IAAAA,EAAA,OALwB,oCAAA,GAAAI,KAAAC,GAKxB,EAAA,KAAAA,GAAA,EAAA,KAAAJ,GAAA,EAAA,KAAAC,GAAA,EAAA,KAAAC,GAAA,EAAA,KAAAC;CACX,IAAA,EAAA,OAAAE,GAAA,QAAAC,MACIC,EAAWC,CAAiB,GAChCC,IAAkBR,KAAAI,KAAA,YAClBK,IAAmBR,KAAAI,KAAA,YAAqCK;CAAA,AAAAZ,EAAA,OAAAC,KAAAD,EAAA,OAAAU,KAAAV,EAAA,OAAAW,KAIrC,KAAA,MACPvB,EACIG,EAAgBmB,CAAS,GACzBf,GACAD,GACAF,EAAiBmB,CAAU,GAC3BlB,GACA,OAAOQ,KAAc,aACfA,EAAUY,CACF,IAFdZ,CAGJ,GAAC,EAAA,KAAAA,GAAA,EAAA,KAAAS,GAAA,EAAA,KAAAC,GAAA,EAAA,KAAAC,KAAA,IAAAZ,EAAA;CAAA,IAAAc;CAKP,OALOd,EAAA,OAAAG,KAAAH,EAAA,QAAAI,KAAAJ,EAAA,QAAAY,KAXT,IAAA,kBAACvB,GAAD;EACe,WAAAuB;EAUN,GAEDR;EACSlB,eAAAiB;EACb,aAAA;CAAS,CAAA,GACX,EAAA,KAAAA,GAAA,EAAA,MAAAC,GAAA,EAAA,MAAAQ,GAAA,EAAA,MAAAE,KAAA,IAAAd,EAAA,KAhBFc;AAgBE"}

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

@@ -1,6 +1,24 @@
 import { Menu } from 'react-aria-components';
 import { MenuColor, MenuLayout } from '../core';
+/**
+ * Props for the [`Menu`](src/components/Menu/Menu/Menu.tsx) component.
+ *
+ * Extends all properties from React Aria's `Menu`, including selection management, keyboard navigation,
+ * and collection props.
+ */
 export interface MenuProps<T extends object> extends React.ComponentPropsWithRef<typeof Menu<T>> {
+    /**
+     * Color scheme for the menu surface and its child items.
+     * Overrides any configuration set by the parent [`MenuTrigger`](src/components/Menu/MenuTrigger/MenuTrigger.tsx).
+     *
+     * @default "standard"
+     */
     color?: MenuColor;
+    /**
+     * Layout density for the menu items.
+     * Overrides any configuration set by the parent [`MenuTrigger`](src/components/Menu/MenuTrigger/MenuTrigger.tsx).
+     *
+     * @default "standard"
+     */
     layout?: MenuLayout;
 }

package/dist/components/Menu/MenuItem/MenuItem.d.ts

@@ -1,2 +1,24 @@
 import { MenuItemProps } from './types';
+/**
+ * Material Design 3 interactive menu item component.
+ *
+ * Supports leading icons, selection checkmarks, multi-line supporting descriptions,
+ * trailing shortcuts ([`MenuShortcut`](src/components/Menu/MenuShortcut/MenuShortcut.tsx)),
+ * trailing metadata ([`MenuTrailingText`](src/components/Menu/MenuTrailingText/MenuTrailingText.tsx)),
+ * submenu disclosure chevrons, and touch ripple splash animations.
+ *
+ * @example
+ * ```tsx
+ * import { MenuItem, MenuShortcut } from "@adgytec/web-ui-components";
+ * import { Copy } from "lucide-react";
+ *
+ * <MenuItem
+ *     id="copy"
+ *     label="Copy"
+ *     leadingIcon={Copy}
+ *     trailingText={<MenuShortcut>⌘C</MenuShortcut>}
+ *     onAction={() => handleCopy()}
+ * />
+ * ```
+ */
 export declare const MenuItem: React.FC<MenuItemProps>;

package/dist/components/Menu/MenuItem/index.js

@@ -7,7 +7,7 @@ import u from "clsx";
 import { Fragment as d, jsx as f, jsxs as p } from "react/jsx-runtime";
 import { MenuItem as m } from "react-aria-components";
 import { Check as h, ChevronRight as g } from "lucide-react";
-//#region src/components/Menu/MenuItem/MenuItem.tsx
+// src/components/Menu/MenuItem/MenuItem.tsx
 var _ = e(), v = (e) => {
 	let v = (0, _.c)(24), y, b, x, S, C, w, T, E;
 	v[0] === e ? (y = v[1], b = v[2], x = v[3], S = v[4], C = v[5], w = v[6], T = v[7], E = v[8]) : ({leadingIcon: x, label: b, supportingText: w, trailingText: E, trailingIcon: T, className: y, onPress: S, ...C} = e, v[0] = e, v[1] = y, v[2] = b, v[3] = x, v[4] = S, v[5] = C, v[6] = w, v[7] = T, v[8] = E);
@@ -57,7 +57,6 @@ var _ = e(), v = (e) => {
 		children: j
 	}), v[18] = O, v[19] = C, v[20] = k, v[21] = A, v[22] = j, v[23] = M) : M = v[23], M;
 };
-//#endregion
 export { v as MenuItem };
 
 //# sourceMappingURL=index.js.map

package/dist/components/Menu/MenuItem/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["Check","MenuItemIconSize","leadingIcon","label","supportingText","ChevronRight","trailingIcon","handlePress"],"sources":["../../../../src/components/Menu/MenuItem/MenuItem.tsx"],"sourcesContent":["import clsx from \"clsx\";\nimport { Check, ChevronRight } from \"lucide-react\";\nimport { MenuItem as AriaMenuItem } from \"react-aria-components\";\nimport { Icon } from \"@/components/Icon\";\nimport { Splash } from \"@/components/Splash/Splash\";\nimport { useSplash } from \"@/components/Splash/useSplash\";\nimport { typography } from \"@/utils/typography\";\nimport {\n    MenuItemIconSize,\n    MenuItemLeadingStyles,\n    MenuItemStyles,\n    MenuItemTrailingStyles,\n    menuItemBaseColor,\n    menuItemLabelColor,\n} from \"../core\";\nimport type { MenuItemProps } from \"./types\";\n\nexport const MenuItem: React.FC<MenuItemProps> = ({\n    leadingIcon,\n    label,\n    supportingText,\n    trailingText,\n    trailingIcon,\n    className,\n    onPress,\n    ...props\n}) => {\n    const { splashInfo, handlePress } = useSplash(onPress);\n\n    return (\n        <AriaMenuItem\n            className={(renderProps) =>\n                clsx(\n                    menuItemBaseColor,\n                    MenuItemStyles,\n                    typeof className === \"function\"\n                        ? className(renderProps)\n                        : className\n                )\n            }\n            onPress={handlePress}\n            {...props}\n            data-multi-line={supportingText ? true : undefined}\n        >\n            {({ hasSubmenu, isSelected }) => {\n                return (\n                    <>\n                        {splashInfo && <Splash {...splashInfo} />}\n\n                        {/* leading comps */}\n                        <div className={clsx(MenuItemLeadingStyles)}>\n                            {isSelected ? (\n                                <Icon icon={Check} size={MenuItemIconSize} />\n                            ) : (\n                                leadingIcon && (\n                                    <Icon\n                                        icon={leadingIcon}\n                                        size={MenuItemIconSize}\n                                    />\n                                )\n                            )}\n\n                            <div>\n                                <p\n                                    slot=\"label\"\n                                    className={clsx(\n                                        typography.labelLarge,\n                                        menuItemLabelColor\n                                    )}\n                                >\n                                    {label}\n                                </p>\n\n                                {supportingText && (\n                                    <p\n                                        slot=\"description\"\n                                        className={clsx(typography.bodySmall)}\n                                    >\n                                        {supportingText}\n                                    </p>\n                                )}\n                            </div>\n                        </div>\n\n                        {/* trailing comps */}\n                        <div className={clsx(MenuItemTrailingStyles)}>\n                            {trailingText && trailingText}\n\n                            {hasSubmenu ? (\n                                <Icon\n                                    icon={ChevronRight}\n                                    size={MenuItemIconSize}\n                                />\n                            ) : (\n                                trailingIcon && (\n                                    <Icon\n                                        icon={trailingIcon}\n                                        size={MenuItemIconSize}\n                                    />\n                                )\n                            )}\n                        </div>\n                    </>\n                );\n            }}\n        </AriaMenuItem>\n    );\n};\n"],"mappings":";;;;;;;;;;aAiBa,KAAoC,MAAA;CAAA,IAAA,KAAA,GAAA,EAAA,EAAA,CAAA,EAAA,GAAA,GAAA,GAAA,GAAA,GAAA,GAAA,GAAA,GAAA;CAAA,AAAA,EAAA,OAAA,KAShD,IAAA,EAAA,IAAA,IAAA,EAAA,IAAA,IAAA,EAAA,IAAA,IAAA,EAAA,IAAA,IAAA,EAAA,IAAA,IAAA,EAAA,IAAA,IAAA,EAAA,IAAA,IAAA,EAAA,OATiD,6GAAA,KAAA,GASjD,EAAA,KAAA,GAAA,EAAA,KAAA,GAAA,EAAA,KAAA,GAAA,EAAA,KAAA,GAAA,EAAA,KAAA,GAAA,EAAA,KAAA,GAAA,EAAA,KAAA,GAAA,EAAA,KAAA,GAAA,EAAA,KAAA;CACG,IAAA,EAAA,eAAA,mBAAoC,EAAU,CAAO,GAAE;CAAA,AAAA,EAAA,OAAA,IAW1C,IAAA,EAAA,OAPM,KAAA,MACP,EACI,GACA,GACA,OAAO,KAAc,aACf,EAAU,CACF,IAFd,CAGJ,GAAC,EAAA,KAAA,GAAA,EAAA,MAAA;CAIY,IAAA,IAAA,IAAA,KAAA,KAAA,GAAiC;CAAA,AAAA,EAAA,QAAA,KAAA,EAAA,QAAA,KAAA,EAAA,QAAA,KAAA,EAAA,QAAA,KAAA,EAAA,QAAA,KAAA,EAAA,QAAA,KAEjD,KAAA,MAAA;EAAC,IAAA,EAAA,eAAA,kBAAA;EAA0B,OAEpB,kBAAA,GAAA,EAAA,UAAA;GACK,KAAc,kBAAC,GAAD,EAAO,GAAK,EAAU,CAAA;GAGrC,kBAAA,OAAA;IAAgB,WAAA,EAAK,CAAqB;cAA1C,CACK,IACG,kBAAC,GAAD;KAAYA,MAAA;KAAaC,MAAAA;IAAgB,CAAA,IAEzC,KACI,kBAAC,GAAD;KACUC,MAAA;KACAD,MAAAA;IAAgB,CAAA,GAKlC,kBAAA,OAAA,EAAA,UAAA,CACI,kBAAA,KAAA;KACS,MAAA;KACM,WAAA,EACP,EAAU,YACV,CACJ;eAEC;IACD,CAAA,GAEH,KACG,kBAAA,KAAA;KACS,MAAA;KACM,WAAA,EAAK,EAAU,SAAU;eAEnC;IACD,CAAA,CAEN,EAAA,CAAA,CACJ;;GAGN,kBAAA,OAAA;IAAgB,WAAA,EAAK,CAAsB;cAA3C,CACK,KAAA,GAEA,IACG,kBAAC,GAAD;KACUI,MAAA;KACAJ,MAAAA;IAAgB,CAAA,IAG1B,KACI,kBAAC,GAAD;KACUK,MAAA;KACAL,MAAAA;IAAgB,CAAA,CAIhC;;EAAA,EAAA,CAAA;CACP,GAEV,EAAA,MAAA,GAAA,EAAA,MAAA,GAAA,EAAA,MAAA,GAAA,EAAA,MAAA,GAAA,EAAA,MAAA,GAAA,EAAA,MAAA,GAAA,EAAA,MAAA,KAAA,IAAA,EAAA;CAAA,IAAA;CACU,OADV,EAAA,QAAA,KAAA,EAAA,QAAA,KAAA,EAAA,QAAA,KAAA,EAAA,QAAA,KAAA,EAAA,QAAA,KA1EL,IAAA,kBAAC,GAAD;EACe,WAAA;EASFM,SAAA;EAAW,GAChB;EACa,mBAAA;YAEhB;CAdQ,CAAA,GA2EE,EAAA,MAAA,GAAA,EAAA,MAAA,GAAA,EAAA,MAAA,GAAA,EAAA,MAAA,GAAA,EAAA,MAAA,GAAA,EAAA,MAAA,KAAA,IAAA,EAAA,KA3Ef;AA2Ee"}
+{"version":3,"file":"index.js","names":["Check","MenuItemIconSize","leadingIcon","label","supportingText","ChevronRight","trailingIcon","handlePress","_c","clsx","_Fragment","AriaMenuItem","require_compiler_runtime","Icon","Splash","useSplash","menuItemBaseColor","MenuItemStyles","menuItemLabelColor","MenuItemTrailingStyles","MenuItemLeadingStyles","clsx$1","MenuItem$1","import_compiler_runtime","MenuItem","$","className","label","leadingIcon","onPress","props","supportingText","trailingIcon","trailingText","t0","t1","renderProps","t2","t3","splashInfo","t4","Fragment","isSelected","Check","typography","hasSubmenu","ChevronRight","handlePress"],"sources":["../../../../src/components/Menu/MenuItem/MenuItem.tsx"],"sourcesContent":["import clsx from \"clsx\";\nimport { Check, ChevronRight } from \"lucide-react\";\nimport { MenuItem as AriaMenuItem } from \"react-aria-components\";\nimport { Icon } from \"@/components/Icon\";\nimport { Splash } from \"@/components/Splash/Splash\";\nimport { useSplash } from \"@/components/Splash/useSplash\";\nimport { typography } from \"@/utils/typography\";\nimport {\n    MenuItemIconSize,\n    MenuItemLeadingStyles,\n    MenuItemStyles,\n    MenuItemTrailingStyles,\n    menuItemBaseColor,\n    menuItemLabelColor,\n} from \"../core\";\nimport type { MenuItemProps } from \"./types\";\n\n/**\n * Material Design 3 interactive menu item component.\n *\n * Supports leading icons, selection checkmarks, multi-line supporting descriptions,\n * trailing shortcuts ([`MenuShortcut`](src/components/Menu/MenuShortcut/MenuShortcut.tsx)),\n * trailing metadata ([`MenuTrailingText`](src/components/Menu/MenuTrailingText/MenuTrailingText.tsx)),\n * submenu disclosure chevrons, and touch ripple splash animations.\n *\n * @example\n * ```tsx\n * import { MenuItem, MenuShortcut } from \"@adgytec/web-ui-components\";\n * import { Copy } from \"lucide-react\";\n *\n * <MenuItem\n *     id=\"copy\"\n *     label=\"Copy\"\n *     leadingIcon={Copy}\n *     trailingText={<MenuShortcut>⌘C</MenuShortcut>}\n *     onAction={() => handleCopy()}\n * />\n * ```\n */\nexport const MenuItem: React.FC<MenuItemProps> = ({\n    leadingIcon,\n    label,\n    supportingText,\n    trailingText,\n    trailingIcon,\n    className,\n    onPress,\n    ...props\n}) => {\n    const { splashInfo, handlePress } = useSplash(onPress);\n\n    return (\n        <AriaMenuItem\n            className={(renderProps) =>\n                clsx(\n                    menuItemBaseColor,\n                    MenuItemStyles,\n                    typeof className === \"function\"\n                        ? className(renderProps)\n                        : className\n                )\n            }\n            onPress={handlePress}\n            {...props}\n            data-multi-line={supportingText ? true : undefined}\n        >\n            {({ hasSubmenu, isSelected }) => {\n                return (\n                    <>\n                        {splashInfo && <Splash {...splashInfo} />}\n\n                        {/* leading comps */}\n                        <div className={clsx(MenuItemLeadingStyles)}>\n                            {isSelected ? (\n                                <Icon icon={Check} size={MenuItemIconSize} />\n                            ) : (\n                                leadingIcon && (\n                                    <Icon\n                                        icon={leadingIcon}\n                                        size={MenuItemIconSize}\n                                    />\n                                )\n                            )}\n\n                            <div>\n                                <p\n                                    slot=\"label\"\n                                    className={clsx(\n                                        typography.labelLarge,\n                                        menuItemLabelColor\n                                    )}\n                                >\n                                    {label}\n                                </p>\n\n                                {supportingText && (\n                                    <p\n                                        slot=\"description\"\n                                        className={clsx(typography.bodySmall)}\n                                    >\n                                        {supportingText}\n                                    </p>\n                                )}\n                            </div>\n                        </div>\n\n                        {/* trailing comps */}\n                        <div className={clsx(MenuItemTrailingStyles)}>\n                            {trailingText && trailingText}\n\n                            {hasSubmenu ? (\n                                <Icon\n                                    icon={ChevronRight}\n                                    size={MenuItemIconSize}\n                                />\n                            ) : (\n                                trailingIcon && (\n                                    <Icon\n                                        icon={trailingIcon}\n                                        size={MenuItemIconSize}\n                                    />\n                                )\n                            )}\n                        </div>\n                    </>\n                );\n            }}\n        </AriaMenuItem>\n    );\n};\n"],"mappings":";;;;;;;;;;A,aAuCawB,KAAoC,MAAA;CAAA,IAAAC,KAAA,GAAAjB,EAAAA,EAAAA,CAAA,EAAA,GAAAkB,GAAAC,GAAAC,GAAAC,GAAAC,GAAAC,GAAAC,GAAAC;CAAA,AAAAR,EAAA,OAAAS,KAShD,IAAAT,EAAA,IAAA,IAAAA,EAAA,IAAA,IAAAA,EAAA,IAAA,IAAAA,EAAA,IAAA,IAAAA,EAAA,IAAA,IAAAA,EAAA,IAAA,IAAAA,EAAA,IAAA,IAAAA,EAAA,OATiD,0GAAA,GAAAK,KAAAI,GASjD,EAAA,KAAAA,GAAA,EAAA,KAAAR,GAAA,EAAA,KAAAC,GAAA,EAAA,KAAAC,GAAA,EAAA,KAAAC,GAAA,EAAA,KAAAC,GAAA,EAAA,KAAAC,GAAA,EAAA,KAAAC,GAAA,EAAA,KAAAC;CACG,IAAA,EAAA,eAAA,mBAAoClB,EAAUc,CAAO,GAAEM;CAAA,AAAAV,EAAA,OAAAC,IAW1C,IAAAD,EAAA,OAPM,KAAA,MACPhB,EACIO,GACAC,GACA,OAAOS,KAAc,aACfA,EAAUU,CACF,IAFdV,CAGJ,GAAC,EAAA,KAAAA,GAAA,EAAA,MAAAS;CAIY,IAAAE,IAAAN,IAAA,KAAA,KAAA,GAAiCO;CAAA,AAAAb,EAAA,QAAAE,KAAAF,EAAA,QAAAG,KAAAH,EAAA,QAAAc,KAAAd,EAAA,QAAAM,KAAAN,EAAA,QAAAO,KAAAP,EAAA,QAAAQ,KAEjD,KAAA,MAAA;EAAC,IAAA,EAAA,eAAA,kBAAAO;EAA0B,OAEpB,kBAAA9B,GAAA,EAAA,UAAA;GACK6B,KAAc,kBAACzB,GAAD,EAAO,GAAKyB,EAAU,CAAA;GAGrC,kBAAA,OAAA;IAAgB,WAAA9B,EAAKW,CAAqB;IAA1C,UAAA,CACKsB,IACG,kBAAC7B,GAAD;KAAYb,MAAA2C;KAAa1C,MAAAA;IAAgB,CAAA,IAEzC2B,KACI,kBAACf,GAAD;KACUX,MAAA0B;KACA3B,MAAAA;IAAgB,CAAA,GAKlC,kBAAA,OAAA,EAAA,UAAA,CACI,kBAAA,KAAA;KACS,MAAA;KACM,WAAAQ,EACPmC,EAAU,YACV1B,CACJ;KAEC,UAAAS;IACD,CAAA,GAEHI,KACG,kBAAA,KAAA;KACS,MAAA;KACM,WAAAtB,EAAKmC,EAAU,SAAU;KAEnC,UAAAb;IACD,CAAA,CAEN,EAAA,CAAA,CACJ;;GAGN,kBAAA,OAAA;IAAgB,WAAAtB,EAAKU,CAAsB;IAA3C,UAAA,CACKc,KAAAA,GAEAY,IACG,kBAAChC,GAAD;KACUR,MAAAyC;KACA7C,MAAAA;IAAgB,CAAA,IAG1B+B,KACI,kBAACnB,GAAD;KACUP,MAAA0B;KACA/B,MAAAA;IAAgB,CAAA,CAIhC;;EAAA,EAAA,CAAA;CACP,GAEV,EAAA,MAAA0B,GAAA,EAAA,MAAAC,GAAA,EAAA,MAAAW,GAAA,EAAA,MAAAR,GAAA,EAAA,MAAAC,GAAA,EAAA,MAAAC,GAAA,EAAA,MAAAK,KAAA,IAAAb,EAAA;CAAA,IAAAe;CACU,OADVf,EAAA,QAAAsB,KAAAtB,EAAA,QAAAK,KAAAL,EAAA,QAAAU,KAAAV,EAAA,QAAAY,KAAAZ,EAAA,QAAAa,KA1EL,IAAA,kBAAC3B,GAAD;EACe,WAAAwB;EASF5B,SAAAwC;EAAW,GAChBjB;EACa,mBAAAO;EAEhB,UAAAC;CAdQ,CAAA,GA2EE,EAAA,MAAAS,GAAA,EAAA,MAAAjB,GAAA,EAAA,MAAAK,GAAA,EAAA,MAAAE,GAAA,EAAA,MAAAC,GAAA,EAAA,MAAAE,KAAA,IAAAf,EAAA,KA3Efe;AA2Ee"}

package/dist/components/Menu/MenuItem/types.d.ts

@@ -1,10 +1,34 @@
 import { LucideIcon } from 'lucide-react';
 import { ReactNode } from 'react';
 import { MenuItem } from 'react-aria-components';
+/**
+ * Props for the [`MenuItem`](src/components/Menu/MenuItem/MenuItem.tsx) component.
+ *
+ * Provides dedicated props for icons, labels, descriptions, and trailing metadata.
+ */
 export interface MenuItemProps extends Omit<React.ComponentPropsWithRef<typeof MenuItem>, "children"> {
+    /**
+     * Optional icon displayed at the start of the item.
+     * When the item is in a selected state, a checkmark icon automatically replaces this.
+     */
     leadingIcon?: LucideIcon;
+    /**
+     * The primary text content for the menu item.
+     */
     label: string;
+    /**
+     * Optional secondary descriptive text displayed beneath the primary label.
+     */
     supportingText?: string;
+    /**
+     * Optional metadata or shortcut text displayed at the trailing edge of the item,
+     * such as [`MenuShortcut`](src/components/Menu/MenuShortcut/MenuShortcut.tsx)
+     * or [`MenuTrailingText`](src/components/Menu/MenuTrailingText/MenuTrailingText.tsx).
+     */
     trailingText?: ReactNode;
+    /**
+     * Optional icon displayed at the trailing end of the item.
+     * When the item triggers a nested submenu, a chevron icon automatically takes precedence.
+     */
     trailingIcon?: LucideIcon;
 }

package/dist/components/Menu/MenuPopover/MenuPopover.d.ts

@@ -1,2 +1,22 @@
 import { Popover } from '../../Popover';
-export declare const MenuPopover: React.FC<React.ComponentPropsWithRef<typeof Popover>>;
+/**
+ * Props for the [`MenuPopover`](src/components/Menu/MenuPopover/MenuPopover.tsx) component.
+ */
+export interface MenuPopoverProps extends React.ComponentPropsWithRef<typeof Popover> {
+}
+/**
+ * Surface overlay container for the [`Menu`](src/components/Menu/Menu/Menu.tsx) component.
+ *
+ * Wraps [`Popover`](src/components/Popover/Popover.tsx)
+ * with Material Design 3 surface styling, rounded corners, and shadow elevation.
+ *
+ * @example
+ * ```tsx
+ * <MenuPopover placement="bottom start">
+ *     <Menu>
+ *         <MenuItem label="Settings" />
+ *     </Menu>
+ * </MenuPopover>
+ * ```
+ */
+export declare const MenuPopover: React.FC<MenuPopoverProps>;

package/dist/components/Menu/MenuPopover/index.js

@@ -1,2 +1 @@
-import { t as e } from "../../../chunks/MenuPopover";
-export { e as MenuPopover };
+export { t as MenuPopover } from "../../../chunks/MenuPopover";

package/dist/components/Menu/MenuSection/MenuSection.d.ts

@@ -1,2 +1,24 @@
 import { MenuSection as AriaMenuSection } from 'react-aria-components';
-export declare const MenuSection: <T extends object>({ className, ...props }: React.ComponentPropsWithRef<typeof AriaMenuSection<T>>) => import("react").JSX.Element;
+/**
+ * Props for the [`MenuSection`](src/components/Menu/MenuSection/MenuSection.tsx) component.
+ */
+export interface MenuSectionProps<T extends object> extends React.ComponentPropsWithRef<typeof AriaMenuSection<T>> {
+}
+/**
+ * Groups related menu items into logical sections within a [`Menu`](src/components/Menu/Menu/Menu.tsx).
+ *
+ * Typically contains a [`MenuSectionHeader`](src/components/Menu/MenuSectionHeader/MenuSectionHeader.tsx)
+ * and one or more [`MenuItem`](src/components/Menu/MenuItem/MenuItem.tsx) components.
+ *
+ * @example
+ * ```tsx
+ * import { MenuSection, MenuSectionHeader, MenuItem } from "@adgytec/web-ui-components";
+ *
+ * <MenuSection>
+ *     <MenuSectionHeader>Document Actions</MenuSectionHeader>
+ *     <MenuItem label="Print" />
+ *     <MenuItem label="Export as PDF" />
+ * </MenuSection>
+ * ```
+ */
+export declare const MenuSection: <T extends object>({ className, ...props }: MenuSectionProps<T>) => import('react').JSX.Element;

package/dist/components/Menu/MenuSection/index.js

@@ -3,7 +3,7 @@ import { a as t } from "../../../chunks/core6";
 import n from "clsx";
 import { jsx as r } from "react/jsx-runtime";
 import { MenuSection as i } from "react-aria-components";
-//#region src/components/Menu/MenuSection/MenuSection.tsx
+// src/components/Menu/MenuSection/MenuSection.tsx
 var a = e(), o = (e) => {
 	let o = (0, a.c)(8), s, c;
 	o[0] === e ? (s = o[1], c = o[2]) : ({className: s, ...c} = e, o[0] = e, o[1] = s, o[2] = c);
@@ -16,7 +16,6 @@ var a = e(), o = (e) => {
 		"data-menu-section": !0
 	}), o[5] = c, o[6] = l, o[7] = u) : u = o[7], u;
 };
-//#endregion
 export { o as MenuSection };
 
 //# sourceMappingURL=index.js.map

package/dist/components/Menu/MenuSection/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../../../src/components/Menu/MenuSection/MenuSection.tsx"],"sourcesContent":["import clsx from \"clsx\";\nimport { MenuSection as AriaMenuSection } from \"react-aria-components\";\nimport { MenuSectionStyles } from \"../core\";\n\nexport const MenuSection = <T extends object>({\n    className,\n    ...props\n}: React.ComponentPropsWithRef<typeof AriaMenuSection<T>>) => {\n    return (\n        <AriaMenuSection\n            className={clsx(MenuSectionStyles, className)}\n            {...props}\n            data-menu-section\n        />\n    );\n};\n"],"mappings":";;;;;;aAIa,KAAc,MAAA;CAAA,IAAA,KAAA,GAAA,EAAA,EAAA,CAAA,CAAA,GAAA,GAAA;CAAA,AAAA,EAAA,OAAA,KAG8B,IAAA,EAAA,IAAA,IAAA,EAAA,OAHX,kBAAA,KAAA,GAGW,EAAA,KAAA,GAAA,EAAA,KAAA,GAAA,EAAA,KAAA;CAAA,IAAA;CAAA,AAAA,EAAA,OAAA,IAGA,IAAA,EAAA,MAAlC,IAAA,EAAK,GAAmB,CAAS,GAAC,EAAA,KAAA,GAAA,EAAA,KAAA;CAAA,IAAA;CAG/C,OAH+C,EAAA,OAAA,KAAA,EAAA,OAAA,KADjD,IAAA,kBAAC,GAAD;EACe,WAAA;EAAkC,GACzC;EACJ,qBAAA;CAAiB,CAAA,GACnB,EAAA,KAAA,GAAA,EAAA,KAAA,GAAA,EAAA,KAAA,KAAA,IAAA,EAAA,IAJF;AAIE"}
+{"version":3,"file":"index.js","names":["_c","clsx","AriaMenuSection","require_compiler_runtime","MenuSectionStyles","clsx$1","MenuSection$1","import_compiler_runtime","MenuSection","$","className","props","t0","t1","t2"],"sources":["../../../../src/components/Menu/MenuSection/MenuSection.tsx"],"sourcesContent":["import clsx from \"clsx\";\nimport { MenuSection as AriaMenuSection } from \"react-aria-components\";\nimport { MenuSectionStyles } from \"../core\";\n\n/**\n * Props for the [`MenuSection`](src/components/Menu/MenuSection/MenuSection.tsx) component.\n */\nexport interface MenuSectionProps<T extends object>\n    extends React.ComponentPropsWithRef<typeof AriaMenuSection<T>> {}\n\n/**\n * Groups related menu items into logical sections within a [`Menu`](src/components/Menu/Menu/Menu.tsx).\n *\n * Typically contains a [`MenuSectionHeader`](src/components/Menu/MenuSectionHeader/MenuSectionHeader.tsx)\n * and one or more [`MenuItem`](src/components/Menu/MenuItem/MenuItem.tsx) components.\n *\n * @example\n * ```tsx\n * import { MenuSection, MenuSectionHeader, MenuItem } from \"@adgytec/web-ui-components\";\n *\n * <MenuSection>\n *     <MenuSectionHeader>Document Actions</MenuSectionHeader>\n *     <MenuItem label=\"Print\" />\n *     <MenuItem label=\"Export as PDF\" />\n * </MenuSection>\n * ```\n */\nexport const MenuSection = <T extends object>({\n    className,\n    ...props\n}: MenuSectionProps<T>) => {\n    return (\n        <AriaMenuSection\n            className={clsx(MenuSectionStyles, className)}\n            {...props}\n            data-menu-section\n        />\n    );\n};\n"],"mappings":";;;;;;A,aA2BaQ,KAAc,MAAA;CAAA,IAAAC,KAAA,GAAAT,EAAAA,EAAAA,CAAA,CAAA,GAAAU,GAAAC;CAAA,AAAAF,EAAA,OAAAG,KAGL,IAAAH,EAAA,IAAA,IAAAA,EAAA,OAHwB,eAAA,GAAAE,KAAAC,GAGxB,EAAA,KAAAA,GAAA,EAAA,KAAAF,GAAA,EAAA,KAAAC;CAAA,IAAAE;CAAA,AAAAJ,EAAA,OAAAC,IAGmC,IAAAD,EAAA,MAAlC,IAAAR,EAAKG,GAAmBM,CAAS,GAAC,EAAA,KAAAA,GAAA,EAAA,KAAAG;CAAA,IAAAC;CAG/C,OAH+CL,EAAA,OAAAE,KAAAF,EAAA,OAAAI,KADjD,IAAA,kBAACX,GAAD;EACe,WAAAW;EAAkC,GACzCF;EACJ,qBAAA;CAAiB,CAAA,GACnB,EAAA,KAAAA,GAAA,EAAA,KAAAE,GAAA,EAAA,KAAAC,KAAA,IAAAL,EAAA,IAJFK;AAIE"}

package/dist/components/Menu/MenuSectionHeader/MenuSectionHeader.d.ts

@@ -1 +1,16 @@
-export declare const MenuSectionHeader: React.FC<React.ComponentPropsWithRef<"header">>;
+/**
+ * Props for the [`MenuSectionHeader`](src/components/Menu/MenuSectionHeader/MenuSectionHeader.tsx) component.
+ */
+export interface MenuSectionHeaderProps extends React.ComponentPropsWithRef<"header"> {
+}
+/**
+ * Section header title rendered at the top of a [`MenuSection`](src/components/Menu/MenuSection/MenuSection.tsx).
+ *
+ * Styled with Material Design 3 `labelLarge` typography and accessible section header semantics.
+ *
+ * @example
+ * ```tsx
+ * <MenuSectionHeader>Preferences</MenuSectionHeader>
+ * ```
+ */
+export declare const MenuSectionHeader: React.FC<MenuSectionHeaderProps>;

package/dist/components/Menu/MenuSectionHeader/index.js

@@ -4,7 +4,7 @@ import { i as n } from "../../../chunks/core6";
 import r from "clsx";
 import { jsx as i } from "react/jsx-runtime";
 import { Header as a } from "react-aria-components";
-//#region src/components/Menu/MenuSectionHeader/MenuSectionHeader.tsx
+// src/components/Menu/MenuSectionHeader/MenuSectionHeader.tsx
 var o = e(), s = (e) => {
 	let s = (0, o.c)(8), c, l;
 	s[0] === e ? (c = s[1], l = s[2]) : ({className: c, ...l} = e, s[0] = e, s[1] = c, s[2] = l);
@@ -16,7 +16,6 @@ var o = e(), s = (e) => {
 		...l
 	}), s[5] = l, s[6] = u, s[7] = d) : d = s[7], d;
 };
-//#endregion
 export { s as MenuSectionHeader };
 
 //# sourceMappingURL=index.js.map

package/dist/components/Menu/MenuSectionHeader/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../../../src/components/Menu/MenuSectionHeader/MenuSectionHeader.tsx"],"sourcesContent":["import clsx from \"clsx\";\nimport { Header } from \"react-aria-components\";\nimport { typography } from \"@/utils\";\nimport { MenuSectionHeaderStyles } from \"../core\";\n\nexport const MenuSectionHeader: React.FC<\n    React.ComponentPropsWithRef<\"header\">\n> = ({ className, ...props }) => {\n    return (\n        <Header\n            className={clsx(\n                typography.labelLarge,\n                MenuSectionHeaderStyles,\n                className\n            )}\n            {...props}\n        />\n    );\n};\n"],"mappings":";;;;;;;aAKa,KAET,MAAA;CAAA,IAAA,KAAA,GAAA,EAAA,EAAA,CAAA,CAAA,GAAA,GAAA;CAAA,AAAA,EAAA,OAAA,KAAwB,IAAA,EAAA,IAAA,IAAA,EAAA,OAAvB,kBAAA,KAAA,GAAuB,EAAA,KAAA,GAAA,EAAA,KAAA,GAAA,EAAA,KAAA;CAAA,IAAA;CAAA,AAAA,EAAA,OAAA,IAOf,IAAA,EAAA,MAJU,IAAA,EACP,EAAU,YACV,GACA,CACJ,GAAC,EAAA,KAAA,GAAA,EAAA,KAAA;CAAA,IAAA;CAEH,OAFG,EAAA,OAAA,KAAA,EAAA,OAAA,KALL,IAAA,kBAAC,GAAD;EACe,WAAA;EAIV,GACG;CAAK,CAAA,GACX,EAAA,KAAA,GAAA,EAAA,KAAA,GAAA,EAAA,KAAA,KAAA,IAAA,EAAA,IAPF;AAOE"}
+{"version":3,"file":"index.js","names":["_c","clsx","require_compiler_runtime","MenuSectionHeaderStyles","clsx$1","import_compiler_runtime","MenuSectionHeader","$","className","props","t0","t1","typography","t2","Header"],"sources":["../../../../src/components/Menu/MenuSectionHeader/MenuSectionHeader.tsx"],"sourcesContent":["import clsx from \"clsx\";\nimport { Header } from \"react-aria-components\";\nimport { typography } from \"@/utils\";\nimport { MenuSectionHeaderStyles } from \"../core\";\n\n/**\n * Props for the [`MenuSectionHeader`](src/components/Menu/MenuSectionHeader/MenuSectionHeader.tsx) component.\n */\nexport interface MenuSectionHeaderProps\n    extends React.ComponentPropsWithRef<\"header\"> {}\n\n/**\n * Section header title rendered at the top of a [`MenuSection`](src/components/Menu/MenuSection/MenuSection.tsx).\n *\n * Styled with Material Design 3 `labelLarge` typography and accessible section header semantics.\n *\n * @example\n * ```tsx\n * <MenuSectionHeader>Preferences</MenuSectionHeader>\n * ```\n */\nexport const MenuSectionHeader: React.FC<MenuSectionHeaderProps> = ({\n    className,\n    ...props\n}) => {\n    return (\n        <Header\n            className={clsx(\n                typography.labelLarge,\n                MenuSectionHeaderStyles,\n                className\n            )}\n            {...props}\n        />\n    );\n};\n"],"mappings":";;;;;;;A,aAqBaM,KAAsD,MAAA;CAAA,IAAAC,KAAA,GAAAP,EAAAA,EAAAA,CAAA,CAAA,GAAAQ,GAAAC;CAAA,AAAAF,EAAA,OAAAG,KAGlE,IAAAH,EAAA,IAAA,IAAAA,EAAA,OAHmE,eAAA,GAAAE,KAAAC,GAGnE,EAAA,KAAAA,GAAA,EAAA,KAAAF,GAAA,EAAA,KAAAC;CAAA,IAAAE;CAAA,AAAAJ,EAAA,OAAAC,IAOY,IAAAD,EAAA,MAJU,IAAAN,EACPW,EAAU,YACVT,GACAK,CACJ,GAAC,EAAA,KAAAA,GAAA,EAAA,KAAAG;CAAA,IAAAE;CAEH,OAFGN,EAAA,OAAAE,KAAAF,EAAA,OAAAI,KALL,IAAA,kBAACG,GAAD;EACe,WAAAH;EAIV,GACGF;CAAK,CAAA,GACX,EAAA,KAAAA,GAAA,EAAA,KAAAE,GAAA,EAAA,KAAAE,KAAA,IAAAN,EAAA,IAPFM;AAOE"}

package/dist/components/Menu/MenuShortcut/MenuShortcut.d.ts

@@ -1 +1,16 @@
-export declare const MenuShortcut: React.FC<React.ComponentPropsWithRef<"kbd">>;
+/**
+ * Props for the [`MenuShortcut`](src/components/Menu/MenuShortcut/MenuShortcut.tsx) component.
+ */
+export interface MenuShortcutProps extends React.ComponentPropsWithRef<"kbd"> {
+}
+/**
+ * Keyboard shortcut badge (`<kbd>`) displayed at the trailing edge of a [`MenuItem`](src/components/Menu/MenuItem/MenuItem.tsx).
+ *
+ * Styled with Material Design 3 `labelLarge` typography and appropriate contrast.
+ *
+ * @example
+ * ```tsx
+ * <MenuShortcut>⌘S</MenuShortcut>
+ * ```
+ */
+export declare const MenuShortcut: React.FC<MenuShortcutProps>;