@accelint/design-toolkit 9.3.0 → 9.4.0

package/dist/components/options/item-description.d.ts

@@ -11,13 +11,25 @@
  */
 
 import { TextProps } from "react-aria-components";
-import * as react_jsx_runtime147 from "react/jsx-runtime";
+import * as react_jsx_runtime104 from "react/jsx-runtime";
 
 //#region src/components/options/item-description.d.ts
+/**
+ * OptionsItemDescription - Secondary text description for an options item
+ *
+ * @example
+ * ```tsx
+ * <OptionsItemDescription>Additional details about this option</OptionsItemDescription>
+ * ```
+ *
+ * @param props - TextProps from react-aria-components.
+ * @param props.className - Optional CSS class name.
+ * @returns The rendered OptionsItemDescription component.
+ */
 declare function OptionsItemDescription({
   className,
   ...rest
-}: TextProps): react_jsx_runtime147.JSX.Element;
+}: TextProps): react_jsx_runtime104.JSX.Element;
 //#endregion
 export { OptionsItemDescription };
 //# sourceMappingURL=item-description.d.ts.map

package/dist/components/options/item-description.js

@@ -17,6 +17,18 @@ import { jsx } from "react/jsx-runtime";
 import styles from "./styles.module.css";
 
 //#region src/components/options/item-description.tsx
+/**
+* OptionsItemDescription - Secondary text description for an options item
+*
+* @example
+* ```tsx
+* <OptionsItemDescription>Additional details about this option</OptionsItemDescription>
+* ```
+*
+* @param props - TextProps from react-aria-components.
+* @param props.className - Optional CSS class name.
+* @returns The rendered OptionsItemDescription component.
+*/
 function OptionsItemDescription({ className, ...rest }) {
 	return /* @__PURE__ */ jsx(Text, {
 		...rest,

package/dist/components/options/item-description.js.map

@@ -1 +1 @@
-{"version":3,"file":"item-description.js","names":[],"sources":["../../../src/components/options/item-description.tsx"],"sourcesContent":["/*\n * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\nimport { clsx } from '@accelint/design-foundation/lib/utils';\nimport { Text } from 'react-aria-components';\nimport styles from './styles.module.css';\nimport type { TextProps } from 'react-aria-components';\n\nexport function OptionsItemDescription({ className, ...rest }: TextProps) {\n  return (\n    <Text\n      {...rest}\n      slot='description'\n      className={clsx(styles.description, className)}\n    />\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAiBA,SAAgB,uBAAuB,EAAE,WAAW,GAAG,QAAmB;AACxE,QACE,oBAAC;EACC,GAAI;EACJ,MAAK;EACL,WAAW,KAAK,OAAO,aAAa,UAAU;GAC9C"}
+{"version":3,"file":"item-description.js","names":[],"sources":["../../../src/components/options/item-description.tsx"],"sourcesContent":["/*\n * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\nimport { clsx } from '@accelint/design-foundation/lib/utils';\nimport { Text } from 'react-aria-components';\nimport styles from './styles.module.css';\nimport type { TextProps } from 'react-aria-components';\n\n/**\n * OptionsItemDescription - Secondary text description for an options item\n *\n * @example\n * ```tsx\n * <OptionsItemDescription>Additional details about this option</OptionsItemDescription>\n * ```\n *\n * @param props - TextProps from react-aria-components.\n * @param props.className - Optional CSS class name.\n * @returns The rendered OptionsItemDescription component.\n */\nexport function OptionsItemDescription({ className, ...rest }: TextProps) {\n  return (\n    <Text\n      {...rest}\n      slot='description'\n      className={clsx(styles.description, className)}\n    />\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6BA,SAAgB,uBAAuB,EAAE,WAAW,GAAG,QAAmB;AACxE,QACE,oBAAC;EACC,GAAI;EACJ,MAAK;EACL,WAAW,KAAK,OAAO,aAAa,UAAU;GAC9C"}

package/dist/components/options/item-label.d.ts

@@ -11,13 +11,25 @@
  */
 
 import { TextProps } from "react-aria-components";
-import * as react_jsx_runtime148 from "react/jsx-runtime";
+import * as react_jsx_runtime103 from "react/jsx-runtime";
 
 //#region src/components/options/item-label.d.ts
+/**
+ * OptionsItemLabel - Primary text label for an options item
+ *
+ * @example
+ * ```tsx
+ * <OptionsItemLabel>Option Name</OptionsItemLabel>
+ * ```
+ *
+ * @param props - TextProps from react-aria-components.
+ * @param props.className - Optional CSS class name.
+ * @returns The rendered OptionsItemLabel component.
+ */
 declare function OptionsItemLabel({
   className,
   ...rest
-}: TextProps): react_jsx_runtime148.JSX.Element;
+}: TextProps): react_jsx_runtime103.JSX.Element;
 //#endregion
 export { OptionsItemLabel };
 //# sourceMappingURL=item-label.d.ts.map

package/dist/components/options/item-label.js

@@ -17,6 +17,18 @@ import { jsx } from "react/jsx-runtime";
 import styles from "./styles.module.css";
 
 //#region src/components/options/item-label.tsx
+/**
+* OptionsItemLabel - Primary text label for an options item
+*
+* @example
+* ```tsx
+* <OptionsItemLabel>Option Name</OptionsItemLabel>
+* ```
+*
+* @param props - TextProps from react-aria-components.
+* @param props.className - Optional CSS class name.
+* @returns The rendered OptionsItemLabel component.
+*/
 function OptionsItemLabel({ className, ...rest }) {
 	return /* @__PURE__ */ jsx(Text, {
 		...rest,

package/dist/components/options/item-label.js.map

@@ -1 +1 @@
-{"version":3,"file":"item-label.js","names":[],"sources":["../../../src/components/options/item-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\nimport { clsx } from '@accelint/design-foundation/lib/utils';\nimport { Text } from 'react-aria-components';\nimport styles from './styles.module.css';\nimport type { TextProps } from 'react-aria-components';\n\nexport function OptionsItemLabel({ className, ...rest }: TextProps) {\n  return (\n    <Text {...rest} slot='label' className={clsx(styles.label, className)} />\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAiBA,SAAgB,iBAAiB,EAAE,WAAW,GAAG,QAAmB;AAClE,QACE,oBAAC;EAAK,GAAI;EAAM,MAAK;EAAQ,WAAW,KAAK,OAAO,OAAO,UAAU;GAAI"}
+{"version":3,"file":"item-label.js","names":[],"sources":["../../../src/components/options/item-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\nimport { clsx } from '@accelint/design-foundation/lib/utils';\nimport { Text } from 'react-aria-components';\nimport styles from './styles.module.css';\nimport type { TextProps } from 'react-aria-components';\n\n/**\n * OptionsItemLabel - Primary text label for an options item\n *\n * @example\n * ```tsx\n * <OptionsItemLabel>Option Name</OptionsItemLabel>\n * ```\n *\n * @param props - TextProps from react-aria-components.\n * @param props.className - Optional CSS class name.\n * @returns The rendered OptionsItemLabel component.\n */\nexport function OptionsItemLabel({ className, ...rest }: TextProps) {\n  return (\n    <Text {...rest} slot='label' className={clsx(styles.label, className)} />\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6BA,SAAgB,iBAAiB,EAAE,WAAW,GAAG,QAAmB;AAClE,QACE,oBAAC;EAAK,GAAI;EAAM,MAAK;EAAQ,WAAW,KAAK,OAAO,OAAO,UAAU;GAAI"}

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

@@ -12,16 +12,38 @@
 
 import { OptionsDataItem, OptionsItemProps } from "./types.js";
 import "client-only";
-import * as react_jsx_runtime149 from "react/jsx-runtime";
+import * as react_jsx_runtime105 from "react/jsx-runtime";
 
 //#region src/components/options/item.d.ts
+
+/**
+ * OptionsItem - Individual selectable item within an Options list
+ *
+ * Supports icons, labels, descriptions, and color variants.
+ * String children are automatically wrapped in OptionsItemLabel.
+ *
+ * @example
+ * ```tsx
+ * <OptionsItem textValue="Edit">
+ *   <Icon><Edit /></Icon>
+ *   <OptionsItemLabel>Edit</OptionsItemLabel>
+ * </OptionsItem>
+ * ```
+ *
+ * @param props - {@link OptionsItemProps}
+ * @param props.children - Content to render inside the item.
+ * @param props.classNames - CSS class names for item elements.
+ * @param props.color - Color variant for the item.
+ * @param props.textValue - Accessible text value for the item.
+ * @returns The rendered OptionsItem component.
+ */
 declare function OptionsItem<T extends OptionsDataItem>({
   children,
   classNames,
   color,
   textValue,
   ...rest
-}: OptionsItemProps<T>): react_jsx_runtime149.JSX.Element;
+}: OptionsItemProps<T>): react_jsx_runtime105.JSX.Element;
 //#endregion
 export { OptionsItem };
 //# sourceMappingURL=item.d.ts.map

package/dist/components/options/item.js

@@ -22,6 +22,27 @@ import { jsx } from "react/jsx-runtime";
 import styles from "./styles.module.css";
 
 //#region src/components/options/item.tsx
+/**
+* OptionsItem - Individual selectable item within an Options list
+*
+* Supports icons, labels, descriptions, and color variants.
+* String children are automatically wrapped in OptionsItemLabel.
+*
+* @example
+* ```tsx
+* <OptionsItem textValue="Edit">
+*   <Icon><Edit /></Icon>
+*   <OptionsItemLabel>Edit</OptionsItemLabel>
+* </OptionsItem>
+* ```
+*
+* @param props - {@link OptionsItemProps}
+* @param props.children - Content to render inside the item.
+* @param props.classNames - CSS class names for item elements.
+* @param props.color - Color variant for the item.
+* @param props.textValue - Accessible text value for the item.
+* @returns The rendered OptionsItem component.
+*/
 function OptionsItem({ children, classNames, color = "info", textValue = typeof children === "string" ? children : "", ...rest }) {
 	return /* @__PURE__ */ jsx(ListBoxItem, {
 		...rest,

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

@@ -1 +1 @@
-{"version":3,"file":"item.js","names":["children"],"sources":["../../../src/components/options/item.tsx"],"sourcesContent":["/*\n * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n'use client';\n\nimport 'client-only';\nimport { clsx } from '@accelint/design-foundation/lib/utils';\nimport { composeRenderProps, ListBoxItem } from 'react-aria-components';\nimport { IconProvider } from '../icon/context';\nimport { OptionsItemLabel } from './item-label';\nimport styles from './styles.module.css';\nimport type { OptionsDataItem, OptionsItemProps } from './types';\n\nexport function OptionsItem<T extends OptionsDataItem>({\n  children,\n  classNames,\n  color = 'info',\n  textValue = typeof children === 'string' ? children : '',\n  ...rest\n}: OptionsItemProps<T>) {\n  return (\n    <ListBoxItem\n      {...rest}\n      className={composeRenderProps(classNames?.item, (className) =>\n        clsx('group/options-item', styles.item, className),\n      )}\n      textValue={textValue}\n      data-color={color}\n    >\n      {composeRenderProps(children, (children) => (\n        <IconProvider\n          className={clsx(styles.icon, classNames?.icon)}\n          size='small'\n        >\n          {typeof children === 'string' ? (\n            <OptionsItemLabel>{children}</OptionsItemLabel>\n          ) : (\n            children\n          )}\n        </IconProvider>\n      ))}\n    </ListBoxItem>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AAqBA,SAAgB,YAAuC,EACrD,UACA,YACA,QAAQ,QACR,YAAY,OAAO,aAAa,WAAW,WAAW,IACtD,GAAG,QACmB;AACtB,QACE,oBAAC;EACC,GAAI;EACJ,WAAW,mBAAmB,YAAY,OAAO,cAC/C,KAAK,sBAAsB,OAAO,MAAM,UAAU,CACnD;EACU;EACX,cAAY;YAEX,mBAAmB,WAAW,eAC7B,oBAAC;GACC,WAAW,KAAK,OAAO,MAAM,YAAY,KAAK;GAC9C,MAAK;aAEJ,OAAOA,eAAa,WACnB,oBAAC,8BAAkBA,aAA4B,GAE/CA;IAEW,CACf;GACU"}
+{"version":3,"file":"item.js","names":["children"],"sources":["../../../src/components/options/item.tsx"],"sourcesContent":["/*\n * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n'use client';\n\nimport 'client-only';\nimport { clsx } from '@accelint/design-foundation/lib/utils';\nimport { composeRenderProps, ListBoxItem } from 'react-aria-components';\nimport { IconProvider } from '../icon/context';\nimport { OptionsItemLabel } from './item-label';\nimport styles from './styles.module.css';\nimport type { OptionsDataItem, OptionsItemProps } from './types';\n\n/**\n * OptionsItem - Individual selectable item within an Options list\n *\n * Supports icons, labels, descriptions, and color variants.\n * String children are automatically wrapped in OptionsItemLabel.\n *\n * @example\n * ```tsx\n * <OptionsItem textValue=\"Edit\">\n *   <Icon><Edit /></Icon>\n *   <OptionsItemLabel>Edit</OptionsItemLabel>\n * </OptionsItem>\n * ```\n *\n * @param props - {@link OptionsItemProps}\n * @param props.children - Content to render inside the item.\n * @param props.classNames - CSS class names for item elements.\n * @param props.color - Color variant for the item.\n * @param props.textValue - Accessible text value for the item.\n * @returns The rendered OptionsItem component.\n */\nexport function OptionsItem<T extends OptionsDataItem>({\n  children,\n  classNames,\n  color = 'info',\n  textValue = typeof children === 'string' ? children : '',\n  ...rest\n}: OptionsItemProps<T>) {\n  return (\n    <ListBoxItem\n      {...rest}\n      className={composeRenderProps(classNames?.item, (className) =>\n        clsx('group/options-item', styles.item, className),\n      )}\n      textValue={textValue}\n      data-color={color}\n    >\n      {composeRenderProps(children, (children) => (\n        <IconProvider\n          className={clsx(styles.icon, classNames?.icon)}\n          size='small'\n        >\n          {typeof children === 'string' ? (\n            <OptionsItemLabel>{children}</OptionsItemLabel>\n          ) : (\n            children\n          )}\n        </IconProvider>\n      ))}\n    </ListBoxItem>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA0CA,SAAgB,YAAuC,EACrD,UACA,YACA,QAAQ,QACR,YAAY,OAAO,aAAa,WAAW,WAAW,IACtD,GAAG,QACmB;AACtB,QACE,oBAAC;EACC,GAAI;EACJ,WAAW,mBAAmB,YAAY,OAAO,cAC/C,KAAK,sBAAsB,OAAO,MAAM,UAAU,CACnD;EACU;EACX,cAAY;YAEX,mBAAmB,WAAW,eAC7B,oBAAC;GACC,WAAW,KAAK,OAAO,MAAM,YAAY,KAAK;GAC9C,MAAK;aAEJ,OAAOA,eAAa,WACnB,oBAAC,8BAAkBA,aAA4B,GAE/CA;IAEW,CACf;GACU"}

package/dist/components/options/section.d.ts

@@ -11,15 +11,34 @@
  */
 
 import { OptionsDataItem, OptionsSectionProps } from "./types.js";
-import * as react_jsx_runtime150 from "react/jsx-runtime";
+import * as react_jsx_runtime106 from "react/jsx-runtime";
 
 //#region src/components/options/section.d.ts
+
+/**
+ * OptionsSection - Groups related options with an optional header
+ *
+ * @example
+ * ```tsx
+ * <OptionsSection header="Recent">
+ *   <OptionsItem>Item 1</OptionsItem>
+ *   <OptionsItem>Item 2</OptionsItem>
+ * </OptionsSection>
+ * ```
+ *
+ * @param props - {@link OptionsSectionProps}
+ * @param props.children - Options items to render in the section.
+ * @param props.classNames - CSS class names for section elements.
+ * @param props.header - Header text for the section.
+ * @param props.items - Collection of items for dynamic rendering.
+ * @returns The rendered OptionsSection component.
+ */
 declare function OptionsSection<T extends OptionsDataItem>({
   children,
   classNames,
   header,
   items
-}: OptionsSectionProps<T>): react_jsx_runtime150.JSX.Element;
+}: OptionsSectionProps<T>): react_jsx_runtime106.JSX.Element;
 //#endregion
 export { OptionsSection };
 //# sourceMappingURL=section.d.ts.map

package/dist/components/options/section.js

@@ -17,6 +17,24 @@ import { jsx, jsxs } from "react/jsx-runtime";
 import styles from "./styles.module.css";
 
 //#region src/components/options/section.tsx
+/**
+* OptionsSection - Groups related options with an optional header
+*
+* @example
+* ```tsx
+* <OptionsSection header="Recent">
+*   <OptionsItem>Item 1</OptionsItem>
+*   <OptionsItem>Item 2</OptionsItem>
+* </OptionsSection>
+* ```
+*
+* @param props - {@link OptionsSectionProps}
+* @param props.children - Options items to render in the section.
+* @param props.classNames - CSS class names for section elements.
+* @param props.header - Header text for the section.
+* @param props.items - Collection of items for dynamic rendering.
+* @returns The rendered OptionsSection component.
+*/
 function OptionsSection({ children, classNames, header, items }) {
 	return /* @__PURE__ */ jsxs(ListBoxSection, {
 		id: header,

package/dist/components/options/section.js.map

@@ -1 +1 @@
-{"version":3,"file":"section.js","names":[],"sources":["../../../src/components/options/section.tsx"],"sourcesContent":["/*\n * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\nimport { clsx } from '@accelint/design-foundation/lib/utils';\nimport { Collection, Header, ListBoxSection } from 'react-aria-components';\nimport styles from './styles.module.css';\nimport type { OptionsDataItem, OptionsSectionProps } from './types';\n\nexport function OptionsSection<T extends OptionsDataItem>({\n  children,\n  classNames,\n  header,\n  items,\n}: OptionsSectionProps<T>) {\n  return (\n    <ListBoxSection\n      id={header}\n      className={clsx(styles.section, classNames?.section)}\n    >\n      <Header className={clsx(styles.header, classNames?.header)}>\n        {header}\n      </Header>\n      <Collection items={items}>{children}</Collection>\n    </ListBoxSection>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAiBA,SAAgB,eAA0C,EACxD,UACA,YACA,QACA,SACyB;AACzB,QACE,qBAAC;EACC,IAAI;EACJ,WAAW,KAAK,OAAO,SAAS,YAAY,QAAQ;aAEpD,oBAAC;GAAO,WAAW,KAAK,OAAO,QAAQ,YAAY,OAAO;aACvD;IACM,EACT,oBAAC;GAAkB;GAAQ;IAAsB;GAClC"}
+{"version":3,"file":"section.js","names":[],"sources":["../../../src/components/options/section.tsx"],"sourcesContent":["/*\n * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\nimport { clsx } from '@accelint/design-foundation/lib/utils';\nimport { Collection, Header, ListBoxSection } from 'react-aria-components';\nimport styles from './styles.module.css';\nimport type { OptionsDataItem, OptionsSectionProps } from './types';\n\n/**\n * OptionsSection - Groups related options with an optional header\n *\n * @example\n * ```tsx\n * <OptionsSection header=\"Recent\">\n *   <OptionsItem>Item 1</OptionsItem>\n *   <OptionsItem>Item 2</OptionsItem>\n * </OptionsSection>\n * ```\n *\n * @param props - {@link OptionsSectionProps}\n * @param props.children - Options items to render in the section.\n * @param props.classNames - CSS class names for section elements.\n * @param props.header - Header text for the section.\n * @param props.items - Collection of items for dynamic rendering.\n * @returns The rendered OptionsSection component.\n */\nexport function OptionsSection<T extends OptionsDataItem>({\n  children,\n  classNames,\n  header,\n  items,\n}: OptionsSectionProps<T>) {\n  return (\n    <ListBoxSection\n      id={header}\n      className={clsx(styles.section, classNames?.section)}\n    >\n      <Header className={clsx(styles.header, classNames?.header)}>\n        {header}\n      </Header>\n      <Collection items={items}>{children}</Collection>\n    </ListBoxSection>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmCA,SAAgB,eAA0C,EACxD,UACA,YACA,QACA,SACyB;AACzB,QACE,qBAAC;EACC,IAAI;EACJ,WAAW,KAAK,OAAO,SAAS,YAAY,QAAQ;aAEpD,oBAAC;GAAO,WAAW,KAAK,OAAO,QAAQ,YAAY,OAAO;aACvD;IACM,EACT,oBAAC;GAAkB;GAAQ;IAAsB;GAClC"}

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

@@ -15,26 +15,50 @@ import { RefAttributes } from "react";
 import { Key, ListBoxItemProps, ListBoxProps, ListBoxSectionProps } from "react-aria-components";
 
 //#region src/components/options/types.d.ts
+/**
+ * Data structure for options items supporting hierarchical collections.
+ */
 type OptionsDataItem = {
+  /** Unique identifier for the item. */
   id: Key;
+  /** Display name for the item. */
   name: string;
+  /** Nested child items for hierarchical structures. */
   children?: OptionsDataItem[];
 };
+/**
+ * Props for the OptionsItem component.
+ */
 type OptionsItemProps<T extends OptionsDataItem> = Omit<ListBoxItemProps<T>, 'className'> & RefAttributes<T> & {
+  /** CSS class names for item elements. */
   classNames?: {
+    /** Class name for the item container. */
     item?: ListBoxItemProps['className'];
+    /** Class name for the item icon. */
     icon?: IconProps['className'];
   };
+  /** Color variant for the item. */
   color?: 'info' | 'serious' | 'critical';
 };
+/**
+ * Props for the Options component.
+ */
 type OptionsProps<T extends OptionsDataItem> = Omit<ListBoxProps<T>, 'orientation' | 'layout'> & RefAttributes<HTMLDivElement> & {
+  /** Size variant for the options list. */
   size?: 'small' | 'large';
 };
+/**
+ * Props for the OptionsSection component.
+ */
 type OptionsSectionProps<T extends OptionsDataItem> = Omit<ListBoxSectionProps<T>, 'className'> & {
+  /** CSS class names for section elements. */
   classNames?: {
+    /** Class name for the section container. */
     section?: ListBoxSectionProps<T>['className'];
+    /** Class name for the section header. */
     header?: string;
   };
+  /** Header text for the section. */
   header?: string;
 };
 //#endregion

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

@@ -12,10 +12,11 @@
 
 import { PaginationContextValue } from "./types.js";
 import "client-only";
-import * as react40 from "react";
+import * as react30 from "react";
 
 //#region src/components/pagination/context.d.ts
-declare const PaginationContext: react40.Context<PaginationContextValue>;
+/** Context for sharing pagination state with sub-components */
+declare const PaginationContext: react30.Context<PaginationContextValue>;
 //#endregion
 export { PaginationContext };
 //# sourceMappingURL=context.d.ts.map

package/dist/components/pagination/context.js

@@ -18,6 +18,7 @@ import { createContext } from "react";
 import { noop } from "radashi";
 
 //#region src/components/pagination/context.ts
+/** Context for sharing pagination state with sub-components */
 const PaginationContext = createContext({
 	page: 0,
 	total: 0,

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

@@ -1 +1 @@
-{"version":3,"file":"context.js","names":[],"sources":["../../../src/components/pagination/context.ts"],"sourcesContent":["/*\n * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\n'use client';\n\nimport 'client-only';\nimport { noop } from 'radashi';\nimport { createContext } from 'react';\nimport type { PaginationContextValue } from './types';\n\nexport const PaginationContext = createContext<PaginationContextValue>({\n  page: 0,\n  total: 0,\n  setPage: noop,\n});\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAmBA,MAAa,oBAAoB,cAAsC;CACrE,MAAM;CACN,OAAO;CACP,SAAS;CACV,CAAC"}
+{"version":3,"file":"context.js","names":[],"sources":["../../../src/components/pagination/context.ts"],"sourcesContent":["/*\n * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\n'use client';\n\nimport 'client-only';\nimport { noop } from 'radashi';\nimport { createContext } from 'react';\nimport type { PaginationContextValue } from './types';\n\n/** Context for sharing pagination state with sub-components */\nexport const PaginationContext = createContext<PaginationContextValue>({\n  page: 0,\n  total: 0,\n  setPage: noop,\n});\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAoBA,MAAa,oBAAoB,cAAsC;CACrE,MAAM;CACN,OAAO;CACP,SAAS;CACV,CAAC"}

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

@@ -12,23 +12,30 @@
 
 import { PaginationProps } from "./types.js";
 import "client-only";
-import * as react_jsx_runtime151 from "react/jsx-runtime";
+import * as react_jsx_runtime107 from "react/jsx-runtime";
 
 //#region src/components/pagination/index.d.ts
+
 /**
+ * Pagination - Lightweight page navigation with prev/next controls
  *
- * Pagination - A lightweight implementation for page navigation.
+ * Displays up to 5 page numbers at a time, automatically adjusting
+ * the visible range as the user navigates.
  *
  * @example
- * <Pagination currentPage={1} pageCount={5} onChange={handleOnChange} />
+ * ```tsx
+ * <Pagination value={1} total={10} onChange={setPage} />
+ * ```
  *
- * @param currentPage - represents currently selected page number
- * @param pageCount - total number of pages
- * @param onChange - (page: number) => void, handler for button press events
- * @param classNames - group of styling applied to components
- *    * container - <nav> container for component
- *    * controls - navigation controls, previous/next
- *    * pages - buttons for page numbers
+ * @param props - {@link PaginationProps}
+ * @param props.children - Custom pagination content (overrides default layout).
+ * @param props.classNames - CSS class names for pagination elements.
+ * @param props.defaultValue - Default page number for uncontrolled mode.
+ * @param props.total - Total number of pages.
+ * @param props.value - Current page number for controlled mode (1-indexed).
+ * @param props.isLoading - Whether the pagination is in a loading state.
+ * @param props.onChange - Handler called when the page changes.
+ * @returns The rendered Pagination component.
  */
 declare function Pagination({
   children,
@@ -39,7 +46,7 @@ declare function Pagination({
   isLoading,
   onChange,
   ...rest
-}: PaginationProps): react_jsx_runtime151.JSX.Element;
+}: PaginationProps): react_jsx_runtime107.JSX.Element;
 //#endregion
 export { Pagination };
 //# sourceMappingURL=index.d.ts.map

package/dist/components/pagination/index.js

@@ -25,19 +25,25 @@ import styles from "./styles.module.css";
 
 //#region src/components/pagination/index.tsx
 /**
+* Pagination - Lightweight page navigation with prev/next controls
 *
-* Pagination - A lightweight implementation for page navigation.
+* Displays up to 5 page numbers at a time, automatically adjusting
+* the visible range as the user navigates.
 *
 * @example
-* <Pagination currentPage={1} pageCount={5} onChange={handleOnChange} />
+* ```tsx
+* <Pagination value={1} total={10} onChange={setPage} />
+* ```
 *
-* @param currentPage - represents currently selected page number
-* @param pageCount - total number of pages
-* @param onChange - (page: number) => void, handler for button press events
-* @param classNames - group of styling applied to components
-*    * container - <nav> container for component
-*    * controls - navigation controls, previous/next
-*    * pages - buttons for page numbers
+* @param props - {@link PaginationProps}
+* @param props.children - Custom pagination content (overrides default layout).
+* @param props.classNames - CSS class names for pagination elements.
+* @param props.defaultValue - Default page number for uncontrolled mode.
+* @param props.total - Total number of pages.
+* @param props.value - Current page number for controlled mode (1-indexed).
+* @param props.isLoading - Whether the pagination is in a loading state.
+* @param props.onChange - Handler called when the page changes.
+* @returns The rendered Pagination component.
 */
 function Pagination({ children, classNames, defaultValue = 1, total = 0, value, isLoading, onChange, ...rest }) {
 	const [page, setPage] = useControlledState(value, defaultValue, onChange);

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../../src/components/pagination/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 { useControlledState } from '@react-stately/utils';\nimport { PaginationContext } from './context';\nimport { PaginationNext } from './next';\nimport { PaginationPages } from './pages';\nimport { PaginationPrev } from './prev';\nimport styles from './styles.module.css';\nimport type { PaginationProps } from './types';\n\n/**\n *\n * Pagination - A lightweight implementation for page navigation.\n *\n * @example\n * <Pagination currentPage={1} pageCount={5} onChange={handleOnChange} />\n *\n * @param currentPage - represents currently selected page number\n * @param pageCount - total number of pages\n * @param onChange - (page: number) => void, handler for button press events\n * @param classNames - group of styling applied to components\n *    * container - <nav> container for component\n *    * controls - navigation controls, previous/next\n *    * pages - buttons for page numbers\n */\nexport function Pagination({\n  children,\n  classNames,\n  defaultValue = 1,\n  total = 0,\n  value,\n  isLoading,\n  onChange,\n  ...rest\n}: PaginationProps) {\n  const [page, setPage] = useControlledState(value, defaultValue, onChange);\n\n  return (\n    <PaginationContext.Provider value={{ page, total, isLoading, setPage }}>\n      <nav\n        {...rest}\n        className={clsx(styles.container, classNames?.container)}\n        aria-label={`Page ${page} of ${total}`}\n      >\n        {children || (\n          <>\n            <PaginationPrev className={classNames?.prev} />\n            <PaginationPages className={classNames?.pages} />\n            <PaginationNext className={classNames?.next} />\n          </>\n        )}\n      </nav>\n    </PaginationContext.Provider>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAuCA,SAAgB,WAAW,EACzB,UACA,YACA,eAAe,GACf,QAAQ,GACR,OACA,WACA,UACA,GAAG,QACe;CAClB,MAAM,CAAC,MAAM,WAAW,mBAAmB,OAAO,cAAc,SAAS;AAEzE,QACE,oBAAC,kBAAkB;EAAS,OAAO;GAAE;GAAM;GAAO;GAAW;GAAS;YACpE,oBAAC;GACC,GAAI;GACJ,WAAW,KAAK,OAAO,WAAW,YAAY,UAAU;GACxD,cAAY,QAAQ,KAAK,MAAM;aAE9B,YACC;IACE,oBAAC,kBAAe,WAAW,YAAY,OAAQ;IAC/C,oBAAC,mBAAgB,WAAW,YAAY,QAAS;IACjD,oBAAC,kBAAe,WAAW,YAAY,OAAQ;OAC9C;IAED;GACqB"}
+{"version":3,"file":"index.js","names":[],"sources":["../../../src/components/pagination/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 { useControlledState } from '@react-stately/utils';\nimport { PaginationContext } from './context';\nimport { PaginationNext } from './next';\nimport { PaginationPages } from './pages';\nimport { PaginationPrev } from './prev';\nimport styles from './styles.module.css';\nimport type { PaginationProps } from './types';\n\n/**\n * Pagination - Lightweight page navigation with prev/next controls\n *\n * Displays up to 5 page numbers at a time, automatically adjusting\n * the visible range as the user navigates.\n *\n * @example\n * ```tsx\n * <Pagination value={1} total={10} onChange={setPage} />\n * ```\n *\n * @param props - {@link PaginationProps}\n * @param props.children - Custom pagination content (overrides default layout).\n * @param props.classNames - CSS class names for pagination elements.\n * @param props.defaultValue - Default page number for uncontrolled mode.\n * @param props.total - Total number of pages.\n * @param props.value - Current page number for controlled mode (1-indexed).\n * @param props.isLoading - Whether the pagination is in a loading state.\n * @param props.onChange - Handler called when the page changes.\n * @returns The rendered Pagination component.\n */\nexport function Pagination({\n  children,\n  classNames,\n  defaultValue = 1,\n  total = 0,\n  value,\n  isLoading,\n  onChange,\n  ...rest\n}: PaginationProps) {\n  const [page, setPage] = useControlledState(value, defaultValue, onChange);\n\n  return (\n    <PaginationContext.Provider value={{ page, total, isLoading, setPage }}>\n      <nav\n        {...rest}\n        className={clsx(styles.container, classNames?.container)}\n        aria-label={`Page ${page} of ${total}`}\n      >\n        {children || (\n          <>\n            <PaginationPrev className={classNames?.prev} />\n            <PaginationPages className={classNames?.pages} />\n            <PaginationNext className={classNames?.next} />\n          </>\n        )}\n      </nav>\n    </PaginationContext.Provider>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6CA,SAAgB,WAAW,EACzB,UACA,YACA,eAAe,GACf,QAAQ,GACR,OACA,WACA,UACA,GAAG,QACe;CAClB,MAAM,CAAC,MAAM,WAAW,mBAAmB,OAAO,cAAc,SAAS;AAEzE,QACE,oBAAC,kBAAkB;EAAS,OAAO;GAAE;GAAM;GAAO;GAAW;GAAS;YACpE,oBAAC;GACC,GAAI;GACJ,WAAW,KAAK,OAAO,WAAW,YAAY,UAAU;GACxD,cAAY,QAAQ,KAAK,MAAM;aAE9B,YACC;IACE,oBAAC,kBAAe,WAAW,YAAY,OAAQ;IAC/C,oBAAC,mBAAgB,WAAW,YAAY,QAAS;IACjD,oBAAC,kBAAe,WAAW,YAAY,OAAQ;OAC9C;IAED;GACqB"}

package/dist/components/pagination/next.d.ts

@@ -12,13 +12,28 @@
 
 import { PaginationNextProps } from "./types.js";
 import "client-only";
-import * as react_jsx_runtime152 from "react/jsx-runtime";
+import * as react_jsx_runtime108 from "react/jsx-runtime";
 
 //#region src/components/pagination/next.d.ts
+/**
+ * PaginationNext - Next page navigation button
+ *
+ * @example
+ * ```tsx
+ * <Pagination page={1} total={10}>
+ *   <PaginationNext onPress={(page) => console.log('Next page:', page)} />
+ * </Pagination>
+ * ```
+ *
+ * @param props - {@link PaginationNextProps}
+ * @param props.className - Optional CSS class name.
+ * @param props.onPress - Handler called when the next button is pressed.
+ * @returns The rendered PaginationNext component.
+ */
 declare function PaginationNext({
   className,
   onPress
-}: PaginationNextProps): react_jsx_runtime152.JSX.Element;
+}: PaginationNextProps): react_jsx_runtime108.JSX.Element;
 //#endregion
 export { PaginationNext };
 //# sourceMappingURL=next.d.ts.map

package/dist/components/pagination/next.js

@@ -26,6 +26,21 @@ import ChevronRight from "@accelint/icons/chevron-right";
 import styles from "./styles.module.css";
 
 //#region src/components/pagination/next.tsx
+/**
+* PaginationNext - Next page navigation button
+*
+* @example
+* ```tsx
+* <Pagination page={1} total={10}>
+*   <PaginationNext onPress={(page) => console.log('Next page:', page)} />
+* </Pagination>
+* ```
+*
+* @param props - {@link PaginationNextProps}
+* @param props.className - Optional CSS class name.
+* @param props.onPress - Handler called when the next button is pressed.
+* @returns The rendered PaginationNext component.
+*/
 function PaginationNext({ className, onPress }) {
 	const { page, total, setPage } = useContext(PaginationContext);
 	return /* @__PURE__ */ jsx(Button$1, {

package/dist/components/pagination/next.js.map

@@ -1 +1 @@
-{"version":3,"file":"next.js","names":["Button","className"],"sources":["../../../src/components/pagination/next.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 ChevronRight from '@accelint/icons/chevron-right';\nimport { useContext } from 'react';\nimport { composeRenderProps } from 'react-aria-components';\nimport { Button } from '../button';\nimport { Icon } from '../icon';\nimport { PaginationContext } from './context';\nimport styles from './styles.module.css';\nimport { isNavigationDisabled } from './utils';\nimport type { PaginationNextProps } from './types';\n\nexport function PaginationNext({ className, onPress }: PaginationNextProps) {\n  const { page, total, setPage } = useContext(PaginationContext);\n\n  return (\n    <Button\n      className={composeRenderProps(className, (className) =>\n        clsx(styles.button, className),\n      )}\n      color='mono-bold'\n      variant='icon'\n      isDisabled={page >= total || isNavigationDisabled(total, page)}\n      onPress={() => {\n        setPage(page + 1);\n        onPress?.(page + 1);\n      }}\n      aria-label='Next page'\n    >\n      <Icon>\n        <ChevronRight />\n      </Icon>\n    </Button>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;AA0BA,SAAgB,eAAe,EAAE,WAAW,WAAgC;CAC1E,MAAM,EAAE,MAAM,OAAO,YAAY,WAAW,kBAAkB;AAE9D,QACE,oBAACA;EACC,WAAW,mBAAmB,YAAY,gBACxC,KAAK,OAAO,QAAQC,YAAU,CAC/B;EACD,OAAM;EACN,SAAQ;EACR,YAAY,QAAQ,SAAS,qBAAqB,OAAO,KAAK;EAC9D,eAAe;AACb,WAAQ,OAAO,EAAE;AACjB,aAAU,OAAO,EAAE;;EAErB,cAAW;YAEX,oBAAC,kBACC,oBAAC,iBAAe,GACX;GACA"}
+{"version":3,"file":"next.js","names":["Button","className"],"sources":["../../../src/components/pagination/next.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 ChevronRight from '@accelint/icons/chevron-right';\nimport { useContext } from 'react';\nimport { composeRenderProps } from 'react-aria-components';\nimport { Button } from '../button';\nimport { Icon } from '../icon';\nimport { PaginationContext } from './context';\nimport styles from './styles.module.css';\nimport { isNavigationDisabled } from './utils';\nimport type { PaginationNextProps } from './types';\n\n/**\n * PaginationNext - Next page navigation button\n *\n * @example\n * ```tsx\n * <Pagination page={1} total={10}>\n *   <PaginationNext onPress={(page) => console.log('Next page:', page)} />\n * </Pagination>\n * ```\n *\n * @param props - {@link PaginationNextProps}\n * @param props.className - Optional CSS class name.\n * @param props.onPress - Handler called when the next button is pressed.\n * @returns The rendered PaginationNext component.\n */\nexport function PaginationNext({ className, onPress }: PaginationNextProps) {\n  const { page, total, setPage } = useContext(PaginationContext);\n\n  return (\n    <Button\n      className={composeRenderProps(className, (className) =>\n        clsx(styles.button, className),\n      )}\n      color='mono-bold'\n      variant='icon'\n      isDisabled={page >= total || isNavigationDisabled(total, page)}\n      onPress={() => {\n        setPage(page + 1);\n        onPress?.(page + 1);\n      }}\n      aria-label='Next page'\n    >\n      <Icon>\n        <ChevronRight />\n      </Icon>\n    </Button>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAyCA,SAAgB,eAAe,EAAE,WAAW,WAAgC;CAC1E,MAAM,EAAE,MAAM,OAAO,YAAY,WAAW,kBAAkB;AAE9D,QACE,oBAACA;EACC,WAAW,mBAAmB,YAAY,gBACxC,KAAK,OAAO,QAAQC,YAAU,CAC/B;EACD,OAAM;EACN,SAAQ;EACR,YAAY,QAAQ,SAAS,qBAAqB,OAAO,KAAK;EAC9D,eAAe;AACb,WAAQ,OAAO,EAAE;AACjB,aAAU,OAAO,EAAE;;EAErB,cAAW;YAEX,oBAAC,kBACC,oBAAC,iBAAe,GACX;GACA"}

package/dist/components/pagination/pages.d.ts

@@ -12,13 +12,32 @@
 
 import { PaginationPagesProps } from "./types.js";
 import "client-only";
-import * as react_jsx_runtime154 from "react/jsx-runtime";
+import * as react_jsx_runtime110 from "react/jsx-runtime";
 
 //#region src/components/pagination/pages.d.ts
+
+/**
+ * PaginationPages - Page number toggle buttons
+ *
+ * Renders up to 5 page numbers, automatically adjusting the
+ * visible range based on current page position.
+ *
+ * @example
+ * ```tsx
+ * <Pagination page={3} total={20}>
+ *   <PaginationPages onPress={(page) => console.log('Go to page:', page)} />
+ * </Pagination>
+ * ```
+ *
+ * @param props - {@link PaginationPagesProps}
+ * @param props.className - Optional CSS class name.
+ * @param props.onPress - Handler called when a page button is pressed.
+ * @returns The rendered PaginationPages component, or null if invalid state.
+ */
 declare function PaginationPages({
   className,
   onPress
-}: PaginationPagesProps): react_jsx_runtime154.JSX.Element[] | null;
+}: PaginationPagesProps): react_jsx_runtime110.JSX.Element[] | null;
 //#endregion
 export { PaginationPages };
 //# sourceMappingURL=pages.d.ts.map

package/dist/components/pagination/pages.js

@@ -24,6 +24,24 @@ import { jsx } from "react/jsx-runtime";
 import styles from "./styles.module.css";
 
 //#region src/components/pagination/pages.tsx
+/**
+* PaginationPages - Page number toggle buttons
+*
+* Renders up to 5 page numbers, automatically adjusting the
+* visible range based on current page position.
+*
+* @example
+* ```tsx
+* <Pagination page={3} total={20}>
+*   <PaginationPages onPress={(page) => console.log('Go to page:', page)} />
+* </Pagination>
+* ```
+*
+* @param props - {@link PaginationPagesProps}
+* @param props.className - Optional CSS class name.
+* @param props.onPress - Handler called when a page button is pressed.
+* @returns The rendered PaginationPages component, or null if invalid state.
+*/
 function PaginationPages({ className, onPress }) {
 	const { page, total, isLoading, setPage } = useContext(PaginationContext);
 	const { minRange, maxRange } = useMemo(() => getPaginationRange(total, page), [total, page]);

package/dist/components/pagination/pages.js.map

@@ -1 +1 @@
-{"version":3,"file":"pages.js","names":["ToggleButton","className"],"sources":["../../../src/components/pagination/pages.tsx"],"sourcesContent":["/*\n * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\n'use client';\n\nimport 'client-only';\nimport { clsx } from '@accelint/design-foundation/lib/utils';\nimport { useContext, useMemo } from 'react';\nimport { composeRenderProps } from 'react-aria-components';\nimport { ToggleButton } from '../button/toggle';\nimport { PaginationContext } from './context';\nimport styles from './styles.module.css';\nimport { getPaginationRange, range } from './utils';\nimport type { PaginationPagesProps } from './types';\n\nexport function PaginationPages({ className, onPress }: PaginationPagesProps) {\n  const { page, total, isLoading, setPage } = useContext(PaginationContext);\n  const { minRange, maxRange } = useMemo(\n    () => getPaginationRange(total, page),\n    [total, page],\n  );\n  const pages = useMemo(() => range(minRange, maxRange), [minRange, maxRange]);\n\n  // No display for invalid props.\n  if (minRange === 0 || maxRange === 0 || isLoading) {\n    return null;\n  }\n\n  return pages.map((number) => (\n    <ToggleButton\n      key={`page-${number}`}\n      className={composeRenderProps(className, (className) =>\n        clsx(styles.button, className),\n      )}\n      color='accent'\n      variant='flat'\n      isSelected={number === page}\n      onPress={() => {\n        setPage(number);\n        onPress?.(number);\n      }}\n      aria-current={number === page ? 'page' : undefined}\n    >\n      {number}\n    </ToggleButton>\n  ));\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAwBA,SAAgB,gBAAgB,EAAE,WAAW,WAAiC;CAC5E,MAAM,EAAE,MAAM,OAAO,WAAW,YAAY,WAAW,kBAAkB;CACzE,MAAM,EAAE,UAAU,aAAa,cACvB,mBAAmB,OAAO,KAAK,EACrC,CAAC,OAAO,KAAK,CACd;CACD,MAAM,QAAQ,cAAc,MAAM,UAAU,SAAS,EAAE,CAAC,UAAU,SAAS,CAAC;AAG5E,KAAI,aAAa,KAAK,aAAa,KAAK,UACtC,QAAO;AAGT,QAAO,MAAM,KAAK,WAChB,oBAACA;EAEC,WAAW,mBAAmB,YAAY,gBACxC,KAAK,OAAO,QAAQC,YAAU,CAC/B;EACD,OAAM;EACN,SAAQ;EACR,YAAY,WAAW;EACvB,eAAe;AACb,WAAQ,OAAO;AACf,aAAU,OAAO;;EAEnB,gBAAc,WAAW,OAAO,SAAS;YAExC;IAbI,QAAQ,SAcA,CACf"}
+{"version":3,"file":"pages.js","names":["ToggleButton","className"],"sources":["../../../src/components/pagination/pages.tsx"],"sourcesContent":["/*\n * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\n'use client';\n\nimport 'client-only';\nimport { clsx } from '@accelint/design-foundation/lib/utils';\nimport { useContext, useMemo } from 'react';\nimport { composeRenderProps } from 'react-aria-components';\nimport { ToggleButton } from '../button/toggle';\nimport { PaginationContext } from './context';\nimport styles from './styles.module.css';\nimport { getPaginationRange, range } from './utils';\nimport type { PaginationPagesProps } from './types';\n\n/**\n * PaginationPages - Page number toggle buttons\n *\n * Renders up to 5 page numbers, automatically adjusting the\n * visible range based on current page position.\n *\n * @example\n * ```tsx\n * <Pagination page={3} total={20}>\n *   <PaginationPages onPress={(page) => console.log('Go to page:', page)} />\n * </Pagination>\n * ```\n *\n * @param props - {@link PaginationPagesProps}\n * @param props.className - Optional CSS class name.\n * @param props.onPress - Handler called when a page button is pressed.\n * @returns The rendered PaginationPages component, or null if invalid state.\n */\nexport function PaginationPages({ className, onPress }: PaginationPagesProps) {\n  const { page, total, isLoading, setPage } = useContext(PaginationContext);\n  const { minRange, maxRange } = useMemo(\n    () => getPaginationRange(total, page),\n    [total, page],\n  );\n  const pages = useMemo(() => range(minRange, maxRange), [minRange, maxRange]);\n\n  // No display for invalid props.\n  if (minRange === 0 || maxRange === 0 || isLoading) {\n    return null;\n  }\n\n  return pages.map((number) => (\n    <ToggleButton\n      key={`page-${number}`}\n      className={composeRenderProps(className, (className) =>\n        clsx(styles.button, className),\n      )}\n      color='accent'\n      variant='flat'\n      isSelected={number === page}\n      onPress={() => {\n        setPage(number);\n        onPress?.(number);\n      }}\n      aria-current={number === page ? 'page' : undefined}\n    >\n      {number}\n    </ToggleButton>\n  ));\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA0CA,SAAgB,gBAAgB,EAAE,WAAW,WAAiC;CAC5E,MAAM,EAAE,MAAM,OAAO,WAAW,YAAY,WAAW,kBAAkB;CACzE,MAAM,EAAE,UAAU,aAAa,cACvB,mBAAmB,OAAO,KAAK,EACrC,CAAC,OAAO,KAAK,CACd;CACD,MAAM,QAAQ,cAAc,MAAM,UAAU,SAAS,EAAE,CAAC,UAAU,SAAS,CAAC;AAG5E,KAAI,aAAa,KAAK,aAAa,KAAK,UACtC,QAAO;AAGT,QAAO,MAAM,KAAK,WAChB,oBAACA;EAEC,WAAW,mBAAmB,YAAY,gBACxC,KAAK,OAAO,QAAQC,YAAU,CAC/B;EACD,OAAM;EACN,SAAQ;EACR,YAAY,WAAW;EACvB,eAAe;AACb,WAAQ,OAAO;AACf,aAAU,OAAO;;EAEnB,gBAAc,WAAW,OAAO,SAAS;YAExC;IAbI,QAAQ,SAcA,CACf"}