@med_ghoul/forge-shared 1.2.0

package/README.md

@@ -0,0 +1,158 @@
+# forge-shared
+
+A collection of reusable React hooks and utility functions for modern web development.
+
+## Features
+
+- 🎣 **React Hooks** - Custom hooks for common patterns
+- 🛠️ **Utilities** - Helper functions for everyday tasks
+- 📦 **Tree-shakeable** - Import only what you need
+- 🔒 **Type-safe** - Full TypeScript support
+- ✅ **Well-tested** - Comprehensive test coverage
+
+## Installation
+
+This package requires **Bun** (v1.1+) as the package manager.
+
+```bash
+bun install
+```
+
+## Usage
+
+### Import Everything
+
+```typescript
+import { useBoolean, useDebounce, classes, cookies } from 'forge-shared';
+```
+
+### Import Specific Modules
+
+```typescript
+// Hooks only
+import { useBoolean, useDebounce } from 'forge-shared/hooks';
+
+// Utils only
+import { classes, cookies } from 'forge-shared/utils';
+
+// Specific hook
+import { useBoolean } from 'forge-shared/hooks/use-boolean';
+
+// Specific util
+import { classes } from 'forge-shared/utils/classes';
+```
+
+## Available Hooks
+
+- `use-back-to-top` - Scroll to top functionality
+- `use-boolean` - Boolean state management
+- `use-client-rect` - Get client rectangle dimensions
+- `use-cookies` - Cookie management
+- `use-copy-to-clipboard` - Copy text to clipboard
+- `use-countdown-date` - Countdown to a specific date
+- `use-countdown-seconds` - Countdown timer in seconds
+- `use-debounce` - Debounce values
+- `use-double-click` - Handle double click events
+- `use-is-client` - Check if running on client
+- `use-local-storage` - LocalStorage management
+- `use-multi-select` - Multi-select state management
+- `use-popover` - Popover state management
+- `use-popover-hover` - Hover-based popover
+- `use-scroll-offset-top` - Track scroll offset from top
+- `use-set-state` - SetState-like hook
+- `use-tabs` - Tab state management
+
+## Available Utils
+
+- `active-link` - Active link detection
+- `classes` - CSS class name utilities
+- `color` - Color manipulation utilities
+- `cookies` - Cookie utilities
+- `css-variables` - CSS variable utilities
+- `font` - Font utilities
+- `local-storage` - LocalStorage utilities
+- `object` - Object manipulation utilities
+- `refs` - Ref utilities
+- `right-to-left` - RTL support utilities
+- `transform-number` - Number transformation utilities
+- `url` - URL utilities
+- `uuidv4` - UUID v4 generation
+
+## Development
+
+### Prerequisites
+
+- [Bun](https://bun.sh) v1.1.38 or higher
+- Node.js (for npm publishing if needed)
+
+### Setup
+
+```bash
+# Install dependencies
+bun install
+```
+
+### Scripts
+
+```bash
+# Development (watch mode)
+bun run dev
+
+# Build
+bun run build
+
+# Run tests
+bun run test
+
+# Watch tests
+bun run test:watch
+
+# Lint
+bun run lint
+
+# Fix linting issues
+bun run lint:fix
+
+# Format code
+bun run fm:fix
+
+# Check formatting
+bun run fm:check
+
+# Type checking
+bun run check-types
+
+# Clean build artifacts
+bun run clean
+
+# Rebuild from scratch
+bun run re:build
+
+# Update dependencies
+bun run check:update
+```
+
+## Project Structure
+
+```
+forge-shared/
+├── src/
+│   ├── hooks/          # React hooks
+│   └── utils/          # Utility functions
+├── dist/               # Build output
+├── package.json
+├── tsconfig.json
+├── eslint.config.mjs
+├── tsup.config.ts
+└── vitest.config.ts
+```
+
+## Requirements
+
+- React ^18.0.0 || ^19.0.0
+- React DOM ^18.0.0 || ^19.0.0
+- TypeScript ^5.0.0
+
+## License
+
+MIT © MedOx

package/dist/hooks/index.cjs

@@ -0,0 +1 @@
+"use strict";var L=Object.defineProperty;var B=Object.getOwnPropertyDescriptor;var _=Object.getOwnPropertyNames;var $=Object.prototype.hasOwnProperty;var W=(e,t)=>{for(var o in t)L(e,o,{get:t[o],enumerable:!0})},N=(e,t,o,r)=>{if(t&&typeof t=="object"||typeof t=="function")for(let n of _(t))!$.call(e,n)&&n!==o&&L(e,n,{get:()=>t[n],enumerable:!(r=B(t,n))||r.enumerable});return e};var J=e=>N(L({},"__esModule",{value:!0}),e);var de={};W(de,{updateSelectedItems:()=>j,useBackToTop:()=>ee,useBoolean:()=>G,useClientRect:()=>oe,useCookies:()=>K,useCopyToClipboard:()=>fe,useCountdownDate:()=>ae,useCountdownSeconds:()=>pe,useDebounce:()=>Q,useDoubleClick:()=>re,useIsClient:()=>Z,useLocalStorage:()=>ie,useMultiSelect:()=>ne,usePopover:()=>q,usePopoverHover:()=>le,useScrollOffsetTop:()=>ue,useSetState:()=>X,useTabs:()=>Y});module.exports=J(de);var k=require("react");function Y(e=!1){let[t,o]=(0,k.useState)(e),r=(0,k.useCallback)((i,s)=>{o(s)},[]),n=(0,k.useCallback)(()=>{o(e)},[e]);return{value:t,setValue:o,onChange:r,reset:n}}var x=require("react");function G(e=!1){let[t,o]=(0,x.useState)(e),r=(0,x.useCallback)(()=>{o(!0)},[]),n=(0,x.useCallback)(()=>{o(!1)},[]),i=(0,x.useCallback)(()=>{o(s=>!s)},[]);return{value:t,onTrue:r,onFalse:n,onToggle:i,setValue:o}}var E=require("react");function q(){let[e,t]=(0,E.useState)(null),o=(0,E.useCallback)(n=>{t(n.currentTarget)},[]),r=(0,E.useCallback)(()=>{t(null)},[]);return{open:!!e,anchorEl:e,onOpen:o,onClose:r,setAnchorEl:t}}var m=require("react");function A(e){if(!e||typeof e!="string")return console.warn("Invalid cookie key provided"),null;try{let t=`${e}=`,n=decodeURIComponent(document.cookie).split("; ").find(s=>s.startsWith(t));if(!n)return null;let i=n.substring(t.length);try{return JSON.parse(i)}catch{return i}}catch(t){return console.error("Error retrieving cookie:",t),null}}function U(e,t,o){if(!e||typeof e!="string"){console.error("Invalid cookie key provided");return}let{daysUntilExpiration:r=0,sameSite:n="Strict",secure:i=!1,path:s="/",domain:a}=o??{};try{let l=encodeURIComponent(typeof t=="string"?t:JSON.stringify(t)),u=[`${e}=${l}`,`path=${s}`,n&&`SameSite=${n}`,i&&"Secure",a&&`domain=${a}`];if(r>0){let p=new Date(Date.now()+r*24*60*60*1e3);u.push(`expires=${p.toUTCString()}`)}document.cookie=u.filter(Boolean).join("; ")}catch(l){console.error("Error setting cookie:",l)}}function P(e,t){if(!e||typeof e!="string"){console.error("Invalid cookie key provided");return}let{path:o="/",domain:r}=t??{};try{let n=[`${e}=`,"expires=Thu, 01 Jan 1970 00:00:00 GMT",`path=${o}`,r&&`domain=${r}`,"Secure"];document.cookie=n.filter(Boolean).join("; ")}catch(n){console.error("Error removing cookie:",n)}}function K(e,t,o){let{initializeWithValue:r=!0,...n}=o??{},i=t&&typeof t=="object",[s,a]=(0,m.useState)(t);(0,m.useEffect)(()=>{let c=A(e);c?a(i?S=>({...S,...c}):c):t&&r&&U(e,t,n)},[]);let l=(0,m.useCallback)(c=>{i?a(S=>{let I={...S,...c};return U(e,I,n),I}):(U(e,c,n),a(c))},[n,i,e]),u=(0,m.useCallback)((c,S)=>{i&&l({[c]:S})},[i,l]),p=(0,m.useCallback)(c=>{a(c??t),P(e)},[t,e]);return(0,m.useMemo)(()=>({state:s,setState:l,setField:u,resetState:p}),[p,u,l,s])}var M=require("react");function Q(e,t=1e3){let[o,r]=(0,M.useState)(e);return(0,M.useEffect)(()=>{let n=setTimeout(()=>{r(e)},t);return()=>{clearTimeout(n)}},[e,t]),o}var C=require("react");function X(e){let[t,o]=(0,C.useState)(e),r=(0,C.useCallback)(s=>{o(a=>({...a,...s}))},[]),n=(0,C.useCallback)((s,a)=>{r({[s]:a})},[r]),i=(0,C.useCallback)(s=>{o(s??e)},[e]);return{state:t,setState:r,setField:n,resetState:i}}var O=require("react");function Z(){let[e,t]=(0,O.useState)(!1);return(0,O.useEffect)(()=>{t(!0)},[]),e}var g=require("react");function ee(e,t){let[o,r]=(0,g.useState)(!1),n=te(e),i=(0,g.useCallback)(()=>{let l=window.innerHeight,u=Math.round(window.scrollY),p=document.body.offsetHeight,f=Math.round(u/(p-l)*100);if(n.type==="percentage")r(f>=n.value);else{let c=p-l-u;r(n.value>=c)}},[n.type,n.value]),s=(0,g.useMemo)(()=>{let l;return()=>{clearTimeout(l),l=setTimeout(i,100)}},[i]);return(0,g.useEffect)(()=>{let l=t?s:i;return window.addEventListener("scroll",l),()=>{window.removeEventListener("scroll",l)}},[s,i,t]),{isVisible:o,onBackToTop:()=>{window.scrollTo({top:0,behavior:"smooth"})},setIsVisible:r}}function te(e){let t,o;if(typeof e=="string")if(e.endsWith("%")){if(t=Number(e.slice(0,-1)),isNaN(t))throw new Error("Invalid percentage value");o="percentage"}else throw new Error("String input must end with %");else t=e,o="number";return{value:t,type:o}}var d=require("react");function oe(e,t){let o=(0,d.useRef)(null),r=e||o,[n,i]=(0,d.useState)(void 0),[s,a]=(0,d.useState)(void 0),l=typeof window<"u"?d.useLayoutEffect:d.useEffect,u=(0,d.useCallback)(()=>{if(r.current){let c=r.current.getBoundingClientRect();i(c),a({scrollWidth:r.current.scrollWidth,scrollHeight:r.current.scrollHeight})}},[r]);l(()=>{u()},[u]),(0,d.useEffect)(()=>{let c=t||"resize";return window.addEventListener(c,u),()=>{window.removeEventListener(c,u)}},[t,u]);let p=(0,d.useMemo)(()=>n,[n]),f=(0,d.useMemo)(()=>s,[s]);return{elementRef:r,top:p?.top??0,right:p?.right??0,bottom:p?.bottom??0,left:p?.left??0,x:p?.x??0,y:p?.y??0,width:p?.width??0,height:p?.height??0,scrollWidth:f?.scrollWidth??0,scrollHeight:f?.scrollHeight??0}}var h=require("react");function ne(e,t){let[o,r]=(0,h.useState)(t??[]),n=(0,h.useCallback)(l=>{r(u=>j(u,l))},[]),i=(0,h.useCallback)(()=>{r(l=>l.length===e.length?[]:e)},[e]),s=(0,h.useCallback)(()=>{r([])},[]),a=(0,h.useMemo)(()=>o.length===0?"unchecked":o.length===e.length?"checked":"indeterminate",[e.length,o.length]);return{values:o,status:a,setValues:r,onSelectAllItems:i,onDeSelectAllItems:s,onToggleSelectItem:n}}function j(e,t){return e.includes(t)?e.filter(o=>o!==t):[...e,t]}var w=require("react");function re({click:e,doubleClick:t,timeout:o=250}){let r=(0,w.useRef)(null),n=(0,w.useCallback)(()=>{r.current&&(clearTimeout(r.current),r.current=null)},[]);return(0,w.useCallback)(s=>{n(),e&&s.detail===1&&(r.current=setTimeout(()=>{e(s)},o)),s.detail%2===0&&t(s)},[e,t,o,n])}var T=require("react");function F(e,t){if(!se())return t??null;let o=localStorage.getItem(e);if(o!=="undefined"){if(o)try{return JSON.parse(o)}catch{return o??t??null}return t??null}}function D(e,t){try{let o=JSON.stringify(t);window.localStorage.setItem(e,o)}catch(o){console.error("Error while setting storage:",o)}}function z(e){try{window.localStorage.removeItem(e)}catch(t){console.error("Error while removing from storage:",t)}}function se(){try{let e="__some_random_key_you_are_not_going_to_use__";return window.localStorage.setItem(e,e),window.localStorage.removeItem(e),!0}catch{return!1}}function ie(e,t,o){let{initializeWithValue:r=!0}=o??{},n=t&&typeof t=="object",[i,s]=(0,T.useState)(t);(0,T.useEffect)(()=>{let f=F(e);f?s(n?c=>({...c,...f}):f):t&&r&&D(e,t)},[]);let a=(0,T.useCallback)(f=>{n?s(c=>{let S={...c,...f};return D(e,S),S}):(D(e,f),s(f))},[e,n]),l=(0,T.useCallback)((f,c)=>{n&&a({[f]:c})},[n,a]),u=(0,T.useCallback)(f=>{s(f??t),z(e)},[t,e]);return(0,T.useMemo)(()=>({state:i,setState:a,setField:l,resetState:u}),[u,l,a,i])}var y=require("react");function le(e){let t=(0,y.useRef)(null),o=e||t,[r,n]=(0,y.useState)(!1),i=(0,y.useCallback)(()=>{n(!0)},[]),s=(0,y.useCallback)(()=>{n(!1)},[]);return{elementRef:o,anchorEl:o.current,open:r,onOpen:i,onClose:s,setOpen:n}}var R=require("react");function ae(e,t="- -"){let[o,r]=(0,R.useState)({days:t,hours:t,minutes:t,seconds:t}),n=(0,R.useCallback)(()=>{let i=new Date,{days:s,hours:a,minutes:l,seconds:u}=ce(e,i);r({days:V(s),hours:V(a),minutes:V(l),seconds:V(u)})},[e]);return(0,R.useEffect)(()=>{n();let i=setInterval(n,1e3);return()=>clearInterval(i)},[]),o}function V(e){return String(e).length===1?`0${e}`:`${e}`}function ce(e,t){let o=e.getTime()-t.getTime();return{days:Math.floor(o/(1e3*60*60*24)),hours:Math.floor(o%(1e3*60*60*24)/(1e3*60*60)),minutes:Math.floor(o%(1e3*60*60)/(1e3*60)),seconds:Math.floor(o%(1e3*60)/1e3)}}var b=require("react");function ue(e=0){let t=(0,b.useRef)(null),[o,r]=(0,b.useState)(!1),n=(0,b.useCallback)(()=>{let i=window.scrollY;if(t.current){let s=t.current.offsetTop;r(i>s-e)}else r(i>e)},[e]);return(0,b.useEffect)(()=>(n(),window.addEventListener("scroll",n),()=>{window.removeEventListener("scroll",n)}),[n]),{elementRef:t,offsetTop:o}}var v=require("react");function pe(e){let[t,o]=(0,v.useState)(e),[r,n]=(0,v.useState)(!1),i=(0,v.useCallback)(()=>{n(!0)},[]),s=(0,v.useCallback)(()=>{n(!1),o(e)},[e]);return(0,v.useEffect)(()=>{let a=null;return r&&t>0?a=setInterval(()=>{o(l=>l-1)},1e3):t<=0&&n(!1),()=>{a&&clearInterval(a)}},[r,t]),{value:t,setValue:o,isCounting:r,start:i,reset:s}}var H=require("react");function fe(){let[e,t]=(0,H.useState)(null);return{copy:(0,H.useCallback)(async r=>{if(!navigator?.clipboard)return console.warn("Clipboard not supported"),!1;try{return await navigator.clipboard.writeText(r),t(r),!0}catch(n){return console.warn("Copy failed",n),t(null),!1}},[t]),copiedText:e}}0&&(module.exports={updateSelectedItems,useBackToTop,useBoolean,useClientRect,useCookies,useCopyToClipboard,useCountdownDate,useCountdownSeconds,useDebounce,useDoubleClick,useIsClient,useLocalStorage,useMultiSelect,usePopover,usePopoverHover,useScrollOffsetTop,useSetState,useTabs});

package/dist/hooks/index.d.cts

@@ -0,0 +1,19 @@
+export { UseTabsReturn, useTabs } from './use-tabs/use-tabs.cjs';
+export { UseBooleanReturn, useBoolean } from './use-boolean/use-boolean.cjs';
+export { UsePopoverReturn, usePopover } from './use-popover/use-popover.cjs';
+export { UseCookiesOptions, UseCookiesReturn, useCookies } from './use-cookies/use-cookies.cjs';
+export { UseDebounceReturn, useDebounce } from './use-debounce/use-debounce.cjs';
+export { UseSetStateReturn, useSetState } from './use-set-state/use-set-state.cjs';
+export { UseIsClientReturn, useIsClient } from './use-is-client/use-is-client.cjs';
+export { UseBackToTopReturn, useBackToTop } from './use-back-to-top/use-back-to-top.cjs';
+export { UseClientRectReturn, useClientRect } from './use-client-rect/use-client-rect.cjs';
+export { UseMultiSelectReturn, updateSelectedItems, useMultiSelect } from './use-multi-select/use-multi-select.cjs';
+export { UseDoubleClickReturn, useDoubleClick } from './use-double-click/use-double-click.cjs';
+export { UseLocalStorageOptions, UseLocalStorageReturn, useLocalStorage } from './use-local-storage/use-local-storage.cjs';
+export { usePopoverHover } from './use-popover-hover/use-popover-hover.cjs';
+export { UseCountdownDateReturn, useCountdownDate } from './use-countdown-date/use-countdown-date.cjs';
+export { UseScrollOffsetTopReturn, useScrollOffsetTop } from './use-scroll-offset-top/use-scroll-offset-top.cjs';
+export { UseCountdownSecondsReturn, useCountdownSeconds } from './use-countdown-seconds/use-countdown-seconds.cjs';
+export { CopiedValue, CopyFn, UseCopyToClipboardReturn, useCopyToClipboard } from './use-copy-to-clipboard/use-copy-to-clipboard.cjs';
+import 'react';
+import '../utils/cookies/cookies.cjs';

package/dist/hooks/index.d.ts

@@ -0,0 +1,19 @@
+export { UseTabsReturn, useTabs } from './use-tabs/use-tabs.js';
+export { UseBooleanReturn, useBoolean } from './use-boolean/use-boolean.js';
+export { UsePopoverReturn, usePopover } from './use-popover/use-popover.js';
+export { UseCookiesOptions, UseCookiesReturn, useCookies } from './use-cookies/use-cookies.js';
+export { UseDebounceReturn, useDebounce } from './use-debounce/use-debounce.js';
+export { UseSetStateReturn, useSetState } from './use-set-state/use-set-state.js';
+export { UseIsClientReturn, useIsClient } from './use-is-client/use-is-client.js';
+export { UseBackToTopReturn, useBackToTop } from './use-back-to-top/use-back-to-top.js';
+export { UseClientRectReturn, useClientRect } from './use-client-rect/use-client-rect.js';
+export { UseMultiSelectReturn, updateSelectedItems, useMultiSelect } from './use-multi-select/use-multi-select.js';
+export { UseDoubleClickReturn, useDoubleClick } from './use-double-click/use-double-click.js';
+export { UseLocalStorageOptions, UseLocalStorageReturn, useLocalStorage } from './use-local-storage/use-local-storage.js';
+export { usePopoverHover } from './use-popover-hover/use-popover-hover.js';
+export { UseCountdownDateReturn, useCountdownDate } from './use-countdown-date/use-countdown-date.js';
+export { UseScrollOffsetTopReturn, useScrollOffsetTop } from './use-scroll-offset-top/use-scroll-offset-top.js';
+export { UseCountdownSecondsReturn, useCountdownSeconds } from './use-countdown-seconds/use-countdown-seconds.js';
+export { CopiedValue, CopyFn, UseCopyToClipboardReturn, useCopyToClipboard } from './use-copy-to-clipboard/use-copy-to-clipboard.js';
+import 'react';
+import '../utils/cookies/cookies.js';

package/dist/hooks/index.js

@@ -0,0 +1 @@
+import{useCallback as C,useState as A}from"react";function Ce(e=!1){let[t,o]=A(e),r=C((i,s)=>{o(s)},[]),n=C(()=>{o(e)},[e]);return{value:t,setValue:o,onChange:r,reset:n}}import{useCallback as g,useState as P}from"react";function Ee(e=!1){let[t,o]=P(e),r=g(()=>{o(!0)},[]),n=g(()=>{o(!1)},[]),i=g(()=>{o(s=>!s)},[]);return{value:t,onTrue:r,onFalse:n,onToggle:i,setValue:o}}import{useCallback as R,useState as j}from"react";function Me(){let[e,t]=j(null),o=R(n=>{t(n.currentTarget)},[]),r=R(()=>{t(null)},[]);return{open:!!e,anchorEl:e,onOpen:o,onClose:r,setAnchorEl:t}}import{useCallback as h,useEffect as F,useMemo as z,useState as B}from"react";function k(e){if(!e||typeof e!="string")return console.warn("Invalid cookie key provided"),null;try{let t=`${e}=`,n=decodeURIComponent(document.cookie).split("; ").find(s=>s.startsWith(t));if(!n)return null;let i=n.substring(t.length);try{return JSON.parse(i)}catch{return i}}catch(t){return console.error("Error retrieving cookie:",t),null}}function m(e,t,o){if(!e||typeof e!="string"){console.error("Invalid cookie key provided");return}let{daysUntilExpiration:r=0,sameSite:n="Strict",secure:i=!1,path:s="/",domain:a}=o??{};try{let l=encodeURIComponent(typeof t=="string"?t:JSON.stringify(t)),u=[`${e}=${l}`,`path=${s}`,n&&`SameSite=${n}`,i&&"Secure",a&&`domain=${a}`];if(r>0){let p=new Date(Date.now()+r*24*60*60*1e3);u.push(`expires=${p.toUTCString()}`)}document.cookie=u.filter(Boolean).join("; ")}catch(l){console.error("Error setting cookie:",l)}}function E(e,t){if(!e||typeof e!="string"){console.error("Invalid cookie key provided");return}let{path:o="/",domain:r}=t??{};try{let n=[`${e}=`,"expires=Thu, 01 Jan 1970 00:00:00 GMT",`path=${o}`,r&&`domain=${r}`,"Secure"];document.cookie=n.filter(Boolean).join("; ")}catch(n){console.error("Error removing cookie:",n)}}function Le(e,t,o){let{initializeWithValue:r=!0,...n}=o??{},i=t&&typeof t=="object",[s,a]=B(t);F(()=>{let c=k(e);c?a(i?d=>({...d,...c}):c):t&&r&&m(e,t,n)},[]);let l=h(c=>{i?a(d=>{let x={...d,...c};return m(e,x,n),x}):(m(e,c,n),a(c))},[n,i,e]),u=h((c,d)=>{i&&l({[c]:d})},[i,l]),p=h(c=>{a(c??t),E(e)},[t,e]);return z(()=>({state:s,setState:l,setField:u,resetState:p}),[p,u,l,s])}import{useEffect as _,useState as $}from"react";function Pe(e,t=1e3){let[o,r]=$(e);return _(()=>{let n=setTimeout(()=>{r(e)},t);return()=>{clearTimeout(n)}},[e,t]),o}import{useCallback as b,useState as W}from"react";function ze(e){let[t,o]=W(e),r=b(s=>{o(a=>({...a,...s}))},[]),n=b((s,a)=>{r({[s]:a})},[r]),i=b(s=>{o(s??e)},[e]);return{state:t,setState:r,setField:n,resetState:i}}import{useEffect as N,useState as J}from"react";function $e(){let[e,t]=J(!1);return N(()=>{t(!0)},[]),e}import{useCallback as Y,useEffect as G,useMemo as q,useState as K}from"react";function Je(e,t){let[o,r]=K(!1),n=Q(e),i=Y(()=>{let l=window.innerHeight,u=Math.round(window.scrollY),p=document.body.offsetHeight,f=Math.round(u/(p-l)*100);if(n.type==="percentage")r(f>=n.value);else{let c=p-l-u;r(n.value>=c)}},[n.type,n.value]),s=q(()=>{let l;return()=>{clearTimeout(l),l=setTimeout(i,100)}},[i]);return G(()=>{let l=t?s:i;return window.addEventListener("scroll",l),()=>{window.removeEventListener("scroll",l)}},[s,i,t]),{isVisible:o,onBackToTop:()=>{window.scrollTo({top:0,behavior:"smooth"})},setIsVisible:r}}function Q(e){let t,o;if(typeof e=="string")if(e.endsWith("%")){if(t=Number(e.slice(0,-1)),isNaN(t))throw new Error("Invalid percentage value");o="percentage"}else throw new Error("String input must end with %");else t=e,o="number";return{value:t,type:o}}import{useCallback as X,useEffect as w,useLayoutEffect as Z,useMemo as U,useRef as ee,useState as M}from"react";function qe(e,t){let o=ee(null),r=e||o,[n,i]=M(void 0),[s,a]=M(void 0),l=typeof window<"u"?Z:w,u=X(()=>{if(r.current){let c=r.current.getBoundingClientRect();i(c),a({scrollWidth:r.current.scrollWidth,scrollHeight:r.current.scrollHeight})}},[r]);l(()=>{u()},[u]),w(()=>{let c=t||"resize";return window.addEventListener(c,u),()=>{window.removeEventListener(c,u)}},[t,u]);let p=U(()=>n,[n]),f=U(()=>s,[s]);return{elementRef:r,top:p?.top??0,right:p?.right??0,bottom:p?.bottom??0,left:p?.left??0,x:p?.x??0,y:p?.y??0,width:p?.width??0,height:p?.height??0,scrollWidth:f?.scrollWidth??0,scrollHeight:f?.scrollHeight??0}}import{useCallback as v,useMemo as te,useState as oe}from"react";function Xe(e,t){let[o,r]=oe(t??[]),n=v(l=>{r(u=>ne(u,l))},[]),i=v(()=>{r(l=>l.length===e.length?[]:e)},[e]),s=v(()=>{r([])},[]),a=te(()=>o.length===0?"unchecked":o.length===e.length?"checked":"indeterminate",[e.length,o.length]);return{values:o,status:a,setValues:r,onSelectAllItems:i,onDeSelectAllItems:s,onToggleSelectItem:n}}function ne(e,t){return e.includes(t)?e.filter(o=>o!==t):[...e,t]}import{useCallback as O,useRef as re}from"react";function tt({click:e,doubleClick:t,timeout:o=250}){let r=re(null),n=O(()=>{r.current&&(clearTimeout(r.current),r.current=null)},[]);return O(s=>{n(),e&&s.detail===1&&(r.current=setTimeout(()=>{e(s)},o)),s.detail%2===0&&t(s)},[e,t,o,n])}import{useCallback as y,useEffect as ie,useMemo as le,useState as ae}from"react";function D(e,t){if(!se())return t??null;let o=localStorage.getItem(e);if(o!=="undefined"){if(o)try{return JSON.parse(o)}catch{return o??t??null}return t??null}}function T(e,t){try{let o=JSON.stringify(t);window.localStorage.setItem(e,o)}catch(o){console.error("Error while setting storage:",o)}}function V(e){try{window.localStorage.removeItem(e)}catch(t){console.error("Error while removing from storage:",t)}}function se(){try{let e="__some_random_key_you_are_not_going_to_use__";return window.localStorage.setItem(e,e),window.localStorage.removeItem(e),!0}catch{return!1}}function it(e,t,o){let{initializeWithValue:r=!0}=o??{},n=t&&typeof t=="object",[i,s]=ae(t);ie(()=>{let f=D(e);f?s(n?c=>({...c,...f}):f):t&&r&&T(e,t)},[]);let a=y(f=>{n?s(c=>{let d={...c,...f};return T(e,d),d}):(T(e,f),s(f))},[e,n]),l=y((f,c)=>{n&&a({[f]:c})},[n,a]),u=y(f=>{s(f??t),V(e)},[t,e]);return le(()=>({state:i,setState:a,setField:l,resetState:u}),[u,l,a,i])}import{useCallback as H,useRef as ce,useState as ue}from"react";function ct(e){let t=ce(null),o=e||t,[r,n]=ue(!1),i=H(()=>{n(!0)},[]),s=H(()=>{n(!1)},[]);return{elementRef:o,anchorEl:o.current,open:r,onOpen:i,onClose:s,setOpen:n}}import{useCallback as pe,useEffect as fe,useState as de}from"react";function ft(e,t="- -"){let[o,r]=de({days:t,hours:t,minutes:t,seconds:t}),n=pe(()=>{let i=new Date,{days:s,hours:a,minutes:l,seconds:u}=me(e,i);r({days:S(s),hours:S(a),minutes:S(l),seconds:S(u)})},[e]);return fe(()=>{n();let i=setInterval(n,1e3);return()=>clearInterval(i)},[]),o}function S(e){return String(e).length===1?`0${e}`:`${e}`}function me(e,t){let o=e.getTime()-t.getTime();return{days:Math.floor(o/(1e3*60*60*24)),hours:Math.floor(o%(1e3*60*60*24)/(1e3*60*60)),minutes:Math.floor(o%(1e3*60*60)/(1e3*60)),seconds:Math.floor(o%(1e3*60)/1e3)}}import{useCallback as Te,useEffect as Se,useRef as ge,useState as he}from"react";function Tt(e=0){let t=ge(null),[o,r]=he(!1),n=Te(()=>{let i=window.scrollY;if(t.current){let s=t.current.offsetTop;r(i>s-e)}else r(i>e)},[e]);return Se(()=>(n(),window.addEventListener("scroll",n),()=>{window.removeEventListener("scroll",n)}),[n]),{elementRef:t,offsetTop:o}}import{useCallback as L,useEffect as be,useState as I}from"react";function ht(e){let[t,o]=I(e),[r,n]=I(!1),i=L(()=>{n(!0)},[]),s=L(()=>{n(!1),o(e)},[e]);return be(()=>{let a=null;return r&&t>0?a=setInterval(()=>{o(l=>l-1)},1e3):t<=0&&n(!1),()=>{a&&clearInterval(a)}},[r,t]),{value:t,setValue:o,isCounting:r,start:i,reset:s}}import{useCallback as ve,useState as ye}from"react";function yt(){let[e,t]=ye(null);return{copy:ve(async r=>{if(!navigator?.clipboard)return console.warn("Clipboard not supported"),!1;try{return await navigator.clipboard.writeText(r),t(r),!0}catch(n){return console.warn("Copy failed",n),t(null),!1}},[t]),copiedText:e}}export{ne as updateSelectedItems,Je as useBackToTop,Ee as useBoolean,qe as useClientRect,Le as useCookies,yt as useCopyToClipboard,ft as useCountdownDate,ht as useCountdownSeconds,Pe as useDebounce,tt as useDoubleClick,$e as useIsClient,it as useLocalStorage,Xe as useMultiSelect,Me as usePopover,ct as usePopoverHover,Tt as useScrollOffsetTop,ze as useSetState,Ce as useTabs};

package/dist/hooks/use-back-to-top/index.cjs

@@ -0,0 +1 @@
+"use strict";var c=Object.defineProperty;var w=Object.getOwnPropertyDescriptor;var f=Object.getOwnPropertyNames;var b=Object.prototype.hasOwnProperty;var T=(t,e)=>{for(var n in e)c(t,n,{get:e[n],enumerable:!0})},h=(t,e,n,i)=>{if(e&&typeof e=="object"||typeof e=="function")for(let o of f(e))!b.call(t,o)&&o!==n&&c(t,o,{get:()=>e[o],enumerable:!(i=w(e,o))||i.enumerable});return t};var g=t=>h(c({},"__esModule",{value:!0}),t);var S={};T(S,{useBackToTop:()=>v});module.exports=g(S);var s=require("react");function v(t,e){let[n,i]=(0,s.useState)(!1),o=y(t),l=(0,s.useCallback)(()=>{let r=window.innerHeight,u=Math.round(window.scrollY),p=document.body.offsetHeight,d=Math.round(u/(p-r)*100);if(o.type==="percentage")i(d>=o.value);else{let m=p-r-u;i(o.value>=m)}},[o.type,o.value]),a=(0,s.useMemo)(()=>{let r;return()=>{clearTimeout(r),r=setTimeout(l,100)}},[l]);return(0,s.useEffect)(()=>{let r=e?a:l;return window.addEventListener("scroll",r),()=>{window.removeEventListener("scroll",r)}},[a,l,e]),{isVisible:n,onBackToTop:()=>{window.scrollTo({top:0,behavior:"smooth"})},setIsVisible:i}}function y(t){let e,n;if(typeof t=="string")if(t.endsWith("%")){if(e=Number(t.slice(0,-1)),isNaN(e))throw new Error("Invalid percentage value");n="percentage"}else throw new Error("String input must end with %");else e=t,n="number";return{value:e,type:n}}0&&(module.exports={useBackToTop});

package/dist/hooks/use-back-to-top/index.d.cts

@@ -0,0 +1,2 @@
+export { UseBackToTopReturn, useBackToTop } from './use-back-to-top.cjs';
+import 'react';

package/dist/hooks/use-back-to-top/index.d.ts

@@ -0,0 +1,2 @@
+export { UseBackToTopReturn, useBackToTop } from './use-back-to-top.js';
+import 'react';

package/dist/hooks/use-back-to-top/index.js

@@ -0,0 +1 @@
+import{useCallback as d,useEffect as m,useMemo as w,useState as f}from"react";function g(o,t){let[n,i]=f(!1),r=b(o),s=d(()=>{let e=window.innerHeight,c=Math.round(window.scrollY),a=document.body.offsetHeight,u=Math.round(c/(a-e)*100);if(r.type==="percentage")i(u>=r.value);else{let p=a-e-c;i(r.value>=p)}},[r.type,r.value]),l=w(()=>{let e;return()=>{clearTimeout(e),e=setTimeout(s,100)}},[s]);return m(()=>{let e=t?l:s;return window.addEventListener("scroll",e),()=>{window.removeEventListener("scroll",e)}},[l,s,t]),{isVisible:n,onBackToTop:()=>{window.scrollTo({top:0,behavior:"smooth"})},setIsVisible:i}}function b(o){let t,n;if(typeof o=="string")if(o.endsWith("%")){if(t=Number(o.slice(0,-1)),isNaN(t))throw new Error("Invalid percentage value");n="percentage"}else throw new Error("String input must end with %");else t=o,n="number";return{value:t,type:n}}export{g as useBackToTop};

package/dist/hooks/use-back-to-top/use-back-to-top.cjs

@@ -0,0 +1 @@
+"use strict";var c=Object.defineProperty;var w=Object.getOwnPropertyDescriptor;var b=Object.getOwnPropertyNames;var f=Object.prototype.hasOwnProperty;var T=(t,e)=>{for(var n in e)c(t,n,{get:e[n],enumerable:!0})},h=(t,e,n,i)=>{if(e&&typeof e=="object"||typeof e=="function")for(let o of b(e))!f.call(t,o)&&o!==n&&c(t,o,{get:()=>e[o],enumerable:!(i=w(e,o))||i.enumerable});return t};var g=t=>h(c({},"__esModule",{value:!0}),t);var S={};T(S,{useBackToTop:()=>v});module.exports=g(S);var s=require("react");function v(t,e){let[n,i]=(0,s.useState)(!1),o=y(t),l=(0,s.useCallback)(()=>{let r=window.innerHeight,u=Math.round(window.scrollY),p=document.body.offsetHeight,d=Math.round(u/(p-r)*100);if(o.type==="percentage")i(d>=o.value);else{let m=p-r-u;i(o.value>=m)}},[o.type,o.value]),a=(0,s.useMemo)(()=>{let r;return()=>{clearTimeout(r),r=setTimeout(l,100)}},[l]);return(0,s.useEffect)(()=>{let r=e?a:l;return window.addEventListener("scroll",r),()=>{window.removeEventListener("scroll",r)}},[a,l,e]),{isVisible:n,onBackToTop:()=>{window.scrollTo({top:0,behavior:"smooth"})},setIsVisible:i}}function y(t){let e,n;if(typeof t=="string")if(t.endsWith("%")){if(e=Number(t.slice(0,-1)),isNaN(e))throw new Error("Invalid percentage value");n="percentage"}else throw new Error("String input must end with %");else e=t,n="number";return{value:e,type:n}}0&&(module.exports={useBackToTop});

package/dist/hooks/use-back-to-top/use-back-to-top.d.cts

@@ -0,0 +1,33 @@
+import { Dispatch, SetStateAction } from 'react';
+
+/**
+ * Custom hook to manage the visibility of a "Back to Top" button based on scroll position.
+ *
+ * @param {string | number} defaultValue - The scroll progress percentage (e.g., '90%') or distance in pixels (e.g., 80) at which the button becomes visible.
+ * - If `defaultValue` is a percentage string (e.g., '90%'), the button becomes visible when the scroll distance is that percentage from the top.
+ * - If `defaultValue` is a number (e.g., 80), the button becomes visible when the scroll distance is that many pixels from the bottom.
+ * @param {boolean} [isDebounce=false] - Whether to debounce the scroll handler to improve performance.
+ *
+ * @returns {UseBackToTopReturn} - An object containing:
+ * - `isVisible`: A boolean indicating whether the "Back to Top" button should be visible.
+ * - `onBackToTop`: A function to scroll the window back to the top smoothly.
+ * - `setIsVisible`: A function to manually set the visibility of the "Back to Top" button.
+ *
+ * @example
+ * const { isVisible, onBackToTop } = useBackToTop('90%');
+ * const { isVisible, onBackToTop } = useBackToTop(80);
+ *
+ * return (
+ *   <button onClick={onBackToTop} style={{ display: isVisible ? 'block' : 'none' }}>
+ *     Back to Top
+ *   </button>
+ * );
+ */
+type UseBackToTopReturn = {
+    isVisible: boolean;
+    onBackToTop: () => void;
+    setIsVisible: Dispatch<SetStateAction<boolean>>;
+};
+declare function useBackToTop(defaultValue: string | number, isDebounce?: boolean): UseBackToTopReturn;
+
+export { type UseBackToTopReturn, useBackToTop };

package/dist/hooks/use-back-to-top/use-back-to-top.d.ts

@@ -0,0 +1,33 @@
+import { Dispatch, SetStateAction } from 'react';
+
+/**
+ * Custom hook to manage the visibility of a "Back to Top" button based on scroll position.
+ *
+ * @param {string | number} defaultValue - The scroll progress percentage (e.g., '90%') or distance in pixels (e.g., 80) at which the button becomes visible.
+ * - If `defaultValue` is a percentage string (e.g., '90%'), the button becomes visible when the scroll distance is that percentage from the top.
+ * - If `defaultValue` is a number (e.g., 80), the button becomes visible when the scroll distance is that many pixels from the bottom.
+ * @param {boolean} [isDebounce=false] - Whether to debounce the scroll handler to improve performance.
+ *
+ * @returns {UseBackToTopReturn} - An object containing:
+ * - `isVisible`: A boolean indicating whether the "Back to Top" button should be visible.
+ * - `onBackToTop`: A function to scroll the window back to the top smoothly.
+ * - `setIsVisible`: A function to manually set the visibility of the "Back to Top" button.
+ *
+ * @example
+ * const { isVisible, onBackToTop } = useBackToTop('90%');
+ * const { isVisible, onBackToTop } = useBackToTop(80);
+ *
+ * return (
+ *   <button onClick={onBackToTop} style={{ display: isVisible ? 'block' : 'none' }}>
+ *     Back to Top
+ *   </button>
+ * );
+ */
+type UseBackToTopReturn = {
+    isVisible: boolean;
+    onBackToTop: () => void;
+    setIsVisible: Dispatch<SetStateAction<boolean>>;
+};
+declare function useBackToTop(defaultValue: string | number, isDebounce?: boolean): UseBackToTopReturn;
+
+export { type UseBackToTopReturn, useBackToTop };

package/dist/hooks/use-back-to-top/use-back-to-top.js

@@ -0,0 +1 @@
+import{useCallback as d,useEffect as m,useMemo as w,useState as b}from"react";function g(o,t){let[n,i]=b(!1),r=f(o),s=d(()=>{let e=window.innerHeight,c=Math.round(window.scrollY),a=document.body.offsetHeight,u=Math.round(c/(a-e)*100);if(r.type==="percentage")i(u>=r.value);else{let p=a-e-c;i(r.value>=p)}},[r.type,r.value]),l=w(()=>{let e;return()=>{clearTimeout(e),e=setTimeout(s,100)}},[s]);return m(()=>{let e=t?l:s;return window.addEventListener("scroll",e),()=>{window.removeEventListener("scroll",e)}},[l,s,t]),{isVisible:n,onBackToTop:()=>{window.scrollTo({top:0,behavior:"smooth"})},setIsVisible:i}}function f(o){let t,n;if(typeof o=="string")if(o.endsWith("%")){if(t=Number(o.slice(0,-1)),isNaN(t))throw new Error("Invalid percentage value");n="percentage"}else throw new Error("String input must end with %");else t=o,n="number";return{value:t,type:n}}export{g as useBackToTop};

package/dist/hooks/use-boolean/index.cjs

@@ -0,0 +1 @@
+"use strict";var s=Object.defineProperty;var c=Object.getOwnPropertyDescriptor;var i=Object.getOwnPropertyNames;var p=Object.prototype.hasOwnProperty;var f=(o,e)=>{for(var t in e)s(o,t,{get:e[t],enumerable:!0})},m=(o,e,t,l)=>{if(e&&typeof e=="object"||typeof e=="function")for(let n of i(e))!p.call(o,n)&&n!==t&&s(o,n,{get:()=>e[n],enumerable:!(l=c(e,n))||l.enumerable});return o};var v=o=>m(s({},"__esModule",{value:!0}),o);var b={};f(b,{useBoolean:()=>S});module.exports=v(b);var a=require("react");function S(o=!1){let[e,t]=(0,a.useState)(o),l=(0,a.useCallback)(()=>{t(!0)},[]),n=(0,a.useCallback)(()=>{t(!1)},[]),r=(0,a.useCallback)(()=>{t(u=>!u)},[]);return{value:e,onTrue:l,onFalse:n,onToggle:r,setValue:t}}0&&(module.exports={useBoolean});

package/dist/hooks/use-boolean/index.d.cts

@@ -0,0 +1,2 @@
+export { UseBooleanReturn, useBoolean } from './use-boolean.cjs';
+import 'react';

package/dist/hooks/use-boolean/index.d.ts

@@ -0,0 +1,2 @@
+export { UseBooleanReturn, useBoolean } from './use-boolean.js';
+import 'react';

package/dist/hooks/use-boolean/index.js

@@ -0,0 +1 @@
+import{useCallback as o,useState as u}from"react";function i(t=!1){let[n,e]=u(t),a=o(()=>{e(!0)},[]),l=o(()=>{e(!1)},[]),s=o(()=>{e(r=>!r)},[]);return{value:n,onTrue:a,onFalse:l,onToggle:s,setValue:e}}export{i as useBoolean};

package/dist/hooks/use-boolean/use-boolean.cjs

@@ -0,0 +1 @@
+"use strict";var s=Object.defineProperty;var c=Object.getOwnPropertyDescriptor;var i=Object.getOwnPropertyNames;var p=Object.prototype.hasOwnProperty;var f=(o,e)=>{for(var t in e)s(o,t,{get:e[t],enumerable:!0})},v=(o,e,t,l)=>{if(e&&typeof e=="object"||typeof e=="function")for(let n of i(e))!p.call(o,n)&&n!==t&&s(o,n,{get:()=>e[n],enumerable:!(l=c(e,n))||l.enumerable});return o};var S=o=>v(s({},"__esModule",{value:!0}),o);var g={};f(g,{useBoolean:()=>b});module.exports=S(g);var a=require("react");function b(o=!1){let[e,t]=(0,a.useState)(o),l=(0,a.useCallback)(()=>{t(!0)},[]),n=(0,a.useCallback)(()=>{t(!1)},[]),r=(0,a.useCallback)(()=>{t(u=>!u)},[]);return{value:e,onTrue:l,onFalse:n,onToggle:r,setValue:t}}0&&(module.exports={useBoolean});

package/dist/hooks/use-boolean/use-boolean.d.cts

@@ -0,0 +1,29 @@
+import { Dispatch, SetStateAction } from 'react';
+
+/**
+ * Custom hook to manage a boolean state with utility functions to set it to true, false, or toggle its value.
+ *
+ * @param {boolean} [defaultValue=false] - The initial value of the boolean state.
+ *
+ * @example
+ * const { value, onTrue, onFalse, onToggle } = useBoolean(false);
+ *
+ * return (
+ *   <div>
+ *     <p>Value: {value.toString()}</p>
+ *     <button onClick={onTrue}>Set True</button>
+ *     <button onClick={onFalse}>Set False</button>
+ *     <button onClick={onToggle}>Toggle</button>
+ *   </div>
+ * );
+ */
+type UseBooleanReturn = {
+    value: boolean;
+    onTrue: () => void;
+    onFalse: () => void;
+    onToggle: () => void;
+    setValue: Dispatch<SetStateAction<boolean>>;
+};
+declare function useBoolean(defaultValue?: boolean): UseBooleanReturn;
+
+export { type UseBooleanReturn, useBoolean };

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

@@ -0,0 +1,29 @@
+import { Dispatch, SetStateAction } from 'react';
+
+/**
+ * Custom hook to manage a boolean state with utility functions to set it to true, false, or toggle its value.
+ *
+ * @param {boolean} [defaultValue=false] - The initial value of the boolean state.
+ *
+ * @example
+ * const { value, onTrue, onFalse, onToggle } = useBoolean(false);
+ *
+ * return (
+ *   <div>
+ *     <p>Value: {value.toString()}</p>
+ *     <button onClick={onTrue}>Set True</button>
+ *     <button onClick={onFalse}>Set False</button>
+ *     <button onClick={onToggle}>Toggle</button>
+ *   </div>
+ * );
+ */
+type UseBooleanReturn = {
+    value: boolean;
+    onTrue: () => void;
+    onFalse: () => void;
+    onToggle: () => void;
+    setValue: Dispatch<SetStateAction<boolean>>;
+};
+declare function useBoolean(defaultValue?: boolean): UseBooleanReturn;
+
+export { type UseBooleanReturn, useBoolean };

package/dist/hooks/use-boolean/use-boolean.js

@@ -0,0 +1 @@
+import{useCallback as o,useState as u}from"react";function i(t=!1){let[n,e]=u(t),a=o(()=>{e(!0)},[]),l=o(()=>{e(!1)},[]),s=o(()=>{e(r=>!r)},[]);return{value:n,onTrue:a,onFalse:l,onToggle:s,setValue:e}}export{i as useBoolean};

package/dist/hooks/use-client-rect/index.cjs

@@ -0,0 +1 @@
+"use strict";var s=Object.defineProperty;var b=Object.getOwnPropertyDescriptor;var a=Object.getOwnPropertyNames;var g=Object.prototype.hasOwnProperty;var p=(n,t)=>{for(var c in t)s(n,c,{get:t[c],enumerable:!0})},E=(n,t,c,l)=>{if(t&&typeof t=="object"||typeof t=="function")for(let o of a(t))!g.call(n,o)&&o!==c&&s(n,o,{get:()=>t[o],enumerable:!(l=b(t,o))||l.enumerable});return n};var T=n=>E(s({},"__esModule",{value:!0}),n);var y={};p(y,{useClientRect:()=>w});module.exports=T(y);var e=require("react");function w(n,t){let c=(0,e.useRef)(null),l=n||c,[o,f]=(0,e.useState)(void 0),[m,h]=(0,e.useState)(void 0),R=typeof window<"u"?e.useLayoutEffect:e.useEffect,i=(0,e.useCallback)(()=>{if(l.current){let u=l.current.getBoundingClientRect();f(u),h({scrollWidth:l.current.scrollWidth,scrollHeight:l.current.scrollHeight})}},[l]);R(()=>{i()},[i]),(0,e.useEffect)(()=>{let u=t||"resize";return window.addEventListener(u,i),()=>{window.removeEventListener(u,i)}},[t,i]);let r=(0,e.useMemo)(()=>o,[o]),d=(0,e.useMemo)(()=>m,[m]);return{elementRef:l,top:r?.top??0,right:r?.right??0,bottom:r?.bottom??0,left:r?.left??0,x:r?.x??0,y:r?.y??0,width:r?.width??0,height:r?.height??0,scrollWidth:d?.scrollWidth??0,scrollHeight:d?.scrollHeight??0}}0&&(module.exports={useClientRect});

package/dist/hooks/use-client-rect/index.d.cts

@@ -0,0 +1,2 @@
+export { UseClientRectReturn, useClientRect } from './use-client-rect.cjs';
+import 'react';

package/dist/hooks/use-client-rect/index.d.ts

@@ -0,0 +1,2 @@
+export { UseClientRectReturn, useClientRect } from './use-client-rect.js';
+import 'react';

package/dist/hooks/use-client-rect/index.js

@@ -0,0 +1 @@
+import{useCallback as a,useEffect as u,useLayoutEffect as g,useMemo as s,useRef as p,useState as m}from"react";function T(d,o){let f=p(null),t=d||f,[r,h]=m(void 0),[c,R]=m(void 0),b=typeof window<"u"?g:u,n=a(()=>{if(t.current){let l=t.current.getBoundingClientRect();h(l),R({scrollWidth:t.current.scrollWidth,scrollHeight:t.current.scrollHeight})}},[t]);b(()=>{n()},[n]),u(()=>{let l=o||"resize";return window.addEventListener(l,n),()=>{window.removeEventListener(l,n)}},[o,n]);let e=s(()=>r,[r]),i=s(()=>c,[c]);return{elementRef:t,top:e?.top??0,right:e?.right??0,bottom:e?.bottom??0,left:e?.left??0,x:e?.x??0,y:e?.y??0,width:e?.width??0,height:e?.height??0,scrollWidth:i?.scrollWidth??0,scrollHeight:i?.scrollHeight??0}}export{T as useClientRect};

package/dist/hooks/use-client-rect/use-client-rect.cjs

@@ -0,0 +1 @@
+"use strict";var s=Object.defineProperty;var b=Object.getOwnPropertyDescriptor;var a=Object.getOwnPropertyNames;var g=Object.prototype.hasOwnProperty;var p=(n,t)=>{for(var c in t)s(n,c,{get:t[c],enumerable:!0})},E=(n,t,c,l)=>{if(t&&typeof t=="object"||typeof t=="function")for(let o of a(t))!g.call(n,o)&&o!==c&&s(n,o,{get:()=>t[o],enumerable:!(l=b(t,o))||l.enumerable});return n};var T=n=>E(s({},"__esModule",{value:!0}),n);var y={};p(y,{useClientRect:()=>w});module.exports=T(y);var e=require("react");function w(n,t){let c=(0,e.useRef)(null),l=n||c,[o,f]=(0,e.useState)(void 0),[d,h]=(0,e.useState)(void 0),R=typeof window<"u"?e.useLayoutEffect:e.useEffect,i=(0,e.useCallback)(()=>{if(l.current){let u=l.current.getBoundingClientRect();f(u),h({scrollWidth:l.current.scrollWidth,scrollHeight:l.current.scrollHeight})}},[l]);R(()=>{i()},[i]),(0,e.useEffect)(()=>{let u=t||"resize";return window.addEventListener(u,i),()=>{window.removeEventListener(u,i)}},[t,i]);let r=(0,e.useMemo)(()=>o,[o]),m=(0,e.useMemo)(()=>d,[d]);return{elementRef:l,top:r?.top??0,right:r?.right??0,bottom:r?.bottom??0,left:r?.left??0,x:r?.x??0,y:r?.y??0,width:r?.width??0,height:r?.height??0,scrollWidth:m?.scrollWidth??0,scrollHeight:m?.scrollHeight??0}}0&&(module.exports={useClientRect});

package/dist/hooks/use-client-rect/use-client-rect.d.cts

@@ -0,0 +1,29 @@
+import { RefObject } from 'react';
+
+/**
+ * Custom hook to get the bounding client rect and scroll dimensions of a DOM element.
+ *
+ * @param {RefObject<T | null>} [inputRef] - Optional ref object to the target element.
+ * @param {string} [eventType] - Optional event type to trigger updates (e.g., 'scroll', 'resize').
+ * @returns {UseClientRectReturn<T>} - Object containing the bounding rect, scroll dimensions, and ref to the element.
+ */
+type ScrollElValue = {
+    scrollWidth: number;
+    scrollHeight: number;
+};
+type DOMRectValue = {
+    top: number;
+    right: number;
+    bottom: number;
+    left: number;
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+};
+type UseClientRectReturn<T extends HTMLElement = HTMLElement> = DOMRectValue & ScrollElValue & {
+    elementRef: RefObject<T>;
+};
+declare function useClientRect<T extends HTMLElement = HTMLElement>(inputRef?: RefObject<T | null>, eventType?: string): UseClientRectReturn<T>;
+
+export { type UseClientRectReturn, useClientRect };

package/dist/hooks/use-client-rect/use-client-rect.d.ts

@@ -0,0 +1,29 @@
+import { RefObject } from 'react';
+
+/**
+ * Custom hook to get the bounding client rect and scroll dimensions of a DOM element.
+ *
+ * @param {RefObject<T | null>} [inputRef] - Optional ref object to the target element.
+ * @param {string} [eventType] - Optional event type to trigger updates (e.g., 'scroll', 'resize').
+ * @returns {UseClientRectReturn<T>} - Object containing the bounding rect, scroll dimensions, and ref to the element.
+ */
+type ScrollElValue = {
+    scrollWidth: number;
+    scrollHeight: number;
+};
+type DOMRectValue = {
+    top: number;
+    right: number;
+    bottom: number;
+    left: number;
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+};
+type UseClientRectReturn<T extends HTMLElement = HTMLElement> = DOMRectValue & ScrollElValue & {
+    elementRef: RefObject<T>;
+};
+declare function useClientRect<T extends HTMLElement = HTMLElement>(inputRef?: RefObject<T | null>, eventType?: string): UseClientRectReturn<T>;
+
+export { type UseClientRectReturn, useClientRect };

package/dist/hooks/use-client-rect/use-client-rect.js

@@ -0,0 +1 @@
+import{useCallback as a,useEffect as u,useLayoutEffect as g,useMemo as s,useRef as p,useState as d}from"react";function T(m,o){let f=p(null),t=m||f,[r,h]=d(void 0),[c,R]=d(void 0),b=typeof window<"u"?g:u,n=a(()=>{if(t.current){let l=t.current.getBoundingClientRect();h(l),R({scrollWidth:t.current.scrollWidth,scrollHeight:t.current.scrollHeight})}},[t]);b(()=>{n()},[n]),u(()=>{let l=o||"resize";return window.addEventListener(l,n),()=>{window.removeEventListener(l,n)}},[o,n]);let e=s(()=>r,[r]),i=s(()=>c,[c]);return{elementRef:t,top:e?.top??0,right:e?.right??0,bottom:e?.bottom??0,left:e?.left??0,x:e?.x??0,y:e?.y??0,width:e?.width??0,height:e?.height??0,scrollWidth:i?.scrollWidth??0,scrollHeight:i?.scrollHeight??0}}export{T as useClientRect};

package/dist/hooks/use-cookies/index.cjs

@@ -0,0 +1 @@
+"use strict";var k=Object.defineProperty;var h=Object.getOwnPropertyDescriptor;var x=Object.getOwnPropertyNames;var y=Object.prototype.hasOwnProperty;var S=(e,o)=>{for(var r in o)k(e,r,{get:o[r],enumerable:!0})},v=(e,o,r,i)=>{if(o&&typeof o=="object"||typeof o=="function")for(let t of x(o))!y.call(e,t)&&t!==r&&k(e,t,{get:()=>o[t],enumerable:!(i=h(o,t))||i.enumerable});return e};var O=e=>v(k({},"__esModule",{value:!0}),e);var U={};S(U,{useCookies:()=>$});module.exports=O(U);var a=require("react");function C(e){if(!e||typeof e!="string")return console.warn("Invalid cookie key provided"),null;try{let o=`${e}=`,t=decodeURIComponent(document.cookie).split("; ").find(p=>p.startsWith(o));if(!t)return null;let s=t.substring(o.length);try{return JSON.parse(s)}catch{return s}}catch(o){return console.error("Error retrieving cookie:",o),null}}function f(e,o,r){if(!e||typeof e!="string"){console.error("Invalid cookie key provided");return}let{daysUntilExpiration:i=0,sameSite:t="Strict",secure:s=!1,path:p="/",domain:c}=r??{};try{let d=encodeURIComponent(typeof o=="string"?o:JSON.stringify(o)),u=[`${e}=${d}`,`path=${p}`,t&&`SameSite=${t}`,s&&"Secure",c&&`domain=${c}`];if(i>0){let T=new Date(Date.now()+i*24*60*60*1e3);u.push(`expires=${T.toUTCString()}`)}document.cookie=u.filter(Boolean).join("; ")}catch(d){console.error("Error setting cookie:",d)}}function g(e,o){if(!e||typeof e!="string"){console.error("Invalid cookie key provided");return}let{path:r="/",domain:i}=o??{};try{let t=[`${e}=`,"expires=Thu, 01 Jan 1970 00:00:00 GMT",`path=${r}`,i&&`domain=${i}`,"Secure"];document.cookie=t.filter(Boolean).join("; ")}catch(t){console.error("Error removing cookie:",t)}}function $(e,o,r){let{initializeWithValue:i=!0,...t}=r??{},s=o&&typeof o=="object",[p,c]=(0,a.useState)(o);(0,a.useEffect)(()=>{let n=C(e);n?c(s?l=>({...l,...n}):n):o&&i&&f(e,o,t)},[]);let d=(0,a.useCallback)(n=>{s?c(l=>{let m={...l,...n};return f(e,m,t),m}):(f(e,n,t),c(n))},[t,s,e]),u=(0,a.useCallback)((n,l)=>{s&&d({[n]:l})},[s,d]),T=(0,a.useCallback)(n=>{c(n??o),g(e)},[o,e]);return(0,a.useMemo)(()=>({state:p,setState:d,setField:u,resetState:T}),[T,u,d,p])}0&&(module.exports={useCookies});

package/dist/hooks/use-cookies/index.d.cts

@@ -0,0 +1,2 @@
+export { UseCookiesOptions, UseCookiesReturn, useCookies } from './use-cookies.cjs';
+import '../../utils/cookies/cookies.cjs';

package/dist/hooks/use-cookies/index.d.ts

@@ -0,0 +1,2 @@
+export { UseCookiesOptions, UseCookiesReturn, useCookies } from './use-cookies.js';
+import '../../utils/cookies/cookies.js';

package/dist/hooks/use-cookies/index.js

@@ -0,0 +1 @@
+import{useCallback as f,useEffect as g,useMemo as h,useState as x}from"react";function m(o){if(!o||typeof o!="string")return console.warn("Invalid cookie key provided"),null;try{let e=`${o}=`,t=decodeURIComponent(document.cookie).split("; ").find(d=>d.startsWith(e));if(!t)return null;let i=t.substring(e.length);try{return JSON.parse(i)}catch{return i}}catch(e){return console.error("Error retrieving cookie:",e),null}}function T(o,e,c){if(!o||typeof o!="string"){console.error("Invalid cookie key provided");return}let{daysUntilExpiration:n=0,sameSite:t="Strict",secure:i=!1,path:d="/",domain:s}=c??{};try{let a=encodeURIComponent(typeof e=="string"?e:JSON.stringify(e)),p=[`${o}=${a}`,`path=${d}`,t&&`SameSite=${t}`,i&&"Secure",s&&`domain=${s}`];if(n>0){let l=new Date(Date.now()+n*24*60*60*1e3);p.push(`expires=${l.toUTCString()}`)}document.cookie=p.filter(Boolean).join("; ")}catch(a){console.error("Error setting cookie:",a)}}function C(o,e){if(!o||typeof o!="string"){console.error("Invalid cookie key provided");return}let{path:c="/",domain:n}=e??{};try{let t=[`${o}=`,"expires=Thu, 01 Jan 1970 00:00:00 GMT",`path=${c}`,n&&`domain=${n}`,"Secure"];document.cookie=t.filter(Boolean).join("; ")}catch(t){console.error("Error removing cookie:",t)}}function $(o,e,c){let{initializeWithValue:n=!0,...t}=c??{},i=e&&typeof e=="object",[d,s]=x(e);g(()=>{let r=m(o);r?s(i?u=>({...u,...r}):r):e&&n&&T(o,e,t)},[]);let a=f(r=>{i?s(u=>{let k={...u,...r};return T(o,k,t),k}):(T(o,r,t),s(r))},[t,i,o]),p=f((r,u)=>{i&&a({[r]:u})},[i,a]),l=f(r=>{s(r??e),C(o)},[e,o]);return h(()=>({state:d,setState:a,setField:p,resetState:l}),[l,p,a,d])}export{$ as useCookies};

package/dist/hooks/use-cookies/use-cookies.cjs

@@ -0,0 +1 @@
+"use strict";var k=Object.defineProperty;var h=Object.getOwnPropertyDescriptor;var y=Object.getOwnPropertyNames;var S=Object.prototype.hasOwnProperty;var v=(o,e)=>{for(var i in e)k(o,i,{get:e[i],enumerable:!0})},x=(o,e,i,r)=>{if(e&&typeof e=="object"||typeof e=="function")for(let t of y(e))!S.call(o,t)&&t!==i&&k(o,t,{get:()=>e[t],enumerable:!(r=h(e,t))||r.enumerable});return o};var O=o=>x(k({},"__esModule",{value:!0}),o);var U={};v(U,{useCookies:()=>$});module.exports=O(U);var a=require("react");function C(o){if(!o||typeof o!="string")return console.warn("Invalid cookie key provided"),null;try{let e=`${o}=`,t=decodeURIComponent(document.cookie).split("; ").find(p=>p.startsWith(e));if(!t)return null;let s=t.substring(e.length);try{return JSON.parse(s)}catch{return s}}catch(e){return console.error("Error retrieving cookie:",e),null}}function f(o,e,i){if(!o||typeof o!="string"){console.error("Invalid cookie key provided");return}let{daysUntilExpiration:r=0,sameSite:t="Strict",secure:s=!1,path:p="/",domain:c}=i??{};try{let d=encodeURIComponent(typeof e=="string"?e:JSON.stringify(e)),u=[`${o}=${d}`,`path=${p}`,t&&`SameSite=${t}`,s&&"Secure",c&&`domain=${c}`];if(r>0){let T=new Date(Date.now()+r*24*60*60*1e3);u.push(`expires=${T.toUTCString()}`)}document.cookie=u.filter(Boolean).join("; ")}catch(d){console.error("Error setting cookie:",d)}}function g(o,e){if(!o||typeof o!="string"){console.error("Invalid cookie key provided");return}let{path:i="/",domain:r}=e??{};try{let t=[`${o}=`,"expires=Thu, 01 Jan 1970 00:00:00 GMT",`path=${i}`,r&&`domain=${r}`,"Secure"];document.cookie=t.filter(Boolean).join("; ")}catch(t){console.error("Error removing cookie:",t)}}function $(o,e,i){let{initializeWithValue:r=!0,...t}=i??{},s=e&&typeof e=="object",[p,c]=(0,a.useState)(e);(0,a.useEffect)(()=>{let n=C(o);n?c(s?l=>({...l,...n}):n):e&&r&&f(o,e,t)},[]);let d=(0,a.useCallback)(n=>{s?c(l=>{let m={...l,...n};return f(o,m,t),m}):(f(o,n,t),c(n))},[t,s,o]),u=(0,a.useCallback)((n,l)=>{s&&d({[n]:l})},[s,d]),T=(0,a.useCallback)(n=>{c(n??e),g(o)},[e,o]);return(0,a.useMemo)(()=>({state:p,setState:d,setField:u,resetState:T}),[T,u,d,p])}0&&(module.exports={useCookies});

package/dist/hooks/use-cookies/use-cookies.d.cts

@@ -0,0 +1,40 @@
+import { CookieOptions } from '../../utils/cookies/cookies.cjs';
+
+/**
+ * Custom hook to manage state with cookies.
+ *
+ * @template T
+ * @param {string} key - The key for the cookie.
+ * @param {T} initialState - The initial state value.
+ * @param {UseCookiesOptions} [options] - Optional settings.
+ *
+ * @returns {UseCookiesReturn<T>} - An object containing:
+ * - `state`: The current state.
+ * - `resetState`: A function to reset the state to the initial value and remove the cookie.
+ * - `setState`: A function to update the state and save it to the cookie.
+ * - `setField`: A function to update a specific field in the state and save it to the cookie.
+ *
+ * @example
+ * const { state, setState, setField, resetState } = useCookies('user', { name: '', age: 0 });
+ *
+ * return (
+ *   <div>
+ *     <p>Name: {state.name}</p>
+ *     <p>Age: {state.age}</p>
+ *     <button onClick={() => setField('name', 'John')}>Set Name</button>
+ *     <button onClick={resetState}>Reset</button>
+ *   </div>
+ * );
+ */
+type UseCookiesOptions = CookieOptions & {
+    initializeWithValue?: boolean;
+};
+type UseCookiesReturn<T> = {
+    state: T;
+    resetState: (defaultState?: T) => void;
+    setState: (updateState: T | Partial<T>) => void;
+    setField: (name: keyof T, updateValue: T[keyof T]) => void;
+};
+declare function useCookies<T>(key: string, initialState?: T, options?: UseCookiesOptions): UseCookiesReturn<T>;
+
+export { type UseCookiesOptions, type UseCookiesReturn, useCookies };

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

@@ -0,0 +1,40 @@
+import { CookieOptions } from '../../utils/cookies/cookies.js';
+
+/**
+ * Custom hook to manage state with cookies.
+ *
+ * @template T
+ * @param {string} key - The key for the cookie.
+ * @param {T} initialState - The initial state value.
+ * @param {UseCookiesOptions} [options] - Optional settings.
+ *
+ * @returns {UseCookiesReturn<T>} - An object containing:
+ * - `state`: The current state.
+ * - `resetState`: A function to reset the state to the initial value and remove the cookie.
+ * - `setState`: A function to update the state and save it to the cookie.
+ * - `setField`: A function to update a specific field in the state and save it to the cookie.
+ *
+ * @example
+ * const { state, setState, setField, resetState } = useCookies('user', { name: '', age: 0 });
+ *
+ * return (
+ *   <div>
+ *     <p>Name: {state.name}</p>
+ *     <p>Age: {state.age}</p>
+ *     <button onClick={() => setField('name', 'John')}>Set Name</button>
+ *     <button onClick={resetState}>Reset</button>
+ *   </div>
+ * );
+ */
+type UseCookiesOptions = CookieOptions & {
+    initializeWithValue?: boolean;
+};
+type UseCookiesReturn<T> = {
+    state: T;
+    resetState: (defaultState?: T) => void;
+    setState: (updateState: T | Partial<T>) => void;
+    setField: (name: keyof T, updateValue: T[keyof T]) => void;
+};
+declare function useCookies<T>(key: string, initialState?: T, options?: UseCookiesOptions): UseCookiesReturn<T>;
+
+export { type UseCookiesOptions, type UseCookiesReturn, useCookies };