@accelint/design-toolkit 9.3.0 → 9.4.0

package/dist/components/sidenav/content.d.ts

@@ -12,19 +12,40 @@
 
 import { SidenavContentProps } from "./types.js";
 import "client-only";
-import * as react_jsx_runtime140 from "react/jsx-runtime";
+import * as react_jsx_runtime142 from "react/jsx-runtime";
 
 //#region src/components/sidenav/content.d.ts
+
 /**
  * SidenavContent - Container for sidenav content
  *
  * Provides a container for sidenav content with proper styling
+ *
+ * @example
+ * ```tsx
+ * <Sidenav>
+ *   <SidenavContent>
+ *     <SidenavItem textValue="Dashboard">
+ *       <Icon><Home /></Icon>
+ *       <Text>Dashboard</Text>
+ *     </SidenavItem>
+ *     <SidenavMenu icon={<Settings />} title="Settings">
+ *       <SidenavMenuItem>Profile</SidenavMenuItem>
+ *     </SidenavMenu>
+ *   </SidenavContent>
+ * </Sidenav>
+ * ```
+ *
+ * @param props - {@link SidenavContentProps}
+ * @param props.className - CSS class for the content container.
+ * @param props.children - Content items (items, menus, dividers).
+ * @returns The rendered SidenavContent component.
  */
 declare function SidenavContent({
   className,
   children,
   ...rest
-}: SidenavContentProps): react_jsx_runtime140.JSX.Element;
+}: SidenavContentProps): react_jsx_runtime142.JSX.Element;
 //#endregion
 export { SidenavContent };
 //# sourceMappingURL=content.d.ts.map

package/dist/components/sidenav/content.js

@@ -25,6 +25,26 @@ import styles from "./styles.module.css";
 * SidenavContent - Container for sidenav content
 *
 * Provides a container for sidenav content with proper styling
+*
+* @example
+* ```tsx
+* <Sidenav>
+*   <SidenavContent>
+*     <SidenavItem textValue="Dashboard">
+*       <Icon><Home /></Icon>
+*       <Text>Dashboard</Text>
+*     </SidenavItem>
+*     <SidenavMenu icon={<Settings />} title="Settings">
+*       <SidenavMenuItem>Profile</SidenavMenuItem>
+*     </SidenavMenu>
+*   </SidenavContent>
+* </Sidenav>
+* ```
+*
+* @param props - {@link SidenavContentProps}
+* @param props.className - CSS class for the content container.
+* @param props.children - Content items (items, menus, dividers).
+* @returns The rendered SidenavContent component.
 */
 function SidenavContent({ className, children, ...rest }) {
 	return /* @__PURE__ */ jsx(Provider, {

package/dist/components/sidenav/content.js.map

@@ -1 +1 @@
-{"version":3,"file":"content.js","names":[],"sources":["../../../src/components/sidenav/content.tsx"],"sourcesContent":["/*\n * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n'use client';\n\nimport 'client-only';\nimport { clsx } from '@accelint/design-foundation/lib/utils';\nimport { Provider } from 'react-aria-components';\nimport { DividerContext } from '../divider/context';\nimport styles from './styles.module.css';\nimport type { SidenavContentProps } from './types';\n\n/**\n * SidenavContent - Container for sidenav content\n *\n * Provides a container for sidenav content with proper styling\n */\nexport function SidenavContent({\n  className,\n  children,\n  ...rest\n}: SidenavContentProps) {\n  return (\n    <Provider values={[[DividerContext, { className: styles.divider }]]}>\n      <div {...rest} className={clsx(styles.content, className)}>\n        {children}\n      </div>\n    </Provider>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAyBA,SAAgB,eAAe,EAC7B,WACA,UACA,GAAG,QACmB;AACtB,QACE,oBAAC;EAAS,QAAQ,CAAC,CAAC,gBAAgB,EAAE,WAAW,OAAO,SAAS,CAAC,CAAC;YACjE,oBAAC;GAAI,GAAI;GAAM,WAAW,KAAK,OAAO,SAAS,UAAU;GACtD;IACG;GACG"}
+{"version":3,"file":"content.js","names":[],"sources":["../../../src/components/sidenav/content.tsx"],"sourcesContent":["/*\n * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n'use client';\n\nimport 'client-only';\nimport { clsx } from '@accelint/design-foundation/lib/utils';\nimport { Provider } from 'react-aria-components';\nimport { DividerContext } from '../divider/context';\nimport styles from './styles.module.css';\nimport type { SidenavContentProps } from './types';\n\n/**\n * SidenavContent - Container for sidenav content\n *\n * Provides a container for sidenav content with proper styling\n *\n * @example\n * ```tsx\n * <Sidenav>\n *   <SidenavContent>\n *     <SidenavItem textValue=\"Dashboard\">\n *       <Icon><Home /></Icon>\n *       <Text>Dashboard</Text>\n *     </SidenavItem>\n *     <SidenavMenu icon={<Settings />} title=\"Settings\">\n *       <SidenavMenuItem>Profile</SidenavMenuItem>\n *     </SidenavMenu>\n *   </SidenavContent>\n * </Sidenav>\n * ```\n *\n * @param props - {@link SidenavContentProps}\n * @param props.className - CSS class for the content container.\n * @param props.children - Content items (items, menus, dividers).\n * @returns The rendered SidenavContent component.\n */\nexport function SidenavContent({\n  className,\n  children,\n  ...rest\n}: SidenavContentProps) {\n  return (\n    <Provider values={[[DividerContext, { className: styles.divider }]]}>\n      <div {...rest} className={clsx(styles.content, className)}>\n        {children}\n      </div>\n    </Provider>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6CA,SAAgB,eAAe,EAC7B,WACA,UACA,GAAG,QACmB;AACtB,QACE,oBAAC;EAAS,QAAQ,CAAC,CAAC,gBAAgB,EAAE,WAAW,OAAO,SAAS,CAAC,CAAC;YACjE,oBAAC;GAAI,GAAI;GAAM,WAAW,KAAK,OAAO,SAAS,UAAU;GACtD;IACG;GACG"}

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

@@ -12,10 +12,11 @@
 
 import { SidenavContextValue } from "./types.js";
 import "client-only";
-import * as react39 from "react";
+import * as react46 from "react";
 
 //#region src/components/sidenav/context.d.ts
-declare const SidenavContext: react39.Context<SidenavContextValue>;
+/** Context for sidenav state and identification */
+declare const SidenavContext: react46.Context<SidenavContextValue>;
 //#endregion
 export { SidenavContext };
 //# sourceMappingURL=context.d.ts.map

package/dist/components/sidenav/context.js

@@ -18,6 +18,7 @@ import { createContext } from "react";
 import { uuid } from "@accelint/core";
 
 //#region src/components/sidenav/context.ts
+/** Context for sidenav state and identification */
 const SidenavContext = createContext({
 	id: uuid(),
 	isOpen: false

package/dist/components/sidenav/context.js.map

@@ -1 +1 @@
-{"version":3,"file":"context.js","names":[],"sources":["../../../src/components/sidenav/context.ts"],"sourcesContent":["/*\n * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\n'use client';\n\nimport { uuid } from '@accelint/core';\nimport 'client-only';\nimport { createContext } from 'react';\nimport type { SidenavContextValue } from './types';\n\nexport const SidenavContext = createContext<SidenavContextValue>({\n  id: uuid(),\n  isOpen: false,\n});\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAmBA,MAAa,iBAAiB,cAAmC;CAC/D,IAAI,MAAM;CACV,QAAQ;CACT,CAAC"}
+{"version":3,"file":"context.js","names":[],"sources":["../../../src/components/sidenav/context.ts"],"sourcesContent":["/*\n * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\n'use client';\n\nimport { uuid } from '@accelint/core';\nimport 'client-only';\nimport { createContext } from 'react';\nimport type { SidenavContextValue } from './types';\n\n/** Context for sidenav state and identification */\nexport const SidenavContext = createContext<SidenavContextValue>({\n  id: uuid(),\n  isOpen: false,\n});\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAoBA,MAAa,iBAAiB,cAAmC;CAC/D,IAAI,MAAM;CACV,QAAQ;CACT,CAAC"}

package/dist/components/sidenav/events.d.ts

@@ -1,5 +1,7 @@
 //#region src/components/sidenav/events.d.ts
+/** Namespace for sidenav bus events. */
 declare const SidenavEventNamespace = "Sidenav";
+/** Event types for sidenav toggle, open, and close actions. */
 declare const SidenavEventTypes: {
   readonly toggle: "Sidenav:toggle";
   readonly open: "Sidenav:open";

package/dist/components/sidenav/events.js

@@ -12,7 +12,9 @@
 
 
 //#region src/components/sidenav/events.ts
+/** Namespace for sidenav bus events. */
 const SidenavEventNamespace = "Sidenav";
+/** Event types for sidenav toggle, open, and close actions. */
 const SidenavEventTypes = {
 	toggle: `${SidenavEventNamespace}:toggle`,
 	open: `${SidenavEventNamespace}:open`,

package/dist/components/sidenav/events.js.map

@@ -1 +1 @@
-{"version":3,"file":"events.js","names":[],"sources":["../../../src/components/sidenav/events.ts"],"sourcesContent":["/*\n * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\nexport const SidenavEventNamespace = 'Sidenav';\n\nexport const SidenavEventTypes = {\n  toggle: `${SidenavEventNamespace}:toggle`,\n  open: `${SidenavEventNamespace}:open`,\n  close: `${SidenavEventNamespace}:close`,\n} as const;\n"],"mappings":";;;;;;;;;;;;;;AAYA,MAAa,wBAAwB;AAErC,MAAa,oBAAoB;CAC/B,QAAQ,GAAG,sBAAsB;CACjC,MAAM,GAAG,sBAAsB;CAC/B,OAAO,GAAG,sBAAsB;CACjC"}
+{"version":3,"file":"events.js","names":[],"sources":["../../../src/components/sidenav/events.ts"],"sourcesContent":["/*\n * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\n/** Namespace for sidenav bus events. */\nexport const SidenavEventNamespace = 'Sidenav';\n\n/** Event types for sidenav toggle, open, and close actions. */\nexport const SidenavEventTypes = {\n  toggle: `${SidenavEventNamespace}:toggle`,\n  open: `${SidenavEventNamespace}:open`,\n  close: `${SidenavEventNamespace}:close`,\n} as const;\n"],"mappings":";;;;;;;;;;;;;;;AAaA,MAAa,wBAAwB;;AAGrC,MAAa,oBAAoB;CAC/B,QAAQ,GAAG,sBAAsB;CACjC,MAAM,GAAG,sBAAsB;CAC/B,OAAO,GAAG,sBAAsB;CACjC"}

package/dist/components/sidenav/footer.d.ts

@@ -11,15 +11,29 @@
  */
 
 import { SidenavFooterProps } from "./types.js";
-import * as react_jsx_runtime141 from "react/jsx-runtime";
+import * as react_jsx_runtime184 from "react/jsx-runtime";
 
 //#region src/components/sidenav/footer.d.ts
+
 /**
  * SidenavFooter - Footer component for sidenav
  *
  * Provides a footer container for the sidenav
+ *
+ * @example
+ * ```tsx
+ * <Sidenav>
+ *   <SidenavContent>...</SidenavContent>
+ *   <SidenavFooter>
+ *     <Button>Logout</Button>
+ *   </SidenavFooter>
+ * </Sidenav>
+ * ```
+ *
+ * @param props - {@link SidenavFooterProps}
+ * @returns The rendered SidenavFooter component.
  */
-declare function SidenavFooter(props: SidenavFooterProps): react_jsx_runtime141.JSX.Element;
+declare function SidenavFooter(props: SidenavFooterProps): react_jsx_runtime184.JSX.Element;
 //#endregion
 export { SidenavFooter };
 //# sourceMappingURL=footer.d.ts.map

package/dist/components/sidenav/footer.js

@@ -18,6 +18,19 @@ import { jsx } from "react/jsx-runtime";
 * SidenavFooter - Footer component for sidenav
 *
 * Provides a footer container for the sidenav
+*
+* @example
+* ```tsx
+* <Sidenav>
+*   <SidenavContent>...</SidenavContent>
+*   <SidenavFooter>
+*     <Button>Logout</Button>
+*   </SidenavFooter>
+* </Sidenav>
+* ```
+*
+* @param props - {@link SidenavFooterProps}
+* @returns The rendered SidenavFooter component.
 */
 function SidenavFooter(props) {
 	return /* @__PURE__ */ jsx("footer", { ...props });

package/dist/components/sidenav/footer.js.map

@@ -1 +1 @@
-{"version":3,"file":"footer.js","names":[],"sources":["../../../src/components/sidenav/footer.tsx"],"sourcesContent":["/*\n * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\nimport type { SidenavFooterProps } from './types';\n\n/**\n * SidenavFooter - Footer component for sidenav\n *\n * Provides a footer container for the sidenav\n */\nexport function SidenavFooter(props: SidenavFooterProps) {\n  return <footer {...props} />;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAkBA,SAAgB,cAAc,OAA2B;AACvD,QAAO,oBAAC,YAAO,GAAI,QAAS"}
+{"version":3,"file":"footer.js","names":[],"sources":["../../../src/components/sidenav/footer.tsx"],"sourcesContent":["/*\n * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\nimport type { SidenavFooterProps } from './types';\n\n/**\n * SidenavFooter - Footer component for sidenav\n *\n * Provides a footer container for the sidenav\n *\n * @example\n * ```tsx\n * <Sidenav>\n *   <SidenavContent>...</SidenavContent>\n *   <SidenavFooter>\n *     <Button>Logout</Button>\n *   </SidenavFooter>\n * </Sidenav>\n * ```\n *\n * @param props - {@link SidenavFooterProps}\n * @returns The rendered SidenavFooter component.\n */\nexport function SidenavFooter(props: SidenavFooterProps) {\n  return <footer {...props} />;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA+BA,SAAgB,cAAc,OAA2B;AACvD,QAAO,oBAAC,YAAO,GAAI,QAAS"}

package/dist/components/sidenav/header.d.ts

@@ -12,19 +12,37 @@
 
 import { SidenavHeaderProps } from "./types.js";
 import "client-only";
-import * as react_jsx_runtime142 from "react/jsx-runtime";
+import * as react_jsx_runtime185 from "react/jsx-runtime";
 
 //#region src/components/sidenav/header.d.ts
+
 /**
  * SidenavHeader - Header component for sidenav
  *
  * Provides a header with toggle button for the sidenav
+ *
+ * @example
+ * ```tsx
+ * <Sidenav>
+ *   <SidenavHeader>
+ *     <SidenavAvatar>
+ *       <Avatar>JD</Avatar>
+ *       <Heading>John Doe</Heading>
+ *     </SidenavAvatar>
+ *   </SidenavHeader>
+ * </Sidenav>
+ * ```
+ *
+ * @param props - {@link SidenavHeaderProps}
+ * @param props.children - Header content (typically SidenavAvatar).
+ * @param props.classNames - Custom CSS class names for header elements.
+ * @returns The rendered SidenavHeader component.
  */
 declare function SidenavHeader({
   children,
   classNames,
   ...rest
-}: SidenavHeaderProps): react_jsx_runtime142.JSX.Element;
+}: SidenavHeaderProps): react_jsx_runtime185.JSX.Element;
 //#endregion
 export { SidenavHeader };
 //# sourceMappingURL=header.d.ts.map

package/dist/components/sidenav/header.js

@@ -21,7 +21,7 @@ import { useContext } from "react";
 import { clsx } from "@accelint/design-foundation/lib/utils";
 import { Button, Header, composeRenderProps } from "react-aria-components";
 import { jsx, jsxs } from "react/jsx-runtime";
-import { ChevronLeft } from "@accelint/icons";
+import ChevronLeft from "@accelint/icons/chevron-left";
 import { useEmit } from "@accelint/bus/react";
 import styles from "./styles.module.css";
 
@@ -30,6 +30,23 @@ import styles from "./styles.module.css";
 * SidenavHeader - Header component for sidenav
 *
 * Provides a header with toggle button for the sidenav
+*
+* @example
+* ```tsx
+* <Sidenav>
+*   <SidenavHeader>
+*     <SidenavAvatar>
+*       <Avatar>JD</Avatar>
+*       <Heading>John Doe</Heading>
+*     </SidenavAvatar>
+*   </SidenavHeader>
+* </Sidenav>
+* ```
+*
+* @param props - {@link SidenavHeaderProps}
+* @param props.children - Header content (typically SidenavAvatar).
+* @param props.classNames - Custom CSS class names for header elements.
+* @returns The rendered SidenavHeader component.
 */
 function SidenavHeader({ children, classNames, ...rest }) {
 	const emit = useEmit(SidenavEventTypes.toggle);

package/dist/components/sidenav/header.js.map

@@ -1 +1 @@
-{"version":3,"file":"header.js","names":[],"sources":["../../../src/components/sidenav/header.tsx"],"sourcesContent":["/*\n * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n'use client';\n\nimport 'client-only';\nimport { useEmit } from '@accelint/bus/react';\nimport { clsx } from '@accelint/design-foundation/lib/utils';\nimport { ChevronLeft } from '@accelint/icons';\nimport { useContext } from 'react';\nimport { Button, composeRenderProps, Header } from 'react-aria-components';\nimport { Icon } from '../icon';\nimport { SidenavContext } from './context';\nimport { SidenavEventTypes } from './events';\nimport styles from './styles.module.css';\nimport type { SidenavHeaderProps, SidenavToggleEvent } from './types';\n\n/**\n * SidenavHeader - Header component for sidenav\n *\n * Provides a header with toggle button for the sidenav\n */\nexport function SidenavHeader({\n  children,\n  classNames,\n  ...rest\n}: SidenavHeaderProps) {\n  const emit = useEmit<SidenavToggleEvent>(SidenavEventTypes.toggle);\n  const { id } = useContext(SidenavContext);\n\n  return (\n    <Header {...rest} className={clsx(styles.header, classNames?.header)}>\n      <Button\n        className={composeRenderProps(classNames?.button, (className) =>\n          clsx(styles.toggle, className),\n        )}\n        onPress={() => emit({ id })}\n      >\n        {children}\n        <Icon className={styles.transient}>\n          <ChevronLeft />\n        </Icon>\n      </Button>\n    </Header>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA8BA,SAAgB,cAAc,EAC5B,UACA,YACA,GAAG,QACkB;CACrB,MAAM,OAAO,QAA4B,kBAAkB,OAAO;CAClE,MAAM,EAAE,OAAO,WAAW,eAAe;AAEzC,QACE,oBAAC;EAAO,GAAI;EAAM,WAAW,KAAK,OAAO,QAAQ,YAAY,OAAO;YAClE,qBAAC;GACC,WAAW,mBAAmB,YAAY,SAAS,cACjD,KAAK,OAAO,QAAQ,UAAU,CAC/B;GACD,eAAe,KAAK,EAAE,IAAI,CAAC;cAE1B,UACD,oBAAC;IAAK,WAAW,OAAO;cACtB,oBAAC,gBAAc;KACV;IACA;GACF"}
+{"version":3,"file":"header.js","names":[],"sources":["../../../src/components/sidenav/header.tsx"],"sourcesContent":["/*\n * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n'use client';\n\nimport 'client-only';\nimport { useEmit } from '@accelint/bus/react';\nimport { clsx } from '@accelint/design-foundation/lib/utils';\nimport ChevronLeft from '@accelint/icons/chevron-left';\nimport { useContext } from 'react';\nimport { Button, composeRenderProps, Header } from 'react-aria-components';\nimport { Icon } from '../icon';\nimport { SidenavContext } from './context';\nimport { SidenavEventTypes } from './events';\nimport styles from './styles.module.css';\nimport type { SidenavHeaderProps, SidenavToggleEvent } from './types';\n\n/**\n * SidenavHeader - Header component for sidenav\n *\n * Provides a header with toggle button for the sidenav\n *\n * @example\n * ```tsx\n * <Sidenav>\n *   <SidenavHeader>\n *     <SidenavAvatar>\n *       <Avatar>JD</Avatar>\n *       <Heading>John Doe</Heading>\n *     </SidenavAvatar>\n *   </SidenavHeader>\n * </Sidenav>\n * ```\n *\n * @param props - {@link SidenavHeaderProps}\n * @param props.children - Header content (typically SidenavAvatar).\n * @param props.classNames - Custom CSS class names for header elements.\n * @returns The rendered SidenavHeader component.\n */\nexport function SidenavHeader({\n  children,\n  classNames,\n  ...rest\n}: SidenavHeaderProps) {\n  const emit = useEmit<SidenavToggleEvent>(SidenavEventTypes.toggle);\n  const { id } = useContext(SidenavContext);\n\n  return (\n    <Header {...rest} className={clsx(styles.header, classNames?.header)}>\n      <Button\n        className={composeRenderProps(classNames?.button, (className) =>\n          clsx(styles.toggle, className),\n        )}\n        onPress={() => emit({ id })}\n      >\n        {children}\n        <Icon className={styles.transient}>\n          <ChevronLeft />\n        </Icon>\n      </Button>\n    </Header>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA+CA,SAAgB,cAAc,EAC5B,UACA,YACA,GAAG,QACkB;CACrB,MAAM,OAAO,QAA4B,kBAAkB,OAAO;CAClE,MAAM,EAAE,OAAO,WAAW,eAAe;AAEzC,QACE,oBAAC;EAAO,GAAI;EAAM,WAAW,KAAK,OAAO,QAAQ,YAAY,OAAO;YAClE,qBAAC;GACC,WAAW,mBAAmB,YAAY,SAAS,cACjD,KAAK,OAAO,QAAQ,UAAU,CAC/B;GACD,eAAe,KAAK,EAAE,IAAI,CAAC;cAE1B,UACD,oBAAC;IAAK,WAAW,OAAO;cACtB,oBAAC,gBAAc;KACV;IACA;GACF"}

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

@@ -12,7 +12,7 @@
 
 import { SidenavProps } from "./types.js";
 import "client-only";
-import * as react_jsx_runtime143 from "react/jsx-runtime";
+import * as react_jsx_runtime133 from "react/jsx-runtime";
 
 //#region src/components/sidenav/index.d.ts
 
@@ -22,7 +22,15 @@ import * as react_jsx_runtime143 from "react/jsx-runtime";
  * Provides a hierarchical collapsible side navigation intended to be used
  * inside a DrawerLayout. Supports headers, avatars, nested menus, and items.
  *
+ * @param props - {@link SidenavProps}
+ * @param props.id - Unique identifier for the sidenav.
+ * @param props.className - CSS class for the nav element.
+ * @param props.isHiddenWhenClosed - Whether to hide the sidenav when closed.
+ * @param props.children - Sidenav content (header, content, footer).
+ * @returns The rendered Sidenav component.
+ *
  * @example
+ * ```tsx
  * <DrawerLayout push="left">
  *   <DrawerLayoutMain className="col-start-2">
  *     <SidenavTrigger>
@@ -71,6 +79,7 @@ import * as react_jsx_runtime143 from "react/jsx-runtime";
  *     </SidenavFooter>
  *   </Sidenav>
  * </DrawerLayout>
+ * ```
  */
 declare function Sidenav({
   id,
@@ -78,7 +87,7 @@ declare function Sidenav({
   isHiddenWhenClosed,
   children,
   ...rest
-}: SidenavProps): react_jsx_runtime143.JSX.Element | null;
+}: SidenavProps): react_jsx_runtime133.JSX.Element | null;
 //#endregion
 export { Sidenav };
 //# sourceMappingURL=index.d.ts.map

package/dist/components/sidenav/index.js

@@ -30,7 +30,15 @@ import styles from "./styles.module.css";
 * Provides a hierarchical collapsible side navigation intended to be used
 * inside a DrawerLayout. Supports headers, avatars, nested menus, and items.
 *
+* @param props - {@link SidenavProps}
+* @param props.id - Unique identifier for the sidenav.
+* @param props.className - CSS class for the nav element.
+* @param props.isHiddenWhenClosed - Whether to hide the sidenav when closed.
+* @param props.children - Sidenav content (header, content, footer).
+* @returns The rendered Sidenav component.
+*
 * @example
+* ```tsx
 * <DrawerLayout push="left">
 *   <DrawerLayoutMain className="col-start-2">
 *     <SidenavTrigger>
@@ -79,6 +87,7 @@ import styles from "./styles.module.css";
 *     </SidenavFooter>
 *   </Sidenav>
 * </DrawerLayout>
+* ```
 */
 function Sidenav({ id, className, isHiddenWhenClosed, children, ...rest }) {
 	const [isOpen, setIsOpen] = useState(false);

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../../src/components/sidenav/index.tsx"],"sourcesContent":["/*\n * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n'use client';\n\nimport 'client-only';\nimport { useOn } from '@accelint/bus/react';\nimport { clsx } from '@accelint/design-foundation/lib/utils';\nimport { useState } from 'react';\nimport { DEFAULT_SLOT, HeadingContext, Provider } from 'react-aria-components';\nimport { SidenavContext } from './context';\nimport { SidenavEventTypes } from './events';\nimport styles from './styles.module.css';\nimport type {\n  SidenavCloseEvent,\n  SidenavOpenEvent,\n  SidenavProps,\n  SidenavToggleEvent,\n} from './types';\n\n/**\n * Sidenav - Collapsible side navigation panel\n *\n * Provides a hierarchical collapsible side navigation intended to be used\n * inside a DrawerLayout. Supports headers, avatars, nested menus, and items.\n *\n * @example\n * <DrawerLayout push=\"left\">\n *   <DrawerLayoutMain className=\"col-start-2\">\n *     <SidenavTrigger>\n *       <Button variant=\"icon\" size=\"large\">\n *         <Icon>\n *           <MenuIcon />\n *         </Icon>\n *       </Button>\n *     </SidenavTrigger>\n *   </DrawerLayoutMain>\n *   <Sidenav>\n *     <SidenavHeader>\n *       <SidenavAvatar>\n *         <Icon><AppLogo /></Icon>\n *         <Heading>Application Header</Heading>\n *         <Text>subheader</Text>\n *       </SidenavAvatar>\n *     </SidenavHeader>\n *     <SidenavContent>\n *       <Heading>Navigation</Heading>\n *       <SidenavItem>\n *         <Icon><HomeIcon /></Icon>\n *         <Text>Home</Text>\n *       </SidenavItem>\n *       <Divider />\n *       <SidenavItem isSelected>\n *         <Icon><SettingsIcon /></Icon>\n *         <Text>Settings</Text>\n *       </SidenavItem>\n *       <Divider />\n *       <SidenavMenu title=\"More Options\" icon={<Icon><MenuIcon /></Icon>}>\n *         <SidenavMenuItem>\n *           <Text>Sub Item 1</Text>\n *         </SidenavMenuItem>\n *         <SidenavMenuItem>\n *           <Text>Sub Item 2</Text>\n *         </SidenavMenuItem>\n *       </SidenavMenu>\n *     </SidenavContent>\n *     <SidenavFooter>\n *       <SidenavAvatar>\n *         <Icon><UserIcon /></Icon>\n *         <Heading>User Name</Heading>\n *         <Text>john@example.com</Text>\n *       </SidenavAvatar>\n *     </SidenavFooter>\n *   </Sidenav>\n * </DrawerLayout>\n */\nexport function Sidenav({\n  id,\n  className,\n  isHiddenWhenClosed,\n  children,\n  ...rest\n}: SidenavProps) {\n  const [isOpen, setIsOpen] = useState(false);\n\n  useOn(SidenavEventTypes.toggle, (data: SidenavToggleEvent) => {\n    if (data.payload.id === id) {\n      setIsOpen((prev) => !prev);\n    }\n  });\n\n  useOn(SidenavEventTypes.open, (data: SidenavOpenEvent) => {\n    if (!isOpen && data.payload.id === id) {\n      setIsOpen(true);\n    }\n  });\n\n  useOn(SidenavEventTypes.close, (data: SidenavCloseEvent) => {\n    if (isOpen && data.payload.id === id) {\n      setIsOpen(false);\n    }\n  });\n\n  if (isHiddenWhenClosed && !isOpen) {\n    return null;\n  }\n\n  return (\n    <Provider\n      values={[\n        [\n          HeadingContext,\n          {\n            slots: {\n              [DEFAULT_SLOT]: {\n                className: clsx(styles.heading, styles.transient),\n              },\n              menu: { className: clsx(styles.heading, styles.transient) },\n              panel: { className: styles.heading },\n            },\n          },\n        ],\n        [SidenavContext, { id, isOpen }],\n      ]}\n    >\n      <nav\n        {...rest}\n        className={clsx('group/sidenav', styles.sidenav, className)}\n        data-open={isOpen || null}\n      >\n        {children}\n      </nav>\n    </Provider>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAoFA,SAAgB,QAAQ,EACtB,IACA,WACA,oBACA,UACA,GAAG,QACY;CACf,MAAM,CAAC,QAAQ,aAAa,SAAS,MAAM;AAE3C,OAAM,kBAAkB,SAAS,SAA6B;AAC5D,MAAI,KAAK,QAAQ,OAAO,GACtB,YAAW,SAAS,CAAC,KAAK;GAE5B;AAEF,OAAM,kBAAkB,OAAO,SAA2B;AACxD,MAAI,CAAC,UAAU,KAAK,QAAQ,OAAO,GACjC,WAAU,KAAK;GAEjB;AAEF,OAAM,kBAAkB,QAAQ,SAA4B;AAC1D,MAAI,UAAU,KAAK,QAAQ,OAAO,GAChC,WAAU,MAAM;GAElB;AAEF,KAAI,sBAAsB,CAAC,OACzB,QAAO;AAGT,QACE,oBAAC;EACC,QAAQ,CACN,CACE,gBACA,EACE,OAAO;IACJ,eAAe,EACd,WAAW,KAAK,OAAO,SAAS,OAAO,UAAU,EAClD;GACD,MAAM,EAAE,WAAW,KAAK,OAAO,SAAS,OAAO,UAAU,EAAE;GAC3D,OAAO,EAAE,WAAW,OAAO,SAAS;GACrC,EACF,CACF,EACD,CAAC,gBAAgB;GAAE;GAAI;GAAQ,CAAC,CACjC;YAED,oBAAC;GACC,GAAI;GACJ,WAAW,KAAK,iBAAiB,OAAO,SAAS,UAAU;GAC3D,aAAW,UAAU;GAEpB;IACG;GACG"}
+{"version":3,"file":"index.js","names":[],"sources":["../../../src/components/sidenav/index.tsx"],"sourcesContent":["/*\n * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n'use client';\n\nimport 'client-only';\nimport { useOn } from '@accelint/bus/react';\nimport { clsx } from '@accelint/design-foundation/lib/utils';\nimport { useState } from 'react';\nimport { DEFAULT_SLOT, HeadingContext, Provider } from 'react-aria-components';\nimport { SidenavContext } from './context';\nimport { SidenavEventTypes } from './events';\nimport styles from './styles.module.css';\nimport type {\n  SidenavCloseEvent,\n  SidenavOpenEvent,\n  SidenavProps,\n  SidenavToggleEvent,\n} from './types';\n\n/**\n * Sidenav - Collapsible side navigation panel\n *\n * Provides a hierarchical collapsible side navigation intended to be used\n * inside a DrawerLayout. Supports headers, avatars, nested menus, and items.\n *\n * @param props - {@link SidenavProps}\n * @param props.id - Unique identifier for the sidenav.\n * @param props.className - CSS class for the nav element.\n * @param props.isHiddenWhenClosed - Whether to hide the sidenav when closed.\n * @param props.children - Sidenav content (header, content, footer).\n * @returns The rendered Sidenav component.\n *\n * @example\n * ```tsx\n * <DrawerLayout push=\"left\">\n *   <DrawerLayoutMain className=\"col-start-2\">\n *     <SidenavTrigger>\n *       <Button variant=\"icon\" size=\"large\">\n *         <Icon>\n *           <MenuIcon />\n *         </Icon>\n *       </Button>\n *     </SidenavTrigger>\n *   </DrawerLayoutMain>\n *   <Sidenav>\n *     <SidenavHeader>\n *       <SidenavAvatar>\n *         <Icon><AppLogo /></Icon>\n *         <Heading>Application Header</Heading>\n *         <Text>subheader</Text>\n *       </SidenavAvatar>\n *     </SidenavHeader>\n *     <SidenavContent>\n *       <Heading>Navigation</Heading>\n *       <SidenavItem>\n *         <Icon><HomeIcon /></Icon>\n *         <Text>Home</Text>\n *       </SidenavItem>\n *       <Divider />\n *       <SidenavItem isSelected>\n *         <Icon><SettingsIcon /></Icon>\n *         <Text>Settings</Text>\n *       </SidenavItem>\n *       <Divider />\n *       <SidenavMenu title=\"More Options\" icon={<Icon><MenuIcon /></Icon>}>\n *         <SidenavMenuItem>\n *           <Text>Sub Item 1</Text>\n *         </SidenavMenuItem>\n *         <SidenavMenuItem>\n *           <Text>Sub Item 2</Text>\n *         </SidenavMenuItem>\n *       </SidenavMenu>\n *     </SidenavContent>\n *     <SidenavFooter>\n *       <SidenavAvatar>\n *         <Icon><UserIcon /></Icon>\n *         <Heading>User Name</Heading>\n *         <Text>john@example.com</Text>\n *       </SidenavAvatar>\n *     </SidenavFooter>\n *   </Sidenav>\n * </DrawerLayout>\n * ```\n */\nexport function Sidenav({\n  id,\n  className,\n  isHiddenWhenClosed,\n  children,\n  ...rest\n}: SidenavProps) {\n  const [isOpen, setIsOpen] = useState(false);\n\n  useOn(SidenavEventTypes.toggle, (data: SidenavToggleEvent) => {\n    if (data.payload.id === id) {\n      setIsOpen((prev) => !prev);\n    }\n  });\n\n  useOn(SidenavEventTypes.open, (data: SidenavOpenEvent) => {\n    if (!isOpen && data.payload.id === id) {\n      setIsOpen(true);\n    }\n  });\n\n  useOn(SidenavEventTypes.close, (data: SidenavCloseEvent) => {\n    if (isOpen && data.payload.id === id) {\n      setIsOpen(false);\n    }\n  });\n\n  if (isHiddenWhenClosed && !isOpen) {\n    return null;\n  }\n\n  return (\n    <Provider\n      values={[\n        [\n          HeadingContext,\n          {\n            slots: {\n              [DEFAULT_SLOT]: {\n                className: clsx(styles.heading, styles.transient),\n              },\n              menu: { className: clsx(styles.heading, styles.transient) },\n              panel: { className: styles.heading },\n            },\n          },\n        ],\n        [SidenavContext, { id, isOpen }],\n      ]}\n    >\n      <nav\n        {...rest}\n        className={clsx('group/sidenav', styles.sidenav, className)}\n        data-open={isOpen || null}\n      >\n        {children}\n      </nav>\n    </Provider>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6FA,SAAgB,QAAQ,EACtB,IACA,WACA,oBACA,UACA,GAAG,QACY;CACf,MAAM,CAAC,QAAQ,aAAa,SAAS,MAAM;AAE3C,OAAM,kBAAkB,SAAS,SAA6B;AAC5D,MAAI,KAAK,QAAQ,OAAO,GACtB,YAAW,SAAS,CAAC,KAAK;GAE5B;AAEF,OAAM,kBAAkB,OAAO,SAA2B;AACxD,MAAI,CAAC,UAAU,KAAK,QAAQ,OAAO,GACjC,WAAU,KAAK;GAEjB;AAEF,OAAM,kBAAkB,QAAQ,SAA4B;AAC1D,MAAI,UAAU,KAAK,QAAQ,OAAO,GAChC,WAAU,MAAM;GAElB;AAEF,KAAI,sBAAsB,CAAC,OACzB,QAAO;AAGT,QACE,oBAAC;EACC,QAAQ,CACN,CACE,gBACA,EACE,OAAO;IACJ,eAAe,EACd,WAAW,KAAK,OAAO,SAAS,OAAO,UAAU,EAClD;GACD,MAAM,EAAE,WAAW,KAAK,OAAO,SAAS,OAAO,UAAU,EAAE;GAC3D,OAAO,EAAE,WAAW,OAAO,SAAS;GACrC,EACF,CACF,EACD,CAAC,gBAAgB;GAAE;GAAI;GAAQ,CAAC,CACjC;YAED,oBAAC;GACC,GAAI;GACJ,WAAW,KAAK,iBAAiB,OAAO,SAAS,UAAU;GAC3D,aAAW,UAAU;GAEpB;IACG;GACG"}

package/dist/components/sidenav/item.d.ts

@@ -12,20 +12,35 @@
 
 import { SidenavItemProps } from "./types.js";
 import "client-only";
-import * as react_jsx_runtime112 from "react/jsx-runtime";
+import * as react_jsx_runtime136 from "react/jsx-runtime";
 
 //#region src/components/sidenav/item.d.ts
+
 /**
  * SidenavItem - Item component for sidenav
  *
  * Provides a selectable item with tooltip for the sidenav
+ *
+ * @example
+ * ```tsx
+ * <SidenavItem textValue="Dashboard" isSelected={true}>
+ *   <Icon><Home /></Icon>
+ *   <Text>Dashboard</Text>
+ * </SidenavItem>
+ * ```
+ *
+ * @param props - {@link SidenavItemProps}
+ * @param props.children - Item content (icon and text).
+ * @param props.classNames - Custom CSS class names for item elements.
+ * @param props.textValue - Text displayed in tooltip when collapsed.
+ * @returns The rendered SidenavItem component.
  */
 declare function SidenavItem({
   children,
   classNames,
   textValue,
   ...rest
-}: SidenavItemProps): react_jsx_runtime112.JSX.Element;
+}: SidenavItemProps): react_jsx_runtime136.JSX.Element;
 //#endregion
 export { SidenavItem };
 //# sourceMappingURL=item.d.ts.map

package/dist/components/sidenav/item.js

@@ -29,6 +29,20 @@ import styles from "./styles.module.css";
 * SidenavItem - Item component for sidenav
 *
 * Provides a selectable item with tooltip for the sidenav
+*
+* @example
+* ```tsx
+* <SidenavItem textValue="Dashboard" isSelected={true}>
+*   <Icon><Home /></Icon>
+*   <Text>Dashboard</Text>
+* </SidenavItem>
+* ```
+*
+* @param props - {@link SidenavItemProps}
+* @param props.children - Item content (icon and text).
+* @param props.classNames - Custom CSS class names for item elements.
+* @param props.textValue - Text displayed in tooltip when collapsed.
+* @returns The rendered SidenavItem component.
 */
 function SidenavItem({ children, classNames, textValue, ...rest }) {
 	const { isOpen } = useContext(SidenavContext);

package/dist/components/sidenav/item.js.map

@@ -1 +1 @@
-{"version":3,"file":"item.js","names":["TooltipTrigger","Tooltip"],"sources":["../../../src/components/sidenav/item.tsx"],"sourcesContent":["/*\n * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n'use client';\n\nimport 'client-only';\nimport { clsx } from '@accelint/design-foundation/lib/utils';\nimport { useContext, useRef } from 'react';\nimport {\n  composeRenderProps,\n  Provider,\n  TextContext,\n  ToggleButton,\n} from 'react-aria-components';\nimport { IconContext } from '../icon/context';\nimport { Tooltip } from '../tooltip';\nimport { TooltipTrigger } from '../tooltip/trigger';\nimport { SidenavContext } from './context';\nimport styles from './styles.module.css';\nimport type { SidenavItemProps } from './types';\n\n/**\n * SidenavItem - Item component for sidenav\n *\n * Provides a selectable item with tooltip for the sidenav\n */\nexport function SidenavItem({\n  children,\n  classNames,\n  textValue,\n  ...rest\n}: SidenavItemProps) {\n  const { isOpen } = useContext(SidenavContext);\n\n  // Implement ref to place tooltip inside Button DOM to enable contextual styling\n  const ref = useRef(null);\n\n  return (\n    <Provider\n      values={[\n        [IconContext, { size: 'medium' }],\n        [TextContext, { className: clsx(styles.text, styles.transient) }],\n      ]}\n    >\n      <TooltipTrigger isDisabled={isOpen}>\n        <ToggleButton\n          {...rest}\n          ref={ref}\n          className={composeRenderProps(classNames?.button, (className) =>\n            clsx('group/item', styles.item, className),\n          )}\n        >\n          {children}\n        </ToggleButton>\n        <Tooltip parentRef={ref} placement='right' className={styles.tooltip}>\n          {textValue}\n        </Tooltip>\n      </TooltipTrigger>\n    </Provider>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAkCA,SAAgB,YAAY,EAC1B,UACA,YACA,WACA,GAAG,QACgB;CACnB,MAAM,EAAE,WAAW,WAAW,eAAe;CAG7C,MAAM,MAAM,OAAO,KAAK;AAExB,QACE,oBAAC;EACC,QAAQ,CACN,CAAC,aAAa,EAAE,MAAM,UAAU,CAAC,EACjC,CAAC,aAAa,EAAE,WAAW,KAAK,OAAO,MAAM,OAAO,UAAU,EAAE,CAAC,CAClE;YAED,qBAACA;GAAe,YAAY;cAC1B,oBAAC;IACC,GAAI;IACC;IACL,WAAW,mBAAmB,YAAY,SAAS,cACjD,KAAK,cAAc,OAAO,MAAM,UAAU,CAC3C;IAEA;KACY,EACf,oBAACC;IAAQ,WAAW;IAAK,WAAU;IAAQ,WAAW,OAAO;cAC1D;KACO;IACK;GACR"}
+{"version":3,"file":"item.js","names":["TooltipTrigger","Tooltip"],"sources":["../../../src/components/sidenav/item.tsx"],"sourcesContent":["/*\n * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n'use client';\n\nimport 'client-only';\nimport { clsx } from '@accelint/design-foundation/lib/utils';\nimport { useContext, useRef } from 'react';\nimport {\n  composeRenderProps,\n  Provider,\n  TextContext,\n  ToggleButton,\n} from 'react-aria-components';\nimport { IconContext } from '../icon/context';\nimport { Tooltip } from '../tooltip';\nimport { TooltipTrigger } from '../tooltip/trigger';\nimport { SidenavContext } from './context';\nimport styles from './styles.module.css';\nimport type { SidenavItemProps } from './types';\n\n/**\n * SidenavItem - Item component for sidenav\n *\n * Provides a selectable item with tooltip for the sidenav\n *\n * @example\n * ```tsx\n * <SidenavItem textValue=\"Dashboard\" isSelected={true}>\n *   <Icon><Home /></Icon>\n *   <Text>Dashboard</Text>\n * </SidenavItem>\n * ```\n *\n * @param props - {@link SidenavItemProps}\n * @param props.children - Item content (icon and text).\n * @param props.classNames - Custom CSS class names for item elements.\n * @param props.textValue - Text displayed in tooltip when collapsed.\n * @returns The rendered SidenavItem component.\n */\nexport function SidenavItem({\n  children,\n  classNames,\n  textValue,\n  ...rest\n}: SidenavItemProps) {\n  const { isOpen } = useContext(SidenavContext);\n\n  // Implement ref to place tooltip inside Button DOM to enable contextual styling\n  const ref = useRef(null);\n\n  return (\n    <Provider\n      values={[\n        [IconContext, { size: 'medium' }],\n        [TextContext, { className: clsx(styles.text, styles.transient) }],\n      ]}\n    >\n      <TooltipTrigger isDisabled={isOpen}>\n        <ToggleButton\n          {...rest}\n          ref={ref}\n          className={composeRenderProps(classNames?.button, (className) =>\n            clsx('group/item', styles.item, className),\n          )}\n        >\n          {children}\n        </ToggleButton>\n        <Tooltip parentRef={ref} placement='right' className={styles.tooltip}>\n          {textValue}\n        </Tooltip>\n      </TooltipTrigger>\n    </Provider>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAgDA,SAAgB,YAAY,EAC1B,UACA,YACA,WACA,GAAG,QACgB;CACnB,MAAM,EAAE,WAAW,WAAW,eAAe;CAG7C,MAAM,MAAM,OAAO,KAAK;AAExB,QACE,oBAAC;EACC,QAAQ,CACN,CAAC,aAAa,EAAE,MAAM,UAAU,CAAC,EACjC,CAAC,aAAa,EAAE,WAAW,KAAK,OAAO,MAAM,OAAO,UAAU,EAAE,CAAC,CAClE;YAED,qBAACA;GAAe,YAAY;cAC1B,oBAAC;IACC,GAAI;IACC;IACL,WAAW,mBAAmB,YAAY,SAAS,cACjD,KAAK,cAAc,OAAO,MAAM,UAAU,CAC3C;IAEA;KACY,EACf,oBAACC;IAAQ,WAAW;IAAK,WAAU;IAAQ,WAAW,OAAO;cAC1D;KACO;IACK;GACR"}

package/dist/components/sidenav/link.d.ts

@@ -12,20 +12,35 @@
 
 import { SidenavLinkProps } from "./types.js";
 import "client-only";
-import * as react_jsx_runtime155 from "react/jsx-runtime";
+import * as react_jsx_runtime139 from "react/jsx-runtime";
 
 //#region src/components/sidenav/link.d.ts
+
 /**
  * SidenavLink - Link component for sidenav
  *
  * Provides a link with tooltip for the sidenav
+ *
+ * @example
+ * ```tsx
+ * <SidenavLink href="https://example.com" textValue="External Link">
+ *   <Icon><Link /></Icon>
+ *   <Text>External Link</Text>
+ * </SidenavLink>
+ * ```
+ *
+ * @param props - {@link SidenavLinkProps}
+ * @param props.children - Link content (icon and text).
+ * @param props.classNames - Custom CSS class names for link elements.
+ * @param props.textValue - Text displayed in tooltip when collapsed.
+ * @returns The rendered SidenavLink component.
  */
 declare function SidenavLink({
   children,
   classNames,
   textValue,
   ...rest
-}: SidenavLinkProps): react_jsx_runtime155.JSX.Element;
+}: SidenavLinkProps): react_jsx_runtime139.JSX.Element;
 //#endregion
 export { SidenavLink };
 //# sourceMappingURL=link.d.ts.map

package/dist/components/sidenav/link.js

@@ -22,14 +22,28 @@ import { useContext, useRef } from "react";
 import { clsx } from "@accelint/design-foundation/lib/utils";
 import { Link, Provider, TextContext, composeRenderProps } from "react-aria-components";
 import { Fragment as Fragment$1, jsx, jsxs } from "react/jsx-runtime";
-import { ArrowNortheast } from "@accelint/icons";
 import styles from "./styles.module.css";
+import ArrowNortheast from "@accelint/icons/arrow-northeast";
 
 //#region src/components/sidenav/link.tsx
 /**
 * SidenavLink - Link component for sidenav
 *
 * Provides a link with tooltip for the sidenav
+*
+* @example
+* ```tsx
+* <SidenavLink href="https://example.com" textValue="External Link">
+*   <Icon><Link /></Icon>
+*   <Text>External Link</Text>
+* </SidenavLink>
+* ```
+*
+* @param props - {@link SidenavLinkProps}
+* @param props.children - Link content (icon and text).
+* @param props.classNames - Custom CSS class names for link elements.
+* @param props.textValue - Text displayed in tooltip when collapsed.
+* @returns The rendered SidenavLink component.
 */
 function SidenavLink({ children, classNames, textValue, ...rest }) {
 	const { isOpen } = useContext(SidenavContext);

package/dist/components/sidenav/link.js.map

@@ -1 +1 @@
-{"version":3,"file":"link.js","names":["TooltipTrigger","children","Tooltip"],"sources":["../../../src/components/sidenav/link.tsx"],"sourcesContent":["/*\n * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n'use client';\n\nimport { ArrowNortheast } from '@accelint/icons';\nimport 'client-only';\nimport { clsx } from '@accelint/design-foundation/lib/utils';\nimport { useContext, useRef } from 'react';\nimport {\n  composeRenderProps,\n  Link,\n  Provider,\n  TextContext,\n} from 'react-aria-components';\nimport { Icon } from '../icon';\nimport { Tooltip } from '../tooltip';\nimport { TooltipTrigger } from '../tooltip/trigger';\nimport { SidenavContext } from './context';\nimport styles from './styles.module.css';\nimport type { SidenavLinkProps } from './types';\n\n/**\n * SidenavLink - Link component for sidenav\n *\n * Provides a link with tooltip for the sidenav\n */\nexport function SidenavLink({\n  children,\n  classNames,\n  textValue,\n  ...rest\n}: SidenavLinkProps) {\n  const { isOpen } = useContext(SidenavContext);\n\n  // Implement ref to place tooltip inside Link DOM to enable contextual styling\n  const ref = useRef(null);\n\n  return (\n    <Provider\n      values={[\n        [TextContext, { className: clsx(styles.text, styles.transient) }],\n      ]}\n    >\n      <TooltipTrigger isDisabled={isOpen}>\n        <Link\n          {...rest}\n          ref={ref}\n          className={composeRenderProps(classNames?.button, (className) =>\n            clsx('group/link', styles.link, className),\n          )}\n        >\n          {composeRenderProps(children, (children) => (\n            <>\n              {children}\n              <Icon className={styles.transient}>\n                <ArrowNortheast />\n              </Icon>\n            </>\n          ))}\n        </Link>\n        <Tooltip parentRef={ref} placement='right' className={styles.tooltip}>\n          {textValue}\n          <Icon>\n            <ArrowNortheast />\n          </Icon>\n        </Tooltip>\n      </TooltipTrigger>\n    </Provider>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmCA,SAAgB,YAAY,EAC1B,UACA,YACA,WACA,GAAG,QACgB;CACnB,MAAM,EAAE,WAAW,WAAW,eAAe;CAG7C,MAAM,MAAM,OAAO,KAAK;AAExB,QACE,oBAAC;EACC,QAAQ,CACN,CAAC,aAAa,EAAE,WAAW,KAAK,OAAO,MAAM,OAAO,UAAU,EAAE,CAAC,CAClE;YAED,qBAACA;GAAe,YAAY;cAC1B,oBAAC;IACC,GAAI;IACC;IACL,WAAW,mBAAmB,YAAY,SAAS,cACjD,KAAK,cAAc,OAAO,MAAM,UAAU,CAC3C;cAEA,mBAAmB,WAAW,eAC7B,8CACGC,YACD,oBAAC;KAAK,WAAW,OAAO;eACtB,oBAAC,mBAAiB;MACb,IACN,CACH;KACG,EACP,qBAACC;IAAQ,WAAW;IAAK,WAAU;IAAQ,WAAW,OAAO;eAC1D,WACD,oBAAC,kBACC,oBAAC,mBAAiB,GACb;KACC;IACK;GACR"}
+{"version":3,"file":"link.js","names":["TooltipTrigger","children","Tooltip"],"sources":["../../../src/components/sidenav/link.tsx"],"sourcesContent":["/*\n * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n'use client';\nimport 'client-only';\nimport { clsx } from '@accelint/design-foundation/lib/utils';\nimport ArrowNortheast from '@accelint/icons/arrow-northeast';\nimport { useContext, useRef } from 'react';\nimport {\n  composeRenderProps,\n  Link,\n  Provider,\n  TextContext,\n} from 'react-aria-components';\nimport { Icon } from '../icon';\nimport { Tooltip } from '../tooltip';\nimport { TooltipTrigger } from '../tooltip/trigger';\nimport { SidenavContext } from './context';\nimport styles from './styles.module.css';\nimport type { SidenavLinkProps } from './types';\n\n/**\n * SidenavLink - Link component for sidenav\n *\n * Provides a link with tooltip for the sidenav\n *\n * @example\n * ```tsx\n * <SidenavLink href=\"https://example.com\" textValue=\"External Link\">\n *   <Icon><Link /></Icon>\n *   <Text>External Link</Text>\n * </SidenavLink>\n * ```\n *\n * @param props - {@link SidenavLinkProps}\n * @param props.children - Link content (icon and text).\n * @param props.classNames - Custom CSS class names for link elements.\n * @param props.textValue - Text displayed in tooltip when collapsed.\n * @returns The rendered SidenavLink component.\n */\nexport function SidenavLink({\n  children,\n  classNames,\n  textValue,\n  ...rest\n}: SidenavLinkProps) {\n  const { isOpen } = useContext(SidenavContext);\n\n  // Implement ref to place tooltip inside Link DOM to enable contextual styling\n  const ref = useRef(null);\n\n  return (\n    <Provider\n      values={[\n        [TextContext, { className: clsx(styles.text, styles.transient) }],\n      ]}\n    >\n      <TooltipTrigger isDisabled={isOpen}>\n        <Link\n          {...rest}\n          ref={ref}\n          className={composeRenderProps(classNames?.button, (className) =>\n            clsx('group/link', styles.link, className),\n          )}\n        >\n          {composeRenderProps(children, (children) => (\n            <>\n              {children}\n              <Icon className={styles.transient}>\n                <ArrowNortheast />\n              </Icon>\n            </>\n          ))}\n        </Link>\n        <Tooltip parentRef={ref} placement='right' className={styles.tooltip}>\n          {textValue}\n          <Icon>\n            <ArrowNortheast />\n          </Icon>\n        </Tooltip>\n      </TooltipTrigger>\n    </Provider>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAgDA,SAAgB,YAAY,EAC1B,UACA,YACA,WACA,GAAG,QACgB;CACnB,MAAM,EAAE,WAAW,WAAW,eAAe;CAG7C,MAAM,MAAM,OAAO,KAAK;AAExB,QACE,oBAAC;EACC,QAAQ,CACN,CAAC,aAAa,EAAE,WAAW,KAAK,OAAO,MAAM,OAAO,UAAU,EAAE,CAAC,CAClE;YAED,qBAACA;GAAe,YAAY;cAC1B,oBAAC;IACC,GAAI;IACC;IACL,WAAW,mBAAmB,YAAY,SAAS,cACjD,KAAK,cAAc,OAAO,MAAM,UAAU,CAC3C;cAEA,mBAAmB,WAAW,eAC7B,8CACGC,YACD,oBAAC;KAAK,WAAW,OAAO;eACtB,oBAAC,mBAAiB;MACb,IACN,CACH;KACG,EACP,qBAACC;IAAQ,WAAW;IAAK,WAAU;IAAQ,WAAW,OAAO;eAC1D,WACD,oBAAC,kBACC,oBAAC,mBAAiB,GACb;KACC;IACK;GACR"}

package/dist/components/sidenav/menu-item.d.ts

@@ -11,19 +11,33 @@
  */
 
 import { SidenavMenuItemProps } from "./types.js";
-import * as react_jsx_runtime157 from "react/jsx-runtime";
+import * as react_jsx_runtime140 from "react/jsx-runtime";
 
 //#region src/components/sidenav/menu-item.d.ts
+
 /**
  * SidenavMenuItem - Menu item component for sidenav
  *
  * Provides a selectable item within a sidenav menu
+ *
+ * @example
+ * ```tsx
+ * <SidenavMenu icon={<Settings />} title="Settings">
+ *   <SidenavMenuItem isSelected={true}>Profile</SidenavMenuItem>
+ *   <SidenavMenuItem>Preferences</SidenavMenuItem>
+ * </SidenavMenu>
+ * ```
+ *
+ * @param props - {@link SidenavMenuItemProps}
+ * @param props.className - CSS class for the menu item.
+ * @param props.children - Menu item content.
+ * @returns The rendered SidenavMenuItem component.
  */
 declare function SidenavMenuItem({
   className,
   children,
   ...rest
-}: SidenavMenuItemProps): react_jsx_runtime157.JSX.Element;
+}: SidenavMenuItemProps): react_jsx_runtime140.JSX.Element;
 //#endregion
 export { SidenavMenuItem };
 //# sourceMappingURL=menu-item.d.ts.map

package/dist/components/sidenav/menu-item.js

@@ -21,6 +21,19 @@ import styles from "./styles.module.css";
 * SidenavMenuItem - Menu item component for sidenav
 *
 * Provides a selectable item within a sidenav menu
+*
+* @example
+* ```tsx
+* <SidenavMenu icon={<Settings />} title="Settings">
+*   <SidenavMenuItem isSelected={true}>Profile</SidenavMenuItem>
+*   <SidenavMenuItem>Preferences</SidenavMenuItem>
+* </SidenavMenu>
+* ```
+*
+* @param props - {@link SidenavMenuItemProps}
+* @param props.className - CSS class for the menu item.
+* @param props.children - Menu item content.
+* @returns The rendered SidenavMenuItem component.
 */
 function SidenavMenuItem({ className, children, ...rest }) {
 	return /* @__PURE__ */ jsx(ToggleButton, {