@codefast/ui 0.3.9 → 0.3.11-canary.0

package/dist/hooks/use-copy-to-clipboard.js

@@ -1,2 +1,24 @@
 "use client";
-import{useState as o}from"react";function r({onCopy:e,timeout:t=2e3}={}){let[i,a]=o(!1);return{copyToClipboard:async o=>{if("undefined"!=typeof globalThis&&navigator.clipboard.writeText&&o)try{await navigator.clipboard.writeText(o),a(!0),e&&e(),setTimeout(()=>{a(!1)},t)}catch(o){console.error(o)}},isCopied:i}}export{r as useCopyToClipboard};
+import { useState } from "react";
+function useCopyToClipboard({ onCopy, timeout = 2000 } = {}) {
+    const [isCopied, setIsCopied] = useState(false);
+    const copyToClipboard = async (value)=>{
+        if ("u" < typeof window || !("clipboard" in navigator) || "function" != typeof navigator.clipboard.writeText) return;
+        if (!value) return;
+        try {
+            await navigator.clipboard.writeText(value);
+            setIsCopied(true);
+            if (onCopy) onCopy();
+            setTimeout(()=>{
+                setIsCopied(false);
+            }, timeout);
+        } catch (error) {
+            console.error(error);
+        }
+    };
+    return {
+        copyToClipboard,
+        isCopied
+    };
+}
+export { useCopyToClipboard };

package/dist/hooks/use-is-mobile.cjs

@@ -1,2 +1,40 @@
+"use strict";
 "use client";
-"use strict";const __rslib_import_meta_url__="undefined"==typeof document?new(require("url".replace("",""))).URL("file:"+__filename).href:document.currentScript&&document.currentScript.src||new URL("main.js",document.baseURI).href;var __webpack_require__={};__webpack_require__.d=(e,_)=>{for(var r in _)__webpack_require__.o(_,r)&&!__webpack_require__.o(e,r)&&Object.defineProperty(e,r,{enumerable:!0,get:_[r]})},__webpack_require__.o=(e,_)=>Object.prototype.hasOwnProperty.call(e,_),__webpack_require__.r=e=>{"undefined"!=typeof Symbol&&Symbol.toStringTag&&Object.defineProperty(e,Symbol.toStringTag,{value:"Module"}),Object.defineProperty(e,"__esModule",{value:!0})};var __webpack_exports__={};__webpack_require__.r(__webpack_exports__),__webpack_require__.d(__webpack_exports__,{useIsMobile:()=>useIsMobile});const external_use_media_query_cjs_namespaceObject=require("./use-media-query.cjs"),MOBILE_BREAKPOINT=768;function useIsMobile(){return(0,external_use_media_query_cjs_namespaceObject.useMediaQuery)("(max-width: 767px)")}for(var __webpack_i__ in exports.useIsMobile=__webpack_exports__.useIsMobile,__webpack_exports__)-1===["useIsMobile"].indexOf(__webpack_i__)&&(exports[__webpack_i__]=__webpack_exports__[__webpack_i__]);Object.defineProperty(exports,"__esModule",{value:!0});
+var __webpack_require__ = {};
+(()=>{
+    __webpack_require__.d = (exports1, definition)=>{
+        for(var key in definition)if (__webpack_require__.o(definition, key) && !__webpack_require__.o(exports1, key)) Object.defineProperty(exports1, key, {
+            enumerable: true,
+            get: definition[key]
+        });
+    };
+})();
+(()=>{
+    __webpack_require__.o = (obj, prop)=>Object.prototype.hasOwnProperty.call(obj, prop);
+})();
+(()=>{
+    __webpack_require__.r = (exports1)=>{
+        if ("u" > typeof Symbol && Symbol.toStringTag) Object.defineProperty(exports1, Symbol.toStringTag, {
+            value: 'Module'
+        });
+        Object.defineProperty(exports1, '__esModule', {
+            value: true
+        });
+    };
+})();
+var __webpack_exports__ = {};
+__webpack_require__.r(__webpack_exports__);
+__webpack_require__.d(__webpack_exports__, {
+    useIsMobile: ()=>useIsMobile
+});
+const external_use_media_query_cjs_namespaceObject = require("./use-media-query.cjs");
+function useIsMobile(mobileBreakpoint = 768) {
+    return (0, external_use_media_query_cjs_namespaceObject.useMediaQuery)(`(max-width: ${(mobileBreakpoint - 1).toString()}px)`);
+}
+exports.useIsMobile = __webpack_exports__.useIsMobile;
+for(var __rspack_i in __webpack_exports__)if (-1 === [
+    "useIsMobile"
+].indexOf(__rspack_i)) exports[__rspack_i] = __webpack_exports__[__rspack_i];
+Object.defineProperty(exports, '__esModule', {
+    value: true
+});

package/dist/hooks/use-is-mobile.d.ts

@@ -1,10 +1,19 @@
 /**
- * Custom hook that determines if the current viewport is mobile-sized.
+ * Determine whether the current viewport should be treated as mobile.
  *
- * This hook uses the useMediaQuery hook to check if the screen width is less than
- * the defined mobile breakpoint (768px).
+ * Uses {@link useMediaQuery} to evaluate a max-width media query derived from the
+ * provided breakpoint. By default, widths below 768px are considered mobile.
  *
- * @returns A boolean indicating whether the current viewport is mobile-sized.
- * True if the screen width is less than 768px, false otherwise.
+ * @param mobileBreakpoint - Pixel width used as the mobile breakpoint. Values strictly
+ * less than this breakpoint are treated as mobile. Defaults to 768.
+ * @returns true when the viewport width is less than the given breakpoint; otherwise false.
+ *
+ * @example
+ * ```tsx
+ * const isMobile = useIsMobile();
+ * if (isMobile) {
+ *   // Render compact layout
+ * }
+ * ```
  */
-export declare function useIsMobile(): boolean;
+export declare function useIsMobile(mobileBreakpoint?: number): boolean;

package/dist/hooks/use-is-mobile.js

@@ -1,2 +1,6 @@
 "use client";
-import{useMediaQuery as e}from"./use-media-query.js";function r(){return e("(max-width: 767px)")}export{r as useIsMobile};
+import { useMediaQuery } from "./use-media-query.js";
+function useIsMobile(mobileBreakpoint = 768) {
+    return useMediaQuery(`(max-width: ${(mobileBreakpoint - 1).toString()}px)`);
+}
+export { useIsMobile };

package/dist/hooks/use-media-query.cjs

@@ -1,2 +1,57 @@
+"use strict";
 "use client";
-"use strict";const __rslib_import_meta_url__="undefined"==typeof document?new(require("url".replace("",""))).URL("file:"+__filename).href:document.currentScript&&document.currentScript.src||new URL("main.js",document.baseURI).href;var __webpack_require__={};__webpack_require__.d=(e,_)=>{for(var r in _)__webpack_require__.o(_,r)&&!__webpack_require__.o(e,r)&&Object.defineProperty(e,r,{enumerable:!0,get:_[r]})},__webpack_require__.o=(e,_)=>Object.prototype.hasOwnProperty.call(e,_),__webpack_require__.r=e=>{"undefined"!=typeof Symbol&&Symbol.toStringTag&&Object.defineProperty(e,Symbol.toStringTag,{value:"Module"}),Object.defineProperty(e,"__esModule",{value:!0})};var __webpack_exports__={};__webpack_require__.r(__webpack_exports__),__webpack_require__.d(__webpack_exports__,{useMediaQuery:()=>useMediaQuery});const external_react_namespaceObject=require("react");function useMediaQuery(e){let[_,r]=(0,external_react_namespaceObject.useState)(()=>"undefined"!=typeof globalThis&&"function"==typeof globalThis.matchMedia&&globalThis.matchMedia(e).matches);return(0,external_react_namespaceObject.useEffect)(()=>{if("undefined"==typeof globalThis)return;let _=globalThis.matchMedia(e),t=e=>{r(e.matches)};return _.addEventListener("change",t),()=>{_.removeEventListener("change",t)}},[e]),_}for(var __webpack_i__ in exports.useMediaQuery=__webpack_exports__.useMediaQuery,__webpack_exports__)-1===["useMediaQuery"].indexOf(__webpack_i__)&&(exports[__webpack_i__]=__webpack_exports__[__webpack_i__]);Object.defineProperty(exports,"__esModule",{value:!0});
+var __webpack_require__ = {};
+(()=>{
+    __webpack_require__.d = (exports1, definition)=>{
+        for(var key in definition)if (__webpack_require__.o(definition, key) && !__webpack_require__.o(exports1, key)) Object.defineProperty(exports1, key, {
+            enumerable: true,
+            get: definition[key]
+        });
+    };
+})();
+(()=>{
+    __webpack_require__.o = (obj, prop)=>Object.prototype.hasOwnProperty.call(obj, prop);
+})();
+(()=>{
+    __webpack_require__.r = (exports1)=>{
+        if ("u" > typeof Symbol && Symbol.toStringTag) Object.defineProperty(exports1, Symbol.toStringTag, {
+            value: 'Module'
+        });
+        Object.defineProperty(exports1, '__esModule', {
+            value: true
+        });
+    };
+})();
+var __webpack_exports__ = {};
+__webpack_require__.r(__webpack_exports__);
+__webpack_require__.d(__webpack_exports__, {
+    useMediaQuery: ()=>useMediaQuery
+});
+const external_react_namespaceObject = require("react");
+function useMediaQuery(query) {
+    const [matches, setMatches] = (0, external_react_namespaceObject.useState)(()=>{
+        if ("u" > typeof window && "function" == typeof window.matchMedia) return window.matchMedia(query).matches;
+        return false;
+    });
+    (0, external_react_namespaceObject.useEffect)(()=>{
+        if ("u" < typeof window) return;
+        const mediaQueryList = window.matchMedia(query);
+        const onChange = (event)=>{
+            setMatches(event.matches);
+        };
+        mediaQueryList.addEventListener("change", onChange);
+        return ()=>{
+            mediaQueryList.removeEventListener("change", onChange);
+        };
+    }, [
+        query
+    ]);
+    return matches;
+}
+exports.useMediaQuery = __webpack_exports__.useMediaQuery;
+for(var __rspack_i in __webpack_exports__)if (-1 === [
+    "useMediaQuery"
+].indexOf(__rspack_i)) exports[__rspack_i] = __webpack_exports__[__rspack_i];
+Object.defineProperty(exports, '__esModule', {
+    value: true
+});

package/dist/hooks/use-media-query.d.ts

@@ -1,7 +1,15 @@
 /**
- * Custom hook to listen to CSS media query.
+ * Subscribe to a CSS media query and receive its match state.
  *
- * @param query - Media query string.
- * @returns Whether the media query matches or not.
+ * Evaluates the query immediately (when supported) and updates on changes
+ * via an event listener.
+ *
+ * @param query - A valid media query string (e.g., "(max-width: 768px)").
+ * @returns true when the media query currently matches; otherwise false.
+ *
+ * @example
+ * ```tsx
+ * const isNarrow = useMediaQuery("(max-width: 768px)");
+ * ```
  */
 export declare function useMediaQuery(query: string): boolean;

package/dist/hooks/use-media-query.js

@@ -1,2 +1,23 @@
 "use client";
-import{useEffect as e,useState as t}from"react";function a(a){let[i,n]=t(()=>"undefined"!=typeof globalThis&&"function"==typeof globalThis.matchMedia&&globalThis.matchMedia(a).matches);return e(()=>{if("undefined"==typeof globalThis)return;let e=globalThis.matchMedia(a),t=e=>{n(e.matches)};return e.addEventListener("change",t),()=>{e.removeEventListener("change",t)}},[a]),i}export{a as useMediaQuery};
+import { useEffect, useState } from "react";
+function useMediaQuery(query) {
+    const [matches, setMatches] = useState(()=>{
+        if ("u" > typeof window && "function" == typeof window.matchMedia) return window.matchMedia(query).matches;
+        return false;
+    });
+    useEffect(()=>{
+        if ("u" < typeof window) return;
+        const mediaQueryList = window.matchMedia(query);
+        const onChange = (event)=>{
+            setMatches(event.matches);
+        };
+        mediaQueryList.addEventListener("change", onChange);
+        return ()=>{
+            mediaQueryList.removeEventListener("change", onChange);
+        };
+    }, [
+        query
+    ]);
+    return matches;
+}
+export { useMediaQuery };

package/dist/hooks/use-mutation-observer.cjs

@@ -1,2 +1,57 @@
+"use strict";
 "use client";
-"use strict";const __rslib_import_meta_url__="undefined"==typeof document?new(require("url".replace("",""))).URL("file:"+__filename).href:document.currentScript&&document.currentScript.src||new URL("main.js",document.baseURI).href;var __webpack_require__={};__webpack_require__.d=(e,_)=>{for(var r in _)__webpack_require__.o(_,r)&&!__webpack_require__.o(e,r)&&Object.defineProperty(e,r,{enumerable:!0,get:_[r]})},__webpack_require__.o=(e,_)=>Object.prototype.hasOwnProperty.call(e,_),__webpack_require__.r=e=>{"undefined"!=typeof Symbol&&Symbol.toStringTag&&Object.defineProperty(e,Symbol.toStringTag,{value:"Module"}),Object.defineProperty(e,"__esModule",{value:!0})};var __webpack_exports__={};__webpack_require__.r(__webpack_exports__),__webpack_require__.d(__webpack_exports__,{useMutationObserver:()=>useMutationObserver});const external_react_namespaceObject=require("react"),defaultOptions={attributes:!0,characterData:!0,childList:!0,subtree:!0};function useMutationObserver(e,_,r=defaultOptions){(0,external_react_namespaceObject.useEffect)(()=>{if(!e.current)return;let t=new MutationObserver(_);return t.observe(e.current,r),()=>{t.disconnect()}},[e,_,r])}for(var __webpack_i__ in exports.useMutationObserver=__webpack_exports__.useMutationObserver,__webpack_exports__)-1===["useMutationObserver"].indexOf(__webpack_i__)&&(exports[__webpack_i__]=__webpack_exports__[__webpack_i__]);Object.defineProperty(exports,"__esModule",{value:!0});
+var __webpack_require__ = {};
+(()=>{
+    __webpack_require__.d = (exports1, definition)=>{
+        for(var key in definition)if (__webpack_require__.o(definition, key) && !__webpack_require__.o(exports1, key)) Object.defineProperty(exports1, key, {
+            enumerable: true,
+            get: definition[key]
+        });
+    };
+})();
+(()=>{
+    __webpack_require__.o = (obj, prop)=>Object.prototype.hasOwnProperty.call(obj, prop);
+})();
+(()=>{
+    __webpack_require__.r = (exports1)=>{
+        if ("u" > typeof Symbol && Symbol.toStringTag) Object.defineProperty(exports1, Symbol.toStringTag, {
+            value: 'Module'
+        });
+        Object.defineProperty(exports1, '__esModule', {
+            value: true
+        });
+    };
+})();
+var __webpack_exports__ = {};
+__webpack_require__.r(__webpack_exports__);
+__webpack_require__.d(__webpack_exports__, {
+    useMutationObserver: ()=>useMutationObserver
+});
+const external_react_namespaceObject = require("react");
+const defaultOptions = {
+    attributes: true,
+    characterData: true,
+    childList: true,
+    subtree: true
+};
+function useMutationObserver(ref, callback, options = defaultOptions) {
+    (0, external_react_namespaceObject.useEffect)(()=>{
+        if (!ref.current) return;
+        const observer = new MutationObserver(callback);
+        observer.observe(ref.current, options);
+        return ()=>{
+            observer.disconnect();
+        };
+    }, [
+        ref,
+        callback,
+        options
+    ]);
+}
+exports.useMutationObserver = __webpack_exports__.useMutationObserver;
+for(var __rspack_i in __webpack_exports__)if (-1 === [
+    "useMutationObserver"
+].indexOf(__rspack_i)) exports[__rspack_i] = __webpack_exports__[__rspack_i];
+Object.defineProperty(exports, '__esModule', {
+    value: true
+});

package/dist/hooks/use-mutation-observer.d.ts

@@ -1,18 +1,14 @@
 import type { RefObject } from "react";
 /**
- * Attaches a MutationObserver to a given HTMLElement and invokes a callback
- * function when mutations occur in the observed elements.
+ * Observe DOM mutations on a referenced element and invoke a callback.
  *
- * @param ref - The mutable reference to the HTMLElement to be observed for mutations
- * @param callback - The function to be called when mutations are detected
- * @param options - Configuration options for the MutationObserver, defaults to watching all changes
- * @returns void
+ * Attaches a MutationObserver to the provided element reference with the given
+ * options and calls the callback whenever mutations occur.
  *
- * @remarks
- * This function is a React hook that attaches a MutationObserver to a given
- * HTMLElement. The MutationObserver listens for mutations in the observed
- * element and its descendants and invokes the provided callback function
- * when mutations occur.
+ * @param ref - Ref to the target HTMLElement to observe.
+ * @param callback - Mutation callback invoked with observed records.
+ * @param options - Observer configuration. Defaults watch attributes, characterData, childList, subtree.
+ * @returns void
  *
  * @see [MutationObserver](https://developer.mozilla.org/en-US/docs/Web/API/MutationObserver)
  */

package/dist/hooks/use-mutation-observer.js

@@ -1,2 +1,23 @@
 "use client";
-import{useEffect as t}from"react";let e={attributes:!0,characterData:!0,childList:!0,subtree:!0};function r(n,u,c=e){t(()=>{if(!n.current)return;let t=new MutationObserver(u);return t.observe(n.current,c),()=>{t.disconnect()}},[n,u,c])}export{r as useMutationObserver};
+import { useEffect } from "react";
+const defaultOptions = {
+    attributes: true,
+    characterData: true,
+    childList: true,
+    subtree: true
+};
+function useMutationObserver(ref, callback, options = defaultOptions) {
+    useEffect(()=>{
+        if (!ref.current) return;
+        const observer = new MutationObserver(callback);
+        observer.observe(ref.current, options);
+        return ()=>{
+            observer.disconnect();
+        };
+    }, [
+        ref,
+        callback,
+        options
+    ]);
+}
+export { useMutationObserver };

package/dist/hooks/use-pagination.cjs

@@ -1,2 +1,93 @@
+"use strict";
 "use client";
-"use strict";const __rslib_import_meta_url__="undefined"==typeof document?new(require("url".replace("",""))).URL("file:"+__filename).href:document.currentScript&&document.currentScript.src||new URL("main.js",document.baseURI).href;var __webpack_require__={};__webpack_require__.d=(e,_)=>{for(var r in _)__webpack_require__.o(_,r)&&!__webpack_require__.o(e,r)&&Object.defineProperty(e,r,{enumerable:!0,get:_[r]})},__webpack_require__.o=(e,_)=>Object.prototype.hasOwnProperty.call(e,_),__webpack_require__.r=e=>{"undefined"!=typeof Symbol&&Symbol.toStringTag&&Object.defineProperty(e,Symbol.toStringTag,{value:"Module"}),Object.defineProperty(e,"__esModule",{value:!0})};var __webpack_exports__={};__webpack_require__.r(__webpack_exports__),__webpack_require__.d(__webpack_exports__,{ELLIPSIS:()=>ELLIPSIS,usePagination:()=>usePagination});const external_react_namespaceObject=require("react"),ELLIPSIS="•••",createRange=(e,_)=>Array.from({length:_-e+1},(_,r)=>e+r);function usePagination({currentPage:e,resultsPerPage:_,siblingPagesCount:r=1,totalResults:t}){return(0,external_react_namespaceObject.useMemo)(()=>{let a=Math.ceil(t/Math.floor(_));if(a<=0)return[];if(r+5>=a)return createRange(1,a);let n=Math.max(e-r,1),c=Math.min(e+r,a),o=n>2,i=c<a-2;return!o&&i?[...createRange(1,3+2*r),ELLIPSIS,a]:o&&!i?[1,ELLIPSIS,...createRange(a-(3+2*r)+1,a)]:o&&i?[1,ELLIPSIS,...createRange(n,c),ELLIPSIS,a]:[]},[t,_,r,e])}for(var __webpack_i__ in exports.ELLIPSIS=__webpack_exports__.ELLIPSIS,exports.usePagination=__webpack_exports__.usePagination,__webpack_exports__)-1===["ELLIPSIS","usePagination"].indexOf(__webpack_i__)&&(exports[__webpack_i__]=__webpack_exports__[__webpack_i__]);Object.defineProperty(exports,"__esModule",{value:!0});
+var __webpack_require__ = {};
+(()=>{
+    __webpack_require__.d = (exports1, definition)=>{
+        for(var key in definition)if (__webpack_require__.o(definition, key) && !__webpack_require__.o(exports1, key)) Object.defineProperty(exports1, key, {
+            enumerable: true,
+            get: definition[key]
+        });
+    };
+})();
+(()=>{
+    __webpack_require__.o = (obj, prop)=>Object.prototype.hasOwnProperty.call(obj, prop);
+})();
+(()=>{
+    __webpack_require__.r = (exports1)=>{
+        if ("u" > typeof Symbol && Symbol.toStringTag) Object.defineProperty(exports1, Symbol.toStringTag, {
+            value: 'Module'
+        });
+        Object.defineProperty(exports1, '__esModule', {
+            value: true
+        });
+    };
+})();
+var __webpack_exports__ = {};
+__webpack_require__.r(__webpack_exports__);
+__webpack_require__.d(__webpack_exports__, {
+    ELLIPSIS: ()=>ELLIPSIS,
+    usePagination: ()=>usePagination
+});
+const external_react_namespaceObject = require("react");
+const ELLIPSIS = "•••";
+const createRange = (start, end)=>{
+    const length = end - start + 1;
+    return Array.from({
+        length
+    }, (_, index)=>start + index);
+};
+function usePagination({ currentPage, resultsPerPage, siblingPagesCount = 1, totalResults }) {
+    return (0, external_react_namespaceObject.useMemo)(()=>{
+        const totalPages = Math.ceil(totalResults / Math.floor(resultsPerPage));
+        if (totalPages <= 0) return [];
+        const visiblePageNumbers = siblingPagesCount + 5;
+        if (visiblePageNumbers >= totalPages) return createRange(1, totalPages);
+        const leftSiblingIndex = Math.max(currentPage - siblingPagesCount, 1);
+        const rightSiblingIndex = Math.min(currentPage + siblingPagesCount, totalPages);
+        const shouldShowLeftEllipsis = leftSiblingIndex > 2;
+        const shouldShowRightEllipsis = rightSiblingIndex < totalPages - 2;
+        const firstPage = 1;
+        const lastPage = totalPages;
+        if (!shouldShowLeftEllipsis && shouldShowRightEllipsis) {
+            const leftRange = createRange(1, 3 + 2 * siblingPagesCount);
+            return [
+                ...leftRange,
+                ELLIPSIS,
+                lastPage
+            ];
+        }
+        if (shouldShowLeftEllipsis && !shouldShowRightEllipsis) {
+            const rightRange = createRange(totalPages - (3 + 2 * siblingPagesCount) + 1, totalPages);
+            return [
+                firstPage,
+                ELLIPSIS,
+                ...rightRange
+            ];
+        }
+        if (shouldShowLeftEllipsis && shouldShowRightEllipsis) {
+            const middleRange = createRange(leftSiblingIndex, rightSiblingIndex);
+            return [
+                firstPage,
+                ELLIPSIS,
+                ...middleRange,
+                ELLIPSIS,
+                lastPage
+            ];
+        }
+        return [];
+    }, [
+        totalResults,
+        resultsPerPage,
+        siblingPagesCount,
+        currentPage
+    ]);
+}
+exports.ELLIPSIS = __webpack_exports__.ELLIPSIS;
+exports.usePagination = __webpack_exports__.usePagination;
+for(var __rspack_i in __webpack_exports__)if (-1 === [
+    "ELLIPSIS",
+    "usePagination"
+].indexOf(__rspack_i)) exports[__rspack_i] = __webpack_exports__[__rspack_i];
+Object.defineProperty(exports, '__esModule', {
+    value: true
+});

package/dist/hooks/use-pagination.d.ts

@@ -1,25 +1,27 @@
 export interface UsePaginationProps {
-    /** The current active page number */
+    /** Current active page number. */
     currentPage: number;
-    /** The number of results to display per page */
+    /** Number of results displayed per page. */
     resultsPerPage: number;
     /**
-     * The number of sibling pages to display on either side of the current page.
+     * Number of sibling pages to show on each side of the current page.
      * Defaults to 1.
      */
     siblingPagesCount?: number;
-    /** The total number of results across all pages */
+    /** Total number of results across all pages. */
     totalResults: number;
 }
-/** Constant representing the ellipsis ("...") used in pagination */
+/** Ellipsis marker used to collapse ranges in pagination output. */
 export declare const ELLIPSIS = "\u2022\u2022\u2022";
 /**
- * A custom hook that calculates the pagination logic for a given set of
- * results.
+ * Compute a pagination structure for result sets.
  *
- * @param props - An object containing the pagination properties
- * @returns An array representing the pagination structure, which includes page
- *   numbers and ellipsis indicators
+ * Returns a mixed array of page numbers and the `ELLIPSIS` marker representing
+ * collapsed ranges. The shape adapts to the total pages and the requested
+ * sibling window around the current page.
+ *
+ * @param props - Pagination options. See {@link UsePaginationProps}.
+ * @returns Array of page numbers and `ELLIPSIS` representing the pagination model.
  *
  * @example
  * ```tsx

package/dist/hooks/use-pagination.js

@@ -1,2 +1,56 @@
 "use client";
-import{useMemo as t}from"react";let r="•••",e=(t,r)=>Array.from({length:r-t+1},(r,e)=>t+e);function n({currentPage:n,resultsPerPage:a,siblingPagesCount:i=1,totalResults:o}){return t(()=>{let t=Math.ceil(o/Math.floor(a));if(t<=0)return[];if(i+5>=t)return e(1,t);let f=Math.max(n-i,1),l=Math.min(n+i,t),u=f>2,h=l<t-2;return!u&&h?[...e(1,3+2*i),r,t]:u&&!h?[1,r,...e(t-(3+2*i)+1,t)]:u&&h?[1,r,...e(f,l),r,t]:[]},[o,a,i,n])}export{r as ELLIPSIS,n as usePagination};
+import { useMemo } from "react";
+const ELLIPSIS = "•••";
+const createRange = (start, end)=>{
+    const length = end - start + 1;
+    return Array.from({
+        length
+    }, (_, index)=>start + index);
+};
+function usePagination({ currentPage, resultsPerPage, siblingPagesCount = 1, totalResults }) {
+    return useMemo(()=>{
+        const totalPages = Math.ceil(totalResults / Math.floor(resultsPerPage));
+        if (totalPages <= 0) return [];
+        const visiblePageNumbers = siblingPagesCount + 5;
+        if (visiblePageNumbers >= totalPages) return createRange(1, totalPages);
+        const leftSiblingIndex = Math.max(currentPage - siblingPagesCount, 1);
+        const rightSiblingIndex = Math.min(currentPage + siblingPagesCount, totalPages);
+        const shouldShowLeftEllipsis = leftSiblingIndex > 2;
+        const shouldShowRightEllipsis = rightSiblingIndex < totalPages - 2;
+        const firstPage = 1;
+        const lastPage = totalPages;
+        if (!shouldShowLeftEllipsis && shouldShowRightEllipsis) {
+            const leftRange = createRange(1, 3 + 2 * siblingPagesCount);
+            return [
+                ...leftRange,
+                ELLIPSIS,
+                lastPage
+            ];
+        }
+        if (shouldShowLeftEllipsis && !shouldShowRightEllipsis) {
+            const rightRange = createRange(totalPages - (3 + 2 * siblingPagesCount) + 1, totalPages);
+            return [
+                firstPage,
+                ELLIPSIS,
+                ...rightRange
+            ];
+        }
+        if (shouldShowLeftEllipsis && shouldShowRightEllipsis) {
+            const middleRange = createRange(leftSiblingIndex, rightSiblingIndex);
+            return [
+                firstPage,
+                ELLIPSIS,
+                ...middleRange,
+                ELLIPSIS,
+                lastPage
+            ];
+        }
+        return [];
+    }, [
+        totalResults,
+        resultsPerPage,
+        siblingPagesCount,
+        currentPage
+    ]);
+}
+export { ELLIPSIS, usePagination };