@accelint/design-toolkit 9.2.0 → 9.4.0

package/dist/components/dialog/title.js

@@ -20,6 +20,24 @@ import { jsx } from "react/jsx-runtime";
 import styles from "./styles.module.css";
 
 //#region src/components/dialog/title.tsx
+/**
+* DialogTitle - Semantic heading element for dialog titles.
+*
+* Renders as an `<h2>` element with the `title` slot for accessibility.
+*
+* @param props - The dialog title props.
+* @param props.children - Title text content.
+* @param props.className - Additional CSS class name.
+* @returns The dialog title component.
+*
+* @example
+* ```tsx
+* <Dialog>
+*   <DialogTitle>Confirm Action</DialogTitle>
+*   <DialogContent>...</DialogContent>
+* </Dialog>
+* ```
+*/
 function DialogTitle({ children, className }) {
 	return /* @__PURE__ */ jsx(Heading, {
 		slot: "title",

package/dist/components/dialog/title.js.map

@@ -1 +1 @@
-{"version":3,"file":"title.js","names":[],"sources":["../../../src/components/dialog/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'use client';\n\nimport 'client-only';\nimport { clsx } from '@accelint/design-foundation/lib/utils';\nimport { Heading, type HeadingProps } from 'react-aria-components';\nimport styles from './styles.module.css';\n\nexport function DialogTitle({ children, className }: HeadingProps) {\n  return (\n    <Heading slot='title' className={clsx(styles.title, className)}>\n      {children}\n    </Heading>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAkBA,SAAgB,YAAY,EAAE,UAAU,aAA2B;AACjE,QACE,oBAAC;EAAQ,MAAK;EAAQ,WAAW,KAAK,OAAO,OAAO,UAAU;EAC3D;GACO"}
+{"version":3,"file":"title.js","names":[],"sources":["../../../src/components/dialog/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'use client';\n\nimport 'client-only';\nimport { clsx } from '@accelint/design-foundation/lib/utils';\nimport { Heading, type HeadingProps } from 'react-aria-components';\nimport styles from './styles.module.css';\n\n/**\n * DialogTitle - Semantic heading element for dialog titles.\n *\n * Renders as an `<h2>` element with the `title` slot for accessibility.\n *\n * @param props - The dialog title props.\n * @param props.children - Title text content.\n * @param props.className - Additional CSS class name.\n * @returns The dialog title component.\n *\n * @example\n * ```tsx\n * <Dialog>\n *   <DialogTitle>Confirm Action</DialogTitle>\n *   <DialogContent>...</DialogContent>\n * </Dialog>\n * ```\n */\nexport function DialogTitle({ children, className }: HeadingProps) {\n  return (\n    <Heading slot='title' className={clsx(styles.title, className)}>\n      {children}\n    </Heading>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAoCA,SAAgB,YAAY,EAAE,UAAU,aAA2B;AACjE,QACE,oBAAC;EAAQ,MAAK;EAAQ,WAAW,KAAK,OAAO,OAAO,UAAU;EAC3D;GACO"}

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

@@ -14,6 +14,24 @@ import "client-only";
 import { DialogTrigger as DialogTrigger$1 } from "react-aria-components";
 
 //#region src/components/dialog/trigger.d.ts
+
+/**
+ * DialogTrigger - Manages dialog open/close state and trigger behavior.
+ *
+ * Wraps a trigger element (typically a Button) and a Dialog component.
+ * Handles accessibility attributes and focus management automatically.
+ *
+ * @example
+ * ```tsx
+ * <DialogTrigger>
+ *   <Button>Open Dialog</Button>
+ *   <Dialog>
+ *     <DialogTitle>Title</DialogTitle>
+ *     <DialogContent>Content</DialogContent>
+ *   </Dialog>
+ * </DialogTrigger>
+ * ```
+ */
 declare const DialogTrigger: typeof DialogTrigger$1;
 //#endregion
 export { DialogTrigger };

package/dist/components/dialog/trigger.js

@@ -17,6 +17,23 @@ import "client-only";
 import { DialogTrigger as DialogTrigger$1 } from "react-aria-components";
 
 //#region src/components/dialog/trigger.tsx
+/**
+* DialogTrigger - Manages dialog open/close state and trigger behavior.
+*
+* Wraps a trigger element (typically a Button) and a Dialog component.
+* Handles accessibility attributes and focus management automatically.
+*
+* @example
+* ```tsx
+* <DialogTrigger>
+*   <Button>Open Dialog</Button>
+*   <Dialog>
+*     <DialogTitle>Title</DialogTitle>
+*     <DialogContent>Content</DialogContent>
+*   </Dialog>
+* </DialogTrigger>
+* ```
+*/
 const DialogTrigger = DialogTrigger$1;
 
 //#endregion

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

@@ -1 +1 @@
-{"version":3,"file":"trigger.js","names":["AriaDialogTrigger"],"sources":["../../../src/components/dialog/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 { DialogTrigger as AriaDialogTrigger } from 'react-aria-components';\n\nexport const DialogTrigger = AriaDialogTrigger;\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAgBA,MAAa,gBAAgBA"}
+{"version":3,"file":"trigger.js","names":["AriaDialogTrigger"],"sources":["../../../src/components/dialog/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 { DialogTrigger as AriaDialogTrigger } from 'react-aria-components';\n\n/**\n * DialogTrigger - Manages dialog open/close state and trigger behavior.\n *\n * Wraps a trigger element (typically a Button) and a Dialog component.\n * Handles accessibility attributes and focus management automatically.\n *\n * @example\n * ```tsx\n * <DialogTrigger>\n *   <Button>Open Dialog</Button>\n *   <Dialog>\n *     <DialogTitle>Title</DialogTitle>\n *     <DialogContent>Content</DialogContent>\n *   </Dialog>\n * </DialogTrigger>\n * ```\n */\nexport const DialogTrigger = AriaDialogTrigger;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAiCA,MAAa,gBAAgBA"}

package/dist/components/dialog/types.d.ts

@@ -14,15 +14,27 @@ import { RefAttributes, RefObject } from "react";
 import { DialogProps as DialogProps$1, DialogTriggerProps as DialogTriggerProps$1, ModalOverlayProps } from "react-aria-components";
 
 //#region src/components/dialog/types.d.ts
+/**
+ * Props for the Dialog component.
+ */
 type DialogProps = Omit<ModalOverlayProps, 'children' | 'className'> & Pick<DialogProps$1, 'children'> & RefAttributes<HTMLDivElement> & {
+  /** Custom class names for sub-elements. */
   classNames?: {
+    /** Class name for the overlay backdrop. */
     overlay?: ModalOverlayProps['className'];
+    /** Class name for the modal container. */
     modal?: ModalOverlayProps['className'];
+    /** Class name for the dialog element. */
     dialog?: DialogProps$1['className'];
   };
+  /** Reference to parent element for portal rendering. */
   parentRef?: RefObject<HTMLElement | null>;
+  /** Size variant of the dialog. */
   size?: 'small' | 'large';
 };
+/**
+ * Props for the DialogTrigger component.
+ */
 type DialogTriggerProps = DialogTriggerProps$1;
 //#endregion
 export { DialogProps, DialogTriggerProps };

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

@@ -13,16 +13,36 @@
 import { ProviderProps } from "../../lib/types.js";
 import { DividerProps } from "./types.js";
 import "client-only";
-import * as react45 from "react";
+import * as react16 from "react";
 import { ContextValue } from "react-aria-components";
-import * as react_jsx_runtime175 from "react/jsx-runtime";
+import * as react_jsx_runtime41 from "react/jsx-runtime";
 
 //#region src/components/divider/context.d.ts
-declare const DividerContext: react45.Context<ContextValue<DividerProps, HTMLHRElement>>;
+/**
+ * Context for sharing Divider props across component tree.
+ */
+declare const DividerContext: react16.Context<ContextValue<DividerProps, HTMLHRElement>>;
+/**
+ * DividerProvider - Context provider for setting default Divider props.
+ *
+ * Use this to configure shared orientation across multiple Divider components.
+ *
+ * @param props - The provider props.
+ * @param props.children - Child components that will receive the divider context.
+ * @returns The divider context provider wrapping children.
+ *
+ * @example
+ * ```tsx
+ * <DividerProvider orientation="vertical">
+ *   <Divider />
+ *   <Divider />
+ * </DividerProvider>
+ * ```
+ */
 declare function DividerProvider({
   children,
   ...props
-}: ProviderProps<DividerProps>): react_jsx_runtime175.JSX.Element;
+}: ProviderProps<DividerProps>): react_jsx_runtime41.JSX.Element;
 //#endregion
 export { DividerContext, DividerProvider };
 //# sourceMappingURL=context.d.ts.map

package/dist/components/divider/context.js

@@ -18,7 +18,27 @@ import { createContext } from "react";
 import { jsx } from "react/jsx-runtime";
 
 //#region src/components/divider/context.tsx
+/**
+* Context for sharing Divider props across component tree.
+*/
 const DividerContext = createContext(null);
+/**
+* DividerProvider - Context provider for setting default Divider props.
+*
+* Use this to configure shared orientation across multiple Divider components.
+*
+* @param props - The provider props.
+* @param props.children - Child components that will receive the divider context.
+* @returns The divider context provider wrapping children.
+*
+* @example
+* ```tsx
+* <DividerProvider orientation="vertical">
+*   <Divider />
+*   <Divider />
+* </DividerProvider>
+* ```
+*/
 function DividerProvider({ children, ...props }) {
 	return /* @__PURE__ */ jsx(DividerContext.Provider, {
 		value: props,

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

@@ -1 +1 @@
-{"version":3,"file":"context.js","names":[],"sources":["../../../src/components/divider/context.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 type { ProviderProps } from '@/lib/types';\nimport 'client-only';\nimport { createContext } from 'react';\nimport type { ContextValue } from 'react-aria-components';\nimport type { DividerProps } from './types';\n\nexport const DividerContext =\n  createContext<ContextValue<DividerProps, HTMLHRElement>>(null);\n\nexport function DividerProvider({\n  children,\n  ...props\n}: ProviderProps<DividerProps>) {\n  return (\n    <DividerContext.Provider value={props}>{children}</DividerContext.Provider>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAoBA,MAAa,iBACX,cAAyD,KAAK;AAEhE,SAAgB,gBAAgB,EAC9B,UACA,GAAG,SAC2B;AAC9B,QACE,oBAAC,eAAe;EAAS,OAAO;EAAQ;GAAmC"}
+{"version":3,"file":"context.js","names":[],"sources":["../../../src/components/divider/context.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 type { ProviderProps } from '@/lib/types';\nimport 'client-only';\nimport { createContext } from 'react';\nimport type { ContextValue } from 'react-aria-components';\nimport type { DividerProps } from './types';\n\n/**\n * Context for sharing Divider props across component tree.\n */\nexport const DividerContext =\n  createContext<ContextValue<DividerProps, HTMLHRElement>>(null);\n\n/**\n * DividerProvider - Context provider for setting default Divider props.\n *\n * Use this to configure shared orientation across multiple Divider components.\n *\n * @param props - The provider props.\n * @param props.children - Child components that will receive the divider context.\n * @returns The divider context provider wrapping children.\n *\n * @example\n * ```tsx\n * <DividerProvider orientation=\"vertical\">\n *   <Divider />\n *   <Divider />\n * </DividerProvider>\n * ```\n */\nexport function DividerProvider({\n  children,\n  ...props\n}: ProviderProps<DividerProps>) {\n  return (\n    <DividerContext.Provider value={props}>{children}</DividerContext.Provider>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AAuBA,MAAa,iBACX,cAAyD,KAAK;;;;;;;;;;;;;;;;;;AAmBhE,SAAgB,gBAAgB,EAC9B,UACA,GAAG,SAC2B;AAC9B,QACE,oBAAC,eAAe;EAAS,OAAO;EAAQ;GAAmC"}

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

@@ -12,27 +12,38 @@
 
 import { DividerProps } from "./types.js";
 import "client-only";
-import * as react_jsx_runtime177 from "react/jsx-runtime";
+import * as react_jsx_runtime43 from "react/jsx-runtime";
 
 //#region src/components/divider/index.d.ts
+
 /**
  * Divider - A simple horizontal or vertical rule component
  *
  * Provides a visual separator between content sections with support for both
  * horizontal and vertical orientations.
  *
+ * @param props - The divider props.
+ * @param props.ref - Reference to the hr element.
+ * @param props.className - Additional CSS class name.
+ * @param props.orientation - Orientation of the divider (horizontal or vertical).
+ * @returns The divider component.
+ *
  * @example
+ * ```tsx
  * // Basic horizontal divider
  * <Divider />
+ * ```
  *
  * @example
+ * ```tsx
  * // Vertical divider
  * <Divider orientation="vertical" />
+ * ```
  */
 declare function Divider({
   ref,
   ...props
-}: DividerProps): react_jsx_runtime177.JSX.Element;
+}: DividerProps): react_jsx_runtime43.JSX.Element;
 //#endregion
 export { Divider };
 //# sourceMappingURL=index.d.ts.map

package/dist/components/divider/index.js

@@ -28,13 +28,23 @@ import styles from "./styles.module.css";
 * Provides a visual separator between content sections with support for both
 * horizontal and vertical orientations.
 *
+* @param props - The divider props.
+* @param props.ref - Reference to the hr element.
+* @param props.className - Additional CSS class name.
+* @param props.orientation - Orientation of the divider (horizontal or vertical).
+* @returns The divider component.
+*
 * @example
+* ```tsx
 * // Basic horizontal divider
 * <Divider />
+* ```
 *
 * @example
+* ```tsx
 * // Vertical divider
 * <Divider orientation="vertical" />
+* ```
 */
 function Divider({ ref, ...props }) {
 	[props, ref] = useContextProps(props, ref ?? null, DividerContext);

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../../src/components/divider/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\n'use client';\n\nimport 'client-only';\nimport { clsx } from '@accelint/design-foundation/lib/utils';\nimport { useLayoutEffect, useState } from 'react';\nimport { useContextProps } from 'react-aria-components';\nimport { DividerContext } from './context';\nimport styles from './styles.module.css';\nimport type { DividerProps } from './types';\n\n/**\n * Divider - A simple horizontal or vertical rule component\n *\n * Provides a visual separator between content sections with support for both\n * horizontal and vertical orientations.\n *\n * @example\n * // Basic horizontal divider\n * <Divider />\n *\n * @example\n * // Vertical divider\n * <Divider orientation=\"vertical\" />\n */\nexport function Divider({ ref, ...props }: DividerProps) {\n  [props, ref] = useContextProps(props, ref ?? null, DividerContext);\n\n  const { className, orientation = 'horizontal', ...rest } = props;\n\n  const [stretch, setStretch] = useState(false);\n\n  /**\n   * CSS flexbox doesn't play nice with height. Unfortunately, there's no\n   * way to detect if a parent element is using CSS flexbox, so we have\n   * to detect it using JS\n   */\n  useLayoutEffect(() => {\n    const parent = ref.current?.parentElement;\n\n    if (\n      parent &&\n      window\n        .getComputedStyle(parent)\n        .getPropertyValue('display')\n        .includes('flex')\n    ) {\n      setStretch(true);\n    }\n  }, [ref.current]);\n\n  return (\n    <hr\n      {...rest}\n      ref={ref}\n      className={clsx(styles.divider, stretch && styles.stretch, className)}\n      data-orientation={orientation}\n    />\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAoCA,SAAgB,QAAQ,EAAE,KAAK,GAAG,SAAuB;AACvD,EAAC,OAAO,OAAO,gBAAgB,OAAO,OAAO,MAAM,eAAe;CAElE,MAAM,EAAE,WAAW,cAAc,cAAc,GAAG,SAAS;CAE3D,MAAM,CAAC,SAAS,cAAc,SAAS,MAAM;;;;;;AAO7C,uBAAsB;EACpB,MAAM,SAAS,IAAI,SAAS;AAE5B,MACE,UACA,OACG,iBAAiB,OAAO,CACxB,iBAAiB,UAAU,CAC3B,SAAS,OAAO,CAEnB,YAAW,KAAK;IAEjB,CAAC,IAAI,QAAQ,CAAC;AAEjB,QACE,oBAAC;EACC,GAAI;EACC;EACL,WAAW,KAAK,OAAO,SAAS,WAAW,OAAO,SAAS,UAAU;EACrE,oBAAkB;GAClB"}
+{"version":3,"file":"index.js","names":[],"sources":["../../../src/components/divider/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\n'use client';\n\nimport 'client-only';\nimport { clsx } from '@accelint/design-foundation/lib/utils';\nimport { useLayoutEffect, useState } from 'react';\nimport { useContextProps } from 'react-aria-components';\nimport { DividerContext } from './context';\nimport styles from './styles.module.css';\nimport type { DividerProps } from './types';\n\n/**\n * Divider - A simple horizontal or vertical rule component\n *\n * Provides a visual separator between content sections with support for both\n * horizontal and vertical orientations.\n *\n * @param props - The divider props.\n * @param props.ref - Reference to the hr element.\n * @param props.className - Additional CSS class name.\n * @param props.orientation - Orientation of the divider (horizontal or vertical).\n * @returns The divider component.\n *\n * @example\n * ```tsx\n * // Basic horizontal divider\n * <Divider />\n * ```\n *\n * @example\n * ```tsx\n * // Vertical divider\n * <Divider orientation=\"vertical\" />\n * ```\n */\nexport function Divider({ ref, ...props }: DividerProps) {\n  [props, ref] = useContextProps(props, ref ?? null, DividerContext);\n\n  const { className, orientation = 'horizontal', ...rest } = props;\n\n  const [stretch, setStretch] = useState(false);\n\n  /**\n   * CSS flexbox doesn't play nice with height. Unfortunately, there's no\n   * way to detect if a parent element is using CSS flexbox, so we have\n   * to detect it using JS\n   */\n  useLayoutEffect(() => {\n    const parent = ref.current?.parentElement;\n\n    if (\n      parent &&\n      window\n        .getComputedStyle(parent)\n        .getPropertyValue('display')\n        .includes('flex')\n    ) {\n      setStretch(true);\n    }\n  }, [ref.current]);\n\n  return (\n    <hr\n      {...rest}\n      ref={ref}\n      className={clsx(styles.divider, stretch && styles.stretch, className)}\n      data-orientation={orientation}\n    />\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA8CA,SAAgB,QAAQ,EAAE,KAAK,GAAG,SAAuB;AACvD,EAAC,OAAO,OAAO,gBAAgB,OAAO,OAAO,MAAM,eAAe;CAElE,MAAM,EAAE,WAAW,cAAc,cAAc,GAAG,SAAS;CAE3D,MAAM,CAAC,SAAS,cAAc,SAAS,MAAM;;;;;;AAO7C,uBAAsB;EACpB,MAAM,SAAS,IAAI,SAAS;AAE5B,MACE,UACA,OACG,iBAAiB,OAAO,CACxB,iBAAiB,UAAU,CAC3B,SAAS,OAAO,CAEnB,YAAW,KAAK;IAEjB,CAAC,IAAI,QAAQ,CAAC;AAEjB,QACE,oBAAC;EACC,GAAI;EACC;EACL,WAAW,KAAK,OAAO,SAAS,WAAW,OAAO,SAAS,UAAU;EACrE,oBAAkB;GAClB"}

package/dist/components/divider/types.d.ts

@@ -13,11 +13,11 @@
 import { ComponentPropsWithRef } from "react";
 
 //#region src/components/divider/types.d.ts
+/**
+ * Props for the Divider component.
+ */
 type DividerProps = ComponentPropsWithRef<'hr'> & {
-  /**
-   * The orientation of the divider.
-   * @default 'horizontal'
-   */
+  /** The orientation of the divider (defaults to 'horizontal'). */
   orientation?: 'horizontal' | 'vertical';
 };
 //#endregion

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

@@ -11,10 +11,29 @@
  */
 
 import "client-only";
-import * as react_jsx_runtime163 from "react/jsx-runtime";
+import * as react_jsx_runtime48 from "react/jsx-runtime";
 
 //#region src/components/drawer/back.d.ts
-declare function DrawerBack(): react_jsx_runtime163.JSX.Element | null;
+
+/**
+ * DrawerBack - Back navigation button for nested drawer views.
+ *
+ * Only renders when the view stack has more than one view.
+ * Triggers a 'back' action to pop the current view from the stack.
+ *
+ * @returns The rendered DrawerBack button, or null if at root view.
+ *
+ * @example
+ * ```tsx
+ * <DrawerView id={nestedViewId}>
+ *   <DrawerHeader>
+ *     <DrawerBack />
+ *     <DrawerHeaderTitle>Nested View</DrawerHeaderTitle>
+ *   </DrawerHeader>
+ * </DrawerView>
+ * ```
+ */
+declare function DrawerBack(): react_jsx_runtime48.JSX.Element | null;
 //#endregion
 export { DrawerBack };
 //# sourceMappingURL=back.d.ts.map

package/dist/components/drawer/back.js

@@ -20,9 +20,27 @@ import { DrawerTrigger } from "./trigger.js";
 import "client-only";
 import { useContext } from "react";
 import { jsx } from "react/jsx-runtime";
-import { ChevronLeft } from "@accelint/icons";
+import ChevronLeft from "@accelint/icons/chevron-left";
 
 //#region src/components/drawer/back.tsx
+/**
+* DrawerBack - Back navigation button for nested drawer views.
+*
+* Only renders when the view stack has more than one view.
+* Triggers a 'back' action to pop the current view from the stack.
+*
+* @returns The rendered DrawerBack button, or null if at root view.
+*
+* @example
+* ```tsx
+* <DrawerView id={nestedViewId}>
+*   <DrawerHeader>
+*     <DrawerBack />
+*     <DrawerHeaderTitle>Nested View</DrawerHeaderTitle>
+*   </DrawerHeader>
+* </DrawerView>
+* ```
+*/
 function DrawerBack() {
 	const { stack } = useContext(ViewStackContext);
 	return stack.length > 1 ? /* @__PURE__ */ jsx(DrawerTrigger, {

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

@@ -1 +1 @@
-{"version":3,"file":"back.js","names":[],"sources":["../../../src/components/drawer/back.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 { ChevronLeft } from '@accelint/icons';\nimport { useContext } from 'react';\nimport { Button } from '../button';\nimport { Icon } from '../icon';\nimport { ViewStackContext } from '../view-stack/context';\nimport { DrawerTrigger } from './trigger';\n\nexport function DrawerBack() {\n  const { stack } = useContext(ViewStackContext);\n\n  return stack.length > 1 ? (\n    <DrawerTrigger for='back'>\n      <Button variant='icon'>\n        <Icon>\n          <ChevronLeft />\n        </Icon>\n      </Button>\n    </DrawerTrigger>\n  ) : null;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;AAsBA,SAAgB,aAAa;CAC3B,MAAM,EAAE,UAAU,WAAW,iBAAiB;AAE9C,QAAO,MAAM,SAAS,IACpB,oBAAC;EAAc,KAAI;YACjB,oBAAC;GAAO,SAAQ;aACd,oBAAC,kBACC,oBAAC,gBAAc,GACV;IACA;GACK,GACd"}
+{"version":3,"file":"back.js","names":[],"sources":["../../../src/components/drawer/back.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 ChevronLeft from '@accelint/icons/chevron-left';\nimport { useContext } from 'react';\nimport { Button } from '../button';\nimport { Icon } from '../icon';\nimport { ViewStackContext } from '../view-stack/context';\nimport { DrawerTrigger } from './trigger';\n\n/**\n * DrawerBack - Back navigation button for nested drawer views.\n *\n * Only renders when the view stack has more than one view.\n * Triggers a 'back' action to pop the current view from the stack.\n *\n * @returns The rendered DrawerBack button, or null if at root view.\n *\n * @example\n * ```tsx\n * <DrawerView id={nestedViewId}>\n *   <DrawerHeader>\n *     <DrawerBack />\n *     <DrawerHeaderTitle>Nested View</DrawerHeaderTitle>\n *   </DrawerHeader>\n * </DrawerView>\n * ```\n */\nexport function DrawerBack() {\n  const { stack } = useContext(ViewStackContext);\n\n  return stack.length > 1 ? (\n    <DrawerTrigger for='back'>\n      <Button variant='icon'>\n        <Icon>\n          <ChevronLeft />\n        </Icon>\n      </Button>\n    </DrawerTrigger>\n  ) : null;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAwCA,SAAgB,aAAa;CAC3B,MAAM,EAAE,UAAU,WAAW,iBAAiB;AAE9C,QAAO,MAAM,SAAS,IACpB,oBAAC;EAAc,KAAI;YACjB,oBAAC;GAAO,SAAQ;aACd,oBAAC,kBACC,oBAAC,gBAAc,GACV;IACA;GACK,GACd"}

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

@@ -10,11 +10,34 @@
  * governing permissions and limitations under the License.
  */
 
+import { DrawerCloseProps } from "./types.js";
 import "client-only";
-import * as react_jsx_runtime165 from "react/jsx-runtime";
+import * as react_jsx_runtime49 from "react/jsx-runtime";
 
 //#region src/components/drawer/close.d.ts
-declare function DrawerClose(): react_jsx_runtime165.JSX.Element;
+
+/**
+ * DrawerClose - Close button for the drawer.
+ *
+ * Triggers a 'close' action to close the entire drawer.
+ *
+ * @param props - {@link DrawerCloseProps}
+ * @param props.for - Optional drawer ID to close. Defaults to current drawer.
+ * @param props.aria-label - Optional accessible label for the button.
+ * @returns The rendered DrawerClose button.
+ *
+ * @example
+ * ```tsx
+ * <DrawerHeader>
+ *   <DrawerHeaderTitle>Settings</DrawerHeaderTitle>
+ *   <DrawerClose />
+ * </DrawerHeader>
+ * ```
+ */
+declare function DrawerClose(props: DrawerCloseProps): react_jsx_runtime49.JSX.Element;
+declare namespace DrawerClose {
+  var displayName: string;
+}
 //#endregion
 export { DrawerClose };
 //# sourceMappingURL=close.d.ts.map

package/dist/components/drawer/close.js

@@ -15,21 +15,46 @@
 
 import { Icon } from "../icon/index.js";
 import { Button } from "../button/index.js";
+import { ViewStackContext } from "../view-stack/context.js";
 import { DrawerTrigger } from "./trigger.js";
 import "client-only";
+import { useContext } from "react";
 import { jsx } from "react/jsx-runtime";
-import { Cancel } from "@accelint/icons";
+import Cancel from "@accelint/icons/cancel";
 
 //#region src/components/drawer/close.tsx
-function DrawerClose() {
+/**
+* DrawerClose - Close button for the drawer.
+*
+* Triggers a 'close' action to close the entire drawer.
+*
+* @param props - {@link DrawerCloseProps}
+* @param props.for - Optional drawer ID to close. Defaults to current drawer.
+* @param props.aria-label - Optional accessible label for the button.
+* @returns The rendered DrawerClose button.
+*
+* @example
+* ```tsx
+* <DrawerHeader>
+*   <DrawerHeaderTitle>Settings</DrawerHeaderTitle>
+*   <DrawerClose />
+* </DrawerHeader>
+* ```
+*/
+function DrawerClose(props) {
+	const context = useContext(ViewStackContext);
+	const id = props.for ?? context.parent ?? null;
+	const event = id ? `close:${id}` : "close";
 	return /* @__PURE__ */ jsx(DrawerTrigger, {
-		for: "close",
+		"aria-label": props["aria-label"],
+		for: event,
 		children: /* @__PURE__ */ jsx(Button, {
 			variant: "icon",
 			children: /* @__PURE__ */ jsx(Icon, { children: /* @__PURE__ */ jsx(Cancel, {}) })
 		})
 	});
 }
+DrawerClose.displayName = "DrawerClose";
 
 //#endregion
 export { DrawerClose };

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

@@ -1 +1 @@
-{"version":3,"file":"close.js","names":[],"sources":["../../../src/components/drawer/close.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 { Cancel } from '@accelint/icons';\nimport { Button } from '../button';\nimport { Icon } from '../icon';\nimport { DrawerTrigger } from './trigger';\n\nexport function DrawerClose() {\n  return (\n    <DrawerTrigger for='close'>\n      <Button variant='icon'>\n        <Icon>\n          <Cancel />\n        </Icon>\n      </Button>\n    </DrawerTrigger>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AAoBA,SAAgB,cAAc;AAC5B,QACE,oBAAC;EAAc,KAAI;YACjB,oBAAC;GAAO,SAAQ;aACd,oBAAC,kBACC,oBAAC,WAAS,GACL;IACA;GACK"}
+{"version":3,"file":"close.js","names":["id: UniqueId | null"],"sources":["../../../src/components/drawer/close.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 Cancel from '@accelint/icons/cancel';\nimport type { UniqueId } from '@accelint/core';\nimport 'client-only';\nimport { useContext } from 'react';\nimport { Button } from '../button';\nimport { Icon } from '../icon';\nimport { ViewStackContext } from '../view-stack/context';\nimport { DrawerTrigger } from './trigger';\nimport type { DrawerCloseProps, SimpleEvents, TargetedEvents } from './types';\n\n/**\n * DrawerClose - Close button for the drawer.\n *\n * Triggers a 'close' action to close the entire drawer.\n *\n * @param props - {@link DrawerCloseProps}\n * @param props.for - Optional drawer ID to close. Defaults to current drawer.\n * @param props.aria-label - Optional accessible label for the button.\n * @returns The rendered DrawerClose button.\n *\n * @example\n * ```tsx\n * <DrawerHeader>\n *   <DrawerHeaderTitle>Settings</DrawerHeaderTitle>\n *   <DrawerClose />\n * </DrawerHeader>\n * ```\n */\nexport function DrawerClose(props: DrawerCloseProps) {\n  const context = useContext(ViewStackContext);\n  const id: UniqueId | null = props.for ?? context.parent ?? null;\n\n  const event = id\n    ? (`close:${id}` as TargetedEvents)\n    : ('close' as SimpleEvents);\n\n  return (\n    // Note, not using ...rest due to possible memory leak within <Pressable />\n    // Still investigating.\n    <DrawerTrigger aria-label={props['aria-label']} for={event}>\n      <Button variant='icon'>\n        <Icon>\n          <Cancel />\n        </Icon>\n      </Button>\n    </DrawerTrigger>\n  );\n}\nDrawerClose.displayName = 'DrawerClose';\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA0CA,SAAgB,YAAY,OAAyB;CACnD,MAAM,UAAU,WAAW,iBAAiB;CAC5C,MAAMA,KAAsB,MAAM,OAAO,QAAQ,UAAU;CAE3D,MAAM,QAAQ,KACT,SAAS,OACT;AAEL,QAGE,oBAAC;EAAc,cAAY,MAAM;EAAe,KAAK;YACnD,oBAAC;GAAO,SAAQ;aACd,oBAAC,kBACC,oBAAC,WAAS,GACL;IACA;GACK;;AAGpB,YAAY,cAAc"}

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

@@ -11,13 +11,33 @@
  */
 
 import { ComponentPropsWithRef } from "react";
-import * as react_jsx_runtime162 from "react/jsx-runtime";
+import * as react_jsx_runtime94 from "react/jsx-runtime";
 
 //#region src/components/drawer/content.d.ts
+
+/**
+ * DrawerContent - Main content area within a DrawerView.
+ *
+ * Scrollable container for the view's primary content.
+ *
+ * @param props - ComponentPropsWithRef<'div'>
+ * @param props.className - Optional CSS class name.
+ * @returns The rendered DrawerContent component.
+ *
+ * @example
+ * ```tsx
+ * <DrawerView id={viewId}>
+ *   <DrawerHeader title="Settings" />
+ *   <DrawerContent>
+ *     <p>Your content here</p>
+ *   </DrawerContent>
+ * </DrawerView>
+ * ```
+ */
 declare function DrawerContent({
   className,
   ...rest
-}: ComponentPropsWithRef<'div'>): react_jsx_runtime162.JSX.Element;
+}: ComponentPropsWithRef<'div'>): react_jsx_runtime94.JSX.Element;
 //#endregion
 export { DrawerContent };
 //# sourceMappingURL=content.d.ts.map

package/dist/components/drawer/content.js

@@ -16,6 +16,25 @@ import { jsx } from "react/jsx-runtime";
 import styles from "./styles.module.css";
 
 //#region src/components/drawer/content.tsx
+/**
+* DrawerContent - Main content area within a DrawerView.
+*
+* Scrollable container for the view's primary content.
+*
+* @param props - ComponentPropsWithRef<'div'>
+* @param props.className - Optional CSS class name.
+* @returns The rendered DrawerContent component.
+*
+* @example
+* ```tsx
+* <DrawerView id={viewId}>
+*   <DrawerHeader title="Settings" />
+*   <DrawerContent>
+*     <p>Your content here</p>
+*   </DrawerContent>
+* </DrawerView>
+* ```
+*/
 function DrawerContent({ className, ...rest }) {
 	return /* @__PURE__ */ jsx("div", {
 		...rest,

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

@@ -1 +1 @@
-{"version":3,"file":"content.js","names":[],"sources":["../../../src/components/drawer/content.tsx"],"sourcesContent":["/*\n * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\nimport { clsx } from '@accelint/design-foundation/lib/utils';\nimport styles from './styles.module.css';\nimport type { ComponentPropsWithRef } from 'react';\n\nexport function DrawerContent({\n  className,\n  ...rest\n}: ComponentPropsWithRef<'div'>) {\n  return <div {...rest} className={clsx(styles.content, className)} />;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAeA,SAAgB,cAAc,EAC5B,WACA,GAAG,QAC4B;AAC/B,QAAO,oBAAC;EAAI,GAAI;EAAM,WAAW,KAAK,OAAO,SAAS,UAAU;GAAI"}
+{"version":3,"file":"content.js","names":[],"sources":["../../../src/components/drawer/content.tsx"],"sourcesContent":["/*\n * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\nimport { clsx } from '@accelint/design-foundation/lib/utils';\nimport styles from './styles.module.css';\nimport type { ComponentPropsWithRef } from 'react';\n\n/**\n * DrawerContent - Main content area within a DrawerView.\n *\n * Scrollable container for the view's primary content.\n *\n * @param props - ComponentPropsWithRef<'div'>\n * @param props.className - Optional CSS class name.\n * @returns The rendered DrawerContent component.\n *\n * @example\n * ```tsx\n * <DrawerView id={viewId}>\n *   <DrawerHeader title=\"Settings\" />\n *   <DrawerContent>\n *     <p>Your content here</p>\n *   </DrawerContent>\n * </DrawerView>\n * ```\n */\nexport function DrawerContent({\n  className,\n  ...rest\n}: ComponentPropsWithRef<'div'>) {\n  return <div {...rest} className={clsx(styles.content, className)} />;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAkCA,SAAgB,cAAc,EAC5B,WACA,GAAG,QAC4B;AAC/B,QAAO,oBAAC;EAAI,GAAI;EAAM,WAAW,KAAK,OAAO,SAAS,UAAU;GAAI"}

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

@@ -12,15 +12,44 @@
 
 import { DrawerContextValue, DrawerEvent } from "./types.js";
 import "client-only";
-import * as react47 from "react";
+import * as react28 from "react";
 import { Broadcast } from "@accelint/bus";
 import { UniqueId } from "@accelint/core";
 
 //#region src/components/drawer/context.d.ts
-declare const DrawerContext: react47.Context<DrawerContextValue>;
+/**
+ * Context for sharing Drawer state across child components.
+ *
+ * @example
+ * ```tsx
+ * const { register, unregister, placement } = useContext(DrawerContext);
+ * ```
+ */
+declare const DrawerContext: react28.Context<DrawerContextValue>;
+/**
+ * Event bus instance for drawer-related events.
+ *
+ * @example
+ * ```tsx
+ * import { bus } from './context';
+ * bus.on('Drawer:open', (event) => console.log(event));
+ * ```
+ */
 declare const bus: Broadcast<DrawerEvent>;
+/**
+ * Event handlers for controlling drawer state programmatically.
+ *
+ * @example
+ * ```tsx
+ * import { DrawerEventHandlers } from './context';
+ *
+ * DrawerEventHandlers.open(viewId);
+ * DrawerEventHandlers.toggle(viewId);
+ * DrawerEventHandlers.close(viewId);
+ * ```
+ */
 declare const DrawerEventHandlers: {
-  readonly close: (stack: UniqueId) => void;
+  readonly close: (view: UniqueId) => void;
   readonly open: (view: UniqueId) => void;
   readonly toggle: (view: UniqueId) => void;
   readonly back: (stack: UniqueId) => void;
@@ -28,8 +57,21 @@ declare const DrawerEventHandlers: {
   readonly push: (view: UniqueId) => void;
   readonly reset: (stack: UniqueId) => void;
 };
+/**
+ * Hook for emitting drawer events (open, close, toggle, push, pop, clear).
+ *
+ * @returns Object with methods to emit drawer events.
+ *
+ * @example
+ * ```tsx
+ * const emit = useDrawerEmit();
+ * emit.open(viewId);
+ * emit.toggle(viewId);
+ * emit.close();
+ * ```
+ */
 declare function useDrawerEmit(): {
-  readonly close: (stack: UniqueId) => void;
+  readonly close: (view: UniqueId) => void;
   readonly open: (view: UniqueId) => void;
   readonly toggle: (view: UniqueId) => void;
   readonly back: (stack: UniqueId) => void;