@zayne-labs/toolkit-react 0.9.29 → 0.9.30

package/dist/esm/{chunk-CEKHHIKA.js → chunk-F46ZNZPZ.js}

@@ -1,4 +1,4 @@
-import { defineEnum, isArray, isPlainObject, isFunction } from '@zayne-labs/toolkit-type-helpers';
+import { defineEnum, isArray, isBoolean, isPlainObject, isFunction } from '@zayne-labs/toolkit-type-helpers';
 import { createContext, useRef, useLayoutEffect, useCallback, useEffect, useState, useSyncExternalStore, useDebugValue, use } from 'react';
 import { on, setAnimationInterval, toArray, onClickOutside, debounce, lockScroll, createLocationStore, createScrollObserver, createExternalStorageStore, throttleBySetTimeout, throttleByTime, throttleByFrame, copyToClipboard, createSearchParams } from '@zayne-labs/toolkit-core';
 
@@ -216,19 +216,18 @@ var useToggle = (initialValue = false) => {
 var useDisclosure = (options = {}) => {
   const { hasScrollControl = false, initialState = false } = options;
   const [isOpen, toggleIsOpen] = useToggle(initialState);
-  const onOpen = useCallbackRef((value) => {
-    const booleanValue = typeof value === "boolean" && value ? value : true;
-    toggleIsOpen(booleanValue);
-    hasScrollControl && lockScroll({ lock: booleanValue });
+  const onOpen = useCallbackRef(() => {
+    toggleIsOpen(true);
+    hasScrollControl && lockScroll({ lock: true });
   });
-  const onClose = useCallbackRef((value) => {
-    const booleanValue = typeof value === "boolean" && !value ? value : false;
-    toggleIsOpen(booleanValue);
-    hasScrollControl && lockScroll({ lock: booleanValue });
+  const onClose = useCallbackRef(() => {
+    toggleIsOpen(false);
+    hasScrollControl && lockScroll({ lock: false });
   });
   const onToggle = useCallbackRef((value) => {
-    if (typeof value === "boolean") {
-      value ? onOpen(value) : onClose(value);
+    if (isBoolean(value)) {
+      toggleIsOpen(value);
+      hasScrollControl && lockScroll({ lock: value });
       return;
     }
     isOpen ? onClose() : onOpen();
@@ -489,5 +488,5 @@ var useThrottleByFrame = (callbackFn) => {
 };
 
 export { ContextError, createCustomContext, createStorageStore, getErrorMessage, useAfterMountEffect, useAnimateElementRefs, useAnimationInterval, useAsyncEffect, useCallbackRef, useClickOutside, useConstant, useCopyToClipboard, useDebouncedFn, useDebouncedState, useDisclosure, useEffectOnce, useIsServer, useLifeCycle, useLocation, useMountEffect, usePresence, useScrollObserver, useSearch, useSearchParams, useSearchParamsObject, useStorageState, useStore, useThrottleByFrame, useThrottleBySetTimeout, useThrottleByTimer, useToggle, useUnmountEffect };
-//# sourceMappingURL=chunk-CEKHHIKA.js.map
-//# sourceMappingURL=chunk-CEKHHIKA.js.map
+//# sourceMappingURL=chunk-F46ZNZPZ.js.map
+//# sourceMappingURL=chunk-F46ZNZPZ.js.map

package/dist/esm/chunk-F46ZNZPZ.js.map

@@ -0,0 +1 @@
+{"version":3,"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/useIsServer.ts","../../src/hooks/useStore.ts","../../src/hooks/useLocation.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/useStorageState.ts","../../src/hooks/useThrottle.ts"],"names":["useRef","useEffect","useCallback","useState","useSyncExternalStore","on","useStorageState"],"mappings":"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","file":"chunk-F46ZNZPZ.js","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\tconstructor(...args: Parameters<typeof Error>) {\n\t\tsuper(...args);\n\n\t\tError.captureStackTrace(this, this.constructor);\n\t}\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> = TStrict extends true\n\t? TContextValue\n\t: 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.Provider, 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\nconst useConstant = <TResult>(initCallbackFn: () => 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 { useConstant };\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 } from \"react\";\nimport { useCallbackRef } from \"./useCallbackRef\";\n\ntype UseClickOutsideOptions = {\n\tenabled?: boolean;\n};\n\nconst useClickOutside = <TElement extends HTMLElement>(\n\trefOrRefArray: Array<React.RefObject<TElement>> | React.RefObject<TElement>,\n\tcallback: (event: MouseEvent | TouchEvent) => void,\n\toptions?: UseClickOutsideOptions\n) => {\n\tconst { enabled = true } = options ?? {};\n\n\tconst savedCallback = useCallbackRef(callback);\n\n\tuseEffect(() => {\n\t\tif (!enabled) return;\n\n\t\tconst controller = new AbortController();\n\n\t\tconst elementArray = toArray(refOrRefArray).map((ref) => ref.current);\n\n\t\tonClickOutside(elementArray, savedCallback, { signal: controller.signal });\n\n\t\treturn () => {\n\t\t\tcontroller.abort();\n\t\t};\n\t}, [enabled, refOrRefArray, savedCallback]);\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 { 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\treturn { isOpen, onClose, onOpen, onToggle };\n};\nexport { useDisclosure };\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 { useDebugValue, useSyncExternalStore } from \"react\";\n\nconst identity = <TState>(x: TState) => x;\n\nconst useStore = <TState, TSlice>(\n\tstore: StoreApi<TState>,\n\tselector: SelectorFn<TState, TSlice> = identity as never\n) => {\n\tconst slice = useSyncExternalStore(\n\t\tstore.subscribe,\n\t\t() => selector(store.getState()),\n\t\t() => selector(store.getInitialState())\n\t);\n\n\tuseDebugValue(slice);\n\n\treturn slice;\n};\n\nexport { useStore };\n","import {\n\ttype LocationInfo,\n\ttype LocationStoreOptions,\n\tcreateLocationStore,\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 LocationStore = ReturnType<typeof createLocationStore>;\n\ntype UseLocationResult<TSlice> = [\n\tstate: TSlice,\n\tsetState: {\n\t\tpush: LocationStore[\"push\"];\n\t\treplace: LocationStore[\"replace\"];\n\t\ttriggerPopstate: LocationStore[\"triggerPopstateEvent\"];\n\t},\n];\n\nconst useLocation = <TSlice = LocationInfo>(\n\tselector?: SelectorFn<LocationInfo, TSlice>,\n\toptions?: LocationStoreOptions\n) => {\n\tconst locationStore = useConstant(() => createLocationStore(options));\n\n\tconst stateSlice = useStore(locationStore as never, selector);\n\n\treturn [\n\t\tstateSlice,\n\t\t{\n\t\t\tpush: locationStore.push,\n\t\t\treplace: locationStore.replace,\n\t\t\ttriggerPopstate: locationStore.triggerPopstateEvent,\n\t\t},\n\t] as UseLocationResult<TSlice>;\n};\n\nexport { useLocation };\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 { useLocation } from \"./useLocation\";\n\ntype UseSearchParamsOptions = {\n\taction?: \"push\" | \"replace\";\n\tlocationOptions?: LocationStoreOptions;\n};\n\nexport const useSearchParams = <TSearchParams extends URLSearchParamsInit>(\n\toptions?: UseSearchParamsOptions\n) => {\n\tconst { action = \"push\", locationOptions } = options ?? {};\n\n\tconst [searchParams, setLocation] = useLocation((state) => state.search, locationOptions);\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\tif (Object.is(searchParams.toString(), nextSearchParams.toString())) return;\n\n\t\tsetLocation[action]({ search: nextSearchParams });\n\t};\n\n\tsetSearchParams.triggerPopstate = setLocation.triggerPopstate;\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\treturn [searchParamsObject, setSearchParamsObject] as const;\n};\n","import {\n\ttype StorageOptions,\n\ttype StorageStoreApi,\n\tcreateExternalStorageStore,\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\nexport const createStorageStore = <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\t};\n\n\tconst useStorageState = (selector?: SelectorFn<TState, unknown>) => {\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"]}

package/dist/esm/hooks/index.d.ts

@@ -87,8 +87,8 @@ type DisclosureOptions = {
 };
 declare const useDisclosure: (options?: DisclosureOptions) => {
     isOpen: boolean;
-    onClose: <TValue>(value?: TValue) => void;
-    onOpen: <TValue>(value?: TValue) => void;
+    onClose: () => void;
+    onOpen: () => void;
     onToggle: <TValue>(value?: TValue) => void;
 };
 

package/dist/esm/hooks/index.js

@@ -1,3 +1,3 @@
-export { ContextError, createCustomContext, createStorageStore, getErrorMessage, useAfterMountEffect, useAnimateElementRefs, useAnimationInterval, useAsyncEffect, useCallbackRef, useClickOutside, useConstant, useCopyToClipboard, useDebouncedFn, useDebouncedState, useDisclosure, useEffectOnce, useIsServer, useLifeCycle, useLocation, useMountEffect, usePresence, useScrollObserver, useSearch, useSearchParams, useSearchParamsObject, useStorageState, useStore, useThrottleByFrame, useThrottleBySetTimeout, useThrottleByTimer, useToggle, useUnmountEffect } from '../chunk-CEKHHIKA.js';
+export { ContextError, createCustomContext, createStorageStore, getErrorMessage, useAfterMountEffect, useAnimateElementRefs, useAnimationInterval, useAsyncEffect, useCallbackRef, useClickOutside, useConstant, useCopyToClipboard, useDebouncedFn, useDebouncedState, useDisclosure, useEffectOnce, useIsServer, useLifeCycle, useLocation, useMountEffect, usePresence, useScrollObserver, useSearch, useSearchParams, useSearchParamsObject, useStorageState, useStore, useThrottleByFrame, useThrottleBySetTimeout, useThrottleByTimer, useToggle, useUnmountEffect } from '../chunk-F46ZNZPZ.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/esm/utils/index.d.ts

@@ -2,13 +2,13 @@ import * as react from 'react';
 import { RefCallback } from 'react';
 import { AnyFunction, UnknownObject, Prettify, UnionToIntersection as UnionToIntersection$1, UnionDiscriminator, AnyObject } from '@zayne-labs/toolkit-type-helpers';
 
-type PossibleRef<TRef> = React.Ref<TRef> | undefined;
+type PossibleRef<TRef extends HTMLElement> = React.Ref<TRef> | undefined;
 /**
  * @description Set a given ref to a given value.
  *
  * This utility takes care of different types of refs: callback refs and RefObject(s)
  */
-declare const setRef: <TRef>(ref: PossibleRef<TRef>, node: TRef) => ReturnType<RefCallback<TRef>>;
+declare const setRef: <TRef extends HTMLElement>(ref: PossibleRef<TRef>, node: TRef | null) => ReturnType<RefCallback<TRef>>;
 /**
  * @description A utility to combine refs. Accepts callback refs and RefObject(s)
  */

package/dist/esm/utils/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/utils/composeRefs.ts","../../../src/utils/composeEventHandlers.ts","../../../src/utils/getSlot.ts","../../../src/utils/getSlotMap.ts","../../../src/utils/mergeTwoProps.ts","../../../src/utils/mergeProps.ts"],"names":["result","isFunction","ReactFragment","isValidElement","toArray"],"mappings":"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","file":"index.js","sourcesContent":["import { isFunction } from \"@zayne-labs/toolkit-type-helpers\";\nimport { type RefCallback, useCallback } from \"react\";\n\ntype PossibleRef<TRef> = React.Ref<TRef> | undefined;\n\n/**\n * @description Set a given ref to a given value.\n *\n * This utility takes care of different types of refs: callback refs and RefObject(s)\n */\nexport const setRef = <TRef>(ref: PossibleRef<TRef>, node: TRef): ReturnType<RefCallback<TRef>> => {\n\tif (!ref) return;\n\n\tif (isFunction(ref)) {\n\t\treturn ref(node);\n\t}\n\n\t// eslint-disable-next-line no-param-reassign -- Mutation is needed here\n\tref.current = node;\n};\n\n/**\n * @description A utility to combine refs. Accepts callback refs and RefObject(s)\n */\nexport const composeRefs = <TRef extends HTMLElement>(\n\t...refs: Array<PossibleRef<TRef>>\n): RefCallback<TRef> => {\n\tconst mergedRefCallBack: RefCallback<TRef> = (node) => {\n\t\tconst cleanupFnArray = refs.map((ref) => setRef(ref, node));\n\n\t\tconst cleanupFn = () => cleanupFnArray.forEach((cleanup) => cleanup?.());\n\n\t\treturn cleanupFn;\n\t};\n\n\treturn mergedRefCallBack;\n};\n\nexport const useComposeRefs = <TRef extends HTMLElement>(...refs: Array<PossibleRef<TRef>>) => {\n\t// eslint-disable-next-line react-hooks/exhaustive-deps -- Allow\n\tconst mergedRef = useCallback(() => composeRefs(...refs), refs);\n\n\treturn mergedRef;\n};\n","import { type AnyFunction, isObject } from \"@zayne-labs/toolkit-type-helpers\";\n\nconst isSyntheticEvent = (event: unknown): event is React.SyntheticEvent => {\n\treturn isObject(event) && Object.hasOwn(event, \"nativeEvent\");\n};\n\nexport const composeTwoEventHandlers = (\n\tformerHandler: AnyFunction | undefined,\n\tlatterHandler: AnyFunction | undefined\n) => {\n\tconst mergedEventHandler = (event: unknown) => {\n\t\tif (isSyntheticEvent(event)) {\n\t\t\tconst result = latterHandler?.(event) as unknown;\n\n\t\t\tif (!event.defaultPrevented) {\n\t\t\t\tformerHandler?.(event);\n\t\t\t}\n\n\t\t\treturn result;\n\t\t}\n\n\t\tconst result = latterHandler?.(event) as unknown;\n\t\tformerHandler?.(event);\n\t\treturn result;\n\t};\n\n\treturn mergedEventHandler;\n};\n\nexport const composeEventHandlers = (...eventHandlerArray: Array<AnyFunction | undefined>) => {\n\tconst mergedEventHandler = (event: unknown) => {\n\t\tif (eventHandlerArray.length === 0) return;\n\n\t\tif (eventHandlerArray.length === 1) {\n\t\t\treturn eventHandlerArray[0]?.(event) as unknown;\n\t\t}\n\n\t\tlet accumulatedHandlers: AnyFunction | undefined;\n\n\t\tfor (const eventHandler of eventHandlerArray) {\n\t\t\tif (!eventHandler) continue;\n\n\t\t\taccumulatedHandlers = composeTwoEventHandlers(accumulatedHandlers, eventHandler);\n\t\t}\n\n\t\treturn accumulatedHandlers?.(event) as unknown;\n\t};\n\n\treturn mergedEventHandler;\n};\n","import { toArray } from \"@zayne-labs/toolkit-core\";\nimport {\n\ttype AnyFunction,\n\tAssertionError,\n\ttype Prettify,\n\ttype UnknownObject,\n\tisArray,\n\tisFunction,\n} from \"@zayne-labs/toolkit-type-helpers\";\nimport { Fragment as ReactFragment, isValidElement } from \"react\";\nimport type { InferProps } from \"./types\";\n\nexport type FunctionalComponent<TProps extends UnknownObject = never> = React.FunctionComponent<TProps>;\n\nconst isWithSlotSymbol = <TFunction extends AnyFunction>(\n\tcomponent: TFunction\n): component is Record<\"slotSymbol\", unknown> & TFunction => {\n\treturn \"slotSymbol\" in component && Boolean(component.slotSymbol);\n};\n\nconst isWithSlotReference = <TFunction extends AnyFunction>(\n\tcomponent: TFunction\n): component is Record<\"slotReference\", unknown> & TFunction => {\n\treturn \"slotReference\" in component && Boolean(component.slotReference);\n};\n/**\n * @description Checks if a react child (within the children array) matches the provided SlotComponent using multiple matching strategies:\n * 1. Matches by slot symbol property\n * 2. Matches by component name\n */\n\nexport const matchesSlotComponent = (child: React.ReactNode, SlotComponent: FunctionalComponent) => {\n\tif (!isValidElement(child) || !isFunction(child.type)) {\n\t\treturn false;\n\t}\n\n\tconst resolvedChildType = isWithSlotReference(child.type)\n\t\t? (child.type.slotReference as FunctionalComponent)\n\t\t: child.type;\n\n\tconst hasMatchingSlotSymbol =\n\t\tisWithSlotSymbol(resolvedChildType)\n\t\t&& isWithSlotSymbol(SlotComponent)\n\t\t&& resolvedChildType.slotSymbol === SlotComponent.slotSymbol;\n\n\tif (hasMatchingSlotSymbol) {\n\t\treturn true;\n\t}\n\n\tif (child.type.name === SlotComponent.name) {\n\t\treturn true;\n\t}\n\n\treturn false;\n};\n\n/**\n * @description Checks if a react child (within the children array) matches any of the provided SlotComponents.\n */\nexport const matchesAnySlotComponent = (child: React.ReactNode, SlotComponents: FunctionalComponent[]) => {\n\tconst matchesSlot = SlotComponents.some((SlotComponent) => matchesSlotComponent(child, SlotComponent));\n\n\treturn matchesSlot;\n};\n\ntype SlotOptions = {\n\t/**\n\t * @description If false, the function will bail out early and return null as the slot.\n\t * @default true\n\t */\n\tcondition?: boolean;\n\t/**\n\t * @description The error message to throw when multiple slots are found for a given slot component\n\t */\n\terrorMessage?: string;\n\t/**\n\t * @description When true, an AssertionError will be thrown if multiple slots are found for a given slot component\n\t */\n\tthrowOnMultipleSlotMatch?: boolean;\n};\n\n/**\n * @description Counts how many times a given slot component appears in an array of children\n * @internal\n */\nconst calculateSlotOccurrences = (\n\tchildrenArray: React.ReactNode[],\n\tSlotComponent: FunctionalComponent\n) => {\n\tlet count = 0;\n\n\tfor (const child of childrenArray) {\n\t\tif (!matchesSlotComponent(child, SlotComponent)) continue;\n\n\t\tcount += 1;\n\t}\n\n\treturn count;\n};\n\n/**\n * @description Retrieves a single slot element from a collection of React children that matches the provided SlotComponent component.\n *\n * @throws { AssertionError } when throwOnMultipleSlotMatch is true and multiple slots are found\n */\nexport const getSingleSlot = (\n\tchildren: React.ReactNode,\n\tSlotComponent: FunctionalComponent,\n\toptions: SlotOptions = {}\n) => {\n\tconst {\n\t\tcondition = true,\n\t\terrorMessage = \"Only one instance of the SlotComponent is allowed\",\n\t\tthrowOnMultipleSlotMatch = false,\n\t} = options;\n\n\tif (!condition) {\n\t\treturn null;\n\t}\n\n\tconst actualChildren =\n\t\tisValidElement<InferProps<typeof ReactFragment>>(children) && children.type === ReactFragment\n\t\t\t? children.props.children\n\t\t\t: children;\n\n\tconst childrenArray = toArray<React.ReactNode>(actualChildren);\n\n\tconst shouldThrow =\n\t\tthrowOnMultipleSlotMatch && calculateSlotOccurrences(childrenArray, SlotComponent) > 1;\n\n\tif (shouldThrow) {\n\t\tthrow new AssertionError(errorMessage);\n\t}\n\n\tconst slotElement = childrenArray.find((child) => matchesSlotComponent(child, SlotComponent));\n\n\treturn slotElement;\n};\n\n// NOTE -  You can imitate const type parameter by extending readonly[] | []\n\ntype MultipleSlotsOptions = {\n\t/**\n\t * @description If false, the function will bail out early and return the regularChildren with the actual children and an empty slots array.\n\t * @default true\n\t */\n\tcondition?: boolean;\n\t/**\n\t * @description The error message to throw when multiple slots are found for a given slot component\n\t * If a string is provided, the same message will be used for all slot components\n\t * If an array is provided, each string in the array will be used as the errorMessage for the corresponding slot component\n\t */\n\terrorMessage?: string | string[];\n\t/**\n\t * @description When true, an AssertionError will be thrown if multiple slots are found for a given slot component\n\t * If a boolean is provided, the same value will be used for all slot components\n\t * If an array is provided, each boolean in the array will be used as the throwOnMultipleSlotMatch value for the corresponding slot component\n\t */\n\tthrowOnMultipleSlotMatch?: boolean | boolean[];\n};\n\ntype GetMultipleSlotsResult<TSlotComponents extends FunctionalComponent[]> = {\n\tregularChildren: React.ReactNode[];\n\tslots: { [Key in keyof TSlotComponents]: ReturnType<TSlotComponents[Key]> };\n};\n\n/**\n * @description The same as getSingleSlot, but for multiple slot components\n */\nexport const getMultipleSlots = <const TSlotComponents extends FunctionalComponent[]>(\n\tchildren: React.ReactNode,\n\tSlotComponents: TSlotComponents,\n\toptions?: MultipleSlotsOptions\n): Prettify<GetMultipleSlotsResult<TSlotComponents>> => {\n\tconst { condition = true, errorMessage, throwOnMultipleSlotMatch } = options ?? {};\n\n\tif (!condition) {\n\t\treturn { regularChildren: children as never, slots: [] } as GetMultipleSlotsResult<TSlotComponents>;\n\t}\n\n\tconst slots = SlotComponents.map((SlotComponent, index) =>\n\t\tgetSingleSlot(children, SlotComponent, {\n\t\t\terrorMessage: isArray(errorMessage) ? errorMessage[index] : errorMessage,\n\t\t\tthrowOnMultipleSlotMatch: isArray(throwOnMultipleSlotMatch)\n\t\t\t\t? throwOnMultipleSlotMatch[index]\n\t\t\t\t: throwOnMultipleSlotMatch,\n\t\t})\n\t);\n\n\tconst regularChildren = getRegularChildren(children, SlotComponents);\n\n\treturn { regularChildren, slots } as GetMultipleSlotsResult<TSlotComponents>;\n};\n\n/**\n * @description Returns all children that are not slot elements (i.e., don't match any of the provided slot components)\n */\nexport const getRegularChildren = (\n\tchildren: React.ReactNode,\n\tSlotComponentOrComponents: FunctionalComponent | FunctionalComponent[],\n\toptions?: Pick<SlotOptions, \"condition\">\n) => {\n\tconst { condition = true } = options ?? {};\n\n\tif (!condition) {\n\t\treturn [];\n\t}\n\n\tconst actualChildren =\n\t\tisValidElement<InferProps<typeof ReactFragment>>(children) && children.type === ReactFragment\n\t\t\t? children.props.children\n\t\t\t: children;\n\n\tconst childrenArray = toArray<React.ReactNode>(actualChildren);\n\n\tconst regularChildren = childrenArray.filter(\n\t\t(child) => !matchesAnySlotComponent(child, toArray(SlotComponentOrComponents))\n\t);\n\n\treturn regularChildren;\n};\n","import { toArray } from \"@zayne-labs/toolkit-core\";\nimport {\n\ttype AnyFunction,\n\ttype Prettify,\n\ttype UnionToIntersection,\n\ttype UnknownObject,\n\tisFunction,\n} from \"@zayne-labs/toolkit-type-helpers\";\nimport { Fragment as ReactFragment, isValidElement } from \"react\";\nimport type { InferProps } from \"./types\";\n\n/**\n * Maps slot names to their corresponding children types\n */\ntype GetSlotMapResult<TSlotComponentProps extends GetSlotComponentProps> = UnionToIntersection<{\n\t[TName in keyof TSlotComponentProps as TSlotComponentProps[\"name\"]]: TSlotComponentProps[\"children\"];\n}> & { default: React.ReactNode[] };\n\n/**\n * Symbol used to identify SlotComponent instances\n */\nexport const slotComponentSymbol = Symbol(\"slot-component\");\n\ntype GetSlotMapOptions = {\n\t/**\n\t * If false, the function will bail out early and return only the default slot with the actual children.\n\t * @default true\n\t */\n\tcondition?: boolean;\n};\n\n/**\n * @description Creates a map of named slots from React children. Returns an object mapping slot names to their children,\n * with a default slot for unmatched children.\n *\n * @example\n * ```tsx\n * import { type GetSlotComponentProps, SlotComponent } from \"@zayne-labs/toolkit-react/utils\"\n *\n * type SlotProps = GetSlotComponentProps<\"header\" | \"footer\">;\n *\n * function Parent({ children }: { children: React.ReactNode }) {\n *   const slots = getSlotMap<SlotProps>(children);\n *\n *   return (\n *     <div>\n *       <header>{slots.header}</header>\n *       <main>{slots.default}</main>\n *       <footer>{slots.footer}</footer>\n *     </div>\n *   );\n * }\n * ```\n *\n * Usage:\n * ```tsx\n * <Parent>\n *   <SlotComponent name=\"header\">Header Content</SlotComponent>\n *   <div>Random stuff</div>\n *   <SlotComponent name=\"footer\">Footer Content</SlotComponent>\n * </Parent>\n * ```\n */\nexport const getSlotMap = <TSlotComponentProps extends GetSlotComponentProps>(\n\tchildren: React.ReactNode,\n\toptions?: GetSlotMapOptions\n): Prettify<GetSlotMapResult<TSlotComponentProps>> => {\n\tconst { condition = true } = options ?? {};\n\n\tif (!condition) {\n\t\treturn { default: children } as GetSlotMapResult<TSlotComponentProps>;\n\t}\n\n\tconst actualChildren =\n\t\tisValidElement<InferProps<typeof ReactFragment>>(children) && children.type === ReactFragment\n\t\t\t? children.props.children\n\t\t\t: children;\n\n\tconst childrenArray = toArray<React.ReactNode>(actualChildren);\n\n\tconst slots: Record<string, React.ReactNode> & { default: React.ReactNode[] } = {\n\t\tdefault: [],\n\t};\n\n\tfor (const child of childrenArray) {\n\t\tif (!isValidElement<TSlotComponentProps>(child) || !isFunction(child.type)) {\n\t\t\tslots.default.push(child);\n\t\t\tcontinue;\n\t\t}\n\n\t\ttype ElementWithSlotReference = AnyFunction & { slotReference: SlotWithNameAndSymbol };\n\n\t\tconst resolvedChildType = Object.hasOwn(child.type, \"slotReference\")\n\t\t\t? (child.type as ElementWithSlotReference).slotReference\n\t\t\t: (child.type as SlotWithNameAndSymbol);\n\n\t\tconst isSlotElement =\n\t\t\tresolvedChildType.slotSymbol === slotComponentSymbol\n\t\t\t&& Boolean(resolvedChildType.slotName ?? child.props.name);\n\n\t\tif (!isSlotElement) {\n\t\t\tslots.default.push(child);\n\t\t\tcontinue;\n\t\t}\n\n\t\tconst slotName = resolvedChildType.slotName ?? child.props.name;\n\n\t\tslots[slotName] = child;\n\t}\n\n\treturn slots as GetSlotMapResult<TSlotComponentProps>;\n};\n\n/**\n * @description Produce props for the SlotComponent\n */\nexport type GetSlotComponentProps<\n\tTName extends string = string,\n\tTChildren extends React.ReactNode = React.ReactNode,\n> = {\n\t/** Content to render in the slot */\n\tchildren: TChildren;\n\t/** Name of the slot where content should be rendered */\n\tname: TName;\n};\n\n/**\n * @description Slot component created by createSlotComponent\n */\n\nexport const createSlotComponent = <TSlotComponentProps extends GetSlotComponentProps>() => {\n\tconst SlotComponent = (props: TSlotComponentProps) => props.children;\n\n\tSlotComponent.slotSymbol = slotComponentSymbol;\n\n\treturn SlotComponent;\n};\n\ntype SlotWithNameAndSymbol<\n\tTSlotComponentProps extends Pick<GetSlotComponentProps, \"name\"> = Pick<GetSlotComponentProps, \"name\">,\n\tTActualProps extends UnknownObject = UnknownObject,\n> = {\n\t(props: Pick<GetSlotComponentProps, \"children\"> & TActualProps): React.ReactNode;\n\treadonly slotName?: TSlotComponentProps[\"name\"];\n\treadonly slotSymbol?: symbol;\n};\n\nexport const withSlotNameAndSymbol = <\n\tTSlotComponentProps extends Pick<GetSlotComponentProps, \"name\">,\n\tTActualProps extends UnknownObject = UnknownObject,\n>(\n\tname: TSlotComponentProps[\"name\"],\n\tSlotComponent: SlotWithNameAndSymbol<TSlotComponentProps, TActualProps> = (props) => props.children\n) => {\n\t/* eslint-disable no-param-reassign -- This is necessary */\n\t// @ts-expect-error -- This is necessary for the time being, to prevent type errors and accidental overrides on consumer side\n\tSlotComponent.slotSymbol = slotComponentSymbol;\n\t// @ts-expect-error -- This is necessary for the time being, to prevent type errors and accidental overrides on consumer side\n\tSlotComponent.slotName = name;\n\t/* eslint-enable no-param-reassign -- This is necessary */\n\n\treturn SlotComponent;\n};\n","import { type AnyFunction, isFunction } from \"@zayne-labs/toolkit-type-helpers\";\nimport { composeTwoEventHandlers } from \"./composeEventHandlers\";\n\n// == This approach is more efficient than using a regex.\nconst isEventHandler = (key: string, value: unknown): value is AnyFunction => {\n\tconst thirdCharCode = key.codePointAt(2);\n\n\tif (!isFunction(value) || thirdCharCode === undefined) {\n\t\treturn false;\n\t}\n\n\tconst isHandler = key.startsWith(\"on\") && thirdCharCode >= 65 /* A */ && thirdCharCode <= 90; /* Z */\n\n\treturn isHandler;\n};\n\nconst mergeTwoClassNames = (formerClassName: string | undefined, latterClassName: string | undefined) => {\n\tif (!latterClassName || !formerClassName) {\n\t\t// eslint-disable-next-line ts-eslint/prefer-nullish-coalescing -- Logical OR is fit for this case\n\t\treturn latterClassName || formerClassName;\n\t}\n\n\t// eslint-disable-next-line prefer-template -- String concatenation is more performant than template literals in this case\n\treturn formerClassName + \" \" + latterClassName;\n};\n\nexport const mergeTwoProps = <TProps extends Record<never, never>>(\n\tformerProps: TProps | undefined,\n\tlatterProps: TProps | undefined\n): TProps => {\n\t// == If no props are provided, return an empty object\n\tif (!latterProps || !formerProps) {\n\t\treturn latterProps ?? formerProps ?? ({} as TProps);\n\t}\n\n\tconst propsAccumulator = { ...formerProps } as Record<string, unknown>;\n\n\tfor (const latterPropName of Object.keys(latterProps)) {\n\t\tconst formerPropValue = (formerProps as Record<string, unknown>)[latterPropName];\n\t\tconst latterPropValue = (latterProps as Record<string, unknown>)[latterPropName];\n\n\t\t// == If the prop is `className` or `class`, we merge them\n\t\tif (latterPropName === \"className\" || latterPropName === \"class\") {\n\t\t\tpropsAccumulator[latterPropName] = mergeTwoClassNames(\n\t\t\t\tformerPropValue as string,\n\t\t\t\tlatterPropValue as string\n\t\t\t);\n\t\t\tcontinue;\n\t\t}\n\n\t\t// == If the prop is `style`, we merge them\n\t\tif (latterPropName === \"style\") {\n\t\t\tpropsAccumulator[latterPropName] = {\n\t\t\t\t...(formerPropValue as object),\n\t\t\t\t...(latterPropValue as object),\n\t\t\t};\n\t\t\tcontinue;\n\t\t}\n\n\t\t// == If the handler exists on both, we compose them\n\t\tif (isEventHandler(latterPropName, latterPropValue)) {\n\t\t\tpropsAccumulator[latterPropName] = composeTwoEventHandlers(\n\t\t\t\tformerPropValue as AnyFunction | undefined,\n\t\t\t\tlatterPropValue\n\t\t\t);\n\n\t\t\tcontinue;\n\t\t}\n\n\t\t// == latterProps override by default\n\t\tpropsAccumulator[latterPropName] = latterPropValue;\n\t}\n\n\treturn propsAccumulator as TProps;\n};\n","import { mergeTwoProps } from \"./mergeTwoProps\";\n\ntype UnionToIntersection<TUnion> = (TUnion extends unknown ? (param: TUnion) => void : \"\") extends (\n\tparam: infer TParam\n) => void\n\t? TParam\n\t: \"\";\n\n/**\n * Merges multiple sets of React props.\n *\n * - It follows the Object.assign pattern where the rightmost object's fields overwrite\n * the conflicting ones from others. This doesn't apply to event handlers, `className` and `style` props.\n * - Event handlers are merged such that they are called in sequence (the rightmost one being called first),\n * and allows the user to prevent the previous event handlers from being executed by calling the `preventDefault` method.\n * - It also merges the `className` and `style` props, whereby the classes are concatenated\n * and the rightmost styles overwrite the previous ones.\n *\n * @important **`ref` is not merged.**\n * @param props props to merge.\n * @returns the merged props.\n */\n\nconst mergeProps = <TProps extends Record<never, never>>(\n\t...propsObjectArray: Array<TProps | undefined>\n): UnionToIntersection<TProps> => {\n\tif (propsObjectArray.length === 0) {\n\t\treturn {} as never;\n\t}\n\n\tif (propsObjectArray.length === 1) {\n\t\treturn propsObjectArray[0] as never;\n\t}\n\n\tlet accumulatedProps: Record<string, unknown> = {};\n\n\tfor (const propsObject of propsObjectArray) {\n\t\tif (!propsObject) continue;\n\n\t\taccumulatedProps = mergeTwoProps(accumulatedProps, propsObject);\n\t}\n\n\treturn accumulatedProps as never;\n};\n\nexport { mergeProps };\n"]}
+{"version":3,"sources":["../../../src/utils/composeRefs.ts","../../../src/utils/composeEventHandlers.ts","../../../src/utils/getSlot.ts","../../../src/utils/getSlotMap.ts","../../../src/utils/mergeTwoProps.ts","../../../src/utils/mergeProps.ts"],"names":["result","isFunction","ReactFragment","isValidElement","toArray"],"mappings":"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","file":"index.js","sourcesContent":["import { isFunction } from \"@zayne-labs/toolkit-type-helpers\";\nimport { type RefCallback, useCallback } from \"react\";\n\ntype PossibleRef<TRef extends HTMLElement> = React.Ref<TRef> | undefined;\n\n/**\n * @description Set a given ref to a given value.\n *\n * This utility takes care of different types of refs: callback refs and RefObject(s)\n */\nexport const setRef = <TRef extends HTMLElement>(\n\tref: PossibleRef<TRef>,\n\tnode: TRef | null\n): ReturnType<RefCallback<TRef>> => {\n\tif (!ref) return;\n\n\tif (isFunction(ref)) {\n\t\treturn ref(node);\n\t}\n\n\t// eslint-disable-next-line no-param-reassign -- Mutation is needed here\n\tref.current = node;\n};\n\n/**\n * @description A utility to combine refs. Accepts callback refs and RefObject(s)\n */\nexport const composeRefs = <TRef extends HTMLElement>(\n\t...refs: Array<PossibleRef<TRef>>\n): RefCallback<TRef> => {\n\tconst mergedRefCallBack: RefCallback<TRef> = (node) => {\n\t\tconst cleanupFnArray = refs.map((ref) => setRef(ref, node));\n\n\t\tconst cleanupFn = () => cleanupFnArray.forEach((cleanup) => cleanup?.());\n\n\t\treturn cleanupFn;\n\t};\n\n\treturn mergedRefCallBack;\n};\n\nexport const useComposeRefs = <TRef extends HTMLElement>(...refs: Array<PossibleRef<TRef>>) => {\n\t// eslint-disable-next-line react-hooks/exhaustive-deps -- Allow\n\tconst mergedRef = useCallback(() => composeRefs(...refs), refs);\n\n\treturn mergedRef;\n};\n","import { type AnyFunction, isObject } from \"@zayne-labs/toolkit-type-helpers\";\n\nconst isSyntheticEvent = (event: unknown): event is React.SyntheticEvent => {\n\treturn isObject(event) && Object.hasOwn(event, \"nativeEvent\");\n};\n\nexport const composeTwoEventHandlers = (\n\tformerHandler: AnyFunction | undefined,\n\tlatterHandler: AnyFunction | undefined\n) => {\n\tconst mergedEventHandler = (event: unknown) => {\n\t\tif (isSyntheticEvent(event)) {\n\t\t\tconst result = latterHandler?.(event) as unknown;\n\n\t\t\tif (!event.defaultPrevented) {\n\t\t\t\tformerHandler?.(event);\n\t\t\t}\n\n\t\t\treturn result;\n\t\t}\n\n\t\tconst result = latterHandler?.(event) as unknown;\n\t\tformerHandler?.(event);\n\t\treturn result;\n\t};\n\n\treturn mergedEventHandler;\n};\n\nexport const composeEventHandlers = (...eventHandlerArray: Array<AnyFunction | undefined>) => {\n\tconst mergedEventHandler = (event: unknown) => {\n\t\tif (eventHandlerArray.length === 0) return;\n\n\t\tif (eventHandlerArray.length === 1) {\n\t\t\treturn eventHandlerArray[0]?.(event) as unknown;\n\t\t}\n\n\t\tlet accumulatedHandlers: AnyFunction | undefined;\n\n\t\tfor (const eventHandler of eventHandlerArray) {\n\t\t\tif (!eventHandler) continue;\n\n\t\t\taccumulatedHandlers = composeTwoEventHandlers(accumulatedHandlers, eventHandler);\n\t\t}\n\n\t\treturn accumulatedHandlers?.(event) as unknown;\n\t};\n\n\treturn mergedEventHandler;\n};\n","import { toArray } from \"@zayne-labs/toolkit-core\";\nimport {\n\ttype AnyFunction,\n\tAssertionError,\n\ttype Prettify,\n\ttype UnknownObject,\n\tisArray,\n\tisFunction,\n} from \"@zayne-labs/toolkit-type-helpers\";\nimport { Fragment as ReactFragment, isValidElement } from \"react\";\nimport type { InferProps } from \"./types\";\n\nexport type FunctionalComponent<TProps extends UnknownObject = never> = React.FunctionComponent<TProps>;\n\nconst isWithSlotSymbol = <TFunction extends AnyFunction>(\n\tcomponent: TFunction\n): component is Record<\"slotSymbol\", unknown> & TFunction => {\n\treturn \"slotSymbol\" in component && Boolean(component.slotSymbol);\n};\n\nconst isWithSlotReference = <TFunction extends AnyFunction>(\n\tcomponent: TFunction\n): component is Record<\"slotReference\", unknown> & TFunction => {\n\treturn \"slotReference\" in component && Boolean(component.slotReference);\n};\n/**\n * @description Checks if a react child (within the children array) matches the provided SlotComponent using multiple matching strategies:\n * 1. Matches by slot symbol property\n * 2. Matches by component name\n */\n\nexport const matchesSlotComponent = (child: React.ReactNode, SlotComponent: FunctionalComponent) => {\n\tif (!isValidElement(child) || !isFunction(child.type)) {\n\t\treturn false;\n\t}\n\n\tconst resolvedChildType = isWithSlotReference(child.type)\n\t\t? (child.type.slotReference as FunctionalComponent)\n\t\t: child.type;\n\n\tconst hasMatchingSlotSymbol =\n\t\tisWithSlotSymbol(resolvedChildType)\n\t\t&& isWithSlotSymbol(SlotComponent)\n\t\t&& resolvedChildType.slotSymbol === SlotComponent.slotSymbol;\n\n\tif (hasMatchingSlotSymbol) {\n\t\treturn true;\n\t}\n\n\tif (child.type.name === SlotComponent.name) {\n\t\treturn true;\n\t}\n\n\treturn false;\n};\n\n/**\n * @description Checks if a react child (within the children array) matches any of the provided SlotComponents.\n */\nexport const matchesAnySlotComponent = (child: React.ReactNode, SlotComponents: FunctionalComponent[]) => {\n\tconst matchesSlot = SlotComponents.some((SlotComponent) => matchesSlotComponent(child, SlotComponent));\n\n\treturn matchesSlot;\n};\n\ntype SlotOptions = {\n\t/**\n\t * @description If false, the function will bail out early and return null as the slot.\n\t * @default true\n\t */\n\tcondition?: boolean;\n\t/**\n\t * @description The error message to throw when multiple slots are found for a given slot component\n\t */\n\terrorMessage?: string;\n\t/**\n\t * @description When true, an AssertionError will be thrown if multiple slots are found for a given slot component\n\t */\n\tthrowOnMultipleSlotMatch?: boolean;\n};\n\n/**\n * @description Counts how many times a given slot component appears in an array of children\n * @internal\n */\nconst calculateSlotOccurrences = (\n\tchildrenArray: React.ReactNode[],\n\tSlotComponent: FunctionalComponent\n) => {\n\tlet count = 0;\n\n\tfor (const child of childrenArray) {\n\t\tif (!matchesSlotComponent(child, SlotComponent)) continue;\n\n\t\tcount += 1;\n\t}\n\n\treturn count;\n};\n\n/**\n * @description Retrieves a single slot element from a collection of React children that matches the provided SlotComponent component.\n *\n * @throws { AssertionError } when throwOnMultipleSlotMatch is true and multiple slots are found\n */\nexport const getSingleSlot = (\n\tchildren: React.ReactNode,\n\tSlotComponent: FunctionalComponent,\n\toptions: SlotOptions = {}\n) => {\n\tconst {\n\t\tcondition = true,\n\t\terrorMessage = \"Only one instance of the SlotComponent is allowed\",\n\t\tthrowOnMultipleSlotMatch = false,\n\t} = options;\n\n\tif (!condition) {\n\t\treturn null;\n\t}\n\n\tconst actualChildren =\n\t\tisValidElement<InferProps<typeof ReactFragment>>(children) && children.type === ReactFragment\n\t\t\t? children.props.children\n\t\t\t: children;\n\n\tconst childrenArray = toArray<React.ReactNode>(actualChildren);\n\n\tconst shouldThrow =\n\t\tthrowOnMultipleSlotMatch && calculateSlotOccurrences(childrenArray, SlotComponent) > 1;\n\n\tif (shouldThrow) {\n\t\tthrow new AssertionError(errorMessage);\n\t}\n\n\tconst slotElement = childrenArray.find((child) => matchesSlotComponent(child, SlotComponent));\n\n\treturn slotElement;\n};\n\n// NOTE -  You can imitate const type parameter by extending readonly[] | []\n\ntype MultipleSlotsOptions = {\n\t/**\n\t * @description If false, the function will bail out early and return the regularChildren with the actual children and an empty slots array.\n\t * @default true\n\t */\n\tcondition?: boolean;\n\t/**\n\t * @description The error message to throw when multiple slots are found for a given slot component\n\t * If a string is provided, the same message will be used for all slot components\n\t * If an array is provided, each string in the array will be used as the errorMessage for the corresponding slot component\n\t */\n\terrorMessage?: string | string[];\n\t/**\n\t * @description When true, an AssertionError will be thrown if multiple slots are found for a given slot component\n\t * If a boolean is provided, the same value will be used for all slot components\n\t * If an array is provided, each boolean in the array will be used as the throwOnMultipleSlotMatch value for the corresponding slot component\n\t */\n\tthrowOnMultipleSlotMatch?: boolean | boolean[];\n};\n\ntype GetMultipleSlotsResult<TSlotComponents extends FunctionalComponent[]> = {\n\tregularChildren: React.ReactNode[];\n\tslots: { [Key in keyof TSlotComponents]: ReturnType<TSlotComponents[Key]> };\n};\n\n/**\n * @description The same as getSingleSlot, but for multiple slot components\n */\nexport const getMultipleSlots = <const TSlotComponents extends FunctionalComponent[]>(\n\tchildren: React.ReactNode,\n\tSlotComponents: TSlotComponents,\n\toptions?: MultipleSlotsOptions\n): Prettify<GetMultipleSlotsResult<TSlotComponents>> => {\n\tconst { condition = true, errorMessage, throwOnMultipleSlotMatch } = options ?? {};\n\n\tif (!condition) {\n\t\treturn { regularChildren: children as never, slots: [] } as GetMultipleSlotsResult<TSlotComponents>;\n\t}\n\n\tconst slots = SlotComponents.map((SlotComponent, index) =>\n\t\tgetSingleSlot(children, SlotComponent, {\n\t\t\terrorMessage: isArray(errorMessage) ? errorMessage[index] : errorMessage,\n\t\t\tthrowOnMultipleSlotMatch: isArray(throwOnMultipleSlotMatch)\n\t\t\t\t? throwOnMultipleSlotMatch[index]\n\t\t\t\t: throwOnMultipleSlotMatch,\n\t\t})\n\t);\n\n\tconst regularChildren = getRegularChildren(children, SlotComponents);\n\n\treturn { regularChildren, slots } as GetMultipleSlotsResult<TSlotComponents>;\n};\n\n/**\n * @description Returns all children that are not slot elements (i.e., don't match any of the provided slot components)\n */\nexport const getRegularChildren = (\n\tchildren: React.ReactNode,\n\tSlotComponentOrComponents: FunctionalComponent | FunctionalComponent[],\n\toptions?: Pick<SlotOptions, \"condition\">\n) => {\n\tconst { condition = true } = options ?? {};\n\n\tif (!condition) {\n\t\treturn [];\n\t}\n\n\tconst actualChildren =\n\t\tisValidElement<InferProps<typeof ReactFragment>>(children) && children.type === ReactFragment\n\t\t\t? children.props.children\n\t\t\t: children;\n\n\tconst childrenArray = toArray<React.ReactNode>(actualChildren);\n\n\tconst regularChildren = childrenArray.filter(\n\t\t(child) => !matchesAnySlotComponent(child, toArray(SlotComponentOrComponents))\n\t);\n\n\treturn regularChildren;\n};\n","import { toArray } from \"@zayne-labs/toolkit-core\";\nimport {\n\ttype AnyFunction,\n\ttype Prettify,\n\ttype UnionToIntersection,\n\ttype UnknownObject,\n\tisFunction,\n} from \"@zayne-labs/toolkit-type-helpers\";\nimport { Fragment as ReactFragment, isValidElement } from \"react\";\nimport type { InferProps } from \"./types\";\n\n/**\n * Maps slot names to their corresponding children types\n */\ntype GetSlotMapResult<TSlotComponentProps extends GetSlotComponentProps> = UnionToIntersection<{\n\t[TName in keyof TSlotComponentProps as TSlotComponentProps[\"name\"]]: TSlotComponentProps[\"children\"];\n}> & { default: React.ReactNode[] };\n\n/**\n * Symbol used to identify SlotComponent instances\n */\nexport const slotComponentSymbol = Symbol(\"slot-component\");\n\ntype GetSlotMapOptions = {\n\t/**\n\t * If false, the function will bail out early and return only the default slot with the actual children.\n\t * @default true\n\t */\n\tcondition?: boolean;\n};\n\n/**\n * @description Creates a map of named slots from React children. Returns an object mapping slot names to their children,\n * with a default slot for unmatched children.\n *\n * @example\n * ```tsx\n * import { type GetSlotComponentProps, SlotComponent } from \"@zayne-labs/toolkit-react/utils\"\n *\n * type SlotProps = GetSlotComponentProps<\"header\" | \"footer\">;\n *\n * function Parent({ children }: { children: React.ReactNode }) {\n *   const slots = getSlotMap<SlotProps>(children);\n *\n *   return (\n *     <div>\n *       <header>{slots.header}</header>\n *       <main>{slots.default}</main>\n *       <footer>{slots.footer}</footer>\n *     </div>\n *   );\n * }\n * ```\n *\n * Usage:\n * ```tsx\n * <Parent>\n *   <SlotComponent name=\"header\">Header Content</SlotComponent>\n *   <div>Random stuff</div>\n *   <SlotComponent name=\"footer\">Footer Content</SlotComponent>\n * </Parent>\n * ```\n */\nexport const getSlotMap = <TSlotComponentProps extends GetSlotComponentProps>(\n\tchildren: React.ReactNode,\n\toptions?: GetSlotMapOptions\n): Prettify<GetSlotMapResult<TSlotComponentProps>> => {\n\tconst { condition = true } = options ?? {};\n\n\tif (!condition) {\n\t\treturn { default: children } as GetSlotMapResult<TSlotComponentProps>;\n\t}\n\n\tconst actualChildren =\n\t\tisValidElement<InferProps<typeof ReactFragment>>(children) && children.type === ReactFragment\n\t\t\t? children.props.children\n\t\t\t: children;\n\n\tconst childrenArray = toArray<React.ReactNode>(actualChildren);\n\n\tconst slots: Record<string, React.ReactNode> & { default: React.ReactNode[] } = {\n\t\tdefault: [],\n\t};\n\n\tfor (const child of childrenArray) {\n\t\tif (!isValidElement<TSlotComponentProps>(child) || !isFunction(child.type)) {\n\t\t\tslots.default.push(child);\n\t\t\tcontinue;\n\t\t}\n\n\t\ttype ElementWithSlotReference = AnyFunction & { slotReference: SlotWithNameAndSymbol };\n\n\t\tconst resolvedChildType = Object.hasOwn(child.type, \"slotReference\")\n\t\t\t? (child.type as ElementWithSlotReference).slotReference\n\t\t\t: (child.type as SlotWithNameAndSymbol);\n\n\t\tconst isSlotElement =\n\t\t\tresolvedChildType.slotSymbol === slotComponentSymbol\n\t\t\t&& Boolean(resolvedChildType.slotName ?? child.props.name);\n\n\t\tif (!isSlotElement) {\n\t\t\tslots.default.push(child);\n\t\t\tcontinue;\n\t\t}\n\n\t\tconst slotName = resolvedChildType.slotName ?? child.props.name;\n\n\t\tslots[slotName] = child;\n\t}\n\n\treturn slots as GetSlotMapResult<TSlotComponentProps>;\n};\n\n/**\n * @description Produce props for the SlotComponent\n */\nexport type GetSlotComponentProps<\n\tTName extends string = string,\n\tTChildren extends React.ReactNode = React.ReactNode,\n> = {\n\t/** Content to render in the slot */\n\tchildren: TChildren;\n\t/** Name of the slot where content should be rendered */\n\tname: TName;\n};\n\n/**\n * @description Slot component created by createSlotComponent\n */\n\nexport const createSlotComponent = <TSlotComponentProps extends GetSlotComponentProps>() => {\n\tconst SlotComponent = (props: TSlotComponentProps) => props.children;\n\n\tSlotComponent.slotSymbol = slotComponentSymbol;\n\n\treturn SlotComponent;\n};\n\ntype SlotWithNameAndSymbol<\n\tTSlotComponentProps extends Pick<GetSlotComponentProps, \"name\"> = Pick<GetSlotComponentProps, \"name\">,\n\tTActualProps extends UnknownObject = UnknownObject,\n> = {\n\t(props: Pick<GetSlotComponentProps, \"children\"> & TActualProps): React.ReactNode;\n\treadonly slotName?: TSlotComponentProps[\"name\"];\n\treadonly slotSymbol?: symbol;\n};\n\nexport const withSlotNameAndSymbol = <\n\tTSlotComponentProps extends Pick<GetSlotComponentProps, \"name\">,\n\tTActualProps extends UnknownObject = UnknownObject,\n>(\n\tname: TSlotComponentProps[\"name\"],\n\tSlotComponent: SlotWithNameAndSymbol<TSlotComponentProps, TActualProps> = (props) => props.children\n) => {\n\t/* eslint-disable no-param-reassign -- This is necessary */\n\t// @ts-expect-error -- This is necessary for the time being, to prevent type errors and accidental overrides on consumer side\n\tSlotComponent.slotSymbol = slotComponentSymbol;\n\t// @ts-expect-error -- This is necessary for the time being, to prevent type errors and accidental overrides on consumer side\n\tSlotComponent.slotName = name;\n\t/* eslint-enable no-param-reassign -- This is necessary */\n\n\treturn SlotComponent;\n};\n","import { type AnyFunction, isFunction } from \"@zayne-labs/toolkit-type-helpers\";\nimport { composeTwoEventHandlers } from \"./composeEventHandlers\";\n\n// == This approach is more efficient than using a regex.\nconst isEventHandler = (key: string, value: unknown): value is AnyFunction => {\n\tconst thirdCharCode = key.codePointAt(2);\n\n\tif (!isFunction(value) || thirdCharCode === undefined) {\n\t\treturn false;\n\t}\n\n\tconst isHandler = key.startsWith(\"on\") && thirdCharCode >= 65 /* A */ && thirdCharCode <= 90; /* Z */\n\n\treturn isHandler;\n};\n\nconst mergeTwoClassNames = (formerClassName: string | undefined, latterClassName: string | undefined) => {\n\tif (!latterClassName || !formerClassName) {\n\t\t// eslint-disable-next-line ts-eslint/prefer-nullish-coalescing -- Logical OR is fit for this case\n\t\treturn latterClassName || formerClassName;\n\t}\n\n\t// eslint-disable-next-line prefer-template -- String concatenation is more performant than template literals in this case\n\treturn formerClassName + \" \" + latterClassName;\n};\n\nexport const mergeTwoProps = <TProps extends Record<never, never>>(\n\tformerProps: TProps | undefined,\n\tlatterProps: TProps | undefined\n): TProps => {\n\t// == If no props are provided, return an empty object\n\tif (!latterProps || !formerProps) {\n\t\treturn latterProps ?? formerProps ?? ({} as TProps);\n\t}\n\n\tconst propsAccumulator = { ...formerProps } as Record<string, unknown>;\n\n\tfor (const latterPropName of Object.keys(latterProps)) {\n\t\tconst formerPropValue = (formerProps as Record<string, unknown>)[latterPropName];\n\t\tconst latterPropValue = (latterProps as Record<string, unknown>)[latterPropName];\n\n\t\t// == If the prop is `className` or `class`, we merge them\n\t\tif (latterPropName === \"className\" || latterPropName === \"class\") {\n\t\t\tpropsAccumulator[latterPropName] = mergeTwoClassNames(\n\t\t\t\tformerPropValue as string,\n\t\t\t\tlatterPropValue as string\n\t\t\t);\n\t\t\tcontinue;\n\t\t}\n\n\t\t// == If the prop is `style`, we merge them\n\t\tif (latterPropName === \"style\") {\n\t\t\tpropsAccumulator[latterPropName] = {\n\t\t\t\t...(formerPropValue as object),\n\t\t\t\t...(latterPropValue as object),\n\t\t\t};\n\t\t\tcontinue;\n\t\t}\n\n\t\t// == If the handler exists on both, we compose them\n\t\tif (isEventHandler(latterPropName, latterPropValue)) {\n\t\t\tpropsAccumulator[latterPropName] = composeTwoEventHandlers(\n\t\t\t\tformerPropValue as AnyFunction | undefined,\n\t\t\t\tlatterPropValue\n\t\t\t);\n\n\t\t\tcontinue;\n\t\t}\n\n\t\t// == latterProps override by default\n\t\tpropsAccumulator[latterPropName] = latterPropValue;\n\t}\n\n\treturn propsAccumulator as TProps;\n};\n","import { mergeTwoProps } from \"./mergeTwoProps\";\n\ntype UnionToIntersection<TUnion> = (TUnion extends unknown ? (param: TUnion) => void : \"\") extends (\n\tparam: infer TParam\n) => void\n\t? TParam\n\t: \"\";\n\n/**\n * Merges multiple sets of React props.\n *\n * - It follows the Object.assign pattern where the rightmost object's fields overwrite\n * the conflicting ones from others. This doesn't apply to event handlers, `className` and `style` props.\n * - Event handlers are merged such that they are called in sequence (the rightmost one being called first),\n * and allows the user to prevent the previous event handlers from being executed by calling the `preventDefault` method.\n * - It also merges the `className` and `style` props, whereby the classes are concatenated\n * and the rightmost styles overwrite the previous ones.\n *\n * @important **`ref` is not merged.**\n * @param props props to merge.\n * @returns the merged props.\n */\n\nconst mergeProps = <TProps extends Record<never, never>>(\n\t...propsObjectArray: Array<TProps | undefined>\n): UnionToIntersection<TProps> => {\n\tif (propsObjectArray.length === 0) {\n\t\treturn {} as never;\n\t}\n\n\tif (propsObjectArray.length === 1) {\n\t\treturn propsObjectArray[0] as never;\n\t}\n\n\tlet accumulatedProps: Record<string, unknown> = {};\n\n\tfor (const propsObject of propsObjectArray) {\n\t\tif (!propsObject) continue;\n\n\t\taccumulatedProps = mergeTwoProps(accumulatedProps, propsObject);\n\t}\n\n\treturn accumulatedProps as never;\n};\n\nexport { mergeProps };\n"]}

package/dist/esm/zustand/index.js

@@ -1,4 +1,4 @@
-import { createCustomContext, useConstant } from '../chunk-CEKHHIKA.js';
+import { createCustomContext, useConstant } from '../chunk-F46ZNZPZ.js';
 import { createElement } from 'react';
 import { createStore, create, useStore } from 'zustand';
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@zayne-labs/toolkit-react",
   "type": "module",
-  "version": "0.9.29",
+  "version": "0.9.30",
   "description": "A collection of utility functions, types and composables used by my other projects. Nothing too fancy but can be useful.",
   "author": "Ryan Zayne",
   "license": "MIT",
@@ -47,8 +47,8 @@
     }
   },
   "dependencies": {
-    "@zayne-labs/toolkit-core": "0.9.29",
-    "@zayne-labs/toolkit-type-helpers": "0.9.29"
+    "@zayne-labs/toolkit-type-helpers": "0.9.30",
+    "@zayne-labs/toolkit-core": "0.9.30"
   },
   "devDependencies": {
     "@arethetypeswrong/cli": "^0.17.4",

package/dist/esm/chunk-CEKHHIKA.js.map

@@ -1 +0,0 @@
-{"version":3,"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/useIsServer.ts","../../src/hooks/useStore.ts","../../src/hooks/useLocation.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/useStorageState.ts","../../src/hooks/useThrottle.ts"],"names":["useRef","useEffect","useCallback","useState","useSyncExternalStore","on","useStorageState"],"mappings":"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","file":"chunk-CEKHHIKA.js","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\tconstructor(...args: Parameters<typeof Error>) {\n\t\tsuper(...args);\n\n\t\tError.captureStackTrace(this, this.constructor);\n\t}\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> = TStrict extends true\n\t? TContextValue\n\t: 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.Provider, 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\nconst useConstant = <TResult>(initCallbackFn: () => 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 { useConstant };\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 } from \"react\";\nimport { useCallbackRef } from \"./useCallbackRef\";\n\ntype UseClickOutsideOptions = {\n\tenabled?: boolean;\n};\n\nconst useClickOutside = <TElement extends HTMLElement>(\n\trefOrRefArray: Array<React.RefObject<TElement>> | React.RefObject<TElement>,\n\tcallback: (event: MouseEvent | TouchEvent) => void,\n\toptions?: UseClickOutsideOptions\n) => {\n\tconst { enabled = true } = options ?? {};\n\n\tconst savedCallback = useCallbackRef(callback);\n\n\tuseEffect(() => {\n\t\tif (!enabled) return;\n\n\t\tconst controller = new AbortController();\n\n\t\tconst elementArray = toArray(refOrRefArray).map((ref) => ref.current);\n\n\t\tonClickOutside(elementArray, savedCallback, { signal: controller.signal });\n\n\t\treturn () => {\n\t\t\tcontroller.abort();\n\t\t};\n\t}, [enabled, refOrRefArray, savedCallback]);\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 { 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(<TValue>(value?: TValue) => {\n\t\tconst booleanValue = typeof value === \"boolean\" && value ? value : true;\n\t\ttoggleIsOpen(booleanValue);\n\t\thasScrollControl && lockScroll({ lock: booleanValue });\n\t});\n\n\tconst onClose = useCallbackRef(<TValue>(value?: TValue) => {\n\t\tconst booleanValue = typeof value === \"boolean\" && !value ? value : false;\n\n\t\ttoggleIsOpen(booleanValue);\n\t\thasScrollControl && lockScroll({ lock: booleanValue });\n\t});\n\n\tconst onToggle = useCallbackRef(<TValue>(value?: TValue) => {\n\t\tif (typeof value === \"boolean\") {\n\t\t\tvalue ? onOpen(value) : onClose(value);\n\t\t\treturn;\n\t\t}\n\n\t\tisOpen ? onClose() : onOpen();\n\t});\n\n\treturn { isOpen, onClose, onOpen, onToggle };\n};\n\nexport { useDisclosure };\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 { useDebugValue, useSyncExternalStore } from \"react\";\n\nconst identity = <TState>(x: TState) => x;\n\nconst useStore = <TState, TSlice>(\n\tstore: StoreApi<TState>,\n\tselector: SelectorFn<TState, TSlice> = identity as never\n) => {\n\tconst slice = useSyncExternalStore(\n\t\tstore.subscribe,\n\t\t() => selector(store.getState()),\n\t\t() => selector(store.getInitialState())\n\t);\n\n\tuseDebugValue(slice);\n\n\treturn slice;\n};\n\nexport { useStore };\n","import {\n\ttype LocationInfo,\n\ttype LocationStoreOptions,\n\tcreateLocationStore,\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 LocationStore = ReturnType<typeof createLocationStore>;\n\ntype UseLocationResult<TSlice> = [\n\tstate: TSlice,\n\tsetState: {\n\t\tpush: LocationStore[\"push\"];\n\t\treplace: LocationStore[\"replace\"];\n\t\ttriggerPopstate: LocationStore[\"triggerPopstateEvent\"];\n\t},\n];\n\nconst useLocation = <TSlice = LocationInfo>(\n\tselector?: SelectorFn<LocationInfo, TSlice>,\n\toptions?: LocationStoreOptions\n) => {\n\tconst locationStore = useConstant(() => createLocationStore(options));\n\n\tconst stateSlice = useStore(locationStore as never, selector);\n\n\treturn [\n\t\tstateSlice,\n\t\t{\n\t\t\tpush: locationStore.push,\n\t\t\treplace: locationStore.replace,\n\t\t\ttriggerPopstate: locationStore.triggerPopstateEvent,\n\t\t},\n\t] as UseLocationResult<TSlice>;\n};\n\nexport { useLocation };\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 { useLocation } from \"./useLocation\";\n\ntype UseSearchParamsOptions = {\n\taction?: \"push\" | \"replace\";\n\tlocationOptions?: LocationStoreOptions;\n};\n\nexport const useSearchParams = <TSearchParams extends URLSearchParamsInit>(\n\toptions?: UseSearchParamsOptions\n) => {\n\tconst { action = \"push\", locationOptions } = options ?? {};\n\n\tconst [searchParams, setLocation] = useLocation((state) => state.search, locationOptions);\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\tif (Object.is(searchParams.toString(), nextSearchParams.toString())) return;\n\n\t\tsetLocation[action]({ search: nextSearchParams });\n\t};\n\n\tsetSearchParams.triggerPopstate = setLocation.triggerPopstate;\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\treturn [searchParamsObject, setSearchParamsObject] as const;\n};\n","import {\n\ttype StorageOptions,\n\ttype StorageStoreApi,\n\tcreateExternalStorageStore,\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\nexport const createStorageStore = <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\t};\n\n\tconst useStorageState = (selector?: SelectorFn<TState, unknown>) => {\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"]}