@jbpark/use-hooks 1.1.3 → 2.0.1

package/README.md

@@ -11,7 +11,7 @@ A collection of reusable React 19 hooks for common UI and interaction patterns.
 
 ## Features
 
-- 📦 **10 Production-Ready Hooks** - Utilities for scrolling, viewport, storage, and more
+- 📦 **11 Production-Ready Hooks** - Utilities for scrolling, viewport, storage, and more
 - 🎯 **Full TypeScript Support** - Complete type definitions for better development experience
 - ⚡ **Tree-Shakeable** - Import only what you need
 - 🔒 **SSR-Safe** - Built-in protection for window/document globals
@@ -74,6 +74,7 @@ function MyComponent() {
 | `useImage`            | Preload images and expose loading/error states                              |
 | `useRecursiveTimeout` | Recursively schedule async/sync callbacks                                   |
 | `useViewport`         | visualViewport support with in-app mode option and debounce                 |
+| `useDebounce`         | Delay function execution to prevent excessive updates (autoInvoke support)  |
 
 ## Development
 
@@ -100,6 +101,7 @@ pnpm exec prettier --write .
 src/
 ├── hooks/                      # Individual hook implementations
 │   ├── useBodyScrollLock/
+│   ├── useDebounce/
 │   ├── useElementPosition/
 │   ├── useElementScroll/
 │   ├── useImage/

package/dist/index.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const n=require("react"),E=(e,{delay:o,autoInvoke:d=!0},t=[])=>{const s=n.useRef(null),c=n.useRef(e),i=n.useRef(t);n.useEffect(()=>{c.current=e}),n.useEffect(()=>{i.current=t});const l=n.useRef(null);l.current||(l.current=((...u)=>{s.current&&clearTimeout(s.current),s.current=setTimeout(()=>{c.current(...u)},o)}));const r=n.useRef(t);return n.useEffect(()=>{const u=!r.current||r.current.length!==t.length||r.current.some((a,w)=>a!==t[w]);u&&s.current&&clearTimeout(s.current),d&&u&&l.current&&l.current(),r.current=t}),n.useEffect(()=>()=>{s.current&&clearTimeout(s.current)},[]),l.current},S=(e=!0)=>{n.useEffect(()=>{if(!e)return;const o=window.scrollY,d=/iPad|iPhone|iPod/.test(navigator.userAgent),t={documentElement:{overflow:document.documentElement.style.overflow,height:document.documentElement.style.height,position:document.documentElement.style.position,width:document.documentElement.style.width},body:{overflow:document.body.style.overflow,height:document.body.style.height,position:document.body.style.position,top:document.body.style.top,left:document.body.style.left,right:document.body.style.right,width:document.body.style.width,webkitOverflowScrolling:document.body.style.getPropertyValue("-webkit-overflow-scrolling")}};if(document.documentElement.style.overflow="hidden",document.documentElement.style.height="100%",document.documentElement.style.position="fixed",document.documentElement.style.width="100%",document.body.style.overflow="hidden",document.body.style.height="100%",document.body.style.position="fixed",document.body.style.top=`-${o}px`,document.body.style.left="0",document.body.style.right="0",document.body.style.width="100%",d){document.body.style.setProperty("-webkit-overflow-scrolling","touch");const s=r=>{(r.target===document.body||r.target===document.documentElement||r.target===window)&&(r.preventDefault(),r.stopPropagation(),r.stopImmediatePropagation())},c=()=>{window.scrollTo(0,0),document.body.scrollTop=0,document.documentElement.scrollTop=0},i=["scroll","touchmove","touchstart","touchend"];i.forEach(r=>{window.addEventListener(r,s,{passive:!1,capture:!0}),document.addEventListener(r,s,{passive:!1,capture:!0}),document.body.addEventListener(r,s,{passive:!1,capture:!0})});const l=setInterval(c,16);return()=>{clearInterval(l),i.forEach(r=>{window.removeEventListener(r,s,{capture:!0}),document.removeEventListener(r,s,{capture:!0}),document.body.removeEventListener(r,s,{capture:!0})}),document.documentElement.style.overflow=t.documentElement.overflow,document.documentElement.style.height=t.documentElement.height,document.documentElement.style.position=t.documentElement.position,document.documentElement.style.width=t.documentElement.width,document.body.style.overflow=t.body.overflow,document.body.style.height=t.body.height,document.body.style.position=t.body.position,document.body.style.top=t.body.top,document.body.style.left=t.body.left,document.body.style.right=t.body.right,document.body.style.width=t.body.width,t.body.webkitOverflowScrolling?document.body.style.setProperty("-webkit-overflow-scrolling",t.body.webkitOverflowScrolling):document.body.style.removeProperty("-webkit-overflow-scrolling"),window.scrollTo(0,o)}}return()=>{document.documentElement.style.overflow=t.documentElement.overflow,document.documentElement.style.height=t.documentElement.height,document.documentElement.style.position=t.documentElement.position,document.documentElement.style.width=t.documentElement.width,document.body.style.overflow=t.body.overflow,document.body.style.height=t.body.height,document.body.style.position=t.body.position,document.body.style.top=t.body.top,document.body.style.left=t.body.left,document.body.style.right=t.body.right,document.body.style.width=t.body.width,window.scrollTo(0,o)}},[e])},L=e=>{const[o,d]=n.useState(null);return n.useEffect(()=>{const t=i=>typeof i=="string"?document.querySelector(i):i.current,s=()=>{const i=t(e);d(i?i.getBoundingClientRect():null)},c=()=>{requestAnimationFrame(s)};return s(),window.addEventListener("scroll",c,{passive:!0}),window.addEventListener("resize",c,{passive:!0}),()=>{window.removeEventListener("scroll",c),window.removeEventListener("resize",c)}},[e]),o},T=()=>{const[e,o]=n.useState(null),[d,t]=n.useState({scrollY:0,scrollPercentage:0,isAtTop:!0,isAtBottom:!1,scrollableHeight:0,clientHeight:0,scrollHeight:0}),s=n.useCallback(c=>{o(c)},[]);return n.useEffect(()=>{if(!e)return;const c=()=>{const{scrollTop:r,scrollHeight:u,clientHeight:a}=e,w=u-a;if(w<=0){t({scrollY:0,scrollPercentage:0,isAtTop:!0,isAtBottom:!0,scrollableHeight:0,clientHeight:a,scrollHeight:u});return}const m=Math.min(100,Math.max(0,r/w*100));t({scrollY:r,scrollPercentage:m,isAtTop:r<=0,isAtBottom:r>=w-1,scrollableHeight:w,clientHeight:a,scrollHeight:u})};c();const i=()=>{c()};e.addEventListener("scroll",i,{passive:!0});const l=new ResizeObserver(()=>{c()});return l.observe(e),()=>{e.removeEventListener("scroll",i),l.unobserve(e)}},[e]),{...d,element:e,setRef:s}},f={sm:640,md:768,lg:1024,xl:1280,"2xl":1536},x=e=>{let o="xs";return e>=f["2xl"]?o="2xl":e>=f.xl?o="xl":e>=f.lg?o="lg":e>=f.md?o="md":e>=f.sm?o="sm":o="xs",{current:o,xs:e<f.sm,sm:e>=f.sm&&e<f.md,md:e>=f.md&&e<f.lg,lg:e>=f.lg&&e<f.xl,xl:e>=f.xl&&e<f["2xl"],"2xl":e>=f["2xl"]}},R=e=>{const{delay:o=100,container:d}=e||{},[t,s]=n.useState({width:0,height:0}),[c,i]=n.useState({current:"xs",xs:!0,sm:!1,md:!1,lg:!1,xl:!1,"2xl":!1}),[l,r]=n.useState({width:0,height:0}),u=n.useRef(null),a=n.useRef(null);return E(()=>{r(t)},{delay:o},[t]),n.useEffect(()=>{const w=()=>{const h=d??u.current??document.body;if(!h)return;const{offsetWidth:y,offsetHeight:v}=h;s(p=>p.width!==y||p.height!==v?{width:y,height:v}:p),i(p=>{const b=x(y);return p.current!==b.current?b:p})},m=()=>{const h=d??u.current??document.body;h&&(w(),a.current&&a.current.disconnect(),a.current=new ResizeObserver(()=>{requestAnimationFrame(()=>{w()})}),a.current.observe(h))},g=()=>{a.current&&(a.current.disconnect(),a.current=null)};return m(),()=>{g()}},[d]),{size:l,breakpoint:c,ref:u}},V=(e,o={})=>{const{retryCount:d=0,retryDelay:t=1e3}=o,[s,c]=n.useState(!0),[i,l]=n.useState(null),[r,u]=n.useState(!1),[a,w]=n.useState(0),m=n.useCallback(()=>{if(!e){c(!1),u(!1);return}c(!0),l(null);const h=new Image;h.src=e,h.onload=()=>{c(!1),u(!0),l(null),w(0)},h.onerror=y=>{c(!1),u(!1),l(y),a<d&&setTimeout(()=>{w(v=>v+1)},t)}},[e,a,d,t]);n.useEffect(()=>{m()},[m]);const g=n.useCallback(()=>{w(0),m()},[m]);return{loading:s,error:i,loaded:r,retry:g}},z=(e,o)=>{const d=n.useRef(o),[t,s]=n.useState(()=>{if(typeof window>"u")return o;try{const i=window.localStorage.getItem(e);return i?JSON.parse(i):o}catch{return o}});n.useEffect(()=>{if(!(typeof window>"u"))try{const i=window.localStorage.getItem(e);i?s(JSON.parse(i)):window.localStorage.setItem(e,JSON.stringify(d.current))}catch(i){console.error(`Error reading localStorage key "${e}":`,i)}},[e]);const c=n.useCallback(i=>{try{s(l=>{const r=i instanceof Function?i(l):i;return localStorage.setItem(e,JSON.stringify(r)),r})}catch(l){console.error(`Error setting localStorage key "${e}":`,l)}},[e]);return[t,c]},P=(e,o)=>{const d=n.useRef(e);n.useEffect(()=>{d.current=e},[e]),n.useEffect(()=>{let t;function s(){const c=d.current();c instanceof Promise?c.then(()=>{o&&(t=setTimeout(s,o))}):o&&(t=setTimeout(s,o))}if(o)return t=setTimeout(s,o),()=>t&&clearTimeout(t)},[o])},H=e=>{const o=n.useRef([]),d=n.useCallback(s=>{if(o.current[s]&&(o.current[s].scrollIntoView({behavior:"smooth",block:"start",inline:"start",...e}),e?.offset)){const c=o.current[s].getBoundingClientRect().top+window.scrollY-e.offset;window.scrollTo({top:c,behavior:e.behavior||"smooth"})}},[e]),t=n.useCallback((s,c)=>{o.current[c]=s},[]);return{elementRefs:o,setElementRef:t,scrollToElement:d}},I=()=>{const[e,o]=n.useState({x:0,y:0,percent:{x:0,y:0}});return n.useEffect(()=>{const d=()=>{const i=window.scrollX||0,l=window.scrollY||0,r=/iPad|iPhone|iPod/.test(navigator.userAgent),u=window.visualViewport,a=r&&u?u.width:window.innerWidth,w=r&&u?u.height:window.innerHeight,m=Math.max(0,document.documentElement.scrollWidth-a),g=Math.max(0,document.documentElement.scrollHeight-w),h=m===0?0:Math.min(100,i/m*100),y=g===0?0:Math.min(100,l/g*100);o({x:i,y:l,percent:{x:Math.floor(Math.max(0,h)),y:Math.floor(Math.max(0,y))}})};d();const t=()=>{d()},s=()=>{setTimeout(d,100)},c=()=>{setTimeout(d,50)};return window.addEventListener("scroll",t,{passive:!0}),window.addEventListener("resize",s),window.addEventListener("orientationchange",s),window.visualViewport&&window.visualViewport.addEventListener("resize",c),()=>{window.removeEventListener("scroll",t),window.removeEventListener("resize",s),window.removeEventListener("orientationchange",s),window.visualViewport&&window.visualViewport.removeEventListener("resize",c)}},[]),e},k=(e={})=>{const{isInApp:o=!1,debounce:d=100}=e,[t,s]=n.useState({width:0,height:0,offsetLeft:0,offsetTop:0,pageLeft:0,pageTop:0,scale:1}),c=n.useCallback(()=>{const l=window.innerHeight,r=window.visualViewport?.height||l,u=document.documentElement.clientHeight,a=document.body.clientHeight;return window.visualViewport&&Math.abs(r-l)>100?r:Math.max(l,u,a)},[]),i=n.useCallback(()=>{if(window.visualViewport&&!o)return window.visualViewport;const l=window.visualViewport?.width||window.innerWidth,r=o?c():window.visualViewport?.height||window.innerHeight;return{width:l,height:r,offsetLeft:window.visualViewport?.offsetLeft||0,offsetTop:window.visualViewport?.offsetTop||0,pageLeft:window.scrollX??window.pageXOffset??0,pageTop:window.scrollY??window.pageYOffset??0,scale:window.visualViewport?.scale||1}},[o,c]);return n.useEffect(()=>{let l;const r=()=>{clearTimeout(l),l=setTimeout(()=>{s(i())},d)},u=()=>s(i());u();const a=["resize","orientationchange"];o&&a.push("focus","blur","touchstart","touchend"),a.forEach(m=>{m==="resize"||m==="orientationchange"?window.addEventListener(m,r):window.addEventListener(m,u,{passive:!0})}),window.visualViewport&&(window.visualViewport.addEventListener("resize",u),window.visualViewport.addEventListener("scroll",u));let w;if(o){let m=i().height;w=setInterval(()=>{const g=i().height;Math.abs(g-m)>50&&(m=g,u())},500)}return()=>{clearTimeout(l),w&&clearInterval(w),a.forEach(m=>{window.removeEventListener(m,m==="resize"||m==="orientationchange"?r:u)}),window.visualViewport&&(window.visualViewport.removeEventListener("resize",u),window.visualViewport.removeEventListener("scroll",u))}},[i,o,d]),t};exports.useBodyScrollLock=S;exports.useDebounce=E;exports.useElementPosition=L;exports.useElementScroll=T;exports.useImage=V;exports.useLocalStorage=z;exports.useRecursiveTimeout=P;exports.useResponsiveSize=R;exports.useScrollToElements=H;exports.useViewport=k;exports.useWindowScroll=I;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const n=require("react"),E=(e,{delay:o=100,autoInvoke:d=!0},t=[])=>{const s=n.useRef(null),c=n.useRef(e),i=n.useRef(t),l=n.useRef(void 0);n.useEffect(()=>{c.current=e}),n.useEffect(()=>{i.current=t});const r=n.useRef(null);return r.current||(r.current=((...u)=>{s.current&&clearTimeout(s.current),s.current=setTimeout(()=>{c.current(...u)},o)})),n.useEffect(()=>{const u=l.current===void 0||l.current.length!==t.length||l.current.some((a,w)=>a!==t[w]);u&&s.current&&clearTimeout(s.current),d&&u&&(l.current===void 0?c.current():r.current&&r.current()),l.current=t}),n.useEffect(()=>()=>{s.current&&clearTimeout(s.current)},[]),r.current},S=(e=!0)=>{n.useEffect(()=>{if(!e)return;const o=window.scrollY,d=/iPad|iPhone|iPod/.test(navigator.userAgent),t={documentElement:{overflow:document.documentElement.style.overflow,height:document.documentElement.style.height,position:document.documentElement.style.position,width:document.documentElement.style.width},body:{overflow:document.body.style.overflow,height:document.body.style.height,position:document.body.style.position,top:document.body.style.top,left:document.body.style.left,right:document.body.style.right,width:document.body.style.width,webkitOverflowScrolling:document.body.style.getPropertyValue("-webkit-overflow-scrolling")}};if(document.documentElement.style.overflow="hidden",document.documentElement.style.height="100%",document.documentElement.style.position="fixed",document.documentElement.style.width="100%",document.body.style.overflow="hidden",document.body.style.height="100%",document.body.style.position="fixed",document.body.style.top=`-${o}px`,document.body.style.left="0",document.body.style.right="0",document.body.style.width="100%",d){document.body.style.setProperty("-webkit-overflow-scrolling","touch");const s=r=>{(r.target===document.body||r.target===document.documentElement||r.target===window)&&(r.preventDefault(),r.stopPropagation(),r.stopImmediatePropagation())},c=()=>{window.scrollTo(0,0),document.body.scrollTop=0,document.documentElement.scrollTop=0},i=["scroll","touchmove","touchstart","touchend"];i.forEach(r=>{window.addEventListener(r,s,{passive:!1,capture:!0}),document.addEventListener(r,s,{passive:!1,capture:!0}),document.body.addEventListener(r,s,{passive:!1,capture:!0})});const l=setInterval(c,16);return()=>{clearInterval(l),i.forEach(r=>{window.removeEventListener(r,s,{capture:!0}),document.removeEventListener(r,s,{capture:!0}),document.body.removeEventListener(r,s,{capture:!0})}),document.documentElement.style.overflow=t.documentElement.overflow,document.documentElement.style.height=t.documentElement.height,document.documentElement.style.position=t.documentElement.position,document.documentElement.style.width=t.documentElement.width,document.body.style.overflow=t.body.overflow,document.body.style.height=t.body.height,document.body.style.position=t.body.position,document.body.style.top=t.body.top,document.body.style.left=t.body.left,document.body.style.right=t.body.right,document.body.style.width=t.body.width,t.body.webkitOverflowScrolling?document.body.style.setProperty("-webkit-overflow-scrolling",t.body.webkitOverflowScrolling):document.body.style.removeProperty("-webkit-overflow-scrolling"),window.scrollTo(0,o)}}return()=>{document.documentElement.style.overflow=t.documentElement.overflow,document.documentElement.style.height=t.documentElement.height,document.documentElement.style.position=t.documentElement.position,document.documentElement.style.width=t.documentElement.width,document.body.style.overflow=t.body.overflow,document.body.style.height=t.body.height,document.body.style.position=t.body.position,document.body.style.top=t.body.top,document.body.style.left=t.body.left,document.body.style.right=t.body.right,document.body.style.width=t.body.width,window.scrollTo(0,o)}},[e])},L=e=>{const[o,d]=n.useState(null);return n.useEffect(()=>{const t=i=>typeof i=="string"?document.querySelector(i):i.current,s=()=>{const i=t(e);d(i?i.getBoundingClientRect():null)},c=()=>{requestAnimationFrame(s)};return s(),window.addEventListener("scroll",c,{passive:!0}),window.addEventListener("resize",c,{passive:!0}),()=>{window.removeEventListener("scroll",c),window.removeEventListener("resize",c)}},[e]),o},T=()=>{const[e,o]=n.useState(null),[d,t]=n.useState({scrollY:0,scrollPercentage:0,isAtTop:!0,isAtBottom:!1,scrollableHeight:0,clientHeight:0,scrollHeight:0}),s=n.useCallback(c=>{o(c)},[]);return n.useEffect(()=>{if(!e)return;const c=()=>{const{scrollTop:r,scrollHeight:u,clientHeight:a}=e,w=u-a;if(w<=0){t({scrollY:0,scrollPercentage:0,isAtTop:!0,isAtBottom:!0,scrollableHeight:0,clientHeight:a,scrollHeight:u});return}const m=Math.min(100,Math.max(0,r/w*100));t({scrollY:r,scrollPercentage:m,isAtTop:r<=0,isAtBottom:r>=w-1,scrollableHeight:w,clientHeight:a,scrollHeight:u})};c();const i=()=>{c()};e.addEventListener("scroll",i,{passive:!0});const l=new ResizeObserver(()=>{c()});return l.observe(e),()=>{e.removeEventListener("scroll",i),l.unobserve(e)}},[e]),{...d,element:e,setRef:s}},f={sm:640,md:768,lg:1024,xl:1280,"2xl":1536},x=e=>{let o="xs";return e>=f["2xl"]?o="2xl":e>=f.xl?o="xl":e>=f.lg?o="lg":e>=f.md?o="md":e>=f.sm?o="sm":o="xs",{current:o,xs:e<f.sm,sm:e>=f.sm&&e<f.md,md:e>=f.md&&e<f.lg,lg:e>=f.lg&&e<f.xl,xl:e>=f.xl&&e<f["2xl"],"2xl":e>=f["2xl"]}},R=e=>{const{delay:o=100,container:d}=e||{},[t,s]=n.useState({width:0,height:0}),[c,i]=n.useState({current:"xs",xs:!0,sm:!1,md:!1,lg:!1,xl:!1,"2xl":!1}),[l,r]=n.useState({width:0,height:0}),u=n.useRef(null),a=n.useRef(null);return E(()=>{r(t)},{delay:o},[t]),n.useEffect(()=>{const w=()=>{const h=d??u.current??document.body;if(!h)return;const{offsetWidth:y,offsetHeight:v}=h;s(p=>p.width!==y||p.height!==v?{width:y,height:v}:p),i(p=>{const b=x(y);return p.current!==b.current?b:p})},m=()=>{const h=d??u.current??document.body;h&&(w(),a.current&&a.current.disconnect(),a.current=new ResizeObserver(()=>{requestAnimationFrame(()=>{w()})}),a.current.observe(h))},g=()=>{a.current&&(a.current.disconnect(),a.current=null)};return m(),()=>{g()}},[d]),{size:l,breakpoint:c,ref:u}},V=(e,o={})=>{const{retryCount:d=0,retryDelay:t=1e3}=o,[s,c]=n.useState(!0),[i,l]=n.useState(null),[r,u]=n.useState(!1),[a,w]=n.useState(0),m=n.useCallback(()=>{if(!e){c(!1),u(!1);return}c(!0),l(null);const h=new Image;h.src=e,h.onload=()=>{c(!1),u(!0),l(null),w(0)},h.onerror=y=>{c(!1),u(!1),l(y),a<d&&setTimeout(()=>{w(v=>v+1)},t)}},[e,a,d,t]);n.useEffect(()=>{m()},[m]);const g=n.useCallback(()=>{w(0),m()},[m]);return{loading:s,error:i,loaded:r,retry:g}},z=(e,o)=>{const d=n.useRef(o),[t,s]=n.useState(()=>{if(typeof window>"u")return o;try{const i=window.localStorage.getItem(e);return i?JSON.parse(i):o}catch{return o}});n.useEffect(()=>{if(!(typeof window>"u"))try{const i=window.localStorage.getItem(e);i?s(JSON.parse(i)):window.localStorage.setItem(e,JSON.stringify(d.current))}catch(i){console.error(`Error reading localStorage key "${e}":`,i)}},[e]);const c=n.useCallback(i=>{try{s(l=>{const r=i instanceof Function?i(l):i;return localStorage.setItem(e,JSON.stringify(r)),r})}catch(l){console.error(`Error setting localStorage key "${e}":`,l)}},[e]);return[t,c]},P=(e,o)=>{const d=n.useRef(e);n.useEffect(()=>{d.current=e},[e]),n.useEffect(()=>{let t;function s(){const c=d.current();c instanceof Promise?c.then(()=>{o&&(t=setTimeout(s,o))}):o&&(t=setTimeout(s,o))}if(o)return t=setTimeout(s,o),()=>t&&clearTimeout(t)},[o])},H=e=>{const o=n.useRef([]),d=n.useCallback(s=>{if(o.current[s]&&(o.current[s].scrollIntoView({behavior:"smooth",block:"start",inline:"start",...e}),e?.offset)){const c=o.current[s].getBoundingClientRect().top+window.scrollY-e.offset;window.scrollTo({top:c,behavior:e.behavior||"smooth"})}},[e]),t=n.useCallback((s,c)=>{o.current[c]=s},[]);return{elementRefs:o,setElementRef:t,scrollToElement:d}},I=()=>{const[e,o]=n.useState({x:0,y:0,percent:{x:0,y:0}});return n.useEffect(()=>{const d=()=>{const i=window.scrollX||0,l=window.scrollY||0,r=/iPad|iPhone|iPod/.test(navigator.userAgent),u=window.visualViewport,a=r&&u?u.width:window.innerWidth,w=r&&u?u.height:window.innerHeight,m=Math.max(0,document.documentElement.scrollWidth-a),g=Math.max(0,document.documentElement.scrollHeight-w),h=m===0?0:Math.min(100,i/m*100),y=g===0?0:Math.min(100,l/g*100);o({x:i,y:l,percent:{x:Math.floor(Math.max(0,h)),y:Math.floor(Math.max(0,y))}})};d();const t=()=>{d()},s=()=>{setTimeout(d,100)},c=()=>{setTimeout(d,50)};return window.addEventListener("scroll",t,{passive:!0}),window.addEventListener("resize",s),window.addEventListener("orientationchange",s),window.visualViewport&&window.visualViewport.addEventListener("resize",c),()=>{window.removeEventListener("scroll",t),window.removeEventListener("resize",s),window.removeEventListener("orientationchange",s),window.visualViewport&&window.visualViewport.removeEventListener("resize",c)}},[]),e},k=(e={})=>{const{isInApp:o=!1,debounce:d=100}=e,[t,s]=n.useState({width:0,height:0,offsetLeft:0,offsetTop:0,pageLeft:0,pageTop:0,scale:1}),c=n.useCallback(()=>{const l=window.innerHeight,r=window.visualViewport?.height||l,u=document.documentElement.clientHeight,a=document.body.clientHeight;return window.visualViewport&&Math.abs(r-l)>100?r:Math.max(l,u,a)},[]),i=n.useCallback(()=>{if(window.visualViewport&&!o)return window.visualViewport;const l=window.visualViewport?.width||window.innerWidth,r=o?c():window.visualViewport?.height||window.innerHeight;return{width:l,height:r,offsetLeft:window.visualViewport?.offsetLeft||0,offsetTop:window.visualViewport?.offsetTop||0,pageLeft:window.scrollX??window.pageXOffset??0,pageTop:window.scrollY??window.pageYOffset??0,scale:window.visualViewport?.scale||1}},[o,c]);return n.useEffect(()=>{let l;const r=()=>{clearTimeout(l),l=setTimeout(()=>{s(i())},d)},u=()=>s(i());u();const a=["resize","orientationchange"];o&&a.push("focus","blur","touchstart","touchend"),a.forEach(m=>{m==="resize"||m==="orientationchange"?window.addEventListener(m,r):window.addEventListener(m,u,{passive:!0})}),window.visualViewport&&(window.visualViewport.addEventListener("resize",u),window.visualViewport.addEventListener("scroll",u));let w;if(o){let m=i().height;w=setInterval(()=>{const g=i().height;Math.abs(g-m)>50&&(m=g,u())},500)}return()=>{clearTimeout(l),w&&clearInterval(w),a.forEach(m=>{window.removeEventListener(m,m==="resize"||m==="orientationchange"?r:u)}),window.visualViewport&&(window.visualViewport.removeEventListener("resize",u),window.visualViewport.removeEventListener("scroll",u))}},[i,o,d]),t};exports.useBodyScrollLock=S;exports.useDebounce=E;exports.useElementPosition=L;exports.useElementScroll=T;exports.useImage=V;exports.useLocalStorage=z;exports.useRecursiveTimeout=P;exports.useResponsiveSize=R;exports.useScrollToElements=H;exports.useViewport=k;exports.useWindowScroll=I;

package/dist/index.d.ts

@@ -15,7 +15,7 @@ declare interface BreakpointInfo {
 declare type ElementReference<T> = string | RefObject<T>;
 
 declare interface Options {
-    delay: number;
+    delay?: number;
     autoInvoke?: boolean;
 }
 

package/dist/index.js

@@ -1,29 +1,27 @@
 import { useRef as y, useEffect as f, useState as h, useCallback as v } from "react";
-const x = (e, { delay: o, autoInvoke: u = !0 }, t = []) => {
-  const n = y(null), i = y(e), s = y(t);
+const x = (e, { delay: o = 100, autoInvoke: d = !0 }, t = []) => {
+  const n = y(null), i = y(e), s = y(t), c = y(void 0);
   f(() => {
     i.current = e;
   }), f(() => {
     s.current = t;
   });
-  const l = y(null);
-  l.current || (l.current = ((...c) => {
+  const r = y(null);
+  return r.current || (r.current = ((...l) => {
     n.current && clearTimeout(n.current), n.current = setTimeout(() => {
-      i.current(...c);
+      i.current(...l);
     }, o);
-  }));
-  const r = y(t);
-  return f(() => {
-    const c = !r.current || r.current.length !== t.length || r.current.some((d, a) => d !== t[a]);
-    c && n.current && clearTimeout(n.current), u && c && l.current && l.current(), r.current = t;
+  })), f(() => {
+    const l = c.current === void 0 || c.current.length !== t.length || c.current.some((u, a) => u !== t[a]);
+    l && n.current && clearTimeout(n.current), d && l && (c.current === void 0 ? i.current() : r.current && r.current()), c.current = t;
   }), f(() => () => {
     n.current && clearTimeout(n.current);
-  }, []), l.current;
+  }, []), r.current;
 }, z = (e = !0) => {
   f(() => {
     if (!e)
       return;
-    const o = window.scrollY, u = /iPad|iPhone|iPod/.test(navigator.userAgent), t = {
+    const o = window.scrollY, d = /iPad|iPhone|iPod/.test(navigator.userAgent), t = {
       documentElement: {
         overflow: document.documentElement.style.overflow,
         height: document.documentElement.style.height,
@@ -43,7 +41,7 @@ const x = (e, { delay: o, autoInvoke: u = !0 }, t = []) => {
         )
       }
     };
-    if (document.documentElement.style.overflow = "hidden", document.documentElement.style.height = "100%", document.documentElement.style.position = "fixed", document.documentElement.style.width = "100%", document.body.style.overflow = "hidden", document.body.style.height = "100%", document.body.style.position = "fixed", document.body.style.top = `-${o}px`, document.body.style.left = "0", document.body.style.right = "0", document.body.style.width = "100%", u) {
+    if (document.documentElement.style.overflow = "hidden", document.documentElement.style.height = "100%", document.documentElement.style.position = "fixed", document.documentElement.style.width = "100%", document.body.style.overflow = "hidden", document.body.style.height = "100%", document.body.style.position = "fixed", document.body.style.top = `-${o}px`, document.body.style.left = "0", document.body.style.right = "0", document.body.style.width = "100%", d) {
       document.body.style.setProperty("-webkit-overflow-scrolling", "touch");
       const n = (r) => {
         (r.target === document.body || r.target === document.documentElement || r.target === window) && (r.preventDefault(), r.stopPropagation(), r.stopImmediatePropagation());
@@ -62,9 +60,9 @@ const x = (e, { delay: o, autoInvoke: u = !0 }, t = []) => {
           capture: !0
         });
       });
-      const l = setInterval(i, 16);
+      const c = setInterval(i, 16);
       return () => {
-        clearInterval(l), s.forEach((r) => {
+        clearInterval(c), s.forEach((r) => {
           window.removeEventListener(r, n, { capture: !0 }), document.removeEventListener(r, n, { capture: !0 }), document.body.removeEventListener(r, n, {
             capture: !0
           });
@@ -79,11 +77,11 @@ const x = (e, { delay: o, autoInvoke: u = !0 }, t = []) => {
     };
   }, [e]);
 }, H = (e) => {
-  const [o, u] = h(null);
+  const [o, d] = h(null);
   return f(() => {
     const t = (s) => typeof s == "string" ? document.querySelector(s) : s.current, n = () => {
       const s = t(e);
-      u(s ? s.getBoundingClientRect() : null);
+      d(s ? s.getBoundingClientRect() : null);
     }, i = () => {
       requestAnimationFrame(n);
     };
@@ -92,7 +90,7 @@ const x = (e, { delay: o, autoInvoke: u = !0 }, t = []) => {
     };
   }, [e]), o;
 }, I = () => {
-  const [e, o] = h(null), [u, t] = h({
+  const [e, o] = h(null), [d, t] = h({
     scrollY: 0,
     scrollPercentage: 0,
     isAtTop: !0,
@@ -107,7 +105,7 @@ const x = (e, { delay: o, autoInvoke: u = !0 }, t = []) => {
     if (!e)
       return;
     const i = () => {
-      const { scrollTop: r, scrollHeight: c, clientHeight: d } = e, a = c - d;
+      const { scrollTop: r, scrollHeight: l, clientHeight: u } = e, a = l - u;
       if (a <= 0) {
         t({
           scrollY: 0,
@@ -115,8 +113,8 @@ const x = (e, { delay: o, autoInvoke: u = !0 }, t = []) => {
           isAtTop: !0,
           isAtBottom: !0,
           scrollableHeight: 0,
-          clientHeight: d,
-          scrollHeight: c
+          clientHeight: u,
+          scrollHeight: l
         });
         return;
       }
@@ -130,8 +128,8 @@ const x = (e, { delay: o, autoInvoke: u = !0 }, t = []) => {
         isAtTop: r <= 0,
         isAtBottom: r >= a - 1,
         scrollableHeight: a,
-        clientHeight: d,
-        scrollHeight: c
+        clientHeight: u,
+        scrollHeight: l
       });
     };
     i();
@@ -139,13 +137,13 @@ const x = (e, { delay: o, autoInvoke: u = !0 }, t = []) => {
       i();
     };
     e.addEventListener("scroll", s, { passive: !0 });
-    const l = new ResizeObserver(() => {
+    const c = new ResizeObserver(() => {
       i();
     });
-    return l.observe(e), () => {
-      e.removeEventListener("scroll", s), l.unobserve(e);
+    return c.observe(e), () => {
+      e.removeEventListener("scroll", s), c.unobserve(e);
     };
-  }, [e]), { ...u, element: e, setRef: n };
+  }, [e]), { ...d, element: e, setRef: n };
 }, w = {
   // < 640px
   sm: 640,
@@ -170,7 +168,7 @@ const x = (e, { delay: o, autoInvoke: u = !0 }, t = []) => {
     "2xl": e >= w["2xl"]
   };
 }, P = (e) => {
-  const { delay: o = 100, container: u } = e || {}, [t, n] = h({ width: 0, height: 0 }), [i, s] = h({
+  const { delay: o = 100, container: d } = e || {}, [t, n] = h({ width: 0, height: 0 }), [i, s] = h({
     current: "xs",
     xs: !0,
     sm: !1,
@@ -178,7 +176,7 @@ const x = (e, { delay: o, autoInvoke: u = !0 }, t = []) => {
     lg: !1,
     xl: !1,
     "2xl": !1
-  }), [l, r] = h({ width: 0, height: 0 }), c = y(null), d = y(null);
+  }), [c, r] = h({ width: 0, height: 0 }), l = y(null), u = y(null);
   return x(
     () => {
       r(t);
@@ -187,7 +185,7 @@ const x = (e, { delay: o, autoInvoke: u = !0 }, t = []) => {
     [t]
   ), f(() => {
     const a = () => {
-      const g = u ?? c.current ?? document.body;
+      const g = d ?? l.current ?? document.body;
       if (!g)
         return;
       const { offsetWidth: b, offsetHeight: S } = g;
@@ -196,39 +194,39 @@ const x = (e, { delay: o, autoInvoke: u = !0 }, t = []) => {
         return E.current !== L.current ? L : E;
       });
     }, m = () => {
-      const g = u ?? c.current ?? document.body;
-      g && (a(), d.current && d.current.disconnect(), d.current = new ResizeObserver(() => {
+      const g = d ?? l.current ?? document.body;
+      g && (a(), u.current && u.current.disconnect(), u.current = new ResizeObserver(() => {
         requestAnimationFrame(() => {
           a();
         });
-      }), d.current.observe(g));
+      }), u.current.observe(g));
     }, p = () => {
-      d.current && (d.current.disconnect(), d.current = null);
+      u.current && (u.current.disconnect(), u.current = null);
     };
     return m(), () => {
       p();
     };
-  }, [u]), {
-    size: l,
+  }, [d]), {
+    size: c,
     breakpoint: i,
-    ref: c
+    ref: l
   };
 }, R = (e, o = {}) => {
-  const { retryCount: u = 0, retryDelay: t = 1e3 } = o, [n, i] = h(!0), [s, l] = h(null), [r, c] = h(!1), [d, a] = h(0), m = v(() => {
+  const { retryCount: d = 0, retryDelay: t = 1e3 } = o, [n, i] = h(!0), [s, c] = h(null), [r, l] = h(!1), [u, a] = h(0), m = v(() => {
     if (!e) {
-      i(!1), c(!1);
+      i(!1), l(!1);
       return;
     }
-    i(!0), l(null);
+    i(!0), c(null);
     const g = new Image();
     g.src = e, g.onload = () => {
-      i(!1), c(!0), l(null), a(0);
+      i(!1), l(!0), c(null), a(0);
     }, g.onerror = (b) => {
-      i(!1), c(!1), l(b), d < u && setTimeout(() => {
+      i(!1), l(!1), c(b), u < d && setTimeout(() => {
         a((S) => S + 1);
       }, t);
     };
-  }, [e, d, u, t]);
+  }, [e, u, d, t]);
   f(() => {
     m();
   }, [m]);
@@ -242,7 +240,7 @@ const x = (e, { delay: o, autoInvoke: u = !0 }, t = []) => {
     retry: p
   };
 }, A = (e, o) => {
-  const u = y(o), [t, n] = h(() => {
+  const d = y(o), [t, n] = h(() => {
     if (typeof window > "u")
       return o;
     try {
@@ -256,7 +254,7 @@ const x = (e, { delay: o, autoInvoke: u = !0 }, t = []) => {
     if (!(typeof window > "u"))
       try {
         const s = window.localStorage.getItem(e);
-        s ? n(JSON.parse(s)) : window.localStorage.setItem(e, JSON.stringify(u.current));
+        s ? n(JSON.parse(s)) : window.localStorage.setItem(e, JSON.stringify(d.current));
       } catch (s) {
         console.error(`Error reading localStorage key "${e}":`, s);
       }
@@ -264,25 +262,25 @@ const x = (e, { delay: o, autoInvoke: u = !0 }, t = []) => {
   const i = v(
     (s) => {
       try {
-        n((l) => {
-          const r = s instanceof Function ? s(l) : s;
+        n((c) => {
+          const r = s instanceof Function ? s(c) : s;
           return localStorage.setItem(e, JSON.stringify(r)), r;
         });
-      } catch (l) {
-        console.error(`Error setting localStorage key "${e}":`, l);
+      } catch (c) {
+        console.error(`Error setting localStorage key "${e}":`, c);
       }
     },
     [e]
   );
   return [t, i];
 }, O = (e, o) => {
-  const u = y(e);
+  const d = y(e);
   f(() => {
-    u.current = e;
+    d.current = e;
   }, [e]), f(() => {
     let t;
     function n() {
-      const i = u.current();
+      const i = d.current();
       i instanceof Promise ? i.then(() => {
         o && (t = setTimeout(n, o));
       }) : o && (t = setTimeout(n, o));
@@ -291,7 +289,7 @@ const x = (e, { delay: o, autoInvoke: u = !0 }, t = []) => {
       return t = setTimeout(n, o), () => t && clearTimeout(t);
   }, [o]);
 }, M = (e) => {
-  const o = y([]), u = v(
+  const o = y([]), d = v(
     (n) => {
       if (o.current[n] && (o.current[n].scrollIntoView({
         behavior: "smooth",
@@ -310,7 +308,7 @@ const x = (e, { delay: o, autoInvoke: u = !0 }, t = []) => {
   ), t = v((n, i) => {
     o.current[i] = n;
   }, []);
-  return { elementRefs: o, setElementRef: t, scrollToElement: u };
+  return { elementRefs: o, setElementRef: t, scrollToElement: d };
 }, Y = () => {
   const [e, o] = h({
     x: 0,
@@ -321,30 +319,30 @@ const x = (e, { delay: o, autoInvoke: u = !0 }, t = []) => {
     }
   });
   return f(() => {
-    const u = () => {
-      const s = window.scrollX || 0, l = window.scrollY || 0, r = /iPad|iPhone|iPod/.test(navigator.userAgent), c = window.visualViewport, d = r && c ? c.width : window.innerWidth, a = r && c ? c.height : window.innerHeight, m = Math.max(
+    const d = () => {
+      const s = window.scrollX || 0, c = window.scrollY || 0, r = /iPad|iPhone|iPod/.test(navigator.userAgent), l = window.visualViewport, u = r && l ? l.width : window.innerWidth, a = r && l ? l.height : window.innerHeight, m = Math.max(
         0,
-        document.documentElement.scrollWidth - d
+        document.documentElement.scrollWidth - u
       ), p = Math.max(
         0,
         document.documentElement.scrollHeight - a
-      ), g = m === 0 ? 0 : Math.min(100, s / m * 100), b = p === 0 ? 0 : Math.min(100, l / p * 100);
+      ), g = m === 0 ? 0 : Math.min(100, s / m * 100), b = p === 0 ? 0 : Math.min(100, c / p * 100);
       o({
         x: s,
-        y: l,
+        y: c,
         percent: {
           x: Math.floor(Math.max(0, g)),
           y: Math.floor(Math.max(0, b))
         }
       });
     };
-    u();
+    d();
     const t = () => {
-      u();
+      d();
     }, n = () => {
-      setTimeout(u, 100);
+      setTimeout(d, 100);
     }, i = () => {
-      setTimeout(u, 50);
+      setTimeout(d, 50);
     };
     return window.addEventListener("scroll", t, { passive: !0 }), window.addEventListener("resize", n), window.addEventListener("orientationchange", n), window.visualViewport && window.visualViewport.addEventListener("resize", i), () => {
       window.removeEventListener("scroll", t), window.removeEventListener("resize", n), window.removeEventListener("orientationchange", n), window.visualViewport && window.visualViewport.removeEventListener(
@@ -354,7 +352,7 @@ const x = (e, { delay: o, autoInvoke: u = !0 }, t = []) => {
     };
   }, []), e;
 }, C = (e = {}) => {
-  const { isInApp: o = !1, debounce: u = 100 } = e, [t, n] = h({
+  const { isInApp: o = !1, debounce: d = 100 } = e, [t, n] = h({
     width: 0,
     height: 0,
     offsetLeft: 0,
@@ -363,14 +361,14 @@ const x = (e, { delay: o, autoInvoke: u = !0 }, t = []) => {
     pageTop: 0,
     scale: 1
   }), i = v(() => {
-    const l = window.innerHeight, r = window.visualViewport?.height || l, c = document.documentElement.clientHeight, d = document.body.clientHeight;
-    return window.visualViewport && Math.abs(r - l) > 100 ? r : Math.max(l, c, d);
+    const c = window.innerHeight, r = window.visualViewport?.height || c, l = document.documentElement.clientHeight, u = document.body.clientHeight;
+    return window.visualViewport && Math.abs(r - c) > 100 ? r : Math.max(c, l, u);
   }, []), s = v(() => {
     if (window.visualViewport && !o)
       return window.visualViewport;
-    const l = window.visualViewport?.width || window.innerWidth, r = o ? i() : window.visualViewport?.height || window.innerHeight;
+    const c = window.visualViewport?.width || window.innerWidth, r = o ? i() : window.visualViewport?.height || window.innerHeight;
     return {
-      width: l,
+      width: c,
       height: r,
       offsetLeft: window.visualViewport?.offsetLeft || 0,
       offsetTop: window.visualViewport?.offsetTop || 0,
@@ -380,34 +378,34 @@ const x = (e, { delay: o, autoInvoke: u = !0 }, t = []) => {
     };
   }, [o, i]);
   return f(() => {
-    let l;
+    let c;
     const r = () => {
-      clearTimeout(l), l = setTimeout(() => {
+      clearTimeout(c), c = setTimeout(() => {
         n(s());
-      }, u);
-    }, c = () => n(s());
-    c();
-    const d = ["resize", "orientationchange"];
-    o && d.push("focus", "blur", "touchstart", "touchend"), d.forEach((m) => {
-      m === "resize" || m === "orientationchange" ? window.addEventListener(m, r) : window.addEventListener(m, c, { passive: !0 });
-    }), window.visualViewport && (window.visualViewport.addEventListener("resize", c), window.visualViewport.addEventListener("scroll", c));
+      }, d);
+    }, l = () => n(s());
+    l();
+    const u = ["resize", "orientationchange"];
+    o && u.push("focus", "blur", "touchstart", "touchend"), u.forEach((m) => {
+      m === "resize" || m === "orientationchange" ? window.addEventListener(m, r) : window.addEventListener(m, l, { passive: !0 });
+    }), window.visualViewport && (window.visualViewport.addEventListener("resize", l), window.visualViewport.addEventListener("scroll", l));
     let a;
     if (o) {
       let m = s().height;
       a = setInterval(() => {
         const p = s().height;
-        Math.abs(p - m) > 50 && (m = p, c());
+        Math.abs(p - m) > 50 && (m = p, l());
       }, 500);
     }
     return () => {
-      clearTimeout(l), a && clearInterval(a), d.forEach((m) => {
+      clearTimeout(c), a && clearInterval(a), u.forEach((m) => {
         window.removeEventListener(
           m,
-          m === "resize" || m === "orientationchange" ? r : c
+          m === "resize" || m === "orientationchange" ? r : l
         );
-      }), window.visualViewport && (window.visualViewport.removeEventListener("resize", c), window.visualViewport.removeEventListener("scroll", c));
+      }), window.visualViewport && (window.visualViewport.removeEventListener("resize", l), window.visualViewport.removeEventListener("scroll", l));
     };
-  }, [s, o, u]), t;
+  }, [s, o, d]), t;
 };
 export {
   z as useBodyScrollLock,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jbpark/use-hooks",
-  "version": "1.1.3",
+  "version": "2.0.1",
   "description": "A collection of reusable React 19 hooks for common UI and interaction patterns",
   "keywords": [
     "react",