@accelint/design-toolkit 9.3.0 → 9.4.1

package/dist/components/drawer/header-title.js.map

@@ -1 +1 @@
-{"version":3,"file":"header-title.js","names":[],"sources":["../../../src/components/drawer/header-title.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\nimport { clsx } from '@accelint/design-foundation/lib/utils';\nimport { Heading } from 'react-aria-components';\nimport styles from './styles.module.css';\nimport type { DrawerTitleProps } from './types';\n\n/**\n * To change size of title, use the `level` prop: `1`-`3` (large), `4`-`6` (medium).\n *\n * `level` also changes the semantic heading tag number `h1`-`h6`\n */\nexport function DrawerHeaderTitle({\n  className,\n  level = 2,\n  ...rest\n}: DrawerTitleProps) {\n  return (\n    <Heading\n      {...rest}\n      className={clsx(\n        styles.title,\n        level <= 3 ? styles.large : styles.medium,\n        className,\n      )}\n      level={level}\n    />\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AAsBA,SAAgB,kBAAkB,EAChC,WACA,QAAQ,GACR,GAAG,QACgB;AACnB,QACE,oBAAC;EACC,GAAI;EACJ,WAAW,KACT,OAAO,OACP,SAAS,IAAI,OAAO,QAAQ,OAAO,QACnC,UACD;EACM;GACP"}
+{"version":3,"file":"header-title.js","names":[],"sources":["../../../src/components/drawer/header-title.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\nimport { clsx } from '@accelint/design-foundation/lib/utils';\nimport { Heading } from 'react-aria-components';\nimport styles from './styles.module.css';\nimport type { DrawerTitleProps } from './types';\n\n/**\n * DrawerHeaderTitle - Semantic heading for drawer headers.\n *\n * The `level` prop controls both visual size and semantic heading level:\n * - Levels 1-3: Large text size (renders as h1-h3)\n * - Levels 4-6: Medium text size (renders as h4-h6)\n *\n * @param props - {@link DrawerTitleProps}\n * @param props.className - Optional CSS class name.\n * @param props.level - Heading level (1-6).\n * @returns The rendered DrawerHeaderTitle component.\n *\n * @default level 2\n *\n * @example\n * ```tsx\n * <DrawerHeader>\n *   <DrawerHeaderTitle level={2}>Settings</DrawerHeaderTitle>\n *   <DrawerClose />\n * </DrawerHeader>\n * ```\n */\nexport function DrawerHeaderTitle({\n  className,\n  level = 2,\n  ...rest\n}: DrawerTitleProps) {\n  return (\n    <Heading\n      {...rest}\n      className={clsx(\n        styles.title,\n        level <= 3 ? styles.large : styles.medium,\n        className,\n      )}\n      level={level}\n    />\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAuCA,SAAgB,kBAAkB,EAChC,WACA,QAAQ,GACR,GAAG,QACgB;AACnB,QACE,oBAAC;EACC,GAAI;EACJ,WAAW,KACT,OAAO,OACP,SAAS,IAAI,OAAO,QAAQ,OAAO,QACnC,UACD;EACM;GACP"}

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

@@ -12,15 +12,47 @@
 
 import "client-only";
 import { ComponentPropsWithRef } from "react";
-import * as react_jsx_runtime73 from "react/jsx-runtime";
+import * as react_jsx_runtime68 from "react/jsx-runtime";
 
 //#region src/components/drawer/header.d.ts
+
+/**
+ * DrawerHeader - Header region within a DrawerView.
+ *
+ * Supports two usage patterns:
+ * - Use `title` prop for automatic layout with back/close buttons
+ * - Use `children` for custom header content
+ *
+ * Heading level automatically adjusts based on view stack depth
+ * (h2 for root view, h4 for nested views).
+ *
+ * @param props - ComponentPropsWithRef<'header'>
+ * @param props.className - Optional CSS class name.
+ * @param props.title - Title text for the header.
+ * @param props.children - Custom header content (overrides title).
+ * @returns The rendered DrawerHeader component.
+ *
+ * @example
+ * ```tsx
+ * // Simplified with title prop
+ * <DrawerHeader title="Settings" />
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // Custom layout
+ * <DrawerHeader>
+ *   <DrawerHeaderTitle level={2}>Settings</DrawerHeaderTitle>
+ *   <DrawerClose />
+ * </DrawerHeader>
+ *```
+ */
 declare function DrawerHeader({
   className,
   title,
   children,
   ...rest
-}: ComponentPropsWithRef<'header'>): react_jsx_runtime73.JSX.Element;
+}: ComponentPropsWithRef<'header'>): react_jsx_runtime68.JSX.Element;
 //#endregion
 export { DrawerHeader };
 //# sourceMappingURL=header.d.ts.map

package/dist/components/drawer/header.js

@@ -13,9 +13,11 @@
 
 'use client';
 
+import { Icon } from "../icon/index.js";
+import { Button as Button$1 } from "../button/index.js";
 import { ViewStackContext } from "../view-stack/context.js";
+import { DrawerTrigger } from "./trigger.js";
 import { DrawerBack } from "./back.js";
-import { DrawerClose } from "./close.js";
 import { DrawerHeaderTitle } from "./header-title.js";
 import "client-only";
 import { useContext } from "react";
@@ -23,8 +25,40 @@ import { clsx } from "@accelint/design-foundation/lib/utils";
 import { Header } from "react-aria-components";
 import { Fragment as Fragment$1, jsx, jsxs } from "react/jsx-runtime";
 import styles from "./styles.module.css";
+import { Cancel } from "@accelint/icons";
 
 //#region src/components/drawer/header.tsx
+/**
+* DrawerHeader - Header region within a DrawerView.
+*
+* Supports two usage patterns:
+* - Use `title` prop for automatic layout with back/close buttons
+* - Use `children` for custom header content
+*
+* Heading level automatically adjusts based on view stack depth
+* (h2 for root view, h4 for nested views).
+*
+* @param props - ComponentPropsWithRef<'header'>
+* @param props.className - Optional CSS class name.
+* @param props.title - Title text for the header.
+* @param props.children - Custom header content (overrides title).
+* @returns The rendered DrawerHeader component.
+*
+* @example
+* ```tsx
+* // Simplified with title prop
+* <DrawerHeader title="Settings" />
+* ```
+*
+* @example
+* ```tsx
+* // Custom layout
+* <DrawerHeader>
+*   <DrawerHeaderTitle level={2}>Settings</DrawerHeaderTitle>
+*   <DrawerClose />
+* </DrawerHeader>
+*```
+*/
 function DrawerHeader({ className, title, children, ...rest }) {
 	const { stack } = useContext(ViewStackContext);
 	const level = stack.length > 1 ? 4 : 2;
@@ -37,7 +71,13 @@ function DrawerHeader({ className, title, children, ...rest }) {
 				level,
 				children: title
 			}),
-			/* @__PURE__ */ jsx(DrawerClose, {})
+			/* @__PURE__ */ jsx(DrawerTrigger, {
+				for: "clear",
+				children: /* @__PURE__ */ jsx(Button$1, {
+					variant: "icon",
+					children: /* @__PURE__ */ jsx(Icon, { children: /* @__PURE__ */ jsx(Cancel, {}) })
+				})
+			})
 		] }) : children
 	});
 }

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

@@ -1 +1 @@
-{"version":3,"file":"header.js","names":[],"sources":["../../../src/components/drawer/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 { clsx } from '@accelint/design-foundation/lib/utils';\nimport { type ComponentPropsWithRef, useContext } from 'react';\nimport { Header } from 'react-aria-components';\nimport { ViewStackContext } from '../view-stack/context';\nimport { DrawerBack } from './back';\nimport { DrawerClose } from './close';\nimport { DrawerHeaderTitle } from './header-title';\nimport styles from './styles.module.css';\n\nexport function DrawerHeader({\n  className,\n  title,\n  children,\n  ...rest\n}: ComponentPropsWithRef<'header'>) {\n  const { stack } = useContext(ViewStackContext);\n  const level = stack.length > 1 ? 4 : 2;\n\n  return (\n    <Header {...rest} className={clsx(styles.header, className)}>\n      {children == null ? (\n        <>\n          <DrawerBack />\n          <DrawerHeaderTitle level={level}>{title}</DrawerHeaderTitle>\n          <DrawerClose />\n        </>\n      ) : (\n        children\n      )}\n    </Header>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;AAuBA,SAAgB,aAAa,EAC3B,WACA,OACA,UACA,GAAG,QAC+B;CAClC,MAAM,EAAE,UAAU,WAAW,iBAAiB;CAC9C,MAAM,QAAQ,MAAM,SAAS,IAAI,IAAI;AAErC,QACE,oBAAC;EAAO,GAAI;EAAM,WAAW,KAAK,OAAO,QAAQ,UAAU;YACxD,YAAY,OACX;GACE,oBAAC,eAAa;GACd,oBAAC;IAAyB;cAAQ;KAA0B;GAC5D,oBAAC,gBAAc;MACd,GAEH;GAEK"}
+{"version":3,"file":"header.js","names":["Button"],"sources":["../../../src/components/drawer/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 { clsx } from '@accelint/design-foundation/lib/utils';\nimport { Cancel } from '@accelint/icons';\nimport 'client-only';\nimport { type ComponentPropsWithRef, useContext } from 'react';\nimport { Header } from 'react-aria-components';\nimport { Button } from '../button';\nimport { Icon } from '../icon';\nimport { ViewStackContext } from '../view-stack/context';\nimport { DrawerBack } from './back';\nimport { DrawerHeaderTitle } from './header-title';\nimport styles from './styles.module.css';\nimport { DrawerTrigger } from './trigger';\n\n/**\n * DrawerHeader - Header region within a DrawerView.\n *\n * Supports two usage patterns:\n * - Use `title` prop for automatic layout with back/close buttons\n * - Use `children` for custom header content\n *\n * Heading level automatically adjusts based on view stack depth\n * (h2 for root view, h4 for nested views).\n *\n * @param props - ComponentPropsWithRef<'header'>\n * @param props.className - Optional CSS class name.\n * @param props.title - Title text for the header.\n * @param props.children - Custom header content (overrides title).\n * @returns The rendered DrawerHeader component.\n *\n * @example\n * ```tsx\n * // Simplified with title prop\n * <DrawerHeader title=\"Settings\" />\n * ```\n *\n * @example\n * ```tsx\n * // Custom layout\n * <DrawerHeader>\n *   <DrawerHeaderTitle level={2}>Settings</DrawerHeaderTitle>\n *   <DrawerClose />\n * </DrawerHeader>\n *```\n */\nexport function DrawerHeader({\n  className,\n  title,\n  children,\n  ...rest\n}: ComponentPropsWithRef<'header'>) {\n  const { stack } = useContext(ViewStackContext);\n  const level = stack.length > 1 ? 4 : 2;\n\n  return (\n    <Header {...rest} className={clsx(styles.header, className)}>\n      {children == null ? (\n        <>\n          <DrawerBack />\n          <DrawerHeaderTitle level={level}>{title}</DrawerHeaderTitle>\n          <DrawerTrigger for='clear'>\n            <Button variant='icon'>\n              <Icon>\n                <Cancel />\n              </Icon>\n            </Button>\n          </DrawerTrigger>\n        </>\n      ) : (\n        children\n      )}\n    </Header>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAyDA,SAAgB,aAAa,EAC3B,WACA,OACA,UACA,GAAG,QAC+B;CAClC,MAAM,EAAE,UAAU,WAAW,iBAAiB;CAC9C,MAAM,QAAQ,MAAM,SAAS,IAAI,IAAI;AAErC,QACE,oBAAC;EAAO,GAAI;EAAM,WAAW,KAAK,OAAO,QAAQ,UAAU;YACxD,YAAY,OACX;GACE,oBAAC,eAAa;GACd,oBAAC;IAAyB;cAAQ;KAA0B;GAC5D,oBAAC;IAAc,KAAI;cACjB,oBAACA;KAAO,SAAQ;eACd,oBAAC,kBACC,oBAAC,WAAS,GACL;MACA;KACK;MACf,GAEH;GAEK"}

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

@@ -12,7 +12,7 @@
 
 import { DrawerProps } from "./types.js";
 import "client-only";
-import * as react_jsx_runtime75 from "react/jsx-runtime";
+import * as react_jsx_runtime70 from "react/jsx-runtime";
 
 //#region src/components/drawer/index.d.ts
 
@@ -22,7 +22,18 @@ import * as react_jsx_runtime75 from "react/jsx-runtime";
  * A flexible panel that slides in from the viewport edge and supports
  * stacked views, headers, footers, and programmatic triggers.
  *
+ * @param props - {@link DrawerProps}
+ * @param props.id - Unique identifier for the drawer.
+ * @param props.children - Content to render inside the drawer.
+ * @param props.className - Optional CSS class name.
+ * @param props.defaultView - ID of the view to display initially.
+ * @param props.placement - Edge of the viewport the drawer slides from.
+ * @param props.size - Size of the drawer panel.
+ * @param props.onChange - Callback when the active view changes.
+ * @returns The rendered Drawer component.
+ *
  * @example
+ * ```tsx
  * const ids = { drawer: uuid(), a: uuid() };
  *
  * <DrawerLayout push="left">
@@ -41,6 +52,7 @@ import * as react_jsx_runtime75 from "react/jsx-runtime";
  *     </DrawerPanel>
  *   </Drawer>
  * </DrawerLayout>
+ * ```
  */
 declare function Drawer({
   id,
@@ -51,7 +63,7 @@ declare function Drawer({
   size,
   onChange,
   ...rest
-}: DrawerProps): react_jsx_runtime75.JSX.Element;
+}: DrawerProps): react_jsx_runtime70.JSX.Element;
 //#endregion
 export { Drawer };
 //# sourceMappingURL=index.d.ts.map

package/dist/components/drawer/index.js

@@ -31,7 +31,18 @@ import styles from "./styles.module.css";
 * A flexible panel that slides in from the viewport edge and supports
 * stacked views, headers, footers, and programmatic triggers.
 *
+* @param props - {@link DrawerProps}
+* @param props.id - Unique identifier for the drawer.
+* @param props.children - Content to render inside the drawer.
+* @param props.className - Optional CSS class name.
+* @param props.defaultView - ID of the view to display initially.
+* @param props.placement - Edge of the viewport the drawer slides from.
+* @param props.size - Size of the drawer panel.
+* @param props.onChange - Callback when the active view changes.
+* @returns The rendered Drawer component.
+*
 * @example
+* ```tsx
 * const ids = { drawer: uuid(), a: uuid() };
 *
 * <DrawerLayout push="left">
@@ -50,11 +61,15 @@ import styles from "./styles.module.css";
 *     </DrawerPanel>
 *   </Drawer>
 * </DrawerLayout>
+* ```
 */
 function Drawer({ id, children, className, defaultView, placement = "left", size = "medium", onChange, ...rest }) {
 	const views = useRef(/* @__PURE__ */ new Set());
 	const [activeView, setActiveView] = useState(defaultView || null);
 	const viewStackEmit = useViewStackEmit();
+	const handleClose = useCallback((data) => {
+		if (views.current.has(data?.payload?.view) || data?.payload?.view === id) viewStackEmit.clear(id);
+	}, [viewStackEmit.clear, id]);
 	const handleOpen = useCallback((data) => {
 		if (views.current.has(data?.payload?.view)) {
 			viewStackEmit.clear(id);
@@ -76,6 +91,7 @@ function Drawer({ id, children, className, defaultView, placement = "left", size
 		viewStackEmit.clear,
 		viewStackEmit.push
 	]);
+	useOn(DrawerEventTypes.close, handleClose);
 	useOn(DrawerEventTypes.open, handleOpen);
 	useOn(DrawerEventTypes.toggle, handleToggle);
 	return /* @__PURE__ */ jsx(DrawerContext.Provider, {

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../../src/components/drawer/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 { useOn } from '@accelint/bus/react';\nimport type { UniqueId } from '@accelint/core';\nimport 'client-only';\nimport { clsx } from '@accelint/design-foundation/lib/utils';\nimport { useCallback, useRef, useState } from 'react';\nimport { ViewStack } from '../view-stack';\nimport { useViewStackEmit } from '../view-stack/context';\nimport { DrawerContext } from './context';\nimport { DrawerEventTypes } from './events';\nimport styles from './styles.module.css';\nimport type { DrawerOpenEvent, DrawerProps, DrawerToggleEvent } from './types';\n\n/**\n * Drawer - Slide-in panel for navigation or contextual content\n *\n * A flexible panel that slides in from the viewport edge and supports\n * stacked views, headers, footers, and programmatic triggers.\n *\n * @example\n * const ids = { drawer: uuid(), a: uuid() };\n *\n * <DrawerLayout push=\"left\">\n *   <DrawerLayoutMain>\n *     <DrawerTrigger for={`open:${ids.a}`}>\n *       <Button variant=\"icon\">Open</Button>\n *     </DrawerTrigger>\n *   </DrawerLayoutMain>\n *\n *   <Drawer id={ids.drawer} defaultView={ids.a}>\n *     <DrawerPanel>\n *       <DrawerView id={ids.a}>\n *         <DrawerHeader title=\"Title A\" />\n *         <DrawerContent>Content for View A</DrawerContent>\n *       </DrawerView>\n *     </DrawerPanel>\n *   </Drawer>\n * </DrawerLayout>\n */\nexport function Drawer({\n  id,\n  children,\n  className,\n  defaultView,\n  placement = 'left',\n  size = 'medium',\n  onChange,\n  ...rest\n}: DrawerProps) {\n  const views = useRef(new Set<UniqueId>());\n  const [activeView, setActiveView] = useState<UniqueId | null>(\n    defaultView || null,\n  );\n\n  const viewStackEmit = useViewStackEmit();\n\n  const handleOpen = useCallback(\n    (data: DrawerOpenEvent) => {\n      if (views.current.has(data?.payload?.view)) {\n        viewStackEmit.clear(id);\n        viewStackEmit.push(data.payload.view);\n      }\n    },\n    [id, viewStackEmit.clear, viewStackEmit.push],\n  );\n  const handleToggle = useCallback(\n    (data: DrawerToggleEvent) => {\n      if (views.current.has(data?.payload?.view)) {\n        viewStackEmit.clear(id);\n        if (activeView !== data?.payload?.view) {\n          viewStackEmit.push(data.payload.view);\n        }\n      }\n    },\n    [id, activeView, viewStackEmit.clear, viewStackEmit.push],\n  );\n\n  useOn(DrawerEventTypes.open, handleOpen);\n  useOn(DrawerEventTypes.toggle, handleToggle);\n\n  return (\n    <DrawerContext.Provider\n      value={{\n        register: (view: UniqueId) => views.current.add(view),\n        unregister: (view: UniqueId) => views.current.delete(view),\n        placement,\n      }}\n    >\n      <ViewStack\n        id={id}\n        defaultView={defaultView}\n        onChange={(view) => {\n          setActiveView(view);\n          onChange?.(view);\n        }}\n      >\n        <div\n          {...rest}\n          className={clsx('group/drawer', styles.drawer, className)}\n          data-open={!!activeView || null}\n          data-placement={placement}\n          data-size={size}\n        >\n          {children}\n        </div>\n      </ViewStack>\n    </DrawerContext.Provider>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmDA,SAAgB,OAAO,EACrB,IACA,UACA,WACA,aACA,YAAY,QACZ,OAAO,UACP,UACA,GAAG,QACW;CACd,MAAM,QAAQ,uBAAO,IAAI,KAAe,CAAC;CACzC,MAAM,CAAC,YAAY,iBAAiB,SAClC,eAAe,KAChB;CAED,MAAM,gBAAgB,kBAAkB;CAExC,MAAM,aAAa,aAChB,SAA0B;AACzB,MAAI,MAAM,QAAQ,IAAI,MAAM,SAAS,KAAK,EAAE;AAC1C,iBAAc,MAAM,GAAG;AACvB,iBAAc,KAAK,KAAK,QAAQ,KAAK;;IAGzC;EAAC;EAAI,cAAc;EAAO,cAAc;EAAK,CAC9C;CACD,MAAM,eAAe,aAClB,SAA4B;AAC3B,MAAI,MAAM,QAAQ,IAAI,MAAM,SAAS,KAAK,EAAE;AAC1C,iBAAc,MAAM,GAAG;AACvB,OAAI,eAAe,MAAM,SAAS,KAChC,eAAc,KAAK,KAAK,QAAQ,KAAK;;IAI3C;EAAC;EAAI;EAAY,cAAc;EAAO,cAAc;EAAK,CAC1D;AAED,OAAM,iBAAiB,MAAM,WAAW;AACxC,OAAM,iBAAiB,QAAQ,aAAa;AAE5C,QACE,oBAAC,cAAc;EACb,OAAO;GACL,WAAW,SAAmB,MAAM,QAAQ,IAAI,KAAK;GACrD,aAAa,SAAmB,MAAM,QAAQ,OAAO,KAAK;GAC1D;GACD;YAED,oBAAC;GACK;GACS;GACb,WAAW,SAAS;AAClB,kBAAc,KAAK;AACnB,eAAW,KAAK;;aAGlB,oBAAC;IACC,GAAI;IACJ,WAAW,KAAK,gBAAgB,OAAO,QAAQ,UAAU;IACzD,aAAW,CAAC,CAAC,cAAc;IAC3B,kBAAgB;IAChB,aAAW;IAEV;KACG;IACI;GACW"}
+{"version":3,"file":"index.js","names":[],"sources":["../../../src/components/drawer/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 { useOn } from '@accelint/bus/react';\nimport { clsx } from '@accelint/design-foundation/lib/utils';\nimport type { UniqueId } from '@accelint/core';\nimport 'client-only';\nimport { useCallback, useRef, useState } from 'react';\nimport { ViewStack } from '../view-stack';\nimport { useViewStackEmit } from '../view-stack/context';\nimport { DrawerContext } from './context';\nimport { DrawerEventTypes } from './events';\nimport styles from './styles.module.css';\nimport type {\n  DrawerCloseEvent,\n  DrawerOpenEvent,\n  DrawerProps,\n  DrawerToggleEvent,\n} from './types';\n\n/**\n * Drawer - Slide-in panel for navigation or contextual content\n *\n * A flexible panel that slides in from the viewport edge and supports\n * stacked views, headers, footers, and programmatic triggers.\n *\n * @param props - {@link DrawerProps}\n * @param props.id - Unique identifier for the drawer.\n * @param props.children - Content to render inside the drawer.\n * @param props.className - Optional CSS class name.\n * @param props.defaultView - ID of the view to display initially.\n * @param props.placement - Edge of the viewport the drawer slides from.\n * @param props.size - Size of the drawer panel.\n * @param props.onChange - Callback when the active view changes.\n * @returns The rendered Drawer component.\n *\n * @example\n * ```tsx\n * const ids = { drawer: uuid(), a: uuid() };\n *\n * <DrawerLayout push=\"left\">\n *   <DrawerLayoutMain>\n *     <DrawerTrigger for={`open:${ids.a}`}>\n *       <Button variant=\"icon\">Open</Button>\n *     </DrawerTrigger>\n *   </DrawerLayoutMain>\n *\n *   <Drawer id={ids.drawer} defaultView={ids.a}>\n *     <DrawerPanel>\n *       <DrawerView id={ids.a}>\n *         <DrawerHeader title=\"Title A\" />\n *         <DrawerContent>Content for View A</DrawerContent>\n *       </DrawerView>\n *     </DrawerPanel>\n *   </Drawer>\n * </DrawerLayout>\n * ```\n */\nexport function Drawer({\n  id,\n  children,\n  className,\n  defaultView,\n  placement = 'left',\n  size = 'medium',\n  onChange,\n  ...rest\n}: DrawerProps) {\n  const views = useRef(new Set<UniqueId>());\n  const [activeView, setActiveView] = useState<UniqueId | null>(\n    defaultView || null,\n  );\n\n  const viewStackEmit = useViewStackEmit();\n\n  const handleClose = useCallback(\n    (data: DrawerCloseEvent) => {\n      if (\n        views.current.has(data?.payload?.view) ||\n        data?.payload?.view === id\n      ) {\n        viewStackEmit.clear(id);\n      }\n    },\n    [viewStackEmit.clear, id],\n  );\n  const handleOpen = useCallback(\n    (data: DrawerOpenEvent) => {\n      if (views.current.has(data?.payload?.view)) {\n        viewStackEmit.clear(id);\n        viewStackEmit.push(data.payload.view);\n      }\n    },\n    [id, viewStackEmit.clear, viewStackEmit.push],\n  );\n  const handleToggle = useCallback(\n    (data: DrawerToggleEvent) => {\n      if (views.current.has(data?.payload?.view)) {\n        viewStackEmit.clear(id);\n        if (activeView !== data?.payload?.view) {\n          viewStackEmit.push(data.payload.view);\n        }\n      }\n    },\n    [id, activeView, viewStackEmit.clear, viewStackEmit.push],\n  );\n\n  useOn(DrawerEventTypes.close, handleClose);\n  useOn(DrawerEventTypes.open, handleOpen);\n  useOn(DrawerEventTypes.toggle, handleToggle);\n\n  return (\n    <DrawerContext.Provider\n      value={{\n        register: (view: UniqueId) => views.current.add(view),\n        unregister: (view: UniqueId) => views.current.delete(view),\n        placement,\n      }}\n    >\n      <ViewStack\n        id={id}\n        defaultView={defaultView}\n        onChange={(view) => {\n          setActiveView(view);\n          onChange?.(view);\n        }}\n      >\n        <div\n          {...rest}\n          className={clsx('group/drawer', styles.drawer, className)}\n          data-open={!!activeView || null}\n          data-placement={placement}\n          data-size={size}\n        >\n          {children}\n        </div>\n      </ViewStack>\n    </DrawerContext.Provider>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAoEA,SAAgB,OAAO,EACrB,IACA,UACA,WACA,aACA,YAAY,QACZ,OAAO,UACP,UACA,GAAG,QACW;CACd,MAAM,QAAQ,uBAAO,IAAI,KAAe,CAAC;CACzC,MAAM,CAAC,YAAY,iBAAiB,SAClC,eAAe,KAChB;CAED,MAAM,gBAAgB,kBAAkB;CAExC,MAAM,cAAc,aACjB,SAA2B;AAC1B,MACE,MAAM,QAAQ,IAAI,MAAM,SAAS,KAAK,IACtC,MAAM,SAAS,SAAS,GAExB,eAAc,MAAM,GAAG;IAG3B,CAAC,cAAc,OAAO,GAAG,CAC1B;CACD,MAAM,aAAa,aAChB,SAA0B;AACzB,MAAI,MAAM,QAAQ,IAAI,MAAM,SAAS,KAAK,EAAE;AAC1C,iBAAc,MAAM,GAAG;AACvB,iBAAc,KAAK,KAAK,QAAQ,KAAK;;IAGzC;EAAC;EAAI,cAAc;EAAO,cAAc;EAAK,CAC9C;CACD,MAAM,eAAe,aAClB,SAA4B;AAC3B,MAAI,MAAM,QAAQ,IAAI,MAAM,SAAS,KAAK,EAAE;AAC1C,iBAAc,MAAM,GAAG;AACvB,OAAI,eAAe,MAAM,SAAS,KAChC,eAAc,KAAK,KAAK,QAAQ,KAAK;;IAI3C;EAAC;EAAI;EAAY,cAAc;EAAO,cAAc;EAAK,CAC1D;AAED,OAAM,iBAAiB,OAAO,YAAY;AAC1C,OAAM,iBAAiB,MAAM,WAAW;AACxC,OAAM,iBAAiB,QAAQ,aAAa;AAE5C,QACE,oBAAC,cAAc;EACb,OAAO;GACL,WAAW,SAAmB,MAAM,QAAQ,IAAI,KAAK;GACrD,aAAa,SAAmB,MAAM,QAAQ,OAAO,KAAK;GAC1D;GACD;YAED,oBAAC;GACK;GACS;GACb,WAAW,SAAS;AAClB,kBAAc,KAAK;AACnB,eAAW,KAAK;;aAGlB,oBAAC;IACC,GAAI;IACJ,WAAW,KAAK,gBAAgB,OAAO,QAAQ,UAAU;IACzD,aAAW,CAAC,CAAC,cAAc;IAC3B,kBAAgB;IAChB,aAAW;IAEV;KACG;IACI;GACW"}

package/dist/components/drawer/layout-main.d.ts

@@ -11,13 +11,34 @@
  */
 
 import { ComponentPropsWithRef } from "react";
-import * as react_jsx_runtime76 from "react/jsx-runtime";
+import * as react_jsx_runtime72 from "react/jsx-runtime";
 
 //#region src/components/drawer/layout-main.d.ts
+
+/**
+ * DrawerLayoutMain - Main content area within DrawerLayout.
+ *
+ * Responds to panel open/close states, adjusting layout based on
+ * the parent DrawerLayout's `push` configuration.
+ *
+ * @param props - ComponentPropsWithRef<'main'>
+ * @param props.className - Optional CSS class name.
+ * @returns The rendered DrawerLayoutMain component.
+ *
+ * @example
+ * ```tsx
+ * <DrawerLayout push="left">
+ *   <DrawerLayoutMain>
+ *     Main content here
+ *   </DrawerLayoutMain>
+ *   <Drawer placement="left">...</Drawer>
+ * </DrawerLayout>
+ * ```
+ */
 declare function DrawerLayoutMain({
   className,
   ...rest
-}: ComponentPropsWithRef<'main'>): react_jsx_runtime76.JSX.Element;
+}: ComponentPropsWithRef<'main'>): react_jsx_runtime72.JSX.Element;
 //#endregion
 export { DrawerLayoutMain };
 //# sourceMappingURL=layout-main.d.ts.map

package/dist/components/drawer/layout-main.js

@@ -16,6 +16,26 @@ import { jsx } from "react/jsx-runtime";
 import styles from "./styles.module.css";
 
 //#region src/components/drawer/layout-main.tsx
+/**
+* DrawerLayoutMain - Main content area within DrawerLayout.
+*
+* Responds to panel open/close states, adjusting layout based on
+* the parent DrawerLayout's `push` configuration.
+*
+* @param props - ComponentPropsWithRef<'main'>
+* @param props.className - Optional CSS class name.
+* @returns The rendered DrawerLayoutMain component.
+*
+* @example
+* ```tsx
+* <DrawerLayout push="left">
+*   <DrawerLayoutMain>
+*     Main content here
+*   </DrawerLayoutMain>
+*   <Drawer placement="left">...</Drawer>
+* </DrawerLayout>
+* ```
+*/
 function DrawerLayoutMain({ className, ...rest }) {
 	return /* @__PURE__ */ jsx("main", {
 		...rest,

package/dist/components/drawer/layout-main.js.map

@@ -1 +1 @@
-{"version":3,"file":"layout-main.js","names":[],"sources":["../../../src/components/drawer/layout-main.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 { clsx } from '@accelint/design-foundation/lib/utils';\nimport styles from './styles.module.css';\nimport type { ComponentPropsWithRef } from 'react';\n\nexport function DrawerLayoutMain({\n  className,\n  ...rest\n}: ComponentPropsWithRef<'main'>) {\n  return <main {...rest} className={clsx(styles.main, className)} />;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAeA,SAAgB,iBAAiB,EAC/B,WACA,GAAG,QAC6B;AAChC,QAAO,oBAAC;EAAK,GAAI;EAAM,WAAW,KAAK,OAAO,MAAM,UAAU;GAAI"}
+{"version":3,"file":"layout-main.js","names":[],"sources":["../../../src/components/drawer/layout-main.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 { clsx } from '@accelint/design-foundation/lib/utils';\nimport styles from './styles.module.css';\nimport type { ComponentPropsWithRef } from 'react';\n\n/**\n * DrawerLayoutMain - Main content area within DrawerLayout.\n *\n * Responds to panel open/close states, adjusting layout based on\n * the parent DrawerLayout's `push` configuration.\n *\n * @param props - ComponentPropsWithRef<'main'>\n * @param props.className - Optional CSS class name.\n * @returns The rendered DrawerLayoutMain component.\n *\n * @example\n * ```tsx\n * <DrawerLayout push=\"left\">\n *   <DrawerLayoutMain>\n *     Main content here\n *   </DrawerLayoutMain>\n *   <Drawer placement=\"left\">...</Drawer>\n * </DrawerLayout>\n * ```\n */\nexport function DrawerLayoutMain({\n  className,\n  ...rest\n}: ComponentPropsWithRef<'main'>) {\n  return <main {...rest} className={clsx(styles.main, className)} />;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmCA,SAAgB,iBAAiB,EAC/B,WACA,GAAG,QAC6B;AAChC,QAAO,oBAAC;EAAK,GAAI;EAAM,WAAW,KAAK,OAAO,MAAM,UAAU;GAAI"}

package/dist/components/drawer/layout.d.ts

@@ -11,15 +11,38 @@
  */
 
 import { DrawerLayoutProps } from "./types.js";
-import * as react_jsx_runtime78 from "react/jsx-runtime";
+import * as react_jsx_runtime110 from "react/jsx-runtime";
 
 //#region src/components/drawer/layout.d.ts
+
+/**
+ * DrawerLayout - CSS Grid layout container for positioning panels
+ *
+ * A shared layout primitive used by Drawer, Sidenav, and other panel components.
+ * Controls how panels are positioned relative to the main content area.
+ *
+ * @param props - {@link DrawerLayoutProps}
+ * @param props.className - Optional CSS class name.
+ * @param props.extend - Which drawers should extend to full container dimensions.
+ * @param props.push - Which drawers push the main content aside.
+ * @returns The rendered DrawerLayout component.
+ *
+ * @example
+ * ```tsx
+ * <DrawerLayout extend="left right" push="left">
+ *   <DrawerLayoutMain>
+ *     // Main content here
+ *   </DrawerLayoutMain>
+ *   <Drawer placement="left">...</Drawer>
+ * </DrawerLayout>
+ * ```
+ */
 declare function DrawerLayout({
   className,
   extend,
   push,
   ...rest
-}: DrawerLayoutProps): react_jsx_runtime78.JSX.Element;
+}: DrawerLayoutProps): react_jsx_runtime110.JSX.Element;
 //#endregion
 export { DrawerLayout };
 //# sourceMappingURL=layout.d.ts.map

package/dist/components/drawer/layout.js

@@ -16,6 +16,28 @@ import { jsx } from "react/jsx-runtime";
 import styles from "./styles.module.css";
 
 //#region src/components/drawer/layout.tsx
+/**
+* DrawerLayout - CSS Grid layout container for positioning panels
+*
+* A shared layout primitive used by Drawer, Sidenav, and other panel components.
+* Controls how panels are positioned relative to the main content area.
+*
+* @param props - {@link DrawerLayoutProps}
+* @param props.className - Optional CSS class name.
+* @param props.extend - Which drawers should extend to full container dimensions.
+* @param props.push - Which drawers push the main content aside.
+* @returns The rendered DrawerLayout component.
+*
+* @example
+* ```tsx
+* <DrawerLayout extend="left right" push="left">
+*   <DrawerLayoutMain>
+*     // Main content here
+*   </DrawerLayoutMain>
+*   <Drawer placement="left">...</Drawer>
+* </DrawerLayout>
+* ```
+*/
 function DrawerLayout({ className, extend = "left right", push, ...rest }) {
 	return /* @__PURE__ */ jsx("div", {
 		...rest,

package/dist/components/drawer/layout.js.map

@@ -1 +1 @@
-{"version":3,"file":"layout.js","names":[],"sources":["../../../src/components/drawer/layout.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 { clsx } from '@accelint/design-foundation/lib/utils';\nimport styles from './styles.module.css';\nimport type { DrawerLayoutProps } from './types';\n\nexport function DrawerLayout({\n  className,\n  extend = 'left right',\n  push,\n  ...rest\n}: DrawerLayoutProps) {\n  return (\n    <div\n      {...rest}\n      className={clsx('group/layout', styles.layout, className)}\n      data-extend={extend}\n      data-push={push || null}\n    />\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAeA,SAAgB,aAAa,EAC3B,WACA,SAAS,cACT,MACA,GAAG,QACiB;AACpB,QACE,oBAAC;EACC,GAAI;EACJ,WAAW,KAAK,gBAAgB,OAAO,QAAQ,UAAU;EACzD,eAAa;EACb,aAAW,QAAQ;GACnB"}
+{"version":3,"file":"layout.js","names":[],"sources":["../../../src/components/drawer/layout.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 { clsx } from '@accelint/design-foundation/lib/utils';\nimport styles from './styles.module.css';\nimport type { DrawerLayoutProps } from './types';\n\n/**\n * DrawerLayout - CSS Grid layout container for positioning panels\n *\n * A shared layout primitive used by Drawer, Sidenav, and other panel components.\n * Controls how panels are positioned relative to the main content area.\n *\n * @param props - {@link DrawerLayoutProps}\n * @param props.className - Optional CSS class name.\n * @param props.extend - Which drawers should extend to full container dimensions.\n * @param props.push - Which drawers push the main content aside.\n * @returns The rendered DrawerLayout component.\n *\n * @example\n * ```tsx\n * <DrawerLayout extend=\"left right\" push=\"left\">\n *   <DrawerLayoutMain>\n *     // Main content here\n *   </DrawerLayoutMain>\n *   <Drawer placement=\"left\">...</Drawer>\n * </DrawerLayout>\n * ```\n */\nexport function DrawerLayout({\n  className,\n  extend = 'left right',\n  push,\n  ...rest\n}: DrawerLayoutProps) {\n  return (\n    <div\n      {...rest}\n      className={clsx('group/layout', styles.layout, className)}\n      data-extend={extend}\n      data-push={push || null}\n    />\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAqCA,SAAgB,aAAa,EAC3B,WACA,SAAS,cACT,MACA,GAAG,QACiB;AACpB,QACE,oBAAC;EACC,GAAI;EACJ,WAAW,KAAK,gBAAgB,OAAO,QAAQ,UAAU;EACzD,eAAa;EACb,aAAW,QAAQ;GACnB"}

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

@@ -12,9 +12,32 @@
 
 import { DrawerMenuItemProps } from "./types.js";
 import "client-only";
-import * as react_jsx_runtime80 from "react/jsx-runtime";
+import * as react_jsx_runtime74 from "react/jsx-runtime";
 
 //#region src/components/drawer/menu-item.d.ts
+
+/**
+ * DrawerMenuItem - Individual navigation item within DrawerMenu.
+ *
+ * Renders as a toggle button with an icon and tooltip.
+ * The `for` prop specifies which view to navigate to.
+ * Use `toggle` prop to toggle the view open/closed instead of just opening.
+ *
+ * @param props - {@link DrawerMenuItemProps}
+ * @param props.for - The unique ID of the view to navigate to.
+ * @param props.children - Icon content to render inside the button.
+ * @param props.classNames - Optional class names for item and tooltip.
+ * @param props.toggle - Whether to toggle the view open/closed.
+ * @param props.textValue - Text for the tooltip.
+ * @returns The rendered DrawerMenuItem component, or null if outside a Drawer.
+ *
+ * @example
+ * ```tsx
+ * <DrawerMenuItem for={viewId} textValue="Settings">
+ *   <SettingsIcon />
+ * </DrawerMenuItem>
+ * ```
+ */
 declare function DrawerMenuItem({
   for: id,
   children,
@@ -22,7 +45,7 @@ declare function DrawerMenuItem({
   toggle,
   textValue,
   ...rest
-}: DrawerMenuItemProps): react_jsx_runtime80.JSX.Element | null;
+}: DrawerMenuItemProps): react_jsx_runtime74.JSX.Element | null;
 //#endregion
 export { DrawerMenuItem };
 //# sourceMappingURL=menu-item.d.ts.map

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

@@ -34,6 +34,28 @@ const tooltipPlacementMap = {
 	top: "bottom",
 	bottom: "top"
 };
+/**
+* DrawerMenuItem - Individual navigation item within DrawerMenu.
+*
+* Renders as a toggle button with an icon and tooltip.
+* The `for` prop specifies which view to navigate to.
+* Use `toggle` prop to toggle the view open/closed instead of just opening.
+*
+* @param props - {@link DrawerMenuItemProps}
+* @param props.for - The unique ID of the view to navigate to.
+* @param props.children - Icon content to render inside the button.
+* @param props.classNames - Optional class names for item and tooltip.
+* @param props.toggle - Whether to toggle the view open/closed.
+* @param props.textValue - Text for the tooltip.
+* @returns The rendered DrawerMenuItem component, or null if outside a Drawer.
+*
+* @example
+* ```tsx
+* <DrawerMenuItem for={viewId} textValue="Settings">
+*   <SettingsIcon />
+* </DrawerMenuItem>
+* ```
+*/
 function DrawerMenuItem({ for: id, children, classNames, toggle, textValue, ...rest }) {
 	const { parent, stack } = useContext(ViewStackContext);
 	const { placement } = useContext(DrawerContext);

package/dist/components/drawer/menu-item.js.map

@@ -1 +1 @@
-{"version":3,"file":"menu-item.js","names":["TooltipTrigger","ToggleButton","children","Tooltip"],"sources":["../../../src/components/drawer/menu-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\n'use client';\n\nimport 'client-only';\nimport { clsx } from '@accelint/design-foundation/lib/utils';\nimport { useContext, useRef } from 'react';\nimport { composeRenderProps } from 'react-aria-components';\nimport { ToggleButton } from '../button/toggle';\nimport { Icon } from '../icon';\nimport { Tooltip } from '../tooltip';\nimport { TooltipTrigger } from '../tooltip/trigger';\nimport { ViewStackContext } from '../view-stack/context';\nimport { DrawerContext } from './context';\nimport styles from './styles.module.css';\nimport { DrawerTrigger } from './trigger';\nimport type { DrawerMenuItemProps } from './types';\n\nconst tooltipPlacementMap = {\n  left: 'right',\n  right: 'left',\n  top: 'bottom',\n  bottom: 'top',\n} as const;\n\nexport function DrawerMenuItem({\n  for: id,\n  children,\n  classNames,\n  toggle,\n  textValue,\n  ...rest\n}: DrawerMenuItemProps) {\n  const { parent, stack } = useContext(ViewStackContext);\n  const { placement } = useContext(DrawerContext);\n  const view = stack.at(-1);\n  const action = toggle ? 'toggle' : 'open';\n  const tooltipRef = useRef(null);\n\n  if (!parent) {\n    return null;\n  }\n\n  return (\n    <TooltipTrigger>\n      <DrawerTrigger for={`${action}:${id}`}>\n        <ToggleButton\n          ref={tooltipRef}\n          className={composeRenderProps(classNames?.item, (className) =>\n            clsx(styles.item, className),\n          )}\n          color='accent'\n          role='tab'\n          variant='icon'\n          isSelected={id === view || (stack.length > 1 && stack.includes(id))}\n          {...rest}\n        >\n          {composeRenderProps(children, (children) => (\n            <Icon>{children}</Icon>\n          ))}\n        </ToggleButton>\n      </DrawerTrigger>\n      <Tooltip\n        triggerRef={tooltipRef}\n        placement={tooltipPlacementMap[placement]}\n        offset={6}\n        className={classNames?.tooltip}\n      >\n        {textValue}\n      </Tooltip>\n    </TooltipTrigger>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA4BA,MAAM,sBAAsB;CAC1B,MAAM;CACN,OAAO;CACP,KAAK;CACL,QAAQ;CACT;AAED,SAAgB,eAAe,EAC7B,KAAK,IACL,UACA,YACA,QACA,WACA,GAAG,QACmB;CACtB,MAAM,EAAE,QAAQ,UAAU,WAAW,iBAAiB;CACtD,MAAM,EAAE,cAAc,WAAW,cAAc;CAC/C,MAAM,OAAO,MAAM,GAAG,GAAG;CACzB,MAAM,SAAS,SAAS,WAAW;CACnC,MAAM,aAAa,OAAO,KAAK;AAE/B,KAAI,CAAC,OACH,QAAO;AAGT,QACE,qBAACA,+BACC,oBAAC;EAAc,KAAK,GAAG,OAAO,GAAG;YAC/B,oBAACC;GACC,KAAK;GACL,WAAW,mBAAmB,YAAY,OAAO,cAC/C,KAAK,OAAO,MAAM,UAAU,CAC7B;GACD,OAAM;GACN,MAAK;GACL,SAAQ;GACR,YAAY,OAAO,QAAS,MAAM,SAAS,KAAK,MAAM,SAAS,GAAG;GAClE,GAAI;aAEH,mBAAmB,WAAW,eAC7B,oBAAC,kBAAMC,aAAgB,CACvB;IACW;GACD,EAChB,oBAACC;EACC,YAAY;EACZ,WAAW,oBAAoB;EAC/B,QAAQ;EACR,WAAW,YAAY;YAEtB;GACO,IACK"}
+{"version":3,"file":"menu-item.js","names":["TooltipTrigger","ToggleButton","children","Tooltip"],"sources":["../../../src/components/drawer/menu-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\n'use client';\n\nimport 'client-only';\nimport { clsx } from '@accelint/design-foundation/lib/utils';\nimport { useContext, useRef } from 'react';\nimport { composeRenderProps } from 'react-aria-components';\nimport { ToggleButton } from '../button/toggle';\nimport { Icon } from '../icon';\nimport { Tooltip } from '../tooltip';\nimport { TooltipTrigger } from '../tooltip/trigger';\nimport { ViewStackContext } from '../view-stack/context';\nimport { DrawerContext } from './context';\nimport styles from './styles.module.css';\nimport { DrawerTrigger } from './trigger';\nimport type { DrawerMenuItemProps } from './types';\n\nconst tooltipPlacementMap = {\n  left: 'right',\n  right: 'left',\n  top: 'bottom',\n  bottom: 'top',\n} as const;\n\n/**\n * DrawerMenuItem - Individual navigation item within DrawerMenu.\n *\n * Renders as a toggle button with an icon and tooltip.\n * The `for` prop specifies which view to navigate to.\n * Use `toggle` prop to toggle the view open/closed instead of just opening.\n *\n * @param props - {@link DrawerMenuItemProps}\n * @param props.for - The unique ID of the view to navigate to.\n * @param props.children - Icon content to render inside the button.\n * @param props.classNames - Optional class names for item and tooltip.\n * @param props.toggle - Whether to toggle the view open/closed.\n * @param props.textValue - Text for the tooltip.\n * @returns The rendered DrawerMenuItem component, or null if outside a Drawer.\n *\n * @example\n * ```tsx\n * <DrawerMenuItem for={viewId} textValue=\"Settings\">\n *   <SettingsIcon />\n * </DrawerMenuItem>\n * ```\n */\nexport function DrawerMenuItem({\n  for: id,\n  children,\n  classNames,\n  toggle,\n  textValue,\n  ...rest\n}: DrawerMenuItemProps) {\n  const { parent, stack } = useContext(ViewStackContext);\n  const { placement } = useContext(DrawerContext);\n  const view = stack.at(-1);\n  const action = toggle ? 'toggle' : 'open';\n  const tooltipRef = useRef(null);\n\n  if (!parent) {\n    return null;\n  }\n\n  return (\n    <TooltipTrigger>\n      <DrawerTrigger for={`${action}:${id}`}>\n        <ToggleButton\n          ref={tooltipRef}\n          className={composeRenderProps(classNames?.item, (className) =>\n            clsx(styles.item, className),\n          )}\n          color='accent'\n          role='tab'\n          variant='icon'\n          isSelected={id === view || (stack.length > 1 && stack.includes(id))}\n          {...rest}\n        >\n          {composeRenderProps(children, (children) => (\n            <Icon>{children}</Icon>\n          ))}\n        </ToggleButton>\n      </DrawerTrigger>\n      <Tooltip\n        triggerRef={tooltipRef}\n        placement={tooltipPlacementMap[placement]}\n        offset={6}\n        className={classNames?.tooltip}\n      >\n        {textValue}\n      </Tooltip>\n    </TooltipTrigger>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA4BA,MAAM,sBAAsB;CAC1B,MAAM;CACN,OAAO;CACP,KAAK;CACL,QAAQ;CACT;;;;;;;;;;;;;;;;;;;;;;;AAwBD,SAAgB,eAAe,EAC7B,KAAK,IACL,UACA,YACA,QACA,WACA,GAAG,QACmB;CACtB,MAAM,EAAE,QAAQ,UAAU,WAAW,iBAAiB;CACtD,MAAM,EAAE,cAAc,WAAW,cAAc;CAC/C,MAAM,OAAO,MAAM,GAAG,GAAG;CACzB,MAAM,SAAS,SAAS,WAAW;CACnC,MAAM,aAAa,OAAO,KAAK;AAE/B,KAAI,CAAC,OACH,QAAO;AAGT,QACE,qBAACA,+BACC,oBAAC;EAAc,KAAK,GAAG,OAAO,GAAG;YAC/B,oBAACC;GACC,KAAK;GACL,WAAW,mBAAmB,YAAY,OAAO,cAC/C,KAAK,OAAO,MAAM,UAAU,CAC7B;GACD,OAAM;GACN,MAAK;GACL,SAAQ;GACR,YAAY,OAAO,QAAS,MAAM,SAAS,KAAK,MAAM,SAAS,GAAG;GAClE,GAAI;aAEH,mBAAmB,WAAW,eAC7B,oBAAC,kBAAMC,aAAgB,CACvB;IACW;GACD,EAChB,oBAACC;EACC,YAAY;EACZ,WAAW,oBAAoB;EAC/B,QAAQ;EACR,WAAW,YAAY;YAEtB;GACO,IACK"}

package/dist/components/drawer/menu.d.ts

@@ -11,15 +11,35 @@
  */
 
 import { DrawerMenuProps } from "./types.js";
-import * as react_jsx_runtime83 from "react/jsx-runtime";
+import * as react_jsx_runtime75 from "react/jsx-runtime";
 
 //#region src/components/drawer/menu.d.ts
+
+/**
+ * DrawerMenu - Navigation menu for switching between drawer views.
+ *
+ * Contains DrawerMenuItem components. Renders as a semantic `<nav>` element.
+ *
+ * @param props - {@link DrawerMenuProps}
+ * @param props.className - Optional CSS class name.
+ * @param props.position - Position of the menu within the layout.
+ * @param props.children - DrawerMenuItem components to render.
+ * @returns The rendered DrawerMenu component.
+ *
+ * @example
+ * ```tsx
+ * <DrawerMenu position="center">
+ *   <DrawerMenuItem for={viewA}>View A</DrawerMenuItem>
+ *   <DrawerMenuItem for={viewB}>View B</DrawerMenuItem>
+ * </DrawerMenu>
+ * ```
+ */
 declare function DrawerMenu({
   className,
   position,
   children,
   ...rest
-}: DrawerMenuProps): react_jsx_runtime83.JSX.Element;
+}: DrawerMenuProps): react_jsx_runtime75.JSX.Element;
 //#endregion
 export { DrawerMenu };
 //# sourceMappingURL=menu.d.ts.map

package/dist/components/drawer/menu.js

@@ -16,6 +16,25 @@ import { jsx } from "react/jsx-runtime";
 import styles from "./styles.module.css";
 
 //#region src/components/drawer/menu.tsx
+/**
+* DrawerMenu - Navigation menu for switching between drawer views.
+*
+* Contains DrawerMenuItem components. Renders as a semantic `<nav>` element.
+*
+* @param props - {@link DrawerMenuProps}
+* @param props.className - Optional CSS class name.
+* @param props.position - Position of the menu within the layout.
+* @param props.children - DrawerMenuItem components to render.
+* @returns The rendered DrawerMenu component.
+*
+* @example
+* ```tsx
+* <DrawerMenu position="center">
+*   <DrawerMenuItem for={viewA}>View A</DrawerMenuItem>
+*   <DrawerMenuItem for={viewB}>View B</DrawerMenuItem>
+* </DrawerMenu>
+* ```
+*/
 function DrawerMenu({ className, position = "center", children, ...rest }) {
 	return /* @__PURE__ */ jsx("nav", {
 		...rest,

package/dist/components/drawer/menu.js.map

@@ -1 +1 @@
-{"version":3,"file":"menu.js","names":[],"sources":["../../../src/components/drawer/menu.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 { clsx } from '@accelint/design-foundation/lib/utils';\nimport styles from './styles.module.css';\nimport type { DrawerMenuProps } from './types';\n\nexport function DrawerMenu({\n  className,\n  position = 'center',\n  children,\n  ...rest\n}: DrawerMenuProps) {\n  return (\n    <nav {...rest} className={clsx(styles.menu, styles[position], className)}>\n      {children}\n    </nav>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAeA,SAAgB,WAAW,EACzB,WACA,WAAW,UACX,UACA,GAAG,QACe;AAClB,QACE,oBAAC;EAAI,GAAI;EAAM,WAAW,KAAK,OAAO,MAAM,OAAO,WAAW,UAAU;EACrE;GACG"}
+{"version":3,"file":"menu.js","names":[],"sources":["../../../src/components/drawer/menu.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 { clsx } from '@accelint/design-foundation/lib/utils';\nimport styles from './styles.module.css';\nimport type { DrawerMenuProps } from './types';\n\n/**\n * DrawerMenu - Navigation menu for switching between drawer views.\n *\n * Contains DrawerMenuItem components. Renders as a semantic `<nav>` element.\n *\n * @param props - {@link DrawerMenuProps}\n * @param props.className - Optional CSS class name.\n * @param props.position - Position of the menu within the layout.\n * @param props.children - DrawerMenuItem components to render.\n * @returns The rendered DrawerMenu component.\n *\n * @example\n * ```tsx\n * <DrawerMenu position=\"center\">\n *   <DrawerMenuItem for={viewA}>View A</DrawerMenuItem>\n *   <DrawerMenuItem for={viewB}>View B</DrawerMenuItem>\n * </DrawerMenu>\n * ```\n */\nexport function DrawerMenu({\n  className,\n  position = 'center',\n  children,\n  ...rest\n}: DrawerMenuProps) {\n  return (\n    <nav {...rest} className={clsx(styles.menu, styles[position], className)}>\n      {children}\n    </nav>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAkCA,SAAgB,WAAW,EACzB,WACA,WAAW,UACX,UACA,GAAG,QACe;AAClB,QACE,oBAAC;EAAI,GAAI;EAAM,WAAW,KAAK,OAAO,MAAM,OAAO,WAAW,UAAU;EACrE;GACG"}

package/dist/components/drawer/panel.d.ts

@@ -11,13 +11,32 @@
  */
 
 import { ComponentPropsWithRef } from "react";
-import * as react_jsx_runtime32 from "react/jsx-runtime";
+import * as react_jsx_runtime76 from "react/jsx-runtime";
 
 //#region src/components/drawer/panel.d.ts
+
+/**
+ * DrawerPanel - Main panel container for drawer content.
+ *
+ * Contains DrawerView components. Only one DrawerPanel allowed per Drawer.
+ *
+ * @param props - ComponentPropsWithRef<'div'>
+ * @param props.className - Optional CSS class name.
+ * @returns The rendered DrawerPanel component.
+ *
+ * @example
+ * ```tsx
+ * <Drawer id={drawerId} defaultView={viewId}>
+ *   <DrawerPanel>
+ *     <DrawerView id={viewId}>...</DrawerView>
+ *   </DrawerPanel>
+ * </Drawer>
+ * ```
+ */
 declare function DrawerPanel({
   className,
   ...rest
-}: ComponentPropsWithRef<'div'>): react_jsx_runtime32.JSX.Element;
+}: ComponentPropsWithRef<'div'>): react_jsx_runtime76.JSX.Element;
 //#endregion
 export { DrawerPanel };
 //# sourceMappingURL=panel.d.ts.map