@accelint/design-toolkit 9.2.0 → 9.4.0

package/dist/components/details-list/context.d.ts

@@ -13,16 +13,37 @@
 import { ProviderProps } from "../../lib/types.js";
 import { DetailsListProps } from "./types.js";
 import "client-only";
-import * as react46 from "react";
+import * as react17 from "react";
 import { ContextValue } from "react-aria-components";
-import * as react_jsx_runtime183 from "react/jsx-runtime";
+import * as react_jsx_runtime44 from "react/jsx-runtime";
 
 //#region src/components/details-list/context.d.ts
-declare const DetailsListContext: react46.Context<ContextValue<DetailsListProps, HTMLDListElement>>;
+/**
+ * Context for sharing DetailsList props across component tree.
+ */
+declare const DetailsListContext: react17.Context<ContextValue<DetailsListProps, HTMLDListElement>>;
+/**
+ * DetailsListProvider - Context provider for setting default DetailsList props.
+ *
+ * Use this to configure shared alignment and classNames across multiple
+ * DetailsList components in your application.
+ *
+ * @param props - The provider props.
+ * @param props.children - Child components that will receive the details list context.
+ * @returns The details list context provider wrapping children.
+ *
+ * @example
+ * ```tsx
+ * <DetailsListProvider align="left">
+ *   <DetailsList>...</DetailsList>
+ *   <DetailsList>...</DetailsList>
+ * </DetailsListProvider>
+ * ```
+ */
 declare function DetailsListProvider({
   children,
   ...props
-}: ProviderProps<DetailsListProps>): react_jsx_runtime183.JSX.Element;
+}: ProviderProps<DetailsListProps>): react_jsx_runtime44.JSX.Element;
 //#endregion
 export { DetailsListContext, DetailsListProvider };
 //# sourceMappingURL=context.d.ts.map

package/dist/components/details-list/context.js

@@ -18,7 +18,28 @@ import { createContext } from "react";
 import { jsx } from "react/jsx-runtime";
 
 //#region src/components/details-list/context.tsx
+/**
+* Context for sharing DetailsList props across component tree.
+*/
 const DetailsListContext = createContext(null);
+/**
+* DetailsListProvider - Context provider for setting default DetailsList props.
+*
+* Use this to configure shared alignment and classNames across multiple
+* DetailsList components in your application.
+*
+* @param props - The provider props.
+* @param props.children - Child components that will receive the details list context.
+* @returns The details list context provider wrapping children.
+*
+* @example
+* ```tsx
+* <DetailsListProvider align="left">
+*   <DetailsList>...</DetailsList>
+*   <DetailsList>...</DetailsList>
+* </DetailsListProvider>
+* ```
+*/
 function DetailsListProvider({ children, ...props }) {
 	return /* @__PURE__ */ jsx(DetailsListContext.Provider, {
 		value: props,

package/dist/components/details-list/context.js.map

@@ -1 +1 @@
-{"version":3,"file":"context.js","names":[],"sources":["../../../src/components/details-list/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'use client';\n\nimport 'client-only';\nimport { createContext } from 'react';\nimport type { ContextValue } from 'react-aria-components';\nimport type { ProviderProps } from '@/lib/types';\nimport type { DetailsListProps } from './types';\n\nexport const DetailsListContext =\n  createContext<ContextValue<DetailsListProps, HTMLDListElement>>(null);\n\nexport function DetailsListProvider({\n  children,\n  ...props\n}: ProviderProps<DetailsListProps>) {\n  return (\n    <DetailsListContext.Provider value={props}>\n      {children}\n    </DetailsListContext.Provider>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAmBA,MAAa,qBACX,cAAgE,KAAK;AAEvE,SAAgB,oBAAoB,EAClC,UACA,GAAG,SAC+B;AAClC,QACE,oBAAC,mBAAmB;EAAS,OAAO;EACjC;GAC2B"}
+{"version":3,"file":"context.js","names":[],"sources":["../../../src/components/details-list/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'use client';\n\nimport 'client-only';\nimport { createContext } from 'react';\nimport type { ContextValue } from 'react-aria-components';\nimport type { ProviderProps } from '@/lib/types';\nimport type { DetailsListProps } from './types';\n\n/**\n * Context for sharing DetailsList props across component tree.\n */\nexport const DetailsListContext =\n  createContext<ContextValue<DetailsListProps, HTMLDListElement>>(null);\n\n/**\n * DetailsListProvider - Context provider for setting default DetailsList props.\n *\n * Use this to configure shared alignment and classNames across multiple\n * DetailsList components in your application.\n *\n * @param props - The provider props.\n * @param props.children - Child components that will receive the details list context.\n * @returns The details list context provider wrapping children.\n *\n * @example\n * ```tsx\n * <DetailsListProvider align=\"left\">\n *   <DetailsList>...</DetailsList>\n *   <DetailsList>...</DetailsList>\n * </DetailsListProvider>\n * ```\n */\nexport function DetailsListProvider({\n  children,\n  ...props\n}: ProviderProps<DetailsListProps>) {\n  return (\n    <DetailsListContext.Provider value={props}>\n      {children}\n    </DetailsListContext.Provider>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AAsBA,MAAa,qBACX,cAAgE,KAAK;;;;;;;;;;;;;;;;;;;AAoBvE,SAAgB,oBAAoB,EAClC,UACA,GAAG,SAC+B;AAClC,QACE,oBAAC,mBAAmB;EAAS,OAAO;EACjC;GAC2B"}

package/dist/components/details-list/index.d.ts

@@ -12,7 +12,7 @@
 
 import { DetailsListProps } from "./types.js";
 import "client-only";
-import * as react_jsx_runtime182 from "react/jsx-runtime";
+import * as react_jsx_runtime45 from "react/jsx-runtime";
 
 //#region src/components/details-list/index.d.ts
 
@@ -21,6 +21,13 @@ import * as react_jsx_runtime182 from "react/jsx-runtime";
  * Uses CSS Grid layout with labels in the first column and values in the second column.
  * Perfect for map object details, user profiles, or any structured information.
  *
+ * @param props - The details list props.
+ * @param props.ref - Reference to the list element.
+ * @param props.children - Label and value child components.
+ * @param props.classNames - Custom class names for sub-elements.
+ * @param props.align - Text alignment for list items.
+ * @returns The details list component.
+ *
  * @example
  * ```tsx
  * <DetailsList align="left">
@@ -48,7 +55,7 @@ import * as react_jsx_runtime182 from "react/jsx-runtime";
 declare function DetailsList({
   ref,
   ...props
-}: DetailsListProps): react_jsx_runtime182.JSX.Element;
+}: DetailsListProps): react_jsx_runtime45.JSX.Element;
 //#endregion
 export { DetailsList };
 //# sourceMappingURL=index.d.ts.map

package/dist/components/details-list/index.js

@@ -26,6 +26,13 @@ import styles from "./styles.module.css";
 * Uses CSS Grid layout with labels in the first column and values in the second column.
 * Perfect for map object details, user profiles, or any structured information.
 *
+* @param props - The details list props.
+* @param props.ref - Reference to the list element.
+* @param props.children - Label and value child components.
+* @param props.classNames - Custom class names for sub-elements.
+* @param props.align - Text alignment for list items.
+* @returns The details list component.
+*
 * @example
 * ```tsx
 * <DetailsList align="left">

package/dist/components/details-list/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../../src/components/details-list/index.tsx"],"sourcesContent":["/*\n * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n'use client';\n\nimport 'client-only';\nimport { clsx } from '@accelint/design-foundation/lib/utils';\nimport {\n  DEFAULT_SLOT,\n  TextContext,\n  useContextProps,\n} from 'react-aria-components';\nimport { DetailsListContext } from './context';\nimport styles from './styles.module.css';\nimport type { DetailsListProps } from './types';\n\n/**\n * A semantic details list component for displaying metadata in key-value pairs.\n * Uses CSS Grid layout with labels in the first column and values in the second column.\n * Perfect for map object details, user profiles, or any structured information.\n *\n * @example\n * ```tsx\n * <DetailsList align=\"left\">\n *   <DetailsListLabel>Key</DetailsListLabel>\n *   <DetailsListValue>Value</DetailsListValue>\n *\n *   <DetailsListLabel>Ships</DetailsListLabel>\n *   <DetailsListValue>Millennium Falcon</DetailsListValue>\n *   <DetailsListValue>USS Enterprise NCC-1701</DetailsListValue>\n *   <DetailsListValue>Serenity</DetailsListValue>\n *\n *   <DetailsListLabel>Coordinates</DetailsListLabel>\n *   <DetailsListValue>\n *     <div>Great Pyramid of Giza: 29°58'44\" N 31°08'02\" E</div>\n *     <div>Machu Picchu: 13°09'47\" S 72°32'41\" W</div>\n *     <div>Colosseum: 41°53'24\" N 12°29'32\" E</div>\n *     <div>Taj Mahal: 27°10'30\" N 78°02'31\" E</div>\n *   </DetailsListValue>\n * </DetailsList>\n * ```\n * ## Child Component Behavior\n * - **DetailsListLabel**: Minimum of 1\n * - **DetailsListValue**: Minimum of 1\n */\nexport function DetailsList({ ref, ...props }: DetailsListProps) {\n  [props, ref] = useContextProps(props, ref ?? null, DetailsListContext);\n\n  const { children, classNames, align = 'justify', ...rest } = props;\n\n  return (\n    <TextContext\n      value={{\n        slots: {\n          [DEFAULT_SLOT]: {},\n          label: {\n            className: clsx(styles.label, styles[align], classNames?.label),\n          },\n          value: {\n            className: clsx(styles.value, styles[align], classNames?.value),\n          },\n        },\n      }}\n    >\n      <dl {...rest} className={clsx(styles.list, classNames?.list)}>\n        {children}\n      </dl>\n    </TextContext>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAqDA,SAAgB,YAAY,EAAE,KAAK,GAAG,SAA2B;AAC/D,EAAC,OAAO,OAAO,gBAAgB,OAAO,OAAO,MAAM,mBAAmB;CAEtE,MAAM,EAAE,UAAU,YAAY,QAAQ,WAAW,GAAG,SAAS;AAE7D,QACE,oBAAC;EACC,OAAO,EACL,OAAO;IACJ,eAAe,EAAE;GAClB,OAAO,EACL,WAAW,KAAK,OAAO,OAAO,OAAO,QAAQ,YAAY,MAAM,EAChE;GACD,OAAO,EACL,WAAW,KAAK,OAAO,OAAO,OAAO,QAAQ,YAAY,MAAM,EAChE;GACF,EACF;YAED,oBAAC;GAAG,GAAI;GAAM,WAAW,KAAK,OAAO,MAAM,YAAY,KAAK;GACzD;IACE;GACO"}
+{"version":3,"file":"index.js","names":[],"sources":["../../../src/components/details-list/index.tsx"],"sourcesContent":["/*\n * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n'use client';\n\nimport 'client-only';\nimport { clsx } from '@accelint/design-foundation/lib/utils';\nimport {\n  DEFAULT_SLOT,\n  TextContext,\n  useContextProps,\n} from 'react-aria-components';\nimport { DetailsListContext } from './context';\nimport styles from './styles.module.css';\nimport type { DetailsListProps } from './types';\n\n/**\n * A semantic details list component for displaying metadata in key-value pairs.\n * Uses CSS Grid layout with labels in the first column and values in the second column.\n * Perfect for map object details, user profiles, or any structured information.\n *\n * @param props - The details list props.\n * @param props.ref - Reference to the list element.\n * @param props.children - Label and value child components.\n * @param props.classNames - Custom class names for sub-elements.\n * @param props.align - Text alignment for list items.\n * @returns The details list component.\n *\n * @example\n * ```tsx\n * <DetailsList align=\"left\">\n *   <DetailsListLabel>Key</DetailsListLabel>\n *   <DetailsListValue>Value</DetailsListValue>\n *\n *   <DetailsListLabel>Ships</DetailsListLabel>\n *   <DetailsListValue>Millennium Falcon</DetailsListValue>\n *   <DetailsListValue>USS Enterprise NCC-1701</DetailsListValue>\n *   <DetailsListValue>Serenity</DetailsListValue>\n *\n *   <DetailsListLabel>Coordinates</DetailsListLabel>\n *   <DetailsListValue>\n *     <div>Great Pyramid of Giza: 29°58'44\" N 31°08'02\" E</div>\n *     <div>Machu Picchu: 13°09'47\" S 72°32'41\" W</div>\n *     <div>Colosseum: 41°53'24\" N 12°29'32\" E</div>\n *     <div>Taj Mahal: 27°10'30\" N 78°02'31\" E</div>\n *   </DetailsListValue>\n * </DetailsList>\n * ```\n * ## Child Component Behavior\n * - **DetailsListLabel**: Minimum of 1\n * - **DetailsListValue**: Minimum of 1\n */\nexport function DetailsList({ ref, ...props }: DetailsListProps) {\n  [props, ref] = useContextProps(props, ref ?? null, DetailsListContext);\n\n  const { children, classNames, align = 'justify', ...rest } = props;\n\n  return (\n    <TextContext\n      value={{\n        slots: {\n          [DEFAULT_SLOT]: {},\n          label: {\n            className: clsx(styles.label, styles[align], classNames?.label),\n          },\n          value: {\n            className: clsx(styles.value, styles[align], classNames?.value),\n          },\n        },\n      }}\n    >\n      <dl {...rest} className={clsx(styles.list, classNames?.list)}>\n        {children}\n      </dl>\n    </TextContext>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA4DA,SAAgB,YAAY,EAAE,KAAK,GAAG,SAA2B;AAC/D,EAAC,OAAO,OAAO,gBAAgB,OAAO,OAAO,MAAM,mBAAmB;CAEtE,MAAM,EAAE,UAAU,YAAY,QAAQ,WAAW,GAAG,SAAS;AAE7D,QACE,oBAAC;EACC,OAAO,EACL,OAAO;IACJ,eAAe,EAAE;GAClB,OAAO,EACL,WAAW,KAAK,OAAO,OAAO,OAAO,QAAQ,YAAY,MAAM,EAChE;GACD,OAAO,EACL,WAAW,KAAK,OAAO,OAAO,OAAO,QAAQ,YAAY,MAAM,EAChE;GACF,EACF;YAED,oBAAC;GAAG,GAAI;GAAM,WAAW,KAAK,OAAO,MAAM,YAAY,KAAK;GACzD;IACE;GACO"}

package/dist/components/details-list/label.d.ts

@@ -12,10 +12,26 @@
 
 import { DetailsListLabelProps } from "./types.js";
 import "client-only";
-import * as react_jsx_runtime184 from "react/jsx-runtime";
+import * as react_jsx_runtime46 from "react/jsx-runtime";
 
 //#region src/components/details-list/label.d.ts
-declare function DetailsListLabel(props: DetailsListLabelProps): react_jsx_runtime184.JSX.Element;
+/**
+ * DetailsListLabel - Label component for DetailsList key/term.
+ *
+ * Renders as a `<dt>` element within the DetailsList grid.
+ *
+ * @param props - The details list label props.
+ * @returns The details list label component.
+ *
+ * @example
+ * ```tsx
+ * <DetailsList>
+ *   <DetailsListLabel>Name</DetailsListLabel>
+ *   <DetailsListValue>John Doe</DetailsListValue>
+ * </DetailsList>
+ * ```
+ */
+declare function DetailsListLabel(props: DetailsListLabelProps): react_jsx_runtime46.JSX.Element;
 //#endregion
 export { DetailsListLabel };
 //# sourceMappingURL=label.d.ts.map

package/dist/components/details-list/label.js

@@ -18,6 +18,22 @@ import { Text } from "react-aria-components";
 import { jsx } from "react/jsx-runtime";
 
 //#region src/components/details-list/label.tsx
+/**
+* DetailsListLabel - Label component for DetailsList key/term.
+*
+* Renders as a `<dt>` element within the DetailsList grid.
+*
+* @param props - The details list label props.
+* @returns The details list label component.
+*
+* @example
+* ```tsx
+* <DetailsList>
+*   <DetailsListLabel>Name</DetailsListLabel>
+*   <DetailsListValue>John Doe</DetailsListValue>
+* </DetailsList>
+* ```
+*/
 function DetailsListLabel(props) {
 	return /* @__PURE__ */ jsx(Text, {
 		...props,

package/dist/components/details-list/label.js.map

@@ -1 +1 @@
-{"version":3,"file":"label.js","names":[],"sources":["../../../src/components/details-list/label.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 { Text } from 'react-aria-components';\nimport type { DetailsListLabelProps } from './types';\n\nexport function DetailsListLabel(props: DetailsListLabelProps) {\n  return <Text {...props} elementType='dt' slot='label' />;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAiBA,SAAgB,iBAAiB,OAA8B;AAC7D,QAAO,oBAAC;EAAK,GAAI;EAAO,aAAY;EAAK,MAAK;GAAU"}
+{"version":3,"file":"label.js","names":[],"sources":["../../../src/components/details-list/label.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 { Text } from 'react-aria-components';\nimport type { DetailsListLabelProps } from './types';\n\n/**\n * DetailsListLabel - Label component for DetailsList key/term.\n *\n * Renders as a `<dt>` element within the DetailsList grid.\n *\n * @param props - The details list label props.\n * @returns The details list label component.\n *\n * @example\n * ```tsx\n * <DetailsList>\n *   <DetailsListLabel>Name</DetailsListLabel>\n *   <DetailsListValue>John Doe</DetailsListValue>\n * </DetailsList>\n * ```\n */\nexport function DetailsListLabel(props: DetailsListLabelProps) {\n  return <Text {...props} elementType='dt' slot='label' />;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAiCA,SAAgB,iBAAiB,OAA8B;AAC7D,QAAO,oBAAC;EAAK,GAAI;EAAO,aAAY;EAAK,MAAK;GAAU"}

package/dist/components/details-list/types.d.ts

@@ -14,15 +14,29 @@ import { ComponentPropsWithRef, RefAttributes } from "react";
 import { TextProps } from "react-aria-components";
 
 //#region src/components/details-list/types.d.ts
+/**
+ * Props for the DetailsList component.
+ */
 type DetailsListProps = Omit<ComponentPropsWithRef<'dl'>, 'className'> & {
+  /** Custom class names for sub-elements. */
   classNames?: {
+    /** Class name for the list container. */
     list?: string;
+    /** Class name for label elements. */
     label?: string;
+    /** Class name for value elements. */
     value?: string;
   };
+  /** Text alignment for list items. */
   align?: 'center' | 'justify' | 'left';
 };
+/**
+ * Props for the DetailsListLabel component.
+ */
 type DetailsListLabelProps = Omit<TextProps, 'elementType'> & RefAttributes<HTMLElement>;
+/**
+ * Props for the DetailsListValue component.
+ */
 type DetailsListValueProps = Omit<TextProps, 'elementType'> & RefAttributes<HTMLElement>;
 //#endregion
 export { DetailsListLabelProps, DetailsListProps, DetailsListValueProps };

package/dist/components/details-list/value.d.ts

@@ -12,10 +12,28 @@
 
 import { DetailsListValueProps } from "./types.js";
 import "client-only";
-import * as react_jsx_runtime179 from "react/jsx-runtime";
+import * as react_jsx_runtime27 from "react/jsx-runtime";
 
 //#region src/components/details-list/value.d.ts
-declare function DetailsListValue(props: DetailsListValueProps): react_jsx_runtime179.JSX.Element;
+
+/**
+ * DetailsListValue - Value component for DetailsList definition.
+ *
+ * Renders as a `<dd>` element within the DetailsList grid.
+ * Supports complex React nodes as children for rich value content.
+ *
+ * @param props - The details list value props.
+ * @returns The details list value component.
+ *
+ * @example
+ * ```tsx
+ * <DetailsList>
+ *   <DetailsListLabel>Name</DetailsListLabel>
+ *   <DetailsListValue>John Doe</DetailsListValue>
+ * </DetailsList>
+ * ```
+ */
+declare function DetailsListValue(props: DetailsListValueProps): react_jsx_runtime27.JSX.Element;
 //#endregion
 export { DetailsListValue };
 //# sourceMappingURL=value.d.ts.map

package/dist/components/details-list/value.js

@@ -18,6 +18,23 @@ import { Text } from "react-aria-components";
 import { jsx } from "react/jsx-runtime";
 
 //#region src/components/details-list/value.tsx
+/**
+* DetailsListValue - Value component for DetailsList definition.
+*
+* Renders as a `<dd>` element within the DetailsList grid.
+* Supports complex React nodes as children for rich value content.
+*
+* @param props - The details list value props.
+* @returns The details list value component.
+*
+* @example
+* ```tsx
+* <DetailsList>
+*   <DetailsListLabel>Name</DetailsListLabel>
+*   <DetailsListValue>John Doe</DetailsListValue>
+* </DetailsList>
+* ```
+*/
 function DetailsListValue(props) {
 	return /* @__PURE__ */ jsx(Text, {
 		...props,

package/dist/components/details-list/value.js.map

@@ -1 +1 @@
-{"version":3,"file":"value.js","names":[],"sources":["../../../src/components/details-list/value.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 { Text } from 'react-aria-components';\nimport type { DetailsListValueProps } from './types';\n\nexport function DetailsListValue(props: DetailsListValueProps) {\n  return <Text {...props} elementType='dd' slot='value' />;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAiBA,SAAgB,iBAAiB,OAA8B;AAC7D,QAAO,oBAAC;EAAK,GAAI;EAAO,aAAY;EAAK,MAAK;GAAU"}
+{"version":3,"file":"value.js","names":[],"sources":["../../../src/components/details-list/value.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 { Text } from 'react-aria-components';\nimport type { DetailsListValueProps } from './types';\n\n/**\n * DetailsListValue - Value component for DetailsList definition.\n *\n * Renders as a `<dd>` element within the DetailsList grid.\n * Supports complex React nodes as children for rich value content.\n *\n * @param props - The details list value props.\n * @returns The details list value component.\n *\n * @example\n * ```tsx\n * <DetailsList>\n *   <DetailsListLabel>Name</DetailsListLabel>\n *   <DetailsListValue>John Doe</DetailsListValue>\n * </DetailsList>\n * ```\n */\nexport function DetailsListValue(props: DetailsListValueProps) {\n  return <Text {...props} elementType='dd' slot='value' />;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAkCA,SAAgB,iBAAiB,OAA8B;AAC7D,QAAO,oBAAC;EAAK,GAAI;EAAO,aAAY;EAAK,MAAK;GAAU"}

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

@@ -12,13 +12,34 @@
 
 import "client-only";
 import { ComponentProps } from "react";
-import * as react_jsx_runtime180 from "react/jsx-runtime";
+import * as react_jsx_runtime29 from "react/jsx-runtime";
 
 //#region src/components/dialog/content.d.ts
+
+/**
+ * DialogContent - Wrapper for the main dialog content.
+ *
+ * Provides appropriate spacing and styling for dialog body content.
+ *
+ * @param props - The dialog content props.
+ * @param props.children - Content to display in the dialog body.
+ * @param props.className - Additional CSS class name.
+ * @returns The dialog content component.
+ *
+ * @example
+ * ```tsx
+ * <Dialog>
+ *   <DialogTitle>Title</DialogTitle>
+ *   <DialogContent>
+ *     <p>Your content goes here...</p>
+ *   </DialogContent>
+ * </Dialog>
+ * ```
+ */
 declare function DialogContent({
   children,
   className
-}: ComponentProps<'div'>): react_jsx_runtime180.JSX.Element;
+}: ComponentProps<'div'>): react_jsx_runtime29.JSX.Element;
 //#endregion
 export { DialogContent };
 //# sourceMappingURL=content.d.ts.map

package/dist/components/dialog/content.js

@@ -19,6 +19,26 @@ import { jsx } from "react/jsx-runtime";
 import styles from "./styles.module.css";
 
 //#region src/components/dialog/content.tsx
+/**
+* DialogContent - Wrapper for the main dialog content.
+*
+* Provides appropriate spacing and styling for dialog body content.
+*
+* @param props - The dialog content props.
+* @param props.children - Content to display in the dialog body.
+* @param props.className - Additional CSS class name.
+* @returns The dialog content component.
+*
+* @example
+* ```tsx
+* <Dialog>
+*   <DialogTitle>Title</DialogTitle>
+*   <DialogContent>
+*     <p>Your content goes here...</p>
+*   </DialogContent>
+* </Dialog>
+* ```
+*/
 function DialogContent({ children, className }) {
 	return /* @__PURE__ */ jsx("div", {
 		className: clsx(styles.content, className),

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

@@ -1 +1 @@
-{"version":3,"file":"content.js","names":[],"sources":["../../../src/components/dialog/content.tsx"],"sourcesContent":["/*\n * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n'use client';\n\nimport 'client-only';\nimport { clsx } from '@accelint/design-foundation/lib/utils';\nimport styles from './styles.module.css';\nimport type { ComponentProps } from 'react';\n\nexport function DialogContent({ children, className }: ComponentProps<'div'>) {\n  return <div className={clsx(styles.content, className)}>{children}</div>;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAkBA,SAAgB,cAAc,EAAE,UAAU,aAAoC;AAC5E,QAAO,oBAAC;EAAI,WAAW,KAAK,OAAO,SAAS,UAAU;EAAG;GAAe"}
+{"version":3,"file":"content.js","names":[],"sources":["../../../src/components/dialog/content.tsx"],"sourcesContent":["/*\n * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n'use client';\n\nimport 'client-only';\nimport { clsx } from '@accelint/design-foundation/lib/utils';\nimport styles from './styles.module.css';\nimport type { ComponentProps } from 'react';\n\n/**\n * DialogContent - Wrapper for the main dialog content.\n *\n * Provides appropriate spacing and styling for dialog body content.\n *\n * @param props - The dialog content props.\n * @param props.children - Content to display in the dialog body.\n * @param props.className - Additional CSS class name.\n * @returns The dialog content component.\n *\n * @example\n * ```tsx\n * <Dialog>\n *   <DialogTitle>Title</DialogTitle>\n *   <DialogContent>\n *     <p>Your content goes here...</p>\n *   </DialogContent>\n * </Dialog>\n * ```\n */\nexport function DialogContent({ children, className }: ComponentProps<'div'>) {\n  return <div className={clsx(styles.content, className)}>{children}</div>;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAsCA,SAAgB,cAAc,EAAE,UAAU,aAAoC;AAC5E,QAAO,oBAAC;EAAI,WAAW,KAAK,OAAO,SAAS,UAAU;EAAG;GAAe"}

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

@@ -12,11 +12,14 @@
 
 import { DialogProps as DialogProps$1 } from "./types.js";
 import "client-only";
-import * as react44 from "react";
+import * as react12 from "react";
 import { ContextValue } from "react-aria-components";
 
 //#region src/components/dialog/context.d.ts
-declare const DialogContext: react44.Context<ContextValue<DialogProps$1, HTMLDivElement>>;
+/**
+ * Context for sharing Dialog props across component tree.
+ */
+declare const DialogContext: react12.Context<ContextValue<DialogProps$1, HTMLDivElement>>;
 //#endregion
 export { DialogContext };
 //# sourceMappingURL=context.d.ts.map

package/dist/components/dialog/context.js

@@ -17,6 +17,9 @@ import "client-only";
 import { createContext } from "react";
 
 //#region src/components/dialog/context.tsx
+/**
+* Context for sharing Dialog props across component tree.
+*/
 const DialogContext = createContext(null);
 
 //#endregion

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

@@ -1 +1 @@
-{"version":3,"file":"context.js","names":[],"sources":["../../../src/components/dialog/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'use client';\n\nimport 'client-only';\nimport { createContext } from 'react';\nimport type { ContextValue } from 'react-aria-components';\nimport type { DialogProps } from './types';\n\nexport const DialogContext =\n  createContext<ContextValue<DialogProps, HTMLDivElement>>(null);\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAkBA,MAAa,gBACX,cAAyD,KAAK"}
+{"version":3,"file":"context.js","names":[],"sources":["../../../src/components/dialog/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'use client';\n\nimport 'client-only';\nimport { createContext } from 'react';\nimport type { ContextValue } from 'react-aria-components';\nimport type { DialogProps } from './types';\n\n/**\n * Context for sharing Dialog props across component tree.\n */\nexport const DialogContext =\n  createContext<ContextValue<DialogProps, HTMLDivElement>>(null);\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAqBA,MAAa,gBACX,cAAyD,KAAK"}

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

@@ -12,13 +12,37 @@
 
 import "client-only";
 import { ComponentProps } from "react";
-import * as react_jsx_runtime174 from "react/jsx-runtime";
+import * as react_jsx_runtime33 from "react/jsx-runtime";
 
 //#region src/components/dialog/footer.d.ts
+
+/**
+ * DialogFooter - Container for dialog action buttons.
+ *
+ * Automatically sizes child Button components based on the dialog size
+ * and wires up default close behavior on button press.
+ *
+ * @param props - The dialog footer props.
+ * @param props.children - Action buttons to display in the footer.
+ * @param props.className - Additional CSS class name.
+ * @returns The dialog footer component.
+ *
+ * @example
+ * ```tsx
+ * <Dialog>
+ *   <DialogTitle>Confirm</DialogTitle>
+ *   <DialogContent>Are you sure?</DialogContent>
+ *   <DialogFooter>
+ *     <Button variant="flat">Cancel</Button>
+ *     <Button>Confirm</Button>
+ *   </DialogFooter>
+ * </Dialog>
+ * ```
+ */
 declare function DialogFooter({
   children,
   className
-}: ComponentProps<'footer'>): react_jsx_runtime174.JSX.Element;
+}: ComponentProps<'footer'>): react_jsx_runtime33.JSX.Element;
 //#endregion
 export { DialogFooter };
 //# sourceMappingURL=footer.d.ts.map

package/dist/components/dialog/footer.js

@@ -24,6 +24,29 @@ import { jsx } from "react/jsx-runtime";
 import styles from "./styles.module.css";
 
 //#region src/components/dialog/footer.tsx
+/**
+* DialogFooter - Container for dialog action buttons.
+*
+* Automatically sizes child Button components based on the dialog size
+* and wires up default close behavior on button press.
+*
+* @param props - The dialog footer props.
+* @param props.children - Action buttons to display in the footer.
+* @param props.className - Additional CSS class name.
+* @returns The dialog footer component.
+*
+* @example
+* ```tsx
+* <Dialog>
+*   <DialogTitle>Confirm</DialogTitle>
+*   <DialogContent>Are you sure?</DialogContent>
+*   <DialogFooter>
+*     <Button variant="flat">Cancel</Button>
+*     <Button>Confirm</Button>
+*   </DialogFooter>
+* </Dialog>
+* ```
+*/
 function DialogFooter({ children, className }) {
 	const context = useContext(DialogContext);
 	const size = (isSlottedContextValue(context) ? null : context?.size) ?? "small";

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

@@ -1 +1 @@
-{"version":3,"file":"footer.js","names":[],"sources":["../../../src/components/dialog/footer.tsx"],"sourcesContent":["/*\n * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n'use client';\n\nimport 'client-only';\nimport { clsx } from '@accelint/design-foundation/lib/utils';\nimport { type ComponentProps, useContext } from 'react';\nimport { OverlayTriggerStateContext } from 'react-aria-components';\nimport { isSlottedContextValue } from '../../lib/utils';\nimport { ButtonContext } from '../button/context';\nimport { DialogContext } from './context';\nimport styles from './styles.module.css';\n\nexport function DialogFooter({\n  children,\n  className,\n}: ComponentProps<'footer'>) {\n  const context = useContext(DialogContext);\n  const size =\n    (isSlottedContextValue(context) ? null : context?.size) ?? 'small';\n  const state = useContext(OverlayTriggerStateContext);\n\n  return (\n    <footer className={clsx(styles.footer, className)}>\n      <ButtonContext.Provider\n        value={{\n          size,\n          onPress: state?.close ?? undefined,\n        }}\n      >\n        {children}\n      </ButtonContext.Provider>\n    </footer>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAsBA,SAAgB,aAAa,EAC3B,UACA,aAC2B;CAC3B,MAAM,UAAU,WAAW,cAAc;CACzC,MAAM,QACH,sBAAsB,QAAQ,GAAG,OAAO,SAAS,SAAS;CAC7D,MAAM,QAAQ,WAAW,2BAA2B;AAEpD,QACE,oBAAC;EAAO,WAAW,KAAK,OAAO,QAAQ,UAAU;YAC/C,oBAAC,cAAc;GACb,OAAO;IACL;IACA,SAAS,OAAO,SAAS;IAC1B;GAEA;IACsB;GAClB"}
+{"version":3,"file":"footer.js","names":[],"sources":["../../../src/components/dialog/footer.tsx"],"sourcesContent":["/*\n * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n'use client';\n\nimport 'client-only';\nimport { clsx } from '@accelint/design-foundation/lib/utils';\nimport { type ComponentProps, useContext } from 'react';\nimport { OverlayTriggerStateContext } from 'react-aria-components';\nimport { isSlottedContextValue } from '../../lib/utils';\nimport { ButtonContext } from '../button/context';\nimport { DialogContext } from './context';\nimport styles from './styles.module.css';\n\n/**\n * DialogFooter - Container for dialog action buttons.\n *\n * Automatically sizes child Button components based on the dialog size\n * and wires up default close behavior on button press.\n *\n * @param props - The dialog footer props.\n * @param props.children - Action buttons to display in the footer.\n * @param props.className - Additional CSS class name.\n * @returns The dialog footer component.\n *\n * @example\n * ```tsx\n * <Dialog>\n *   <DialogTitle>Confirm</DialogTitle>\n *   <DialogContent>Are you sure?</DialogContent>\n *   <DialogFooter>\n *     <Button variant=\"flat\">Cancel</Button>\n *     <Button>Confirm</Button>\n *   </DialogFooter>\n * </Dialog>\n * ```\n */\nexport function DialogFooter({\n  children,\n  className,\n}: ComponentProps<'footer'>) {\n  const context = useContext(DialogContext);\n  const size =\n    (isSlottedContextValue(context) ? null : context?.size) ?? 'small';\n  const state = useContext(OverlayTriggerStateContext);\n\n  return (\n    <footer className={clsx(styles.footer, className)}>\n      <ButtonContext.Provider\n        value={{\n          size,\n          onPress: state?.close ?? undefined,\n        }}\n      >\n        {children}\n      </ButtonContext.Provider>\n    </footer>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6CA,SAAgB,aAAa,EAC3B,UACA,aAC2B;CAC3B,MAAM,UAAU,WAAW,cAAc;CACzC,MAAM,QACH,sBAAsB,QAAQ,GAAG,OAAO,SAAS,SAAS;CAC7D,MAAM,QAAQ,WAAW,2BAA2B;AAEpD,QACE,oBAAC;EAAO,WAAW,KAAK,OAAO,QAAQ,UAAU;YAC/C,oBAAC,cAAc;GACb,OAAO;IACL;IACA,SAAS,OAAO,SAAS;IAC1B;GAEA;IACsB;GAClB"}

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

@@ -12,7 +12,7 @@
 
 import { DialogProps } from "./types.js";
 import "client-only";
-import * as react_jsx_runtime176 from "react/jsx-runtime";
+import * as react_jsx_runtime36 from "react/jsx-runtime";
 
 //#region src/components/dialog/index.d.ts
 
@@ -23,7 +23,16 @@ import * as react_jsx_runtime176 from "react/jsx-runtime";
  * and keyboard navigation. Supports multiple sizes and customizable dismissal behavior.
  * Perfect for confirmations, forms, or any content requiring user focus.
  *
+ * @param props - The dialog props.
+ * @param props.ref - Reference to the dialog element.
+ * @param props.children - Dialog content (can be a render function with close callback).
+ * @param props.classNames - Custom class names for sub-elements.
+ * @param props.parentRef - Reference to parent element for portal rendering.
+ * @param props.size - Size variant of the dialog.
+ * @returns The dialog component.
+ *
  * @example
+ * ```tsx
  * // Basic dialog with trigger
  * <DialogTrigger>
  *   <Button>Open Dialog</Button>
@@ -39,11 +48,12 @@ import * as react_jsx_runtime176 from "react/jsx-runtime";
  *     )}
  *   </Dialog>
  * </DialogTrigger>
+ * ```
  */
 declare function Dialog({
   ref,
   ...props
-}: DialogProps): react_jsx_runtime176.JSX.Element;
+}: DialogProps): react_jsx_runtime36.JSX.Element;
 //#endregion
 export { Dialog };
 //# sourceMappingURL=index.d.ts.map

package/dist/components/dialog/index.js

@@ -29,7 +29,16 @@ import styles from "./styles.module.css";
 * and keyboard navigation. Supports multiple sizes and customizable dismissal behavior.
 * Perfect for confirmations, forms, or any content requiring user focus.
 *
+* @param props - The dialog props.
+* @param props.ref - Reference to the dialog element.
+* @param props.children - Dialog content (can be a render function with close callback).
+* @param props.classNames - Custom class names for sub-elements.
+* @param props.parentRef - Reference to parent element for portal rendering.
+* @param props.size - Size variant of the dialog.
+* @returns The dialog component.
+*
 * @example
+* ```tsx
 * // Basic dialog with trigger
 * <DialogTrigger>
 *   <Button>Open Dialog</Button>
@@ -45,6 +54,7 @@ import styles from "./styles.module.css";
 *     )}
 *   </Dialog>
 * </DialogTrigger>
+* ```
 */
 function Dialog({ ref, ...props }) {
 	[props, ref] = useContextProps(props, ref ?? null, DialogContext);

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["AriaDialog"],"sources":["../../../src/components/dialog/index.tsx"],"sourcesContent":["/*\n * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n'use client';\n\nimport 'client-only';\nimport { clsx } from '@accelint/design-foundation/lib/utils';\nimport {\n  Dialog as AriaDialog,\n  composeRenderProps,\n  Modal,\n  ModalOverlay,\n  useContextProps,\n} from 'react-aria-components';\nimport { PortalProvider } from '@/providers/portal';\nimport { DialogContext } from './context';\nimport styles from './styles.module.css';\nimport type { DialogProps } from './types';\n\n/**\n * Dialog - A modal dialog component for important content and interactions\n *\n * Provides accessible modal functionality with focus management, backdrop handling,\n * and keyboard navigation. Supports multiple sizes and customizable dismissal behavior.\n * Perfect for confirmations, forms, or any content requiring user focus.\n *\n * @example\n * // Basic dialog with trigger\n * <DialogTrigger>\n *   <Button>Open Dialog</Button>\n *   <Dialog>\n *     {({ close }) => (\n *       <>\n *         <DialogTitle>Confirm Action</DialogTitle>\n *         <p>Are you sure you want to continue?</p>\n *         <DialogFooter>\n *           <Button onPress={close}>Confirm</Button>\n *         </DialogFooter>\n *       </>\n *     )}\n *   </Dialog>\n * </DialogTrigger>\n */\nexport function Dialog({ ref, ...props }: DialogProps) {\n  [props, ref] = useContextProps(props, ref ?? null, DialogContext);\n\n  const { children, classNames, parentRef, size = 'small', ...rest } = props;\n\n  return (\n    <DialogContext.Provider value={props}>\n      <PortalProvider parentRef={parentRef}>\n        <ModalOverlay\n          {...rest}\n          ref={ref}\n          className={composeRenderProps(classNames?.overlay, (className) =>\n            clsx('group/dialog', styles.overlay, className),\n          )}\n          data-size={size}\n        >\n          <Modal\n            className={composeRenderProps(classNames?.modal, (className) =>\n              clsx(styles.modal, className),\n            )}\n          >\n            <AriaDialog className={clsx(styles.dialog, classNames?.dialog)}>\n              {children}\n            </AriaDialog>\n          </Modal>\n        </ModalOverlay>\n      </PortalProvider>\n    </DialogContext.Provider>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmDA,SAAgB,OAAO,EAAE,KAAK,GAAG,SAAsB;AACrD,EAAC,OAAO,OAAO,gBAAgB,OAAO,OAAO,MAAM,cAAc;CAEjE,MAAM,EAAE,UAAU,YAAY,WAAW,OAAO,SAAS,GAAG,SAAS;AAErE,QACE,oBAAC,cAAc;EAAS,OAAO;YAC7B,oBAAC;GAA0B;aACzB,oBAAC;IACC,GAAI;IACC;IACL,WAAW,mBAAmB,YAAY,UAAU,cAClD,KAAK,gBAAgB,OAAO,SAAS,UAAU,CAChD;IACD,aAAW;cAEX,oBAAC;KACC,WAAW,mBAAmB,YAAY,QAAQ,cAChD,KAAK,OAAO,OAAO,UAAU,CAC9B;eAED,oBAACA;MAAW,WAAW,KAAK,OAAO,QAAQ,YAAY,OAAO;MAC3D;OACU;MACP;KACK;IACA;GACM"}
+{"version":3,"file":"index.js","names":["AriaDialog"],"sources":["../../../src/components/dialog/index.tsx"],"sourcesContent":["/*\n * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n'use client';\n\nimport 'client-only';\nimport { clsx } from '@accelint/design-foundation/lib/utils';\nimport {\n  Dialog as AriaDialog,\n  composeRenderProps,\n  Modal,\n  ModalOverlay,\n  useContextProps,\n} from 'react-aria-components';\nimport { PortalProvider } from '@/providers/portal';\nimport { DialogContext } from './context';\nimport styles from './styles.module.css';\nimport type { DialogProps } from './types';\n\n/**\n * Dialog - A modal dialog component for important content and interactions\n *\n * Provides accessible modal functionality with focus management, backdrop handling,\n * and keyboard navigation. Supports multiple sizes and customizable dismissal behavior.\n * Perfect for confirmations, forms, or any content requiring user focus.\n *\n * @param props - The dialog props.\n * @param props.ref - Reference to the dialog element.\n * @param props.children - Dialog content (can be a render function with close callback).\n * @param props.classNames - Custom class names for sub-elements.\n * @param props.parentRef - Reference to parent element for portal rendering.\n * @param props.size - Size variant of the dialog.\n * @returns The dialog component.\n *\n * @example\n * ```tsx\n * // Basic dialog with trigger\n * <DialogTrigger>\n *   <Button>Open Dialog</Button>\n *   <Dialog>\n *     {({ close }) => (\n *       <>\n *         <DialogTitle>Confirm Action</DialogTitle>\n *         <p>Are you sure you want to continue?</p>\n *         <DialogFooter>\n *           <Button onPress={close}>Confirm</Button>\n *         </DialogFooter>\n *       </>\n *     )}\n *   </Dialog>\n * </DialogTrigger>\n * ```\n */\nexport function Dialog({ ref, ...props }: DialogProps) {\n  [props, ref] = useContextProps(props, ref ?? null, DialogContext);\n\n  const { children, classNames, parentRef, size = 'small', ...rest } = props;\n\n  return (\n    <DialogContext.Provider value={props}>\n      <PortalProvider parentRef={parentRef}>\n        <ModalOverlay\n          {...rest}\n          ref={ref}\n          className={composeRenderProps(classNames?.overlay, (className) =>\n            clsx('group/dialog', styles.overlay, className),\n          )}\n          data-size={size}\n        >\n          <Modal\n            className={composeRenderProps(classNames?.modal, (className) =>\n              clsx(styles.modal, className),\n            )}\n          >\n            <AriaDialog className={clsx(styles.dialog, classNames?.dialog)}>\n              {children}\n            </AriaDialog>\n          </Modal>\n        </ModalOverlay>\n      </PortalProvider>\n    </DialogContext.Provider>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6DA,SAAgB,OAAO,EAAE,KAAK,GAAG,SAAsB;AACrD,EAAC,OAAO,OAAO,gBAAgB,OAAO,OAAO,MAAM,cAAc;CAEjE,MAAM,EAAE,UAAU,YAAY,WAAW,OAAO,SAAS,GAAG,SAAS;AAErE,QACE,oBAAC,cAAc;EAAS,OAAO;YAC7B,oBAAC;GAA0B;aACzB,oBAAC;IACC,GAAI;IACC;IACL,WAAW,mBAAmB,YAAY,UAAU,cAClD,KAAK,gBAAgB,OAAO,SAAS,UAAU,CAChD;IACD,aAAW;cAEX,oBAAC;KACC,WAAW,mBAAmB,YAAY,QAAQ,cAChD,KAAK,OAAO,OAAO,UAAU,CAC9B;eAED,oBAACA;MAAW,WAAW,KAAK,OAAO,QAAQ,YAAY,OAAO;MAC3D;OACU;MACP;KACK;IACA;GACM"}

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

@@ -12,13 +12,32 @@
 
 import "client-only";
 import { HeadingProps } from "react-aria-components";
-import * as react_jsx_runtime178 from "react/jsx-runtime";
+import * as react_jsx_runtime39 from "react/jsx-runtime";
 
 //#region src/components/dialog/title.d.ts
+
+/**
+ * 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>
+ * ```
+ */
 declare function DialogTitle({
   children,
   className
-}: HeadingProps): react_jsx_runtime178.JSX.Element;
+}: HeadingProps): react_jsx_runtime39.JSX.Element;
 //#endregion
 export { DialogTitle };
 //# sourceMappingURL=title.d.ts.map