@accelint/design-toolkit 9.3.0 → 9.4.0

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_runtime51 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_runtime51.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_runtime54 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_runtime54.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_runtime66 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_runtime66.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_runtime67 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_runtime67.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_runtime82 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_runtime82.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_runtime69 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_runtime69.JSX.Element;
 //#endregion
 export { DrawerPanel };
 //# sourceMappingURL=panel.d.ts.map

package/dist/components/drawer/panel.js

@@ -16,6 +16,24 @@ import { jsx } from "react/jsx-runtime";
 import styles from "./styles.module.css";
 
 //#region src/components/drawer/panel.tsx
+/**
+* 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>
+* ```
+*/
 function DrawerPanel({ className, ...rest }) {
 	return /* @__PURE__ */ jsx("div", {
 		...rest,

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

@@ -1 +1 @@
-{"version":3,"file":"panel.js","names":[],"sources":["../../../src/components/drawer/panel.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 DrawerPanel({\n  className,\n  ...rest\n}: ComponentPropsWithRef<'div'>) {\n  return <div {...rest} className={clsx(styles.panel, className)} />;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAeA,SAAgB,YAAY,EAC1B,WACA,GAAG,QAC4B;AAC/B,QAAO,oBAAC;EAAI,GAAI;EAAM,WAAW,KAAK,OAAO,OAAO,UAAU;GAAI"}
+{"version":3,"file":"panel.js","names":[],"sources":["../../../src/components/drawer/panel.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 * DrawerPanel - Main panel container for drawer content.\n *\n * Contains DrawerView components. Only one DrawerPanel allowed per Drawer.\n *\n * @param props - ComponentPropsWithRef<'div'>\n * @param props.className - Optional CSS class name.\n * @returns The rendered DrawerPanel component.\n *\n * @example\n * ```tsx\n * <Drawer id={drawerId} defaultView={viewId}>\n *   <DrawerPanel>\n *     <DrawerView id={viewId}>...</DrawerView>\n *   </DrawerPanel>\n * </Drawer>\n * ```\n */\nexport function DrawerPanel({\n  className,\n  ...rest\n}: ComponentPropsWithRef<'div'>) {\n  return <div {...rest} className={clsx(styles.panel, className)} />;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAiCA,SAAgB,YAAY,EAC1B,WACA,GAAG,QAC4B;AAC/B,QAAO,oBAAC;EAAI,GAAI;EAAM,WAAW,KAAK,OAAO,OAAO,UAAU;GAAI"}

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

@@ -12,13 +12,42 @@
 
 import { DrawerTriggerProps } from "./types.js";
 import "client-only";
-import * as react_jsx_runtime34 from "react/jsx-runtime";
+import * as react_jsx_runtime71 from "react/jsx-runtime";
 
 //#region src/components/drawer/trigger.d.ts
+
+/**
+ * DrawerTrigger - Programmatic trigger for drawer actions.
+ *
+ * The `for` prop controls the behavior:
+ * - `'open'`, `'toggle'`, `'close'`: Control drawer open state
+ * - `'back'`: Pop the current view from the stack
+ * - `UniqueId`: Push a specific view onto the stack
+ * - `'action:viewId'`: Combine action with view ID (e.g., `'open:${viewId}'`)
+ * - `Array`: Fire multiple events in sequence
+ *
+ * @param props - {@link DrawerTriggerProps}
+ * @param props.for - The event(s) to fire when the trigger is pressed.
+ * @returns The rendered DrawerTrigger component.
+ *
+ * @example
+ * ```tsx
+ * <DrawerTrigger for="close">
+ *   <Button>Close</Button>
+ * </DrawerTrigger>
+ * ```
+
+ * @example
+ * ```tsx
+ * <DrawerTrigger for={`open:${viewId}`}>
+ *   <Button>Open Settings</Button>
+ * </DrawerTrigger>
+ * ```
+ */
 declare function DrawerTrigger({
   for: events,
   ...rest
-}: DrawerTriggerProps): react_jsx_runtime34.JSX.Element;
+}: DrawerTriggerProps): react_jsx_runtime71.JSX.Element;
 //#endregion
 export { DrawerTrigger };
 //# sourceMappingURL=trigger.d.ts.map

package/dist/components/drawer/trigger.js

@@ -18,10 +18,38 @@ import { useDrawerEmit } from "./context.js";
 import "client-only";
 import { useContext } from "react";
 import { jsx } from "react/jsx-runtime";
-import { Pressable } from "@react-aria/interactions";
 import { isUUID } from "@accelint/core";
+import { Pressable } from "@react-aria/interactions";
 
 //#region src/components/drawer/trigger.tsx
+/**
+* DrawerTrigger - Programmatic trigger for drawer actions.
+*
+* The `for` prop controls the behavior:
+* - `'open'`, `'toggle'`, `'close'`: Control drawer open state
+* - `'back'`: Pop the current view from the stack
+* - `UniqueId`: Push a specific view onto the stack
+* - `'action:viewId'`: Combine action with view ID (e.g., `'open:${viewId}'`)
+* - `Array`: Fire multiple events in sequence
+*
+* @param props - {@link DrawerTriggerProps}
+* @param props.for - The event(s) to fire when the trigger is pressed.
+* @returns The rendered DrawerTrigger component.
+*
+* @example
+* ```tsx
+* <DrawerTrigger for="close">
+*   <Button>Close</Button>
+* </DrawerTrigger>
+* ```
+
+* @example
+* ```tsx
+* <DrawerTrigger for={`open:${viewId}`}>
+*   <Button>Open Settings</Button>
+* </DrawerTrigger>
+* ```
+*/
 function DrawerTrigger({ for: events, ...rest }) {
 	const { parent } = useContext(ViewStackContext);
 	const drawerEmit = useDrawerEmit();

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

@@ -1 +1 @@
-{"version":3,"file":"trigger.js","names":[],"sources":["../../../src/components/drawer/trigger.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 { isUUID, type UniqueId } from '@accelint/core';\nimport { Pressable } from '@react-aria/interactions';\nimport { useContext } from 'react';\nimport { ViewStackContext } from '../view-stack/context';\nimport { useDrawerEmit } from './context';\nimport type { DrawerTriggerProps } from './types';\n\nexport function DrawerTrigger({ for: events, ...rest }: DrawerTriggerProps) {\n  const { parent } = useContext(ViewStackContext);\n  const drawerEmit = useDrawerEmit();\n\n  function handlePress() {\n    for (const type of Array.isArray(events) ? events : [events]) {\n      let [event, id] = (isUUID(type) ? ['push', type] : type.split(':')) as [\n        'back' | 'clear' | 'close' | 'open' | 'push' | 'reset' | 'toggle',\n        UniqueId | undefined | null,\n      ];\n\n      id ??= parent;\n\n      if (!id) {\n        continue;\n      }\n\n      drawerEmit[event](id);\n    }\n  }\n\n  return <Pressable {...rest} onPress={handlePress} />;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AAqBA,SAAgB,cAAc,EAAE,KAAK,QAAQ,GAAG,QAA4B;CAC1E,MAAM,EAAE,WAAW,WAAW,iBAAiB;CAC/C,MAAM,aAAa,eAAe;CAElC,SAAS,cAAc;AACrB,OAAK,MAAM,QAAQ,MAAM,QAAQ,OAAO,GAAG,SAAS,CAAC,OAAO,EAAE;GAC5D,IAAI,CAAC,OAAO,MAAO,OAAO,KAAK,GAAG,CAAC,QAAQ,KAAK,GAAG,KAAK,MAAM,IAAI;AAKlE,UAAO;AAEP,OAAI,CAAC,GACH;AAGF,cAAW,OAAO,GAAG;;;AAIzB,QAAO,oBAAC;EAAU,GAAI;EAAM,SAAS;GAAe"}
+{"version":3,"file":"trigger.js","names":[],"sources":["../../../src/components/drawer/trigger.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 { isUUID, type UniqueId } from '@accelint/core';\nimport { Pressable } from '@react-aria/interactions';\nimport 'client-only';\nimport { useContext } from 'react';\nimport { ViewStackContext } from '../view-stack/context';\nimport { useDrawerEmit } from './context';\nimport type { DrawerTriggerProps } from './types';\n\n/**\n * DrawerTrigger - Programmatic trigger for drawer actions.\n *\n * The `for` prop controls the behavior:\n * - `'open'`, `'toggle'`, `'close'`: Control drawer open state\n * - `'back'`: Pop the current view from the stack\n * - `UniqueId`: Push a specific view onto the stack\n * - `'action:viewId'`: Combine action with view ID (e.g., `'open:${viewId}'`)\n * - `Array`: Fire multiple events in sequence\n *\n * @param props - {@link DrawerTriggerProps}\n * @param props.for - The event(s) to fire when the trigger is pressed.\n * @returns The rendered DrawerTrigger component.\n *\n * @example\n * ```tsx\n * <DrawerTrigger for=\"close\">\n *   <Button>Close</Button>\n * </DrawerTrigger>\n * ```\n\n * @example\n * ```tsx\n * <DrawerTrigger for={`open:${viewId}`}>\n *   <Button>Open Settings</Button>\n * </DrawerTrigger>\n * ```\n */\nexport function DrawerTrigger({ for: events, ...rest }: DrawerTriggerProps) {\n  const { parent } = useContext(ViewStackContext);\n  const drawerEmit = useDrawerEmit();\n\n  function handlePress() {\n    for (const type of Array.isArray(events) ? events : [events]) {\n      let [event, id] = (isUUID(type) ? ['push', type] : type.split(':')) as [\n        'back' | 'clear' | 'close' | 'open' | 'push' | 'reset' | 'toggle',\n        UniqueId | undefined | null,\n      ];\n\n      id ??= parent;\n\n      if (!id) {\n        continue;\n      }\n\n      drawerEmit[event](id);\n    }\n  }\n\n  return <Pressable {...rest} onPress={handlePress} />;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAiDA,SAAgB,cAAc,EAAE,KAAK,QAAQ,GAAG,QAA4B;CAC1E,MAAM,EAAE,WAAW,WAAW,iBAAiB;CAC/C,MAAM,aAAa,eAAe;CAElC,SAAS,cAAc;AACrB,OAAK,MAAM,QAAQ,MAAM,QAAQ,OAAO,GAAG,SAAS,CAAC,OAAO,EAAE;GAC5D,IAAI,CAAC,OAAO,MAAO,OAAO,KAAK,GAAG,CAAC,QAAQ,KAAK,GAAG,KAAK,MAAM,IAAI;AAKlE,UAAO;AAEP,OAAI,CAAC,GACH;AAGF,cAAW,OAAO,GAAG;;;AAIzB,QAAO,oBAAC;EAAU,GAAI;EAAM,SAAS;GAAe"}