@zayne-labs/toolkit-react 0.10.22 → 0.10.24

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,3 +1,3 @@
1
- import { ContextError, createCustomContext, createUseLocationState, createUseStorageState, getErrorMessage, useAfterMountEffect, useAnimateElementRefs, useAnimationInterval, useAsyncEffect, useCallbackRef, useClickOutside, useConstant, useCopyToClipboard, useDebouncedFn, useDebouncedState, useDisclosure, useEffectOnce, useIsHydrated, useIsServer, useLazyRef, useLifeCycle, useLocationState, useMountEffect, usePresence, useScrollObserver, useSearch, useSearchParams, useSearchParamsObject, useShallowComparedSelector, useShallowComparedValue, useStorageState, useStore, useThrottleByFrame, useThrottleBySetTimeout, useThrottleByTimer, useToggle, useUnmountEffect } from "../hooks-DuWtaFqu.js";
1
+ import { ContextError, createCustomContext, createUseLocationState, createUseStorageState, getErrorMessage, useAfterMountEffect, useAnimateElementRefs, useAnimationInterval, useAsyncEffect, useCallbackRef, useClickOutside, useConstant, useCopyToClipboard, useDebouncedFn, useDebouncedState, useDisclosure, useEffectOnce, useIsHydrated, useIsServer, useLazyRef, useLifeCycle, useLocationState, useMountEffect, usePresence, useScrollObserver, useSearch, useSearchParams, useSearchParamsObject, useShallowComparedSelector, useShallowComparedValue, useStorageState, useStore, useThrottleByFrame, useThrottleBySetTimeout, useThrottleByTimer, useToggle, useUnmountEffect } from "../hooks-CJPA1jR-.js";
2
2
 
3
3
  export { ContextError, createCustomContext, createUseLocationState, createUseStorageState, getErrorMessage, useAfterMountEffect, useAnimateElementRefs, useAnimationInterval, useAsyncEffect, useCallbackRef, useClickOutside, useConstant, useCopyToClipboard, useDebouncedFn, useDebouncedState, useDisclosure, useEffectOnce, useIsHydrated, useIsServer, useLazyRef, useLifeCycle, useLocationState, useMountEffect, usePresence, useScrollObserver, useSearch, useSearchParams, useSearchParamsObject, useShallowComparedSelector, useShallowComparedValue, useStorageState, useStore, useThrottleByFrame, useThrottleBySetTimeout, useThrottleByTimer, useToggle, useUnmountEffect };
@@ -147,25 +147,16 @@ const useAnimateElementRefs = (elementsInfoArray) => {
147
147
  };
148
148
  };
149
149
 
150
- //#endregion
151
- //#region src/hooks/useConstant.ts
152
- const useConstant = (initCallbackFn) => {
153
- const resultRef = useRef(null);
154
- if (resultRef.current === null) resultRef.current = initCallbackFn();
155
- return resultRef.current;
156
- };
157
- const useLazyRef = (initCallbackFn) => {
158
- const resultRef = useRef(null);
159
- if (resultRef.current === null) resultRef.current = initCallbackFn();
160
- return resultRef;
161
- };
162
-
163
150
  //#endregion
164
151
  //#region src/hooks/useAnimationInterval.ts
165
152
  const useAnimationInterval = (options) => {
166
153
  const { intervalDuration, onAnimation, once } = options;
167
154
  const latestCallback = useCallbackRef(onAnimation);
168
- const { start, stop } = useConstant(() => setAnimationInterval(latestCallback, intervalDuration, { once }));
155
+ const { start, stop } = useMemo(() => setAnimationInterval(latestCallback, intervalDuration, { once }), [
156
+ intervalDuration,
157
+ latestCallback,
158
+ once
159
+ ]);
169
160
  useEffect(() => {
170
161
  if (intervalDuration === null) return;
171
162
  start();
@@ -196,6 +187,19 @@ const useClickOutside = (options) => {
196
187
  return { ref: innerRef };
197
188
  };
198
189
 
190
+ //#endregion
191
+ //#region src/hooks/useConstant.ts
192
+ const useConstant = (initCallbackFn) => {
193
+ const resultRef = useRef(null);
194
+ if (resultRef.current === null) resultRef.current = initCallbackFn();
195
+ return resultRef.current;
196
+ };
197
+ const useLazyRef = (initCallbackFn) => {
198
+ const resultRef = useRef(null);
199
+ if (resultRef.current === null) resultRef.current = initCallbackFn();
200
+ return resultRef;
201
+ };
202
+
199
203
  //#endregion
200
204
  //#region src/hooks/useCopyToClipboard.ts
201
205
  const useCopyToClipboard = () => {
@@ -214,7 +218,7 @@ const useCopyToClipboard = () => {
214
218
  //#region src/hooks/useDebounce.ts
215
219
  const useDebouncedFn = (callBackFn, delay) => {
216
220
  const latestCallback = useCallbackRef(callBackFn);
217
- const debouncedFn = useConstant(() => debounce(latestCallback, delay));
221
+ const debouncedFn = useMemo(() => debounce(latestCallback, delay), [delay, latestCallback]);
218
222
  useUnmountEffect(() => {
219
223
  debouncedFn.cancel();
220
224
  debouncedFn.cancelMaxWait();
@@ -223,7 +227,7 @@ const useDebouncedFn = (callBackFn, delay) => {
223
227
  };
224
228
  const useDebouncedState = (defaultValue, delay) => {
225
229
  const [value, setValue] = useState(defaultValue);
226
- const setDebouncedValue = useConstant(() => debounce(setValue, delay));
230
+ const setDebouncedValue = useMemo(() => debounce(setValue, delay), [delay]);
227
231
  useUnmountEffect(() => {
228
232
  setDebouncedValue.cancel();
229
233
  setDebouncedValue.cancelMaxWait();
@@ -353,8 +357,10 @@ const createUseLocationState = (options) => {
353
357
  Object.assign(useLocationState$1, locationStore);
354
358
  return useLocationState$1;
355
359
  };
356
- const useLocationState = (selector, options) => {
357
- const locationStore = useConstant(() => createLocationStore(options));
360
+ const useLocationState = (selector, options = {}) => {
361
+ const { equalityFn } = options;
362
+ const savedEqualityFn = useCallbackRef(equalityFn);
363
+ const locationStore = useMemo(() => createLocationStore({ equalityFn: savedEqualityFn }), [savedEqualityFn]);
358
364
  const stateSlice = useStore(locationStore, selector);
359
365
  return [stateSlice, locationStore];
360
366
  };
@@ -468,10 +474,10 @@ const usePresence = (options = {}) => {
468
474
  //#endregion
469
475
  //#region src/hooks/useScrollObserver.ts
470
476
  const useScrollObserver = (options = {}) => {
471
- const { onIntersection, rootMargin = "10px 0px 0px 0px",...restOfOptions } = options;
477
+ const { onIntersection, root, rootMargin = "10px 0px 0px 0px", threshold } = options;
472
478
  const [isScrolled, setIsScrolled] = useState(false);
473
479
  const savedOnIntersection = useCallbackRef(onIntersection);
474
- const { handleObservation } = useConstant(() => {
480
+ const { handleObservation } = useMemo(() => {
475
481
  return createScrollObserver({
476
482
  onIntersection: (entry, observer) => {
477
483
  const newIsScrolledState = !entry.isIntersecting;
@@ -479,10 +485,16 @@ const useScrollObserver = (options = {}) => {
479
485
  entry.target.dataset.scrolled = String(newIsScrolledState);
480
486
  savedOnIntersection(entry, observer);
481
487
  },
488
+ root,
482
489
  rootMargin,
483
- ...restOfOptions
490
+ threshold
484
491
  });
485
- });
492
+ }, [
493
+ root,
494
+ rootMargin,
495
+ savedOnIntersection,
496
+ threshold
497
+ ]);
486
498
  const observedElementRef = useCallbackRef((element) => {
487
499
  const cleanupFn = handleObservation(element);
488
500
  if (!element) {
@@ -587,14 +599,35 @@ const createUseStorageState = (baseOptions) => {
587
599
  return useStorageState$1;
588
600
  };
589
601
  const useStorageState = (key, initialValue, options) => {
590
- const { select,...restOfOptions } = options ?? {};
591
- const externalStore = useConstant(() => {
602
+ const { equalityFn, logger, parser, partialize, select, serializer, storageArea, syncStateAcrossTabs } = options ?? {};
603
+ const savedEquality = useCallbackRef(equalityFn);
604
+ const savedLogger = useCallbackRef(logger);
605
+ const savedParser = useCallbackRef(parser);
606
+ const savedPartialize = useCallbackRef(partialize);
607
+ const savedSerializer = useCallbackRef(serializer);
608
+ const externalStore = useMemo(() => {
592
609
  return createExternalStorageStore({
610
+ equalityFn: savedEquality,
593
611
  initialValue,
594
612
  key,
595
- ...restOfOptions
613
+ logger: savedLogger,
614
+ parser: savedParser,
615
+ partialize: savedPartialize,
616
+ serializer: savedSerializer,
617
+ storageArea,
618
+ syncStateAcrossTabs
596
619
  });
597
- });
620
+ }, [
621
+ initialValue,
622
+ key,
623
+ savedEquality,
624
+ savedLogger,
625
+ savedParser,
626
+ savedPartialize,
627
+ savedSerializer,
628
+ storageArea,
629
+ syncStateAcrossTabs
630
+ ]);
598
631
  const stateInStorage = useStore(externalStore, select);
599
632
  return [stateInStorage, externalStore];
600
633
  };
@@ -603,13 +636,13 @@ const useStorageState = (key, initialValue, options) => {
603
636
  //#region src/hooks/useThrottle.ts
604
637
  const useThrottleBySetTimeout = (callbackFn, delay) => {
605
638
  const latestCallback = useCallbackRef(callbackFn);
606
- const throttledCallback = useConstant(() => throttleBySetTimeout(latestCallback, delay));
639
+ const throttledCallback = useMemo(() => throttleBySetTimeout(latestCallback, delay), [delay, latestCallback]);
607
640
  useUnmountEffect(() => throttledCallback.cancelTimeout());
608
641
  return throttledCallback;
609
642
  };
610
643
  const useThrottleByTimer = (callbackFn, delay) => {
611
644
  const latestCallback = useCallbackRef(callbackFn);
612
- const throttledCallback = useConstant(() => throttleByTime(latestCallback, delay));
645
+ const throttledCallback = useMemo(() => throttleByTime(latestCallback, delay), [delay, latestCallback]);
613
646
  return throttledCallback;
614
647
  };
615
648
  const useThrottleByFrame = (callbackFn) => {
@@ -621,4 +654,4 @@ const useThrottleByFrame = (callbackFn) => {
621
654
 
622
655
  //#endregion
623
656
  export { ContextError, createCustomContext, createUseLocationState, createUseStorageState, getErrorMessage, useAfterMountEffect, useAnimateElementRefs, useAnimationInterval, useAsyncEffect, useCallbackRef, useClickOutside, useConstant, useCopyToClipboard, useDebouncedFn, useDebouncedState, useDisclosure, useEffectOnce, useIsHydrated, useIsServer, useLazyRef, useLifeCycle, useLocationState, useMountEffect, usePresence, useScrollObserver, useSearch, useSearchParams, useSearchParamsObject, useShallowComparedSelector, useShallowComparedValue, useStorageState, useStore, useThrottleByFrame, useThrottleBySetTimeout, useThrottleByTimer, useToggle, useUnmountEffect };
624
- //# sourceMappingURL=hooks-DuWtaFqu.js.map
657
+ //# sourceMappingURL=hooks-CJPA1jR-.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"hooks-CJPA1jR-.js","names":["useAfterMountEffect: typeof useEffect","useLocationState","useAnimationPresence: UseSpecificPresence","useTransitionPresence: UseSpecificPresence","usePresence: UsePresence","observedElementRef: RefCallback<TElement>","useStorageState"],"sources":["../../src/hooks/createCustomContext.ts","../../src/hooks/useCallbackRef.ts","../../src/hooks/effects/useAfterMountEffect.ts","../../src/hooks/effects/useAsyncEffect.ts","../../src/hooks/effects/useEffectOnce.ts","../../src/hooks/effects/useLifeCycle.ts","../../src/hooks/effects/useMountEffect.ts","../../src/hooks/effects/useUnMountEffect.ts","../../src/hooks/useAnimateElementRefs.ts","../../src/hooks/useAnimationInterval.ts","../../src/hooks/useClickOutside.ts","../../src/hooks/useConstant.ts","../../src/hooks/useCopyToClipboard.ts","../../src/hooks/useDebounce.ts","../../src/hooks/useToggle.ts","../../src/hooks/useDisclosure.ts","../../src/hooks/useIsHydrated.ts","../../src/hooks/useIsServer.ts","../../src/hooks/useStore.ts","../../src/hooks/useLocationState.ts","../../src/hooks/usePresence/useAnimationPresence.ts","../../src/hooks/usePresence/useTransitionPresence.ts","../../src/hooks/usePresence/usePresence.ts","../../src/hooks/useScrollObserver.ts","../../src/hooks/useSearch.ts","../../src/hooks/useSearchParams.ts","../../src/hooks/useShallowCompare.ts","../../src/hooks/useStorageState.ts","../../src/hooks/useThrottle.ts"],"sourcesContent":["import { defineEnum } from \"@zayne-labs/toolkit-type-helpers\";\nimport { createContext, use } from \"react\";\n\nexport class ContextError extends Error {\n\toverride name = \"ContextError\";\n}\n\nexport const getErrorMessage = (hook: string, provider: string) => {\n\treturn `${hook} returned \"null\". Did you forget to wrap the necessary components within ${provider}?`;\n};\n\nexport type CustomContextOptions<TContextValue, TStrict extends boolean> = {\n\tdefaultValue?: TContextValue | null;\n\terrorMessage?: string;\n\textension?: (contextValue: NoInfer<TContextValue> | null) => TContextValue | null;\n\thookName?: string;\n\tname?: string;\n\tproviderName?: string;\n\tstrict?: TStrict;\n};\n\ntype UseCustomContextResult<TContextValue, TStrict extends boolean> =\n\tTStrict extends true ? TContextValue : TContextValue | null;\n\nconst createCustomContext = <TContextValue, TStrict extends boolean = true>(\n\toptions: CustomContextOptions<TContextValue, TStrict> = {}\n) => {\n\tconst {\n\t\tdefaultValue = null,\n\t\terrorMessage,\n\t\textension,\n\t\thookName = \"useUnnamedContext\",\n\t\tproviderName = \"UnnamedContextProvider\",\n\t\tname = providerName.endsWith(\"Provider\") ? providerName.slice(0, -8) : \"UnnamedContext\",\n\t\tstrict = true,\n\t} = options;\n\n\tconst Context = createContext<TContextValue | null>(defaultValue);\n\n\tContext.displayName = name;\n\n\tconst useCustomContext = (): UseCustomContextResult<TContextValue, TStrict> => {\n\t\tconst contextValue = use(Context);\n\n\t\tconst extendedContextValue = extension?.(contextValue) ?? contextValue;\n\n\t\tif (strict && extendedContextValue === null) {\n\t\t\tthrow new ContextError(errorMessage ?? getErrorMessage(hookName, providerName));\n\t\t}\n\n\t\treturn extendedContextValue as NonNullable<typeof extendedContextValue>;\n\t};\n\n\treturn defineEnum([Context, useCustomContext]);\n};\n\nexport { createCustomContext };\n","import type { AnyFunction } from \"@zayne-labs/toolkit-type-helpers\";\nimport { useCallback, useLayoutEffect, useRef } from \"react\";\n\n/**\n * Returns a stable function that always points to the latest version of the callback function.\n * @param callbackFn - The function to reference\n * @returns a stable function that always points to the latest version of the callback function\n */\n\nconst useCallbackRef = <TCallback = AnyFunction>(callbackFn: TCallback | undefined) => {\n\tconst callbackRef = useRef(callbackFn);\n\n\tuseLayoutEffect(() => {\n\t\t// == Doing this instead updating it during render cuz according to Dan Abramov, render should be pure\n\t\tcallbackRef.current = callbackFn;\n\t}, [callbackFn]);\n\n\tconst savedCallback = useCallback(\n\t\t// eslint-disable-next-line ts-eslint/no-unnecessary-condition -- callbackRef.current can be null in some cases\n\t\t(...params: unknown[]) => (callbackRef.current as AnyFunction)?.(...params) as unknown,\n\t\t[]\n\t);\n\n\treturn savedCallback as TCallback;\n};\n\nexport { useCallbackRef };\n","import { useEffect, useRef } from \"react\";\nimport { useCallbackRef } from \"../useCallbackRef\";\n\nconst useAfterMountEffect: typeof useEffect = (callBackFn, deps) => {\n\tconst isFirstMount = useRef(true);\n\tconst stableCallback = useCallbackRef(callBackFn);\n\n\tuseEffect(() => {\n\t\tif (isFirstMount.current) {\n\t\t\tisFirstMount.current = false;\n\t\t\treturn;\n\t\t}\n\n\t\tstableCallback();\n\t\t// eslint-disable-next-line react-hooks/exhaustive-deps -- stableCallback is stable\n\t}, deps);\n};\nexport { useAfterMountEffect };\n","import { useEffect, useState } from \"react\";\nimport { useCallbackRef } from \"../useCallbackRef\";\n\nexport function useAsyncEffect(\n\teffect: () => Promise<ReturnType<React.EffectCallback>>,\n\tdeps?: React.DependencyList\n) {\n\tconst stableEffectCallback = useCallbackRef(effect);\n\tconst [destroy, setDestroy] = useState<ReturnType<React.EffectCallback>>();\n\n\tuseEffect(() => {\n\t\tconst e = stableEffectCallback();\n\n\t\tasync function execute() {\n\t\t\tsetDestroy(await e);\n\t\t}\n\n\t\tvoid execute();\n\n\t\treturn () => void destroy?.();\n\t\t// eslint-disable-next-line react-hooks/exhaustive-deps -- stableEffectCallback is stable\n\t}, deps);\n}\n","import { useEffect, useRef } from \"react\";\nimport { useCallbackRef } from \"../useCallbackRef\";\n\nconst useEffectOnce = (callBackFn: React.EffectCallback) => {\n\tconst stableCallback = useCallbackRef(callBackFn);\n\n\tconst effectGuard = useRef(false);\n\n\t// == savedCallback is always stable so no worries about re-execution of this effect\n\tuseEffect(() => {\n\t\tif (effectGuard.current) return;\n\n\t\teffectGuard.current = true;\n\n\t\treturn stableCallback();\n\t\t// eslint-disable-next-line react-hooks/exhaustive-deps -- stableCallback is stable\n\t}, []);\n};\n\nexport { useEffectOnce };\n","import { useEffect } from \"react\";\nimport { useCallbackRef } from \"../useCallbackRef\";\n\nexport type Destructor = ReturnType<React.EffectCallback>;\n\ntype LifeCycleOptions = {\n\tonMount?: () => void;\n\tonUnmount?: Destructor;\n};\n\nconst useLifeCycle = ({ onMount, onUnmount }: LifeCycleOptions) => {\n\tconst stableOnMount = useCallbackRef(onMount);\n\tconst stableOnUnmount = useCallbackRef(onUnmount);\n\n\tuseEffect(() => {\n\t\tstableOnMount();\n\n\t\treturn stableOnUnmount;\n\t\t// eslint-disable-next-line react-hooks/exhaustive-deps -- stableOnMount and stableOnUnmount are stable\n\t}, []);\n};\n\nexport { useLifeCycle };\n","import { useLifeCycle } from \"./useLifeCycle\";\n\nconst useMountEffect = (callBackFn: () => void) => {\n\tuseLifeCycle({ onMount: callBackFn });\n};\n\nexport { useMountEffect };\n","import { type Destructor, useLifeCycle } from \"./useLifeCycle\";\n\nconst useUnmountEffect = (cleanUpFn: Destructor) => useLifeCycle({ onUnmount: cleanUpFn });\n\nexport { useUnmountEffect };\n","import { on } from \"@zayne-labs/toolkit-core\";\nimport { type NonEmptyArray, isArray } from \"@zayne-labs/toolkit-type-helpers\";\nimport { useCallback, useRef } from \"react\";\nimport { useCallbackRef } from \"./useCallbackRef\";\n\ntype ElementsInfoArray<TTargetElement extends string> = NonEmptyArray<{\n\tanimationClass: string;\n\ttargetElement: TTargetElement;\n}>;\n\nconst removeClass = (target: HTMLElement, className: string) => () => target.classList.remove(className);\n\n/**\n * This is a custom React hook that adds and removes animation classes to specified HTML elements.\n * @param elementsInfoArray - An array of objects that contain information about the animation class and the target HTML element.\n * @returns - An object containing the refs of the animated elements and a function to handle the initiation and removal animation.\n */\n\nconst useAnimateElementRefs = <TTargetElement extends string>(\n\telementsInfoArray: ElementsInfoArray<TTargetElement>\n) => {\n\tconst elementsRef = useRef<Record<TTargetElement, HTMLElement | null>>({} as never);\n\n\tconst addAnimationClasses = useCallbackRef(() => {\n\t\tif (!isArray(elementsInfoArray)) {\n\t\t\tconsole.error(\"elementsInfo is not an Array\");\n\t\t\treturn;\n\t\t}\n\n\t\tfor (const { animationClass, targetElement } of elementsInfoArray) {\n\t\t\tif (!elementsRef.current[targetElement]) {\n\t\t\t\tconsole.error(\"ElementError\", `\"${targetElement}\" element does not exist`);\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\telementsRef.current[targetElement].classList.add(animationClass);\n\t\t}\n\t});\n\n\tconst removeAnimationClasses = useCallbackRef(() => {\n\t\tif (!isArray(elementsInfoArray)) {\n\t\t\tconsole.error(\"elementsInfo is not an Array\");\n\t\t\treturn;\n\t\t}\n\n\t\tfor (const { animationClass, targetElement } of elementsInfoArray) {\n\t\t\tif (!elementsRef.current[targetElement]) {\n\t\t\t\tconsole.error(\"ElementError\", `\"${targetElement}\" element does not exist`);\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\ton(\n\t\t\t\t\"transitionend\",\n\t\t\t\telementsRef.current[targetElement],\n\t\t\t\tremoveClass(elementsRef.current[targetElement], animationClass)\n\t\t\t);\n\n\t\t\ton(\n\t\t\t\t\"animationend\",\n\t\t\t\telementsRef.current[targetElement],\n\t\t\t\tremoveClass(elementsRef.current[targetElement], animationClass)\n\t\t\t);\n\t\t}\n\t});\n\n\t// Add animation classes to elements and remove them after the animation ends\n\tconst handleElementsAnimation = useCallback(() => {\n\t\taddAnimationClasses();\n\n\t\tremoveAnimationClasses();\n\t}, [addAnimationClasses, removeAnimationClasses]);\n\n\treturn { animatedElements: elementsRef.current, handleElementsAnimation };\n};\n\nexport { useAnimateElementRefs };\n","import { type AnimationIntervalOptions, setAnimationInterval } from \"@zayne-labs/toolkit-core\";\nimport type { Prettify } from \"@zayne-labs/toolkit-type-helpers\";\nimport { useEffect, useMemo } from \"react\";\nimport { useCallbackRef } from \"./useCallbackRef\";\n\ntype AnimationOptions = Prettify<\n\tAnimationIntervalOptions & {\n\t\tintervalDuration: number | null;\n\t\tonAnimation: () => void;\n\t}\n>;\n\nconst useAnimationInterval = (options: AnimationOptions) => {\n\tconst { intervalDuration, onAnimation, once } = options;\n\n\tconst latestCallback = useCallbackRef(onAnimation);\n\n\tconst { start, stop } = useMemo(\n\t\t() => setAnimationInterval(latestCallback, intervalDuration, { once }),\n\t\t[intervalDuration, latestCallback, once]\n\t);\n\n\tuseEffect(() => {\n\t\tif (intervalDuration === null) return;\n\n\t\tstart();\n\n\t\treturn stop;\n\t\t// eslint-disable-next-line react-hooks/exhaustive-deps -- start and stop are stable\n\t}, [intervalDuration]);\n\n\treturn { start, stop };\n};\n\nexport { useAnimationInterval };\n","import { onClickOutside, toArray } from \"@zayne-labs/toolkit-core\";\nimport { useEffect, useRef } from \"react\";\nimport { useCallbackRef } from \"./useCallbackRef\";\n\ntype UseClickOutsideOptions<TElement extends HTMLElement> = {\n\tenabled?: boolean;\n\tonClick: (event: MouseEvent | TouchEvent) => void;\n\tref?: Array<React.RefObject<TElement>> | React.RefObject<TElement>;\n};\n\nconst useClickOutside = <TElement extends HTMLElement>(options: UseClickOutsideOptions<TElement>) => {\n\tconst innerRef = useRef<TElement>(null);\n\n\tconst { enabled = true, onClick, ref: refOrRefArray = innerRef } = options;\n\n\tconst savedOnClick = useCallbackRef(onClick);\n\n\tuseEffect(() => {\n\t\tif (!enabled) return;\n\n\t\tconst elementArray = toArray(refOrRefArray).map((ref) => ref.current);\n\n\t\tconst cleanup = onClickOutside(elementArray, savedOnClick);\n\n\t\treturn () => cleanup();\n\t}, [enabled, refOrRefArray, savedOnClick]);\n\n\treturn {\n\t\tref: innerRef,\n\t};\n};\n\nexport { useClickOutside };\n","import { useRef } from \"react\";\n\nexport const useConstant = <TResult>(initCallbackFn: () => TResult): TResult => {\n\tconst resultRef = useRef<TResult | null>(null);\n\n\t// eslint-disable-next-line ts-eslint/prefer-nullish-coalescing -- The current case is justified since it's optimizable by the react compiler\n\tif (resultRef.current === null) {\n\t\tresultRef.current = initCallbackFn();\n\t}\n\n\treturn resultRef.current;\n};\n\nexport const useLazyRef = <TResult>(initCallbackFn: () => TResult): React.RefObject<TResult> => {\n\tconst resultRef = useRef<TResult | null>(null);\n\n\t// eslint-disable-next-line ts-eslint/prefer-nullish-coalescing -- The current case is justified since it's optimizable by the react compiler\n\tif (resultRef.current === null) {\n\t\tresultRef.current = initCallbackFn();\n\t}\n\n\treturn resultRef as React.RefObject<TResult>;\n};\n","import { copyToClipboard } from \"@zayne-labs/toolkit-core\";\nimport { useState } from \"react\";\n\nconst useCopyToClipboard = () => {\n\tconst [state, setState] = useState(\"\");\n\n\tconst handleCopy = (value: string) => {\n\t\tsetState(value);\n\t\tvoid copyToClipboard(value);\n\t};\n\n\treturn { copiedValue: state, handleCopy };\n};\n\nexport { useCopyToClipboard };\n","import { debounce } from \"@zayne-labs/toolkit-core\";\nimport type { CallbackFn } from \"@zayne-labs/toolkit-type-helpers\";\nimport { useMemo, useState } from \"react\";\nimport { useUnmountEffect } from \"./effects/useUnMountEffect\";\nimport { useCallbackRef } from \"./useCallbackRef\";\n\nexport const useDebouncedFn = <TParams>(callBackFn: CallbackFn<TParams>, delay: number | undefined) => {\n\tconst latestCallback = useCallbackRef(callBackFn);\n\n\tconst debouncedFn = useMemo(() => debounce(latestCallback, delay), [delay, latestCallback]);\n\n\tuseUnmountEffect(() => {\n\t\tdebouncedFn.cancel();\n\t\tdebouncedFn.cancelMaxWait();\n\t});\n\n\treturn debouncedFn;\n};\n\nexport const useDebouncedState = <TValue>(defaultValue: TValue, delay: number | undefined) => {\n\tconst [value, setValue] = useState(defaultValue);\n\n\tconst setDebouncedValue = useMemo(() => debounce(setValue, delay), [delay]);\n\n\tuseUnmountEffect(() => {\n\t\tsetDebouncedValue.cancel();\n\t\tsetDebouncedValue.cancelMaxWait();\n\t});\n\n\treturn [value, setDebouncedValue, setValue] as const;\n};\n","import { useCallback, useState } from \"react\";\n\ntype InitialState = boolean | (() => boolean);\n\nconst useToggle = (initialValue: InitialState = false) => {\n\tconst [value, setValue] = useState(initialValue);\n\n\tconst toggle = useCallback(<TValue>(newValue?: TValue) => {\n\t\tif (typeof newValue === \"boolean\") {\n\t\t\tsetValue(newValue);\n\t\t\treturn;\n\t\t}\n\n\t\tsetValue((prev) => !prev);\n\t}, []);\n\n\treturn [value, toggle] as const;\n};\n\nexport { useToggle };\n","import { lockScroll } from \"@zayne-labs/toolkit-core\";\nimport { isBoolean } from \"@zayne-labs/toolkit-type-helpers\";\nimport { useMemo } from \"react\";\nimport { useCallbackRef } from \"./useCallbackRef\";\nimport { useToggle } from \"./useToggle\";\n\ntype DisclosureOptions = {\n\thasScrollControl?: boolean;\n\tinitialState?: boolean | (() => boolean);\n};\n\nconst useDisclosure = (options: DisclosureOptions = {}) => {\n\tconst { hasScrollControl = false, initialState = false } = options;\n\tconst [isOpen, toggleIsOpen] = useToggle(initialState);\n\n\tconst onOpen = useCallbackRef(() => {\n\t\ttoggleIsOpen(true);\n\t\thasScrollControl && lockScroll({ lock: true });\n\t});\n\n\tconst onClose = useCallbackRef(() => {\n\t\ttoggleIsOpen(false);\n\t\thasScrollControl && lockScroll({ lock: false });\n\t});\n\n\tconst onToggle = useCallbackRef(<TValue>(value?: TValue) => {\n\t\tif (isBoolean(value)) {\n\t\t\ttoggleIsOpen(value);\n\t\t\thasScrollControl && lockScroll({ lock: value });\n\t\t\treturn;\n\t\t}\n\n\t\tisOpen ? onClose() : onOpen();\n\t});\n\n\tconst api = useMemo(() => ({ isOpen, onClose, onOpen, onToggle }), [isOpen, onClose, onOpen, onToggle]);\n\n\treturn api;\n};\nexport { useDisclosure };\n","import { useSyncExternalStore } from \"react\";\n\nconst noop = () => {};\n\nconst emptySubscribe = () => noop;\n\n/**\n * @description Return a boolean indicating if the JS has been hydrated already.\n * When doing Server-Side Rendering, the result will always be false.\n * When doing Client-Side Rendering, the result will always be false on the\n * first render and true from then on. Even if a new component renders it will\n * always start with true.\n *\n * @see https://github.com/sergiodxa/remix-utils/blob/main/src/react/use-hydrated.ts\n *\n * @see https://github.com/sergiodxa/remix-utils/blob/main/src/react/use-hydrated.ts\n *\n * @example\n * **Example: Disable a button that needs JS to work.**\n * ```tsx\n * const isHydrated = useIsHydrated();\n *\n * return (\n * <button type=\"button\" disabled={!isHydrated} onClick={doSomethingCustom}>\n * Click me\n * </button>\n * );\n * ```\n */\nexport const useIsHydrated = () => {\n\tconst isHydrated = useSyncExternalStore(\n\t\temptySubscribe,\n\t\t() => true,\n\t\t() => false\n\t);\n\n\treturn isHydrated;\n};\n","import { useSyncExternalStore } from \"react\";\n\nconst noopStore = {\n\tgetServerSnapshot: () => true,\n\tgetSnapshot: () => false,\n\t// eslint-disable-next-line unicorn/consistent-function-scoping -- It's fine\n\tsubscribe: () => () => {},\n};\n\n/**\n * @description Returns whether the component is currently being server side rendered or\n * hydrated on the client. Can be used to delay browser-specific rendering\n * until after hydration.\n */\nconst useIsServer = () => {\n\tconst isServer = useSyncExternalStore(\n\t\tnoopStore.subscribe,\n\t\tnoopStore.getSnapshot,\n\t\tnoopStore.getServerSnapshot\n\t);\n\n\treturn isServer;\n};\n\nexport { useIsServer };\n","import type { StoreApi } from \"@zayne-labs/toolkit-core\";\nimport type { SelectorFn } from \"@zayne-labs/toolkit-type-helpers\";\nimport { useCallback, useDebugValue, useSyncExternalStore } from \"react\";\n\nconst identity = <TState>(value: TState) => value;\n\nconst useStore = <TState, TSlice = TState>(\n\tstore: StoreApi<TState>,\n\tselector: SelectorFn<TState, TSlice> = identity as never\n) => {\n\tconst slice = useSyncExternalStore(\n\t\tstore.subscribe,\n\t\tuseCallback(() => selector(store.getState()), [store, selector]),\n\t\tuseCallback(() => selector(store.getInitialState()), [store, selector])\n\t);\n\n\tuseDebugValue(slice);\n\n\treturn slice;\n};\n\nexport { useStore };\n","import {\n\tcreateLocationStore,\n\ttype LocationInfo,\n\ttype LocationStoreApi,\n\ttype LocationStoreOptions,\n} from \"@zayne-labs/toolkit-core\";\nimport type { SelectorFn } from \"@zayne-labs/toolkit-type-helpers\";\nimport { useMemo } from \"react\";\nimport { useCallbackRef } from \"./useCallbackRef\";\nimport { useStore } from \"./useStore\";\n\ntype UseLocationResult<TSlice> = [state: TSlice, actions: LocationStoreApi];\n\nexport const createUseLocationState = (options?: LocationStoreOptions) => {\n\tconst locationStore = createLocationStore(options);\n\n\ttype UseBoundLocationState = LocationStoreApi\n\t\t& (<TSlice = LocationInfo>(\n\t\t\tselector?: SelectorFn<LocationInfo, TSlice>\n\t\t) => UseLocationResult<TSlice>);\n\n\tconst useLocationState = <TSlice = LocationInfo>(\n\t\tselector?: SelectorFn<LocationInfo, TSlice>\n\t): UseLocationResult<TSlice> => {\n\t\tconst stateSlice = useStore(locationStore as never, selector);\n\n\t\treturn [stateSlice, locationStore];\n\t};\n\n\tObject.assign(useLocationState, locationStore);\n\n\treturn useLocationState as UseBoundLocationState;\n};\n\nexport const useLocationState = <TSlice = LocationInfo>(\n\tselector?: SelectorFn<LocationInfo, TSlice>,\n\toptions: LocationStoreOptions = {}\n): UseLocationResult<TSlice> => {\n\tconst { equalityFn } = options;\n\n\tconst savedEqualityFn = useCallbackRef(equalityFn);\n\n\tconst locationStore = useMemo(\n\t\t() => createLocationStore({ equalityFn: savedEqualityFn }),\n\t\t[savedEqualityFn]\n\t);\n\n\tconst stateSlice = useStore(locationStore as never, selector);\n\n\treturn [stateSlice, locationStore];\n};\n","import { on } from \"@zayne-labs/toolkit-core\";\nimport { useEffect, useRef, useState } from \"react\";\nimport { useCallbackRef } from \"../useCallbackRef\";\nimport { useDebouncedState } from \"../useDebounce\";\nimport type { UseSpecificPresence } from \"./types\";\n\nconst useAnimationPresence: UseSpecificPresence = (options = {}) => {\n\tconst { defaultValue = true, duration, onExitComplete } = options;\n\n\tconst [isShown, setIsShown] = useState(defaultValue);\n\n\tconst [isMounted, setDebouncedIsMounted, setRegularIsMounted] = useDebouncedState(\n\t\tdefaultValue,\n\t\tduration\n\t);\n\tconst elementRef = useRef<HTMLElement>(null);\n\n\tconst stableOnExitComplete = useCallbackRef(onExitComplete);\n\n\tuseEffect(() => {\n\t\t!isMounted && stableOnExitComplete();\n\t\t// eslint-disable-next-line react-hooks/exhaustive-deps -- stableOnExitComplete is stable\n\t}, [isMounted]);\n\n\tconst handleIsMountedWithoutRef = (value: boolean) => {\n\t\tif (value) {\n\t\t\tsetRegularIsMounted(true);\n\t\t\treturn;\n\t\t}\n\n\t\tsetDebouncedIsMounted(false);\n\t};\n\n\tconst handleIsMountedWithRef = (value: boolean) => {\n\t\tif (value) {\n\t\t\tsetRegularIsMounted(true);\n\t\t\treturn;\n\t\t}\n\n\t\ton(\"animationend\", elementRef.current, () => {\n\t\t\tsetDebouncedIsMounted.cancel();\n\t\t\tsetRegularIsMounted(false);\n\t\t});\n\t};\n\n\tconst toggleVisibility = useCallbackRef(<TValue>(newValue?: TValue) => {\n\t\tconst handleSetIsMounted = !duration ? handleIsMountedWithRef : handleIsMountedWithoutRef;\n\n\t\tif (typeof newValue === \"boolean\") {\n\t\t\tsetIsShown(newValue);\n\t\t\thandleSetIsMounted(newValue);\n\t\t\treturn;\n\t\t}\n\n\t\tsetIsShown(!isShown);\n\t\thandleSetIsMounted(!isShown);\n\t});\n\n\treturn {\n\t\tisPresent: isMounted,\n\t\tisVisible: isShown,\n\t\ttoggleVisibility,\n\t\t...(duration === undefined && { elementRef }),\n\t} as never;\n};\n\nexport { useAnimationPresence };\n","import { on } from \"@zayne-labs/toolkit-core\";\nimport { useEffect, useRef, useState } from \"react\";\nimport { useCallbackRef } from \"../useCallbackRef\";\nimport { useDebouncedState } from \"../useDebounce\";\nimport type { UseSpecificPresence } from \"./types\";\n\nconst useTransitionPresence: UseSpecificPresence = (options = {}) => {\n\tconst { defaultValue = true, duration, onExitComplete } = options;\n\n\tconst [isShown, setIsShown] = useState(defaultValue);\n\n\tconst [isMounted, setDebouncedIsMounted, setRegularIsMounted] = useDebouncedState(\n\t\tdefaultValue,\n\t\tduration\n\t);\n\tconst elementRef = useRef<HTMLElement>(null);\n\tconst stableOnExitComplete = useCallbackRef(onExitComplete);\n\n\tconst handleIsMountedWithoutRef = (value: boolean) => {\n\t\tif (value) {\n\t\t\tsetDebouncedIsMounted(value, { $delay: 0 });\n\t\t\treturn;\n\t\t}\n\n\t\tsetDebouncedIsMounted(false);\n\t};\n\n\tconst handleIsMountedWithRef = (value: boolean) => {\n\t\tif (value) {\n\t\t\tsetDebouncedIsMounted(value, { $delay: 0 });\n\t\t\treturn;\n\t\t}\n\n\t\ton(\"transitionend\", elementRef.current, () => {\n\t\t\tsetDebouncedIsMounted.cancel();\n\t\t\tsetRegularIsMounted(false);\n\t\t});\n\t};\n\n\tconst toggleVisibility = useCallbackRef(<TValue>(newValue?: TValue) => {\n\t\tconst handleSetIsMounted = !duration ? handleIsMountedWithRef : handleIsMountedWithoutRef;\n\n\t\tif (typeof newValue === \"boolean\") {\n\t\t\tsetIsShown(newValue);\n\t\t\thandleSetIsMounted(newValue);\n\t\t\treturn;\n\t\t}\n\n\t\tsetIsShown(!isShown);\n\t\thandleSetIsMounted(!isShown);\n\t});\n\n\tuseEffect(() => {\n\t\t!isMounted && stableOnExitComplete();\n\t\t// eslint-disable-next-line react-hooks/exhaustive-deps -- stableOnExitComplete is stable\n\t}, [isMounted]);\n\n\treturn {\n\t\tisPresent: isMounted || isShown,\n\t\tisVisible: isMounted && isShown,\n\t\ttoggleVisibility,\n\t\t...(duration === undefined && { elementRef }),\n\t} as never;\n};\n\nexport { useTransitionPresence };\n","import type { UsePresence } from \"./types\";\nimport { useAnimationPresence } from \"./useAnimationPresence\";\nimport { useTransitionPresence } from \"./useTransitionPresence\";\n\n/**\n * usePresence hook provides a way to animate an element, before removing it from the DOM.\n * @param defaultValue - The default value for the presence state. Defaults to `true`.\n * @param options - The options for the usePresence hook.\n * @returns A object containing the boolean that should be used to conditionally render the element (isPresent), another boolean used to toggle the animation classes, and a function to toggle the state.\n */\n\nconst usePresence: UsePresence = (options = {}) => {\n\tconst { type = \"transition\", ...restOfOptions } = options;\n\n\tconst useSpecificPresence = type === \"transition\" ? useTransitionPresence : useAnimationPresence;\n\n\treturn useSpecificPresence(restOfOptions);\n};\n\nexport { usePresence };\n","import { createScrollObserver, type ScrollObserverOptions } from \"@zayne-labs/toolkit-core\";\nimport { type RefCallback, useMemo, useState } from \"react\";\nimport { useCallbackRef } from \"./useCallbackRef\";\n\nconst useScrollObserver = <TElement extends HTMLElement>(options: ScrollObserverOptions = {}) => {\n\tconst { onIntersection, root, rootMargin = \"10px 0px 0px 0px\", threshold } = options;\n\n\tconst [isScrolled, setIsScrolled] = useState(false);\n\n\tconst savedOnIntersection = useCallbackRef(onIntersection);\n\n\tconst { handleObservation } = useMemo(() => {\n\t\treturn createScrollObserver({\n\t\t\tonIntersection: (entry, observer) => {\n\t\t\t\tconst newIsScrolledState = !entry.isIntersecting;\n\n\t\t\t\tsetIsScrolled(newIsScrolledState);\n\n\t\t\t\t// eslint-disable-next-line no-param-reassign -- Mutation is fine here\n\t\t\t\t(entry.target as HTMLElement).dataset.scrolled = String(newIsScrolledState);\n\n\t\t\t\tsavedOnIntersection(entry, observer);\n\t\t\t},\n\t\t\troot,\n\t\t\trootMargin,\n\t\t\tthreshold,\n\t\t});\n\t}, [root, rootMargin, savedOnIntersection, threshold]);\n\n\tconst observedElementRef: RefCallback<TElement> = useCallbackRef((element) => {\n\t\tconst cleanupFn = handleObservation(element);\n\n\t\t// == React 18 may not call the cleanup function so we need to call it manually on element unmount\n\t\tif (!element) {\n\t\t\tcleanupFn?.();\n\t\t\treturn;\n\t\t}\n\n\t\treturn cleanupFn;\n\t});\n\n\treturn { isScrolled, observedElementRef };\n};\n\nexport { useScrollObserver };\n","import { isPlainObject } from \"@zayne-labs/toolkit-type-helpers\";\nimport { useState } from \"react\";\nimport { useAfterMountEffect } from \"./effects/useAfterMountEffect\";\nimport { useDebouncedFn } from \"./useDebounce\";\n\nconst isSerializable = (item: unknown): item is boolean | number | string =>\n\ttypeof item === \"string\" || typeof item === \"number\" || typeof item === \"boolean\";\n\nconst checkObjectPropsForQuery = (item: Record<string, unknown>, query: string): boolean => {\n\tfor (const value of Object.values(item)) {\n\t\tif (isSerializable(value) && value.toString().toLowerCase().includes(query)) {\n\t\t\treturn true;\n\t\t}\n\t}\n\treturn false;\n};\n\nconst useSearch = <TData>(initialData: TData[], delay?: number) => {\n\tconst [searchQuery, setSearchQuery] = useState(\"\");\n\tconst [filteredData, setFilteredData] = useState(initialData);\n\tconst [isLoading, setIsLoading] = useState(false);\n\n\tconst handleDebouncedSearch = useDebouncedFn(() => {\n\t\tconst query = searchQuery.toLowerCase();\n\n\t\tconst filteredResults = initialData.filter((item) => {\n\t\t\tif (isSerializable(item)) {\n\t\t\t\treturn item.toString().toLowerCase().includes(query);\n\t\t\t}\n\n\t\t\tif (isPlainObject(item)) {\n\t\t\t\treturn checkObjectPropsForQuery(item, query);\n\t\t\t}\n\n\t\t\treturn false;\n\t\t});\n\n\t\tsetFilteredData(filteredResults);\n\t\tsetIsLoading(false);\n\t}, delay);\n\n\tuseAfterMountEffect(() => {\n\t\tsetIsLoading(true);\n\t\thandleDebouncedSearch();\n\t}, [searchQuery]);\n\n\treturn { data: filteredData, isLoading, query: searchQuery, setQuery: setSearchQuery };\n};\n\nexport { useSearch };\n","import {\n\ttype LocationStoreOptions,\n\ttype URLSearchParamsInit,\n\tcreateSearchParams,\n} from \"@zayne-labs/toolkit-core\";\nimport { isFunction } from \"@zayne-labs/toolkit-type-helpers\";\nimport { useLocationState } from \"./useLocationState\";\n\ntype UseSearchParamsOptions = LocationStoreOptions & {\n\taction?: \"push\" | \"replace\";\n};\n\nexport const useSearchParams = <TSearchParams extends URLSearchParamsInit>(\n\toptions?: UseSearchParamsOptions\n) => {\n\tconst { action = \"push\", ...restOfOptions } = options ?? {};\n\n\tconst [searchParams, actions] = useLocationState((state) => state.search, restOfOptions);\n\n\tconst setSearchParams = (\n\t\tnewQueryParams: TSearchParams | ((prev: URLSearchParams) => TSearchParams)\n\t) => {\n\t\tconst params = isFunction(newQueryParams) ? newQueryParams(searchParams) : newQueryParams;\n\n\t\tconst nextSearchParams = createSearchParams(params);\n\n\t\tactions[action]({ search: nextSearchParams });\n\t};\n\n\tsetSearchParams.triggerPopstateEvent = actions.triggerPopstateEvent;\n\n\treturn [searchParams, setSearchParams] as const;\n};\n\nexport const useSearchParamsObject = <TSearchParams extends Record<string, string>>(\n\toptions?: UseSearchParamsOptions\n) => {\n\tconst [searchParams, setSearchParams] = useSearchParams(options);\n\n\tconst searchParamsObject = Object.fromEntries(searchParams) as TSearchParams;\n\n\tconst setSearchParamsObject = (\n\t\tnewQueryParams: TSearchParams | ((prev: TSearchParams) => TSearchParams)\n\t) => {\n\t\tconst params = isFunction(newQueryParams) ? newQueryParams(searchParamsObject) : newQueryParams;\n\n\t\tsetSearchParams(params);\n\t};\n\n\tsetSearchParamsObject.triggerPopstateEvent = setSearchParams.triggerPopstateEvent;\n\n\treturn [searchParamsObject, setSearchParamsObject] as const;\n};\n","import { shallowCompare } from \"@zayne-labs/toolkit-core\";\nimport type { SelectorFn } from \"@zayne-labs/toolkit-type-helpers\";\nimport { useRef } from \"react\";\n\nexport const useShallowComparedSelector = <TState, TResult>(selector: SelectorFn<TState, TResult>) => {\n\tconst prevStateRef = useRef<TResult>(undefined as never);\n\n\tconst shallowSelector = (state: TState) => {\n\t\tconst nextState = selector(state);\n\n\t\tif (shallowCompare(prevStateRef.current, nextState)) {\n\t\t\treturn prevStateRef.current;\n\t\t}\n\n\t\treturn (prevStateRef.current = nextState);\n\t};\n\n\treturn shallowSelector;\n};\n\nexport const useShallowComparedValue = <TValue>(value: TValue) => {\n\tconst prevValueRef = useRef<TValue>(value);\n\n\tif (shallowCompare(prevValueRef.current, value)) {\n\t\treturn prevValueRef.current;\n\t}\n\n\treturn (prevValueRef.current = value);\n};\n","import {\n\tcreateExternalStorageStore,\n\ttype StorageOptions,\n\ttype StorageStoreApi,\n} from \"@zayne-labs/toolkit-core\";\nimport type { SelectorFn } from \"@zayne-labs/toolkit-type-helpers\";\nimport { useMemo } from \"react\";\nimport { useCallbackRef } from \"./useCallbackRef\";\nimport { useStore } from \"./useStore\";\n\ntype UseStorageResult<TState, TSlice = TState> = [state: TSlice, actions: StorageStoreApi<TState>];\n\n/**\n * @description Creates a custom hook that returns a storage state and actions to modify it. You can use this if you need shared options.\n * @note You must use this if you want to be able to prevent syncing state across tabs.\n */\nexport const createUseStorageState = <TState>(baseOptions: StorageOptions<TState>) => {\n\tconst externalStore = createExternalStorageStore(baseOptions);\n\n\ttype UseBoundStorageState = StorageStoreApi<TState>\n\t\t& (<TSlice = TState>(selector?: SelectorFn<TState, TSlice>) => UseStorageResult<TState, TSlice>);\n\n\tconst useStorageState = <TSlice = TState>(\n\t\tselector?: SelectorFn<TState, TSlice>\n\t): UseStorageResult<TState, TSlice> => {\n\t\tconst stateInStorage = useStore(externalStore, selector);\n\n\t\treturn [stateInStorage, externalStore];\n\t};\n\n\tObject.assign(useStorageState, externalStore);\n\n\treturn useStorageState as UseBoundStorageState;\n};\n\ntype UseStorageStateOptions<TValue> = Omit<StorageOptions<TValue>, \"initialValue\" | \"key\">;\n\nexport const useStorageState = <TValue, TSlice = TValue>(\n\tkey: string,\n\tinitialValue?: TValue,\n\toptions?: UseStorageStateOptions<TValue> & { select?: SelectorFn<TValue, TSlice> }\n): UseStorageResult<TValue, TSlice> => {\n\tconst { equalityFn, logger, parser, partialize, select, serializer, storageArea, syncStateAcrossTabs } =\n\t\toptions ?? {};\n\n\tconst savedEquality = useCallbackRef(equalityFn);\n\tconst savedLogger = useCallbackRef(logger);\n\tconst savedParser = useCallbackRef(parser);\n\tconst savedPartialize = useCallbackRef(partialize);\n\tconst savedSerializer = useCallbackRef(serializer);\n\n\tconst externalStore = useMemo(() => {\n\t\treturn createExternalStorageStore({\n\t\t\tequalityFn: savedEquality,\n\t\t\tinitialValue,\n\t\t\tkey,\n\t\t\tlogger: savedLogger,\n\t\t\tparser: savedParser,\n\t\t\tpartialize: savedPartialize,\n\t\t\tserializer: savedSerializer,\n\t\t\tstorageArea,\n\t\t\tsyncStateAcrossTabs,\n\t\t});\n\t}, [\n\t\tinitialValue,\n\t\tkey,\n\t\tsavedEquality,\n\t\tsavedLogger,\n\t\tsavedParser,\n\t\tsavedPartialize,\n\t\tsavedSerializer,\n\t\tstorageArea,\n\t\tsyncStateAcrossTabs,\n\t]);\n\n\tconst stateInStorage = useStore(externalStore as never, select as never);\n\n\treturn [stateInStorage as never, externalStore];\n};\n","import { throttleByFrame, throttleBySetTimeout, throttleByTime } from \"@zayne-labs/toolkit-core\";\nimport type { CallbackFn } from \"@zayne-labs/toolkit-type-helpers\";\nimport { useMemo } from \"react\";\nimport { useUnmountEffect } from \"./effects\";\nimport { useCallbackRef } from \"./useCallbackRef\";\nimport { useConstant } from \"./useConstant\";\n\nexport const useThrottleBySetTimeout = <TParams>(callbackFn: CallbackFn<TParams>, delay: number) => {\n\tconst latestCallback = useCallbackRef(callbackFn);\n\n\tconst throttledCallback = useMemo(\n\t\t() => throttleBySetTimeout(latestCallback, delay),\n\t\t[delay, latestCallback]\n\t);\n\n\tuseUnmountEffect(() => throttledCallback.cancelTimeout());\n\n\treturn throttledCallback;\n};\n\nexport const useThrottleByTimer = <TParams>(callbackFn: CallbackFn<TParams>, delay: number) => {\n\tconst latestCallback = useCallbackRef(callbackFn);\n\n\tconst throttledCallback = useMemo(() => throttleByTime(latestCallback, delay), [delay, latestCallback]);\n\n\treturn throttledCallback;\n};\n\nexport const useThrottleByFrame = <TParams>(callbackFn: CallbackFn<TParams>) => {\n\tconst latestCallback = useCallbackRef(callbackFn);\n\n\tconst throttledCallback = useConstant(() => throttleByFrame(latestCallback));\n\n\tuseUnmountEffect(() => throttledCallback.cancelAnimation());\n\n\treturn throttledCallback;\n};\n"],"mappings":"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"}
@@ -1,4 +1,4 @@
1
- import { createCustomContext, useStore } from "../hooks-DuWtaFqu.js";
1
+ import { createCustomContext, useStore } from "../hooks-CJPA1jR-.js";
2
2
  import { createElement } from "react";
3
3
  import { createStore } from "@zayne-labs/toolkit-core";
4
4
  import { create, createStore as createStore$1 } from "zustand";
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@zayne-labs/toolkit-react",
3
3
  "type": "module",
4
- "version": "0.10.22",
4
+ "version": "0.10.24",
5
5
  "description": "A collection of utility functions, types and composables used by my other projects. Nothing too fancy but can be useful.",
6
6
  "author": "Ryan Zayne",
7
7
  "license": "MIT",
@@ -47,8 +47,8 @@
47
47
  }
48
48
  },
49
49
  "dependencies": {
50
- "@zayne-labs/toolkit-core": "0.10.22",
51
- "@zayne-labs/toolkit-type-helpers": "0.10.22"
50
+ "@zayne-labs/toolkit-core": "0.10.24",
51
+ "@zayne-labs/toolkit-type-helpers": "0.10.24"
52
52
  },
53
53
  "devDependencies": {
54
54
  "@arethetypeswrong/cli": "^0.18.2",
@@ -1 +0,0 @@
1
- {"version":3,"file":"hooks-DuWtaFqu.js","names":["useAfterMountEffect: typeof useEffect","useLocationState","useAnimationPresence: UseSpecificPresence","useTransitionPresence: UseSpecificPresence","usePresence: UsePresence","observedElementRef: RefCallback<TElement>","useStorageState"],"sources":["../../src/hooks/createCustomContext.ts","../../src/hooks/useCallbackRef.ts","../../src/hooks/effects/useAfterMountEffect.ts","../../src/hooks/effects/useAsyncEffect.ts","../../src/hooks/effects/useEffectOnce.ts","../../src/hooks/effects/useLifeCycle.ts","../../src/hooks/effects/useMountEffect.ts","../../src/hooks/effects/useUnMountEffect.ts","../../src/hooks/useAnimateElementRefs.ts","../../src/hooks/useConstant.ts","../../src/hooks/useAnimationInterval.ts","../../src/hooks/useClickOutside.ts","../../src/hooks/useCopyToClipboard.ts","../../src/hooks/useDebounce.ts","../../src/hooks/useToggle.ts","../../src/hooks/useDisclosure.ts","../../src/hooks/useIsHydrated.ts","../../src/hooks/useIsServer.ts","../../src/hooks/useStore.ts","../../src/hooks/useLocationState.ts","../../src/hooks/usePresence/useAnimationPresence.ts","../../src/hooks/usePresence/useTransitionPresence.ts","../../src/hooks/usePresence/usePresence.ts","../../src/hooks/useScrollObserver.ts","../../src/hooks/useSearch.ts","../../src/hooks/useSearchParams.ts","../../src/hooks/useShallowCompare.ts","../../src/hooks/useStorageState.ts","../../src/hooks/useThrottle.ts"],"sourcesContent":["import { defineEnum } from \"@zayne-labs/toolkit-type-helpers\";\nimport { createContext, use } from \"react\";\n\nexport class ContextError extends Error {\n\toverride name = \"ContextError\";\n}\n\nexport const getErrorMessage = (hook: string, provider: string) => {\n\treturn `${hook} returned \"null\". Did you forget to wrap the necessary components within ${provider}?`;\n};\n\nexport type CustomContextOptions<TContextValue, TStrict extends boolean> = {\n\tdefaultValue?: TContextValue | null;\n\terrorMessage?: string;\n\textension?: (contextValue: NoInfer<TContextValue> | null) => TContextValue | null;\n\thookName?: string;\n\tname?: string;\n\tproviderName?: string;\n\tstrict?: TStrict;\n};\n\ntype UseCustomContextResult<TContextValue, TStrict extends boolean> =\n\tTStrict extends true ? TContextValue : TContextValue | null;\n\nconst createCustomContext = <TContextValue, TStrict extends boolean = true>(\n\toptions: CustomContextOptions<TContextValue, TStrict> = {}\n) => {\n\tconst {\n\t\tdefaultValue = null,\n\t\terrorMessage,\n\t\textension,\n\t\thookName = \"useUnnamedContext\",\n\t\tproviderName = \"UnnamedContextProvider\",\n\t\tname = providerName.endsWith(\"Provider\") ? providerName.slice(0, -8) : \"UnnamedContext\",\n\t\tstrict = true,\n\t} = options;\n\n\tconst Context = createContext<TContextValue | null>(defaultValue);\n\n\tContext.displayName = name;\n\n\tconst useCustomContext = (): UseCustomContextResult<TContextValue, TStrict> => {\n\t\tconst contextValue = use(Context);\n\n\t\tconst extendedContextValue = extension?.(contextValue) ?? contextValue;\n\n\t\tif (strict && extendedContextValue === null) {\n\t\t\tthrow new ContextError(errorMessage ?? getErrorMessage(hookName, providerName));\n\t\t}\n\n\t\treturn extendedContextValue as NonNullable<typeof extendedContextValue>;\n\t};\n\n\treturn defineEnum([Context, useCustomContext]);\n};\n\nexport { createCustomContext };\n","import type { AnyFunction } from \"@zayne-labs/toolkit-type-helpers\";\nimport { useCallback, useLayoutEffect, useRef } from \"react\";\n\n/**\n * Returns a stable function that always points to the latest version of the callback function.\n * @param callbackFn - The function to reference\n * @returns a stable function that always points to the latest version of the callback function\n */\n\nconst useCallbackRef = <TCallback = AnyFunction>(callbackFn: TCallback | undefined) => {\n\tconst callbackRef = useRef(callbackFn);\n\n\tuseLayoutEffect(() => {\n\t\t// == Doing this instead updating it during render cuz according to Dan Abramov, render should be pure\n\t\tcallbackRef.current = callbackFn;\n\t}, [callbackFn]);\n\n\tconst savedCallback = useCallback(\n\t\t// eslint-disable-next-line ts-eslint/no-unnecessary-condition -- callbackRef.current can be null in some cases\n\t\t(...params: unknown[]) => (callbackRef.current as AnyFunction)?.(...params) as unknown,\n\t\t[]\n\t);\n\n\treturn savedCallback as TCallback;\n};\n\nexport { useCallbackRef };\n","import { useEffect, useRef } from \"react\";\nimport { useCallbackRef } from \"../useCallbackRef\";\n\nconst useAfterMountEffect: typeof useEffect = (callBackFn, deps) => {\n\tconst isFirstMount = useRef(true);\n\tconst stableCallback = useCallbackRef(callBackFn);\n\n\tuseEffect(() => {\n\t\tif (isFirstMount.current) {\n\t\t\tisFirstMount.current = false;\n\t\t\treturn;\n\t\t}\n\n\t\tstableCallback();\n\t\t// eslint-disable-next-line react-hooks/exhaustive-deps -- stableCallback is stable\n\t}, deps);\n};\nexport { useAfterMountEffect };\n","import { useEffect, useState } from \"react\";\nimport { useCallbackRef } from \"../useCallbackRef\";\n\nexport function useAsyncEffect(\n\teffect: () => Promise<ReturnType<React.EffectCallback>>,\n\tdeps?: React.DependencyList\n) {\n\tconst stableEffectCallback = useCallbackRef(effect);\n\tconst [destroy, setDestroy] = useState<ReturnType<React.EffectCallback>>();\n\n\tuseEffect(() => {\n\t\tconst e = stableEffectCallback();\n\n\t\tasync function execute() {\n\t\t\tsetDestroy(await e);\n\t\t}\n\n\t\tvoid execute();\n\n\t\treturn () => void destroy?.();\n\t\t// eslint-disable-next-line react-hooks/exhaustive-deps -- stableEffectCallback is stable\n\t}, deps);\n}\n","import { useEffect, useRef } from \"react\";\nimport { useCallbackRef } from \"../useCallbackRef\";\n\nconst useEffectOnce = (callBackFn: React.EffectCallback) => {\n\tconst stableCallback = useCallbackRef(callBackFn);\n\n\tconst effectGuard = useRef(false);\n\n\t// == savedCallback is always stable so no worries about re-execution of this effect\n\tuseEffect(() => {\n\t\tif (effectGuard.current) return;\n\n\t\teffectGuard.current = true;\n\n\t\treturn stableCallback();\n\t\t// eslint-disable-next-line react-hooks/exhaustive-deps -- stableCallback is stable\n\t}, []);\n};\n\nexport { useEffectOnce };\n","import { useEffect } from \"react\";\nimport { useCallbackRef } from \"../useCallbackRef\";\n\nexport type Destructor = ReturnType<React.EffectCallback>;\n\ntype LifeCycleOptions = {\n\tonMount?: () => void;\n\tonUnmount?: Destructor;\n};\n\nconst useLifeCycle = ({ onMount, onUnmount }: LifeCycleOptions) => {\n\tconst stableOnMount = useCallbackRef(onMount);\n\tconst stableOnUnmount = useCallbackRef(onUnmount);\n\n\tuseEffect(() => {\n\t\tstableOnMount();\n\n\t\treturn stableOnUnmount;\n\t\t// eslint-disable-next-line react-hooks/exhaustive-deps -- stableOnMount and stableOnUnmount are stable\n\t}, []);\n};\n\nexport { useLifeCycle };\n","import { useLifeCycle } from \"./useLifeCycle\";\n\nconst useMountEffect = (callBackFn: () => void) => {\n\tuseLifeCycle({ onMount: callBackFn });\n};\n\nexport { useMountEffect };\n","import { type Destructor, useLifeCycle } from \"./useLifeCycle\";\n\nconst useUnmountEffect = (cleanUpFn: Destructor) => useLifeCycle({ onUnmount: cleanUpFn });\n\nexport { useUnmountEffect };\n","import { on } from \"@zayne-labs/toolkit-core\";\nimport { type NonEmptyArray, isArray } from \"@zayne-labs/toolkit-type-helpers\";\nimport { useCallback, useRef } from \"react\";\nimport { useCallbackRef } from \"./useCallbackRef\";\n\ntype ElementsInfoArray<TTargetElement extends string> = NonEmptyArray<{\n\tanimationClass: string;\n\ttargetElement: TTargetElement;\n}>;\n\nconst removeClass = (target: HTMLElement, className: string) => () => target.classList.remove(className);\n\n/**\n * This is a custom React hook that adds and removes animation classes to specified HTML elements.\n * @param elementsInfoArray - An array of objects that contain information about the animation class and the target HTML element.\n * @returns - An object containing the refs of the animated elements and a function to handle the initiation and removal animation.\n */\n\nconst useAnimateElementRefs = <TTargetElement extends string>(\n\telementsInfoArray: ElementsInfoArray<TTargetElement>\n) => {\n\tconst elementsRef = useRef<Record<TTargetElement, HTMLElement | null>>({} as never);\n\n\tconst addAnimationClasses = useCallbackRef(() => {\n\t\tif (!isArray(elementsInfoArray)) {\n\t\t\tconsole.error(\"elementsInfo is not an Array\");\n\t\t\treturn;\n\t\t}\n\n\t\tfor (const { animationClass, targetElement } of elementsInfoArray) {\n\t\t\tif (!elementsRef.current[targetElement]) {\n\t\t\t\tconsole.error(\"ElementError\", `\"${targetElement}\" element does not exist`);\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\telementsRef.current[targetElement].classList.add(animationClass);\n\t\t}\n\t});\n\n\tconst removeAnimationClasses = useCallbackRef(() => {\n\t\tif (!isArray(elementsInfoArray)) {\n\t\t\tconsole.error(\"elementsInfo is not an Array\");\n\t\t\treturn;\n\t\t}\n\n\t\tfor (const { animationClass, targetElement } of elementsInfoArray) {\n\t\t\tif (!elementsRef.current[targetElement]) {\n\t\t\t\tconsole.error(\"ElementError\", `\"${targetElement}\" element does not exist`);\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\ton(\n\t\t\t\t\"transitionend\",\n\t\t\t\telementsRef.current[targetElement],\n\t\t\t\tremoveClass(elementsRef.current[targetElement], animationClass)\n\t\t\t);\n\n\t\t\ton(\n\t\t\t\t\"animationend\",\n\t\t\t\telementsRef.current[targetElement],\n\t\t\t\tremoveClass(elementsRef.current[targetElement], animationClass)\n\t\t\t);\n\t\t}\n\t});\n\n\t// Add animation classes to elements and remove them after the animation ends\n\tconst handleElementsAnimation = useCallback(() => {\n\t\taddAnimationClasses();\n\n\t\tremoveAnimationClasses();\n\t}, [addAnimationClasses, removeAnimationClasses]);\n\n\treturn { animatedElements: elementsRef.current, handleElementsAnimation };\n};\n\nexport { useAnimateElementRefs };\n","import { useRef } from \"react\";\n\nexport const useConstant = <TResult>(initCallbackFn: () => TResult): TResult => {\n\tconst resultRef = useRef<TResult | null>(null);\n\n\t// eslint-disable-next-line ts-eslint/prefer-nullish-coalescing -- The current case is justified since it's optimizable by the react compiler\n\tif (resultRef.current === null) {\n\t\tresultRef.current = initCallbackFn();\n\t}\n\n\treturn resultRef.current;\n};\n\nexport const useLazyRef = <TResult>(initCallbackFn: () => TResult): React.RefObject<TResult> => {\n\tconst resultRef = useRef<TResult | null>(null);\n\n\t// eslint-disable-next-line ts-eslint/prefer-nullish-coalescing -- The current case is justified since it's optimizable by the react compiler\n\tif (resultRef.current === null) {\n\t\tresultRef.current = initCallbackFn();\n\t}\n\n\treturn resultRef as React.RefObject<TResult>;\n};\n","import { type AnimationIntervalOptions, setAnimationInterval } from \"@zayne-labs/toolkit-core\";\nimport type { Prettify } from \"@zayne-labs/toolkit-type-helpers\";\nimport { useEffect } from \"react\";\nimport { useCallbackRef } from \"./useCallbackRef\";\nimport { useConstant } from \"./useConstant\";\n\ntype AnimationOptions = Prettify<\n\tAnimationIntervalOptions & {\n\t\tintervalDuration: number | null;\n\t\tonAnimation: () => void;\n\t}\n>;\n\nconst useAnimationInterval = (options: AnimationOptions) => {\n\tconst { intervalDuration, onAnimation, once } = options;\n\n\tconst latestCallback = useCallbackRef(onAnimation);\n\n\t// prettier-ignore\n\tconst { start, stop } = useConstant(() => setAnimationInterval(latestCallback, intervalDuration, { once }));\n\n\tuseEffect(() => {\n\t\tif (intervalDuration === null) return;\n\n\t\tstart();\n\n\t\treturn stop;\n\t\t// eslint-disable-next-line react-hooks/exhaustive-deps -- start and stop are stable\n\t}, [intervalDuration]);\n\n\treturn { start, stop };\n};\n\nexport { useAnimationInterval };\n","import { onClickOutside, toArray } from \"@zayne-labs/toolkit-core\";\nimport { useEffect, useRef } from \"react\";\nimport { useCallbackRef } from \"./useCallbackRef\";\n\ntype UseClickOutsideOptions<TElement extends HTMLElement> = {\n\tenabled?: boolean;\n\tonClick: (event: MouseEvent | TouchEvent) => void;\n\tref?: Array<React.RefObject<TElement>> | React.RefObject<TElement>;\n};\n\nconst useClickOutside = <TElement extends HTMLElement>(options: UseClickOutsideOptions<TElement>) => {\n\tconst innerRef = useRef<TElement>(null);\n\n\tconst { enabled = true, onClick, ref: refOrRefArray = innerRef } = options;\n\n\tconst savedOnClick = useCallbackRef(onClick);\n\n\tuseEffect(() => {\n\t\tif (!enabled) return;\n\n\t\tconst elementArray = toArray(refOrRefArray).map((ref) => ref.current);\n\n\t\tconst cleanup = onClickOutside(elementArray, savedOnClick);\n\n\t\treturn () => cleanup();\n\t}, [enabled, refOrRefArray, savedOnClick]);\n\n\treturn {\n\t\tref: innerRef,\n\t};\n};\n\nexport { useClickOutside };\n","import { copyToClipboard } from \"@zayne-labs/toolkit-core\";\nimport { useState } from \"react\";\n\nconst useCopyToClipboard = () => {\n\tconst [state, setState] = useState(\"\");\n\n\tconst handleCopy = (value: string) => {\n\t\tsetState(value);\n\t\tvoid copyToClipboard(value);\n\t};\n\n\treturn { copiedValue: state, handleCopy };\n};\n\nexport { useCopyToClipboard };\n","import { debounce } from \"@zayne-labs/toolkit-core\";\nimport type { CallbackFn } from \"@zayne-labs/toolkit-type-helpers\";\nimport { useState } from \"react\";\nimport { useUnmountEffect } from \"./effects/useUnMountEffect\";\nimport { useCallbackRef } from \"./useCallbackRef\";\nimport { useConstant } from \"./useConstant\";\n\nexport const useDebouncedFn = <TParams>(callBackFn: CallbackFn<TParams>, delay: number | undefined) => {\n\tconst latestCallback = useCallbackRef(callBackFn);\n\n\tconst debouncedFn = useConstant(() => debounce(latestCallback, delay));\n\n\tuseUnmountEffect(() => {\n\t\tdebouncedFn.cancel();\n\t\tdebouncedFn.cancelMaxWait();\n\t});\n\n\treturn debouncedFn;\n};\n\nexport const useDebouncedState = <TValue>(defaultValue: TValue, delay: number | undefined) => {\n\tconst [value, setValue] = useState(defaultValue);\n\n\tconst setDebouncedValue = useConstant(() => debounce(setValue, delay));\n\n\tuseUnmountEffect(() => {\n\t\tsetDebouncedValue.cancel();\n\t\tsetDebouncedValue.cancelMaxWait();\n\t});\n\n\treturn [value, setDebouncedValue, setValue] as const;\n};\n","import { useCallback, useState } from \"react\";\n\ntype InitialState = boolean | (() => boolean);\n\nconst useToggle = (initialValue: InitialState = false) => {\n\tconst [value, setValue] = useState(initialValue);\n\n\tconst toggle = useCallback(<TValue>(newValue?: TValue) => {\n\t\tif (typeof newValue === \"boolean\") {\n\t\t\tsetValue(newValue);\n\t\t\treturn;\n\t\t}\n\n\t\tsetValue((prev) => !prev);\n\t}, []);\n\n\treturn [value, toggle] as const;\n};\n\nexport { useToggle };\n","import { lockScroll } from \"@zayne-labs/toolkit-core\";\nimport { isBoolean } from \"@zayne-labs/toolkit-type-helpers\";\nimport { useMemo } from \"react\";\nimport { useCallbackRef } from \"./useCallbackRef\";\nimport { useToggle } from \"./useToggle\";\n\ntype DisclosureOptions = {\n\thasScrollControl?: boolean;\n\tinitialState?: boolean | (() => boolean);\n};\n\nconst useDisclosure = (options: DisclosureOptions = {}) => {\n\tconst { hasScrollControl = false, initialState = false } = options;\n\tconst [isOpen, toggleIsOpen] = useToggle(initialState);\n\n\tconst onOpen = useCallbackRef(() => {\n\t\ttoggleIsOpen(true);\n\t\thasScrollControl && lockScroll({ lock: true });\n\t});\n\n\tconst onClose = useCallbackRef(() => {\n\t\ttoggleIsOpen(false);\n\t\thasScrollControl && lockScroll({ lock: false });\n\t});\n\n\tconst onToggle = useCallbackRef(<TValue>(value?: TValue) => {\n\t\tif (isBoolean(value)) {\n\t\t\ttoggleIsOpen(value);\n\t\t\thasScrollControl && lockScroll({ lock: value });\n\t\t\treturn;\n\t\t}\n\n\t\tisOpen ? onClose() : onOpen();\n\t});\n\n\tconst api = useMemo(() => ({ isOpen, onClose, onOpen, onToggle }), [isOpen, onClose, onOpen, onToggle]);\n\n\treturn api;\n};\nexport { useDisclosure };\n","import { useSyncExternalStore } from \"react\";\n\nconst noop = () => {};\n\nconst emptySubscribe = () => noop;\n\n/**\n * @description Return a boolean indicating if the JS has been hydrated already.\n * When doing Server-Side Rendering, the result will always be false.\n * When doing Client-Side Rendering, the result will always be false on the\n * first render and true from then on. Even if a new component renders it will\n * always start with true.\n *\n * @see https://github.com/sergiodxa/remix-utils/blob/main/src/react/use-hydrated.ts\n *\n * @see https://github.com/sergiodxa/remix-utils/blob/main/src/react/use-hydrated.ts\n *\n * @example\n * **Example: Disable a button that needs JS to work.**\n * ```tsx\n * const isHydrated = useIsHydrated();\n *\n * return (\n * <button type=\"button\" disabled={!isHydrated} onClick={doSomethingCustom}>\n * Click me\n * </button>\n * );\n * ```\n */\nexport const useIsHydrated = () => {\n\tconst isHydrated = useSyncExternalStore(\n\t\temptySubscribe,\n\t\t() => true,\n\t\t() => false\n\t);\n\n\treturn isHydrated;\n};\n","import { useSyncExternalStore } from \"react\";\n\nconst noopStore = {\n\tgetServerSnapshot: () => true,\n\tgetSnapshot: () => false,\n\t// eslint-disable-next-line unicorn/consistent-function-scoping -- It's fine\n\tsubscribe: () => () => {},\n};\n\n/**\n * @description Returns whether the component is currently being server side rendered or\n * hydrated on the client. Can be used to delay browser-specific rendering\n * until after hydration.\n */\nconst useIsServer = () => {\n\tconst isServer = useSyncExternalStore(\n\t\tnoopStore.subscribe,\n\t\tnoopStore.getSnapshot,\n\t\tnoopStore.getServerSnapshot\n\t);\n\n\treturn isServer;\n};\n\nexport { useIsServer };\n","import type { StoreApi } from \"@zayne-labs/toolkit-core\";\nimport type { SelectorFn } from \"@zayne-labs/toolkit-type-helpers\";\nimport { useCallback, useDebugValue, useSyncExternalStore } from \"react\";\n\nconst identity = <TState>(value: TState) => value;\n\nconst useStore = <TState, TSlice = TState>(\n\tstore: StoreApi<TState>,\n\tselector: SelectorFn<TState, TSlice> = identity as never\n) => {\n\tconst slice = useSyncExternalStore(\n\t\tstore.subscribe,\n\t\tuseCallback(() => selector(store.getState()), [store, selector]),\n\t\tuseCallback(() => selector(store.getInitialState()), [store, selector])\n\t);\n\n\tuseDebugValue(slice);\n\n\treturn slice;\n};\n\nexport { useStore };\n","import {\n\tcreateLocationStore,\n\ttype LocationInfo,\n\ttype LocationStoreApi,\n\ttype LocationStoreOptions,\n} from \"@zayne-labs/toolkit-core\";\nimport type { SelectorFn } from \"@zayne-labs/toolkit-type-helpers\";\nimport { useConstant } from \"./useConstant\";\nimport { useStore } from \"./useStore\";\n\ntype UseLocationResult<TSlice> = [state: TSlice, actions: LocationStoreApi];\n\nexport const createUseLocationState = (options?: LocationStoreOptions) => {\n\tconst locationStore = createLocationStore(options);\n\n\ttype UseBoundLocationState = LocationStoreApi\n\t\t& (<TSlice = LocationInfo>(\n\t\t\tselector?: SelectorFn<LocationInfo, TSlice>\n\t\t) => UseLocationResult<TSlice>);\n\n\tconst useLocationState = <TSlice = LocationInfo>(\n\t\tselector?: SelectorFn<LocationInfo, TSlice>\n\t): UseLocationResult<TSlice> => {\n\t\tconst stateSlice = useStore(locationStore as never, selector);\n\n\t\treturn [stateSlice, locationStore];\n\t};\n\n\tObject.assign(useLocationState, locationStore);\n\n\treturn useLocationState as UseBoundLocationState;\n};\n\nexport const useLocationState = <TSlice = LocationInfo>(\n\tselector?: SelectorFn<LocationInfo, TSlice>,\n\toptions?: LocationStoreOptions\n): UseLocationResult<TSlice> => {\n\tconst locationStore = useConstant(() => createLocationStore(options));\n\n\tconst stateSlice = useStore(locationStore as never, selector);\n\n\treturn [stateSlice, locationStore];\n};\n","import { on } from \"@zayne-labs/toolkit-core\";\nimport { useEffect, useRef, useState } from \"react\";\nimport { useCallbackRef } from \"../useCallbackRef\";\nimport { useDebouncedState } from \"../useDebounce\";\nimport type { UseSpecificPresence } from \"./types\";\n\nconst useAnimationPresence: UseSpecificPresence = (options = {}) => {\n\tconst { defaultValue = true, duration, onExitComplete } = options;\n\n\tconst [isShown, setIsShown] = useState(defaultValue);\n\n\tconst [isMounted, setDebouncedIsMounted, setRegularIsMounted] = useDebouncedState(\n\t\tdefaultValue,\n\t\tduration\n\t);\n\tconst elementRef = useRef<HTMLElement>(null);\n\n\tconst stableOnExitComplete = useCallbackRef(onExitComplete);\n\n\tuseEffect(() => {\n\t\t!isMounted && stableOnExitComplete();\n\t\t// eslint-disable-next-line react-hooks/exhaustive-deps -- stableOnExitComplete is stable\n\t}, [isMounted]);\n\n\tconst handleIsMountedWithoutRef = (value: boolean) => {\n\t\tif (value) {\n\t\t\tsetRegularIsMounted(true);\n\t\t\treturn;\n\t\t}\n\n\t\tsetDebouncedIsMounted(false);\n\t};\n\n\tconst handleIsMountedWithRef = (value: boolean) => {\n\t\tif (value) {\n\t\t\tsetRegularIsMounted(true);\n\t\t\treturn;\n\t\t}\n\n\t\ton(\"animationend\", elementRef.current, () => {\n\t\t\tsetDebouncedIsMounted.cancel();\n\t\t\tsetRegularIsMounted(false);\n\t\t});\n\t};\n\n\tconst toggleVisibility = useCallbackRef(<TValue>(newValue?: TValue) => {\n\t\tconst handleSetIsMounted = !duration ? handleIsMountedWithRef : handleIsMountedWithoutRef;\n\n\t\tif (typeof newValue === \"boolean\") {\n\t\t\tsetIsShown(newValue);\n\t\t\thandleSetIsMounted(newValue);\n\t\t\treturn;\n\t\t}\n\n\t\tsetIsShown(!isShown);\n\t\thandleSetIsMounted(!isShown);\n\t});\n\n\treturn {\n\t\tisPresent: isMounted,\n\t\tisVisible: isShown,\n\t\ttoggleVisibility,\n\t\t...(duration === undefined && { elementRef }),\n\t} as never;\n};\n\nexport { useAnimationPresence };\n","import { on } from \"@zayne-labs/toolkit-core\";\nimport { useEffect, useRef, useState } from \"react\";\nimport { useCallbackRef } from \"../useCallbackRef\";\nimport { useDebouncedState } from \"../useDebounce\";\nimport type { UseSpecificPresence } from \"./types\";\n\nconst useTransitionPresence: UseSpecificPresence = (options = {}) => {\n\tconst { defaultValue = true, duration, onExitComplete } = options;\n\n\tconst [isShown, setIsShown] = useState(defaultValue);\n\n\tconst [isMounted, setDebouncedIsMounted, setRegularIsMounted] = useDebouncedState(\n\t\tdefaultValue,\n\t\tduration\n\t);\n\tconst elementRef = useRef<HTMLElement>(null);\n\tconst stableOnExitComplete = useCallbackRef(onExitComplete);\n\n\tconst handleIsMountedWithoutRef = (value: boolean) => {\n\t\tif (value) {\n\t\t\tsetDebouncedIsMounted(value, { $delay: 0 });\n\t\t\treturn;\n\t\t}\n\n\t\tsetDebouncedIsMounted(false);\n\t};\n\n\tconst handleIsMountedWithRef = (value: boolean) => {\n\t\tif (value) {\n\t\t\tsetDebouncedIsMounted(value, { $delay: 0 });\n\t\t\treturn;\n\t\t}\n\n\t\ton(\"transitionend\", elementRef.current, () => {\n\t\t\tsetDebouncedIsMounted.cancel();\n\t\t\tsetRegularIsMounted(false);\n\t\t});\n\t};\n\n\tconst toggleVisibility = useCallbackRef(<TValue>(newValue?: TValue) => {\n\t\tconst handleSetIsMounted = !duration ? handleIsMountedWithRef : handleIsMountedWithoutRef;\n\n\t\tif (typeof newValue === \"boolean\") {\n\t\t\tsetIsShown(newValue);\n\t\t\thandleSetIsMounted(newValue);\n\t\t\treturn;\n\t\t}\n\n\t\tsetIsShown(!isShown);\n\t\thandleSetIsMounted(!isShown);\n\t});\n\n\tuseEffect(() => {\n\t\t!isMounted && stableOnExitComplete();\n\t\t// eslint-disable-next-line react-hooks/exhaustive-deps -- stableOnExitComplete is stable\n\t}, [isMounted]);\n\n\treturn {\n\t\tisPresent: isMounted || isShown,\n\t\tisVisible: isMounted && isShown,\n\t\ttoggleVisibility,\n\t\t...(duration === undefined && { elementRef }),\n\t} as never;\n};\n\nexport { useTransitionPresence };\n","import type { UsePresence } from \"./types\";\nimport { useAnimationPresence } from \"./useAnimationPresence\";\nimport { useTransitionPresence } from \"./useTransitionPresence\";\n\n/**\n * usePresence hook provides a way to animate an element, before removing it from the DOM.\n * @param defaultValue - The default value for the presence state. Defaults to `true`.\n * @param options - The options for the usePresence hook.\n * @returns A object containing the boolean that should be used to conditionally render the element (isPresent), another boolean used to toggle the animation classes, and a function to toggle the state.\n */\n\nconst usePresence: UsePresence = (options = {}) => {\n\tconst { type = \"transition\", ...restOfOptions } = options;\n\n\tconst useSpecificPresence = type === \"transition\" ? useTransitionPresence : useAnimationPresence;\n\n\treturn useSpecificPresence(restOfOptions);\n};\n\nexport { usePresence };\n","import { type ScrollObserverOptions, createScrollObserver } from \"@zayne-labs/toolkit-core\";\nimport { type RefCallback, useState } from \"react\";\nimport { useCallbackRef } from \"./useCallbackRef\";\nimport { useConstant } from \"./useConstant\";\n\nconst useScrollObserver = <TElement extends HTMLElement>(options: ScrollObserverOptions = {}) => {\n\tconst { onIntersection, rootMargin = \"10px 0px 0px 0px\", ...restOfOptions } = options;\n\n\tconst [isScrolled, setIsScrolled] = useState(false);\n\n\tconst savedOnIntersection = useCallbackRef(onIntersection);\n\n\tconst { handleObservation } = useConstant(() => {\n\t\treturn createScrollObserver({\n\t\t\tonIntersection: (entry, observer) => {\n\t\t\t\tconst newIsScrolledState = !entry.isIntersecting;\n\n\t\t\t\tsetIsScrolled(newIsScrolledState);\n\n\t\t\t\t// eslint-disable-next-line no-param-reassign -- Mutation is fine here\n\t\t\t\t(entry.target as HTMLElement).dataset.scrolled = String(newIsScrolledState);\n\n\t\t\t\tsavedOnIntersection(entry, observer);\n\t\t\t},\n\t\t\trootMargin,\n\t\t\t...restOfOptions,\n\t\t});\n\t});\n\n\tconst observedElementRef: RefCallback<TElement> = useCallbackRef((element) => {\n\t\tconst cleanupFn = handleObservation(element);\n\n\t\t// == React 18 may not call the cleanup function so we need to call it manually on element unmount\n\t\tif (!element) {\n\t\t\tcleanupFn?.();\n\t\t\treturn;\n\t\t}\n\n\t\treturn cleanupFn;\n\t});\n\n\treturn { isScrolled, observedElementRef };\n};\n\nexport { useScrollObserver };\n","import { isPlainObject } from \"@zayne-labs/toolkit-type-helpers\";\nimport { useState } from \"react\";\nimport { useAfterMountEffect } from \"./effects/useAfterMountEffect\";\nimport { useDebouncedFn } from \"./useDebounce\";\n\nconst isSerializable = (item: unknown): item is boolean | number | string =>\n\ttypeof item === \"string\" || typeof item === \"number\" || typeof item === \"boolean\";\n\nconst checkObjectPropsForQuery = (item: Record<string, unknown>, query: string): boolean => {\n\tfor (const value of Object.values(item)) {\n\t\tif (isSerializable(value) && value.toString().toLowerCase().includes(query)) {\n\t\t\treturn true;\n\t\t}\n\t}\n\treturn false;\n};\n\nconst useSearch = <TData>(initialData: TData[], delay?: number) => {\n\tconst [searchQuery, setSearchQuery] = useState(\"\");\n\tconst [filteredData, setFilteredData] = useState(initialData);\n\tconst [isLoading, setIsLoading] = useState(false);\n\n\tconst handleDebouncedSearch = useDebouncedFn(() => {\n\t\tconst query = searchQuery.toLowerCase();\n\n\t\tconst filteredResults = initialData.filter((item) => {\n\t\t\tif (isSerializable(item)) {\n\t\t\t\treturn item.toString().toLowerCase().includes(query);\n\t\t\t}\n\n\t\t\tif (isPlainObject(item)) {\n\t\t\t\treturn checkObjectPropsForQuery(item, query);\n\t\t\t}\n\n\t\t\treturn false;\n\t\t});\n\n\t\tsetFilteredData(filteredResults);\n\t\tsetIsLoading(false);\n\t}, delay);\n\n\tuseAfterMountEffect(() => {\n\t\tsetIsLoading(true);\n\t\thandleDebouncedSearch();\n\t}, [searchQuery]);\n\n\treturn { data: filteredData, isLoading, query: searchQuery, setQuery: setSearchQuery };\n};\n\nexport { useSearch };\n","import {\n\ttype LocationStoreOptions,\n\ttype URLSearchParamsInit,\n\tcreateSearchParams,\n} from \"@zayne-labs/toolkit-core\";\nimport { isFunction } from \"@zayne-labs/toolkit-type-helpers\";\nimport { useLocationState } from \"./useLocationState\";\n\ntype UseSearchParamsOptions = LocationStoreOptions & {\n\taction?: \"push\" | \"replace\";\n};\n\nexport const useSearchParams = <TSearchParams extends URLSearchParamsInit>(\n\toptions?: UseSearchParamsOptions\n) => {\n\tconst { action = \"push\", ...restOfOptions } = options ?? {};\n\n\tconst [searchParams, actions] = useLocationState((state) => state.search, restOfOptions);\n\n\tconst setSearchParams = (\n\t\tnewQueryParams: TSearchParams | ((prev: URLSearchParams) => TSearchParams)\n\t) => {\n\t\tconst params = isFunction(newQueryParams) ? newQueryParams(searchParams) : newQueryParams;\n\n\t\tconst nextSearchParams = createSearchParams(params);\n\n\t\tactions[action]({ search: nextSearchParams });\n\t};\n\n\tsetSearchParams.triggerPopstateEvent = actions.triggerPopstateEvent;\n\n\treturn [searchParams, setSearchParams] as const;\n};\n\nexport const useSearchParamsObject = <TSearchParams extends Record<string, string>>(\n\toptions?: UseSearchParamsOptions\n) => {\n\tconst [searchParams, setSearchParams] = useSearchParams(options);\n\n\tconst searchParamsObject = Object.fromEntries(searchParams) as TSearchParams;\n\n\tconst setSearchParamsObject = (\n\t\tnewQueryParams: TSearchParams | ((prev: TSearchParams) => TSearchParams)\n\t) => {\n\t\tconst params = isFunction(newQueryParams) ? newQueryParams(searchParamsObject) : newQueryParams;\n\n\t\tsetSearchParams(params);\n\t};\n\n\tsetSearchParamsObject.triggerPopstateEvent = setSearchParams.triggerPopstateEvent;\n\n\treturn [searchParamsObject, setSearchParamsObject] as const;\n};\n","import { shallowCompare } from \"@zayne-labs/toolkit-core\";\nimport type { SelectorFn } from \"@zayne-labs/toolkit-type-helpers\";\nimport { useRef } from \"react\";\n\nexport const useShallowComparedSelector = <TState, TResult>(selector: SelectorFn<TState, TResult>) => {\n\tconst prevStateRef = useRef<TResult>(undefined as never);\n\n\tconst shallowSelector = (state: TState) => {\n\t\tconst nextState = selector(state);\n\n\t\tif (shallowCompare(prevStateRef.current, nextState)) {\n\t\t\treturn prevStateRef.current;\n\t\t}\n\n\t\treturn (prevStateRef.current = nextState);\n\t};\n\n\treturn shallowSelector;\n};\n\nexport const useShallowComparedValue = <TValue>(value: TValue) => {\n\tconst prevValueRef = useRef<TValue>(value);\n\n\tif (shallowCompare(prevValueRef.current, value)) {\n\t\treturn prevValueRef.current;\n\t}\n\n\treturn (prevValueRef.current = value);\n};\n","import {\n\tcreateExternalStorageStore,\n\ttype StorageOptions,\n\ttype StorageStoreApi,\n} from \"@zayne-labs/toolkit-core\";\nimport type { SelectorFn } from \"@zayne-labs/toolkit-type-helpers\";\nimport { useConstant } from \"./useConstant\";\nimport { useStore } from \"./useStore\";\n\ntype UseStorageResult<TState, TSlice = TState> = [state: TSlice, actions: StorageStoreApi<TState>];\n\n/**\n * @description Creates a custom hook that returns a storage state and actions to modify it. You can use this if you need shared options.\n * @note You must use this if you want to be able to prevent syncing state across tabs.\n */\nexport const createUseStorageState = <TState>(baseOptions: StorageOptions<TState>) => {\n\tconst externalStore = createExternalStorageStore(baseOptions);\n\n\ttype UseBoundStorageState = StorageStoreApi<TState>\n\t\t& (<TSlice = TState>(selector?: SelectorFn<TState, TSlice>) => UseStorageResult<TState, TSlice>);\n\n\tconst useStorageState = <TSlice = TState>(\n\t\tselector?: SelectorFn<TState, TSlice>\n\t): UseStorageResult<TState, TSlice> => {\n\t\tconst stateInStorage = useStore(externalStore, selector);\n\n\t\treturn [stateInStorage, externalStore];\n\t};\n\n\tObject.assign(useStorageState, externalStore);\n\n\treturn useStorageState as UseBoundStorageState;\n};\n\ntype UseStorageStateOptions<TValue> = Omit<StorageOptions<TValue>, \"initialValue\" | \"key\">;\n\nexport const useStorageState = <TValue, TSlice = TValue>(\n\tkey: string,\n\tinitialValue?: TValue,\n\toptions?: UseStorageStateOptions<TValue> & { select?: SelectorFn<TValue, TSlice> }\n): UseStorageResult<TValue, TSlice> => {\n\tconst { select, ...restOfOptions } = options ?? {};\n\n\tconst externalStore = useConstant(() => {\n\t\treturn createExternalStorageStore({ initialValue, key, ...restOfOptions });\n\t});\n\n\tconst stateInStorage = useStore(externalStore as never, select as never);\n\n\treturn [stateInStorage as never, externalStore];\n};\n","import { throttleByFrame, throttleBySetTimeout, throttleByTime } from \"@zayne-labs/toolkit-core\";\nimport type { CallbackFn } from \"@zayne-labs/toolkit-type-helpers\";\nimport { useUnmountEffect } from \"./effects\";\nimport { useCallbackRef } from \"./useCallbackRef\";\nimport { useConstant } from \"./useConstant\";\n\nexport const useThrottleBySetTimeout = <TParams>(callbackFn: CallbackFn<TParams>, delay: number) => {\n\tconst latestCallback = useCallbackRef(callbackFn);\n\n\tconst throttledCallback = useConstant(() => throttleBySetTimeout(latestCallback, delay));\n\n\tuseUnmountEffect(() => throttledCallback.cancelTimeout());\n\n\treturn throttledCallback;\n};\n\nexport const useThrottleByTimer = <TParams>(callbackFn: CallbackFn<TParams>, delay: number) => {\n\tconst latestCallback = useCallbackRef(callbackFn);\n\n\tconst throttledCallback = useConstant(() => throttleByTime(latestCallback, delay));\n\n\treturn throttledCallback;\n};\n\nexport const useThrottleByFrame = <TParams>(callbackFn: CallbackFn<TParams>) => {\n\tconst latestCallback = useCallbackRef(callbackFn);\n\n\tconst throttledCallback = useConstant(() => throttleByFrame(latestCallback));\n\n\tuseUnmountEffect(() => throttledCallback.cancelAnimation());\n\n\treturn throttledCallback;\n};\n"],"mappings":"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"}