@adgytec/adgytec-web-ui-components 2.2.0 → 2.3.1

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":";;;;;;;;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`](file:///home/rohan/work/adgytec/adgytec-web-ui-components/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`](file:///home/rohan/work/adgytec/adgytec-web-ui-components/src/components/Menu/MenuTrigger/MenuTrigger.tsx).
+     *
+     * @default "standard"
+     */
     color?: MenuColor;
+    /**
+     * Layout density for the menu items.
+     * Overrides any configuration set by the parent [`MenuTrigger`](file:///home/rohan/work/adgytec/adgytec-web-ui-components/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`](file:///home/rohan/work/adgytec/adgytec-web-ui-components/src/components/Menu/MenuShortcut/MenuShortcut.tsx)),
+ * trailing metadata ([`MenuTrailingText`](file:///home/rohan/work/adgytec/adgytec-web-ui-components/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.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`](file:///home/rohan/work/adgytec/adgytec-web-ui-components/src/components/Menu/MenuShortcut/MenuShortcut.tsx)),\n * trailing metadata ([`MenuTrailingText`](file:///home/rohan/work/adgytec/adgytec-web-ui-components/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":";;;;;;;;;;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`](file:///home/rohan/work/adgytec/adgytec-web-ui-components/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`](file:///home/rohan/work/adgytec/adgytec-web-ui-components/src/components/Menu/MenuShortcut/MenuShortcut.tsx)
+     * or [`MenuTrailingText`](file:///home/rohan/work/adgytec/adgytec-web-ui-components/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`](file:///home/rohan/work/adgytec/adgytec-web-ui-components/src/components/Menu/MenuPopover/MenuPopover.tsx) component.
+ */
+export interface MenuPopoverProps extends React.ComponentPropsWithRef<typeof Popover> {
+}
+/**
+ * Surface overlay container for the [`Menu`](file:///home/rohan/work/adgytec/adgytec-web-ui-components/src/components/Menu/Menu/Menu.tsx) component.
+ *
+ * Wraps [`Popover`](file:///home/rohan/work/adgytec/adgytec-web-ui-components/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/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`](file:///home/rohan/work/adgytec/adgytec-web-ui-components/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`](file:///home/rohan/work/adgytec/adgytec-web-ui-components/src/components/Menu/Menu/Menu.tsx).
+ *
+ * Typically contains a [`MenuSectionHeader`](file:///home/rohan/work/adgytec/adgytec-web-ui-components/src/components/Menu/MenuSectionHeader/MenuSectionHeader.tsx)
+ * and one or more [`MenuItem`](file:///home/rohan/work/adgytec/adgytec-web-ui-components/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.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`](file:///home/rohan/work/adgytec/adgytec-web-ui-components/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`](file:///home/rohan/work/adgytec/adgytec-web-ui-components/src/components/Menu/Menu/Menu.tsx).\n *\n * Typically contains a [`MenuSectionHeader`](file:///home/rohan/work/adgytec/adgytec-web-ui-components/src/components/Menu/MenuSectionHeader/MenuSectionHeader.tsx)\n * and one or more [`MenuItem`](file:///home/rohan/work/adgytec/adgytec-web-ui-components/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":";;;;;;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`](file:///home/rohan/work/adgytec/adgytec-web-ui-components/src/components/Menu/MenuSectionHeader/MenuSectionHeader.tsx) component.
+ */
+export interface MenuSectionHeaderProps extends React.ComponentPropsWithRef<"header"> {
+}
+/**
+ * Section header title rendered at the top of a [`MenuSection`](file:///home/rohan/work/adgytec/adgytec-web-ui-components/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.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`](file:///home/rohan/work/adgytec/adgytec-web-ui-components/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`](file:///home/rohan/work/adgytec/adgytec-web-ui-components/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":";;;;;;;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`](file:///home/rohan/work/adgytec/adgytec-web-ui-components/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`](file:///home/rohan/work/adgytec/adgytec-web-ui-components/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>;

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../../../src/components/Menu/MenuShortcut/MenuShortcut.tsx"],"sourcesContent":["import clsx from \"clsx\";\nimport { typography } from \"@/utils/typography\";\n\nexport const MenuShortcut: React.FC<React.ComponentPropsWithRef<\"kbd\">> = ({\n    className,\n    ...props\n}) => {\n    return (\n        <kbd className={clsx(typography.labelLarge, className)} {...props} />\n    );\n};\n"],"mappings":";;;;;aAGa,KAA6D,MAAA;CAAA,IAAA,KAAA,GAAA,EAAA,EAAA,CAAA,CAAA,GAAA,GAAA;CAAA,AAAA,EAAA,OAAA,KAGzE,IAAA,EAAA,IAAA,IAAA,EAAA,OAH0E,kBAAA,KAAA,GAG1E,EAAA,KAAA,GAAA,EAAA,KAAA,GAAA,EAAA,KAAA;CAAA,IAAA;CAAA,AAAA,EAAA,OAAA,IAE6D,IAAA,EAAA,MAAtC,IAAA,EAAK,EAAU,YAAa,CAAS,GAAC,EAAA,KAAA,GAAA,EAAA,KAAA;CAAA,IAAA;CAAe,OAAf,EAAA,OAAA,KAAA,EAAA,OAAA,KAAtD,IAAA,kBAAA,OAAA;EAAgB,WAAA;EAAsC,GAAM;CAAK,CAAA,GAAI,EAAA,KAAA,GAAA,EAAA,KAAA,GAAA,EAAA,KAAA,KAAA,IAAA,EAAA,IAArE;AAAqE"}
+{"version":3,"file":"index.js","names":["_c","clsx","require_compiler_runtime","clsx$1","import_compiler_runtime","MenuShortcut","$","className","props","t0","t1","typography","t2"],"sources":["../../../../src/components/Menu/MenuShortcut/MenuShortcut.tsx"],"sourcesContent":["import clsx from \"clsx\";\nimport { typography } from \"@/utils/typography\";\n\n/**\n * Props for the [`MenuShortcut`](file:///home/rohan/work/adgytec/adgytec-web-ui-components/src/components/Menu/MenuShortcut/MenuShortcut.tsx) component.\n */\nexport interface MenuShortcutProps extends React.ComponentPropsWithRef<\"kbd\"> {}\n\n/**\n * Keyboard shortcut badge (`<kbd>`) displayed at the trailing edge of a [`MenuItem`](file:///home/rohan/work/adgytec/adgytec-web-ui-components/src/components/Menu/MenuItem/MenuItem.tsx).\n *\n * Styled with Material Design 3 `labelLarge` typography and appropriate contrast.\n *\n * @example\n * ```tsx\n * <MenuShortcut>⌘S</MenuShortcut>\n * ```\n */\nexport const MenuShortcut: React.FC<MenuShortcutProps> = ({\n    className,\n    ...props\n}) => {\n    return (\n        <kbd className={clsx(typography.labelLarge, className)} {...props} />\n    );\n};\n"],"mappings":";;;;;aAkBaK,KAA4C,MAAA;CAAA,IAAAC,KAAA,GAAAN,EAAAA,EAAAA,CAAA,CAAA,GAAAO,GAAAC;CAAA,AAAAF,EAAA,OAAAG,KAGxD,IAAAH,EAAA,IAAA,IAAAA,EAAA,OAHyD,eAAA,GAAAE,KAAAC,GAGzD,EAAA,KAAAA,GAAA,EAAA,KAAAF,GAAA,EAAA,KAAAC;CAAA,IAAAE;CAAA,AAAAJ,EAAA,OAAAC,IAE6D,IAAAD,EAAA,MAAtC,IAAAL,EAAKU,EAAU,YAAaJ,CAAS,GAAC,EAAA,KAAAA,GAAA,EAAA,KAAAG;CAAA,IAAAE;CAAe,OAAfN,EAAA,OAAAE,KAAAF,EAAA,OAAAI,KAAtD,IAAA,kBAAA,OAAA;EAAgB,WAAAA;EAAsC,GAAMF;CAAK,CAAA,GAAI,EAAA,KAAAA,GAAA,EAAA,KAAAE,GAAA,EAAA,KAAAE,KAAA,IAAAN,EAAA,IAArEM;AAAqE"}

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

@@ -1 +1,16 @@
-export declare const MenuTrailingText: React.FC<React.ComponentPropsWithRef<"p">>;
+/**
+ * Props for the [`MenuTrailingText`](file:///home/rohan/work/adgytec/adgytec-web-ui-components/src/components/Menu/MenuTrailingText/MenuTrailingText.tsx) component.
+ */
+export interface MenuTrailingTextProps extends React.ComponentPropsWithRef<"p"> {
+}
+/**
+ * Secondary metadata or descriptive text placed at the trailing edge of a [`MenuItem`](file:///home/rohan/work/adgytec/adgytec-web-ui-components/src/components/Menu/MenuItem/MenuItem.tsx).
+ *
+ * Styled with Material Design 3 `labelLarge` typography.
+ *
+ * @example
+ * ```tsx
+ * <MenuTrailingText>New</MenuTrailingText>
+ * ```
+ */
+export declare const MenuTrailingText: React.FC<MenuTrailingTextProps>;

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../../../src/components/Menu/MenuTrailingText/MenuTrailingText.tsx"],"sourcesContent":["import clsx from \"clsx\";\nimport { typography } from \"@/utils/typography\";\n\nexport const MenuTrailingText: React.FC<React.ComponentPropsWithRef<\"p\">> = ({\n    className,\n    ...props\n}) => {\n    return <p className={clsx(typography.labelLarge, className)} {...props} />;\n};\n"],"mappings":";;;;;aAGa,KAA+D,MAAA;CAAA,IAAA,KAAA,GAAA,EAAA,EAAA,CAAA,CAAA,GAAA,GAAA;CAAA,AAAA,EAAA,OAAA,KAG3E,IAAA,EAAA,IAAA,IAAA,EAAA,OAH4E,kBAAA,KAAA,GAG5E,EAAA,KAAA,GAAA,EAAA,KAAA,GAAA,EAAA,KAAA;CAAA,IAAA;CAAA,AAAA,EAAA,OAAA,IAC8D,IAAA,EAAA,MAAtC,IAAA,EAAK,EAAU,YAAa,CAAS,GAAC,EAAA,KAAA,GAAA,EAAA,KAAA;CAAA,IAAA;CAAe,OAAf,EAAA,OAAA,KAAA,EAAA,OAAA,KAApD,IAAA,kBAAA,KAAA;EAAc,WAAA;EAAsC,GAAM;CAAK,CAAA,GAAI,EAAA,KAAA,GAAA,EAAA,KAAA,GAAA,EAAA,KAAA,KAAA,IAAA,EAAA,IAAnE;AAAmE"}
+{"version":3,"file":"index.js","names":["_c","clsx","require_compiler_runtime","clsx$1","import_compiler_runtime","MenuTrailingText","$","className","props","t0","t1","typography","t2"],"sources":["../../../../src/components/Menu/MenuTrailingText/MenuTrailingText.tsx"],"sourcesContent":["import clsx from \"clsx\";\nimport { typography } from \"@/utils/typography\";\n\n/**\n * Props for the [`MenuTrailingText`](file:///home/rohan/work/adgytec/adgytec-web-ui-components/src/components/Menu/MenuTrailingText/MenuTrailingText.tsx) component.\n */\nexport interface MenuTrailingTextProps\n    extends React.ComponentPropsWithRef<\"p\"> {}\n\n/**\n * Secondary metadata or descriptive text placed at the trailing edge of a [`MenuItem`](file:///home/rohan/work/adgytec/adgytec-web-ui-components/src/components/Menu/MenuItem/MenuItem.tsx).\n *\n * Styled with Material Design 3 `labelLarge` typography.\n *\n * @example\n * ```tsx\n * <MenuTrailingText>New</MenuTrailingText>\n * ```\n */\nexport const MenuTrailingText: React.FC<MenuTrailingTextProps> = ({\n    className,\n    ...props\n}) => {\n    return <p className={clsx(typography.labelLarge, className)} {...props} />;\n};\n"],"mappings":";;;;;aAmBaK,KAAoD,MAAA;CAAA,IAAAC,KAAA,GAAAN,EAAAA,EAAAA,CAAA,CAAA,GAAAO,GAAAC;CAAA,AAAAF,EAAA,OAAAG,KAGhE,IAAAH,EAAA,IAAA,IAAAA,EAAA,OAHiE,eAAA,GAAAE,KAAAC,GAGjE,EAAA,KAAAA,GAAA,EAAA,KAAAF,GAAA,EAAA,KAAAC;CAAA,IAAAE;CAAA,AAAAJ,EAAA,OAAAC,IAC8D,IAAAD,EAAA,MAAtC,IAAAL,EAAKU,EAAU,YAAaJ,CAAS,GAAC,EAAA,KAAAA,GAAA,EAAA,KAAAG;CAAA,IAAAE;CAAe,OAAfN,EAAA,OAAAE,KAAAF,EAAA,OAAAI,KAApD,IAAA,kBAAA,KAAA;EAAc,WAAAA;EAAsC,GAAMF;CAAK,CAAA,GAAI,EAAA,KAAAA,GAAA,EAAA,KAAAE,GAAA,EAAA,KAAAE,KAAA,IAAAN,EAAA,IAAnEM;AAAmE"}

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

@@ -1,6 +1,47 @@
 import { MenuTrigger as AriaMenuTrigger } from 'react-aria-components';
 import { MenuColor, MenuLayout } from '../core';
-export declare const MenuTrigger: React.FC<React.ComponentPropsWithRef<typeof AriaMenuTrigger> & {
+/**
+ * Props for the [`MenuTrigger`](file:///home/rohan/work/adgytec/adgytec-web-ui-components/src/components/Menu/MenuTrigger/MenuTrigger.tsx) component.
+ */
+export interface MenuTriggerProps extends React.ComponentPropsWithRef<typeof AriaMenuTrigger> {
+    /**
+     * Sets the default color scheme for child menus.
+     *
+     * @default "standard"
+     */
     color?: MenuColor;
+    /**
+     * Sets the default layout density for child menus.
+     *
+     * @default "standard"
+     */
     layout?: MenuLayout;
-}>;
+}
+/**
+ * Container component that manages menu visibility and trigger interaction states.
+ *
+ * Wraps React Aria's `MenuTrigger` and provides [`MenuConfigContext`](file:///home/rohan/work/adgytec/adgytec-web-ui-components/src/components/Menu/context/context.ts)
+ * to configure the color scheme and layout density across descendant [`Menu`](file:///home/rohan/work/adgytec/adgytec-web-ui-components/src/components/Menu/Menu/Menu.tsx) components.
+ *
+ * @example
+ * ```tsx
+ * import {
+ *     MenuTrigger,
+ *     Button,
+ *     MenuPopover,
+ *     Menu,
+ *     MenuItem,
+ * } from "@adgytec/web-ui-components";
+ *
+ * <MenuTrigger color="vibrant">
+ *     <Button label="Open Menu" />
+ *     <MenuPopover>
+ *         <Menu>
+ *             <MenuItem label="Item 1" />
+ *             <MenuItem label="Item 2" />
+ *         </Menu>
+ *     </MenuPopover>
+ * </MenuTrigger>
+ * ```
+ */
+export declare const MenuTrigger: React.FC<MenuTriggerProps>;

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../../../src/components/Menu/MenuTrigger/MenuTrigger.tsx"],"sourcesContent":["import { MenuTrigger as AriaMenuTrigger } from \"react-aria-components\";\nimport { MenuConfigContext } from \"../context\";\nimport type { MenuColor, MenuLayout } from \"../core\";\n\nexport const MenuTrigger: React.FC<\n    React.ComponentPropsWithRef<typeof AriaMenuTrigger> & {\n        color?: MenuColor;\n        layout?: MenuLayout;\n    }\n> = ({ color, layout, ...props }) => {\n    return (\n        <MenuConfigContext value={{ color, layout }}>\n            <AriaMenuTrigger {...props} />\n        </MenuConfigContext>\n    );\n};\n"],"mappings":";;;;;aAIa,KAKT,MAAA;CAAA,IAAA,KAAA,GAAA,EAAA,EAAA,CAAA,EAAA,GAAA,GAAA,GAAA;CAAA,AAAA,EAAA,OAAA,KAA4B,IAAA,EAAA,IAAA,IAAA,EAAA,IAAA,IAAA,EAAA,OAA3B,yBAAA,KAAA,GAA2B,EAAA,KAAA,GAAA,EAAA,KAAA,GAAA,EAAA,KAAA,GAAA,EAAA,KAAA;CAAA,IAAA;CAAA,AAAA,EAAA,OAAA,KAAA,EAAA,OAAA,KAEE,IAAA;EAAA;EAAA;CAAgB,GAAC,EAAA,KAAA,GAAA,EAAA,KAAA,GAAA,EAAA,KAAA,KAAA,IAAA,EAAA;CAAA,IAAA;CAAA,AAAA,EAAA,OAAA,IACT,IAAA,EAAA,MAA9B,IAAA,kBAAC,GAAD,EAAgB,GAAK,EAAK,CAAA,GAAI,EAAA,KAAA,GAAA,EAAA,KAAA;CAAA,IAAA;CACd,OADc,EAAA,OAAA,KAAA,EAAA,QAAA,KADlC,IAAA,kBAAC,GAAD;EAA0B,OAAA;YACtB;CADc,CAAA,GAEE,EAAA,KAAA,GAAA,EAAA,MAAA,GAAA,EAAA,MAAA,KAAA,IAAA,EAAA,KAFpB;AAEoB"}
+{"version":3,"file":"index.js","names":["_c","AriaMenuTrigger","require_compiler_runtime","MenuTrigger$1","import_compiler_runtime","MenuTrigger","$","color","layout","props","t0","t1","t2","t3","MenuConfigContext"],"sources":["../../../../src/components/Menu/MenuTrigger/MenuTrigger.tsx"],"sourcesContent":["import { MenuTrigger as AriaMenuTrigger } from \"react-aria-components\";\nimport { MenuConfigContext } from \"../context\";\nimport type { MenuColor, MenuLayout } from \"../core\";\n\n/**\n * Props for the [`MenuTrigger`](file:///home/rohan/work/adgytec/adgytec-web-ui-components/src/components/Menu/MenuTrigger/MenuTrigger.tsx) component.\n */\nexport interface MenuTriggerProps\n    extends React.ComponentPropsWithRef<typeof AriaMenuTrigger> {\n    /**\n     * Sets the default color scheme for child menus.\n     *\n     * @default \"standard\"\n     */\n    color?: MenuColor;\n\n    /**\n     * Sets the default layout density for child menus.\n     *\n     * @default \"standard\"\n     */\n    layout?: MenuLayout;\n}\n\n/**\n * Container component that manages menu visibility and trigger interaction states.\n *\n * Wraps React Aria's `MenuTrigger` and provides [`MenuConfigContext`](file:///home/rohan/work/adgytec/adgytec-web-ui-components/src/components/Menu/context/context.ts)\n * to configure the color scheme and layout density across descendant [`Menu`](file:///home/rohan/work/adgytec/adgytec-web-ui-components/src/components/Menu/Menu/Menu.tsx) components.\n *\n * @example\n * ```tsx\n * import {\n *     MenuTrigger,\n *     Button,\n *     MenuPopover,\n *     Menu,\n *     MenuItem,\n * } from \"@adgytec/web-ui-components\";\n *\n * <MenuTrigger color=\"vibrant\">\n *     <Button label=\"Open Menu\" />\n *     <MenuPopover>\n *         <Menu>\n *             <MenuItem label=\"Item 1\" />\n *             <MenuItem label=\"Item 2\" />\n *         </Menu>\n *     </MenuPopover>\n * </MenuTrigger>\n * ```\n */\nexport const MenuTrigger: React.FC<MenuTriggerProps> = ({\n    color,\n    layout,\n    ...props\n}) => {\n    return (\n        <MenuConfigContext value={{ color, layout }}>\n            <AriaMenuTrigger {...props} />\n        </MenuConfigContext>\n    );\n};\n"],"mappings":";;;;;aAmDaK,KAA0C,MAAA;CAAA,IAAAC,KAAA,GAAAN,EAAAA,EAAAA,CAAA,EAAA,GAAAO,GAAAC,GAAAC;CAAA,AAAAH,EAAA,OAAAI,KAItD,IAAAJ,EAAA,IAAA,IAAAA,EAAA,IAAA,IAAAA,EAAA,OAJuD,sBAAA,GAAAG,KAAAC,GAIvD,EAAA,KAAAA,GAAA,EAAA,KAAAH,GAAA,EAAA,KAAAC,GAAA,EAAA,KAAAC;CAAA,IAAAE;CAAA,AAAAL,EAAA,OAAAC,KAAAD,EAAA,OAAAE,KAEiC,IAAA;EAAA;EAAA;CAAgB,GAAC,EAAA,KAAAD,GAAA,EAAA,KAAAC,GAAA,EAAA,KAAAG,KAAA,IAAAL,EAAA;CAAA,IAAAM;CAAA,AAAAN,EAAA,OAAAG,IACT,IAAAH,EAAA,MAA9B,IAAA,kBAACL,GAAD,EAAgB,GAAKQ,EAAK,CAAA,GAAI,EAAA,KAAAA,GAAA,EAAA,KAAAG;CAAA,IAAAC;CACd,OADcP,EAAA,OAAAK,KAAAL,EAAA,QAAAM,KADlC,IAAA,kBAACE,GAAD;EAA0B,OAAAH;EACtB,UAAAC;CADc,CAAA,GAEE,EAAA,KAAAD,GAAA,EAAA,MAAAC,GAAA,EAAA,MAAAC,KAAA,IAAAP,EAAA,KAFpBO;AAEoB"}

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

@@ -1,2 +1,23 @@
 import { Popover } from '../../Popover';
-export declare const SubmenuPopover: React.FC<React.ComponentPropsWithRef<typeof Popover>>;
+/**
+ * Props for the [`SubmenuPopover`](file:///home/rohan/work/adgytec/adgytec-web-ui-components/src/components/Menu/SubmenuPopover/SubmenuPopover.tsx) component.
+ */
+export interface SubmenuPopoverProps extends React.ComponentPropsWithRef<typeof Popover> {
+}
+/**
+ * Specialized popover container for nested cascading submenus.
+ *
+ * Defaults to an `offset` of `-1` px so the submenu slightly overlaps the parent
+ * menu edge according to Material Design 3 menu specifications.
+ *
+ * @example
+ * ```tsx
+ * <SubmenuPopover>
+ *     <Menu>
+ *         <MenuItem label="Sub-item 1" />
+ *         <MenuItem label="Sub-item 2" />
+ *     </Menu>
+ * </SubmenuPopover>
+ * ```
+ */
+export declare const SubmenuPopover: React.FC<SubmenuPopoverProps>;

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

@@ -1,6 +1,19 @@
 import { MenuColor, MenuLayout } from '../core';
+/**
+ * Configuration options propagated from [`MenuTrigger`](file:///home/rohan/work/adgytec/adgytec-web-ui-components/src/components/Menu/MenuTrigger/MenuTrigger.tsx)
+ * down to child menus.
+ */
 export type MenuConfigContextValue = {
+    /**
+     * Color scheme for the menu surface and items.
+     */
     color?: MenuColor;
+    /**
+     * Layout density for the menu items.
+     */
     layout?: MenuLayout;
 };
+/**
+ * React context providing menu configuration (`color` and `layout`) to nested menus.
+ */
 export declare const MenuConfigContext: import('react').Context<MenuConfigContextValue>;

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../../../src/components/Menu/context/context.ts","../../../../src/components/Menu/context/useMenuConfigContext.ts"],"sourcesContent":["import { createContext } from \"react\";\nimport type { MenuColor, MenuLayout } from \"../core\";\n\nexport type MenuConfigContextValue = {\n    color?: MenuColor;\n    layout?: MenuLayout;\n};\n\nexport const MenuConfigContext = createContext<MenuConfigContextValue>({});\n","import { useContext } from \"react\";\nimport { MenuConfigContext } from \"./context\";\n\nexport function useMenuConfigContext() {\n    return useContext(MenuConfigContext);\n}\n"],"mappings":";;AAQA,IAAa,IAAoB,EAAsC,CAAC,CAAC;;;ACLzE,SAAO,IAAA;CAAA,OACI,EAAW,CAAiB;AAAC"}
+{"version":3,"file":"index.js","names":["MenuConfigContext","createContext","useMenuConfigContext","useContext"],"sources":["../../../../src/components/Menu/context/context.ts","../../../../src/components/Menu/context/useMenuConfigContext.ts"],"sourcesContent":["import { createContext } from \"react\";\nimport type { MenuColor, MenuLayout } from \"../core\";\n\n/**\n * Configuration options propagated from [`MenuTrigger`](file:///home/rohan/work/adgytec/adgytec-web-ui-components/src/components/Menu/MenuTrigger/MenuTrigger.tsx)\n * down to child menus.\n */\nexport type MenuConfigContextValue = {\n    /**\n     * Color scheme for the menu surface and items.\n     */\n    color?: MenuColor;\n    /**\n     * Layout density for the menu items.\n     */\n    layout?: MenuLayout;\n};\n\n/**\n * React context providing menu configuration (`color` and `layout`) to nested menus.\n */\nexport const MenuConfigContext = createContext<MenuConfigContextValue>({});\n","import { useContext } from \"react\";\nimport { MenuConfigContext } from \"./context\";\n\n/**\n * Hook to access the current menu configuration (`color` and `layout`) provided by an ancestor\n * [`MenuTrigger`](file:///home/rohan/work/adgytec/adgytec-web-ui-components/src/components/Menu/MenuTrigger/MenuTrigger.tsx).\n *\n * @returns The current {@link MenuConfigContextValue}.\n */\nexport function useMenuConfigContext() {\n    return useContext(MenuConfigContext);\n}\n"],"mappings":";;AAqBA,IAAaA,IAAoBC,EAAsC,CAAC,CAAC;;;ACZzE,SAAOC,IAAA;CAAA,OACIC,EAAWH,CAAiB;AAAC"}

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

@@ -1 +1,7 @@
+/**
+ * Hook to access the current menu configuration (`color` and `layout`) provided by an ancestor
+ * [`MenuTrigger`](file:///home/rohan/work/adgytec/adgytec-web-ui-components/src/components/Menu/MenuTrigger/MenuTrigger.tsx).
+ *
+ * @returns The current {@link MenuConfigContextValue}.
+ */
 export declare function useMenuConfigContext(): import('./context').MenuConfigContextValue;

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

@@ -1,5 +1,25 @@
+/**
+ * Color scheme variants for the menu system:
+ * - `"standard"`: Neutral container surface with on-surface text and secondary container selection.
+ * - `"vibrant"`: Tertiary container surface with high-contrast tertiary accents.
+ */
 export type MenuColor = "standard" | "vibrant";
+/**
+ * CSS class applying the base icon and supporting text color to menu items.
+ */
 export declare const menuItemBaseColor: string;
+/**
+ * CSS class applying the primary label text color to menu items.
+ */
 export declare const menuItemLabelColor: string;
+/**
+ * Resolves the CSS class corresponding to a given [`MenuColor`](file:///home/rohan/work/adgytec/adgytec-web-ui-components/src/components/Menu/core/color.ts#L8) variant.
+ *
+ * @param color - The selected color variant.
+ * @returns The CSS class name.
+ */
 export declare const menuColorConfig: (color: MenuColor) => string;
+/**
+ * CSS class applying base surface coloring to the menu container.
+ */
 export declare const menuBaseColor: string;

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

@@ -1,4 +1,21 @@
+/**
+ * Layout density variants for the menu:
+ * - `"standard"`: Default density with standard item heights and padding.
+ * - `"grouped"`: Grouped layout with compact spacing for nested or sectioned menus.
+ */
 export type MenuLayout = "standard" | "grouped";
+/**
+ * Standard dimension (20px) for leading and trailing icons in menu items.
+ */
 export declare const MenuItemIconSize = 20;
+/**
+ * CSS class applying the base flex layout to the menu list.
+ */
 export declare const MenuBaseLayout: string;
+/**
+ * Resolves the CSS class corresponding to a given [`MenuLayout`](file:///home/rohan/work/adgytec/adgytec-web-ui-components/src/components/Menu/core/layout.ts#L8) variant.
+ *
+ * @param layout - The layout density variant.
+ * @returns The CSS class name.
+ */
 export declare const menuLayoutConfig: (layout: MenuLayout) => string;

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

@@ -1,6 +1,24 @@
+/**
+ * CSS class for the root menu list element.
+ */
 export declare const MenuStyles: string;
+/**
+ * CSS class for a menu section grouping element.
+ */
 export declare const MenuSectionStyles: string;
+/**
+ * CSS class for a menu section header text element.
+ */
 export declare const MenuSectionHeaderStyles: string;
+/**
+ * CSS class for an individual interactive menu item container.
+ */
 export declare const MenuItemStyles: string;
+/**
+ * CSS class for the leading content wrapper (icon, label, supporting text) of a menu item.
+ */
 export declare const MenuItemLeadingStyles: string;
+/**
+ * CSS class for the trailing content wrapper (trailing text, shortcut, chevron) of a menu item.
+ */
 export declare const MenuItemTrailingStyles: string;

package/dist/components/Navigation/Navigation/Navigation.d.ts

@@ -1,2 +1,30 @@
 import { NavigationProps } from './types';
+/**
+ * Main layout container for application navigation following Material Design 3 guidelines.
+ *
+ * Coordinates navigation header titles, dialog/drawer modal close buttons, scroll position synchronization,
+ * and context providers for link/button active states and portal-rendered sub-navigation panels.
+ * Automatically provides a [`NavigationState`](file:///home/rohan/work/adgytec/adgytec-web-ui-components/src/components/Navigation/NavigationState/NavigationState.tsx)
+ * if not already nested within one.
+ *
+ * @example
+ * ```tsx
+ * import {
+ *     Navigation,
+ *     NavigationSection,
+ *     NavigationLink,
+ * } from "@adgytec/web-ui-components";
+ * import { Home, Settings } from "lucide-react";
+ *
+ * <Navigation
+ *     label="Dashboard"
+ *     isLinkActive={(href) => window.location.pathname === href}
+ * >
+ *     <NavigationSection>
+ *         <NavigationLink href="/" label="Home" icon={Home} />
+ *         <NavigationLink href="/settings" label="Settings" icon={Settings} />
+ *     </NavigationSection>
+ * </Navigation>
+ * ```
+ */
 export declare const Navigation: React.FC<NavigationProps>;

package/dist/components/Navigation/Navigation/navContext.d.ts

@@ -1,7 +1,26 @@
 import { IsButtonActive, IsLinkActive } from './types';
+/**
+ * Context value carrying active predicate functions for child navigation items.
+ */
 export type NavigationContextType = {
+    /**
+     * Active predicate function for links.
+     */
     isLinkActive?: IsLinkActive;
+    /**
+     * Active predicate function for buttons.
+     */
     isButtonActive?: IsButtonActive;
 };
+/**
+ * React context providing link and button active state predicates to descendant navigation items.
+ */
 export declare const NavigationContext: import('react').Context<NavigationContextType | null>;
+/**
+ * Hook to access active state predicates (`isLinkActive` and `isButtonActive`) from the parent
+ * [`Navigation`](file:///home/rohan/work/adgytec/adgytec-web-ui-components/src/components/Navigation/Navigation/Navigation.tsx) container.
+ *
+ * @throws If called outside of a `Navigation` component.
+ * @returns The current {@link NavigationContextType}.
+ */
 export declare function useNavigationContext(): NavigationContextType;

package/dist/components/Navigation/Navigation/navRenderingContext.d.ts

@@ -1,5 +1,21 @@
+/**
+ * Context value providing the DOM reference of the navigation container for sub-navigation portal mounting.
+ */
 export type NavigationRenderingContextType = {
+    /**
+     * Outer container DOM node used as the target portal container for sliding sub-navigations.
+     */
     container: HTMLDivElement | null;
 };
+/**
+ * React context providing the container DOM element for rendering nested sub-navigation portals.
+ */
 export declare const NavigationRenderingContext: import('react').Context<NavigationRenderingContextType | null>;
+/**
+ * Hook to access the parent navigation container element used for portal mounting of
+ * [`SubNavigation`](file:///home/rohan/work/adgytec/adgytec-web-ui-components/src/components/Navigation/SubNavigation/SubNavigation/SubNavigation.tsx).
+ *
+ * @throws If called outside of a [`Navigation`](file:///home/rohan/work/adgytec/adgytec-web-ui-components/src/components/Navigation/Navigation/Navigation.tsx) component.
+ * @returns The current {@link NavigationRenderingContextType}.
+ */
 export declare function useNavigationContainer(): NavigationRenderingContextType;