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

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

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

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`](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`](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":";;;;;A,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`](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`](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

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

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`](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`](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":";;;;;A,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`](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`](src/components/Menu/context/context.ts)
+ * to configure the color scheme and layout density across descendant [`Menu`](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

@@ -2,7 +2,7 @@ import { t as e } from "../../../chunks/compiler-runtime";
 import { MenuConfigContext as t } from "../context/index.js";
 import { jsx as n } from "react/jsx-runtime";
 import { MenuTrigger as r } from "react-aria-components";
-//#region src/components/Menu/MenuTrigger/MenuTrigger.tsx
+// src/components/Menu/MenuTrigger/MenuTrigger.tsx
 var i = e(), a = (e) => {
 	let a = (0, i.c)(12), o, s, c;
 	a[0] === e ? (o = a[1], s = a[2], c = a[3]) : ({color: o, layout: s, ...c} = e, a[0] = e, a[1] = o, a[2] = s, a[3] = c);
@@ -19,7 +19,6 @@ var i = e(), a = (e) => {
 		children: u
 	}), a[9] = l, a[10] = u, a[11] = d) : d = a[11], d;
 };
-//#endregion
 export { a as MenuTrigger };
 
 //# sourceMappingURL=index.js.map

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`](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`](src/components/Menu/context/context.ts)\n * to configure the color scheme and layout density across descendant [`Menu`](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":";;;;;A,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`](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/SubmenuPopover/index.js

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

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

@@ -1,6 +1,19 @@
 import { MenuColor, MenuLayout } from '../core';
+/**
+ * Configuration options propagated from [`MenuTrigger`](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

@@ -1,12 +1,10 @@
 import { createContext as e, useContext as t } from "react";
-//#region src/components/Menu/context/context.ts
+// src/components/Menu/context/context.ts
 var n = e({});
-//#endregion
-//#region src/components/Menu/context/useMenuConfigContext.ts
+// src/components/Menu/context/useMenuConfigContext.ts
 function r() {
 	return t(n);
 }
-//#endregion
 export { n as MenuConfigContext, r as useMenuConfigContext };
 
 //# sourceMappingURL=index.js.map

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`](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`](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`](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`](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/index.js

@@ -1,2 +1 @@
-import { a as e, c as t, d as n, f as r, i, l as a, n as o, o as s, p as c, r as l, s as u, t as d, u as f } from "../../../chunks/core6";
-export { u as MenuBaseLayout, t as MenuItemIconSize, d as MenuItemLeadingStyles, o as MenuItemStyles, l as MenuItemTrailingStyles, i as MenuSectionHeaderStyles, e as MenuSectionStyles, s as MenuStyles, f as menuBaseColor, n as menuColorConfig, r as menuItemBaseColor, c as menuItemLabelColor, a as menuLayoutConfig };
+export { s as MenuBaseLayout, c as MenuItemIconSize, t as MenuItemLeadingStyles, n as MenuItemStyles, r as MenuItemTrailingStyles, i as MenuSectionHeaderStyles, a as MenuSectionStyles, o as MenuStyles, u as menuBaseColor, d as menuColorConfig, f as menuItemBaseColor, p as menuItemLabelColor, l as menuLayoutConfig } from "../../../chunks/core6";

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`](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`](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`](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`](src/components/Navigation/SubNavigation/SubNavigation/SubNavigation.tsx).
+ *
+ * @throws If called outside of a [`Navigation`](src/components/Navigation/Navigation/Navigation.tsx) component.
+ * @returns The current {@link NavigationRenderingContextType}.
+ */
 export declare function useNavigationContainer(): NavigationRenderingContextType;

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

@@ -1,10 +1,38 @@
 import { ReactNode } from 'react';
+/**
+ * Callback function signature used to determine whether a navigation link matching `href` is currently active.
+ */
 export type IsLinkActive = (href?: string) => boolean;
+/**
+ * Callback function signature used to determine whether a navigation button matching `prefix` is currently active.
+ */
 export type IsButtonActive = (prefix?: string) => boolean;
+/**
+ * Props for the root [`Navigation`](src/components/Navigation/Navigation/Navigation.tsx) container component.
+ */
 export interface NavigationProps extends React.ComponentPropsWithRef<"nav"> {
+    /**
+     * Header title or node displayed at the top of the navigation surface.
+     */
     label?: ReactNode;
+    /**
+     * Callback function used by child [`NavigationLink`](src/components/Navigation/NavigationItem/NavigationLink/NavigationLink.tsx)
+     * components to determine their active state from their `href`.
+     */
     isLinkActive?: IsLinkActive;
+    /**
+     * Callback function used by child [`NavigationButton`](src/components/Navigation/NavigationItem/NavigationButton/NavigationButton.tsx)
+     * components to determine their active state from their `prefix`.
+     */
     isButtonActive?: IsButtonActive;
+    /**
+     * Root state identifier used for depth tracking and scroll position synchronization.
+     *
+     * @default "__root__"
+     */
     stateID?: string;
+    /**
+     * Optional CSS class applied to the outer container `<div>` wrapping the navigation surface.
+     */
     containerClassName?: string;
 }

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

@@ -1,2 +1,17 @@
 import { NavigationButtonProps } from './types';
+/**
+ * Button navigation item component.
+ *
+ * Typically used as an action trigger within a [`SubNavigationTrigger`](src/components/Navigation/SubNavigation/SubNavigationTrigger/SubNavigationTrigger.tsx)
+ * to open a nested sub-navigation panel. Automatically evaluates active state matching based on its `prefix`,
+ * switches between resting and active icons, and inherits labels from parent triggers.
+ *
+ * @example
+ * ```tsx
+ * import { NavigationButton } from "@adgytec/web-ui-components";
+ * import { Briefcase } from "lucide-react";
+ *
+ * <NavigationButton icon={Briefcase} prefix="/projects" label="Projects" />
+ * ```
+ */
 export declare const NavigationButton: React.FC<NavigationButtonProps>;

package/dist/components/Navigation/NavigationItem/NavigationButton/index.js

@@ -7,7 +7,7 @@ import { clsx as o } from "clsx";
 import { useContext as s } from "react";
 import { jsx as c, jsxs as l } from "react/jsx-runtime";
 import { Button as u } from "react-aria-components";
-//#region src/components/Navigation/NavigationItem/NavigationButton/NavigationButton.tsx
+// src/components/Navigation/NavigationItem/NavigationButton/NavigationButton.tsx
 var d = e(), f = (e) => {
 	let f = (0, d.c)(24), p, m, h, g, _, v, y;
 	f[0] === e ? (p = f[1], m = f[2], h = f[3], g = f[4], _ = f[5], v = f[6], y = f[7]) : ({className: m, icon: h, activeIcon: p, label: _, prefix: v, isActive: g, ...y} = e, f[0] = e, f[1] = p, f[2] = m, f[3] = h, f[4] = g, f[5] = _, f[6] = v, f[7] = y);
@@ -30,7 +30,6 @@ var d = e(), f = (e) => {
 		children: [D, w]
 	}), f[18] = w, f[19] = y, f[20] = T, f[21] = E, f[22] = D, f[23] = O) : O = f[23], O;
 };
-//#endregion
 export { f as NavigationButton };
 
 //# sourceMappingURL=index.js.map

package/dist/components/Navigation/NavigationItem/NavigationButton/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["icon","activeIcon","buttonActive","buttonLabel"],"sources":["../../../../../src/components/Navigation/NavigationItem/NavigationButton/NavigationButton.tsx"],"sourcesContent":["import { clsx } from \"clsx\";\nimport { useContext } from \"react\";\nimport { Button } from \"react-aria-components\";\nimport { NavLabelContext } from \"../../core\";\nimport { useNavigationContext } from \"../../Navigation/navContext\";\nimport { NavigationItemLabelTypography, NavigationItemStyles } from \"../core\";\nimport { NavigationItemIconRenderer } from \"../NavigationItemIconRenderer\";\nimport type { NavigationButtonProps } from \"./types\";\n\nexport const NavigationButton: React.FC<NavigationButtonProps> = ({\n    className,\n    icon,\n    activeIcon,\n    label,\n    prefix,\n    isActive,\n    ...props\n}) => {\n    const { isButtonActive } = useNavigationContext();\n    const buttonActive =\n        typeof isActive === \"function\"\n            ? isActive(prefix)\n            : (isActive ?? isButtonActive?.(prefix));\n\n    const triggerLabel = useContext(NavLabelContext);\n    const buttonLabel = label ?? triggerLabel;\n\n    return (\n        <Button\n            className={(renderProps) =>\n                clsx(\n                    NavigationItemStyles,\n                    NavigationItemLabelTypography,\n                    typeof className === \"function\"\n                        ? className(renderProps)\n                        : className\n                )\n            }\n            {...props}\n            slot=\"open\"\n            data-active={buttonActive || undefined}\n        >\n            <NavigationItemIconRenderer\n                icon={icon}\n                activeIcon={activeIcon}\n                isActive={buttonActive}\n            />\n            {buttonLabel}\n        </Button>\n    );\n};\n"],"mappings":";;;;;;;;;;aASa,KAAoD,MAAA;CAAA,IAAA,KAAA,GAAA,EAAA,EAAA,CAAA,EAAA,GAAA,GAAA,GAAA,GAAA,GAAA,GAAA,GAAA;CAAA,AAAA,EAAA,OAAA,KAQhE,IAAA,EAAA,IAAA,IAAA,EAAA,IAAA,IAAA,EAAA,IAAA,IAAA,EAAA,IAAA,IAAA,EAAA,IAAA,IAAA,EAAA,IAAA,IAAA,EAAA,OARiE,4EAAA,KAAA,GAQjE,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,sBAA2B,EAAqB,GAAE;CAAA,AAAA,EAAA,OAAA,KAAA,EAAA,OAAA,KAAA,EAAA,QAAA,KAE9C,IAAA,OAAO,KAAa,aACd,EAAS,CAC4B,IAApC,KAAY,IAAiB,CAAM,GAAE,EAAA,KAAA,GAAA,EAAA,KAAA,GAAA,EAAA,MAAA,GAAA,EAAA,MAAA,KAAA,IAAA,EAAA;CAHhD,IAAA,IACI,GAIJ,IAAqB,EAAW,CAAe,GAC/C,IAAoB,KAAA,GAAsB;CAAA,AAAA,EAAA,QAAA,IAW7B,IAAA,EAAA,OAPM,KAAA,MACP,EACI,GACA,GACA,OAAO,KAAc,aACf,EAAU,CACF,IAFd,CAGJ,GAAC,EAAA,MAAA,GAAA,EAAA,MAAA;CAIQ,IAAA,IAAA,KAAA,KAAA,GAAyB;CAAA,AAAA,EAAA,QAAA,KAAA,EAAA,QAAA,KAAA,EAAA,QAAA,KAEtC,IAAA,kBAAC,GAAD;EACU;EACM;EACFE,UAAA;CAAY,CAAA,GACxB,EAAA,MAAA,GAAA,EAAA,MAAA,GAAA,EAAA,MAAA,GAAA,EAAA,MAAA,KAAA,IAAA,EAAA;CAAA,IAAA;CAEG,OAFH,EAAA,QAAA,KAAA,EAAA,QAAA,KAAA,EAAA,QAAA,KAAA,EAAA,QAAA,KAAA,EAAA,QAAA,KAlBN,IAAA,kBAAC,GAAD;EACe,WAAA;EAON,GAED;EACC,MAAA;EACQ,eAAA;YAZjB,CAcI,GAKC,CAnBE;KAoBE,EAAA,MAAA,GAAA,EAAA,MAAA,GAAA,EAAA,MAAA,GAAA,EAAA,MAAA,GAAA,EAAA,MAAA,GAAA,EAAA,MAAA,KAAA,IAAA,EAAA,KApBT;AAoBS"}
+{"version":3,"file":"index.js","names":["icon","activeIcon","buttonActive","buttonLabel","_c","require_compiler_runtime","NavigationItemStyles","NavigationItemLabelTypography","import_compiler_runtime","NavigationButton","$","activeIcon","className","icon","isActive","label","prefix","props","t0","useNavigationContext","t1","isButtonActive","buttonActive","triggerLabel","useContext","NavLabelContext","buttonLabel","t2","clsx","renderProps","t3","t4","NavigationItemIconRenderer","t5","Button"],"sources":["../../../../../src/components/Navigation/NavigationItem/NavigationButton/NavigationButton.tsx"],"sourcesContent":["import { clsx } from \"clsx\";\nimport { useContext } from \"react\";\nimport { Button } from \"react-aria-components\";\nimport { NavLabelContext } from \"../../core\";\nimport { useNavigationContext } from \"../../Navigation/navContext\";\nimport { NavigationItemLabelTypography, NavigationItemStyles } from \"../core\";\nimport { NavigationItemIconRenderer } from \"../NavigationItemIconRenderer\";\nimport type { NavigationButtonProps } from \"./types\";\n\n/**\n * Button navigation item component.\n *\n * Typically used as an action trigger within a [`SubNavigationTrigger`](src/components/Navigation/SubNavigation/SubNavigationTrigger/SubNavigationTrigger.tsx)\n * to open a nested sub-navigation panel. Automatically evaluates active state matching based on its `prefix`,\n * switches between resting and active icons, and inherits labels from parent triggers.\n *\n * @example\n * ```tsx\n * import { NavigationButton } from \"@adgytec/web-ui-components\";\n * import { Briefcase } from \"lucide-react\";\n *\n * <NavigationButton icon={Briefcase} prefix=\"/projects\" label=\"Projects\" />\n * ```\n */\nexport const NavigationButton: React.FC<NavigationButtonProps> = ({\n    className,\n    icon,\n    activeIcon,\n    label,\n    prefix,\n    isActive,\n    ...props\n}) => {\n    const { isButtonActive } = useNavigationContext();\n    const buttonActive =\n        typeof isActive === \"function\"\n            ? isActive(prefix)\n            : (isActive ?? isButtonActive?.(prefix));\n\n    const triggerLabel = useContext(NavLabelContext);\n    const buttonLabel = label ?? triggerLabel;\n\n    return (\n        <Button\n            className={(renderProps) =>\n                clsx(\n                    NavigationItemStyles,\n                    NavigationItemLabelTypography,\n                    typeof className === \"function\"\n                        ? className(renderProps)\n                        : className\n                )\n            }\n            {...props}\n            slot=\"open\"\n            data-active={buttonActive || undefined}\n        >\n            <NavigationItemIconRenderer\n                icon={icon}\n                activeIcon={activeIcon}\n                isActive={buttonActive}\n            />\n            {buttonLabel}\n        </Button>\n    );\n};\n"],"mappings":";;;;;;;;;;A,aAwBaS,KAAoD,MAAA;CAAA,IAAAC,KAAA,GAAAN,EAAAA,EAAAA,CAAA,EAAA,GAAAO,GAAAC,GAAAC,GAAAC,GAAAC,GAAAC,GAAAC;CAAA,AAAAP,EAAA,OAAAQ,KAQhE,IAAAR,EAAA,IAAA,IAAAA,EAAA,IAAA,IAAAA,EAAA,IAAA,IAAAA,EAAA,IAAA,IAAAA,EAAA,IAAA,IAAAA,EAAA,IAAA,IAAAA,EAAA,OARiE,yEAAA,GAAAO,KAAAC,GAQjE,EAAA,KAAAA,GAAA,EAAA,KAAAP,GAAA,EAAA,KAAAC,GAAA,EAAA,KAAAC,GAAA,EAAA,KAAAC,GAAA,EAAA,KAAAC,GAAA,EAAA,KAAAC,GAAA,EAAA,KAAAC;CACG,IAAA,EAAA,sBAA2BE,EAAqB,GAAEC;CAAA,AAAAV,EAAA,OAAAI,KAAAJ,EAAA,OAAAW,KAAAX,EAAA,QAAAM,KAE9C,IAAA,OAAOF,KAAa,aACdA,EAASE,CAC4B,IAApCF,KAAYO,IAAiBL,CAAM,GAAE,EAAA,KAAAF,GAAA,EAAA,KAAAO,GAAA,EAAA,MAAAL,GAAA,EAAA,MAAAI,KAAA,IAAAV,EAAA;CAHhD,IAAAY,IACIF,GAIJG,IAAqBC,EAAWC,CAAe,GAC/CC,IAAoBX,KAAAQ,GAAsBI;CAAA,AAAAjB,EAAA,QAAAE,IAW7B,IAAAF,EAAA,OAPM,KAAA,MACPkB,EACItB,GACAC,GACA,OAAOK,KAAc,aACfA,EAAUiB,CACF,IAFdjB,CAGJ,GAAC,EAAA,MAAAA,GAAA,EAAA,MAAAe;CAIQ,IAAAG,IAAAR,KAAA,KAAA,GAAyBS;CAAA,AAAArB,EAAA,QAAAC,KAAAD,EAAA,QAAAY,KAAAZ,EAAA,QAAAG,KAEtC,IAAA,kBAACmB,GAAD;EACU;EACM;EACF9B,UAAAoB;CAAY,CAAA,GACxB,EAAA,MAAAX,GAAA,EAAA,MAAAW,GAAA,EAAA,MAAAT,GAAA,EAAA,MAAAkB,KAAA,IAAArB,EAAA;CAAA,IAAAuB;CAEG,OAFHvB,EAAA,QAAAgB,KAAAhB,EAAA,QAAAO,KAAAP,EAAA,QAAAiB,KAAAjB,EAAA,QAAAoB,KAAApB,EAAA,QAAAqB,KAlBN,IAAA,kBAACG,GAAD;EACe,WAAAP;EAON,GAEDV;EACC,MAAA;EACQ,eAAAa;EAZjB,UAAA,CAcIC,GAKCL,CAnBE;C,IAoBE,EAAA,MAAAA,GAAA,EAAA,MAAAT,GAAA,EAAA,MAAAU,GAAA,EAAA,MAAAG,GAAA,EAAA,MAAAC,GAAA,EAAA,MAAAE,KAAA,IAAAvB,EAAA,KApBTuB;AAoBS"}

package/dist/components/Navigation/NavigationItem/NavigationButton/types.d.ts

@@ -1,7 +1,16 @@
 import { ReactNode } from 'react';
 import { Button } from 'react-aria-components';
 import { NavigationItemProps } from '../core';
+/**
+ * Props for the [`NavigationButton`](src/components/Navigation/NavigationItem/NavigationButton/NavigationButton.tsx) component.
+ */
 export interface NavigationButtonProps extends Omit<React.ComponentPropsWithRef<typeof Button>, "children" | "slot">, Omit<NavigationItemProps, "label"> {
+    /**
+     * URL path prefix evaluated by `isButtonActive` to determine the button's active state.
+     */
     prefix?: string;
+    /**
+     * Button label content. If omitted, falls back to the label provided to [`SubNavigationTrigger`](src/components/Navigation/SubNavigation/SubNavigationTrigger/SubNavigationTrigger.tsx).
+     */
     label?: ReactNode;
 }

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

@@ -1,6 +1,25 @@
 import { LucideIcon } from 'lucide-react';
-export declare const NavigationItemIconRenderer: React.FC<{
+/**
+ * Props for the [`NavigationItemIconRenderer`](src/components/Navigation/NavigationItem/NavigationItemIconRenderer/NavigationItemIconRenderer.tsx) component.
+ */
+export interface NavigationItemIconRendererProps {
+    /**
+     * Icon displayed when the item is in its inactive/resting state.
+     */
     icon?: LucideIcon;
+    /**
+     * Alternate icon displayed when the item is active.
+     */
     activeIcon?: LucideIcon;
+    /**
+     * Whether the parent navigation item is currently active.
+     */
     isActive?: boolean;
-}>;
+}
+/**
+ * Internal icon renderer for navigation items.
+ *
+ * Renders a standard 24px icon with automatic fallback between `activeIcon` (when `isActive` is true)
+ * and the resting `icon`.
+ */
+export declare const NavigationItemIconRenderer: React.FC<NavigationItemIconRendererProps>;

package/dist/components/Navigation/NavigationItem/NavigationItemIconRenderer/index.js

@@ -1,7 +1,7 @@
 import { t as e } from "../../../../chunks/compiler-runtime";
 import { t } from "../../../../chunks/Icon";
 import { jsx as n } from "react/jsx-runtime";
-//#region src/components/Navigation/NavigationItem/NavigationItemIconRenderer/NavigationItemIconRenderer.tsx
+// src/components/Navigation/NavigationItem/NavigationItemIconRenderer/NavigationItemIconRenderer.tsx
 var r = e(), i = (e) => {
 	let i = (0, r.c)(2), { icon: a } = e, o;
 	return i[0] === a ? o = i[1] : (o = /* @__PURE__ */ n(t, {
@@ -28,7 +28,6 @@ var r = e(), i = (e) => {
 	}
 	return null;
 };
-//#endregion
 export { a as NavigationItemIconRenderer };
 
 //# sourceMappingURL=index.js.map

package/dist/components/Navigation/NavigationItem/NavigationItemIconRenderer/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["icon","activeIcon"],"sources":["../../../../../src/components/Navigation/NavigationItem/NavigationItemIconRenderer/NavigationItemIconRenderer.tsx"],"sourcesContent":["import type { LucideIcon } from \"lucide-react\";\nimport { Icon } from \"@/components/Icon\";\n\nconst IconRenderer: React.FC<{ icon: LucideIcon }> = ({ icon }) => {\n    return <Icon icon={icon} size={24} data-nav-icon />;\n};\n\nexport const NavigationItemIconRenderer: React.FC<{\n    icon?: LucideIcon;\n    activeIcon?: LucideIcon;\n    isActive?: boolean;\n}> = ({ icon, activeIcon, isActive }) => {\n    if (isActive) {\n        if (activeIcon) return <IconRenderer icon={activeIcon} />;\n        if (icon) return <IconRenderer icon={icon} />;\n\n        return null;\n    }\n\n    if (icon) return <IconRenderer icon={icon} />;\n    return null;\n};\n"],"mappings":";;;;aAGM,KAA+C,MAAA;CAAA,IAAA,KAAA,GAAA,EAAA,EAAA,CAAA,CAAA,GAAC,EAAA,YAAA,GAAQ;CACP,OADO,EAAA,OAAA,IACP,IAAA,EAAA,MAA5C,IAAA,kBAAC,GAAD;EAAY;EAAY,MAAA;EAAI,iBAAA;CAAa,CAAA,GAAG,EAAA,KAAA,GAAA,EAAA,KAAA,IAA5C;AAA4C,GAG1C,KAIR,MAAA;CAAA,IAAA,KAAA,GAAA,EAAA,EAAA,CAAA,CAAA,GAAC,EAAA,SAAA,eAAA,gBAAA;CACF,IAAI,GAAQ;EACR,IAAI,GAAU;GAAA,IAAA;GAA2C,OAA3C,EAAA,OAAA,IAA2C,IAAA,EAAA,MAAlC,IAAA,kBAAC,GAAD,EAAoBC,MAAA,EAAU,CAAA,GAAI,EAAA,KAAA,GAAA,EAAA,KAAA,IAAlC;EAAkC;EACzD,IAAI,GAAI;GAAA,IAAA;GAAqC,OAArC,EAAA,OAAA,IAAqC,IAAA,EAAA,MAA5B,IAAA,kBAAC,GAAD,EAAoB,QAAI,CAAA,GAAI,EAAA,KAAA,GAAA,EAAA,KAAA,IAA5B;EAA4B;EAAC,OAEvC;CAAI;CAGf,IAAI,GAAI;EAAA,IAAA;EAAqC,OAArC,EAAA,OAAA,IAAqC,IAAA,EAAA,MAA5B,IAAA,kBAAC,GAAD,EAAoB,QAAI,CAAA,GAAI,EAAA,KAAA,GAAA,EAAA,KAAA,IAA5B;CAA4B;CAAC,OACvC;AAAI"}
+{"version":3,"file":"index.js","names":["icon","activeIcon","_c","require_compiler_runtime","import_compiler_runtime","IconRenderer","$","t0","t1","icon","Icon","NavigationItemIconRenderer","isActive","activeIcon"],"sources":["../../../../../src/components/Navigation/NavigationItem/NavigationItemIconRenderer/NavigationItemIconRenderer.tsx"],"sourcesContent":["import type { LucideIcon } from \"lucide-react\";\nimport { Icon } from \"@/components/Icon\";\n\nconst IconRenderer: React.FC<{ icon: LucideIcon }> = ({ icon }) => {\n    return <Icon icon={icon} size={24} data-nav-icon />;\n};\n\n/**\n * Props for the [`NavigationItemIconRenderer`](src/components/Navigation/NavigationItem/NavigationItemIconRenderer/NavigationItemIconRenderer.tsx) component.\n */\nexport interface NavigationItemIconRendererProps {\n    /**\n     * Icon displayed when the item is in its inactive/resting state.\n     */\n    icon?: LucideIcon;\n\n    /**\n     * Alternate icon displayed when the item is active.\n     */\n    activeIcon?: LucideIcon;\n\n    /**\n     * Whether the parent navigation item is currently active.\n     */\n    isActive?: boolean;\n}\n\n/**\n * Internal icon renderer for navigation items.\n *\n * Renders a standard 24px icon with automatic fallback between `activeIcon` (when `isActive` is true)\n * and the resting `icon`.\n */\nexport const NavigationItemIconRenderer: React.FC<\n    NavigationItemIconRendererProps\n> = ({ icon, activeIcon, isActive }) => {\n    if (isActive) {\n        if (activeIcon) return <IconRenderer icon={activeIcon} />;\n        if (icon) return <IconRenderer icon={icon} />;\n\n        return null;\n    }\n\n    if (icon) return <IconRenderer icon={icon} />;\n    return null;\n};\n"],"mappings":";;;;A,aAGMK,KAA+C,MAAA;CAAA,IAAAC,KAAA,GAAAJ,EAAAA,EAAAA,CAAA,CAAA,GAAC,EAAA,YAAAK,GAAQC;CACP,OADOF,EAAA,OAAAG,IACP,IAAAH,EAAA,MAA5C,IAAA,kBAACI,GAAD;EAAY;EAAY,MAAA;EAAI,iBAAA;CAAa,CAAA,GAAG,EAAA,KAAAD,GAAA,EAAA,KAAAD,IAA5CA;AAA4C,GA6B1CG,KAET,MAAA;CAAA,IAAAL,KAAA,GAAAJ,EAAAA,EAAAA,CAAA,CAAA,GAAC,EAAA,SAAA,eAAA,gBAAAK;CACD,IAAIK,GAAQ;EACR,IAAIC,GAAU;GAAA,IAAAL;GAA2C,OAA3CF,EAAA,OAAAO,IAA2C,IAAAP,EAAA,MAAlC,IAAA,kBAACD,GAAD,EAAoBJ,MAAAY,EAAU,CAAA,GAAI,EAAA,KAAAA,GAAA,EAAA,KAAAL,IAAlCA;EAAkC;EACzD,IAAIC,GAAI;GAAA,IAAAD;GAAqC,OAArCF,EAAA,OAAAG,IAAqC,IAAAH,EAAA,MAA5B,IAAA,kBAACD,GAAD,EAAoB,QAAI,CAAA,GAAI,EAAA,KAAAI,GAAA,EAAA,KAAAD,IAA5BA;EAA4B;EAAC,OAEvC;CAAI;CAGf,IAAIC,GAAI;EAAA,IAAAD;EAAqC,OAArCF,EAAA,OAAAG,IAAqC,IAAAH,EAAA,MAA5B,IAAA,kBAACD,GAAD,EAAoB,QAAI,CAAA,GAAI,EAAA,KAAAI,GAAA,EAAA,KAAAD,IAA5BA;CAA4B;CAAC,OACvC;AAAI"}

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

@@ -1,2 +1,17 @@
 import { NavigationLinkProps } from './types';
+/**
+ * Anchor-based navigation item component.
+ *
+ * Renders an accessible navigation link that evaluates active URL state matching (using `href`),
+ * automatically toggles between resting and active icons, and applies Material Design 3
+ * active state pill backgrounds.
+ *
+ * @example
+ * ```tsx
+ * import { NavigationLink } from "@adgytec/web-ui-components";
+ * import { Home } from "lucide-react";
+ *
+ * <NavigationLink href="/dashboard" label="Dashboard" icon={Home} />
+ * ```
+ */
 export declare const NavigationLink: React.FC<NavigationLinkProps>;

package/dist/components/Navigation/NavigationItem/NavigationLink/index.js

@@ -5,7 +5,7 @@ import { NavigationItemIconRenderer as i } from "../NavigationItemIconRenderer/i
 import a from "clsx";
 import { jsx as o, jsxs as s } from "react/jsx-runtime";
 import { Link as c } from "react-aria-components";
-//#region src/components/Navigation/NavigationItem/NavigationLink/NavigationLink.tsx
+// src/components/Navigation/NavigationItem/NavigationLink/NavigationLink.tsx
 var l = e(), u = (e) => {
 	let u = (0, l.c)(25), d, f, p, m, h, g, _;
 	u[0] === e ? (d = u[1], f = u[2], p = u[3], m = u[4], h = u[5], g = u[6], _ = u[7]) : ({className: f, icon: m, activeIcon: d, label: g, href: p, isActive: h, ..._} = e, u[0] = e, u[1] = d, u[2] = f, u[3] = p, u[4] = m, u[5] = h, u[6] = g, u[7] = _);
@@ -28,7 +28,6 @@ var l = e(), u = (e) => {
 		children: [C, g]
 	}), u[18] = p, u[19] = g, u[20] = _, u[21] = x, u[22] = S, u[23] = C, u[24] = w) : w = u[24], w;
 };
-//#endregion
 export { u as NavigationLink };
 
 //# sourceMappingURL=index.js.map