@siberiacancode/reactuse 0.2.31 → 0.2.32

package/dist/cjs/hooks/useControllableState/useControllableState.cjs

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const o=require("react");function C(u){const{value:r,initialValue:c,onChange:a}=u,e=r!==void 0,[i,f]=o.useState(c),l=o.useRef(a);l.current=a;const t=e?r:i,S=o.useCallback(n=>{const s=typeof n=="function"?n(t):n;e||f(s),l.current?.(s)},[t,e]);return[t,S,e]}exports.useControllableState=C;
+//# sourceMappingURL=useControllableState.cjs.map

package/dist/cjs/hooks/useControllableState/useControllableState.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"useControllableState.cjs","sources":["../../../../src/hooks/useControllableState/useControllableState.ts"],"sourcesContent":["import { useCallback, useRef, useState } from 'react';\n\n/** The use controllable state options type */\nexport interface UseControllableStateOptions<Value> {\n  /** The initial value for uncontrolled state */\n  initialValue?: Value;\n  /** The controlled value */\n  value?: Value;\n  /** The onChange callback */\n  onChange?: (value: Value) => void;\n}\n\n/** The use controllable state return type */\nexport type UseControllableStateReturn<Value> = [\n  /** Current value */\n  value: Value,\n  /** Setter function that works with both controlled and uncontrolled state */\n  setValue: (nextValue: ((prevValue: Value) => Value) | Value) => void,\n  /** Whether the state is controlled */\n  isControlled: boolean\n];\n\n/**\n * @name useControllableState\n * @description - Hook that manages both controlled and uncontrolled state patterns\n * @category State\n * @usage medium\n *\n * @template Value The type of the state value\n * @param {Value} [options.value] The controlled value. When provided, the component becomes controlled\n * @param {Value} [options.initialValue] The initial value for uncontrolled state\n * @param {(value: Value) => void} [options.onChange] The callback function called when the state changes\n * @returns {UseControllableStateReturn<Value>} A tuple containing the current value, setter function, and controlled flag\n *\n * @example\n * const [value, setValue, isControlled] = useControllableState({ initialValue: 'initial' });\n */\nexport function useControllableState<Value>(\n  options: UseControllableStateOptions<Value>\n): UseControllableStateReturn<Value> {\n  const { value, initialValue, onChange } = options;\n  const isControlled = value !== undefined;\n\n  const [internalState, setInternalState] = useState<Value>(initialValue as Value);\n\n  const onChangeRef = useRef(onChange);\n  onChangeRef.current = onChange;\n\n  const currentValue = isControlled ? value : internalState;\n\n  const setValue = useCallback(\n    (nextValue: ((prevValue: Value) => Value) | Value) => {\n      const resolvedValue =\n        typeof nextValue === 'function'\n          ? (nextValue as (prevValue: Value) => Value)(currentValue)\n          : nextValue;\n\n      if (!isControlled) setInternalState(resolvedValue);\n\n      onChangeRef.current?.(resolvedValue);\n    },\n    [currentValue, isControlled]\n  );\n\n  return [currentValue, setValue, isControlled];\n}\n"],"names":["useControllableState","options","value","initialValue","onChange","isControlled","internalState","setInternalState","useState","onChangeRef","useRef","currentValue","setValue","useCallback","nextValue","resolvedValue"],"mappings":"yGAqCO,SAASA,EACdC,EACmC,CACnC,KAAM,CAAE,MAAAC,EAAO,aAAAC,EAAc,SAAAC,CAAA,EAAaH,EACpCI,EAAeH,IAAU,OAEzB,CAACI,EAAeC,CAAgB,EAAIC,EAAAA,SAAgBL,CAAqB,EAEzEM,EAAcC,EAAAA,OAAON,CAAQ,EACnCK,EAAY,QAAUL,EAEtB,MAAMO,EAAeN,EAAeH,EAAQI,EAEtCM,EAAWC,EAAAA,YACdC,GAAqD,CACpD,MAAMC,EACJ,OAAOD,GAAc,WAChBA,EAA0CH,CAAY,EACvDG,EAEDT,GAAcE,EAAiBQ,CAAa,EAEjDN,EAAY,UAAUM,CAAa,CAAA,EAErC,CAACJ,EAAcN,CAAY,CAAA,EAG7B,MAAO,CAACM,EAAcC,EAAUP,CAAY,CAC9C"}

package/dist/cjs/hooks/useScroll/useScroll.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const f=require("react"),H=require("../useRefState/useRefState.cjs"),j=require("../../utils/helpers/isTarget.cjs"),O=require("../../utils/helpers/getElement.cjs"),w=1,P=(...t)=>{const r=j.isTarget(t[0])?t[0]:void 0,d=r?typeof t[1]=="object"?t[1]:{onScroll:t[1]}:typeof t[0]=="object"?t[0]:{onScroll:t[0]},s=H.useRefState(),g=f.useRef(d);g.current=d;const[S,E]=f.useState(!1),l=f.useRef({x:0,y:0});return f.useEffect(()=>{if(!r&&!s.state)return;const i=(r?O.getElement(r):s.current)??window,R=n=>{E(!1),d?.onStop?.(n)},a=n=>{E(!0);const e=n.target===document?n.target.documentElement:n.target,{display:m,flexDirection:y,direction:q}=e.style,v=q==="rtl"?-1:1,c=e.scrollLeft;let o=e.scrollTop;e instanceof Document&&!o&&(o=window.document.body.scrollTop);const u=g.current?.offset,b=c*v<=(u?.left??0),p=c*v+e.clientWidth>=e.scrollWidth-(u?.right??0)-w,T=o<=(u?.top??0),h=o+e.clientHeight>=e.scrollHeight-(u?.bottom??0)-w,x=m==="flex"&&y==="column-reverse",L=m==="flex"&&y==="column-reverse",D={x:c,y:o,directions:{left:c<l.current.x,right:c>l.current.x,top:o<l.current.y,bottom:o>l.current.y},arrived:{left:L?p:b,right:L?b:p,top:x?h:T,bottom:x?T:h}};l.current={x:c,y:o},g.current?.onScroll?.(D,n)};return i.addEventListener("scroll",a),i.addEventListener("scrollend",R),()=>{i.removeEventListener("scroll",a),i.removeEventListener("scrollend",R)}},[r,s.state]),r?S:{ref:s,scrolling:S}};exports.useScroll=P;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const d=require("react"),O=require("../useRefState/useRefState.cjs"),P=require("../../utils/helpers/isTarget.cjs"),V=require("../../utils/helpers/getElement.cjs"),H=1,_=(...o)=>{const c=P.isTarget(o[0])?o[0]:void 0,R=c?typeof o[1]=="object"?o[1]:{onScroll:o[1]}:typeof o[0]=="object"?o[0]:{onScroll:o[0]},g=O.useRefState(),a=d.useRef(R),u=d.useRef(null);a.current=R;const[m,y]=d.useState(!1),f=d.useRef({x:0,y:0});d.useEffect(()=>{if(!c&&!g.state)return;const e=(c?V.getElement(c):g.current)??window;u.current=e;const l=t=>{y(!1),R?.onStop?.(t)},s=t=>{y(!0);const r=t.target===document?t.target.documentElement:t.target,{display:v,flexDirection:T,direction:I}=r.style,h=I==="rtl"?-1:1,i=r.scrollLeft;let n=r.scrollTop;r instanceof Document&&!n&&(n=window.document.body.scrollTop);const S=a.current?.offset,p=i*h<=(S?.left??0),x=i*h+r.clientWidth>=r.scrollWidth-(S?.right??0)-H,L=n<=(S?.top??0),w=n+r.clientHeight>=r.scrollHeight-(S?.bottom??0)-H,q=v==="flex"&&T==="column-reverse",D=v==="flex"&&T==="column-reverse",j={x:i,y:n,directions:{left:i<f.current.x,right:i>f.current.x,top:n<f.current.y,bottom:n>f.current.y},arrived:{left:D?x:p,right:D?p:x,top:q?w:L,bottom:q?L:w}};f.current={x:i,y:n},a.current?.onScroll?.(j,t)};return e.addEventListener("scroll",s),e.addEventListener("scrollend",l),()=>{e.removeEventListener("scroll",s),e.removeEventListener("scrollend",l)}},[c,g.state]);const E=e=>{if(!u.current)return;const{behavior:l,block:s,inline:t}=e??{};u.current.scrollIntoView({behavior:l,block:s,inline:t})},b=e=>{if(!u.current)return;const{x:l,y:s,behavior:t}=e??{};u.current.scrollTo({left:l,top:s,behavior:t})};return c?{scrollIntoView:E,scrollTo:b,scrolling:m}:{ref:g,scrolling:m,scrollIntoView:E,scrollTo:b}};exports.useScroll=_;
 //# sourceMappingURL=useScroll.cjs.map

package/dist/cjs/hooks/useScroll/useScroll.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"useScroll.cjs","sources":["../../../../src/hooks/useScroll/useScroll.ts"],"sourcesContent":["import { useEffect, useRef, useState } from 'react';\n\nimport type { HookTarget } from '@/utils/helpers';\n\nimport { getElement, isTarget } from '@/utils/helpers';\n\nimport type { StateRef } from '../useRefState/useRefState';\n\nimport { useRefState } from '../useRefState/useRefState';\n\nconst ARRIVED_STATE_THRESHOLD_PIXELS = 1;\n\nexport interface UseScrollOptions {\n  /** The on scroll callback */\n  onScroll?: (params: UseScrollCallbackParams, event: Event) => void;\n\n  /** The on end scroll callback */\n  onStop?: (event: Event) => void;\n\n  /** Offset arrived states by x pixels. */\n  offset?: {\n    left?: number;\n    right?: number;\n    top?: number;\n    bottom?: number;\n  };\n}\n\nexport interface UseScrollCallbackParams {\n  /** The element x position */\n  x: number;\n  /** The element y position */\n  y: number;\n  /** State of scroll arrived */\n  arrived: {\n    left: boolean;\n    right: boolean;\n    top: boolean;\n    bottom: boolean;\n  };\n  /** State of scroll direction */\n  directions: {\n    left: boolean;\n    right: boolean;\n    top: boolean;\n    bottom: boolean;\n  };\n}\n\nexport interface UseScroll {\n  (\n    target?: HookTarget,\n    callback?: (params: UseScrollCallbackParams, event: Event) => void\n  ): boolean;\n\n  (target?: HookTarget, options?: UseScrollOptions): boolean;\n\n  <Target extends Element>(\n    callback?: (params: UseScrollCallbackParams, event: Event) => void,\n    target?: never\n  ): {\n    ref: StateRef<Target>;\n    scrolling: boolean;\n  };\n\n  <Target extends Element>(\n    options?: UseScrollOptions,\n    target?: never\n  ): {\n    ref: StateRef<Target>;\n    scrolling: boolean;\n  };\n}\n\n/**\n * @name useScroll\n * @description - Hook that allows you to control scroll a element\n * @category Sensors\n * @usage low\n *\n * @overload\n * @template Target The target element\n * @param {ScrollBehavior} [options.behavior=auto] The behavior of scrolling\n * @param {number} [options.offset.left=0] The left offset for arrived states\n * @param {number} [options.offset.right=0]  The right offset for arrived states\n * @param {number} [options.offset.top=0] The top offset for arrived states\n * @param {number} [options.offset.bottom=0] The bottom offset for arrived states\n * @param {(params: UseScrollCallbackParams, event: Event) => void} [options.onScroll] The callback function to be invoked on scroll\n * @param {(event: Event) => void} [options.onStop] The callback function to be invoked on scroll end\n * @returns {boolean} The state of scrolling\n *\n * @example\n * const scrolling = useScroll(ref, options);\n *\n * @overload\n * @template Target The target element\n * @param {(params: UseScrollCallbackParams, event: Event) => void} [callback] The callback function to be invoked on scroll\n * @returns {boolean} The state of scrolling\n *\n * @example\n * const scrolling = useScroll(ref, () => console.log('callback'));\n *\n * @overload\n * @template Target The target element\n * @param {Target} [target=window] The target element to scroll\n * @param {ScrollBehavior} [options.behavior=auto] The behavior of scrolling\n * @param {number} [options.offset.left=0] The left offset for arrived states\n * @param {number} [options.offset.right=0]  The right offset for arrived states\n * @param {number} [options.offset.top=0] The top offset for arrived states\n * @param {number} [options.offset.bottom=0] The bottom offset for arrived states\n * @param {(params: UseScrollCallbackParams, event: Event) => void} [options.onScroll] The callback function to be invoked on scroll\n * @param {(event: Event) => void} [options.onStop] The callback function to be invoked on scroll end\n * @returns {[StateRef<Target>, boolean]} The state of scrolling\n *\n * @example\n * const { ref, scrolling } = useScroll(options);\n *\n * @overload\n * @template Target The target element\n * @param {Target} target The target element to scroll\n * @param {(params: UseScrollCallbackParams, event: Event) => void} [callback] The callback function to be invoked on scroll\n * @returns {[StateRef<Target>, boolean]} The state of scrolling\n *\n * @example\n * const { ref, scrolling } = useScroll(() => console.log('callback'));\n */\nexport const useScroll = ((...params: any[]) => {\n  const target = (isTarget(params[0]) ? params[0] : undefined) as HookTarget | undefined;\n  const options = (\n    target\n      ? typeof params[1] === 'object'\n        ? params[1]\n        : { onScroll: params[1] }\n      : typeof params[0] === 'object'\n        ? params[0]\n        : { onScroll: params[0] }\n  ) as UseScrollOptions | undefined;\n\n  const internalRef = useRefState<Element>();\n  const internalOptionsRef = useRef(options);\n  internalOptionsRef.current = options;\n\n  const [scrolling, setScrolling] = useState(false);\n  const scrollPositionRef = useRef({ x: 0, y: 0 });\n\n  useEffect(() => {\n    if (!target && !internalRef.state) return;\n    const element = ((target ? getElement(target) : internalRef.current) as Element) ?? window;\n\n    const onScrollEnd = (event: Event) => {\n      setScrolling(false);\n      options?.onStop?.(event);\n    };\n\n    const onScroll = (event: Event) => {\n      setScrolling(true);\n      const target = (\n        event.target === document ? (event.target as Document).documentElement : event.target\n      ) as HTMLElement;\n\n      const { display, flexDirection, direction } = target.style;\n      const directionMultiplier = direction === 'rtl' ? -1 : 1;\n\n      const scrollLeft = target.scrollLeft;\n      let scrollTop = target.scrollTop;\n      if (target instanceof Document && !scrollTop) scrollTop = window.document.body.scrollTop;\n\n      const offset = internalOptionsRef.current?.offset;\n      const left = scrollLeft * directionMultiplier <= (offset?.left ?? 0);\n      const right =\n        scrollLeft * directionMultiplier + target.clientWidth >=\n        target.scrollWidth - (offset?.right ?? 0) - ARRIVED_STATE_THRESHOLD_PIXELS;\n      const top = scrollTop <= (offset?.top ?? 0);\n      const bottom =\n        scrollTop + target.clientHeight >=\n        target.scrollHeight - (offset?.bottom ?? 0) - ARRIVED_STATE_THRESHOLD_PIXELS;\n\n      const isColumnReverse = display === 'flex' && flexDirection === 'column-reverse';\n      const isRowReverse = display === 'flex' && flexDirection === 'column-reverse';\n\n      const params = {\n        x: scrollLeft,\n        y: scrollTop,\n        directions: {\n          left: scrollLeft < scrollPositionRef.current.x,\n          right: scrollLeft > scrollPositionRef.current.x,\n          top: scrollTop < scrollPositionRef.current.y,\n          bottom: scrollTop > scrollPositionRef.current.y\n        },\n        arrived: {\n          left: isRowReverse ? right : left,\n          right: isRowReverse ? left : right,\n          top: isColumnReverse ? bottom : top,\n          bottom: isColumnReverse ? top : bottom\n        }\n      };\n\n      scrollPositionRef.current = { x: scrollLeft, y: scrollTop };\n      internalOptionsRef.current?.onScroll?.(params, event);\n    };\n\n    element.addEventListener('scroll', onScroll);\n    element.addEventListener('scrollend', onScrollEnd);\n\n    return () => {\n      element.removeEventListener('scroll', onScroll);\n      element.removeEventListener('scrollend', onScrollEnd);\n    };\n  }, [target, internalRef.state]);\n\n  if (target) return scrolling;\n  return {\n    ref: internalRef,\n    scrolling\n  };\n}) as UseScroll;\n"],"names":["ARRIVED_STATE_THRESHOLD_PIXELS","useScroll","params","target","isTarget","options","internalRef","useRefState","internalOptionsRef","useRef","scrolling","setScrolling","useState","scrollPositionRef","useEffect","element","getElement","onScrollEnd","event","onScroll","display","flexDirection","direction","directionMultiplier","scrollLeft","scrollTop","offset","left","right","top","bottom","isColumnReverse","isRowReverse"],"mappings":"mPAUMA,EAAiC,EAoH1BC,EAAa,IAAIC,IAAkB,CAC9C,MAAMC,EAAUC,EAAAA,SAASF,EAAO,CAAC,CAAC,EAAIA,EAAO,CAAC,EAAI,OAC5CG,EACJF,EACI,OAAOD,EAAO,CAAC,GAAM,SACnBA,EAAO,CAAC,EACR,CAAE,SAAUA,EAAO,CAAC,CAAA,EACtB,OAAOA,EAAO,CAAC,GAAM,SACnBA,EAAO,CAAC,EACR,CAAE,SAAUA,EAAO,CAAC,CAAA,EAGtBI,EAAcC,EAAAA,YAAA,EACdC,EAAqBC,EAAAA,OAAOJ,CAAO,EACzCG,EAAmB,QAAUH,EAE7B,KAAM,CAACK,EAAWC,CAAY,EAAIC,EAAAA,SAAS,EAAK,EAC1CC,EAAoBJ,EAAAA,OAAO,CAAE,EAAG,EAAG,EAAG,EAAG,EAmE/C,OAjEAK,EAAAA,UAAU,IAAM,CACd,GAAI,CAACX,GAAU,CAACG,EAAY,MAAO,OACnC,MAAMS,GAAYZ,EAASa,EAAAA,WAAWb,CAAM,EAAIG,EAAY,UAAwB,OAE9EW,EAAeC,GAAiB,CACpCP,EAAa,EAAK,EAClBN,GAAS,SAASa,CAAK,CAAA,EAGnBC,EAAYD,GAAiB,CACjCP,EAAa,EAAI,EACjB,MAAMR,EACJe,EAAM,SAAW,SAAYA,EAAM,OAAoB,gBAAkBA,EAAM,OAG3E,CAAE,QAAAE,EAAS,cAAAC,EAAe,UAAAC,CAAA,EAAcnB,EAAO,MAC/CoB,EAAsBD,IAAc,MAAQ,GAAK,EAEjDE,EAAarB,EAAO,WAC1B,IAAIsB,EAAYtB,EAAO,UACnBA,aAAkB,UAAY,CAACsB,IAAWA,EAAY,OAAO,SAAS,KAAK,WAE/E,MAAMC,EAASlB,EAAmB,SAAS,OACrCmB,EAAOH,EAAaD,IAAwBG,GAAQ,MAAQ,GAC5DE,EACJJ,EAAaD,EAAsBpB,EAAO,aAC1CA,EAAO,aAAeuB,GAAQ,OAAS,GAAK1B,EACxC6B,EAAMJ,IAAcC,GAAQ,KAAO,GACnCI,EACJL,EAAYtB,EAAO,cACnBA,EAAO,cAAgBuB,GAAQ,QAAU,GAAK1B,EAE1C+B,EAAkBX,IAAY,QAAUC,IAAkB,iBAC1DW,EAAeZ,IAAY,QAAUC,IAAkB,iBAEvDnB,EAAS,CACb,EAAGsB,EACH,EAAGC,EACH,WAAY,CACV,KAAMD,EAAaX,EAAkB,QAAQ,EAC7C,MAAOW,EAAaX,EAAkB,QAAQ,EAC9C,IAAKY,EAAYZ,EAAkB,QAAQ,EAC3C,OAAQY,EAAYZ,EAAkB,QAAQ,CAAA,EAEhD,QAAS,CACP,KAAMmB,EAAeJ,EAAQD,EAC7B,MAAOK,EAAeL,EAAOC,EAC7B,IAAKG,EAAkBD,EAASD,EAChC,OAAQE,EAAkBF,EAAMC,CAAA,CAClC,EAGFjB,EAAkB,QAAU,CAAE,EAAGW,EAAY,EAAGC,CAAA,EAChDjB,EAAmB,SAAS,WAAWN,EAAQgB,CAAK,CAAA,EAGtD,OAAAH,EAAQ,iBAAiB,SAAUI,CAAQ,EAC3CJ,EAAQ,iBAAiB,YAAaE,CAAW,EAE1C,IAAM,CACXF,EAAQ,oBAAoB,SAAUI,CAAQ,EAC9CJ,EAAQ,oBAAoB,YAAaE,CAAW,CAAA,CACtD,EACC,CAACd,EAAQG,EAAY,KAAK,CAAC,EAE1BH,EAAeO,EACZ,CACL,IAAKJ,EACL,UAAAI,CAAA,CAEJ"}
+{"version":3,"file":"useScroll.cjs","sources":["../../../../src/hooks/useScroll/useScroll.ts"],"sourcesContent":["import { useEffect, useRef, useState } from 'react';\n\nimport type { HookTarget } from '@/utils/helpers';\n\nimport { getElement, isTarget } from '@/utils/helpers';\n\nimport type { StateRef } from '../useRefState/useRefState';\n\nimport { useRefState } from '../useRefState/useRefState';\n\nconst ARRIVED_STATE_THRESHOLD_PIXELS = 1;\n\nexport interface UseScrollOptions {\n  /** The on scroll callback */\n  onScroll?: (params: UseScrollCallbackParams, event: Event) => void;\n\n  /** The on end scroll callback */\n  onStop?: (event: Event) => void;\n\n  /** Offset arrived states by x pixels. */\n  offset?: {\n    left?: number;\n    right?: number;\n    top?: number;\n    bottom?: number;\n  };\n}\n\nexport interface UseScrollCallbackParams {\n  /** The element x position */\n  x: number;\n  /** The element y position */\n  y: number;\n  /** State of scroll arrived */\n  arrived: {\n    left: boolean;\n    right: boolean;\n    top: boolean;\n    bottom: boolean;\n  };\n  /** State of scroll direction */\n  directions: {\n    left: boolean;\n    right: boolean;\n    top: boolean;\n    bottom: boolean;\n  };\n}\n\n/** The scroll into view params type */\nexport interface ScrollIntoViewParams {\n  behavior?: ScrollBehavior;\n  block?: ScrollLogicalPosition;\n  inline?: ScrollLogicalPosition;\n}\n/** The scroll to params type */\nexport interface ScrollToParams {\n  behavior?: ScrollBehavior;\n  x: number;\n  y: number;\n}\n\n/** The use scroll return type */\nexport interface UseScrollReturn {\n  /** The state of scrolling */\n  scrolling: boolean;\n  /** Function to scroll element into view */\n  scrollIntoView: (params?: ScrollIntoViewParams) => void;\n  /** Function to scroll element to a specific position */\n  scrollTo: (params?: ScrollToParams) => void;\n}\n\nexport interface UseScroll {\n  (\n    target?: HookTarget,\n    callback?: (params: UseScrollCallbackParams, event: Event) => void\n  ): UseScrollReturn;\n\n  (target?: HookTarget, options?: UseScrollOptions): UseScrollReturn;\n\n  <Target extends Element>(\n    callback?: (params: UseScrollCallbackParams, event: Event) => void,\n    target?: never\n  ): UseScrollReturn & { ref: StateRef<Target> };\n\n  <Target extends Element>(\n    options?: UseScrollOptions,\n    target?: never\n  ): UseScrollReturn & {\n    ref: StateRef<Target>;\n  };\n}\n\n/**\n * @name useScroll\n * @description - Hook that allows you to control scroll a element\n * @category Sensors\n * @usage low\n *\n * @overload\n * @template Target The target element\n * @param {ScrollBehavior} [options.behavior=auto] The behavior of scrolling\n * @param {number} [options.offset.left=0] The left offset for arrived states\n * @param {number} [options.offset.right=0]  The right offset for arrived states\n * @param {number} [options.offset.top=0] The top offset for arrived states\n * @param {number} [options.offset.bottom=0] The bottom offset for arrived states\n * @param {(params: UseScrollCallbackParams, event: Event) => void} [options.onScroll] The callback function to be invoked on scroll\n * @param {(event: Event) => void} [options.onStop] The callback function to be invoked on scroll end\n * @returns {UseScrollReturn} The state of scrolling\n *\n * @example\n * const { scrolling, scrollIntoView, scrollTo} = useScroll(ref, options);\n *\n * @overload\n * @template Target The target element\n * @param {(params: UseScrollCallbackParams, event: Event) => void} [callback] The callback function to be invoked on scroll\n * @returns {UseScrollReturn} The state of scrolling\n *\n * @example\n * const { scrolling, scrollIntoView, scrollTo} = useScroll(ref, () => console.log('callback'));\n *\n * @overload\n * @template Target The target element\n * @param {Target} [target=window] The target element to scroll\n * @param {ScrollBehavior} [options.behavior=auto] The behavior of scrolling\n * @param {number} [options.offset.left=0] The left offset for arrived states\n * @param {number} [options.offset.right=0]  The right offset for arrived states\n * @param {number} [options.offset.top=0] The top offset for arrived states\n * @param {number} [options.offset.bottom=0] The bottom offset for arrived states\n * @param {(params: UseScrollCallbackParams, event: Event) => void} [options.onScroll] The callback function to be invoked on scroll\n * @param {(event: Event) => void} [options.onStop] The callback function to be invoked on scroll end\n * @returns {UseScrollReturn & { ref: StateRef<Target> }} The state of scrolling\n *\n * @example\n * const { ref, scrolling, scrollIntoView, scrollTo} = useScroll(options);\n *\n * @overload\n * @template Target The target element\n * @param {Target} target The target element to scroll\n * @param {(params: UseScrollCallbackParams, event: Event) => void} [callback] The callback function to be invoked on scroll\n * @returns {UseScrollReturn & { ref: StateRef<Target> }} The state of scrolling\n *\n * @example\n * const { ref, scrolling, scrollIntoView, scrollTo} = useScroll(() => console.log('callback'));\n */\nexport const useScroll = ((...params: any[]) => {\n  const target = (isTarget(params[0]) ? params[0] : undefined) as HookTarget | undefined;\n  const options = (\n    target\n      ? typeof params[1] === 'object'\n        ? params[1]\n        : { onScroll: params[1] }\n      : typeof params[0] === 'object'\n        ? params[0]\n        : { onScroll: params[0] }\n  ) as UseScrollOptions | undefined;\n\n  const internalRef = useRefState<Element>();\n  const internalOptionsRef = useRef(options);\n  const elementRef = useRef<Element>(null);\n  internalOptionsRef.current = options;\n\n  const [scrolling, setScrolling] = useState(false);\n  const scrollPositionRef = useRef({ x: 0, y: 0 });\n\n  useEffect(() => {\n    if (!target && !internalRef.state) return;\n    const element = ((target ? getElement(target) : internalRef.current) as Element) ?? window;\n\n    elementRef.current = element;\n\n    const onScrollEnd = (event: Event) => {\n      setScrolling(false);\n      options?.onStop?.(event);\n    };\n\n    const onScroll = (event: Event) => {\n      setScrolling(true);\n      const target = (\n        event.target === document ? (event.target as Document).documentElement : event.target\n      ) as HTMLElement;\n\n      const { display, flexDirection, direction } = target.style;\n      const directionMultiplier = direction === 'rtl' ? -1 : 1;\n\n      const scrollLeft = target.scrollLeft;\n      let scrollTop = target.scrollTop;\n      if (target instanceof Document && !scrollTop) scrollTop = window.document.body.scrollTop;\n\n      const offset = internalOptionsRef.current?.offset;\n      const left = scrollLeft * directionMultiplier <= (offset?.left ?? 0);\n      const right =\n        scrollLeft * directionMultiplier + target.clientWidth >=\n        target.scrollWidth - (offset?.right ?? 0) - ARRIVED_STATE_THRESHOLD_PIXELS;\n      const top = scrollTop <= (offset?.top ?? 0);\n      const bottom =\n        scrollTop + target.clientHeight >=\n        target.scrollHeight - (offset?.bottom ?? 0) - ARRIVED_STATE_THRESHOLD_PIXELS;\n\n      const isColumnReverse = display === 'flex' && flexDirection === 'column-reverse';\n      const isRowReverse = display === 'flex' && flexDirection === 'column-reverse';\n\n      const params = {\n        x: scrollLeft,\n        y: scrollTop,\n        directions: {\n          left: scrollLeft < scrollPositionRef.current.x,\n          right: scrollLeft > scrollPositionRef.current.x,\n          top: scrollTop < scrollPositionRef.current.y,\n          bottom: scrollTop > scrollPositionRef.current.y\n        },\n        arrived: {\n          left: isRowReverse ? right : left,\n          right: isRowReverse ? left : right,\n          top: isColumnReverse ? bottom : top,\n          bottom: isColumnReverse ? top : bottom\n        }\n      };\n\n      scrollPositionRef.current = { x: scrollLeft, y: scrollTop };\n      internalOptionsRef.current?.onScroll?.(params, event);\n    };\n\n    element.addEventListener('scroll', onScroll);\n    element.addEventListener('scrollend', onScrollEnd);\n\n    return () => {\n      element.removeEventListener('scroll', onScroll);\n      element.removeEventListener('scrollend', onScrollEnd);\n    };\n  }, [target, internalRef.state]);\n\n  const scrollIntoView = (params?: {\n    behavior?: ScrollBehavior;\n    block?: ScrollLogicalPosition;\n    inline?: ScrollLogicalPosition;\n  }) => {\n    if (!elementRef.current) return;\n\n    const { behavior, block, inline } = params ?? {};\n\n    elementRef.current.scrollIntoView({\n      behavior,\n      block,\n      inline\n    });\n  };\n\n  const scrollTo = (params?: { x: number; y: number; behavior?: ScrollBehavior }) => {\n    if (!elementRef.current) return;\n\n    const { x, y, behavior } = params ?? {};\n\n    elementRef.current.scrollTo({ left: x, top: y, behavior });\n  };\n\n  if (target) return { scrollIntoView, scrollTo, scrolling };\n  return {\n    ref: internalRef,\n    scrolling,\n    scrollIntoView,\n    scrollTo\n  };\n}) as UseScroll;\n"],"names":["ARRIVED_STATE_THRESHOLD_PIXELS","useScroll","params","target","isTarget","options","internalRef","useRefState","internalOptionsRef","useRef","elementRef","scrolling","setScrolling","useState","scrollPositionRef","useEffect","element","getElement","onScrollEnd","event","onScroll","display","flexDirection","direction","directionMultiplier","scrollLeft","scrollTop","offset","left","right","top","bottom","isColumnReverse","isRowReverse","scrollIntoView","behavior","block","inline","scrollTo","x","y"],"mappings":"mPAUMA,EAAiC,EAuI1BC,EAAa,IAAIC,IAAkB,CAC9C,MAAMC,EAAUC,EAAAA,SAASF,EAAO,CAAC,CAAC,EAAIA,EAAO,CAAC,EAAI,OAC5CG,EACJF,EACI,OAAOD,EAAO,CAAC,GAAM,SACnBA,EAAO,CAAC,EACR,CAAE,SAAUA,EAAO,CAAC,CAAA,EACtB,OAAOA,EAAO,CAAC,GAAM,SACnBA,EAAO,CAAC,EACR,CAAE,SAAUA,EAAO,CAAC,CAAA,EAGtBI,EAAcC,EAAAA,YAAA,EACdC,EAAqBC,EAAAA,OAAOJ,CAAO,EACnCK,EAAaD,EAAAA,OAAgB,IAAI,EACvCD,EAAmB,QAAUH,EAE7B,KAAM,CAACM,EAAWC,CAAY,EAAIC,EAAAA,SAAS,EAAK,EAC1CC,EAAoBL,EAAAA,OAAO,CAAE,EAAG,EAAG,EAAG,EAAG,EAE/CM,EAAAA,UAAU,IAAM,CACd,GAAI,CAACZ,GAAU,CAACG,EAAY,MAAO,OACnC,MAAMU,GAAYb,EAASc,EAAAA,WAAWd,CAAM,EAAIG,EAAY,UAAwB,OAEpFI,EAAW,QAAUM,EAErB,MAAME,EAAeC,GAAiB,CACpCP,EAAa,EAAK,EAClBP,GAAS,SAASc,CAAK,CAAA,EAGnBC,EAAYD,GAAiB,CACjCP,EAAa,EAAI,EACjB,MAAMT,EACJgB,EAAM,SAAW,SAAYA,EAAM,OAAoB,gBAAkBA,EAAM,OAG3E,CAAE,QAAAE,EAAS,cAAAC,EAAe,UAAAC,CAAA,EAAcpB,EAAO,MAC/CqB,EAAsBD,IAAc,MAAQ,GAAK,EAEjDE,EAAatB,EAAO,WAC1B,IAAIuB,EAAYvB,EAAO,UACnBA,aAAkB,UAAY,CAACuB,IAAWA,EAAY,OAAO,SAAS,KAAK,WAE/E,MAAMC,EAASnB,EAAmB,SAAS,OACrCoB,EAAOH,EAAaD,IAAwBG,GAAQ,MAAQ,GAC5DE,EACJJ,EAAaD,EAAsBrB,EAAO,aAC1CA,EAAO,aAAewB,GAAQ,OAAS,GAAK3B,EACxC8B,EAAMJ,IAAcC,GAAQ,KAAO,GACnCI,EACJL,EAAYvB,EAAO,cACnBA,EAAO,cAAgBwB,GAAQ,QAAU,GAAK3B,EAE1CgC,EAAkBX,IAAY,QAAUC,IAAkB,iBAC1DW,EAAeZ,IAAY,QAAUC,IAAkB,iBAEvDpB,EAAS,CACb,EAAGuB,EACH,EAAGC,EACH,WAAY,CACV,KAAMD,EAAaX,EAAkB,QAAQ,EAC7C,MAAOW,EAAaX,EAAkB,QAAQ,EAC9C,IAAKY,EAAYZ,EAAkB,QAAQ,EAC3C,OAAQY,EAAYZ,EAAkB,QAAQ,CAAA,EAEhD,QAAS,CACP,KAAMmB,EAAeJ,EAAQD,EAC7B,MAAOK,EAAeL,EAAOC,EAC7B,IAAKG,EAAkBD,EAASD,EAChC,OAAQE,EAAkBF,EAAMC,CAAA,CAClC,EAGFjB,EAAkB,QAAU,CAAE,EAAGW,EAAY,EAAGC,CAAA,EAChDlB,EAAmB,SAAS,WAAWN,EAAQiB,CAAK,CAAA,EAGtD,OAAAH,EAAQ,iBAAiB,SAAUI,CAAQ,EAC3CJ,EAAQ,iBAAiB,YAAaE,CAAW,EAE1C,IAAM,CACXF,EAAQ,oBAAoB,SAAUI,CAAQ,EAC9CJ,EAAQ,oBAAoB,YAAaE,CAAW,CAAA,CACtD,EACC,CAACf,EAAQG,EAAY,KAAK,CAAC,EAE9B,MAAM4B,EAAkBhC,GAIlB,CACJ,GAAI,CAACQ,EAAW,QAAS,OAEzB,KAAM,CAAE,SAAAyB,EAAU,MAAAC,EAAO,OAAAC,CAAA,EAAWnC,GAAU,CAAA,EAE9CQ,EAAW,QAAQ,eAAe,CAChC,SAAAyB,EACA,MAAAC,EACA,OAAAC,CAAA,CACD,CAAA,EAGGC,EAAYpC,GAAiE,CACjF,GAAI,CAACQ,EAAW,QAAS,OAEzB,KAAM,CAAE,EAAA6B,EAAG,EAAAC,EAAG,SAAAL,CAAA,EAAajC,GAAU,CAAA,EAErCQ,EAAW,QAAQ,SAAS,CAAE,KAAM6B,EAAG,IAAKC,EAAG,SAAAL,EAAU,CAAA,EAG3D,OAAIhC,EAAe,CAAE,eAAA+B,EAAgB,SAAAI,EAAU,UAAA3B,CAAA,EACxC,CACL,IAAKL,EACL,UAAAK,EACA,eAAAuB,EACA,SAAAI,CAAA,CAEJ"}

package/dist/cjs/index.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const y=require("./helpers/createContext/createContext.cjs"),I=require("./helpers/createEventEmitter/createEventEmitter.cjs"),k=require("./helpers/createReactiveContext/createReactiveContext.cjs"),v=require("./helpers/createStore/createStore.cjs"),O=require("./hooks/useAsync/useAsync.cjs"),h=require("./hooks/useLockCallback/useLockCallback.cjs"),A=require("./hooks/useMutation/useMutation.cjs"),D=require("./hooks/useOptimistic/useOptimistic.cjs"),b=require("./hooks/useQuery/useQuery.cjs"),f=require("./hooks/useAudio/useAudio.cjs"),M=require("./hooks/useBattery/useBattery.cjs"),L=require("./hooks/useBluetooth/useBluetooth.cjs"),_=require("./hooks/useBroadcastChannel/useBroadcastChannel.cjs"),N=require("./hooks/useClipboard/useClipboard.cjs"),B=require("./hooks/useCopy/useCopy.cjs"),K=require("./hooks/useCssVar/useCssVar.cjs"),F=require("./hooks/useDisplayMedia/useDisplayMedia.cjs"),V=require("./hooks/useDocumentTitle/useDocumentTitle.cjs"),U=require("./hooks/useEventSource/useEventSource.cjs"),w=require("./hooks/useEyeDropper/useEyeDropper.cjs"),W=require("./hooks/useFavicon/useFavicon.cjs"),H=require("./hooks/useFps/useFps.cjs"),x=require("./hooks/useFullscreen/useFullscreen.cjs"),n=require("./hooks/useGamepad/useGamepad.cjs"),Q=require("./hooks/useGeolocation/useGeolocation.cjs"),c=require("./hooks/useMediaControls/useMediaControls.cjs"),z=require("./hooks/useMemory/useMemory.cjs"),a=require("./hooks/useNetwork/useNetwork.cjs"),G=require("./hooks/useOnline/useOnline.cjs"),X=require("./hooks/useOtpCredential/useOtpCredential.cjs"),Z=require("./hooks/usePermission/usePermission.cjs"),j=require("./hooks/usePictureInPicture/usePictureInPicture.cjs"),J=require("./hooks/usePointerLock/usePointerLock.cjs"),Y=require("./hooks/usePostMessage/usePostMessage.cjs"),$=require("./hooks/useRaf/useRaf.cjs"),ee=require("./hooks/useShare/useShare.cjs"),l=require("./hooks/useSpeechRecognition/useSpeechRecognition.cjs"),se=require("./hooks/useSpeechSynthesis/useSpeechSynthesis.cjs"),ue=require("./hooks/useVibrate/useVibrate.cjs"),re=require("./hooks/useVirtualKeyboard/useVirtualKeyboard.cjs"),te=require("./hooks/useWakeLock/useWakeLock.cjs"),oe=require("./hooks/useWebSocket/useWebSocket.cjs"),ie=require("./hooks/useLogger/useLogger.cjs"),ne=require("./hooks/useRenderCount/useRenderCount.cjs"),ce=require("./hooks/useRenderInfo/useRenderInfo.cjs"),ae=require("./hooks/useRerender/useRerender.cjs"),le=require("./hooks/useActiveElement/useActiveElement.cjs"),Se=require("./hooks/useAutoScroll/useAutoScroll.cjs"),qe=require("./hooks/useClickOutside/useClickOutside.cjs"),S=require("./hooks/useDoubleClick/useDoubleClick.cjs"),de=require("./hooks/useDropZone/useDropZone.cjs"),ge=require("./hooks/useFileDialog/useFileDialog.cjs"),Ee=require("./hooks/useFocus/useFocus.cjs"),Te=require("./hooks/useHover/useHover.cjs"),Pe=require("./hooks/useImage/useImage.cjs"),Ce=require("./hooks/useLongPress/useLongPress.cjs"),r=require("./hooks/usePaint/usePaint.cjs"),Re=require("./hooks/useRightClick/useRightClick.cjs"),q=require("./hooks/useScript/useScript.cjs"),me=require("./hooks/useSticky/useSticky.cjs"),pe=require("./hooks/useTextDirection/useTextDirection.cjs"),ye=require("./hooks/useFul/useFul.cjs"),Ie=require("./hooks/useLess/useLess.cjs"),ke=require("./hooks/useOnce/useOnce.cjs"),ve=require("./hooks/useDidUpdate/useDidUpdate.cjs"),Oe=require("./hooks/useIsFirstRender/useIsFirstRender.cjs"),he=require("./hooks/useIsomorphicLayoutEffect/useIsomorphicLayoutEffect.cjs"),Ae=require("./hooks/useMount/useMount.cjs"),d=require("./hooks/useShallowEffect/useShallowEffect.cjs"),De=require("./hooks/useUnmount/useUnmount.cjs"),e=require("./hooks/useBreakpoints/useBreakpoints.cjs"),be=require("./hooks/useDeviceMotion/useDeviceMotion.cjs"),fe=require("./hooks/useDeviceOrientation/useDeviceOrientation.cjs"),Me=require("./hooks/useDevicePixelRatio/useDevicePixelRatio.cjs"),Le=require("./hooks/useDocumentEvent/useDocumentEvent.cjs"),_e=require("./hooks/useDocumentVisibility/useDocumentVisibility.cjs"),Ne=require("./hooks/useElementSize/useElementSize.cjs"),Be=require("./hooks/useEventListener/useEventListener.cjs"),g=require("./hooks/useHotkeys/useHotkeys.cjs"),Ke=require("./hooks/useIdle/useIdle.cjs"),Fe=require("./hooks/useInfiniteScroll/useInfiniteScroll.cjs"),Ve=require("./hooks/useIntersectionObserver/useIntersectionObserver.cjs"),Ue=require("./hooks/useKeyboard/useKeyboard.cjs"),we=require("./hooks/useKeyPress/useKeyPress.cjs"),We=require("./hooks/useKeyPressEvent/useKeyPressEvent.cjs"),He=require("./hooks/useKeysPressed/useKeysPressed.cjs"),xe=require("./hooks/useLockScroll/useLockScroll.cjs"),Qe=require("./hooks/useMeasure/useMeasure.cjs"),ze=require("./hooks/useMediaQuery/useMediaQuery.cjs"),Ge=require("./hooks/useMouse/useMouse.cjs"),Xe=require("./hooks/useMutationObserver/useMutationObserver.cjs"),Ze=require("./hooks/useOrientation/useOrientation.cjs"),je=require("./hooks/usePageLeave/usePageLeave.cjs"),Je=require("./hooks/useParallax/useParallax.cjs"),Ye=require("./hooks/usePerformanceObserver/usePerformanceObserver.cjs"),$e=require("./hooks/useResizeObserver/useResizeObserver.cjs"),es=require("./hooks/useScroll/useScroll.cjs"),ss=require("./hooks/useScrollIntoView/useScrollIntoView.cjs"),us=require("./hooks/useScrollTo/useScrollTo.cjs"),E=require("./hooks/useTextSelection/useTextSelection.cjs"),rs=require("./hooks/useWindowEvent/useWindowEvent.cjs"),ts=require("./hooks/useWindowFocus/useWindowFocus.cjs"),T=require("./hooks/useWindowScroll/useWindowScroll.cjs"),os=require("./hooks/useWindowSize/useWindowSize.cjs"),is=require("./hooks/useBoolean/useBoolean.cjs"),s=require("./hooks/useCookie/useCookie.cjs"),P=require("./hooks/useCookies/useCookies.cjs"),ns=require("./hooks/useCounter/useCounter.cjs"),cs=require("./hooks/useDefault/useDefault.cjs"),as=require("./hooks/useDisclosure/useDisclosure.cjs"),ls=require("./hooks/useField/useField.cjs"),Ss=require("./hooks/useHash/useHash.cjs"),qs=require("./hooks/useList/useList.cjs"),ds=require("./hooks/useLocalStorage/useLocalStorage.cjs"),gs=require("./hooks/useMap/useMap.cjs"),t=require("./hooks/useMergedRef/useMergedRef.cjs"),Es=require("./hooks/useOffsetPagination/useOffsetPagination.cjs"),Ts=require("./hooks/useQueue/useQueue.cjs"),Ps=require("./hooks/useRafState/useRafState.cjs"),Cs=require("./hooks/useRefState/useRefState.cjs"),Rs=require("./hooks/useSessionStorage/useSessionStorage.cjs"),ms=require("./hooks/useSet/useSet.cjs"),C=require("./hooks/useStateHistory/useStateHistory.cjs"),ps=require("./hooks/useStep/useStep.cjs"),o=require("./hooks/useStorage/useStorage.cjs"),ys=require("./hooks/useToggle/useToggle.cjs"),u=require("./hooks/useUrlSearchParam/useUrlSearchParam.cjs"),Is=require("./hooks/useUrlSearchParams/useUrlSearchParams.cjs"),ks=require("./hooks/useWizard/useWizard.cjs"),vs=require("./hooks/useInterval/useInterval.cjs"),Os=require("./hooks/useStopwatch/useStopwatch.cjs"),hs=require("./hooks/useTime/useTime.cjs"),As=require("./hooks/useTimeout/useTimeout.cjs"),R=require("./hooks/useTimer/useTimer.cjs"),Ds=require("./hooks/useBrowserLanguage/useBrowserLanguage.cjs"),m=require("./hooks/useOperatingSystem/useOperatingSystem.cjs"),bs=require("./hooks/usePreferredColorScheme/usePreferredColorScheme.cjs"),fs=require("./hooks/usePreferredContrast/usePreferredContrast.cjs"),Ms=require("./hooks/usePreferredDark/usePreferredDark.cjs"),Ls=require("./hooks/usePreferredLanguages/usePreferredLanguages.cjs"),_s=require("./hooks/usePreferredReducedMotion/usePreferredReducedMotion.cjs"),Ns=require("./hooks/useConst/useConst.cjs"),Bs=require("./hooks/useDebounceCallback/useDebounceCallback.cjs"),Ks=require("./hooks/useDebounceState/useDebounceState.cjs"),Fs=require("./hooks/useDebounceValue/useDebounceValue.cjs"),Vs=require("./hooks/useEvent/useEvent.cjs"),Us=require("./hooks/useLastChanged/useLastChanged.cjs"),ws=require("./hooks/useLatest/useLatest.cjs"),Ws=require("./hooks/usePrevious/usePrevious.cjs"),Hs=require("./hooks/useThrottleCallback/useThrottleCallback.cjs"),xs=require("./hooks/useThrottleState/useThrottleState.cjs"),Qs=require("./hooks/useThrottleValue/useThrottleValue.cjs"),p=require("./utils/helpers/copy.cjs"),zs=require("./utils/helpers/debounce.cjs"),Gs=require("./utils/helpers/getDate.cjs"),i=require("./utils/helpers/getElement.cjs"),Xs=require("./utils/helpers/getRetry.cjs"),Zs=require("./utils/helpers/isTarget.cjs"),js=require("./utils/helpers/throttle.cjs");exports.createContext=y.createContext;exports.createEventEmitter=I.createEventEmitter;exports.createReactiveContext=k.createReactiveContext;exports.createStore=v.createStore;exports.useAsync=O.useAsync;exports.useLockCallback=h.useLockCallback;exports.useMutation=A.useMutation;exports.useOptimistic=D.useOptimistic;exports.useQuery=b.useQuery;exports.useAudio=f.useAudio;exports.useBattery=M.useBattery;exports.useBluetooth=L.useBluetooth;exports.useBroadcastChannel=_.useBroadcastChannel;exports.useClipboard=N.useClipboard;exports.useCopy=B.useCopy;exports.useCssVar=K.useCssVar;exports.useDisplayMedia=F.useDisplayMedia;exports.useDocumentTitle=V.useDocumentTitle;exports.useEventSource=U.useEventSource;exports.useEyeDropper=w.useEyeDropper;exports.useFavicon=W.useFavicon;exports.useFps=H.useFps;exports.useFullscreen=x.useFullscreen;exports.mapGamepadToXbox360Controller=n.mapGamepadToXbox360Controller;exports.useGamepad=n.useGamepad;exports.useGeolocation=Q.useGeolocation;exports.timeRangeToArray=c.timeRangeToArray;exports.useMediaControls=c.useMediaControls;exports.useMemory=z.useMemory;exports.getConnection=a.getConnection;exports.useNetwork=a.useNetwork;exports.useOnline=G.useOnline;exports.useOtpCredential=X.useOtpCredential;exports.usePermission=Z.usePermission;exports.usePictureInPicture=j.usePictureInPicture;exports.usePointerLock=J.usePointerLock;exports.usePostMessage=Y.usePostMessage;exports.useRaf=$.useRaf;exports.useShare=ee.useShare;exports.getSpeechRecognition=l.getSpeechRecognition;exports.useSpeechRecognition=l.useSpeechRecognition;exports.useSpeechSynthesis=se.useSpeechSynthesis;exports.useVibrate=ue.useVibrate;exports.useVirtualKeyboard=re.useVirtualKeyboard;exports.useWakeLock=te.useWakeLock;exports.useWebSocket=oe.useWebSocket;exports.useLogger=ie.useLogger;exports.useRenderCount=ne.useRenderCount;exports.useRenderInfo=ce.useRenderInfo;exports.useRerender=ae.useRerender;exports.useActiveElement=le.useActiveElement;exports.useAutoScroll=Se.useAutoScroll;exports.useClickOutside=qe.useClickOutside;exports.DEFAULT_THRESHOLD_TIME=S.DEFAULT_THRESHOLD_TIME;exports.useDoubleClick=S.useDoubleClick;exports.useDropZone=de.useDropZone;exports.useFileDialog=ge.useFileDialog;exports.useFocus=Ee.useFocus;exports.useHover=Te.useHover;exports.useImage=Pe.useImage;exports.useLongPress=Ce.useLongPress;exports.Paint=r.Paint;exports.Pointer=r.Pointer;exports.usePaint=r.usePaint;exports.useRightClick=Re.useRightClick;exports.SCRIPT_STATUS_ATTRIBUTE_NAME=q.SCRIPT_STATUS_ATTRIBUTE_NAME;exports.useScript=q.useScript;exports.useSticky=me.useSticky;exports.useTextDirection=pe.useTextDirection;exports.useFul=ye.useFul;exports.useLess=Ie.useLess;exports.useOnce=ke.useOnce;exports.useDidUpdate=ve.useDidUpdate;exports.useIsFirstRender=Oe.useIsFirstRender;exports.useIsomorphicLayoutEffect=he.useIsomorphicLayoutEffect;exports.useMount=Ae.useMount;exports.deepEqual=d.deepEqual;exports.useShallowEffect=d.useShallowEffect;exports.useUnmount=De.useUnmount;exports.BREAKPOINTS_ANT_DESIGN=e.BREAKPOINTS_ANT_DESIGN;exports.BREAKPOINTS_BOOTSTRAP_V5=e.BREAKPOINTS_BOOTSTRAP_V5;exports.BREAKPOINTS_MANTINE=e.BREAKPOINTS_MANTINE;exports.BREAKPOINTS_MASTER_CSS=e.BREAKPOINTS_MASTER_CSS;exports.BREAKPOINTS_MATERIAL_UI=e.BREAKPOINTS_MATERIAL_UI;exports.BREAKPOINTS_PRIME_FLEX=e.BREAKPOINTS_PRIME_FLEX;exports.BREAKPOINTS_QUASAR_V2=e.BREAKPOINTS_QUASAR_V2;exports.BREAKPOINTS_SEMANTIC=e.BREAKPOINTS_SEMANTIC;exports.BREAKPOINTS_TAILWIND=e.BREAKPOINTS_TAILWIND;exports.useBreakpoints=e.useBreakpoints;exports.useDeviceMotion=be.useDeviceMotion;exports.useDeviceOrientation=fe.useDeviceOrientation;exports.useDevicePixelRatio=Me.useDevicePixelRatio;exports.useDocumentEvent=Le.useDocumentEvent;exports.useDocumentVisibility=_e.useDocumentVisibility;exports.useElementSize=Ne.useElementSize;exports.useEventListener=Be.useEventListener;exports.isHotkeyMatch=g.isHotkeyMatch;exports.useHotkeys=g.useHotkeys;exports.useIdle=Ke.useIdle;exports.useInfiniteScroll=Fe.useInfiniteScroll;exports.useIntersectionObserver=Ve.useIntersectionObserver;exports.useKeyboard=Ue.useKeyboard;exports.useKeyPress=we.useKeyPress;exports.useKeyPressEvent=We.useKeyPressEvent;exports.useKeysPressed=He.useKeysPressed;exports.useLockScroll=xe.useLockScroll;exports.useMeasure=Qe.useMeasure;exports.useMediaQuery=ze.useMediaQuery;exports.useMouse=Ge.useMouse;exports.useMutationObserver=Xe.useMutationObserver;exports.useOrientation=Ze.useOrientation;exports.usePageLeave=je.usePageLeave;exports.useParallax=Je.useParallax;exports.usePerformanceObserver=Ye.usePerformanceObserver;exports.useResizeObserver=$e.useResizeObserver;exports.useScroll=es.useScroll;exports.useScrollIntoView=ss.useScrollIntoView;exports.useScrollTo=us.useScrollTo;exports.getRangesSelection=E.getRangesSelection;exports.useTextSelection=E.useTextSelection;exports.useWindowEvent=rs.useWindowEvent;exports.useWindowFocus=ts.useWindowFocus;exports.scrollTo=T.scrollTo;exports.useWindowScroll=T.useWindowScroll;exports.useWindowSize=os.useWindowSize;exports.useBoolean=is.useBoolean;exports.COOKIE_EVENT=s.COOKIE_EVENT;exports.dispatchCookieEvent=s.dispatchCookieEvent;exports.getCookie=s.getCookie;exports.getCookies=s.getCookies;exports.removeCookie=s.removeCookie;exports.removeCookieItem=s.removeCookieItem;exports.setCookie=s.setCookie;exports.setCookieItem=s.setCookieItem;exports.useCookie=s.useCookie;exports.clearCookies=P.clearCookies;exports.useCookies=P.useCookies;exports.useCounter=ns.useCounter;exports.useDefault=cs.useDefault;exports.useDisclosure=as.useDisclosure;exports.useField=ls.useField;exports.useHash=Ss.useHash;exports.useList=qs.useList;exports.useLocalStorage=ds.useLocalStorage;exports.useMap=gs.useMap;exports.assignRef=t.assignRef;exports.mergeRefs=t.mergeRefs;exports.useMergedRef=t.useMergedRef;exports.useOffsetPagination=Es.useOffsetPagination;exports.useQueue=Ts.useQueue;exports.useRafState=Ps.useRafState;exports.useRefState=Cs.useRefState;exports.useSessionStorage=Rs.useSessionStorage;exports.useSet=ms.useSet;exports.stateHistoryReducer=C.stateHistoryReducer;exports.useStateHistory=C.useStateHistory;exports.useStep=ps.useStep;exports.STORAGE_EVENT=o.STORAGE_EVENT;exports.dispatchStorageEvent=o.dispatchStorageEvent;exports.useStorage=o.useStorage;exports.useToggle=ys.useToggle;exports.URL_SEARCH_PARAMS_EVENT=u.URL_SEARCH_PARAMS_EVENT;exports.createQueryString=u.createQueryString;exports.dispatchUrlSearchParamsEvent=u.dispatchUrlSearchParamsEvent;exports.getUrlSearchParams=u.getUrlSearchParams;exports.useUrlSearchParam=u.useUrlSearchParam;exports.useUrlSearchParams=Is.useUrlSearchParams;exports.useWizard=ks.useWizard;exports.useInterval=vs.useInterval;exports.useStopwatch=Os.useStopwatch;exports.useTime=hs.useTime;exports.useTimeout=As.useTimeout;exports.getTimeFromSeconds=R.getTimeFromSeconds;exports.useTimer=R.useTimer;exports.useBrowserLanguage=Ds.useBrowserLanguage;exports.getOperatingSystem=m.getOperatingSystem;exports.useOperatingSystem=m.useOperatingSystem;exports.usePreferredColorScheme=bs.usePreferredColorScheme;exports.usePreferredContrast=fs.usePreferredContrast;exports.usePreferredDark=Ms.usePreferredDark;exports.usePreferredLanguages=Ls.usePreferredLanguages;exports.usePreferredReducedMotion=_s.usePreferredReducedMotion;exports.useConst=Ns.useConst;exports.useDebounceCallback=Bs.useDebounceCallback;exports.useDebounceState=Ks.useDebounceState;exports.useDebounceValue=Fs.useDebounceValue;exports.useEvent=Vs.useEvent;exports.useLastChanged=Us.useLastChanged;exports.useLatest=ws.useLatest;exports.usePrevious=Ws.usePrevious;exports.useThrottleCallback=Hs.useThrottleCallback;exports.useThrottleState=xs.useThrottleState;exports.useThrottleValue=Qs.useThrottleValue;exports.copy=p.copy;exports.legacyCopyToClipboard=p.legacyCopyToClipboard;exports.debounce=zs.debounce;exports.getDate=Gs.getDate;exports.getElement=i.getElement;exports.target=i.target;exports.targetSymbol=i.targetSymbol;exports.getRetry=Xs.getRetry;exports.isTarget=Zs.isTarget;exports.throttle=js.throttle;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const y=require("./helpers/createContext/createContext.cjs"),I=require("./helpers/createEventEmitter/createEventEmitter.cjs"),k=require("./helpers/createReactiveContext/createReactiveContext.cjs"),v=require("./helpers/createStore/createStore.cjs"),O=require("./hooks/useAsync/useAsync.cjs"),h=require("./hooks/useLockCallback/useLockCallback.cjs"),A=require("./hooks/useMutation/useMutation.cjs"),D=require("./hooks/useOptimistic/useOptimistic.cjs"),b=require("./hooks/useQuery/useQuery.cjs"),f=require("./hooks/useAudio/useAudio.cjs"),M=require("./hooks/useBattery/useBattery.cjs"),L=require("./hooks/useBluetooth/useBluetooth.cjs"),_=require("./hooks/useBroadcastChannel/useBroadcastChannel.cjs"),N=require("./hooks/useClipboard/useClipboard.cjs"),B=require("./hooks/useCopy/useCopy.cjs"),K=require("./hooks/useCssVar/useCssVar.cjs"),F=require("./hooks/useDisplayMedia/useDisplayMedia.cjs"),V=require("./hooks/useDocumentTitle/useDocumentTitle.cjs"),U=require("./hooks/useEventSource/useEventSource.cjs"),w=require("./hooks/useEyeDropper/useEyeDropper.cjs"),W=require("./hooks/useFavicon/useFavicon.cjs"),H=require("./hooks/useFps/useFps.cjs"),x=require("./hooks/useFullscreen/useFullscreen.cjs"),n=require("./hooks/useGamepad/useGamepad.cjs"),Q=require("./hooks/useGeolocation/useGeolocation.cjs"),c=require("./hooks/useMediaControls/useMediaControls.cjs"),z=require("./hooks/useMemory/useMemory.cjs"),a=require("./hooks/useNetwork/useNetwork.cjs"),G=require("./hooks/useOnline/useOnline.cjs"),X=require("./hooks/useOtpCredential/useOtpCredential.cjs"),Z=require("./hooks/usePermission/usePermission.cjs"),j=require("./hooks/usePictureInPicture/usePictureInPicture.cjs"),J=require("./hooks/usePointerLock/usePointerLock.cjs"),Y=require("./hooks/usePostMessage/usePostMessage.cjs"),$=require("./hooks/useRaf/useRaf.cjs"),ee=require("./hooks/useShare/useShare.cjs"),l=require("./hooks/useSpeechRecognition/useSpeechRecognition.cjs"),se=require("./hooks/useSpeechSynthesis/useSpeechSynthesis.cjs"),ue=require("./hooks/useVibrate/useVibrate.cjs"),re=require("./hooks/useVirtualKeyboard/useVirtualKeyboard.cjs"),te=require("./hooks/useWakeLock/useWakeLock.cjs"),oe=require("./hooks/useWebSocket/useWebSocket.cjs"),ie=require("./hooks/useLogger/useLogger.cjs"),ne=require("./hooks/useRenderCount/useRenderCount.cjs"),ce=require("./hooks/useRenderInfo/useRenderInfo.cjs"),ae=require("./hooks/useRerender/useRerender.cjs"),le=require("./hooks/useActiveElement/useActiveElement.cjs"),Se=require("./hooks/useAutoScroll/useAutoScroll.cjs"),qe=require("./hooks/useClickOutside/useClickOutside.cjs"),S=require("./hooks/useDoubleClick/useDoubleClick.cjs"),de=require("./hooks/useDropZone/useDropZone.cjs"),ge=require("./hooks/useFileDialog/useFileDialog.cjs"),Ee=require("./hooks/useFocus/useFocus.cjs"),Te=require("./hooks/useHover/useHover.cjs"),Pe=require("./hooks/useImage/useImage.cjs"),Ce=require("./hooks/useLongPress/useLongPress.cjs"),r=require("./hooks/usePaint/usePaint.cjs"),Re=require("./hooks/useRightClick/useRightClick.cjs"),q=require("./hooks/useScript/useScript.cjs"),me=require("./hooks/useSticky/useSticky.cjs"),pe=require("./hooks/useTextDirection/useTextDirection.cjs"),ye=require("./hooks/useFul/useFul.cjs"),Ie=require("./hooks/useLess/useLess.cjs"),ke=require("./hooks/useOnce/useOnce.cjs"),ve=require("./hooks/useDidUpdate/useDidUpdate.cjs"),Oe=require("./hooks/useIsFirstRender/useIsFirstRender.cjs"),he=require("./hooks/useIsomorphicLayoutEffect/useIsomorphicLayoutEffect.cjs"),Ae=require("./hooks/useMount/useMount.cjs"),d=require("./hooks/useShallowEffect/useShallowEffect.cjs"),De=require("./hooks/useUnmount/useUnmount.cjs"),e=require("./hooks/useBreakpoints/useBreakpoints.cjs"),be=require("./hooks/useDeviceMotion/useDeviceMotion.cjs"),fe=require("./hooks/useDeviceOrientation/useDeviceOrientation.cjs"),Me=require("./hooks/useDevicePixelRatio/useDevicePixelRatio.cjs"),Le=require("./hooks/useDocumentEvent/useDocumentEvent.cjs"),_e=require("./hooks/useDocumentVisibility/useDocumentVisibility.cjs"),Ne=require("./hooks/useElementSize/useElementSize.cjs"),Be=require("./hooks/useEventListener/useEventListener.cjs"),g=require("./hooks/useHotkeys/useHotkeys.cjs"),Ke=require("./hooks/useIdle/useIdle.cjs"),Fe=require("./hooks/useInfiniteScroll/useInfiniteScroll.cjs"),Ve=require("./hooks/useIntersectionObserver/useIntersectionObserver.cjs"),Ue=require("./hooks/useKeyboard/useKeyboard.cjs"),we=require("./hooks/useKeyPress/useKeyPress.cjs"),We=require("./hooks/useKeyPressEvent/useKeyPressEvent.cjs"),He=require("./hooks/useKeysPressed/useKeysPressed.cjs"),xe=require("./hooks/useLockScroll/useLockScroll.cjs"),Qe=require("./hooks/useMeasure/useMeasure.cjs"),ze=require("./hooks/useMediaQuery/useMediaQuery.cjs"),Ge=require("./hooks/useMouse/useMouse.cjs"),Xe=require("./hooks/useMutationObserver/useMutationObserver.cjs"),Ze=require("./hooks/useOrientation/useOrientation.cjs"),je=require("./hooks/usePageLeave/usePageLeave.cjs"),Je=require("./hooks/useParallax/useParallax.cjs"),Ye=require("./hooks/usePerformanceObserver/usePerformanceObserver.cjs"),$e=require("./hooks/useResizeObserver/useResizeObserver.cjs"),es=require("./hooks/useScroll/useScroll.cjs"),ss=require("./hooks/useScrollIntoView/useScrollIntoView.cjs"),us=require("./hooks/useScrollTo/useScrollTo.cjs"),E=require("./hooks/useTextSelection/useTextSelection.cjs"),rs=require("./hooks/useWindowEvent/useWindowEvent.cjs"),ts=require("./hooks/useWindowFocus/useWindowFocus.cjs"),T=require("./hooks/useWindowScroll/useWindowScroll.cjs"),os=require("./hooks/useWindowSize/useWindowSize.cjs"),is=require("./hooks/useBoolean/useBoolean.cjs"),ns=require("./hooks/useControllableState/useControllableState.cjs"),s=require("./hooks/useCookie/useCookie.cjs"),P=require("./hooks/useCookies/useCookies.cjs"),cs=require("./hooks/useCounter/useCounter.cjs"),as=require("./hooks/useDefault/useDefault.cjs"),ls=require("./hooks/useDisclosure/useDisclosure.cjs"),Ss=require("./hooks/useField/useField.cjs"),qs=require("./hooks/useHash/useHash.cjs"),ds=require("./hooks/useList/useList.cjs"),gs=require("./hooks/useLocalStorage/useLocalStorage.cjs"),Es=require("./hooks/useMap/useMap.cjs"),t=require("./hooks/useMergedRef/useMergedRef.cjs"),Ts=require("./hooks/useOffsetPagination/useOffsetPagination.cjs"),Ps=require("./hooks/useQueue/useQueue.cjs"),Cs=require("./hooks/useRafState/useRafState.cjs"),Rs=require("./hooks/useRefState/useRefState.cjs"),ms=require("./hooks/useSessionStorage/useSessionStorage.cjs"),ps=require("./hooks/useSet/useSet.cjs"),C=require("./hooks/useStateHistory/useStateHistory.cjs"),ys=require("./hooks/useStep/useStep.cjs"),o=require("./hooks/useStorage/useStorage.cjs"),Is=require("./hooks/useToggle/useToggle.cjs"),u=require("./hooks/useUrlSearchParam/useUrlSearchParam.cjs"),ks=require("./hooks/useUrlSearchParams/useUrlSearchParams.cjs"),vs=require("./hooks/useWizard/useWizard.cjs"),Os=require("./hooks/useInterval/useInterval.cjs"),hs=require("./hooks/useStopwatch/useStopwatch.cjs"),As=require("./hooks/useTime/useTime.cjs"),Ds=require("./hooks/useTimeout/useTimeout.cjs"),R=require("./hooks/useTimer/useTimer.cjs"),bs=require("./hooks/useBrowserLanguage/useBrowserLanguage.cjs"),m=require("./hooks/useOperatingSystem/useOperatingSystem.cjs"),fs=require("./hooks/usePreferredColorScheme/usePreferredColorScheme.cjs"),Ms=require("./hooks/usePreferredContrast/usePreferredContrast.cjs"),Ls=require("./hooks/usePreferredDark/usePreferredDark.cjs"),_s=require("./hooks/usePreferredLanguages/usePreferredLanguages.cjs"),Ns=require("./hooks/usePreferredReducedMotion/usePreferredReducedMotion.cjs"),Bs=require("./hooks/useConst/useConst.cjs"),Ks=require("./hooks/useDebounceCallback/useDebounceCallback.cjs"),Fs=require("./hooks/useDebounceState/useDebounceState.cjs"),Vs=require("./hooks/useDebounceValue/useDebounceValue.cjs"),Us=require("./hooks/useEvent/useEvent.cjs"),ws=require("./hooks/useLastChanged/useLastChanged.cjs"),Ws=require("./hooks/useLatest/useLatest.cjs"),Hs=require("./hooks/usePrevious/usePrevious.cjs"),xs=require("./hooks/useThrottleCallback/useThrottleCallback.cjs"),Qs=require("./hooks/useThrottleState/useThrottleState.cjs"),zs=require("./hooks/useThrottleValue/useThrottleValue.cjs"),p=require("./utils/helpers/copy.cjs"),Gs=require("./utils/helpers/debounce.cjs"),Xs=require("./utils/helpers/getDate.cjs"),i=require("./utils/helpers/getElement.cjs"),Zs=require("./utils/helpers/getRetry.cjs"),js=require("./utils/helpers/isTarget.cjs"),Js=require("./utils/helpers/throttle.cjs");exports.createContext=y.createContext;exports.createEventEmitter=I.createEventEmitter;exports.createReactiveContext=k.createReactiveContext;exports.createStore=v.createStore;exports.useAsync=O.useAsync;exports.useLockCallback=h.useLockCallback;exports.useMutation=A.useMutation;exports.useOptimistic=D.useOptimistic;exports.useQuery=b.useQuery;exports.useAudio=f.useAudio;exports.useBattery=M.useBattery;exports.useBluetooth=L.useBluetooth;exports.useBroadcastChannel=_.useBroadcastChannel;exports.useClipboard=N.useClipboard;exports.useCopy=B.useCopy;exports.useCssVar=K.useCssVar;exports.useDisplayMedia=F.useDisplayMedia;exports.useDocumentTitle=V.useDocumentTitle;exports.useEventSource=U.useEventSource;exports.useEyeDropper=w.useEyeDropper;exports.useFavicon=W.useFavicon;exports.useFps=H.useFps;exports.useFullscreen=x.useFullscreen;exports.mapGamepadToXbox360Controller=n.mapGamepadToXbox360Controller;exports.useGamepad=n.useGamepad;exports.useGeolocation=Q.useGeolocation;exports.timeRangeToArray=c.timeRangeToArray;exports.useMediaControls=c.useMediaControls;exports.useMemory=z.useMemory;exports.getConnection=a.getConnection;exports.useNetwork=a.useNetwork;exports.useOnline=G.useOnline;exports.useOtpCredential=X.useOtpCredential;exports.usePermission=Z.usePermission;exports.usePictureInPicture=j.usePictureInPicture;exports.usePointerLock=J.usePointerLock;exports.usePostMessage=Y.usePostMessage;exports.useRaf=$.useRaf;exports.useShare=ee.useShare;exports.getSpeechRecognition=l.getSpeechRecognition;exports.useSpeechRecognition=l.useSpeechRecognition;exports.useSpeechSynthesis=se.useSpeechSynthesis;exports.useVibrate=ue.useVibrate;exports.useVirtualKeyboard=re.useVirtualKeyboard;exports.useWakeLock=te.useWakeLock;exports.useWebSocket=oe.useWebSocket;exports.useLogger=ie.useLogger;exports.useRenderCount=ne.useRenderCount;exports.useRenderInfo=ce.useRenderInfo;exports.useRerender=ae.useRerender;exports.useActiveElement=le.useActiveElement;exports.useAutoScroll=Se.useAutoScroll;exports.useClickOutside=qe.useClickOutside;exports.DEFAULT_THRESHOLD_TIME=S.DEFAULT_THRESHOLD_TIME;exports.useDoubleClick=S.useDoubleClick;exports.useDropZone=de.useDropZone;exports.useFileDialog=ge.useFileDialog;exports.useFocus=Ee.useFocus;exports.useHover=Te.useHover;exports.useImage=Pe.useImage;exports.useLongPress=Ce.useLongPress;exports.Paint=r.Paint;exports.Pointer=r.Pointer;exports.usePaint=r.usePaint;exports.useRightClick=Re.useRightClick;exports.SCRIPT_STATUS_ATTRIBUTE_NAME=q.SCRIPT_STATUS_ATTRIBUTE_NAME;exports.useScript=q.useScript;exports.useSticky=me.useSticky;exports.useTextDirection=pe.useTextDirection;exports.useFul=ye.useFul;exports.useLess=Ie.useLess;exports.useOnce=ke.useOnce;exports.useDidUpdate=ve.useDidUpdate;exports.useIsFirstRender=Oe.useIsFirstRender;exports.useIsomorphicLayoutEffect=he.useIsomorphicLayoutEffect;exports.useMount=Ae.useMount;exports.deepEqual=d.deepEqual;exports.useShallowEffect=d.useShallowEffect;exports.useUnmount=De.useUnmount;exports.BREAKPOINTS_ANT_DESIGN=e.BREAKPOINTS_ANT_DESIGN;exports.BREAKPOINTS_BOOTSTRAP_V5=e.BREAKPOINTS_BOOTSTRAP_V5;exports.BREAKPOINTS_MANTINE=e.BREAKPOINTS_MANTINE;exports.BREAKPOINTS_MASTER_CSS=e.BREAKPOINTS_MASTER_CSS;exports.BREAKPOINTS_MATERIAL_UI=e.BREAKPOINTS_MATERIAL_UI;exports.BREAKPOINTS_PRIME_FLEX=e.BREAKPOINTS_PRIME_FLEX;exports.BREAKPOINTS_QUASAR_V2=e.BREAKPOINTS_QUASAR_V2;exports.BREAKPOINTS_SEMANTIC=e.BREAKPOINTS_SEMANTIC;exports.BREAKPOINTS_TAILWIND=e.BREAKPOINTS_TAILWIND;exports.useBreakpoints=e.useBreakpoints;exports.useDeviceMotion=be.useDeviceMotion;exports.useDeviceOrientation=fe.useDeviceOrientation;exports.useDevicePixelRatio=Me.useDevicePixelRatio;exports.useDocumentEvent=Le.useDocumentEvent;exports.useDocumentVisibility=_e.useDocumentVisibility;exports.useElementSize=Ne.useElementSize;exports.useEventListener=Be.useEventListener;exports.isHotkeyMatch=g.isHotkeyMatch;exports.useHotkeys=g.useHotkeys;exports.useIdle=Ke.useIdle;exports.useInfiniteScroll=Fe.useInfiniteScroll;exports.useIntersectionObserver=Ve.useIntersectionObserver;exports.useKeyboard=Ue.useKeyboard;exports.useKeyPress=we.useKeyPress;exports.useKeyPressEvent=We.useKeyPressEvent;exports.useKeysPressed=He.useKeysPressed;exports.useLockScroll=xe.useLockScroll;exports.useMeasure=Qe.useMeasure;exports.useMediaQuery=ze.useMediaQuery;exports.useMouse=Ge.useMouse;exports.useMutationObserver=Xe.useMutationObserver;exports.useOrientation=Ze.useOrientation;exports.usePageLeave=je.usePageLeave;exports.useParallax=Je.useParallax;exports.usePerformanceObserver=Ye.usePerformanceObserver;exports.useResizeObserver=$e.useResizeObserver;exports.useScroll=es.useScroll;exports.useScrollIntoView=ss.useScrollIntoView;exports.useScrollTo=us.useScrollTo;exports.getRangesSelection=E.getRangesSelection;exports.useTextSelection=E.useTextSelection;exports.useWindowEvent=rs.useWindowEvent;exports.useWindowFocus=ts.useWindowFocus;exports.scrollTo=T.scrollTo;exports.useWindowScroll=T.useWindowScroll;exports.useWindowSize=os.useWindowSize;exports.useBoolean=is.useBoolean;exports.useControllableState=ns.useControllableState;exports.COOKIE_EVENT=s.COOKIE_EVENT;exports.dispatchCookieEvent=s.dispatchCookieEvent;exports.getCookie=s.getCookie;exports.getCookies=s.getCookies;exports.removeCookie=s.removeCookie;exports.removeCookieItem=s.removeCookieItem;exports.setCookie=s.setCookie;exports.setCookieItem=s.setCookieItem;exports.useCookie=s.useCookie;exports.clearCookies=P.clearCookies;exports.useCookies=P.useCookies;exports.useCounter=cs.useCounter;exports.useDefault=as.useDefault;exports.useDisclosure=ls.useDisclosure;exports.useField=Ss.useField;exports.useHash=qs.useHash;exports.useList=ds.useList;exports.useLocalStorage=gs.useLocalStorage;exports.useMap=Es.useMap;exports.assignRef=t.assignRef;exports.mergeRefs=t.mergeRefs;exports.useMergedRef=t.useMergedRef;exports.useOffsetPagination=Ts.useOffsetPagination;exports.useQueue=Ps.useQueue;exports.useRafState=Cs.useRafState;exports.useRefState=Rs.useRefState;exports.useSessionStorage=ms.useSessionStorage;exports.useSet=ps.useSet;exports.stateHistoryReducer=C.stateHistoryReducer;exports.useStateHistory=C.useStateHistory;exports.useStep=ys.useStep;exports.STORAGE_EVENT=o.STORAGE_EVENT;exports.dispatchStorageEvent=o.dispatchStorageEvent;exports.useStorage=o.useStorage;exports.useToggle=Is.useToggle;exports.URL_SEARCH_PARAMS_EVENT=u.URL_SEARCH_PARAMS_EVENT;exports.createQueryString=u.createQueryString;exports.dispatchUrlSearchParamsEvent=u.dispatchUrlSearchParamsEvent;exports.getUrlSearchParams=u.getUrlSearchParams;exports.useUrlSearchParam=u.useUrlSearchParam;exports.useUrlSearchParams=ks.useUrlSearchParams;exports.useWizard=vs.useWizard;exports.useInterval=Os.useInterval;exports.useStopwatch=hs.useStopwatch;exports.useTime=As.useTime;exports.useTimeout=Ds.useTimeout;exports.getTimeFromSeconds=R.getTimeFromSeconds;exports.useTimer=R.useTimer;exports.useBrowserLanguage=bs.useBrowserLanguage;exports.getOperatingSystem=m.getOperatingSystem;exports.useOperatingSystem=m.useOperatingSystem;exports.usePreferredColorScheme=fs.usePreferredColorScheme;exports.usePreferredContrast=Ms.usePreferredContrast;exports.usePreferredDark=Ls.usePreferredDark;exports.usePreferredLanguages=_s.usePreferredLanguages;exports.usePreferredReducedMotion=Ns.usePreferredReducedMotion;exports.useConst=Bs.useConst;exports.useDebounceCallback=Ks.useDebounceCallback;exports.useDebounceState=Fs.useDebounceState;exports.useDebounceValue=Vs.useDebounceValue;exports.useEvent=Us.useEvent;exports.useLastChanged=ws.useLastChanged;exports.useLatest=Ws.useLatest;exports.usePrevious=Hs.usePrevious;exports.useThrottleCallback=xs.useThrottleCallback;exports.useThrottleState=Qs.useThrottleState;exports.useThrottleValue=zs.useThrottleValue;exports.copy=p.copy;exports.legacyCopyToClipboard=p.legacyCopyToClipboard;exports.debounce=Gs.debounce;exports.getDate=Xs.getDate;exports.getElement=i.getElement;exports.target=i.target;exports.targetSymbol=i.targetSymbol;exports.getRetry=Zs.getRetry;exports.isTarget=js.isTarget;exports.throttle=Js.throttle;
 //# sourceMappingURL=index.cjs.map

package/dist/esm/hooks/useControllableState/useControllableState.mjs

@@ -0,0 +1,17 @@
+import { useState as C, useRef as S, useCallback as d } from "react";
+function v(l) {
+  const { value: o, initialValue: c, onChange: r } = l, t = o !== void 0, [u, i] = C(c), a = S(r);
+  a.current = r;
+  const e = t ? o : u, f = d(
+    (n) => {
+      const s = typeof n == "function" ? n(e) : n;
+      t || i(s), a.current?.(s);
+    },
+    [e, t]
+  );
+  return [e, f, t];
+}
+export {
+  v as useControllableState
+};
+//# sourceMappingURL=useControllableState.mjs.map

package/dist/esm/hooks/useControllableState/useControllableState.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"useControllableState.mjs","sources":["../../../../src/hooks/useControllableState/useControllableState.ts"],"sourcesContent":["import { useCallback, useRef, useState } from 'react';\n\n/** The use controllable state options type */\nexport interface UseControllableStateOptions<Value> {\n  /** The initial value for uncontrolled state */\n  initialValue?: Value;\n  /** The controlled value */\n  value?: Value;\n  /** The onChange callback */\n  onChange?: (value: Value) => void;\n}\n\n/** The use controllable state return type */\nexport type UseControllableStateReturn<Value> = [\n  /** Current value */\n  value: Value,\n  /** Setter function that works with both controlled and uncontrolled state */\n  setValue: (nextValue: ((prevValue: Value) => Value) | Value) => void,\n  /** Whether the state is controlled */\n  isControlled: boolean\n];\n\n/**\n * @name useControllableState\n * @description - Hook that manages both controlled and uncontrolled state patterns\n * @category State\n * @usage medium\n *\n * @template Value The type of the state value\n * @param {Value} [options.value] The controlled value. When provided, the component becomes controlled\n * @param {Value} [options.initialValue] The initial value for uncontrolled state\n * @param {(value: Value) => void} [options.onChange] The callback function called when the state changes\n * @returns {UseControllableStateReturn<Value>} A tuple containing the current value, setter function, and controlled flag\n *\n * @example\n * const [value, setValue, isControlled] = useControllableState({ initialValue: 'initial' });\n */\nexport function useControllableState<Value>(\n  options: UseControllableStateOptions<Value>\n): UseControllableStateReturn<Value> {\n  const { value, initialValue, onChange } = options;\n  const isControlled = value !== undefined;\n\n  const [internalState, setInternalState] = useState<Value>(initialValue as Value);\n\n  const onChangeRef = useRef(onChange);\n  onChangeRef.current = onChange;\n\n  const currentValue = isControlled ? value : internalState;\n\n  const setValue = useCallback(\n    (nextValue: ((prevValue: Value) => Value) | Value) => {\n      const resolvedValue =\n        typeof nextValue === 'function'\n          ? (nextValue as (prevValue: Value) => Value)(currentValue)\n          : nextValue;\n\n      if (!isControlled) setInternalState(resolvedValue);\n\n      onChangeRef.current?.(resolvedValue);\n    },\n    [currentValue, isControlled]\n  );\n\n  return [currentValue, setValue, isControlled];\n}\n"],"names":["useControllableState","options","value","initialValue","onChange","isControlled","internalState","setInternalState","useState","onChangeRef","useRef","currentValue","setValue","useCallback","nextValue","resolvedValue"],"mappings":";AAqCO,SAASA,EACdC,GACmC;AACnC,QAAM,EAAE,OAAAC,GAAO,cAAAC,GAAc,UAAAC,EAAA,IAAaH,GACpCI,IAAeH,MAAU,QAEzB,CAACI,GAAeC,CAAgB,IAAIC,EAAgBL,CAAqB,GAEzEM,IAAcC,EAAON,CAAQ;AACnC,EAAAK,EAAY,UAAUL;AAEtB,QAAMO,IAAeN,IAAeH,IAAQI,GAEtCM,IAAWC;AAAA,IACf,CAACC,MAAqD;AACpD,YAAMC,IACJ,OAAOD,KAAc,aAChBA,EAA0CH,CAAY,IACvDG;AAEN,MAAKT,KAAcE,EAAiBQ,CAAa,GAEjDN,EAAY,UAAUM,CAAa;AAAA,IAAA;AAAA,IAErC,CAACJ,GAAcN,CAAY;AAAA,EAAA;AAG7B,SAAO,CAACM,GAAcC,GAAUP,CAAY;AAC9C;"}

package/dist/esm/hooks/useScroll/useScroll.mjs

@@ -1,47 +1,65 @@
-import { useRef as T, useState as _, useEffect as j } from "react";
-import { useRefState as A } from "../useRefState/useRefState.mjs";
-import { isTarget as I } from "../../utils/helpers/isTarget.mjs";
-import { getElement as O } from "../../utils/helpers/getElement.mjs";
-const w = 1, V = (...t) => {
-  const r = I(t[0]) ? t[0] : void 0, u = r ? typeof t[1] == "object" ? t[1] : { onScroll: t[1] } : typeof t[0] == "object" ? t[0] : { onScroll: t[0] }, s = A(), d = T(u);
-  d.current = u;
-  const [m, g] = _(!1), l = T({ x: 0, y: 0 });
-  return j(() => {
-    if (!r && !s.state) return;
-    const i = (r ? O(r) : s.current) ?? window, p = (n) => {
-      g(!1), u?.onStop?.(n);
-    }, S = (n) => {
-      g(!0);
-      const e = n.target === document ? n.target.documentElement : n.target, { display: E, flexDirection: R, direction: D } = e.style, y = D === "rtl" ? -1 : 1, c = e.scrollLeft;
-      let o = e.scrollTop;
-      e instanceof Document && !o && (o = window.document.body.scrollTop);
-      const f = d.current?.offset, v = c * y <= (f?.left ?? 0), x = c * y + e.clientWidth >= e.scrollWidth - (f?.right ?? 0) - w, h = o <= (f?.top ?? 0), L = o + e.clientHeight >= e.scrollHeight - (f?.bottom ?? 0) - w, a = E === "flex" && R === "column-reverse", b = E === "flex" && R === "column-reverse", H = {
-        x: c,
-        y: o,
+import { useRef as S, useState as j, useEffect as A } from "react";
+import { useRefState as O } from "../useRefState/useRefState.mjs";
+import { isTarget as P } from "../../utils/helpers/isTarget.mjs";
+import { getElement as W } from "../../utils/helpers/getElement.mjs";
+const I = 1, q = (...o) => {
+  const c = P(o[0]) ? o[0] : void 0, g = c ? typeof o[1] == "object" ? o[1] : { onScroll: o[1] } : typeof o[0] == "object" ? o[0] : { onScroll: o[0] }, d = O(), p = S(g), f = S(null);
+  p.current = g;
+  const [E, R] = j(!1), u = S({ x: 0, y: 0 });
+  A(() => {
+    if (!c && !d.state) return;
+    const e = (c ? W(c) : d.current) ?? window;
+    f.current = e;
+    const l = (t) => {
+      R(!1), g?.onStop?.(t);
+    }, s = (t) => {
+      R(!0);
+      const r = t.target === document ? t.target.documentElement : t.target, { display: b, flexDirection: h, direction: V } = r.style, x = V === "rtl" ? -1 : 1, i = r.scrollLeft;
+      let n = r.scrollTop;
+      r instanceof Document && !n && (n = window.document.body.scrollTop);
+      const m = p.current?.offset, a = i * x <= (m?.left ?? 0), T = i * x + r.clientWidth >= r.scrollWidth - (m?.right ?? 0) - I, L = n <= (m?.top ?? 0), w = n + r.clientHeight >= r.scrollHeight - (m?.bottom ?? 0) - I, D = b === "flex" && h === "column-reverse", H = b === "flex" && h === "column-reverse", _ = {
+        x: i,
+        y: n,
         directions: {
-          left: c < l.current.x,
-          right: c > l.current.x,
-          top: o < l.current.y,
-          bottom: o > l.current.y
+          left: i < u.current.x,
+          right: i > u.current.x,
+          top: n < u.current.y,
+          bottom: n > u.current.y
         },
         arrived: {
-          left: b ? x : v,
-          right: b ? v : x,
-          top: a ? L : h,
-          bottom: a ? h : L
+          left: H ? T : a,
+          right: H ? a : T,
+          top: D ? w : L,
+          bottom: D ? L : w
         }
       };
-      l.current = { x: c, y: o }, d.current?.onScroll?.(H, n);
+      u.current = { x: i, y: n }, p.current?.onScroll?.(_, t);
     };
-    return i.addEventListener("scroll", S), i.addEventListener("scrollend", p), () => {
-      i.removeEventListener("scroll", S), i.removeEventListener("scrollend", p);
+    return e.addEventListener("scroll", s), e.addEventListener("scrollend", l), () => {
+      e.removeEventListener("scroll", s), e.removeEventListener("scrollend", l);
     };
-  }, [r, s.state]), r ? m : {
-    ref: s,
-    scrolling: m
+  }, [c, d.state]);
+  const v = (e) => {
+    if (!f.current) return;
+    const { behavior: l, block: s, inline: t } = e ?? {};
+    f.current.scrollIntoView({
+      behavior: l,
+      block: s,
+      inline: t
+    });
+  }, y = (e) => {
+    if (!f.current) return;
+    const { x: l, y: s, behavior: t } = e ?? {};
+    f.current.scrollTo({ left: l, top: s, behavior: t });
+  };
+  return c ? { scrollIntoView: v, scrollTo: y, scrolling: E } : {
+    ref: d,
+    scrolling: E,
+    scrollIntoView: v,
+    scrollTo: y
   };
 };
 export {
-  V as useScroll
+  q as useScroll
 };
 //# sourceMappingURL=useScroll.mjs.map

package/dist/esm/hooks/useScroll/useScroll.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"useScroll.mjs","sources":["../../../../src/hooks/useScroll/useScroll.ts"],"sourcesContent":["import { useEffect, useRef, useState } from 'react';\n\nimport type { HookTarget } from '@/utils/helpers';\n\nimport { getElement, isTarget } from '@/utils/helpers';\n\nimport type { StateRef } from '../useRefState/useRefState';\n\nimport { useRefState } from '../useRefState/useRefState';\n\nconst ARRIVED_STATE_THRESHOLD_PIXELS = 1;\n\nexport interface UseScrollOptions {\n  /** The on scroll callback */\n  onScroll?: (params: UseScrollCallbackParams, event: Event) => void;\n\n  /** The on end scroll callback */\n  onStop?: (event: Event) => void;\n\n  /** Offset arrived states by x pixels. */\n  offset?: {\n    left?: number;\n    right?: number;\n    top?: number;\n    bottom?: number;\n  };\n}\n\nexport interface UseScrollCallbackParams {\n  /** The element x position */\n  x: number;\n  /** The element y position */\n  y: number;\n  /** State of scroll arrived */\n  arrived: {\n    left: boolean;\n    right: boolean;\n    top: boolean;\n    bottom: boolean;\n  };\n  /** State of scroll direction */\n  directions: {\n    left: boolean;\n    right: boolean;\n    top: boolean;\n    bottom: boolean;\n  };\n}\n\nexport interface UseScroll {\n  (\n    target?: HookTarget,\n    callback?: (params: UseScrollCallbackParams, event: Event) => void\n  ): boolean;\n\n  (target?: HookTarget, options?: UseScrollOptions): boolean;\n\n  <Target extends Element>(\n    callback?: (params: UseScrollCallbackParams, event: Event) => void,\n    target?: never\n  ): {\n    ref: StateRef<Target>;\n    scrolling: boolean;\n  };\n\n  <Target extends Element>(\n    options?: UseScrollOptions,\n    target?: never\n  ): {\n    ref: StateRef<Target>;\n    scrolling: boolean;\n  };\n}\n\n/**\n * @name useScroll\n * @description - Hook that allows you to control scroll a element\n * @category Sensors\n * @usage low\n *\n * @overload\n * @template Target The target element\n * @param {ScrollBehavior} [options.behavior=auto] The behavior of scrolling\n * @param {number} [options.offset.left=0] The left offset for arrived states\n * @param {number} [options.offset.right=0]  The right offset for arrived states\n * @param {number} [options.offset.top=0] The top offset for arrived states\n * @param {number} [options.offset.bottom=0] The bottom offset for arrived states\n * @param {(params: UseScrollCallbackParams, event: Event) => void} [options.onScroll] The callback function to be invoked on scroll\n * @param {(event: Event) => void} [options.onStop] The callback function to be invoked on scroll end\n * @returns {boolean} The state of scrolling\n *\n * @example\n * const scrolling = useScroll(ref, options);\n *\n * @overload\n * @template Target The target element\n * @param {(params: UseScrollCallbackParams, event: Event) => void} [callback] The callback function to be invoked on scroll\n * @returns {boolean} The state of scrolling\n *\n * @example\n * const scrolling = useScroll(ref, () => console.log('callback'));\n *\n * @overload\n * @template Target The target element\n * @param {Target} [target=window] The target element to scroll\n * @param {ScrollBehavior} [options.behavior=auto] The behavior of scrolling\n * @param {number} [options.offset.left=0] The left offset for arrived states\n * @param {number} [options.offset.right=0]  The right offset for arrived states\n * @param {number} [options.offset.top=0] The top offset for arrived states\n * @param {number} [options.offset.bottom=0] The bottom offset for arrived states\n * @param {(params: UseScrollCallbackParams, event: Event) => void} [options.onScroll] The callback function to be invoked on scroll\n * @param {(event: Event) => void} [options.onStop] The callback function to be invoked on scroll end\n * @returns {[StateRef<Target>, boolean]} The state of scrolling\n *\n * @example\n * const { ref, scrolling } = useScroll(options);\n *\n * @overload\n * @template Target The target element\n * @param {Target} target The target element to scroll\n * @param {(params: UseScrollCallbackParams, event: Event) => void} [callback] The callback function to be invoked on scroll\n * @returns {[StateRef<Target>, boolean]} The state of scrolling\n *\n * @example\n * const { ref, scrolling } = useScroll(() => console.log('callback'));\n */\nexport const useScroll = ((...params: any[]) => {\n  const target = (isTarget(params[0]) ? params[0] : undefined) as HookTarget | undefined;\n  const options = (\n    target\n      ? typeof params[1] === 'object'\n        ? params[1]\n        : { onScroll: params[1] }\n      : typeof params[0] === 'object'\n        ? params[0]\n        : { onScroll: params[0] }\n  ) as UseScrollOptions | undefined;\n\n  const internalRef = useRefState<Element>();\n  const internalOptionsRef = useRef(options);\n  internalOptionsRef.current = options;\n\n  const [scrolling, setScrolling] = useState(false);\n  const scrollPositionRef = useRef({ x: 0, y: 0 });\n\n  useEffect(() => {\n    if (!target && !internalRef.state) return;\n    const element = ((target ? getElement(target) : internalRef.current) as Element) ?? window;\n\n    const onScrollEnd = (event: Event) => {\n      setScrolling(false);\n      options?.onStop?.(event);\n    };\n\n    const onScroll = (event: Event) => {\n      setScrolling(true);\n      const target = (\n        event.target === document ? (event.target as Document).documentElement : event.target\n      ) as HTMLElement;\n\n      const { display, flexDirection, direction } = target.style;\n      const directionMultiplier = direction === 'rtl' ? -1 : 1;\n\n      const scrollLeft = target.scrollLeft;\n      let scrollTop = target.scrollTop;\n      if (target instanceof Document && !scrollTop) scrollTop = window.document.body.scrollTop;\n\n      const offset = internalOptionsRef.current?.offset;\n      const left = scrollLeft * directionMultiplier <= (offset?.left ?? 0);\n      const right =\n        scrollLeft * directionMultiplier + target.clientWidth >=\n        target.scrollWidth - (offset?.right ?? 0) - ARRIVED_STATE_THRESHOLD_PIXELS;\n      const top = scrollTop <= (offset?.top ?? 0);\n      const bottom =\n        scrollTop + target.clientHeight >=\n        target.scrollHeight - (offset?.bottom ?? 0) - ARRIVED_STATE_THRESHOLD_PIXELS;\n\n      const isColumnReverse = display === 'flex' && flexDirection === 'column-reverse';\n      const isRowReverse = display === 'flex' && flexDirection === 'column-reverse';\n\n      const params = {\n        x: scrollLeft,\n        y: scrollTop,\n        directions: {\n          left: scrollLeft < scrollPositionRef.current.x,\n          right: scrollLeft > scrollPositionRef.current.x,\n          top: scrollTop < scrollPositionRef.current.y,\n          bottom: scrollTop > scrollPositionRef.current.y\n        },\n        arrived: {\n          left: isRowReverse ? right : left,\n          right: isRowReverse ? left : right,\n          top: isColumnReverse ? bottom : top,\n          bottom: isColumnReverse ? top : bottom\n        }\n      };\n\n      scrollPositionRef.current = { x: scrollLeft, y: scrollTop };\n      internalOptionsRef.current?.onScroll?.(params, event);\n    };\n\n    element.addEventListener('scroll', onScroll);\n    element.addEventListener('scrollend', onScrollEnd);\n\n    return () => {\n      element.removeEventListener('scroll', onScroll);\n      element.removeEventListener('scrollend', onScrollEnd);\n    };\n  }, [target, internalRef.state]);\n\n  if (target) return scrolling;\n  return {\n    ref: internalRef,\n    scrolling\n  };\n}) as UseScroll;\n"],"names":["ARRIVED_STATE_THRESHOLD_PIXELS","useScroll","params","target","isTarget","options","internalRef","useRefState","internalOptionsRef","useRef","scrolling","setScrolling","useState","scrollPositionRef","useEffect","element","getElement","onScrollEnd","event","onScroll","display","flexDirection","direction","directionMultiplier","scrollLeft","scrollTop","offset","left","right","top","bottom","isColumnReverse","isRowReverse"],"mappings":";;;;AAUA,MAAMA,IAAiC,GAoH1BC,IAAa,IAAIC,MAAkB;AAC9C,QAAMC,IAAUC,EAASF,EAAO,CAAC,CAAC,IAAIA,EAAO,CAAC,IAAI,QAC5CG,IACJF,IACI,OAAOD,EAAO,CAAC,KAAM,WACnBA,EAAO,CAAC,IACR,EAAE,UAAUA,EAAO,CAAC,EAAA,IACtB,OAAOA,EAAO,CAAC,KAAM,WACnBA,EAAO,CAAC,IACR,EAAE,UAAUA,EAAO,CAAC,EAAA,GAGtBI,IAAcC,EAAA,GACdC,IAAqBC,EAAOJ,CAAO;AACzC,EAAAG,EAAmB,UAAUH;AAE7B,QAAM,CAACK,GAAWC,CAAY,IAAIC,EAAS,EAAK,GAC1CC,IAAoBJ,EAAO,EAAE,GAAG,GAAG,GAAG,GAAG;AAmE/C,SAjEAK,EAAU,MAAM;AACd,QAAI,CAACX,KAAU,CAACG,EAAY,MAAO;AACnC,UAAMS,KAAYZ,IAASa,EAAWb,CAAM,IAAIG,EAAY,YAAwB,QAE9EW,IAAc,CAACC,MAAiB;AACpC,MAAAP,EAAa,EAAK,GAClBN,GAAS,SAASa,CAAK;AAAA,IAAA,GAGnBC,IAAW,CAACD,MAAiB;AACjC,MAAAP,EAAa,EAAI;AACjB,YAAMR,IACJe,EAAM,WAAW,WAAYA,EAAM,OAAoB,kBAAkBA,EAAM,QAG3E,EAAE,SAAAE,GAAS,eAAAC,GAAe,WAAAC,EAAA,IAAcnB,EAAO,OAC/CoB,IAAsBD,MAAc,QAAQ,KAAK,GAEjDE,IAAarB,EAAO;AAC1B,UAAIsB,IAAYtB,EAAO;AACvB,MAAIA,aAAkB,YAAY,CAACsB,MAAWA,IAAY,OAAO,SAAS,KAAK;AAE/E,YAAMC,IAASlB,EAAmB,SAAS,QACrCmB,IAAOH,IAAaD,MAAwBG,GAAQ,QAAQ,IAC5DE,IACJJ,IAAaD,IAAsBpB,EAAO,eAC1CA,EAAO,eAAeuB,GAAQ,SAAS,KAAK1B,GACxC6B,IAAMJ,MAAcC,GAAQ,OAAO,IACnCI,IACJL,IAAYtB,EAAO,gBACnBA,EAAO,gBAAgBuB,GAAQ,UAAU,KAAK1B,GAE1C+B,IAAkBX,MAAY,UAAUC,MAAkB,kBAC1DW,IAAeZ,MAAY,UAAUC,MAAkB,kBAEvDnB,IAAS;AAAA,QACb,GAAGsB;AAAA,QACH,GAAGC;AAAA,QACH,YAAY;AAAA,UACV,MAAMD,IAAaX,EAAkB,QAAQ;AAAA,UAC7C,OAAOW,IAAaX,EAAkB,QAAQ;AAAA,UAC9C,KAAKY,IAAYZ,EAAkB,QAAQ;AAAA,UAC3C,QAAQY,IAAYZ,EAAkB,QAAQ;AAAA,QAAA;AAAA,QAEhD,SAAS;AAAA,UACP,MAAMmB,IAAeJ,IAAQD;AAAA,UAC7B,OAAOK,IAAeL,IAAOC;AAAA,UAC7B,KAAKG,IAAkBD,IAASD;AAAA,UAChC,QAAQE,IAAkBF,IAAMC;AAAA,QAAA;AAAA,MAClC;AAGF,MAAAjB,EAAkB,UAAU,EAAE,GAAGW,GAAY,GAAGC,EAAA,GAChDjB,EAAmB,SAAS,WAAWN,GAAQgB,CAAK;AAAA,IAAA;AAGtD,WAAAH,EAAQ,iBAAiB,UAAUI,CAAQ,GAC3CJ,EAAQ,iBAAiB,aAAaE,CAAW,GAE1C,MAAM;AACX,MAAAF,EAAQ,oBAAoB,UAAUI,CAAQ,GAC9CJ,EAAQ,oBAAoB,aAAaE,CAAW;AAAA,IAAA;AAAA,EACtD,GACC,CAACd,GAAQG,EAAY,KAAK,CAAC,GAE1BH,IAAeO,IACZ;AAAA,IACL,KAAKJ;AAAA,IACL,WAAAI;AAAA,EAAA;AAEJ;"}
+{"version":3,"file":"useScroll.mjs","sources":["../../../../src/hooks/useScroll/useScroll.ts"],"sourcesContent":["import { useEffect, useRef, useState } from 'react';\n\nimport type { HookTarget } from '@/utils/helpers';\n\nimport { getElement, isTarget } from '@/utils/helpers';\n\nimport type { StateRef } from '../useRefState/useRefState';\n\nimport { useRefState } from '../useRefState/useRefState';\n\nconst ARRIVED_STATE_THRESHOLD_PIXELS = 1;\n\nexport interface UseScrollOptions {\n  /** The on scroll callback */\n  onScroll?: (params: UseScrollCallbackParams, event: Event) => void;\n\n  /** The on end scroll callback */\n  onStop?: (event: Event) => void;\n\n  /** Offset arrived states by x pixels. */\n  offset?: {\n    left?: number;\n    right?: number;\n    top?: number;\n    bottom?: number;\n  };\n}\n\nexport interface UseScrollCallbackParams {\n  /** The element x position */\n  x: number;\n  /** The element y position */\n  y: number;\n  /** State of scroll arrived */\n  arrived: {\n    left: boolean;\n    right: boolean;\n    top: boolean;\n    bottom: boolean;\n  };\n  /** State of scroll direction */\n  directions: {\n    left: boolean;\n    right: boolean;\n    top: boolean;\n    bottom: boolean;\n  };\n}\n\n/** The scroll into view params type */\nexport interface ScrollIntoViewParams {\n  behavior?: ScrollBehavior;\n  block?: ScrollLogicalPosition;\n  inline?: ScrollLogicalPosition;\n}\n/** The scroll to params type */\nexport interface ScrollToParams {\n  behavior?: ScrollBehavior;\n  x: number;\n  y: number;\n}\n\n/** The use scroll return type */\nexport interface UseScrollReturn {\n  /** The state of scrolling */\n  scrolling: boolean;\n  /** Function to scroll element into view */\n  scrollIntoView: (params?: ScrollIntoViewParams) => void;\n  /** Function to scroll element to a specific position */\n  scrollTo: (params?: ScrollToParams) => void;\n}\n\nexport interface UseScroll {\n  (\n    target?: HookTarget,\n    callback?: (params: UseScrollCallbackParams, event: Event) => void\n  ): UseScrollReturn;\n\n  (target?: HookTarget, options?: UseScrollOptions): UseScrollReturn;\n\n  <Target extends Element>(\n    callback?: (params: UseScrollCallbackParams, event: Event) => void,\n    target?: never\n  ): UseScrollReturn & { ref: StateRef<Target> };\n\n  <Target extends Element>(\n    options?: UseScrollOptions,\n    target?: never\n  ): UseScrollReturn & {\n    ref: StateRef<Target>;\n  };\n}\n\n/**\n * @name useScroll\n * @description - Hook that allows you to control scroll a element\n * @category Sensors\n * @usage low\n *\n * @overload\n * @template Target The target element\n * @param {ScrollBehavior} [options.behavior=auto] The behavior of scrolling\n * @param {number} [options.offset.left=0] The left offset for arrived states\n * @param {number} [options.offset.right=0]  The right offset for arrived states\n * @param {number} [options.offset.top=0] The top offset for arrived states\n * @param {number} [options.offset.bottom=0] The bottom offset for arrived states\n * @param {(params: UseScrollCallbackParams, event: Event) => void} [options.onScroll] The callback function to be invoked on scroll\n * @param {(event: Event) => void} [options.onStop] The callback function to be invoked on scroll end\n * @returns {UseScrollReturn} The state of scrolling\n *\n * @example\n * const { scrolling, scrollIntoView, scrollTo} = useScroll(ref, options);\n *\n * @overload\n * @template Target The target element\n * @param {(params: UseScrollCallbackParams, event: Event) => void} [callback] The callback function to be invoked on scroll\n * @returns {UseScrollReturn} The state of scrolling\n *\n * @example\n * const { scrolling, scrollIntoView, scrollTo} = useScroll(ref, () => console.log('callback'));\n *\n * @overload\n * @template Target The target element\n * @param {Target} [target=window] The target element to scroll\n * @param {ScrollBehavior} [options.behavior=auto] The behavior of scrolling\n * @param {number} [options.offset.left=0] The left offset for arrived states\n * @param {number} [options.offset.right=0]  The right offset for arrived states\n * @param {number} [options.offset.top=0] The top offset for arrived states\n * @param {number} [options.offset.bottom=0] The bottom offset for arrived states\n * @param {(params: UseScrollCallbackParams, event: Event) => void} [options.onScroll] The callback function to be invoked on scroll\n * @param {(event: Event) => void} [options.onStop] The callback function to be invoked on scroll end\n * @returns {UseScrollReturn & { ref: StateRef<Target> }} The state of scrolling\n *\n * @example\n * const { ref, scrolling, scrollIntoView, scrollTo} = useScroll(options);\n *\n * @overload\n * @template Target The target element\n * @param {Target} target The target element to scroll\n * @param {(params: UseScrollCallbackParams, event: Event) => void} [callback] The callback function to be invoked on scroll\n * @returns {UseScrollReturn & { ref: StateRef<Target> }} The state of scrolling\n *\n * @example\n * const { ref, scrolling, scrollIntoView, scrollTo} = useScroll(() => console.log('callback'));\n */\nexport const useScroll = ((...params: any[]) => {\n  const target = (isTarget(params[0]) ? params[0] : undefined) as HookTarget | undefined;\n  const options = (\n    target\n      ? typeof params[1] === 'object'\n        ? params[1]\n        : { onScroll: params[1] }\n      : typeof params[0] === 'object'\n        ? params[0]\n        : { onScroll: params[0] }\n  ) as UseScrollOptions | undefined;\n\n  const internalRef = useRefState<Element>();\n  const internalOptionsRef = useRef(options);\n  const elementRef = useRef<Element>(null);\n  internalOptionsRef.current = options;\n\n  const [scrolling, setScrolling] = useState(false);\n  const scrollPositionRef = useRef({ x: 0, y: 0 });\n\n  useEffect(() => {\n    if (!target && !internalRef.state) return;\n    const element = ((target ? getElement(target) : internalRef.current) as Element) ?? window;\n\n    elementRef.current = element;\n\n    const onScrollEnd = (event: Event) => {\n      setScrolling(false);\n      options?.onStop?.(event);\n    };\n\n    const onScroll = (event: Event) => {\n      setScrolling(true);\n      const target = (\n        event.target === document ? (event.target as Document).documentElement : event.target\n      ) as HTMLElement;\n\n      const { display, flexDirection, direction } = target.style;\n      const directionMultiplier = direction === 'rtl' ? -1 : 1;\n\n      const scrollLeft = target.scrollLeft;\n      let scrollTop = target.scrollTop;\n      if (target instanceof Document && !scrollTop) scrollTop = window.document.body.scrollTop;\n\n      const offset = internalOptionsRef.current?.offset;\n      const left = scrollLeft * directionMultiplier <= (offset?.left ?? 0);\n      const right =\n        scrollLeft * directionMultiplier + target.clientWidth >=\n        target.scrollWidth - (offset?.right ?? 0) - ARRIVED_STATE_THRESHOLD_PIXELS;\n      const top = scrollTop <= (offset?.top ?? 0);\n      const bottom =\n        scrollTop + target.clientHeight >=\n        target.scrollHeight - (offset?.bottom ?? 0) - ARRIVED_STATE_THRESHOLD_PIXELS;\n\n      const isColumnReverse = display === 'flex' && flexDirection === 'column-reverse';\n      const isRowReverse = display === 'flex' && flexDirection === 'column-reverse';\n\n      const params = {\n        x: scrollLeft,\n        y: scrollTop,\n        directions: {\n          left: scrollLeft < scrollPositionRef.current.x,\n          right: scrollLeft > scrollPositionRef.current.x,\n          top: scrollTop < scrollPositionRef.current.y,\n          bottom: scrollTop > scrollPositionRef.current.y\n        },\n        arrived: {\n          left: isRowReverse ? right : left,\n          right: isRowReverse ? left : right,\n          top: isColumnReverse ? bottom : top,\n          bottom: isColumnReverse ? top : bottom\n        }\n      };\n\n      scrollPositionRef.current = { x: scrollLeft, y: scrollTop };\n      internalOptionsRef.current?.onScroll?.(params, event);\n    };\n\n    element.addEventListener('scroll', onScroll);\n    element.addEventListener('scrollend', onScrollEnd);\n\n    return () => {\n      element.removeEventListener('scroll', onScroll);\n      element.removeEventListener('scrollend', onScrollEnd);\n    };\n  }, [target, internalRef.state]);\n\n  const scrollIntoView = (params?: {\n    behavior?: ScrollBehavior;\n    block?: ScrollLogicalPosition;\n    inline?: ScrollLogicalPosition;\n  }) => {\n    if (!elementRef.current) return;\n\n    const { behavior, block, inline } = params ?? {};\n\n    elementRef.current.scrollIntoView({\n      behavior,\n      block,\n      inline\n    });\n  };\n\n  const scrollTo = (params?: { x: number; y: number; behavior?: ScrollBehavior }) => {\n    if (!elementRef.current) return;\n\n    const { x, y, behavior } = params ?? {};\n\n    elementRef.current.scrollTo({ left: x, top: y, behavior });\n  };\n\n  if (target) return { scrollIntoView, scrollTo, scrolling };\n  return {\n    ref: internalRef,\n    scrolling,\n    scrollIntoView,\n    scrollTo\n  };\n}) as UseScroll;\n"],"names":["ARRIVED_STATE_THRESHOLD_PIXELS","useScroll","params","target","isTarget","options","internalRef","useRefState","internalOptionsRef","useRef","elementRef","scrolling","setScrolling","useState","scrollPositionRef","useEffect","element","getElement","onScrollEnd","event","onScroll","display","flexDirection","direction","directionMultiplier","scrollLeft","scrollTop","offset","left","right","top","bottom","isColumnReverse","isRowReverse","scrollIntoView","behavior","block","inline","scrollTo","x","y"],"mappings":";;;;AAUA,MAAMA,IAAiC,GAuI1BC,IAAa,IAAIC,MAAkB;AAC9C,QAAMC,IAAUC,EAASF,EAAO,CAAC,CAAC,IAAIA,EAAO,CAAC,IAAI,QAC5CG,IACJF,IACI,OAAOD,EAAO,CAAC,KAAM,WACnBA,EAAO,CAAC,IACR,EAAE,UAAUA,EAAO,CAAC,EAAA,IACtB,OAAOA,EAAO,CAAC,KAAM,WACnBA,EAAO,CAAC,IACR,EAAE,UAAUA,EAAO,CAAC,EAAA,GAGtBI,IAAcC,EAAA,GACdC,IAAqBC,EAAOJ,CAAO,GACnCK,IAAaD,EAAgB,IAAI;AACvC,EAAAD,EAAmB,UAAUH;AAE7B,QAAM,CAACM,GAAWC,CAAY,IAAIC,EAAS,EAAK,GAC1CC,IAAoBL,EAAO,EAAE,GAAG,GAAG,GAAG,GAAG;AAE/C,EAAAM,EAAU,MAAM;AACd,QAAI,CAACZ,KAAU,CAACG,EAAY,MAAO;AACnC,UAAMU,KAAYb,IAASc,EAAWd,CAAM,IAAIG,EAAY,YAAwB;AAEpF,IAAAI,EAAW,UAAUM;AAErB,UAAME,IAAc,CAACC,MAAiB;AACpC,MAAAP,EAAa,EAAK,GAClBP,GAAS,SAASc,CAAK;AAAA,IAAA,GAGnBC,IAAW,CAACD,MAAiB;AACjC,MAAAP,EAAa,EAAI;AACjB,YAAMT,IACJgB,EAAM,WAAW,WAAYA,EAAM,OAAoB,kBAAkBA,EAAM,QAG3E,EAAE,SAAAE,GAAS,eAAAC,GAAe,WAAAC,EAAA,IAAcpB,EAAO,OAC/CqB,IAAsBD,MAAc,QAAQ,KAAK,GAEjDE,IAAatB,EAAO;AAC1B,UAAIuB,IAAYvB,EAAO;AACvB,MAAIA,aAAkB,YAAY,CAACuB,MAAWA,IAAY,OAAO,SAAS,KAAK;AAE/E,YAAMC,IAASnB,EAAmB,SAAS,QACrCoB,IAAOH,IAAaD,MAAwBG,GAAQ,QAAQ,IAC5DE,IACJJ,IAAaD,IAAsBrB,EAAO,eAC1CA,EAAO,eAAewB,GAAQ,SAAS,KAAK3B,GACxC8B,IAAMJ,MAAcC,GAAQ,OAAO,IACnCI,IACJL,IAAYvB,EAAO,gBACnBA,EAAO,gBAAgBwB,GAAQ,UAAU,KAAK3B,GAE1CgC,IAAkBX,MAAY,UAAUC,MAAkB,kBAC1DW,IAAeZ,MAAY,UAAUC,MAAkB,kBAEvDpB,IAAS;AAAA,QACb,GAAGuB;AAAA,QACH,GAAGC;AAAA,QACH,YAAY;AAAA,UACV,MAAMD,IAAaX,EAAkB,QAAQ;AAAA,UAC7C,OAAOW,IAAaX,EAAkB,QAAQ;AAAA,UAC9C,KAAKY,IAAYZ,EAAkB,QAAQ;AAAA,UAC3C,QAAQY,IAAYZ,EAAkB,QAAQ;AAAA,QAAA;AAAA,QAEhD,SAAS;AAAA,UACP,MAAMmB,IAAeJ,IAAQD;AAAA,UAC7B,OAAOK,IAAeL,IAAOC;AAAA,UAC7B,KAAKG,IAAkBD,IAASD;AAAA,UAChC,QAAQE,IAAkBF,IAAMC;AAAA,QAAA;AAAA,MAClC;AAGF,MAAAjB,EAAkB,UAAU,EAAE,GAAGW,GAAY,GAAGC,EAAA,GAChDlB,EAAmB,SAAS,WAAWN,GAAQiB,CAAK;AAAA,IAAA;AAGtD,WAAAH,EAAQ,iBAAiB,UAAUI,CAAQ,GAC3CJ,EAAQ,iBAAiB,aAAaE,CAAW,GAE1C,MAAM;AACX,MAAAF,EAAQ,oBAAoB,UAAUI,CAAQ,GAC9CJ,EAAQ,oBAAoB,aAAaE,CAAW;AAAA,IAAA;AAAA,EACtD,GACC,CAACf,GAAQG,EAAY,KAAK,CAAC;AAE9B,QAAM4B,IAAiB,CAAChC,MAIlB;AACJ,QAAI,CAACQ,EAAW,QAAS;AAEzB,UAAM,EAAE,UAAAyB,GAAU,OAAAC,GAAO,QAAAC,EAAA,IAAWnC,KAAU,CAAA;AAE9C,IAAAQ,EAAW,QAAQ,eAAe;AAAA,MAChC,UAAAyB;AAAA,MACA,OAAAC;AAAA,MACA,QAAAC;AAAA,IAAA,CACD;AAAA,EAAA,GAGGC,IAAW,CAACpC,MAAiE;AACjF,QAAI,CAACQ,EAAW,QAAS;AAEzB,UAAM,EAAE,GAAA6B,GAAG,GAAAC,GAAG,UAAAL,EAAA,IAAajC,KAAU,CAAA;AAErC,IAAAQ,EAAW,QAAQ,SAAS,EAAE,MAAM6B,GAAG,KAAKC,GAAG,UAAAL,GAAU;AAAA,EAAA;AAG3D,SAAIhC,IAAe,EAAE,gBAAA+B,GAAgB,UAAAI,GAAU,WAAA3B,EAAA,IACxC;AAAA,IACL,KAAKL;AAAA,IACL,WAAAK;AAAA,IACA,gBAAAuB;AAAA,IACA,UAAAI;AAAA,EAAA;AAEJ;"}

package/dist/esm/index.mjs

@@ -8,13 +8,13 @@ import { useMutation as l } from "./hooks/useMutation/useMutation.mjs";
 import { useOptimistic as E } from "./hooks/useOptimistic/useOptimistic.mjs";
 import { useQuery as g } from "./hooks/useQuery/useQuery.mjs";
 import { useAudio as R } from "./hooks/useAudio/useAudio.mjs";
-import { useBattery as C } from "./hooks/useBattery/useBattery.mjs";
+import { useBattery as P } from "./hooks/useBattery/useBattery.mjs";
 import { useBluetooth as A } from "./hooks/useBluetooth/useBluetooth.mjs";
 import { useBroadcastChannel as O } from "./hooks/useBroadcastChannel/useBroadcastChannel.mjs";
 import { useClipboard as h } from "./hooks/useClipboard/useClipboard.mjs";
 import { useCopy as _ } from "./hooks/useCopy/useCopy.mjs";
 import { useCssVar as M } from "./hooks/useCssVar/useCssVar.mjs";
-import { useDisplayMedia as b } from "./hooks/useDisplayMedia/useDisplayMedia.mjs";
+import { useDisplayMedia as L } from "./hooks/useDisplayMedia/useDisplayMedia.mjs";
 import { useDocumentTitle as B } from "./hooks/useDocumentTitle/useDocumentTitle.mjs";
 import { useEventSource as F } from "./hooks/useEventSource/useEventSource.mjs";
 import { useEyeDropper as V } from "./hooks/useEyeDropper/useEyeDropper.mjs";
@@ -33,13 +33,13 @@ import { usePictureInPicture as ce } from "./hooks/usePictureInPicture/usePictur
 import { usePointerLock as Se } from "./hooks/usePointerLock/usePointerLock.mjs";
 import { usePostMessage as Te } from "./hooks/usePostMessage/usePostMessage.mjs";
 import { useRaf as de } from "./hooks/useRaf/useRaf.mjs";
-import { useShare as Pe } from "./hooks/useShare/useShare.mjs";
+import { useShare as Ce } from "./hooks/useShare/useShare.mjs";
 import { getSpeechRecognition as Ie, useSpeechRecognition as Ae } from "./hooks/useSpeechRecognition/useSpeechRecognition.mjs";
 import { useSpeechSynthesis as Oe } from "./hooks/useSpeechSynthesis/useSpeechSynthesis.mjs";
 import { useVibrate as he } from "./hooks/useVibrate/useVibrate.mjs";
 import { useVirtualKeyboard as _e } from "./hooks/useVirtualKeyboard/useVirtualKeyboard.mjs";
 import { useWakeLock as Me } from "./hooks/useWakeLock/useWakeLock.mjs";
-import { useWebSocket as be } from "./hooks/useWebSocket/useWebSocket.mjs";
+import { useWebSocket as Le } from "./hooks/useWebSocket/useWebSocket.mjs";
 import { useLogger as Be } from "./hooks/useLogger/useLogger.mjs";
 import { useRenderCount as Fe } from "./hooks/useRenderCount/useRenderCount.mjs";
 import { useRenderInfo as Ve } from "./hooks/useRenderInfo/useRenderInfo.mjs";
@@ -57,13 +57,13 @@ import { useLongPress as xo } from "./hooks/useLongPress/useLongPress.mjs";
 import { Paint as io, Pointer as no, usePaint as co } from "./hooks/usePaint/usePaint.mjs";
 import { useRightClick as So } from "./hooks/useRightClick/useRightClick.mjs";
 import { SCRIPT_STATUS_ATTRIBUTE_NAME as To, useScript as go } from "./hooks/useScript/useScript.mjs";
-import { useSticky as Po } from "./hooks/useSticky/useSticky.mjs";
+import { useSticky as Co } from "./hooks/useSticky/useSticky.mjs";
 import { useTextDirection as Io } from "./hooks/useTextDirection/useTextDirection.mjs";
 import { useFul as yo } from "./hooks/useFul/useFul.mjs";
 import { useLess as ko } from "./hooks/useLess/useLess.mjs";
 import { useOnce as vo } from "./hooks/useOnce/useOnce.mjs";
 import { useDidUpdate as Do } from "./hooks/useDidUpdate/useDidUpdate.mjs";
-import { useIsFirstRender as Lo } from "./hooks/useIsFirstRender/useIsFirstRender.mjs";
+import { useIsFirstRender as bo } from "./hooks/useIsFirstRender/useIsFirstRender.mjs";
 import { useIsomorphicLayoutEffect as No } from "./hooks/useIsomorphicLayoutEffect/useIsomorphicLayoutEffect.mjs";
 import { useMount as Ko } from "./hooks/useMount/useMount.mjs";
 import { deepEqual as Uo, useShallowEffect as Vo } from "./hooks/useShallowEffect/useShallowEffect.mjs";
@@ -79,13 +79,13 @@ import { useEventListener as cr } from "./hooks/useEventListener/useEventListene
 import { isHotkeyMatch as Sr, useHotkeys as Er } from "./hooks/useHotkeys/useHotkeys.mjs";
 import { useIdle as gr } from "./hooks/useIdle/useIdle.mjs";
 import { useInfiniteScroll as Rr } from "./hooks/useInfiniteScroll/useInfiniteScroll.mjs";
-import { useIntersectionObserver as Cr } from "./hooks/useIntersectionObserver/useIntersectionObserver.mjs";
+import { useIntersectionObserver as Pr } from "./hooks/useIntersectionObserver/useIntersectionObserver.mjs";
 import { useKeyboard as Ar } from "./hooks/useKeyboard/useKeyboard.mjs";
 import { useKeyPress as Or } from "./hooks/useKeyPress/useKeyPress.mjs";
 import { useKeyPressEvent as hr } from "./hooks/useKeyPressEvent/useKeyPressEvent.mjs";
 import { useKeysPressed as _r } from "./hooks/useKeysPressed/useKeysPressed.mjs";
 import { useLockScroll as Mr } from "./hooks/useLockScroll/useLockScroll.mjs";
-import { useMeasure as br } from "./hooks/useMeasure/useMeasure.mjs";
+import { useMeasure as Lr } from "./hooks/useMeasure/useMeasure.mjs";
 import { useMediaQuery as Br } from "./hooks/useMediaQuery/useMediaQuery.mjs";
 import { useMouse as Fr } from "./hooks/useMouse/useMouse.mjs";
 import { useMutationObserver as Vr } from "./hooks/useMutationObserver/useMutationObserver.mjs";
@@ -103,60 +103,61 @@ import { useWindowFocus as xt } from "./hooks/useWindowFocus/useWindowFocus.mjs"
 import { scrollTo as it, useWindowScroll as nt } from "./hooks/useWindowScroll/useWindowScroll.mjs";
 import { useWindowSize as lt } from "./hooks/useWindowSize/useWindowSize.mjs";
 import { useBoolean as Et } from "./hooks/useBoolean/useBoolean.mjs";
-import { COOKIE_EVENT as gt, dispatchCookieEvent as dt, getCookie as Rt, getCookies as Pt, removeCookie as Ct, removeCookieItem as It, setCookie as At, setCookieItem as yt, useCookie as Ot } from "./hooks/useCookie/useCookie.mjs";
-import { clearCookies as ht, useCookies as vt } from "./hooks/useCookies/useCookies.mjs";
-import { useCounter as Dt } from "./hooks/useCounter/useCounter.mjs";
-import { useDefault as Lt } from "./hooks/useDefault/useDefault.mjs";
-import { useDisclosure as Nt } from "./hooks/useDisclosure/useDisclosure.mjs";
-import { useField as Kt } from "./hooks/useField/useField.mjs";
-import { useHash as Ut } from "./hooks/useHash/useHash.mjs";
-import { useList as wt } from "./hooks/useList/useList.mjs";
-import { useLocalStorage as Wt } from "./hooks/useLocalStorage/useLocalStorage.mjs";
-import { useMap as Qt } from "./hooks/useMap/useMap.mjs";
-import { assignRef as Xt, mergeRefs as qt, useMergedRef as Zt } from "./hooks/useMergedRef/useMergedRef.mjs";
-import { useOffsetPagination as Jt } from "./hooks/useOffsetPagination/useOffsetPagination.mjs";
-import { useQueue as $t } from "./hooks/useQueue/useQueue.mjs";
-import { useRafState as os } from "./hooks/useRafState/useRafState.mjs";
-import { useRefState as ts } from "./hooks/useRefState/useRefState.mjs";
-import { useSessionStorage as ms } from "./hooks/useSessionStorage/useSessionStorage.mjs";
-import { useSet as ps } from "./hooks/useSet/useSet.mjs";
-import { stateHistoryReducer as xs, useStateHistory as as } from "./hooks/useStateHistory/useStateHistory.mjs";
-import { useStep as ns } from "./hooks/useStep/useStep.mjs";
-import { STORAGE_EVENT as ls, dispatchStorageEvent as Ss, useStorage as Es } from "./hooks/useStorage/useStorage.mjs";
-import { useToggle as gs } from "./hooks/useToggle/useToggle.mjs";
-import { URL_SEARCH_PARAMS_EVENT as Rs, createQueryString as Ps, dispatchUrlSearchParamsEvent as Cs, getUrlSearchParams as Is, useUrlSearchParam as As } from "./hooks/useUrlSearchParam/useUrlSearchParam.mjs";
-import { useUrlSearchParams as Os } from "./hooks/useUrlSearchParams/useUrlSearchParams.mjs";
-import { useWizard as hs } from "./hooks/useWizard/useWizard.mjs";
-import { useInterval as _s } from "./hooks/useInterval/useInterval.mjs";
-import { useStopwatch as Ms } from "./hooks/useStopwatch/useStopwatch.mjs";
-import { useTime as bs } from "./hooks/useTime/useTime.mjs";
-import { useTimeout as Bs } from "./hooks/useTimeout/useTimeout.mjs";
-import { getTimeFromSeconds as Fs, useTimer as Us } from "./hooks/useTimer/useTimer.mjs";
-import { useBrowserLanguage as ws } from "./hooks/useBrowserLanguage/useBrowserLanguage.mjs";
-import { getOperatingSystem as Ws, useOperatingSystem as Gs } from "./hooks/useOperatingSystem/useOperatingSystem.mjs";
-import { usePreferredColorScheme as zs } from "./hooks/usePreferredColorScheme/usePreferredColorScheme.mjs";
-import { usePreferredContrast as qs } from "./hooks/usePreferredContrast/usePreferredContrast.mjs";
-import { usePreferredDark as js } from "./hooks/usePreferredDark/usePreferredDark.mjs";
-import { usePreferredLanguages as Ys } from "./hooks/usePreferredLanguages/usePreferredLanguages.mjs";
-import { usePreferredReducedMotion as em } from "./hooks/usePreferredReducedMotion/usePreferredReducedMotion.mjs";
-import { useConst as rm } from "./hooks/useConst/useConst.mjs";
-import { useDebounceCallback as sm } from "./hooks/useDebounceCallback/useDebounceCallback.mjs";
-import { useDebounceState as um } from "./hooks/useDebounceState/useDebounceState.mjs";
-import { useDebounceValue as fm } from "./hooks/useDebounceValue/useDebounceValue.mjs";
-import { useEvent as am } from "./hooks/useEvent/useEvent.mjs";
-import { useLastChanged as nm } from "./hooks/useLastChanged/useLastChanged.mjs";
-import { useLatest as lm } from "./hooks/useLatest/useLatest.mjs";
-import { usePrevious as Em } from "./hooks/usePrevious/usePrevious.mjs";
-import { useThrottleCallback as gm } from "./hooks/useThrottleCallback/useThrottleCallback.mjs";
-import { useThrottleState as Rm } from "./hooks/useThrottleState/useThrottleState.mjs";
-import { useThrottleValue as Cm } from "./hooks/useThrottleValue/useThrottleValue.mjs";
-import { copy as Am, legacyCopyToClipboard as ym } from "./utils/helpers/copy.mjs";
-import { debounce as km } from "./utils/helpers/debounce.mjs";
-import { getDate as vm } from "./utils/helpers/getDate.mjs";
-import { getElement as Dm, target as Mm, targetSymbol as Lm } from "./utils/helpers/getElement.mjs";
-import { getRetry as Nm } from "./utils/helpers/getRetry.mjs";
-import { isTarget as Km } from "./utils/helpers/isTarget.mjs";
-import { throttle as Um } from "./utils/helpers/throttle.mjs";
+import { useControllableState as gt } from "./hooks/useControllableState/useControllableState.mjs";
+import { COOKIE_EVENT as Rt, dispatchCookieEvent as Ct, getCookie as Pt, getCookies as It, removeCookie as At, removeCookieItem as yt, setCookie as Ot, setCookieItem as kt, useCookie as ht } from "./hooks/useCookie/useCookie.mjs";
+import { clearCookies as _t, useCookies as Dt } from "./hooks/useCookies/useCookies.mjs";
+import { useCounter as bt } from "./hooks/useCounter/useCounter.mjs";
+import { useDefault as Nt } from "./hooks/useDefault/useDefault.mjs";
+import { useDisclosure as Kt } from "./hooks/useDisclosure/useDisclosure.mjs";
+import { useField as Ut } from "./hooks/useField/useField.mjs";
+import { useHash as wt } from "./hooks/useHash/useHash.mjs";
+import { useList as Wt } from "./hooks/useList/useList.mjs";
+import { useLocalStorage as Qt } from "./hooks/useLocalStorage/useLocalStorage.mjs";
+import { useMap as Xt } from "./hooks/useMap/useMap.mjs";
+import { assignRef as Zt, mergeRefs as jt, useMergedRef as Jt } from "./hooks/useMergedRef/useMergedRef.mjs";
+import { useOffsetPagination as $t } from "./hooks/useOffsetPagination/useOffsetPagination.mjs";
+import { useQueue as os } from "./hooks/useQueue/useQueue.mjs";
+import { useRafState as ts } from "./hooks/useRafState/useRafState.mjs";
+import { useRefState as ms } from "./hooks/useRefState/useRefState.mjs";
+import { useSessionStorage as ps } from "./hooks/useSessionStorage/useSessionStorage.mjs";
+import { useSet as xs } from "./hooks/useSet/useSet.mjs";
+import { stateHistoryReducer as is, useStateHistory as ns } from "./hooks/useStateHistory/useStateHistory.mjs";
+import { useStep as ls } from "./hooks/useStep/useStep.mjs";
+import { STORAGE_EVENT as Es, dispatchStorageEvent as Ts, useStorage as gs } from "./hooks/useStorage/useStorage.mjs";
+import { useToggle as Rs } from "./hooks/useToggle/useToggle.mjs";
+import { URL_SEARCH_PARAMS_EVENT as Ps, createQueryString as Is, dispatchUrlSearchParamsEvent as As, getUrlSearchParams as ys, useUrlSearchParam as Os } from "./hooks/useUrlSearchParam/useUrlSearchParam.mjs";
+import { useUrlSearchParams as hs } from "./hooks/useUrlSearchParams/useUrlSearchParams.mjs";
+import { useWizard as _s } from "./hooks/useWizard/useWizard.mjs";
+import { useInterval as Ms } from "./hooks/useInterval/useInterval.mjs";
+import { useStopwatch as Ls } from "./hooks/useStopwatch/useStopwatch.mjs";
+import { useTime as Bs } from "./hooks/useTime/useTime.mjs";
+import { useTimeout as Fs } from "./hooks/useTimeout/useTimeout.mjs";
+import { getTimeFromSeconds as Vs, useTimer as ws } from "./hooks/useTimer/useTimer.mjs";
+import { useBrowserLanguage as Ws } from "./hooks/useBrowserLanguage/useBrowserLanguage.mjs";
+import { getOperatingSystem as Qs, useOperatingSystem as zs } from "./hooks/useOperatingSystem/useOperatingSystem.mjs";
+import { usePreferredColorScheme as qs } from "./hooks/usePreferredColorScheme/usePreferredColorScheme.mjs";
+import { usePreferredContrast as js } from "./hooks/usePreferredContrast/usePreferredContrast.mjs";
+import { usePreferredDark as Ys } from "./hooks/usePreferredDark/usePreferredDark.mjs";
+import { usePreferredLanguages as em } from "./hooks/usePreferredLanguages/usePreferredLanguages.mjs";
+import { usePreferredReducedMotion as rm } from "./hooks/usePreferredReducedMotion/usePreferredReducedMotion.mjs";
+import { useConst as sm } from "./hooks/useConst/useConst.mjs";
+import { useDebounceCallback as um } from "./hooks/useDebounceCallback/useDebounceCallback.mjs";
+import { useDebounceState as fm } from "./hooks/useDebounceState/useDebounceState.mjs";
+import { useDebounceValue as am } from "./hooks/useDebounceValue/useDebounceValue.mjs";
+import { useEvent as nm } from "./hooks/useEvent/useEvent.mjs";
+import { useLastChanged as lm } from "./hooks/useLastChanged/useLastChanged.mjs";
+import { useLatest as Em } from "./hooks/useLatest/useLatest.mjs";
+import { usePrevious as gm } from "./hooks/usePrevious/usePrevious.mjs";
+import { useThrottleCallback as Rm } from "./hooks/useThrottleCallback/useThrottleCallback.mjs";
+import { useThrottleState as Pm } from "./hooks/useThrottleState/useThrottleState.mjs";
+import { useThrottleValue as Am } from "./hooks/useThrottleValue/useThrottleValue.mjs";
+import { copy as Om, legacyCopyToClipboard as km } from "./utils/helpers/copy.mjs";
+import { debounce as vm } from "./utils/helpers/debounce.mjs";
+import { getDate as Dm } from "./utils/helpers/getDate.mjs";
+import { getElement as bm, target as Lm, targetSymbol as Nm } from "./utils/helpers/getElement.mjs";
+import { getRetry as Km } from "./utils/helpers/getRetry.mjs";
+import { isTarget as Um } from "./utils/helpers/isTarget.mjs";
+import { throttle as wm } from "./utils/helpers/throttle.mjs";
 export {
   Go as BREAKPOINTS_ANT_DESIGN,
   Qo as BREAKPOINTS_BOOTSTRAP_V5,
@@ -167,92 +168,93 @@ export {
   jo as BREAKPOINTS_QUASAR_V2,
   Jo as BREAKPOINTS_SEMANTIC,
   Yo as BREAKPOINTS_TAILWIND,
-  gt as COOKIE_EVENT,
+  Rt as COOKIE_EVENT,
   je as DEFAULT_THRESHOLD_TIME,
   io as Paint,
   no as Pointer,
   To as SCRIPT_STATUS_ATTRIBUTE_NAME,
-  ls as STORAGE_EVENT,
-  Rs as URL_SEARCH_PARAMS_EVENT,
-  Xt as assignRef,
-  ht as clearCookies,
-  Am as copy,
+  Es as STORAGE_EVENT,
+  Ps as URL_SEARCH_PARAMS_EVENT,
+  Zt as assignRef,
+  _t as clearCookies,
+  Om as copy,
   r as createContext,
   s as createEventEmitter,
-  Ps as createQueryString,
+  Is as createQueryString,
   u as createReactiveContext,
   f as createStore,
-  km as debounce,
+  vm as debounce,
   Uo as deepEqual,
-  dt as dispatchCookieEvent,
-  Ss as dispatchStorageEvent,
-  Cs as dispatchUrlSearchParamsEvent,
+  Ct as dispatchCookieEvent,
+  Ts as dispatchStorageEvent,
+  As as dispatchUrlSearchParamsEvent,
   se as getConnection,
-  Rt as getCookie,
-  Pt as getCookies,
-  vm as getDate,
-  Dm as getElement,
-  Ws as getOperatingSystem,
+  Pt as getCookie,
+  It as getCookies,
+  Dm as getDate,
+  bm as getElement,
+  Qs as getOperatingSystem,
   st as getRangesSelection,
-  Nm as getRetry,
+  Km as getRetry,
   Ie as getSpeechRecognition,
-  Fs as getTimeFromSeconds,
-  Is as getUrlSearchParams,
+  Vs as getTimeFromSeconds,
+  ys as getUrlSearchParams,
   Sr as isHotkeyMatch,
-  Km as isTarget,
-  ym as legacyCopyToClipboard,
+  Um as isTarget,
+  km as legacyCopyToClipboard,
   q as mapGamepadToXbox360Controller,
-  qt as mergeRefs,
-  Ct as removeCookie,
-  It as removeCookieItem,
+  jt as mergeRefs,
+  At as removeCookie,
+  yt as removeCookieItem,
   it as scrollTo,
-  At as setCookie,
-  yt as setCookieItem,
-  xs as stateHistoryReducer,
-  Mm as target,
-  Lm as targetSymbol,
-  Um as throttle,
+  Ot as setCookie,
+  kt as setCookieItem,
+  is as stateHistoryReducer,
+  Lm as target,
+  Nm as targetSymbol,
+  wm as throttle,
   $ as timeRangeToArray,
   Ge as useActiveElement,
   a as useAsync,
   R as useAudio,
   ze as useAutoScroll,
-  C as useBattery,
+  P as useBattery,
   A as useBluetooth,
   Et as useBoolean,
   $o as useBreakpoints,
   O as useBroadcastChannel,
-  ws as useBrowserLanguage,
+  Ws as useBrowserLanguage,
   qe as useClickOutside,
   h as useClipboard,
-  rm as useConst,
-  Ot as useCookie,
-  vt as useCookies,
+  sm as useConst,
+  gt as useControllableState,
+  ht as useCookie,
+  Dt as useCookies,
   _ as useCopy,
-  Dt as useCounter,
+  bt as useCounter,
   M as useCssVar,
-  sm as useDebounceCallback,
-  um as useDebounceState,
-  fm as useDebounceValue,
-  Lt as useDefault,
+  um as useDebounceCallback,
+  fm as useDebounceState,
+  am as useDebounceValue,
+  Nt as useDefault,
   or as useDeviceMotion,
   tr as useDeviceOrientation,
   mr as useDevicePixelRatio,
   Do as useDidUpdate,
-  Nt as useDisclosure,
-  b as useDisplayMedia,
+  Kt as useDisclosure,
+  L as useDisplayMedia,
   pr as useDocumentEvent,
   B as useDocumentTitle,
   xr as useDocumentVisibility,
   Je as useDoubleClick,
   $e as useDropZone,
   ir as useElementSize,
-  am as useEvent,
+  nm as useEvent,
   cr as useEventListener,
   F as useEventSource,
   V as useEyeDropper,
   H as useFavicon,
-  Kt as useField,
+  Ut as useField,
   oo as useFileDialog,
   to as useFocus,
   G as useFps,
@@ -260,44 +262,44 @@ export {
   z as useFullscreen,
   Z as useGamepad,
   J as useGeolocation,
-  Ut as useHash,
+  wt as useHash,
   Er as useHotkeys,
   mo as useHover,
   gr as useIdle,
   po as useImage,
   Rr as useInfiniteScroll,
-  Cr as useIntersectionObserver,
-  _s as useInterval,
-  Lo as useIsFirstRender,
+  Pr as useIntersectionObserver,
+  Ms as useInterval,
+  bo as useIsFirstRender,
   No as useIsomorphicLayoutEffect,
   Or as useKeyPress,
   hr as useKeyPressEvent,
   Ar as useKeyboard,
   _r as useKeysPressed,
-  nm as useLastChanged,
-  lm as useLatest,
+  lm as useLastChanged,
+  Em as useLatest,
   ko as useLess,
-  wt as useList,
-  Wt as useLocalStorage,
+  Wt as useList,
+  Qt as useLocalStorage,
   n as useLockCallback,
   Mr as useLockScroll,
   Be as useLogger,
   xo as useLongPress,
-  Qt as useMap,
-  br as useMeasure,
+  Xt as useMap,
+  Lr as useMeasure,
   ee as useMediaControls,
   Br as useMediaQuery,
   re as useMemory,
-  Zt as useMergedRef,
+  Jt as useMergedRef,
   Ko as useMount,
   Fr as useMouse,
   l as useMutation,
   Vr as useMutationObserver,
   me as useNetwork,
-  Jt as useOffsetPagination,
+  $t as useOffsetPagination,
   vo as useOnce,
   pe as useOnline,
-  Gs as useOperatingSystem,
+  zs as useOperatingSystem,
   E as useOptimistic,
   Hr as useOrientation,
   xe as useOtpCredential,
@@ -309,17 +311,17 @@ export {
   ce as usePictureInPicture,
   Se as usePointerLock,
   Te as usePostMessage,
-  zs as usePreferredColorScheme,
-  qs as usePreferredContrast,
-  js as usePreferredDark,
-  Ys as usePreferredLanguages,
-  em as usePreferredReducedMotion,
-  Em as usePrevious,
+  qs as usePreferredColorScheme,
+  js as usePreferredContrast,
+  Ys as usePreferredDark,
+  em as usePreferredLanguages,
+  rm as usePreferredReducedMotion,
+  gm as usePrevious,
   g as useQuery,
-  $t as useQueue,
+  os as useQueue,
   de as useRaf,
-  os as useRafState,
-  ts as useRefState,
+  ts as useRafState,
+  ms as useRefState,
   Fe as useRenderCount,
   Ve as useRenderInfo,
   He as useRerender,
@@ -329,37 +331,37 @@ export {
   Yr as useScroll,
   et as useScrollIntoView,
   rt as useScrollTo,
-  ms as useSessionStorage,
-  ps as useSet,
+  ps as useSessionStorage,
+  xs as useSet,
   Vo as useShallowEffect,
-  Pe as useShare,
+  Ce as useShare,
   Ae as useSpeechRecognition,
   Oe as useSpeechSynthesis,
-  as as useStateHistory,
-  ns as useStep,
-  Po as useSticky,
-  Ms as useStopwatch,
-  Es as useStorage,
+  ns as useStateHistory,
+  ls as useStep,
+  Co as useSticky,
+  Ls as useStopwatch,
+  gs as useStorage,
   Io as useTextDirection,
   mt as useTextSelection,
-  gm as useThrottleCallback,
-  Rm as useThrottleState,
-  Cm as useThrottleValue,
-  bs as useTime,
-  Bs as useTimeout,
-  Us as useTimer,
-  gs as useToggle,
+  Rm as useThrottleCallback,
+  Pm as useThrottleState,
+  Am as useThrottleValue,
+  Bs as useTime,
+  Fs as useTimeout,
+  ws as useTimer,
+  Rs as useToggle,
   Ho as useUnmount,
-  As as useUrlSearchParam,
-  Os as useUrlSearchParams,
+  Os as useUrlSearchParam,
+  hs as useUrlSearchParams,
   he as useVibrate,
   _e as useVirtualKeyboard,
   Me as useWakeLock,
-  be as useWebSocket,
+  Le as useWebSocket,
   pt as useWindowEvent,
   xt as useWindowFocus,
   nt as useWindowScroll,
   lt as useWindowSize,
-  hs as useWizard
+  _s as useWizard
 };
 //# sourceMappingURL=index.mjs.map

package/dist/esm/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}
+{"version":3,"file":"index.mjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}

package/dist/types/hooks/state.d.ts

@@ -1,4 +1,5 @@
 export * from './useBoolean/useBoolean';
+export * from './useControllableState/useControllableState';
 export * from './useCookie/useCookie';
 export * from './useCookies/useCookies';
 export * from './useCounter/useCounter';

package/dist/types/hooks/useControllableState/useControllableState.d.ts

@@ -0,0 +1,34 @@
+/** The use controllable state options type */
+export interface UseControllableStateOptions<Value> {
+    /** The initial value for uncontrolled state */
+    initialValue?: Value;
+    /** The controlled value */
+    value?: Value;
+    /** The onChange callback */
+    onChange?: (value: Value) => void;
+}
+/** The use controllable state return type */
+export type UseControllableStateReturn<Value> = [
+    /** Current value */
+    value: Value,
+    /** Setter function that works with both controlled and uncontrolled state */
+    setValue: (nextValue: ((prevValue: Value) => Value) | Value) => void,
+    /** Whether the state is controlled */
+    isControlled: boolean
+];
+/**
+ * @name useControllableState
+ * @description - Hook that manages both controlled and uncontrolled state patterns
+ * @category State
+ * @usage medium
+ *
+ * @template Value The type of the state value
+ * @param {Value} [options.value] The controlled value. When provided, the component becomes controlled
+ * @param {Value} [options.initialValue] The initial value for uncontrolled state
+ * @param {(value: Value) => void} [options.onChange] The callback function called when the state changes
+ * @returns {UseControllableStateReturn<Value>} A tuple containing the current value, setter function, and controlled flag
+ *
+ * @example
+ * const [value, setValue, isControlled] = useControllableState({ initialValue: 'initial' });
+ */
+export declare function useControllableState<Value>(options: UseControllableStateOptions<Value>): UseControllableStateReturn<Value>;

package/dist/types/hooks/useScroll/useScroll.d.ts

@@ -33,16 +33,35 @@ export interface UseScrollCallbackParams {
         bottom: boolean;
     };
 }
+/** The scroll into view params type */
+export interface ScrollIntoViewParams {
+    behavior?: ScrollBehavior;
+    block?: ScrollLogicalPosition;
+    inline?: ScrollLogicalPosition;
+}
+/** The scroll to params type */
+export interface ScrollToParams {
+    behavior?: ScrollBehavior;
+    x: number;
+    y: number;
+}
+/** The use scroll return type */
+export interface UseScrollReturn {
+    /** The state of scrolling */
+    scrolling: boolean;
+    /** Function to scroll element into view */
+    scrollIntoView: (params?: ScrollIntoViewParams) => void;
+    /** Function to scroll element to a specific position */
+    scrollTo: (params?: ScrollToParams) => void;
+}
 export interface UseScroll {
-    (target?: HookTarget, callback?: (params: UseScrollCallbackParams, event: Event) => void): boolean;
-    (target?: HookTarget, options?: UseScrollOptions): boolean;
-    <Target extends Element>(callback?: (params: UseScrollCallbackParams, event: Event) => void, target?: never): {
+    (target?: HookTarget, callback?: (params: UseScrollCallbackParams, event: Event) => void): UseScrollReturn;
+    (target?: HookTarget, options?: UseScrollOptions): UseScrollReturn;
+    <Target extends Element>(callback?: (params: UseScrollCallbackParams, event: Event) => void, target?: never): UseScrollReturn & {
         ref: StateRef<Target>;
-        scrolling: boolean;
     };
-    <Target extends Element>(options?: UseScrollOptions, target?: never): {
+    <Target extends Element>(options?: UseScrollOptions, target?: never): UseScrollReturn & {
         ref: StateRef<Target>;
-        scrolling: boolean;
     };
 }
 /**
@@ -60,18 +79,18 @@ export interface UseScroll {
  * @param {number} [options.offset.bottom=0] The bottom offset for arrived states
  * @param {(params: UseScrollCallbackParams, event: Event) => void} [options.onScroll] The callback function to be invoked on scroll
  * @param {(event: Event) => void} [options.onStop] The callback function to be invoked on scroll end
- * @returns {boolean} The state of scrolling
+ * @returns {UseScrollReturn} The state of scrolling
  *
  * @example
- * const scrolling = useScroll(ref, options);
+ * const { scrolling, scrollIntoView, scrollTo} = useScroll(ref, options);
  *
  * @overload
  * @template Target The target element
  * @param {(params: UseScrollCallbackParams, event: Event) => void} [callback] The callback function to be invoked on scroll
- * @returns {boolean} The state of scrolling
+ * @returns {UseScrollReturn} The state of scrolling
  *
  * @example
- * const scrolling = useScroll(ref, () => console.log('callback'));
+ * const { scrolling, scrollIntoView, scrollTo} = useScroll(ref, () => console.log('callback'));
  *
  * @overload
  * @template Target The target element
@@ -83,18 +102,18 @@ export interface UseScroll {
  * @param {number} [options.offset.bottom=0] The bottom offset for arrived states
  * @param {(params: UseScrollCallbackParams, event: Event) => void} [options.onScroll] The callback function to be invoked on scroll
  * @param {(event: Event) => void} [options.onStop] The callback function to be invoked on scroll end
- * @returns {[StateRef<Target>, boolean]} The state of scrolling
+ * @returns {UseScrollReturn & { ref: StateRef<Target> }} The state of scrolling
  *
  * @example
- * const { ref, scrolling } = useScroll(options);
+ * const { ref, scrolling, scrollIntoView, scrollTo} = useScroll(options);
  *
  * @overload
  * @template Target The target element
  * @param {Target} target The target element to scroll
  * @param {(params: UseScrollCallbackParams, event: Event) => void} [callback] The callback function to be invoked on scroll
- * @returns {[StateRef<Target>, boolean]} The state of scrolling
+ * @returns {UseScrollReturn & { ref: StateRef<Target> }} The state of scrolling
  *
  * @example
- * const { ref, scrolling } = useScroll(() => console.log('callback'));
+ * const { ref, scrolling, scrollIntoView, scrollTo} = useScroll(() => console.log('callback'));
  */
 export declare const useScroll: UseScroll;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@siberiacancode/reactuse",
-  "version": "0.2.31",
+  "version": "0.2.32",
   "description": "The ultimate collection of react hooks",
   "author": {
     "name": "SIBERIA CAN CODE 🧊",