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

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":";;;;;;;;A,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;C,IAoBE,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`](src/components/Navigation/NavigationItem/NavigationLink/NavigationLink.tsx) component.
+ *
+ * Extends React Aria's `Link` properties and [`NavigationItemProps`](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/index.js

@@ -1,2 +1 @@
-import { n as e, t } from "../../../../chunks/core9";
-export { t as NavigationItemLabelTypography, e as NavigationItemStyles };
+export { t as NavigationItemLabelTypography, n as NavigationItemStyles } from "../../../../chunks/core9";

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`](src/components/Navigation/NavigationItem/NavigationLink/NavigationLink.tsx)
+ * and [`NavigationButton`](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`](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`](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/NavigationScrollContainer/index.js

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

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

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

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`](src/components/Navigation/NavigationSection/NavigationSectionLabel/NavigationSectionLabel.tsx) component.
+ */
+export interface NavigationSectionLabelProps extends React.ComponentPropsWithRef<typeof Heading> {
+}
+/**
+ * Styled title heading for a [`NavigationSection`](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/NavigationSection/NavigationSectionLabel/index.js

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

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`](src/components/Navigation/NavigationState/NavigationState.tsx) component.
+ */
+export interface NavigationStateProps {
+    /**
+     * Child elements, typically one or more [`Navigation`](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`](src/components/Navigation/NavigationState/NavigationState.tsx)
+ * or [`Navigation`](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

@@ -1,15 +1,14 @@
 import { t as e } from "../../../chunks/compiler-runtime";
 import { createContext as t, useContext as n, useRef as r, useState as i } from "react";
 import { jsx as a } from "react/jsx-runtime";
-//#region src/components/Navigation/NavigationState/context.ts
+// src/components/Navigation/NavigationState/context.ts
 var o = t(null);
 function s() {
 	let e = n(o);
 	if (e === null) throw Error("Missing navigation state. Ensure this component is rendered within Navigation component.");
 	return e;
 }
-//#endregion
-//#region src/components/Navigation/NavigationState/NavigationState.tsx
+// src/components/Navigation/NavigationState/NavigationState.tsx
 var c = e(), l = (e) => {
 	let t = (0, c.c)(18), { children: n } = e, s;
 	t[0] === Symbol.for("react.memo_cache_sentinel") ? (s = [], t[0] = s) : s = t[0];
@@ -55,7 +54,6 @@ var c = e(), l = (e) => {
 		children: n
 	}), t[15] = n, t[16] = T, t[17] = E) : E = t[17], E;
 };
-//#endregion
 export { l as NavigationState, o as NavigationStateContext, s as useNavigationState };
 
 //# sourceMappingURL=index.js.map

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`](src/components/Navigation/NavigationState/NavigationState.tsx)\n * or [`Navigation`](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`](src/components/Navigation/NavigationState/NavigationState.tsx) component.\n */\nexport interface NavigationStateProps {\n    /**\n     * Child elements, typically one or more [`Navigation`](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`](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`](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

@@ -14,7 +14,7 @@ import { ArrowLeft as _ } from "lucide-react";
 import { FocusScope as v, useObjectRef as y } from "react-aria";
 import { Transition as b } from "react-transition-group";
 import { createPortal as x } from "react-dom";
-//#region src/components/Navigation/SubNavigation/SubNavigation/SubNavigation.tsx
+// src/components/Navigation/SubNavigation/SubNavigation/SubNavigation.tsx
 var S = e(), C = (e) => {
 	let C = (0, S.c)(30), w, T, E, D, O, k, A;
 	C[0] === e ? (w = C[1], T = C[2], E = C[3], D = C[4], O = C[5], k = C[6], A = C[7]) : ({className: T, label: D, children: w, inert: E, ref: k, style: A, ...O} = e, C[0] = e, C[1] = w, C[2] = T, C[3] = E, C[4] = D, C[5] = O, C[6] = k, C[7] = A);
@@ -70,7 +70,6 @@ var S = e(), C = (e) => {
 	let W;
 	return C[27] !== L || C[28] !== U ? (W = x(U, L), C[27] = L, C[28] = U, C[29] = W) : W = C[29], W;
 };
-//#endregion
 export { C as SubNavigation };
 
 //# sourceMappingURL=index.js.map

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`](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`](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":";;;;;;;;;;;;;;;;;A,aAwDac,KAA8C,MAAA;CAAA,IAAAC,KAAA,GAAAV,EAAAA,EAAAA,CAAA,EAAA,GAAAW,GAAAC,GAAAC,GAAAC,GAAAC,GAAAC,GAAAC;CAAA,AAAAP,EAAA,OAAAQ,KAQ1D,IAAAR,EAAA,IAAA,IAAAA,EAAA,IAAA,IAAAA,EAAA,IAAA,IAAAA,EAAA,IAAA,IAAAA,EAAA,IAAA,IAAAA,EAAA,IAAA,IAAAA,EAAA,OAR2D,kEAAA,GAAAK,KAAAG,GAQ3D,EAAA,KAAAA,GAAA,EAAA,KAAAP,GAAA,EAAA,KAAAC,GAAA,EAAA,KAAAC,GAAA,EAAA,KAAAC,GAAA,EAAA,KAAAC,GAAA,EAAA,KAAAC,GAAA,EAAA,KAAAC;CACG,IAAAE,IAAkBC,EAAaJ,CAAG,GAElCK,IAAkBC,EAAY,GAE9B,EAAA,OAAA,aAAsBlB,EAAkB,GACxC,EAAA,YAAA,2BAAyCmB,EAAmB,GAC5D,EAAA,iBAAsBjB,EAAuB,GAE7CkB,IAAqBC,EAAWpB,CAAe,GAC/CqB,IAAoBZ,KAAAU;CAEpB,IAAIG,MAAc,MAAI,OAAS;CAAK,IAAAC;CAAA,AAAAlB,EAAA,OAAA,OAAA,IAAA,2BAAA,KAKnB,IAAA;EAAA,OACE;EAAC,MACF;CACV,GAAC,EAAA,KAAAkB,KAAA,IAAAlB,EAAA;CAAA,IAAAmB;CAAA,AAAAnB,EAAA,OAAAoB,KAAApB,EAAA,QAAAqB,KACG,IAAAA,EAAoBD,CAAE,GAAC,EAAA,KAAAA,GAAA,EAAA,MAAAC,GAAA,EAAA,MAAAF,KAAA,IAAAnB,EAAA;CAAA,IAAAsB;CAAA,AAAAtB,EAAA,QAAAC,KAAAD,EAAA,QAAAE,KAAAF,EAAA,QAAAuB,KAAAvB,EAAA,QAAAgB,KAAAhB,EAAA,QAAAG,KAAAH,EAAA,QAAAW,KAAAX,EAAA,QAAAwB,KAAAxB,EAAA,QAAAK,KAAAL,EAAA,QAAAO,KAAAP,EAAA,QAAAS,KAI1B,KAAA,MACG,kBAACgB,GAAD;EAAY,cAAA;EACR,UAAA,kBAAA,OAAA;GACSxC,KAAAwB;GACM,WAAAlB,EAAKmC,GAAkBxB,CAAS;GAAC,GACxCG;GACG,OAAA;IAAA,GACAE;IAAK,QACAgB,IAAQ;GACpB;GACO,OAAApB,KAASqB,EAAQD,CAAK;GAChB,eAAA;GACArC,eAAAyC;GACC,gBAAA;GACF,cAAAhB,KAAA,KAAA;GAZhB,UAAA,CAcI,kBAACiB,GAAD;IAAmB,WAAArC,EAAKsC,CAAyB;IAAjD,UAAA,CACI,kBAACC,GAAD;KACU3C,MAAA4C;KACA,OAAA;KACD,MAAA;KACL,qBAAA;IAAiB,CAAA,GAGpBf,KACG,kBAACgB,GAAD;KACe,WAAAzC,EAAKE,EAAU,UAAW;KACrC,gBAAA;KAEC,UAAAuB;IAJG,CAAA,CATT;GAkBP,CAAA,GAAA,kBAACiB,GAAD,EACK,YADqB,CAAA,CAGxB;;CApCC,CAAA,GAsCd,EAAA,MAAAhC,GAAA,EAAA,MAAAC,GAAA,EAAA,MAAAqB,GAAA,EAAA,MAAAP,GAAA,EAAA,MAAAb,GAAA,EAAA,MAAAQ,GAAA,EAAA,MAAAa,GAAA,EAAA,MAAAnB,GAAA,EAAA,MAAAE,GAAA,EAAA,MAAAE,GAAA,EAAA,MAAAa,KAAA,IAAAtB,EAAA;CAAA,IAAAkC;CAAA,AAAAlC,EAAA,QAAAS,KAAAT,EAAA,QAAAmB,KAAAnB,EAAA,QAAAsB,KAjDL,IAAA,kBAACa,GAAD;EACalD,SAAAwB;EACA,SAAAS;EAIL,IAAAC;EACJ,cAAA;EACA,eAAA;EAEC,UAAAG;CAVM,CAAA,GAkDE,EAAA,MAAAb,GAAA,EAAA,MAAAU,GAAA,EAAA,MAAAG,GAAA,EAAA,MAAAY,KAAA,IAAAlC,EAAA;CAAA,IAAAoC;CAEhB,OAFgBpC,EAAA,QAAAiB,KAAAjB,EAAA,QAAAkC,KAnDV,IAAAG,EACHH,GAmDAjB,CACJ,GAAC,EAAA,MAAAA,GAAA,EAAA,MAAAiB,GAAA,EAAA,MAAAE,KAAA,IAAApC,EAAA,KArDMoC;AAqDN"}

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`](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`](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`](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

@@ -3,7 +3,7 @@ import { n as t, r as n, t as r } from "../../../../chunks/core8";
 import { useNavigationState as i } from "../../NavigationState/index.js";
 import { jsx as a } from "react/jsx-runtime";
 import { ButtonContext as o, DEFAULT_SLOT as s, Provider as c } from "react-aria-components";
-//#region src/components/Navigation/SubNavigation/SubNavigationTrigger/SubNavigationTrigger.tsx
+// src/components/Navigation/SubNavigation/SubNavigationTrigger/SubNavigationTrigger.tsx
 var l = e(), u = (e) => {
 	let u = (0, l.c)(29), { stateID: d, children: f, label: p } = e, m = n(), { openSubNavigation: h, closeSubNavigation: g, isSubNavigationOpen: _ } = i(), v = `${m.id}--${d}`, y = m.depth + 1, b;
 	u[0] === p ? b = u[1] : (b = [r, p], u[0] = p, u[1] = b);
@@ -47,7 +47,6 @@ var l = e(), u = (e) => {
 		children: f
 	}), u[26] = f, u[27] = O, u[28] = k) : k = u[28], k;
 };
-//#endregion
 export { u as SubNavigationTrigger };
 
 //# sourceMappingURL=index.js.map

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

@@ -1,2 +1 @@
-import { a as e, i as t, n, o as r, r as i, t as a } from "../../../chunks/core8";
-export { a as NavLabelContext, t as NavigationHeaderStyles, n as NavigationInfoContext, e as NavigationStyles, r as SubNavigationHeaderStyles, i as useNavigationInfo };
+export { t as NavLabelContext, i as NavigationHeaderStyles, n as NavigationInfoContext, a as NavigationStyles, o as SubNavigationHeaderStyles, r as useNavigationInfo } from "../../../chunks/core8";

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`](src/components/Navigation/Navigation/Navigation.tsx) container.
+ */
 export declare const NavigationHeaderStyles: string;
+/**
+ * CSS class for the header area of a sliding [`SubNavigation`](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`](src/components/Navigation/Navigation/Navigation.tsx)
+ * or [`SubNavigation`](src/components/Navigation/SubNavigation/SubNavigation/SubNavigation.tsx) component.
+ * @returns The current {@link NavigationInfoContextType}.
+ */
 export declare function useNavigationInfo(): NavigationInfoContextType;

package/dist/components/Popover/Popover.d.ts

@@ -1,2 +1,35 @@
 import { Popover as AriaPopover } from 'react-aria-components';
-export declare const Popover: React.FC<React.ComponentPropsWithRef<typeof AriaPopover>>;
+/**
+ * Props for the [`Popover`](src/components/Popover/Popover.tsx) component.
+ *
+ * Extends all properties from React Aria's `Popover`, including positioning (`placement`, `offset`, `crossOffset`),
+ * portal containers, and entry/exit transition states.
+ */
+export interface PopoverProps extends React.ComponentPropsWithRef<typeof AriaPopover> {
+}
+/**
+ * Overlay surface container that presents content anchored to a trigger element.
+ *
+ * Built on React Aria's `Popover` with Material Design 3 surface colors, shadow elevation,
+ * and built-in entry/exit animations responsive to placement directions.
+ *
+ * @example
+ * ```tsx
+ * import {
+ *     Popover,
+ *     Button,
+ *     DialogTrigger,
+ *     Dialog,
+ * } from "@adgytec/web-ui-components";
+ *
+ * <DialogTrigger>
+ *     <Button label="Open Popover" />
+ *     <Popover>
+ *         <Dialog>
+ *             <p>This is the content inside the popover.</p>
+ *         </Dialog>
+ *     </Popover>
+ * </DialogTrigger>
+ * ```
+ */
+export declare const Popover: React.FC<PopoverProps>;