@bi-digital/react 0.6.1 → 0.6.2

package/dist/tabs-DtBM8JYq.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"tabs-DtBM8JYq.mjs","names":[],"sources":["../src/components/tabs/tabs.tsx"],"sourcesContent":["import type { HTMLAttributes, Ref } from 'react';\nimport type { DefaultProps } from '../../types';\nimport type { MergeRight } from '../../utilities';\nimport { Root } from '@radix-ui/react-tabs';\nimport clsx from 'clsx/lite';\n\nexport type TabsProps = MergeRight<\n  DefaultProps & Omit<HTMLAttributes<HTMLDivElement>, 'dir'>,\n  {\n    /**\n     * When `automatic`, tabs are activated when receiving focus. When `manual`, tabs are activated when clicked.\n     * @default 'automatic'\n     */\n    activationMode?: 'manual' | 'automatic';\n    /**\n     * The orientation of the component.\n     * @default 'horizontal'\n     */\n    orientation?: 'horizontal' | 'vertical';\n    /** The value of the tab that should be active when initially rendered. Use when you do not need to control the state of the tabs. */\n    defaultValue?: string;\n    /** The controlled value of the tab to activate. Should be used together with `onChange`. */\n    value?: string;\n    /** Event handler called when the value changes. */\n    onChange?: (value: string) => void;\n    /**\n     * Change the default rendered element for the one passed as a child, merging their props and behavior.\n     * @default false\n     */\n    asChild?: boolean;\n    ref?: Ref<HTMLDivElement>;\n  }\n>;\n\nexport const Tabs = ({\n  activationMode = 'automatic',\n  orientation = 'horizontal',\n  defaultValue,\n  value,\n  onChange,\n  children,\n  className,\n  asChild,\n  dark,\n  ref,\n  ...props\n}: TabsProps) => {\n  return (\n    <Root\n      className={clsx('bi-tabs', className)}\n      activationMode={activationMode}\n      orientation={orientation}\n      defaultValue={defaultValue}\n      value={value}\n      onValueChange={onChange}\n      asChild={asChild}\n      data-dark={dark}\n      ref={ref}\n      {...props}\n    >\n      {children}\n    </Root>\n  );\n};\n"],"mappings":";;;;;AAkCA,MAAa,QAAQ,EACnB,iBAAiB,aACjB,cAAc,cACd,cACA,OACA,UACA,UACA,WACA,SACA,MACA,KACA,GAAG,YACY;AACf,QACE,oBAAC;EACC,WAAW,KAAK,WAAW,UAAU;EACrB;EACH;EACC;EACP;EACP,eAAe;EACN;EACT,aAAW;EACN;EACL,GAAI;EAEH;GACI"}

package/dist/tabs-list-C14k_kq2.mjs

@@ -0,0 +1,20 @@
+import clsx from "clsx/lite";
+import { jsx } from "react/jsx-runtime";
+import { List } from "@radix-ui/react-tabs";
+
+//#region src/components/tabs/tabs-list.tsx
+const TabsList = ({ className, loop = true, children, asChild, dark, ref, ...props }) => {
+	return /* @__PURE__ */ jsx(List, {
+		className: clsx("bi-tabs--list", className),
+		loop,
+		asChild,
+		"data-dark": dark,
+		ref,
+		...props,
+		children
+	});
+};
+
+//#endregion
+export { TabsList as t };
+//# sourceMappingURL=tabs-list-C14k_kq2.mjs.map

package/dist/tabs-list-C14k_kq2.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"tabs-list-C14k_kq2.mjs","names":[],"sources":["../src/components/tabs/tabs-list.tsx"],"sourcesContent":["import type { HTMLAttributes, Ref } from 'react';\nimport type { DefaultProps } from '../../types';\nimport type { MergeRight } from '../../utilities';\nimport { List } from '@radix-ui/react-tabs';\nimport clsx from 'clsx/lite';\n\nexport type TabsListProps = MergeRight<\n  DefaultProps & Omit<HTMLAttributes<HTMLDivElement>, 'dir'>,\n  {\n    /**\n     * When `true`, keyboard navigation will loop from last tab to first, and vice versa.\n     * @default true\n     */\n    loop?: boolean;\n    /**\n     * Change the default rendered element for the one passed as a child, merging their props and behavior.\n     * @default false\n     */\n    asChild?: boolean;\n    ref?: Ref<HTMLDivElement>;\n  }\n>;\n\nexport const TabsList = ({ className, loop = true, children, asChild, dark, ref, ...props }: TabsListProps) => {\n  return (\n    <List\n      className={clsx('bi-tabs--list', className)}\n      loop={loop}\n      asChild={asChild}\n      data-dark={dark}\n      ref={ref}\n      {...props}\n    >\n      {children}\n    </List>\n  );\n};\n"],"mappings":";;;;;AAuBA,MAAa,YAAY,EAAE,WAAW,OAAO,MAAM,UAAU,SAAS,MAAM,KAAK,GAAG,YAA2B;AAC7G,QACE,oBAAC;EACC,WAAW,KAAK,iBAAiB,UAAU;EACrC;EACG;EACT,aAAW;EACN;EACL,GAAI;EAEH;GACI"}

package/dist/tabs-panel-DuwFItiC.mjs

@@ -0,0 +1,21 @@
+import clsx from "clsx/lite";
+import { jsx } from "react/jsx-runtime";
+import { Content } from "@radix-ui/react-tabs";
+
+//#region src/components/tabs/tabs-panel.tsx
+const TabsPanel = ({ className, value, forceMount, children, asChild, dark, ref, ...props }) => {
+	return /* @__PURE__ */ jsx(Content, {
+		className: clsx("bi-tabs--panel", className),
+		value,
+		forceMount: forceMount || void 0,
+		asChild,
+		"data-dark": dark,
+		ref,
+		...props,
+		children
+	});
+};
+
+//#endregion
+export { TabsPanel as t };
+//# sourceMappingURL=tabs-panel-DuwFItiC.mjs.map

package/dist/tabs-panel-DuwFItiC.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"tabs-panel-DuwFItiC.mjs","names":[],"sources":["../src/components/tabs/tabs-panel.tsx"],"sourcesContent":["import type { HTMLAttributes, Ref } from 'react';\nimport type { DefaultProps } from '../../types';\nimport type { MergeRight } from '../../utilities';\nimport { Content } from '@radix-ui/react-tabs';\nimport clsx from 'clsx/lite';\n\nexport type TabsPanelProps = MergeRight<\n  DefaultProps & Omit<HTMLAttributes<HTMLDivElement>, 'dir'>,\n  {\n    /** A unique value that associates the content with a trigger. */\n    value: string;\n    /** Used to force mounting when more control is needed. Useful when controlling animation with React animation libraries. */\n    forceMount?: boolean;\n    /**\n     * Change the default rendered element for the one passed as a child, merging their props and behavior.\n     * @default false\n     */\n    asChild?: boolean;\n    ref?: Ref<HTMLDivElement>;\n  }\n>;\n\nexport const TabsPanel = ({ className, value, forceMount, children, asChild, dark, ref, ...props }: TabsPanelProps) => {\n  return (\n    <Content\n      className={clsx('bi-tabs--panel', className)}\n      value={value}\n      forceMount={forceMount || undefined}\n      asChild={asChild}\n      data-dark={dark}\n      ref={ref}\n      {...props}\n    >\n      {children}\n    </Content>\n  );\n};\n"],"mappings":";;;;;AAsBA,MAAa,aAAa,EAAE,WAAW,OAAO,YAAY,UAAU,SAAS,MAAM,KAAK,GAAG,YAA4B;AACrH,QACE,oBAAC;EACC,WAAW,KAAK,kBAAkB,UAAU;EACrC;EACP,YAAY,cAAc;EACjB;EACT,aAAW;EACN;EACL,GAAI;EAEH;GACO"}

package/dist/textarea-DFVhK8mn.mjs

@@ -0,0 +1,17 @@
+import clsx from "clsx/lite";
+import { jsx } from "react/jsx-runtime";
+
+//#region src/components/textarea/textarea.tsx
+const Textarea = ({ className, dark, size, ref, ...props }) => {
+	return /* @__PURE__ */ jsx("textarea", {
+		className: clsx("bi-input", className),
+		"data-dark": dark,
+		"data-size": size,
+		ref,
+		...props
+	});
+};
+
+//#endregion
+export { Textarea as t };
+//# sourceMappingURL=textarea-DFVhK8mn.mjs.map

package/dist/textarea-DFVhK8mn.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"textarea-DFVhK8mn.mjs","names":[],"sources":["../src/components/textarea/textarea.tsx"],"sourcesContent":["import clsx from 'clsx/lite';\nimport type { Ref, TextareaHTMLAttributes } from 'react';\nimport type { DefaultProps } from '../../types';\nimport type { MergeRight } from '../../utilities';\n\nexport type TextareaProps = MergeRight<\n  DefaultProps & Omit<TextareaHTMLAttributes<HTMLTextAreaElement>, 'prefix'>,\n  {\n    /**\n     * Size of the textarea.\n     * @default 'medium'\n     */\n    size?: 'medium' | 'large';\n    ref?: Ref<HTMLTextAreaElement>;\n  }\n>;\n\nexport const Textarea = ({ className, dark, size, ref, ...props }: TextareaProps) => {\n  return <textarea className={clsx('bi-input', className)} data-dark={dark} data-size={size} ref={ref} {...props} />;\n};\n"],"mappings":";;;;AAiBA,MAAa,YAAY,EAAE,WAAW,MAAM,MAAM,KAAK,GAAG,YAA2B;AACnF,QAAO,oBAAC;EAAS,WAAW,KAAK,YAAY,UAAU;EAAE,aAAW;EAAM,aAAW;EAAW;EAAK,GAAI;GAAS"}

package/dist/textfield-DJ8JNFtQ.mjs

@@ -0,0 +1,65 @@
+import { t as Field } from "./field-BCZ3EqOp.mjs";
+import { t as FieldDescription } from "./field-description-XJjYxMvw.mjs";
+import { n as FieldAffixes, t as FieldAffix } from "./field-affix-C4X9hVtO.mjs";
+import { t as Input } from "./input-npZkJQsL.mjs";
+import { t as Label } from "./label-CLZYAwXB.mjs";
+import { t as ValidationMessage } from "./validation-message-Dd58lGnj.mjs";
+import { t as Textarea } from "./textarea-DFVhK8mn.mjs";
+import { jsx, jsxs } from "react/jsx-runtime";
+import { useId } from "react";
+
+//#region src/components/textfield/textfield.tsx
+const Textfield = ({ dark, label, description, error, multiline, prefix, suffix, style, className, fullwidth, ref, id: idProp, "aria-describedby": ariaDescribedByProp, ...props }) => {
+	const generatedId = useId();
+	const descriptionId = useId();
+	const validationId = useId();
+	const id = idProp || generatedId;
+	const ariaDescribedBy = [
+		description ? descriptionId : "",
+		error ? validationId : "",
+		ariaDescribedByProp
+	].join(" ").trim() || void 0;
+	return /* @__PURE__ */ jsxs(Field, {
+		className,
+		"data-dark": dark,
+		style,
+		fullwidth,
+		children: [
+			label && /* @__PURE__ */ jsx(Label, {
+				htmlFor: id,
+				children: label
+			}),
+			description && /* @__PURE__ */ jsx(FieldDescription, {
+				id: descriptionId,
+				children: description
+			}),
+			/* @__PURE__ */ jsxs(FieldAffixes, { children: [
+				prefix && /* @__PURE__ */ jsx(FieldAffix, { children: prefix }),
+				multiline ? /* @__PURE__ */ jsx(Textarea, {
+					id,
+					ref,
+					"aria-invalid": Boolean(error) || void 0,
+					"aria-describedby": ariaDescribedBy,
+					dark,
+					...props
+				}) : /* @__PURE__ */ jsx(Input, {
+					id,
+					ref,
+					"aria-invalid": Boolean(error) || void 0,
+					"aria-describedby": ariaDescribedBy,
+					dark,
+					...props
+				}),
+				suffix && /* @__PURE__ */ jsx(FieldAffix, { children: suffix })
+			] }),
+			!!error && /* @__PURE__ */ jsx(ValidationMessage, {
+				id: validationId,
+				children: error
+			})
+		]
+	});
+};
+
+//#endregion
+export { Textfield as t };
+//# sourceMappingURL=textfield-DJ8JNFtQ.mjs.map

package/dist/textfield-DJ8JNFtQ.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"textfield-DJ8JNFtQ.mjs","names":[],"sources":["../src/components/textfield/textfield.tsx"],"sourcesContent":["import { useId, type ReactNode, type Ref } from 'react';\n\nimport type { DefaultProps, LabelRequiredProps } from '../../types';\nimport { Field, FieldAffix, FieldAffixes, FieldDescription } from '../field';\nimport { Input, type InputProps } from '../input';\nimport { Label } from '../label';\nimport { Textarea, type TextareaProps } from '../textarea';\nimport { ValidationMessage } from '../validation-message';\n\ntype InputPropsFiltered = Omit<InputProps, 'prefix' | 'className' | 'style'>;\ntype TextareaPropsFiltered = Omit<TextareaProps, 'prefix' | 'className' | 'style'>;\n\ntype BaseTextfieldProps = LabelRequiredProps &\n  DefaultProps & {\n    /** Label */\n    label?: ReactNode;\n    /** Description */\n    description?: ReactNode;\n    /** Prefix */\n    prefix?: string;\n    /** Suffix */\n    suffix?: string;\n    /** Error message for field */\n    error?: ReactNode;\n    /** `className` for the `Field` element */\n    className?: InputProps['className'];\n    /** `style` for the `Field` element */\n    style?: InputProps['style'];\n    /** If true, the selectfield will take up the full available width */\n    fullwidth?: boolean;\n  };\n\ntype TextfieldTextareaProps = {\n  /** Render `Textarea` instead of a `Input`. The `Textarea` has support for multiple rows of input. */\n  multiline: true;\n} & TextareaPropsFiltered;\n\ntype TextfieldInputProps = {\n  /** Render `Textarea` instead of a `Input`. The `Textarea` has support for multiple rows of input. */\n  multiline?: never | false;\n} & InputPropsFiltered;\n\nexport type TextfieldProps = BaseTextfieldProps &\n  // We use either Textarea or Input props, depending on the `multiline` prop.\n  (TextfieldTextareaProps | TextfieldInputProps) & {\n    ref?: Ref<HTMLInputElement | HTMLTextAreaElement>;\n  };\n\nexport const Textfield = ({\n  dark,\n  label,\n  description,\n  error,\n  multiline,\n  prefix,\n  suffix,\n  style,\n  className,\n  fullwidth,\n  ref,\n  id: idProp,\n  'aria-describedby': ariaDescribedByProp,\n  ...props\n}: TextfieldProps) => {\n  const generatedId = useId();\n  const descriptionId = useId();\n  const validationId = useId();\n  const id = idProp || generatedId;\n\n  const ariaDescribedBy =\n    [description ? descriptionId : '', error ? validationId : '', ariaDescribedByProp].join(' ').trim() || undefined;\n  return (\n    <Field className={className} data-dark={dark} style={style} fullwidth={fullwidth}>\n      {label && <Label htmlFor={id}>{label}</Label>}\n      {description && <FieldDescription id={descriptionId}>{description}</FieldDescription>}\n      <FieldAffixes>\n        {prefix && <FieldAffix>{prefix}</FieldAffix>}\n        {multiline ? (\n          <Textarea\n            id={id}\n            ref={ref as Ref<HTMLTextAreaElement>}\n            aria-invalid={Boolean(error) || undefined}\n            aria-describedby={ariaDescribedBy}\n            dark={dark}\n            {...(props as TextareaPropsFiltered)}\n          />\n        ) : (\n          <Input\n            id={id}\n            ref={ref as Ref<HTMLInputElement>}\n            aria-invalid={Boolean(error) || undefined}\n            aria-describedby={ariaDescribedBy}\n            dark={dark}\n            {...(props as InputPropsFiltered)}\n          />\n        )}\n        {suffix && <FieldAffix>{suffix}</FieldAffix>}\n      </FieldAffixes>\n      {!!error && <ValidationMessage id={validationId}>{error}</ValidationMessage>}\n    </Field>\n  );\n};\n"],"mappings":";;;;;;;;;;;AAgDA,MAAa,aAAa,EACxB,MACA,OACA,aACA,OACA,WACA,QACA,QACA,OACA,WACA,WACA,KACA,IAAI,QACJ,oBAAoB,qBACpB,GAAG,YACiB;CACpB,MAAM,cAAc,OAAO;CAC3B,MAAM,gBAAgB,OAAO;CAC7B,MAAM,eAAe,OAAO;CAC5B,MAAM,KAAK,UAAU;CAErB,MAAM,kBACJ;EAAC,cAAc,gBAAgB;EAAI,QAAQ,eAAe;EAAI;EAAoB,CAAC,KAAK,IAAI,CAAC,MAAM,IAAI;AACzG,QACE,qBAAC;EAAiB;EAAW,aAAW;EAAa;EAAkB;;GACpE,SAAS,oBAAC;IAAM,SAAS;cAAK;KAAc;GAC5C,eAAe,oBAAC;IAAiB,IAAI;cAAgB;KAA+B;GACrF,qBAAC;IACE,UAAU,oBAAC,wBAAY,SAAoB;IAC3C,YACC,oBAAC;KACK;KACC;KACL,gBAAc,QAAQ,MAAM,IAAI;KAChC,oBAAkB;KACZ;KACN,GAAK;MACL,GAEF,oBAAC;KACK;KACC;KACL,gBAAc,QAAQ,MAAM,IAAI;KAChC,oBAAkB;KACZ;KACN,GAAK;MACL;IAEH,UAAU,oBAAC,wBAAY,SAAoB;OAC/B;GACd,CAAC,CAAC,SAAS,oBAAC;IAAkB,IAAI;cAAe;KAA0B;;GACtE"}

package/dist/types-BcT-ov7S.d.mts

@@ -0,0 +1,34 @@
+import { ReactNode } from "react";
+
+//#region src/types.d.ts
+type DefaultProps = {
+  /**
+   * Is the component displayed on a dark background.
+   * @default false
+   */
+  dark?: boolean;
+};
+type AsChildProps = {
+  /**
+   * Change the default rendered element for the one passed as a child, merging their props and behavior.
+   * @default false
+   */
+  asChild?: boolean;
+};
+/** Ensure that some kind of label always is present. */
+type LabelRequiredProps = {
+  'aria-label': string;
+  'aria-labelledby'?: never;
+  label?: never;
+} | {
+  'aria-label'?: never;
+  'aria-labelledby'?: never;
+  label: ReactNode;
+} | {
+  'aria-label'?: never;
+  'aria-labelledby': string;
+  label?: never;
+};
+//#endregion
+export { DefaultProps as n, LabelRequiredProps as r, AsChildProps as t };
+//# sourceMappingURL=types-BcT-ov7S.d.mts.map

package/dist/types-Bljf8GkA.d.mts

@@ -0,0 +1,9 @@
+//#region src/utilities/types.d.ts
+/**
+ * Create a new type with the properties of the first type merged with the properties of the second type.
+ * If a key exists in both types, the property from the *second* type will be used.
+ */
+type MergeRight<T1, T2> = Omit<T1, keyof T2> & T2;
+//#endregion
+export { MergeRight as t };
+//# sourceMappingURL=types-Bljf8GkA.d.mts.map

package/dist/types.d.mts

@@ -0,0 +1,2 @@
+import { n as DefaultProps, r as LabelRequiredProps, t as AsChildProps } from "./types-BcT-ov7S.mjs";
+export { AsChildProps, DefaultProps, LabelRequiredProps };

package/dist/useCheckboxGroup-CXmF4bqs.mjs

@@ -0,0 +1,17 @@
+//#region src/utilities/hooks/useCheckboxGroup/useCheckboxGroup.tsx
+const useCheckboxGroup = ({ options, updateOptions }) => {
+	const checked = options.every((option) => option);
+	const indeterminate = options.some((option) => option) && !checked;
+	const onChange = (e) => {
+		updateOptions(e.target.indeterminate ? true : e.target.checked);
+	};
+	return { checkboxGroupProps: {
+		checked,
+		indeterminate,
+		onChange
+	} };
+};
+
+//#endregion
+export { useCheckboxGroup as t };
+//# sourceMappingURL=useCheckboxGroup-CXmF4bqs.mjs.map

package/dist/useCheckboxGroup-CXmF4bqs.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCheckboxGroup-CXmF4bqs.mjs","names":[],"sources":["../src/utilities/hooks/useCheckboxGroup/useCheckboxGroup.tsx"],"sourcesContent":["import type { ChangeEvent } from 'react';\n\nexport type UseCheckboxGroupOptions = {\n  options: boolean[];\n  updateOptions: (checked: boolean) => void;\n};\n\nexport type UseCheckboxGroupReturn = {\n  /** Spread this on the \"parent\" checkbox */\n  checkboxGroupProps: {\n    checked: boolean;\n    indeterminate: boolean;\n    onChange: (e: ChangeEvent<HTMLInputElement>) => void;\n  };\n};\n\nexport const useCheckboxGroup = ({ options, updateOptions }: UseCheckboxGroupOptions): UseCheckboxGroupReturn => {\n  const checked = options.every((option) => option);\n  const indeterminate = options.some((option) => option) && !checked;\n\n  const onChange = (e: ChangeEvent<HTMLInputElement>) => {\n    const newChecked = e.target.indeterminate ? true : e.target.checked;\n    updateOptions(newChecked);\n  };\n\n  return {\n    checkboxGroupProps: {\n      checked,\n      indeterminate,\n      onChange,\n    },\n  };\n};\n"],"mappings":";AAgBA,MAAa,oBAAoB,EAAE,SAAS,oBAAqE;CAC/G,MAAM,UAAU,QAAQ,OAAO,WAAW,OAAO;CACjD,MAAM,gBAAgB,QAAQ,MAAM,WAAW,OAAO,IAAI,CAAC;CAE3D,MAAM,YAAY,MAAqC;AAErD,gBADmB,EAAE,OAAO,gBAAgB,OAAO,EAAE,OAAO,QACnC;;AAG3B,QAAO,EACL,oBAAoB;EAClB;EACA;EACA;EACD,EACF"}

package/dist/useCheckboxGroup-DBBHH8cS.d.mts

@@ -0,0 +1,22 @@
+import { ChangeEvent } from "react";
+
+//#region src/utilities/hooks/useCheckboxGroup/useCheckboxGroup.d.ts
+type UseCheckboxGroupOptions = {
+  options: boolean[];
+  updateOptions: (checked: boolean) => void;
+};
+type UseCheckboxGroupReturn = {
+  /** Spread this on the "parent" checkbox */
+  checkboxGroupProps: {
+    checked: boolean;
+    indeterminate: boolean;
+    onChange: (e: ChangeEvent<HTMLInputElement>) => void;
+  };
+};
+declare const useCheckboxGroup: ({
+  options,
+  updateOptions
+}: UseCheckboxGroupOptions) => UseCheckboxGroupReturn;
+//#endregion
+export { UseCheckboxGroupReturn as n, useCheckboxGroup as r, UseCheckboxGroupOptions as t };
+//# sourceMappingURL=useCheckboxGroup-DBBHH8cS.d.mts.map

package/dist/useIsElementAboveViewport-Dm5KwNnK.d.mts

@@ -0,0 +1,8 @@
+import { RefObject } from "react";
+
+//#region src/utilities/hooks/useIsElementAboveViewport/useIsElementAboveViewport.d.ts
+/** Detects when an element's is scrolled past and is no longer in the viewport. */
+declare const useIsElementAboveViewport: (elementRef: RefObject<HTMLElement | null>) => boolean;
+//#endregion
+export { useIsElementAboveViewport as t };
+//# sourceMappingURL=useIsElementAboveViewport-Dm5KwNnK.d.mts.map

package/dist/useIsElementAboveViewport-Dy_5jjA4.mjs

@@ -0,0 +1,20 @@
+import { useEffect, useState } from "react";
+
+//#region src/utilities/hooks/useIsElementAboveViewport/useIsElementAboveViewport.tsx
+/** Detects when an element's is scrolled past and is no longer in the viewport. */
+const useIsElementAboveViewport = (elementRef) => {
+	const [isAboveViewport, setIsPast] = useState(false);
+	useEffect(() => {
+		const observer = new IntersectionObserver(([entry]) => setIsPast(entry.boundingClientRect.y < 0), { threshold: [0] });
+		const currentRef = elementRef.current;
+		if (currentRef) observer.observe(currentRef);
+		return () => {
+			if (currentRef) observer.unobserve(currentRef);
+		};
+	}, [elementRef]);
+	return isAboveViewport;
+};
+
+//#endregion
+export { useIsElementAboveViewport as t };
+//# sourceMappingURL=useIsElementAboveViewport-Dy_5jjA4.mjs.map

package/dist/useIsElementAboveViewport-Dy_5jjA4.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"useIsElementAboveViewport-Dy_5jjA4.mjs","names":[],"sources":["../src/utilities/hooks/useIsElementAboveViewport/useIsElementAboveViewport.tsx"],"sourcesContent":["import { useEffect, useState, type RefObject } from 'react';\n\n/** Detects when an element's is scrolled past and is no longer in the viewport. */\nexport const useIsElementAboveViewport = (elementRef: RefObject<HTMLElement | null>): boolean => {\n  const [isAboveViewport, setIsPast] = useState(false);\n\n  useEffect(() => {\n    const observer = new IntersectionObserver(([entry]) => setIsPast(entry.boundingClientRect.y < 0), {\n      threshold: [0],\n    });\n    const currentRef = elementRef.current;\n    if (currentRef) observer.observe(currentRef);\n    return () => {\n      if (currentRef) observer.unobserve(currentRef);\n    };\n  }, [elementRef]);\n  return isAboveViewport;\n};\n"],"mappings":";;;;AAGA,MAAa,6BAA6B,eAAuD;CAC/F,MAAM,CAAC,iBAAiB,aAAa,SAAS,MAAM;AAEpD,iBAAgB;EACd,MAAM,WAAW,IAAI,sBAAsB,CAAC,WAAW,UAAU,MAAM,mBAAmB,IAAI,EAAE,EAAE,EAChG,WAAW,CAAC,EAAE,EACf,CAAC;EACF,MAAM,aAAa,WAAW;AAC9B,MAAI,WAAY,UAAS,QAAQ,WAAW;AAC5C,eAAa;AACX,OAAI,WAAY,UAAS,UAAU,WAAW;;IAE/C,CAAC,WAAW,CAAC;AAChB,QAAO"}

package/dist/useIsomorphicLayoutEffect-CUaF-bk-.mjs

@@ -0,0 +1,8 @@
+import { useEffect, useLayoutEffect } from "react";
+
+//#region src/utilities/hooks/useIsomorphicLayoutEffect/useIsomorphicLayoutEffect.ts
+const useIsomorphicLayoutEffect = typeof window !== "undefined" ? useLayoutEffect : useEffect;
+
+//#endregion
+export { useIsomorphicLayoutEffect as t };
+//# sourceMappingURL=useIsomorphicLayoutEffect-CUaF-bk-.mjs.map

package/dist/useIsomorphicLayoutEffect-CUaF-bk-.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"useIsomorphicLayoutEffect-CUaF-bk-.mjs","names":[],"sources":["../src/utilities/hooks/useIsomorphicLayoutEffect/useIsomorphicLayoutEffect.ts"],"sourcesContent":["// https://usehooks-ts.com/react-hook/use-isomorphic-layout-effect\n\nimport { useEffect, useLayoutEffect } from 'react';\n\nexport const useIsomorphicLayoutEffect = typeof window !== 'undefined' ? useLayoutEffect : useEffect;\n"],"mappings":";;;AAIA,MAAa,4BAA4B,OAAO,WAAW,cAAc,kBAAkB"}

package/dist/useIsomorphicLayoutEffect-DpkpaE5o.d.mts

@@ -0,0 +1,7 @@
+import { useLayoutEffect } from "react";
+
+//#region src/utilities/hooks/useIsomorphicLayoutEffect/useIsomorphicLayoutEffect.d.ts
+declare const useIsomorphicLayoutEffect: typeof useLayoutEffect;
+//#endregion
+export { useIsomorphicLayoutEffect as t };
+//# sourceMappingURL=useIsomorphicLayoutEffect-DpkpaE5o.d.mts.map

package/dist/useMediaQuery-BzRQnFto.mjs

@@ -0,0 +1,44 @@
+import { t as useIsomorphicLayoutEffect } from "./useIsomorphicLayoutEffect-CUaF-bk-.mjs";
+import { useState } from "react";
+
+//#region src/utilities/hooks/useMediaQuery/useMediaQuery.tsx
+const IS_SERVER = typeof window === "undefined";
+/**
+* Custom hook that tracks the state of a media query using the [`Match Media API`](https://developer.mozilla.org/en-US/docs/Web/API/Window/matchMedia).
+* @param {string} query - The media query to track.
+* @param {?UseMediaQueryOptions} [options] - The options for customizing the behavior of the hook (optional).
+* @returns {boolean} The current state of the media query (true if the query matches, false otherwise).
+* @example
+* ```tsx
+* const isSmallScreen = useMediaQuery('(max-width: 600px)');
+* // Use `isSmallScreen` to conditionally apply styles or logic based on the screen size.
+* ```
+*/
+function useMediaQuery(query, { defaultValue = false, initializeWithValue = true } = {}) {
+	const getMatches = (query$1) => {
+		if (IS_SERVER) return defaultValue;
+		return window.matchMedia(query$1).matches;
+	};
+	const [matches, setMatches] = useState(() => {
+		if (initializeWithValue) return getMatches(query);
+		return defaultValue;
+	});
+	function handleChange() {
+		setMatches(getMatches(query));
+	}
+	useIsomorphicLayoutEffect(() => {
+		const matchMedia = window.matchMedia(query);
+		handleChange();
+		if (matchMedia.addListener) matchMedia.addListener(handleChange);
+		else matchMedia.addEventListener("change", handleChange);
+		return () => {
+			if (matchMedia.removeListener) matchMedia.removeListener(handleChange);
+			else matchMedia.removeEventListener("change", handleChange);
+		};
+	}, [query]);
+	return matches;
+}
+
+//#endregion
+export { useMediaQuery as t };
+//# sourceMappingURL=useMediaQuery-BzRQnFto.mjs.map

package/dist/useMediaQuery-BzRQnFto.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"useMediaQuery-BzRQnFto.mjs","names":["query"],"sources":["../src/utilities/hooks/useMediaQuery/useMediaQuery.tsx"],"sourcesContent":["import { useState } from 'react';\n\nimport { useIsomorphicLayoutEffect } from '../useIsomorphicLayoutEffect/useIsomorphicLayoutEffect';\n\n/** Hook options. */\nexport type UseMediaQueryOptions = {\n  /**\n   * The default value to return if the hook is being run on the server.\n   * @default false\n   */\n  defaultValue?: boolean;\n  /**\n   * If `true` (default), the hook will initialize reading the media query. In SSR, you should set it to `false`, returning `options.defaultValue` or `false` initially.\n   * @default true\n   */\n  initializeWithValue?: boolean;\n};\n\nconst IS_SERVER = typeof window === 'undefined';\n\n/**\n * Custom hook that tracks the state of a media query using the [`Match Media API`](https://developer.mozilla.org/en-US/docs/Web/API/Window/matchMedia).\n * @param {string} query - The media query to track.\n * @param {?UseMediaQueryOptions} [options] - The options for customizing the behavior of the hook (optional).\n * @returns {boolean} The current state of the media query (true if the query matches, false otherwise).\n * @example\n * ```tsx\n * const isSmallScreen = useMediaQuery('(max-width: 600px)');\n * // Use `isSmallScreen` to conditionally apply styles or logic based on the screen size.\n * ```\n */\nexport function useMediaQuery(\n  query: string,\n  { defaultValue = false, initializeWithValue = true }: UseMediaQueryOptions = {},\n): boolean {\n  const getMatches = (query: string): boolean => {\n    if (IS_SERVER) {\n      return defaultValue;\n    }\n    return window.matchMedia(query).matches;\n  };\n\n  const [matches, setMatches] = useState<boolean>(() => {\n    if (initializeWithValue) {\n      return getMatches(query);\n    }\n    return defaultValue;\n  });\n\n  // Handles the change event of the media query.\n  function handleChange() {\n    setMatches(getMatches(query));\n  }\n\n  useIsomorphicLayoutEffect(() => {\n    const matchMedia = window.matchMedia(query);\n\n    // Triggered at the first client-side load and if query changes\n    handleChange();\n\n    // Use deprecated `addListener` and `removeListener` to support Safari < 14\n    if (matchMedia.addListener) {\n      matchMedia.addListener(handleChange);\n    } else {\n      matchMedia.addEventListener('change', handleChange);\n    }\n\n    return () => {\n      if (matchMedia.removeListener) {\n        matchMedia.removeListener(handleChange);\n      } else {\n        matchMedia.removeEventListener('change', handleChange);\n      }\n    };\n  }, [query]);\n\n  return matches;\n}\n"],"mappings":";;;;AAkBA,MAAM,YAAY,OAAO,WAAW;;;;;;;;;;;;AAapC,SAAgB,cACd,OACA,EAAE,eAAe,OAAO,sBAAsB,SAA+B,EAAE,EACtE;CACT,MAAM,cAAc,YAA2B;AAC7C,MAAI,UACF,QAAO;AAET,SAAO,OAAO,WAAWA,QAAM,CAAC;;CAGlC,MAAM,CAAC,SAAS,cAAc,eAAwB;AACpD,MAAI,oBACF,QAAO,WAAW,MAAM;AAE1B,SAAO;GACP;CAGF,SAAS,eAAe;AACtB,aAAW,WAAW,MAAM,CAAC;;AAG/B,iCAAgC;EAC9B,MAAM,aAAa,OAAO,WAAW,MAAM;AAG3C,gBAAc;AAGd,MAAI,WAAW,YACb,YAAW,YAAY,aAAa;MAEpC,YAAW,iBAAiB,UAAU,aAAa;AAGrD,eAAa;AACX,OAAI,WAAW,eACb,YAAW,eAAe,aAAa;OAEvC,YAAW,oBAAoB,UAAU,aAAa;;IAGzD,CAAC,MAAM,CAAC;AAEX,QAAO"}

package/dist/useMediaQuery-CRVu5ZHm.d.mts

@@ -0,0 +1,32 @@
+//#region src/utilities/hooks/useMediaQuery/useMediaQuery.d.ts
+/** Hook options. */
+type UseMediaQueryOptions = {
+  /**
+   * The default value to return if the hook is being run on the server.
+   * @default false
+   */
+  defaultValue?: boolean;
+  /**
+   * If `true` (default), the hook will initialize reading the media query. In SSR, you should set it to `false`, returning `options.defaultValue` or `false` initially.
+   * @default true
+   */
+  initializeWithValue?: boolean;
+};
+/**
+ * Custom hook that tracks the state of a media query using the [`Match Media API`](https://developer.mozilla.org/en-US/docs/Web/API/Window/matchMedia).
+ * @param {string} query - The media query to track.
+ * @param {?UseMediaQueryOptions} [options] - The options for customizing the behavior of the hook (optional).
+ * @returns {boolean} The current state of the media query (true if the query matches, false otherwise).
+ * @example
+ * ```tsx
+ * const isSmallScreen = useMediaQuery('(max-width: 600px)');
+ * // Use `isSmallScreen` to conditionally apply styles or logic based on the screen size.
+ * ```
+ */
+declare function useMediaQuery(query: string, {
+  defaultValue,
+  initializeWithValue
+}?: UseMediaQueryOptions): boolean;
+//#endregion
+export { useMediaQuery as n, UseMediaQueryOptions as t };
+//# sourceMappingURL=useMediaQuery-CRVu5ZHm.d.mts.map

package/dist/useMergeRefs-B7Ew7-l-.mjs

@@ -0,0 +1,42 @@
+import { useCallback, useMemo, useRef } from "react";
+
+//#region src/utilities/hooks/useMergeRefs/useMergeRefs.ts
+/**
+* Merges an array of refs into a single memoized callback ref or `null`.
+*/
+function useMergeRefs(refs) {
+	const cleanupRef = useRef(void 0);
+	const refEffect = useCallback((instance) => {
+		const cleanups = refs.map((ref) => {
+			if (ref == null) return;
+			if (typeof ref === "function") {
+				const refCallback = ref;
+				const refCleanup = refCallback(instance);
+				return typeof refCleanup === "function" ? refCleanup : () => {
+					refCallback(null);
+				};
+			}
+			ref.current = instance;
+			return () => {
+				ref.current = null;
+			};
+		});
+		return () => {
+			for (const refCleanup of cleanups) refCleanup?.();
+		};
+	}, refs);
+	return useMemo(() => {
+		if (refs.every((ref) => ref == null)) return null;
+		return (value) => {
+			if (cleanupRef.current) {
+				cleanupRef.current();
+				cleanupRef.current = void 0;
+			}
+			if (value != null) cleanupRef.current = refEffect(value);
+		};
+	}, refs);
+}
+
+//#endregion
+export { useMergeRefs as t };
+//# sourceMappingURL=useMergeRefs-B7Ew7-l-.mjs.map

package/dist/useMergeRefs-B7Ew7-l-.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"useMergeRefs-B7Ew7-l-.mjs","names":["refCleanup: void | (() => void)"],"sources":["../src/utilities/hooks/useMergeRefs/useMergeRefs.ts"],"sourcesContent":["// https://github.com/floating-ui/floating-ui/blob/master/packages/react/src/hooks/useMergeRefs.ts\nimport { useCallback, useMemo, useRef } from 'react';\nimport type { Ref, RefCallback, RefObject } from 'react';\n\n/**\n * Merges an array of refs into a single memoized callback ref or `null`.\n */\nexport function useMergeRefs<Instance>(refs: Array<Ref<Instance> | undefined>): null | RefCallback<Instance> {\n  const cleanupRef = useRef<undefined | (() => void)>(undefined);\n\n  const refEffect = useCallback((instance: Instance | null) => {\n    const cleanups = refs.map((ref) => {\n      if (ref == null) {\n        return;\n      }\n\n      if (typeof ref === 'function') {\n        const refCallback = ref;\n        // biome-ignore lint/suspicious/noConfusingVoidType: @types-react wants `void` here\n        const refCleanup: void | (() => void) = refCallback(instance);\n        return typeof refCleanup === 'function'\n          ? refCleanup\n          : () => {\n              refCallback(null);\n            };\n      }\n\n      (ref as RefObject<Instance | null>).current = instance;\n      return () => {\n        (ref as RefObject<Instance | null>).current = null;\n      };\n    });\n\n    return () => {\n      for (const refCleanup of cleanups) {\n        refCleanup?.();\n      }\n    };\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, refs);\n\n  return useMemo(() => {\n    if (refs.every((ref) => ref == null)) {\n      return null;\n    }\n\n    return (value) => {\n      if (cleanupRef.current) {\n        cleanupRef.current();\n        (cleanupRef as RefObject<undefined | (() => void)>).current = undefined;\n      }\n\n      if (value != null) {\n        (cleanupRef as RefObject<undefined | (() => void)>).current = refEffect(value);\n      }\n    };\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, refs);\n}\n"],"mappings":";;;;;;AAOA,SAAgB,aAAuB,MAAsE;CAC3G,MAAM,aAAa,OAAiC,OAAU;CAE9D,MAAM,YAAY,aAAa,aAA8B;EAC3D,MAAM,WAAW,KAAK,KAAK,QAAQ;AACjC,OAAI,OAAO,KACT;AAGF,OAAI,OAAO,QAAQ,YAAY;IAC7B,MAAM,cAAc;IAEpB,MAAMA,aAAkC,YAAY,SAAS;AAC7D,WAAO,OAAO,eAAe,aACzB,mBACM;AACJ,iBAAY,KAAK;;;AAIzB,GAAC,IAAmC,UAAU;AAC9C,gBAAa;AACX,IAAC,IAAmC,UAAU;;IAEhD;AAEF,eAAa;AACX,QAAK,MAAM,cAAc,SACvB,eAAc;;IAIjB,KAAK;AAER,QAAO,cAAc;AACnB,MAAI,KAAK,OAAO,QAAQ,OAAO,KAAK,CAClC,QAAO;AAGT,UAAQ,UAAU;AAChB,OAAI,WAAW,SAAS;AACtB,eAAW,SAAS;AACpB,IAAC,WAAmD,UAAU;;AAGhE,OAAI,SAAS,KACX,CAAC,WAAmD,UAAU,UAAU,MAAM;;IAIjF,KAAK"}

package/dist/usePagination-Cs_RI4QO.mjs

@@ -0,0 +1,97 @@
+import { useMemo } from "react";
+import { useControllableState } from "@radix-ui/react-use-controllable-state";
+
+//#region src/utilities/hooks/usePagination/usePagination.tsx
+const range = (start, end) => {
+	const length = end - start + 1;
+	return Array.from({ length }, (_, i) => start + i);
+};
+/**
+* Hook to help manage pagination state of a Pagination component.
+*
+* @example
+* const { pages, nextButtonProps, prevButtonProps } = usePagination({
+*   page,
+*   count: 10,
+*   showPages: 7,
+*   boundaryCount: 1,
+*   siblingCount: 1,
+* })
+*
+* <Pagination>
+*   <PaginationItem>
+*     <PaginationButton {...prevButtonProps}>Previous</PaginationButton>
+*   </PaginationItem>
+*   {pages.map(({ page, itemKey, buttonProps }) => (
+*     <PaginationItem key={itemKey}>
+*       {typeof page === 'number' && (
+*         <PaginationButton {...buttonProps} aria-label={`Page ${page}`}>
+*           {page}
+*         </PaginationButton>
+*       )}
+*     </PaginationItem>
+*   ))}
+*   <PaginationItem>
+*     <PaginationButton {...nextButtonProps}>Next</PaginationButton>
+*   </PaginationItem>
+* </Pagination>
+**/
+const usePagination = ({ count, page: pageProp, defaultPage, boundaryCount = 1, siblingCount = 1, disabled = false, onPageChange }) => {
+	const [page, setPage] = useControllableState({
+		prop: pageProp,
+		onChange: onPageChange,
+		defaultProp: defaultPage ?? 1,
+		caller: "Pagination"
+	});
+	return useMemo(() => {
+		const startPages = range(1, Math.min(boundaryCount, count));
+		const endPages = range(Math.max(count - boundaryCount + 1, boundaryCount + 1), count);
+		const siblingsStart = Math.max(Math.min(page - siblingCount, count - boundaryCount - siblingCount * 2 - 1), boundaryCount + 2);
+		const siblingsEnd = Math.min(Math.max(page + siblingCount, boundaryCount + siblingCount * 2 + 2), count - boundaryCount - 1);
+		const itemList = [
+			...startPages,
+			...siblingsStart > boundaryCount + 2 ? ["ellipsis"] : boundaryCount + 1 < count - boundaryCount ? [boundaryCount + 1] : [],
+			...range(siblingsStart, siblingsEnd),
+			...siblingsEnd < count - boundaryCount - 1 ? ["ellipsis"] : count - boundaryCount > boundaryCount ? [count - boundaryCount] : [],
+			...endPages
+		];
+		const hasNext = page < count;
+		const hasPrev = page !== 1;
+		return {
+			pages: itemList.map((item, index) => ({
+				page: item,
+				key: typeof item === "number" ? `page-${item}` : `ellipsis-${index}`,
+				buttonProps: typeof item === "number" ? {
+					"aria-current": item === page ? "page" : void 0,
+					onClick: () => setPage(item),
+					variant: "text"
+				} : null
+			})),
+			prevButtonProps: {
+				disabled: disabled || !hasPrev,
+				"aria-disabled": disabled || !hasPrev,
+				onClick: () => setPage(page - 1),
+				variant: "text"
+			},
+			nextButtonProps: {
+				disabled: disabled || !hasNext,
+				"aria-disabled": disabled || !hasNext,
+				onClick: () => setPage(page + 1),
+				variant: "text"
+			},
+			hasPrev,
+			hasNext
+		};
+	}, [
+		boundaryCount,
+		count,
+		disabled,
+		page,
+		setPage,
+		siblingCount
+	]);
+};
+
+//#endregion
+export { usePagination as t };
+//# sourceMappingURL=usePagination-Cs_RI4QO.mjs.map

package/dist/usePagination-Cs_RI4QO.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePagination-Cs_RI4QO.mjs","names":["itemList: (number | 'ellipsis')[]"],"sources":["../src/utilities/hooks/usePagination/usePagination.tsx"],"sourcesContent":["import { useMemo } from 'react';\nimport type { PaginationButtonProps } from '../../../components';\nimport { useControllableState } from '@radix-ui/react-use-controllable-state';\n\nconst range = (start: number, end: number) => {\n  const length = end - start + 1;\n  return Array.from({ length }, (_, i) => start + i);\n};\n\nexport type UsePaginationProps = {\n  /**\n   * The number of pages\n   */\n  count: number;\n  /*\n   * The current page. The numbering starts from `1`, if controlled\n   * @default 1\n   */\n  page?: number;\n  /*\n   * The current page. The numbering starts from `1`, if uncontrolled\n   * @default 1\n   */\n  defaultPage?: number;\n  /**\n   * Number of always visible pages at the beginning and end.\n   * @default 1\n   */\n  boundaryCount?: number;\n  /**\n   * Number of always visible pages before and after the current page.\n   * @default 1\n   */\n  siblingCount?: number;\n  /**\n   * If `true`, the component is disabled.\n   * @default false\n   */\n  disabled?: boolean;\n  /** Callback when the page changes */\n  onPageChange?: (page: number) => void;\n};\n\n/**\n * Hook to help manage pagination state of a Pagination component.\n *\n * @example\n * const { pages, nextButtonProps, prevButtonProps } = usePagination({\n *   page,\n *   count: 10,\n *   showPages: 7,\n *   boundaryCount: 1,\n *   siblingCount: 1,\n * })\n *\n * <Pagination>\n *   <PaginationItem>\n *     <PaginationButton {...prevButtonProps}>Previous</PaginationButton>\n *   </PaginationItem>\n *   {pages.map(({ page, itemKey, buttonProps }) => (\n *     <PaginationItem key={itemKey}>\n *       {typeof page === 'number' && (\n *         <PaginationButton {...buttonProps} aria-label={`Page ${page}`}>\n *           {page}\n *         </PaginationButton>\n *       )}\n *     </PaginationItem>\n *   ))}\n *   <PaginationItem>\n *     <PaginationButton {...nextButtonProps}>Next</PaginationButton>\n *   </PaginationItem>\n * </Pagination>\n **/\nexport const usePagination = ({\n  count,\n  page: pageProp,\n  defaultPage,\n  boundaryCount = 1,\n  siblingCount = 1,\n  disabled = false,\n  onPageChange,\n}: UsePaginationProps) => {\n  const [page, setPage] = useControllableState({\n    prop: pageProp,\n    onChange: onPageChange,\n    defaultProp: defaultPage ?? 1,\n    caller: 'Pagination',\n  });\n\n  return useMemo(() => {\n    const startPages = range(1, Math.min(boundaryCount, count));\n    const endPages = range(Math.max(count - boundaryCount + 1, boundaryCount + 1), count);\n\n    const siblingsStart = Math.max(\n      Math.min(\n        // Natural start\n        page - siblingCount,\n        // Lower boundary when page is high\n        count - boundaryCount - siblingCount * 2 - 1,\n      ),\n      // Greater than startPages\n      boundaryCount + 2,\n    );\n\n    const siblingsEnd = Math.min(\n      Math.max(\n        // Natural end\n        page + siblingCount,\n        // Upper boundary when page is low\n        boundaryCount + siblingCount * 2 + 2,\n      ),\n      // Less than endPages\n      count - boundaryCount - 1,\n    );\n\n    // Basic list of items to render, for example: itemList = ['previous', 1, 'ellipsis', 4, 5, 6, 'ellipsis', 10, 'next']\n    const itemList: (number | 'ellipsis')[] = [\n      ...startPages,\n\n      // Start ellipsis\n      ...(siblingsStart > boundaryCount + 2\n        ? (['ellipsis'] as const)\n        : boundaryCount + 1 < count - boundaryCount\n          ? [boundaryCount + 1]\n          : []),\n\n      // Sibling pages\n      ...range(siblingsStart, siblingsEnd),\n\n      // End ellipsis\n      ...(siblingsEnd < count - boundaryCount - 1\n        ? (['ellipsis'] as const)\n        : count - boundaryCount > boundaryCount\n          ? [count - boundaryCount]\n          : []),\n\n      ...endPages,\n    ];\n\n    const hasNext = page < count;\n    const hasPrev = page !== 1;\n\n    return {\n      /** Items and pages to be displayed */\n      pages: itemList.map((item, index) => ({\n        /** Page number, \"ellipsis\" for ellipsis items */\n        page: item,\n        /** Unique key for the item */\n        key: typeof item === 'number' ? `page-${item}` : `ellipsis-${index}`,\n        /** Properties to spread on PaginationButton */\n        buttonProps: (typeof item === 'number'\n          ? {\n              'aria-current': item === page ? 'page' : undefined,\n              onClick: () => setPage(item),\n              variant: 'text',\n            }\n          : null) satisfies PaginationButtonProps | null,\n      })),\n      /** Properties to spread on PaginationButton used for previous navigation */\n      prevButtonProps: {\n        disabled: disabled || !hasPrev,\n        'aria-disabled': disabled || !hasPrev, // Using aria-disabled to support all HTML elements if asChild is used\n        onClick: () => setPage(page - 1),\n        variant: 'text',\n      } as PaginationButtonProps,\n      /** Properties to spread on PaginationButton used for next naviagation */\n      nextButtonProps: {\n        disabled: disabled || !hasNext,\n        'aria-disabled': disabled || !hasNext, // Using aria-disabled to support all HTML elements if asChild is used\n        onClick: () => setPage(page + 1),\n        variant: 'text',\n      } as PaginationButtonProps,\n      /** If previous page action should be shown */\n      hasPrev,\n      /** If next page action should be shown */\n      hasNext,\n    };\n  }, [boundaryCount, count, disabled, page, setPage, siblingCount]);\n};\n"],"mappings":";;;;AAIA,MAAM,SAAS,OAAe,QAAgB;CAC5C,MAAM,SAAS,MAAM,QAAQ;AAC7B,QAAO,MAAM,KAAK,EAAE,QAAQ,GAAG,GAAG,MAAM,QAAQ,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmEpD,MAAa,iBAAiB,EAC5B,OACA,MAAM,UACN,aACA,gBAAgB,GAChB,eAAe,GACf,WAAW,OACX,mBACwB;CACxB,MAAM,CAAC,MAAM,WAAW,qBAAqB;EAC3C,MAAM;EACN,UAAU;EACV,aAAa,eAAe;EAC5B,QAAQ;EACT,CAAC;AAEF,QAAO,cAAc;EACnB,MAAM,aAAa,MAAM,GAAG,KAAK,IAAI,eAAe,MAAM,CAAC;EAC3D,MAAM,WAAW,MAAM,KAAK,IAAI,QAAQ,gBAAgB,GAAG,gBAAgB,EAAE,EAAE,MAAM;EAErF,MAAM,gBAAgB,KAAK,IACzB,KAAK,IAEH,OAAO,cAEP,QAAQ,gBAAgB,eAAe,IAAI,EAC5C,EAED,gBAAgB,EACjB;EAED,MAAM,cAAc,KAAK,IACvB,KAAK,IAEH,OAAO,cAEP,gBAAgB,eAAe,IAAI,EACpC,EAED,QAAQ,gBAAgB,EACzB;EAGD,MAAMA,WAAoC;GACxC,GAAG;GAGH,GAAI,gBAAgB,gBAAgB,IAC/B,CAAC,WAAW,GACb,gBAAgB,IAAI,QAAQ,gBAC1B,CAAC,gBAAgB,EAAE,GACnB,EAAE;GAGR,GAAG,MAAM,eAAe,YAAY;GAGpC,GAAI,cAAc,QAAQ,gBAAgB,IACrC,CAAC,WAAW,GACb,QAAQ,gBAAgB,gBACtB,CAAC,QAAQ,cAAc,GACvB,EAAE;GAER,GAAG;GACJ;EAED,MAAM,UAAU,OAAO;EACvB,MAAM,UAAU,SAAS;AAEzB,SAAO;GAEL,OAAO,SAAS,KAAK,MAAM,WAAW;IAEpC,MAAM;IAEN,KAAK,OAAO,SAAS,WAAW,QAAQ,SAAS,YAAY;IAE7D,aAAc,OAAO,SAAS,WAC1B;KACE,gBAAgB,SAAS,OAAO,SAAS;KACzC,eAAe,QAAQ,KAAK;KAC5B,SAAS;KACV,GACD;IACL,EAAE;GAEH,iBAAiB;IACf,UAAU,YAAY,CAAC;IACvB,iBAAiB,YAAY,CAAC;IAC9B,eAAe,QAAQ,OAAO,EAAE;IAChC,SAAS;IACV;GAED,iBAAiB;IACf,UAAU,YAAY,CAAC;IACvB,iBAAiB,YAAY,CAAC;IAC9B,eAAe,QAAQ,OAAO,EAAE;IAChC,SAAS;IACV;GAED;GAEA;GACD;IACA;EAAC;EAAe;EAAO;EAAU;EAAM;EAAS;EAAa,CAAC"}

package/dist/useScrollDirection-D35f7Y4k.mjs

@@ -0,0 +1,28 @@
+import { useEffect, useState } from "react";
+
+//#region src/utilities/hooks/useScrollDirection/useScrollDirection.tsx
+/**
+* A custom React hook that detects the vertical scroll direction of the page.
+*
+* @returns {'up' | 'down' | null} The current scroll direction. Returns `null` on the initial render.
+* The direction is only updated if the scroll distance exceeds a 5px threshold to prevent sensitivity to minor scroll jitter.
+*/
+const useScrollDirection = () => {
+	const [scrollDirection, setScrollDirection] = useState(null);
+	useEffect(() => {
+		let lastScrollY = window.pageYOffset;
+		const updateScrollDirection = () => {
+			const scrollY = window.pageYOffset;
+			const direction = scrollY > lastScrollY ? "down" : "up";
+			if (direction !== scrollDirection && (scrollY - lastScrollY > 5 || scrollY - lastScrollY < -5)) setScrollDirection(direction);
+			lastScrollY = scrollY > 0 ? scrollY : 0;
+		};
+		window.addEventListener("scroll", updateScrollDirection);
+		return () => window.removeEventListener("scroll", updateScrollDirection);
+	}, [scrollDirection]);
+	return scrollDirection;
+};
+
+//#endregion
+export { useScrollDirection as t };
+//# sourceMappingURL=useScrollDirection-D35f7Y4k.mjs.map

package/dist/useScrollDirection-D35f7Y4k.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"useScrollDirection-D35f7Y4k.mjs","names":[],"sources":["../src/utilities/hooks/useScrollDirection/useScrollDirection.tsx"],"sourcesContent":["import { useEffect, useState } from 'react';\n\n/**\n * A custom React hook that detects the vertical scroll direction of the page.\n *\n * @returns {'up' | 'down' | null} The current scroll direction. Returns `null` on the initial render.\n * The direction is only updated if the scroll distance exceeds a 5px threshold to prevent sensitivity to minor scroll jitter.\n */\nexport const useScrollDirection = () => {\n  const [scrollDirection, setScrollDirection] = useState<'up' | 'down' | null>(null);\n  useEffect(() => {\n    let lastScrollY = window.pageYOffset;\n    const updateScrollDirection = () => {\n      const scrollY = window.pageYOffset;\n      const direction = scrollY > lastScrollY ? 'down' : 'up';\n      if (direction !== scrollDirection && (scrollY - lastScrollY > 5 || scrollY - lastScrollY < -5)) {\n        setScrollDirection(direction);\n      }\n      lastScrollY = scrollY > 0 ? scrollY : 0;\n    };\n    window.addEventListener('scroll', updateScrollDirection);\n    return () => window.removeEventListener('scroll', updateScrollDirection);\n  }, [scrollDirection]);\n\n  return scrollDirection;\n};\n"],"mappings":";;;;;;;;;AAQA,MAAa,2BAA2B;CACtC,MAAM,CAAC,iBAAiB,sBAAsB,SAA+B,KAAK;AAClF,iBAAgB;EACd,IAAI,cAAc,OAAO;EACzB,MAAM,8BAA8B;GAClC,MAAM,UAAU,OAAO;GACvB,MAAM,YAAY,UAAU,cAAc,SAAS;AACnD,OAAI,cAAc,oBAAoB,UAAU,cAAc,KAAK,UAAU,cAAc,IACzF,oBAAmB,UAAU;AAE/B,iBAAc,UAAU,IAAI,UAAU;;AAExC,SAAO,iBAAiB,UAAU,sBAAsB;AACxD,eAAa,OAAO,oBAAoB,UAAU,sBAAsB;IACvE,CAAC,gBAAgB,CAAC;AAErB,QAAO"}

package/dist/useScrollDirection-D8-lMWT2.d.mts

@@ -0,0 +1,11 @@
+//#region src/utilities/hooks/useScrollDirection/useScrollDirection.d.ts
+/**
+ * A custom React hook that detects the vertical scroll direction of the page.
+ *
+ * @returns {'up' | 'down' | null} The current scroll direction. Returns `null` on the initial render.
+ * The direction is only updated if the scroll distance exceeds a 5px threshold to prevent sensitivity to minor scroll jitter.
+ */
+declare const useScrollDirection: () => "up" | "down" | null;
+//#endregion
+export { useScrollDirection as t };
+//# sourceMappingURL=useScrollDirection-D8-lMWT2.d.mts.map