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

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`](file:///home/rohan/work/adgytec/adgytec-web-ui-components/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":";;;;;;;;;;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;KAoBE,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`](file:///home/rohan/work/adgytec/adgytec-web-ui-components/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`](file:///home/rohan/work/adgytec/adgytec-web-ui-components/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`](file:///home/rohan/work/adgytec/adgytec-web-ui-components/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.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`](file:///home/rohan/work/adgytec/adgytec-web-ui-components/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":";;;;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.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["icon","activeIcon","linkActive","href","label"],"sources":["../../../../../src/components/Navigation/NavigationItem/NavigationLink/NavigationLink.tsx"],"sourcesContent":["import clsx from \"clsx\";\nimport { Link } from \"react-aria-components\";\nimport { useNavigationContext } from \"../../Navigation/navContext\";\nimport { NavigationItemLabelTypography, NavigationItemStyles } from \"../core\";\nimport { NavigationItemIconRenderer } from \"../NavigationItemIconRenderer\";\nimport type { NavigationLinkProps } from \"./types\";\n\nexport const NavigationLink: React.FC<NavigationLinkProps> = ({\n    className,\n    icon,\n    activeIcon,\n    label,\n    href,\n    isActive,\n    ...props\n}) => {\n    const { isLinkActive } = useNavigationContext();\n    const linkActive =\n        typeof isActive === \"function\"\n            ? isActive(href)\n            : (isActive ?? isLinkActive?.(href));\n\n    return (\n        <Link\n            className={(renderProps) =>\n                clsx(\n                    NavigationItemStyles,\n                    NavigationItemLabelTypography,\n                    typeof className === \"function\"\n                        ? className(renderProps)\n                        : className\n                )\n            }\n            href={href}\n            {...props}\n            data-active={linkActive || undefined}\n        >\n            <NavigationItemIconRenderer\n                icon={icon}\n                activeIcon={activeIcon}\n                isActive={linkActive}\n            />\n            {label}\n        </Link>\n    );\n};\n"],"mappings":";;;;;;;;aAOa,KAAgD,MAAA;CAAA,IAAA,KAAA,GAAA,EAAA,EAAA,CAAA,EAAA,GAAA,GAAA,GAAA,GAAA,GAAA,GAAA,GAAA;CAAA,AAAA,EAAA,OAAA,KAQ5D,IAAA,EAAA,IAAA,IAAA,EAAA,IAAA,IAAA,EAAA,IAAA,IAAA,EAAA,IAAA,IAAA,EAAA,IAAA,IAAA,EAAA,IAAA,IAAA,EAAA,OAR6D,0EAAA,KAAA,GAQ7D,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,oBAAyB,EAAqB,GAAE;CAAA,AAAA,EAAA,OAAA,KAAA,EAAA,OAAA,KAAA,EAAA,QAAA,KAE5C,IAAA,OAAO,KAAa,aACd,EAAS,CACwB,IAAhC,KAAY,IAAe,CAAI,GAAE,EAAA,KAAA,GAAA,EAAA,KAAA,GAAA,EAAA,MAAA,GAAA,EAAA,MAAA,KAAA,IAAA,EAAA;CAH5C,IAAA,IACI,GAEyC;CAAA,AAAA,EAAA,QAAA,IAWhC,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,GAAuB;CAAA,AAAA,EAAA,QAAA,KAAA,EAAA,QAAA,KAAA,EAAA,QAAA,KAEpC,IAAA,kBAAC,GAAD;EACU;EACM;EACFE,UAAA;CAAU,CAAA,GACtB,EAAA,MAAA,GAAA,EAAA,MAAA,GAAA,EAAA,MAAA,GAAA,EAAA,MAAA,KAAA,IAAA,EAAA;CAAA,IAAA;CAEC,OAFD,EAAA,QAAA,KAAA,EAAA,QAAA,KAAA,EAAA,QAAA,KAAA,EAAA,QAAA,KAAA,EAAA,QAAA,KAAA,EAAA,QAAA,KAlBN,IAAA,kBAAC,GAAD;EACe,WAAA;EASL;EAAI,GACN;EACS,eAAA;YAZjB,CAcI,GAKC,CAnBA;KAoBE,EAAA,MAAA,GAAA,EAAA,MAAA,GAAA,EAAA,MAAA,GAAA,EAAA,MAAA,GAAA,EAAA,MAAA,GAAA,EAAA,MAAA,GAAA,EAAA,MAAA,KAAA,IAAA,EAAA,KApBP;AAoBO"}
+{"version":3,"file":"index.js","names":["icon","activeIcon","linkActive","href","label","_c","clsx","require_compiler_runtime","useNavigationContext","NavigationItemLabelTypography","clsx$1","import_compiler_runtime","NavigationLink","$","activeIcon","className","href","icon","isActive","label","props","t0","t1","isLinkActive","linkActive","t2","NavigationItemStyles","renderProps","t3","t4","NavigationItemIconRenderer","t5","Link"],"sources":["../../../../../src/components/Navigation/NavigationItem/NavigationLink/NavigationLink.tsx"],"sourcesContent":["import clsx from \"clsx\";\nimport { Link } from \"react-aria-components\";\nimport { useNavigationContext } from \"../../Navigation/navContext\";\nimport { NavigationItemLabelTypography, NavigationItemStyles } from \"../core\";\nimport { NavigationItemIconRenderer } from \"../NavigationItemIconRenderer\";\nimport type { NavigationLinkProps } from \"./types\";\n\n/**\n * Anchor-based navigation item component.\n *\n * Renders an accessible navigation link that evaluates active URL state matching (using `href`),\n * automatically toggles between resting and active icons, and applies Material Design 3\n * active state pill backgrounds.\n *\n * @example\n * ```tsx\n * import { NavigationLink } from \"@adgytec/web-ui-components\";\n * import { Home } from \"lucide-react\";\n *\n * <NavigationLink href=\"/dashboard\" label=\"Dashboard\" icon={Home} />\n * ```\n */\nexport const NavigationLink: React.FC<NavigationLinkProps> = ({\n    className,\n    icon,\n    activeIcon,\n    label,\n    href,\n    isActive,\n    ...props\n}) => {\n    const { isLinkActive } = useNavigationContext();\n    const linkActive =\n        typeof isActive === \"function\"\n            ? isActive(href)\n            : (isActive ?? isLinkActive?.(href));\n\n    return (\n        <Link\n            className={(renderProps) =>\n                clsx(\n                    NavigationItemStyles,\n                    NavigationItemLabelTypography,\n                    typeof className === \"function\"\n                        ? className(renderProps)\n                        : className\n                )\n            }\n            href={href}\n            {...props}\n            data-active={linkActive || undefined}\n        >\n            <NavigationItemIconRenderer\n                icon={icon}\n                activeIcon={activeIcon}\n                isActive={linkActive}\n            />\n            {label}\n        </Link>\n    );\n};\n"],"mappings":";;;;;;;;aAsBaY,KAAgD,MAAA;CAAA,IAAAC,KAAA,GAAAR,EAAAA,EAAAA,CAAA,EAAA,GAAAS,GAAAC,GAAAC,GAAAC,GAAAC,GAAAC,GAAAC;CAAA,AAAAP,EAAA,OAAAQ,KAQ5D,IAAAR,EAAA,IAAA,IAAAA,EAAA,IAAA,IAAAA,EAAA,IAAA,IAAAA,EAAA,IAAA,IAAAA,EAAA,IAAA,IAAAA,EAAA,IAAA,IAAAA,EAAA,OAR6D,uEAAA,GAAAO,KAAAC,GAQ7D,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,oBAAyBZ,EAAqB,GAAEc;CAAA,AAAAT,EAAA,OAAAG,KAAAH,EAAA,OAAAK,KAAAL,EAAA,QAAAU,KAE5C,IAAA,OAAOL,KAAa,aACdA,EAASF,CACwB,IAAhCE,KAAYK,IAAeP,CAAI,GAAE,EAAA,KAAAA,GAAA,EAAA,KAAAE,GAAA,EAAA,MAAAK,GAAA,EAAA,MAAAD,KAAA,IAAAT,EAAA;CAH5C,IAAAW,IACIF,GAEyCG;CAAA,AAAAZ,EAAA,QAAAE,IAWhC,IAAAF,EAAA,OAPM,KAAA,MACPP,EACIoB,GACAjB,GACA,OAAOM,KAAc,aACfA,EAAUY,CACF,IAFdZ,CAGJ,GAAC,EAAA,MAAAA,GAAA,EAAA,MAAAU;CAIQ,IAAAG,IAAAJ,KAAA,KAAA,GAAuBK;CAAA,AAAAhB,EAAA,QAAAC,KAAAD,EAAA,QAAAI,KAAAJ,EAAA,QAAAW,KAEpC,IAAA,kBAACM,GAAD;EACU;EACM;EACF5B,UAAAsB;CAAU,CAAA,GACtB,EAAA,MAAAV,GAAA,EAAA,MAAAG,GAAA,EAAA,MAAAO,GAAA,EAAA,MAAAK,KAAA,IAAAhB,EAAA;CAAA,IAAAkB;CAEC,OAFDlB,EAAA,QAAAG,KAAAH,EAAA,QAAAM,KAAAN,EAAA,QAAAO,KAAAP,EAAA,QAAAY,KAAAZ,EAAA,QAAAe,KAAAf,EAAA,QAAAgB,KAlBN,IAAA,kBAACG,GAAD;EACe,WAAAP;EASL;EAAI,GACNL;EACS,eAAAQ;EAZjB,UAAA,CAcIC,GAKCV,CAnBA;KAoBE,EAAA,MAAAH,GAAA,EAAA,MAAAG,GAAA,EAAA,MAAAC,GAAA,EAAA,MAAAK,GAAA,EAAA,MAAAG,GAAA,EAAA,MAAAC,GAAA,EAAA,MAAAE,KAAA,IAAAlB,EAAA,KApBPkB;AAoBO"}

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

@@ -1,4 +1,9 @@
 import { Link } from 'react-aria-components';
 import { NavigationItemProps } from '../core';
+/**
+ * Props for the [`NavigationLink`](file:///home/rohan/work/adgytec/adgytec-web-ui-components/src/components/Navigation/NavigationItem/NavigationLink/NavigationLink.tsx) component.
+ *
+ * Extends React Aria's `Link` properties and [`NavigationItemProps`](file:///home/rohan/work/adgytec/adgytec-web-ui-components/src/components/Navigation/NavigationItem/core/navigationItem.ts#L8).
+ */
 export interface NavigationLinkProps extends Omit<React.ComponentPropsWithRef<typeof Link>, "children">, NavigationItemProps {
 }

package/dist/components/Navigation/NavigationItem/core/navigationItem.d.ts

@@ -1,10 +1,32 @@
 import { LucideIcon } from 'lucide-react';
 import { ReactNode } from 'react';
+/**
+ * Common configuration properties shared across navigation items ([`NavigationLink`](file:///home/rohan/work/adgytec/adgytec-web-ui-components/src/components/Navigation/NavigationItem/NavigationLink/NavigationLink.tsx)
+ * and [`NavigationButton`](file:///home/rohan/work/adgytec/adgytec-web-ui-components/src/components/Navigation/NavigationItem/NavigationButton/NavigationButton.tsx)).
+ */
 export interface NavigationItemProps {
+    /**
+     * Primary label content for the navigation item.
+     */
     label: ReactNode;
+    /**
+     * Optional icon displayed when the navigation item is in its inactive state.
+     */
     icon?: LucideIcon;
+    /**
+     * Optional alternate icon displayed when the navigation item is in its active state.
+     */
     activeIcon?: LucideIcon;
+    /**
+     * Override flag or predicate function evaluating whether the item is currently active.
+     */
     isActive?: boolean | ((value?: string) => boolean);
 }
+/**
+ * Standard typography style (`titleSmall`) for navigation item label text.
+ */
 export declare const NavigationItemLabelTypography: "typography-title-small";
+/**
+ * CSS class for individual navigation item styling, interactive state layers, and padding.
+ */
 export declare const NavigationItemStyles: string;

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

@@ -1 +1,22 @@
-export declare const NavigationScrollContainer: React.FC<React.ComponentPropsWithRef<"div">>;
+/**
+ * Props for the [`NavigationScrollContainer`](file:///home/rohan/work/adgytec/adgytec-web-ui-components/src/components/Navigation/NavigationScrollContainer/NavigationScrollContainer.tsx) component.
+ */
+export interface NavigationScrollContainerProps extends React.ComponentPropsWithRef<"div"> {
+}
+/**
+ * Scrollable viewport container for navigation items and sections.
+ *
+ * Automatically records and restores scroll progress on mount and scroll events,
+ * coordinating with [`NavigationState`](file:///home/rohan/work/adgytec/adgytec-web-ui-components/src/components/Navigation/NavigationState/NavigationState.tsx)
+ * to keep scroll positions synchronized when navigating into and out of sub-menus.
+ *
+ * @example
+ * ```tsx
+ * <NavigationScrollContainer>
+ *     <NavigationSection>
+ *         <NavigationLink href="/" label="Home" />
+ *     </NavigationSection>
+ * </NavigationScrollContainer>
+ * ```
+ */
+export declare const NavigationScrollContainer: React.FC<NavigationScrollContainerProps>;

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

@@ -1 +1,24 @@
-export declare const NavigationSection: React.FC<React.ComponentPropsWithRef<"section">>;
+/**
+ * Props for the [`NavigationSection`](file:///home/rohan/work/adgytec/adgytec-web-ui-components/src/components/Navigation/NavigationSection/NavigationSection/NavigationSection.tsx) component.
+ */
+export interface NavigationSectionProps extends React.ComponentPropsWithRef<"section"> {
+}
+/**
+ * Semantic container used to group related navigation items and an optional section heading.
+ *
+ * @example
+ * ```tsx
+ * import {
+ *     NavigationSection,
+ *     NavigationSectionLabel,
+ *     NavigationLink,
+ * } from "@adgytec/web-ui-components";
+ * import { Settings } from "lucide-react";
+ *
+ * <NavigationSection>
+ *     <NavigationSectionLabel>Preferences</NavigationSectionLabel>
+ *     <NavigationLink href="/settings" label="Settings" icon={Settings} />
+ * </NavigationSection>
+ * ```
+ */
+export declare const NavigationSection: React.FC<NavigationSectionProps>;

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

@@ -1,2 +1,17 @@
 import { Heading } from 'react-aria-components';
-export declare const NavigationSectionLabel: React.FC<React.ComponentPropsWithRef<typeof Heading>>;
+/**
+ * Props for the [`NavigationSectionLabel`](file:///home/rohan/work/adgytec/adgytec-web-ui-components/src/components/Navigation/NavigationSection/NavigationSectionLabel/NavigationSectionLabel.tsx) component.
+ */
+export interface NavigationSectionLabelProps extends React.ComponentPropsWithRef<typeof Heading> {
+}
+/**
+ * Styled title heading for a [`NavigationSection`](file:///home/rohan/work/adgytec/adgytec-web-ui-components/src/components/Navigation/NavigationSection/NavigationSection/NavigationSection.tsx).
+ *
+ * Rendered with Material Design 3 `titleSmall` typography and accessible heading semantics.
+ *
+ * @example
+ * ```tsx
+ * <NavigationSectionLabel>Workspaces</NavigationSectionLabel>
+ * ```
+ */
+export declare const NavigationSectionLabel: React.FC<NavigationSectionLabelProps>;

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

@@ -1,4 +1,29 @@
 import { ReactNode } from 'react';
-export declare const NavigationState: React.FC<{
+/**
+ * Props for the [`NavigationState`](file:///home/rohan/work/adgytec/adgytec-web-ui-components/src/components/Navigation/NavigationState/NavigationState.tsx) component.
+ */
+export interface NavigationStateProps {
+    /**
+     * Child elements, typically one or more [`Navigation`](file:///home/rohan/work/adgytec/adgytec-web-ui-components/src/components/Navigation/Navigation/Navigation.tsx) instances.
+     */
     children?: ReactNode;
-}>;
+}
+/**
+ * Global navigation state coordinator component.
+ *
+ * Coordinates active sub-navigation panel stacks, tracks inert states for covered panels,
+ * and maintains scroll position synchronization across multiple navigation instances
+ * (such as a persistent desktop sidebar and a mobile drawer).
+ *
+ * @example
+ * ```tsx
+ * import { NavigationState, Navigation } from "@adgytec/web-ui-components";
+ *
+ * <NavigationState>
+ *     <Navigation label="Main Navigation">
+ *         {...}
+ *     </Navigation>
+ * </NavigationState>
+ * ```
+ */
+export declare const NavigationState: React.FC<NavigationStateProps>;

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

@@ -1,10 +1,41 @@
+/**
+ * Context value managing sub-navigation transitions, inert state tracking, and scroll progress synchronization.
+ */
 export type NavigationStateContextType = {
+    /**
+     * Opens a sub-navigation panel at the specified depth level.
+     */
     openSubNavigation: (id: string, depth: number) => void;
+    /**
+     * Closes the sub-navigation panel matching `id` and any panels nested deeper.
+     */
     closeSubNavigation: (id: string) => void;
+    /**
+     * Saves scroll progress (0 to 1) for the navigation level matching `id`.
+     */
     saveNavigationScrollTopProgress: (id: string, progress: number) => void;
+    /**
+     * Checks whether a given sub-navigation panel is currently open.
+     */
     isSubNavigationOpen: (id: string) => boolean;
+    /**
+     * Checks whether a given depth level should be inert (i.e. covered by a deeper active sub-navigation panel).
+     */
     isInert: (depth: number) => boolean;
+    /**
+     * Retrieves the saved scroll progress (0 to 1) for the navigation level matching `id`.
+     */
     getNavigationScrollProgress: (id: string) => number;
 };
+/**
+ * React context coordinating navigation transition stacks, inert states, and scroll synchronization.
+ */
 export declare const NavigationStateContext: import('react').Context<NavigationStateContextType | null>;
+/**
+ * Hook to access the current navigation state manager.
+ *
+ * @throws If called outside of a [`NavigationState`](file:///home/rohan/work/adgytec/adgytec-web-ui-components/src/components/Navigation/NavigationState/NavigationState.tsx)
+ * or [`Navigation`](file:///home/rohan/work/adgytec/adgytec-web-ui-components/src/components/Navigation/Navigation/Navigation.tsx) component.
+ * @returns The current {@link NavigationStateContextType}.
+ */
 export declare function useNavigationState(): NavigationStateContextType;

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

@@ -1,2 +1,3 @@
 export * from './context';
 export * from './NavigationState';
+export type * from './types';

package/dist/components/Navigation/NavigationState/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["id","item","x","prev","depth","children"],"sources":["../../../../src/components/Navigation/NavigationState/context.ts","../../../../src/components/Navigation/NavigationState/NavigationState.tsx"],"sourcesContent":["import { createContext, useContext } from \"react\";\n\nexport type NavigationStateContextType = {\n    openSubNavigation: (id: string, depth: number) => void;\n    closeSubNavigation: (id: string) => void;\n    saveNavigationScrollTopProgress: (id: string, progress: number) => void;\n\n    isSubNavigationOpen: (id: string) => boolean;\n    isInert: (depth: number) => boolean;\n\n    getNavigationScrollProgress: (id: string) => number;\n};\n\nexport const NavigationStateContext =\n    createContext<NavigationStateContextType | null>(null);\n\nexport function useNavigationState() {\n    const ctx = useContext(NavigationStateContext);\n    if (ctx === null) {\n        throw new Error(\n            \"Missing navigation state. Ensure this component is rendered within Navigation component.\"\n        );\n    }\n\n    return ctx;\n}\n","import { type ReactNode, useCallback, useRef, useState } from \"react\";\nimport { NavigationStateContext } from \"./context\";\nimport type { NavScrollInfo, SubNavItem } from \"./types\";\n\nexport const NavigationState: React.FC<{ children?: ReactNode }> = ({\n    children,\n}) => {\n    const [openSubNavs, setOpenSubNavs] = useState<SubNavItem[]>([]);\n    const navScrollRef = useRef<NavScrollInfo>({});\n\n    const getNavigationScrollProgress = useCallback((id: string) => {\n        return navScrollRef.current[id] ?? 0;\n    }, []);\n\n    const openSubNavigation = useCallback((id: string, depth: number) => {\n        setOpenSubNavs((prev) => [\n            ...prev.filter((item) => item.depth < depth),\n            { id, depth },\n        ]);\n    }, []);\n\n    const closeSubNavigation = useCallback(\n        (id: string) => {\n            const item = openSubNavs.find((x) => x.id === id);\n            if (!item) {\n                return;\n            }\n\n            const removedItems = openSubNavs.filter(\n                (x) => x.depth >= item.depth\n            );\n            for (const removedItem of removedItems) {\n                delete navScrollRef.current[removedItem.id];\n            }\n\n            setOpenSubNavs((prev) => prev.filter((x) => x.depth < item.depth));\n        },\n        [openSubNavs]\n    );\n\n    const saveNavigationScrollTopProgress = useCallback(\n        (id: string, progress: number) => {\n            navScrollRef.current[id] = progress;\n        },\n        []\n    );\n\n    const isSubNavigationOpen = useCallback(\n        (id: string) => {\n            return openSubNavs.some((item) => item.id === id);\n        },\n        [openSubNavs]\n    );\n\n    const isInert = useCallback(\n        (depth: number) => {\n            const activeDepth = openSubNavs[openSubNavs.length - 1]?.depth ?? 0;\n\n            return depth < activeDepth;\n        },\n        [openSubNavs]\n    );\n\n    return (\n        <NavigationStateContext\n            value={{\n                getNavigationScrollProgress,\n                openSubNavigation,\n                closeSubNavigation,\n                saveNavigationScrollTopProgress,\n                isSubNavigationOpen,\n                isInert,\n            }}\n        >\n            {children}\n        </NavigationStateContext>\n    );\n};\n"],"mappings":";;;;AAaA,IAAa,IACT,EAAiD,IAAI;AAEzD,SAAO,IAAA;CACH,IAAA,IAAY,EAAW,CAAsB;CAC7C,IAAI,MAAQ,MACR,MAAU,MACN,0FACJ;CACH,OAEM;AAAG;;;aCpBD,KAAsD,MAAA;CAAA,IAAA,KAAA,GAAA,EAAA,EAAA,CAAA,EAAA,GAAC,EAAA,gBAAA,GAEnE;CAAA,AAAA,EAAA,OAAA,OAAA,IAAA,2BAAA,KACgE,IAAA,CAAA,GAAE,EAAA,KAAA,KAAA,IAAA,EAAA;CAA/D,IAAA,CAAA,GAAA,KAAsC,EAAuB,CAAE,GAAE;CAAA,AAAA,EAAA,OAAA,OAAA,IAAA,2BAAA,KACtB,IAAA,CAAC,GAAC,EAAA,KAAA,KAAA,IAAA,EAAA;CAA7C,IAAA,IAAqB,EAAsB,CAAE,GAAE;CAAA,AAAA,EAAA,OAAA,OAAA,IAAA,2BAAA,KAEC,KAAA,MACrC,EAAY,QAAS,MAArB,GACV,EAAA,KAAA,KAAA,IAAA,EAAA;CAFD,IAAA,IAAoC,GAE7B;CAAA,AAAA,EAAA,OAAA,OAAA,IAAA,2BAAA,KAE+B,KAAA,GAAA,MAAA;EAClC,GAAe,MAAU,CAAA,GAClB,EAAI,QAAQ,MAAU,EAAI,QAAS,CAAK,GAC3C;GAAA,IAAEA;GAAE;EAAQ,CAAC,CAChB;CAAC,GACL,EAAA,KAAA,KAAA,IAAA,EAAA;CALD,IAAA,IAA0B,GAKnB;CAAA,AAAA,EAAA,OAAA,IAiBF,IAAA,EAAA,MAdD,KAAA,MAAA;EACI,IAAA,IAAa,EAAW,MAAM,MAAO,EAAC,OAAQA,CAAE;EAChD,IAAI,CAACC,GAAI;EAIT,IAAA,IAAqB,EAAW,QAC5B,MAAOC,EAAC,SAAUD,EAAI,KAC1B;EACA,KAAK,IAAA,KAAqB,GACtB,OAAO,EAAY,QAAS,EAAW;EAG3C,GAAe,MAAUE,EAAI,QAAQ,MAAOD,EAAC,QAASD,EAAI,KAAM,CAAC;CAAC,GACrE,EAAA,KAAA,GAAA,EAAA,KAAA;CAfL,IAAA,IAA2B,GAiBzB;CAAA,AAAA,EAAA,OAAA,OAAA,IAAA,2BAAA,KAGE,KAAA,GAAA,MAAA;EACI,EAAY,QAASD,KAAM;CAAH,GAC3B,EAAA,KAAA,KAAA,IAAA,EAAA;CAHL,IAAA,IAAwC,GAKtC;CAAA,AAAA,EAAA,OAAA,IAKG,IAAA,EAAA,MAFD,KAAA,MACW,EAAW,MAAM,MAAUC,EAAI,OAAQD,CAAE,GACnD,EAAA,KAAA,GAAA,EAAA,KAAA;CAHL,IAAA,IAA4B,GAK1B;CAAA,AAAA,EAAA,OAAA,IAOG,IAAA,EAAA,OAJD,KAAA,MAGWI,KAFa,EAAY,EAAW,SAAU,EAAS,EAAA,SAA1C,IAGvB,EAAA,KAAA,GAAA,EAAA,MAAA;CALL,IAAA,IAAgB,GAOd;CAAA,AAAA,EAAA,QAAA,KAAA,EAAA,QAAA,KAAA,EAAA,QAAA,KAIa,IAAA;EAAA;EAAA;EAAA;EAAA;EAAA;EAAA;CAOP,GAAC,EAAA,MAAA,GAAA,EAAA,MAAA,GAAA,EAAA,MAAA,GAAA,EAAA,MAAA,KAAA,IAAA,EAAA;CAAA,IAAA;CAGoB,OAHpB,EAAA,QAAA,KAAA,EAAA,QAAA,KARL,IAAA,kBAAC,GAAD;EACW,OAAA;EASN;CAVkB,CAAA,GAWE,EAAA,MAAA,GAAA,EAAA,MAAA,GAAA,EAAA,MAAA,KAAA,IAAA,EAAA,KAXzB;AAWyB"}
+{"version":3,"file":"index.js","names":["id","item","x","prev","depth","children","_c","require_compiler_runtime","NavigationStateContext","createContext","useNavigationState","ctx","useContext","import_compiler_runtime","NavigationState","$","t0","t1","openSubNavs","setOpenSubNavs","useState","t2","navScrollRef","useRef","t3","id","getNavigationScrollProgress","t4","prev","item","depth","id_0","openSubNavigation","t5","item_0","x","id_1","removedItems","x_0","removedItem","prev_0","x_1","closeSubNavigation","t6","id_2","progress","saveNavigationScrollTopProgress","t7","item_1","id_3","isSubNavigationOpen","t8","depth_0","isInert","t9","t10","children"],"sources":["../../../../src/components/Navigation/NavigationState/context.ts","../../../../src/components/Navigation/NavigationState/NavigationState.tsx"],"sourcesContent":["import { createContext, useContext } from \"react\";\n\n/**\n * Context value managing sub-navigation transitions, inert state tracking, and scroll progress synchronization.\n */\nexport type NavigationStateContextType = {\n    /**\n     * Opens a sub-navigation panel at the specified depth level.\n     */\n    openSubNavigation: (id: string, depth: number) => void;\n    /**\n     * Closes the sub-navigation panel matching `id` and any panels nested deeper.\n     */\n    closeSubNavigation: (id: string) => void;\n    /**\n     * Saves scroll progress (0 to 1) for the navigation level matching `id`.\n     */\n    saveNavigationScrollTopProgress: (id: string, progress: number) => void;\n\n    /**\n     * Checks whether a given sub-navigation panel is currently open.\n     */\n    isSubNavigationOpen: (id: string) => boolean;\n    /**\n     * Checks whether a given depth level should be inert (i.e. covered by a deeper active sub-navigation panel).\n     */\n    isInert: (depth: number) => boolean;\n\n    /**\n     * Retrieves the saved scroll progress (0 to 1) for the navigation level matching `id`.\n     */\n    getNavigationScrollProgress: (id: string) => number;\n};\n\n/**\n * React context coordinating navigation transition stacks, inert states, and scroll synchronization.\n */\nexport const NavigationStateContext =\n    createContext<NavigationStateContextType | null>(null);\n\n/**\n * Hook to access the current navigation state manager.\n *\n * @throws If called outside of a [`NavigationState`](file:///home/rohan/work/adgytec/adgytec-web-ui-components/src/components/Navigation/NavigationState/NavigationState.tsx)\n * or [`Navigation`](file:///home/rohan/work/adgytec/adgytec-web-ui-components/src/components/Navigation/Navigation/Navigation.tsx) component.\n * @returns The current {@link NavigationStateContextType}.\n */\nexport function useNavigationState() {\n    const ctx = useContext(NavigationStateContext);\n    if (ctx === null) {\n        throw new Error(\n            \"Missing navigation state. Ensure this component is rendered within Navigation component.\"\n        );\n    }\n\n    return ctx;\n}\n","import { type ReactNode, useCallback, useRef, useState } from \"react\";\nimport { NavigationStateContext } from \"./context\";\nimport type { NavScrollInfo, SubNavItem } from \"./types\";\n\n/**\n * Props for the [`NavigationState`](file:///home/rohan/work/adgytec/adgytec-web-ui-components/src/components/Navigation/NavigationState/NavigationState.tsx) component.\n */\nexport interface NavigationStateProps {\n    /**\n     * Child elements, typically one or more [`Navigation`](file:///home/rohan/work/adgytec/adgytec-web-ui-components/src/components/Navigation/Navigation/Navigation.tsx) instances.\n     */\n    children?: ReactNode;\n}\n\n/**\n * Global navigation state coordinator component.\n *\n * Coordinates active sub-navigation panel stacks, tracks inert states for covered panels,\n * and maintains scroll position synchronization across multiple navigation instances\n * (such as a persistent desktop sidebar and a mobile drawer).\n *\n * @example\n * ```tsx\n * import { NavigationState, Navigation } from \"@adgytec/web-ui-components\";\n *\n * <NavigationState>\n *     <Navigation label=\"Main Navigation\">\n *         {...}\n *     </Navigation>\n * </NavigationState>\n * ```\n */\nexport const NavigationState: React.FC<NavigationStateProps> = ({\n    children,\n}) => {\n    const [openSubNavs, setOpenSubNavs] = useState<SubNavItem[]>([]);\n    const navScrollRef = useRef<NavScrollInfo>({});\n\n    const getNavigationScrollProgress = useCallback((id: string) => {\n        return navScrollRef.current[id] ?? 0;\n    }, []);\n\n    const openSubNavigation = useCallback((id: string, depth: number) => {\n        setOpenSubNavs((prev) => [\n            ...prev.filter((item) => item.depth < depth),\n            { id, depth },\n        ]);\n    }, []);\n\n    const closeSubNavigation = useCallback(\n        (id: string) => {\n            const item = openSubNavs.find((x) => x.id === id);\n            if (!item) {\n                return;\n            }\n\n            const removedItems = openSubNavs.filter(\n                (x) => x.depth >= item.depth\n            );\n            for (const removedItem of removedItems) {\n                delete navScrollRef.current[removedItem.id];\n            }\n\n            setOpenSubNavs((prev) => prev.filter((x) => x.depth < item.depth));\n        },\n        [openSubNavs]\n    );\n\n    const saveNavigationScrollTopProgress = useCallback(\n        (id: string, progress: number) => {\n            navScrollRef.current[id] = progress;\n        },\n        []\n    );\n\n    const isSubNavigationOpen = useCallback(\n        (id: string) => {\n            return openSubNavs.some((item) => item.id === id);\n        },\n        [openSubNavs]\n    );\n\n    const isInert = useCallback(\n        (depth: number) => {\n            const activeDepth = openSubNavs[openSubNavs.length - 1]?.depth ?? 0;\n\n            return depth < activeDepth;\n        },\n        [openSubNavs]\n    );\n\n    return (\n        <NavigationStateContext\n            value={{\n                getNavigationScrollProgress,\n                openSubNavigation,\n                closeSubNavigation,\n                saveNavigationScrollTopProgress,\n                isSubNavigationOpen,\n                isInert,\n            }}\n        >\n            {children}\n        </NavigationStateContext>\n    );\n};\n"],"mappings":"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"}

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

@@ -1,5 +1,17 @@
+/**
+ * Map recording scroll progress values (0 to 1) keyed by navigation level identifier.
+ */
 export type NavScrollInfo = Record<string, number>;
+/**
+ * Representation of an active sub-navigation panel in the navigation stack.
+ */
 export type SubNavItem = {
+    /**
+     * Unique identifier for the sub-navigation panel.
+     */
     id: string;
+    /**
+     * Nesting depth level of the sub-navigation panel.
+     */
     depth: number;
 };

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

@@ -1,4 +1,37 @@
 import { ReactNode } from 'react';
-export declare const SubNavigation: React.FC<React.ComponentPropsWithRef<"nav"> & {
+/**
+ * Props for the [`SubNavigation`](file:///home/rohan/work/adgytec/adgytec-web-ui-components/src/components/Navigation/SubNavigation/SubNavigation/SubNavigation.tsx) component.
+ */
+export interface SubNavigationProps extends React.ComponentPropsWithRef<"nav"> {
+    /**
+     * Heading title displayed at the top of the sub-navigation panel.
+     * If omitted, inherits the label provided to the ancestor
+     * [`SubNavigationTrigger`](file:///home/rohan/work/adgytec/adgytec-web-ui-components/src/components/Navigation/SubNavigation/SubNavigationTrigger/SubNavigationTrigger.tsx).
+     */
     label?: ReactNode;
-}>;
+}
+/**
+ * Secondary sliding navigation panel rendered into the root navigation container via a React Portal.
+ *
+ * Provides a dedicated header with an animated back button, accessible focus containment via `FocusScope`,
+ * slide-in transition animations, and independent scroll position synchronization.
+ *
+ * @example
+ * ```tsx
+ * import {
+ *     SubNavigationTrigger,
+ *     NavigationButton,
+ *     SubNavigation,
+ *     NavigationLink,
+ * } from "@adgytec/web-ui-components";
+ * import { Folder, Plus } from "lucide-react";
+ *
+ * <SubNavigationTrigger stateID="projects" label="Projects">
+ *     <NavigationButton icon={Folder} />
+ *     <SubNavigation>
+ *         <NavigationLink href="/projects/new" label="New Project" icon={Plus} />
+ *     </SubNavigation>
+ * </SubNavigationTrigger>
+ * ```
+ */
+export declare const SubNavigation: React.FC<SubNavigationProps>;

package/dist/components/Navigation/SubNavigation/SubNavigation/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["subNavRef","status","ArrowLeft","headerLabel","children"],"sources":["../../../../../src/components/Navigation/SubNavigation/SubNavigation/SubNavigation.tsx"],"sourcesContent":["import clsx from \"clsx\";\nimport { ArrowLeft } from \"lucide-react\";\nimport { type ReactNode, useContext } from \"react\";\nimport { FocusScope, useObjectRef } from \"react-aria\";\nimport { Header, Heading } from \"react-aria-components\";\nimport { createPortal } from \"react-dom\";\nimport { Transition } from \"react-transition-group\";\nimport { IconButton } from \"@/components/Button\";\nimport { useInDialog } from \"@/components/Dialog\";\nimport { typography } from \"@/utils\";\nimport {\n    NavigationStyles,\n    NavLabelContext,\n    SubNavigationHeaderStyles,\n    useNavigationInfo,\n} from \"../../core\";\nimport { useNavigationContainer } from \"../../Navigation\";\nimport { NavigationScrollContainer } from \"../../NavigationScrollContainer\";\nimport { useNavigationState } from \"../../NavigationState\";\n\nexport const SubNavigation: React.FC<\n    React.ComponentPropsWithRef<\"nav\"> & { label?: ReactNode }\n> = ({ className, label, children, inert, ref, style, ...props }) => {\n    const subNavRef = useObjectRef(ref);\n\n    const isInModal = useInDialog();\n\n    const { id, depth } = useNavigationInfo();\n    const { isInert, isSubNavigationOpen } = useNavigationState();\n    const { container } = useNavigationContainer();\n\n    const triggerLabel = useContext(NavLabelContext);\n    const headerLabel = label ?? triggerLabel;\n\n    if (container === null) return null;\n\n    return createPortal(\n        <Transition\n            nodeRef={subNavRef}\n            timeout={{\n                enter: 0,\n                exit: 150,\n            }}\n            in={isSubNavigationOpen(id)}\n            mountOnEnter\n            unmountOnExit\n        >\n            {(status) => (\n                <FocusScope restoreFocus>\n                    <nav\n                        ref={subNavRef}\n                        className={clsx(NavigationStyles, className)}\n                        {...props}\n                        style={{\n                            ...style,\n                            zIndex: depth + 1,\n                        }}\n                        inert={inert ?? isInert(depth)}\n                        data-header={true}\n                        data-status={status}\n                        data-sub-nav={true}\n                        data-modal={isInModal || undefined}\n                    >\n                        <Header className={clsx(SubNavigationHeaderStyles)}>\n                            <IconButton\n                                icon={ArrowLeft}\n                                color=\"standard\"\n                                slot=\"close\"\n                                data-close-button\n                            />\n\n                            {headerLabel && (\n                                <Heading\n                                    className={clsx(typography.titleLarge)}\n                                    data-heading\n                                >\n                                    {headerLabel}\n                                </Heading>\n                            )}\n                        </Header>\n\n                        <NavigationScrollContainer>\n                            {children}\n                        </NavigationScrollContainer>\n                    </nav>\n                </FocusScope>\n            )}\n        </Transition>,\n        container\n    );\n};\n"],"mappings":";;;;;;;;;;;;;;;;;aAoBa,KAET,MAAA;CAAA,IAAA,KAAA,GAAA,EAAA,EAAA,CAAA,EAAA,GAAA,GAAA,GAAA,GAAA,GAAA,GAAA,GAAA;CAAA,AAAA,EAAA,OAAA,KAA4D,IAAA,EAAA,IAAA,IAAA,EAAA,IAAA,IAAA,EAAA,IAAA,IAAA,EAAA,IAAA,IAAA,EAAA,IAAA,IAAA,EAAA,IAAA,IAAA,EAAA,OAA3D,qEAAA,KAAA,GAA2D,EAAA,KAAA,GAAA,EAAA,KAAA,GAAA,EAAA,KAAA,GAAA,EAAA,KAAA,GAAA,EAAA,KAAA,GAAA,EAAA,KAAA,GAAA,EAAA,KAAA,GAAA,EAAA,KAAA;CAC5D,IAAA,IAAkB,EAAa,CAAG,GAElC,IAAkB,EAAY,GAE9B,EAAA,OAAA,aAAsB,EAAkB,GACxC,EAAA,YAAA,2BAAyC,EAAmB,GAC5D,EAAA,iBAAsB,EAAuB,GAE7C,IAAqB,EAAW,CAAe,GAC/C,IAAoB,KAAA;CAEpB,IAAI,MAAc,MAAI,OAAS;CAAK,IAAA;CAAA,AAAA,EAAA,OAAA,OAAA,IAAA,2BAAA,KAKnB,IAAA;EAAA,OACE;EAAC,MACF;CACV,GAAC,EAAA,KAAA,KAAA,IAAA,EAAA;CAAA,IAAA;CAAA,AAAA,EAAA,OAAA,KAAA,EAAA,QAAA,KACG,IAAA,EAAoB,CAAE,GAAC,EAAA,KAAA,GAAA,EAAA,MAAA,GAAA,EAAA,MAAA,KAAA,IAAA,EAAA;CAAA,IAAA;CAAA,AAAA,EAAA,QAAA,KAAA,EAAA,QAAA,KAAA,EAAA,QAAA,KAAA,EAAA,QAAA,KAAA,EAAA,QAAA,KAAA,EAAA,QAAA,KAAA,EAAA,QAAA,KAAA,EAAA,QAAA,KAAA,EAAA,QAAA,KAAA,EAAA,QAAA,KAI1B,KAAA,MACG,kBAAC,GAAD;EAAY,cAAA;YACR,kBAAA,OAAA;GACSA,KAAA;GACM,WAAA,EAAK,GAAkB,CAAS;GAAC,GACxC;GACG,OAAA;IAAA,GACA;IAAK,QACA,IAAQ;GACpB;GACO,OAAA,KAAS,EAAQ,CAAK;GAChB,eAAA;GACAC,eAAA;GACC,gBAAA;GACF,cAAA,KAAA,KAAA;aAZhB,CAcI,kBAAC,GAAD;IAAmB,WAAA,EAAK,CAAyB;cAAjD,CACI,kBAAC,GAAD;KACUC,MAAA;KACA,OAAA;KACD,MAAA;KACL,qBAAA;IAAiB,CAAA,GAGpB,KACG,kBAAC,GAAD;KACe,WAAA,EAAK,EAAU,UAAW;KACrC,gBAAA;eAEC;IAJG,CAAA,CATT;OAkBP,kBAAC,GAAD,EACK,YADqB,CAAA,CAGxB;;CApCC,CAAA,GAsCd,EAAA,MAAA,GAAA,EAAA,MAAA,GAAA,EAAA,MAAA,GAAA,EAAA,MAAA,GAAA,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;CAAA,AAAA,EAAA,QAAA,KAAA,EAAA,QAAA,KAAA,EAAA,QAAA,KAjDL,IAAA,kBAAC,GAAD;EACaF,SAAA;EACA,SAAA;EAIL,IAAA;EACJ,cAAA;EACA,eAAA;YAEC;CAVM,CAAA,GAkDE,EAAA,MAAA,GAAA,EAAA,MAAA,GAAA,EAAA,MAAA,GAAA,EAAA,MAAA,KAAA,IAAA,EAAA;CAAA,IAAA;CAEhB,OAFgB,EAAA,QAAA,KAAA,EAAA,QAAA,KAnDV,IAAA,EACH,GAmDA,CACJ,GAAC,EAAA,MAAA,GAAA,EAAA,MAAA,GAAA,EAAA,MAAA,KAAA,IAAA,EAAA,KArDM;AAqDN"}
+{"version":3,"file":"index.js","names":["subNavRef","status","ArrowLeft","headerLabel","children","_c","clsx","require_compiler_runtime","typography","useNavigationInfo","NavLabelContext","useNavigationContainer","clsx$1","import_compiler_runtime","SubNavigation","$","children","className","inert","label","props","ref","style","t0","subNavRef","useObjectRef","isInModal","useInDialog","useNavigationState","triggerLabel","useContext","headerLabel","container","t1","t2","id","isSubNavigationOpen","t3","depth","isInert","FocusScope","NavigationStyles","status","Header","SubNavigationHeaderStyles","IconButton","ArrowLeft","Heading","NavigationScrollContainer","t4","Transition","t5","createPortal"],"sources":["../../../../../src/components/Navigation/SubNavigation/SubNavigation/SubNavigation.tsx"],"sourcesContent":["import clsx from \"clsx\";\nimport { ArrowLeft } from \"lucide-react\";\nimport { type ReactNode, useContext } from \"react\";\nimport { FocusScope, useObjectRef } from \"react-aria\";\nimport { Header, Heading } from \"react-aria-components\";\nimport { createPortal } from \"react-dom\";\nimport { Transition } from \"react-transition-group\";\nimport { IconButton } from \"@/components/Button\";\nimport { useInDialog } from \"@/components/Dialog\";\nimport { typography } from \"@/utils\";\nimport {\n    NavigationStyles,\n    NavLabelContext,\n    SubNavigationHeaderStyles,\n    useNavigationInfo,\n} from \"../../core\";\nimport { useNavigationContainer } from \"../../Navigation\";\nimport { NavigationScrollContainer } from \"../../NavigationScrollContainer\";\nimport { useNavigationState } from \"../../NavigationState\";\n\n/**\n * Props for the [`SubNavigation`](file:///home/rohan/work/adgytec/adgytec-web-ui-components/src/components/Navigation/SubNavigation/SubNavigation/SubNavigation.tsx) component.\n */\nexport interface SubNavigationProps extends React.ComponentPropsWithRef<\"nav\"> {\n    /**\n     * Heading title displayed at the top of the sub-navigation panel.\n     * If omitted, inherits the label provided to the ancestor\n     * [`SubNavigationTrigger`](file:///home/rohan/work/adgytec/adgytec-web-ui-components/src/components/Navigation/SubNavigation/SubNavigationTrigger/SubNavigationTrigger.tsx).\n     */\n    label?: ReactNode;\n}\n\n/**\n * Secondary sliding navigation panel rendered into the root navigation container via a React Portal.\n *\n * Provides a dedicated header with an animated back button, accessible focus containment via `FocusScope`,\n * slide-in transition animations, and independent scroll position synchronization.\n *\n * @example\n * ```tsx\n * import {\n *     SubNavigationTrigger,\n *     NavigationButton,\n *     SubNavigation,\n *     NavigationLink,\n * } from \"@adgytec/web-ui-components\";\n * import { Folder, Plus } from \"lucide-react\";\n *\n * <SubNavigationTrigger stateID=\"projects\" label=\"Projects\">\n *     <NavigationButton icon={Folder} />\n *     <SubNavigation>\n *         <NavigationLink href=\"/projects/new\" label=\"New Project\" icon={Plus} />\n *     </SubNavigation>\n * </SubNavigationTrigger>\n * ```\n */\nexport const SubNavigation: React.FC<SubNavigationProps> = ({\n    className,\n    label,\n    children,\n    inert,\n    ref,\n    style,\n    ...props\n}) => {\n    const subNavRef = useObjectRef(ref);\n\n    const isInModal = useInDialog();\n\n    const { id, depth } = useNavigationInfo();\n    const { isInert, isSubNavigationOpen } = useNavigationState();\n    const { container } = useNavigationContainer();\n\n    const triggerLabel = useContext(NavLabelContext);\n    const headerLabel = label ?? triggerLabel;\n\n    if (container === null) return null;\n\n    return createPortal(\n        <Transition\n            nodeRef={subNavRef}\n            timeout={{\n                enter: 0,\n                exit: 150,\n            }}\n            in={isSubNavigationOpen(id)}\n            mountOnEnter\n            unmountOnExit\n        >\n            {(status) => (\n                <FocusScope restoreFocus>\n                    <nav\n                        ref={subNavRef}\n                        className={clsx(NavigationStyles, className)}\n                        {...props}\n                        style={{\n                            ...style,\n                            zIndex: depth + 1,\n                        }}\n                        inert={inert ?? isInert(depth)}\n                        data-header={true}\n                        data-status={status}\n                        data-sub-nav={true}\n                        data-modal={isInModal || undefined}\n                    >\n                        <Header className={clsx(SubNavigationHeaderStyles)}>\n                            <IconButton\n                                icon={ArrowLeft}\n                                color=\"standard\"\n                                slot=\"close\"\n                                data-close-button\n                            />\n\n                            {headerLabel && (\n                                <Heading\n                                    className={clsx(typography.titleLarge)}\n                                    data-heading\n                                >\n                                    {headerLabel}\n                                </Heading>\n                            )}\n                        </Header>\n\n                        <NavigationScrollContainer>\n                            {children}\n                        </NavigationScrollContainer>\n                    </nav>\n                </FocusScope>\n            )}\n        </Transition>,\n        container\n    );\n};\n"],"mappings":"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"}

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

@@ -1,6 +1,44 @@
 import { ReactNode } from 'react';
-export declare const SubNavigationTrigger: React.FC<{
+/**
+ * Props for the [`SubNavigationTrigger`](file:///home/rohan/work/adgytec/adgytec-web-ui-components/src/components/Navigation/SubNavigation/SubNavigationTrigger/SubNavigationTrigger.tsx) component.
+ */
+export interface SubNavigationTriggerProps {
+    /**
+     * Unique state key used for referencing and animating this sub-navigation level.
+     */
     stateID: string;
+    /**
+     * Child elements, typically an opening trigger button and a [`SubNavigation`](file:///home/rohan/work/adgytec/adgytec-web-ui-components/src/components/Navigation/SubNavigation/SubNavigation/SubNavigation.tsx) panel.
+     */
     children?: ReactNode;
+    /**
+     * Text or node label passed down to the trigger button and child sub-navigation header.
+     */
     label: ReactNode;
-}>;
+}
+/**
+ * Orchestrator component tying together an opening action button and its sliding
+ * [`SubNavigation`](file:///home/rohan/work/adgytec/adgytec-web-ui-components/src/components/Navigation/SubNavigation/SubNavigation/SubNavigation.tsx) panel.
+ *
+ * Configures button click handlers to slide the sub-navigation panel into view, increments the
+ * depth counter, and passes down the section label.
+ *
+ * @example
+ * ```tsx
+ * import {
+ *     SubNavigationTrigger,
+ *     NavigationButton,
+ *     SubNavigation,
+ *     NavigationLink,
+ * } from "@adgytec/web-ui-components";
+ * import { Settings } from "lucide-react";
+ *
+ * <SubNavigationTrigger stateID="settings" label="Settings">
+ *     <NavigationButton icon={Settings} />
+ *     <SubNavigation>
+ *         <NavigationLink href="/settings/profile" label="Profile" />
+ *     </SubNavigation>
+ * </SubNavigationTrigger>
+ * ```
+ */
+export declare const SubNavigationTrigger: React.FC<SubNavigationTriggerProps>;

package/dist/components/Navigation/SubNavigation/SubNavigationTrigger/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["children"],"sources":["../../../../../src/components/Navigation/SubNavigation/SubNavigationTrigger/SubNavigationTrigger.tsx"],"sourcesContent":["import type { ReactNode } from \"react\";\nimport { ButtonContext, DEFAULT_SLOT, Provider } from \"react-aria-components\";\nimport {\n    NavigationInfoContext,\n    NavLabelContext,\n    useNavigationInfo,\n} from \"../../core\";\nimport { useNavigationState } from \"../../NavigationState\";\n\nexport const SubNavigationTrigger: React.FC<{\n    stateID: string;\n    children?: ReactNode;\n    label: ReactNode;\n}> = ({ stateID, children, label }) => {\n    const parentInfo = useNavigationInfo();\n    const { openSubNavigation, closeSubNavigation, isSubNavigationOpen } =\n        useNavigationState();\n\n    const subNavID = `${parentInfo.id}--${stateID}`;\n    const depth = parentInfo.depth + 1;\n\n    return (\n        <Provider\n            values={[\n                [NavLabelContext, label],\n                [NavigationInfoContext, { id: subNavID, depth }],\n                [\n                    ButtonContext,\n                    {\n                        slots: {\n                            [DEFAULT_SLOT]: {},\n                            open: {\n                                onPress: () => {\n                                    openSubNavigation(subNavID, depth);\n                                },\n                                isPressed: isSubNavigationOpen(subNavID),\n                            },\n                            close: {\n                                onPress: () => {\n                                    closeSubNavigation(subNavID);\n                                },\n                            },\n                        },\n                    },\n                ],\n            ]}\n        >\n            {children}\n        </Provider>\n    );\n};\n"],"mappings":";;;;;;aASa,KAIR,MAAA;CAAA,IAAA,KAAA,GAAA,EAAA,EAAA,CAAA,EAAA,GAAC,EAAA,YAAA,aAAA,aAAA,GACF,IAAmB,EAAkB,GACrC,EAAA,sBAAA,uBAAA,2BACI,EAAmB,GAEvB,IAAiB,GAAG,EAAU,GAAG,IAAK,KACtC,IAAc,EAAU,QAAS,GAAE;CAAA,AAAA,EAAA,OAAA,IAKC,IAAA,EAAA,MAAxB,IAAA,CAAC,GAAiB,CAAK,GAAC,EAAA,KAAA,GAAA,EAAA,KAAA;CAAA,IAAA;CAAA,AAAA,EAAA,OAAA,KAAA,EAAA,OAAA,KACxB,IAAA,CAAC,GAAuB;EAAA,IAAM;EAAQ;CAAQ,CAAC,GAAC,EAAA,KAAA,GAAA,EAAA,KAAA,GAAA,EAAA,KAAA,KAAA,IAAA,EAAA;CAAA,IAAA;CAAA,AAAA,EAAA,OAAA,OAAA,IAAA,2BAAA,KAKpB,IAAA,CAAC,GAAC,EAAA,KAAA,KAAA,IAAA,EAAA;CAAA,IAAA;CAAA,AAAA,EAAA,OAAA,KAAA,EAAA,OAAA,KAAA,EAAA,OAAA,KAEL,UAAA;EACL,EAAkB,GAAU,CAAK;CAAC,GACrC,EAAA,KAAA,GAAA,EAAA,KAAA,GAAA,EAAA,KAAA,GAAA,EAAA,KAAA,KAAA,IAAA,EAAA;CAAA,IAAA;CAAA,AAAA,EAAA,QAAA,KAAA,EAAA,QAAA,KACU,IAAA,EAAoB,CAAQ,GAAC,EAAA,MAAA,GAAA,EAAA,MAAA,GAAA,EAAA,MAAA,KAAA,IAAA,EAAA;CAAA,IAAA;CAAA,AAAA,EAAA,QAAA,KAAA,EAAA,QAAA,KAJtC,IAAA;EAAA,SACO;EAER,WACU;CACf,GAAC,EAAA,MAAA,GAAA,EAAA,MAAA,GAAA,EAAA,MAAA,KAAA,IAAA,EAAA;CAAA,IAAA;CAAA,AAAA,EAAA,QAAA,KAAA,EAAA,QAAA,KACM,IAAA,EAAA,eACM;EACL,EAAmB,CAAQ;CAAC,EAEpC,GAAC,EAAA,MAAA,GAAA,EAAA,MAAA,GAAA,EAAA,MAAA,KAAA,IAAA,EAAA;CAAA,IAAA;CAAA,AAAA,EAAA,QAAA,KAAA,EAAA,QAAA,KAfb,IAAA,CACI,GACA,EAAA,OACW;GACF,IAAe;EAAE,MACZ;EAKL,OACM;CAKX,EACJ,CAAC,GACJ,EAAA,MAAA,GAAA,EAAA,MAAA,GAAA,EAAA,MAAA,KAAA,IAAA,EAAA;CAAA,IAAA;CAAA,AAAA,EAAA,QAAA,KAAA,EAAA,QAAA,KAAA,EAAA,QAAA,KArBG,IAAA;EACJ;EACA;EACA;CAkBC,GACJ,EAAA,MAAA,GAAA,EAAA,MAAA,GAAA,EAAA,MAAA,GAAA,EAAA,MAAA,KAAA,IAAA,EAAA;CAAA,IAAA;CAGM,OAHN,EAAA,QAAA,KAAA,EAAA,QAAA,KAvBL,IAAA,kBAAC,GAAD;EACY,QAAA;EAwBP;CAzBI,CAAA,GA0BE,EAAA,MAAA,GAAA,EAAA,MAAA,GAAA,EAAA,MAAA,KAAA,IAAA,EAAA,KA1BX;AA0BW"}
+{"version":3,"file":"index.js","names":["children","_c","require_compiler_runtime","NavigationInfoContext","useNavigationInfo","NavLabelContext","import_compiler_runtime","SubNavigationTrigger","$","t0","parentInfo","useNavigationState","subNavID","stateID","depth","t1","label","t2","t3","t4","openSubNavigation","t5","isSubNavigationOpen","t6","t7","closeSubNavigation","t8","ButtonContext","DEFAULT_SLOT","t9","t10","children","Provider"],"sources":["../../../../../src/components/Navigation/SubNavigation/SubNavigationTrigger/SubNavigationTrigger.tsx"],"sourcesContent":["import type { ReactNode } from \"react\";\nimport { ButtonContext, DEFAULT_SLOT, Provider } from \"react-aria-components\";\nimport {\n    NavigationInfoContext,\n    NavLabelContext,\n    useNavigationInfo,\n} from \"../../core\";\nimport { useNavigationState } from \"../../NavigationState\";\n\n/**\n * Props for the [`SubNavigationTrigger`](file:///home/rohan/work/adgytec/adgytec-web-ui-components/src/components/Navigation/SubNavigation/SubNavigationTrigger/SubNavigationTrigger.tsx) component.\n */\nexport interface SubNavigationTriggerProps {\n    /**\n     * Unique state key used for referencing and animating this sub-navigation level.\n     */\n    stateID: string;\n\n    /**\n     * Child elements, typically an opening trigger button and a [`SubNavigation`](file:///home/rohan/work/adgytec/adgytec-web-ui-components/src/components/Navigation/SubNavigation/SubNavigation/SubNavigation.tsx) panel.\n     */\n    children?: ReactNode;\n\n    /**\n     * Text or node label passed down to the trigger button and child sub-navigation header.\n     */\n    label: ReactNode;\n}\n\n/**\n * Orchestrator component tying together an opening action button and its sliding\n * [`SubNavigation`](file:///home/rohan/work/adgytec/adgytec-web-ui-components/src/components/Navigation/SubNavigation/SubNavigation/SubNavigation.tsx) panel.\n *\n * Configures button click handlers to slide the sub-navigation panel into view, increments the\n * depth counter, and passes down the section label.\n *\n * @example\n * ```tsx\n * import {\n *     SubNavigationTrigger,\n *     NavigationButton,\n *     SubNavigation,\n *     NavigationLink,\n * } from \"@adgytec/web-ui-components\";\n * import { Settings } from \"lucide-react\";\n *\n * <SubNavigationTrigger stateID=\"settings\" label=\"Settings\">\n *     <NavigationButton icon={Settings} />\n *     <SubNavigation>\n *         <NavigationLink href=\"/settings/profile\" label=\"Profile\" />\n *     </SubNavigation>\n * </SubNavigationTrigger>\n * ```\n */\nexport const SubNavigationTrigger: React.FC<SubNavigationTriggerProps> = ({\n    stateID,\n    children,\n    label,\n}) => {\n    const parentInfo = useNavigationInfo();\n    const { openSubNavigation, closeSubNavigation, isSubNavigationOpen } =\n        useNavigationState();\n\n    const subNavID = `${parentInfo.id}--${stateID}`;\n    const depth = parentInfo.depth + 1;\n\n    return (\n        <Provider\n            values={[\n                [NavLabelContext, label],\n                [NavigationInfoContext, { id: subNavID, depth }],\n                [\n                    ButtonContext,\n                    {\n                        slots: {\n                            [DEFAULT_SLOT]: {},\n                            open: {\n                                onPress: () => {\n                                    openSubNavigation(subNavID, depth);\n                                },\n                                isPressed: isSubNavigationOpen(subNavID),\n                            },\n                            close: {\n                                onPress: () => {\n                                    closeSubNavigation(subNavID);\n                                },\n                            },\n                        },\n                    },\n                ],\n            ]}\n        >\n            {children}\n        </Provider>\n    );\n};\n"],"mappings":";;;;;;aAsDaO,KAA4D,MAAA;CAAA,IAAAC,KAAA,GAAAP,EAAAA,EAAAA,CAAA,EAAA,GAAC,EAAA,YAAA,aAAA,aAAAQ,GAKtEC,IAAmBN,EAAkB,GACrC,EAAA,sBAAA,uBAAA,2BACIO,EAAmB,GAEvBC,IAAiB,GAAGF,EAAU,GAAG,IAAKG,KACtCC,IAAcJ,EAAU,QAAS,GAAEK;CAAA,AAAAP,EAAA,OAAAQ,IAKC,IAAAR,EAAA,MAAxB,IAAA,CAACH,GAAiBW,CAAK,GAAC,EAAA,KAAAA,GAAA,EAAA,KAAAD;CAAA,IAAAE;CAAA,AAAAT,EAAA,OAAAM,KAAAN,EAAA,OAAAI,KACxB,IAAA,CAACT,GAAuB;EAAA,IAAMS;EAAQ;CAAQ,CAAC,GAAC,EAAA,KAAAE,GAAA,EAAA,KAAAF,GAAA,EAAA,KAAAK,KAAA,IAAAT,EAAA;CAAA,IAAAU;CAAA,AAAAV,EAAA,OAAA,OAAA,IAAA,2BAAA,KAKpB,IAAA,CAAC,GAAC,EAAA,KAAAU,KAAA,IAAAV,EAAA;CAAA,IAAAW;CAAA,AAAAX,EAAA,OAAAM,KAAAN,EAAA,OAAAY,KAAAZ,EAAA,OAAAI,KAEL,UAAA;EACL,EAAkBA,GAAUE,CAAK;CAAC,GACrC,EAAA,KAAAA,GAAA,EAAA,KAAAM,GAAA,EAAA,KAAAR,GAAA,EAAA,KAAAO,KAAA,IAAAX,EAAA;CAAA,IAAAa;CAAA,AAAAb,EAAA,QAAAc,KAAAd,EAAA,QAAAI,KACU,IAAAU,EAAoBV,CAAQ,GAAC,EAAA,MAAAU,GAAA,EAAA,MAAAV,GAAA,EAAA,MAAAS,KAAA,IAAAb,EAAA;CAAA,IAAAe;CAAA,AAAAf,EAAA,QAAAW,KAAAX,EAAA,QAAAa,KAJtC,IAAA;EAAA,SACOF;EAER,WACUE;CACf,GAAC,EAAA,MAAAF,GAAA,EAAA,MAAAE,GAAA,EAAA,MAAAE,KAAA,IAAAf,EAAA;CAAA,IAAAgB;CAAA,AAAAhB,EAAA,QAAAiB,KAAAjB,EAAA,QAAAI,KACM,IAAA,EAAA,eACM;EACL,EAAmBA,CAAQ;CAAC,EAEpC,GAAC,EAAA,MAAAa,GAAA,EAAA,MAAAb,GAAA,EAAA,MAAAY,KAAA,IAAAhB,EAAA;CAAA,IAAAkB;CAAA,AAAAlB,EAAA,QAAAe,KAAAf,EAAA,QAAAgB,KAfb,IAAA,CACIG,GACA,EAAA,OACW;GACFC,IAAeV;EAAE,MACZK;EAKL,OACMC;CAKX,EACJ,CAAC,GACJ,EAAA,MAAAD,GAAA,EAAA,MAAAC,GAAA,EAAA,MAAAE,KAAA,IAAAlB,EAAA;CAAA,IAAAqB;CAAA,AAAArB,EAAA,QAAAO,KAAAP,EAAA,QAAAS,KAAAT,EAAA,QAAAkB,KArBG,IAAA;EACJX;EACAE;EACAS;CAkBC,GACJ,EAAA,MAAAX,GAAA,EAAA,MAAAE,GAAA,EAAA,MAAAS,GAAA,EAAA,MAAAG,KAAA,IAAArB,EAAA;CAAA,IAAAsB;CAGM,OAHNtB,EAAA,QAAAuB,KAAAvB,EAAA,QAAAqB,KAvBL,IAAA,kBAACG,GAAD;EACY,QAAAH;EAwBP;CAzBI,CAAA,GA0BE,EAAA,MAAAE,GAAA,EAAA,MAAAF,GAAA,EAAA,MAAAC,KAAA,IAAAtB,EAAA,KA1BXsB;AA0BW"}

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

@@ -1,3 +1,9 @@
 import { ReactNode } from 'react';
+/**
+ * Context value representing the label inherited from a parent navigation trigger.
+ */
 export type NavLabelContextType = ReactNode;
+/**
+ * React context providing the trigger label to descendant navigation items or sub-navigation panels.
+ */
 export declare const NavLabelContext: import('react').Context<ReactNode>;

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

@@ -1,3 +1,12 @@
+/**
+ * CSS class for the root navigation container layout and surface styling.
+ */
 export declare const NavigationStyles: string;
+/**
+ * CSS class for the header area of a root [`Navigation`](file:///home/rohan/work/adgytec/adgytec-web-ui-components/src/components/Navigation/Navigation/Navigation.tsx) container.
+ */
 export declare const NavigationHeaderStyles: string;
+/**
+ * CSS class for the header area of a sliding [`SubNavigation`](file:///home/rohan/work/adgytec/adgytec-web-ui-components/src/components/Navigation/SubNavigation/SubNavigation/SubNavigation.tsx) panel.
+ */
 export declare const SubNavigationHeaderStyles: string;

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

@@ -1,6 +1,25 @@
+/**
+ * Identifier and nesting depth information for the current navigation level.
+ */
 export type NavigationInfoContextType = {
+    /**
+     * Unique identifier for this navigation level/panel.
+     */
     id: string;
+    /**
+     * Current nesting hierarchy depth (root is 0, sub-navigations increment from 1).
+     */
     depth: number;
 };
+/**
+ * React context providing the current navigation level's ID and hierarchy depth.
+ */
 export declare const NavigationInfoContext: import('react').Context<NavigationInfoContextType | null>;
+/**
+ * Hook to access the current navigation level's unique ID and nesting depth.
+ *
+ * @throws If rendered outside of a [`Navigation`](file:///home/rohan/work/adgytec/adgytec-web-ui-components/src/components/Navigation/Navigation/Navigation.tsx)
+ * or [`SubNavigation`](file:///home/rohan/work/adgytec/adgytec-web-ui-components/src/components/Navigation/SubNavigation/SubNavigation/SubNavigation.tsx) component.
+ * @returns The current {@link NavigationInfoContextType}.
+ */
 export declare function useNavigationInfo(): NavigationInfoContextType;