@zayne-labs/toolkit-react 0.8.22

package/dist/esm/chunk-AHVBSEEO.js

@@ -0,0 +1,462 @@
+import { createContext, useRef, useLayoutEffect, useCallback, useEffect, useState, useSyncExternalStore, useDebugValue, useContext } from 'react';
+import { on, setAnimationInterval, debounce, lockScroll, createLocationStore, isBrowser, createExternalStorageStore, throttleBySetTimeout, throttleByTime, throttleByFrame, copyToClipboard, createSearchParams } from '@zayne-labs/toolkit-core';
+import { isArray, isPlainObject, isString, isFunction } from '@zayne-labs/toolkit-type-helpers';
+
+// src/hooks/createCustomContext.ts
+var ContextError = class extends Error {
+  name = "ContextError";
+};
+var getErrorMessage = (hook, provider) => {
+  return `${hook} returned "null". Did you forget to wrap the necessary components within ${provider}?`;
+};
+var createCustomContext = (options = {}) => {
+  const {
+    defaultValue = null,
+    errorMessage,
+    hookName = "Unnamed Context hook",
+    name = "Unnamed Context",
+    providerName = "Unnamed Provider",
+    strict = true
+  } = options;
+  const Context = createContext(defaultValue);
+  Context.displayName = name;
+  const useCustomContext = () => {
+    const contextValue = useContext(Context);
+    if (strict && contextValue === null) {
+      throw new ContextError(errorMessage ?? getErrorMessage(hookName, providerName));
+    }
+    return contextValue;
+  };
+  return [Context.Provider, useCustomContext];
+};
+var useCallbackRef = (callbackFn) => {
+  const callbackRef = useRef(callbackFn);
+  useLayoutEffect(() => {
+    callbackRef.current = callbackFn;
+  }, [callbackFn]);
+  const savedCallback = useCallback(
+    // eslint-disable-next-line ts-eslint/no-unnecessary-condition -- callbackRef.current can be null in some cases
+    (...params) => callbackRef.current?.(...params),
+    []
+  );
+  return savedCallback;
+};
+
+// src/hooks/effects/useAfterMountEffect.ts
+var useAfterMountEffect = (callBackFn, deps) => {
+  const isFirstMount = useRef(true);
+  const stableCallback = useCallbackRef(callBackFn);
+  useEffect(() => {
+    if (isFirstMount.current) {
+      isFirstMount.current = false;
+      return;
+    }
+    stableCallback();
+  }, deps);
+};
+var useEffectOnce = (callBackFn) => {
+  const stableCallback = useCallbackRef(callBackFn);
+  const effectGuard = useRef(false);
+  useEffect(() => {
+    if (effectGuard.current) return;
+    effectGuard.current = true;
+    return stableCallback();
+  }, []);
+};
+var useLifeCycle = ({ onMount, onUnmount }) => {
+  const stableOnMount = useCallbackRef(onMount);
+  const stableOnUnmount = useCallbackRef(onUnmount);
+  useEffect(() => {
+    stableOnMount();
+    return stableOnUnmount;
+  }, []);
+};
+
+// src/hooks/effects/useOnMountEffect.ts
+var useMountEffect = (callBackFn) => {
+  useLifeCycle({ onMount: callBackFn });
+};
+
+// src/hooks/effects/useOnUnMountEffect.ts
+var useOnUnmountEffect = (cleanUpFn) => useLifeCycle({ onUnmount: cleanUpFn });
+var removeClass = (target, className) => () => target.classList.remove(className);
+var useAnimateElementRefs = (elementsInfoArray) => {
+  const elementsRef = useRef({});
+  const addAnimationClasses = useCallbackRef(() => {
+    if (!isArray(elementsInfoArray)) {
+      console.error("elementsInfo is not an Array");
+      return;
+    }
+    for (const { animationClass, targetElement } of elementsInfoArray) {
+      if (!elementsRef.current[targetElement]) {
+        console.error("ElementError", `"${targetElement}" element does not exist`);
+        return;
+      }
+      elementsRef.current[targetElement].classList.add(animationClass);
+    }
+  });
+  const removeAnimationClasses = useCallbackRef(() => {
+    if (!isArray(elementsInfoArray)) {
+      console.error("elementsInfo is not an Array");
+      return;
+    }
+    for (const { animationClass, targetElement } of elementsInfoArray) {
+      if (!elementsRef.current[targetElement]) {
+        console.error("ElementError", `"${targetElement}" element does not exist`);
+        return;
+      }
+      on(
+        "transitionend",
+        elementsRef.current[targetElement],
+        removeClass(elementsRef.current[targetElement], animationClass)
+      );
+      on(
+        "animationend",
+        elementsRef.current[targetElement],
+        removeClass(elementsRef.current[targetElement], animationClass)
+      );
+    }
+  });
+  const handleElementsAnimation = useCallback(() => {
+    addAnimationClasses();
+    removeAnimationClasses();
+  }, [addAnimationClasses, removeAnimationClasses]);
+  return { animatedElements: elementsRef.current, handleElementsAnimation };
+};
+var useConstant = (initCallbackFn) => useState(initCallbackFn)[0];
+
+// src/hooks/useAnimationInterval.ts
+var useAnimationInterval = (options) => {
+  const { intervalDuration, onAnimation, once } = options;
+  const latestCallback = useCallbackRef(onAnimation);
+  const { start, stop } = useConstant(() => setAnimationInterval(latestCallback, intervalDuration, { once }));
+  useEffect(() => {
+    if (intervalDuration === null) return;
+    start();
+    return stop;
+  }, [intervalDuration]);
+  return { start, stop };
+};
+var useCopyToClipboard = () => {
+  const [state, setState] = useState("");
+  const handleCopy = (value) => {
+    setState(value);
+    void copyToClipboard(value);
+  };
+  return { copiedValue: state, handleCopy };
+};
+var useDebouncedFn = (callBackFn, delay) => {
+  const latestCallback = useCallbackRef(callBackFn);
+  const debouncedFn = useConstant(() => debounce(latestCallback, delay));
+  useOnUnmountEffect(() => {
+    debouncedFn.cancel();
+    debouncedFn.cancelMaxWait();
+  });
+  return debouncedFn;
+};
+var useDebouncedState = (defaultValue, delay) => {
+  const [value, setValue] = useState(defaultValue);
+  const setDebouncedValue = useConstant(() => debounce(setValue, delay));
+  useOnUnmountEffect(() => {
+    setDebouncedValue.cancel();
+    setDebouncedValue.cancelMaxWait();
+  });
+  return [value, setDebouncedValue, setValue];
+};
+var useToggle = (initialValue = false) => {
+  const [value, setValue] = useState(initialValue);
+  const toggle = useCallback((newValue) => {
+    if (typeof newValue === "boolean") {
+      setValue(newValue);
+      return;
+    }
+    setValue((prev) => !prev);
+  }, []);
+  return [value, toggle];
+};
+
+// src/hooks/useDisclosure.ts
+var useDisclosure = (options = {}) => {
+  const { hasScrollControl = false, initialState = false } = options;
+  const [isOpen, toggleIsOpen] = useToggle(initialState);
+  const handleScrollControl = useCallbackRef(
+    (state) => hasScrollControl && lockScroll({ isActive: state })
+  );
+  const onOpen = useCallbackRef((value) => {
+    const booleanValue = typeof value === "boolean" && value ? value : true;
+    toggleIsOpen(booleanValue);
+    handleScrollControl(booleanValue);
+  });
+  const onClose = useCallbackRef((value) => {
+    const booleanValue = typeof value === "boolean" && !value ? value : false;
+    toggleIsOpen(booleanValue);
+    handleScrollControl(booleanValue);
+  });
+  const onToggle = useCallbackRef((value) => {
+    if (typeof value === "boolean") {
+      value ? onOpen(value) : onClose(value);
+      return;
+    }
+    isOpen ? onClose() : onOpen();
+  });
+  return { isOpen, onClose, onOpen, onToggle };
+};
+var noopStore = {
+  getServerSnapshot: () => true,
+  getSnapshot: () => false,
+  // eslint-disable-next-line unicorn/consistent-function-scoping -- It's fine
+  subscribe: () => () => {
+  }
+};
+var useIsServer = () => {
+  const isServer = useSyncExternalStore(
+    noopStore.subscribe,
+    noopStore.getSnapshot,
+    noopStore.getServerSnapshot
+  );
+  return isServer;
+};
+var useStore = (store, selector) => {
+  const slice = useSyncExternalStore(
+    store.subscribe,
+    () => selector(store.getState()),
+    () => selector(store.getInitialState())
+  );
+  useDebugValue(slice);
+  return slice;
+};
+
+// src/hooks/useLocation.ts
+var useLocation = (selector, options) => {
+  const locationStore = useConstant(() => createLocationStore(options));
+  const stateSlice = useStore(locationStore, selector);
+  return [
+    stateSlice,
+    {
+      push: locationStore.push,
+      replace: locationStore.replace,
+      triggerPopstate: locationStore.triggerPopstateEvent
+    }
+  ];
+};
+var useAnimationPresence = (options = {}) => {
+  const { defaultValue = true, duration, onExitComplete } = options;
+  const [isShown, setIsShown] = useState(defaultValue);
+  const [isMounted, setDebouncedIsMounted, setRegularIsMounted] = useDebouncedState(
+    defaultValue,
+    duration
+  );
+  const elementRef = useRef(null);
+  const stableOnExitComplete = useCallbackRef(onExitComplete);
+  useEffect(() => {
+    !isMounted && stableOnExitComplete();
+  }, [isMounted]);
+  const handleIsMountedWithoutRef = (value) => {
+    if (value) {
+      setRegularIsMounted(true);
+      return;
+    }
+    setDebouncedIsMounted(false);
+  };
+  const handleIsMountedWithRef = (value) => {
+    if (value) {
+      setRegularIsMounted(true);
+      return;
+    }
+    on("animationend", elementRef.current, () => {
+      setDebouncedIsMounted.cancel();
+      setRegularIsMounted(false);
+    });
+  };
+  const toggleVisibility = useCallbackRef((newValue) => {
+    const handleSetIsMounted = !duration ? handleIsMountedWithRef : handleIsMountedWithoutRef;
+    if (typeof newValue === "boolean") {
+      setIsShown(newValue);
+      handleSetIsMounted(newValue);
+      return;
+    }
+    setIsShown(!isShown);
+    handleSetIsMounted(!isShown);
+  });
+  return {
+    isPresent: isMounted,
+    isVisible: isShown,
+    toggleVisibility,
+    ...duration === void 0 && { elementRef }
+  };
+};
+var useTransitionPresence = (options = {}) => {
+  const { defaultValue = true, duration, onExitComplete } = options;
+  const [isShown, setIsShown] = useState(defaultValue);
+  const [isMounted, setDebouncedIsMounted, setRegularIsMounted] = useDebouncedState(
+    defaultValue,
+    duration
+  );
+  const elementRef = useRef(null);
+  const stableOnExitComplete = useCallbackRef(onExitComplete);
+  const handleIsMountedWithoutRef = (value) => {
+    if (value) {
+      setDebouncedIsMounted(value, { $delay: 0 });
+      return;
+    }
+    setDebouncedIsMounted(false);
+  };
+  const handleIsMountedWithRef = (value) => {
+    if (value) {
+      setDebouncedIsMounted(value, { $delay: 0 });
+      return;
+    }
+    on("transitionend", elementRef.current, () => {
+      setDebouncedIsMounted.cancel();
+      setRegularIsMounted(false);
+    });
+  };
+  const toggleVisibility = useCallbackRef((newValue) => {
+    const handleSetIsMounted = !duration ? handleIsMountedWithRef : handleIsMountedWithoutRef;
+    if (typeof newValue === "boolean") {
+      setIsShown(newValue);
+      handleSetIsMounted(newValue);
+      return;
+    }
+    setIsShown(!isShown);
+    handleSetIsMounted(!isShown);
+  });
+  useEffect(() => {
+    !isMounted && stableOnExitComplete();
+  }, [isMounted]);
+  return {
+    isPresent: isMounted || isShown,
+    isVisible: isMounted && isShown,
+    toggleVisibility,
+    ...duration === void 0 && { elementRef }
+  };
+};
+
+// src/hooks/usePresence/usePresence.ts
+var usePresence = (options = {}) => {
+  const { type = "transition", ...restOfOptions } = options;
+  const useSpecificPresence = type === "transition" ? useTransitionPresence : useAnimationPresence;
+  return useSpecificPresence(restOfOptions);
+};
+var useScrollObserver = (options = {}) => {
+  const { rootMargin = "10px 0px 0px 0px", ...restOfOptions } = options;
+  const [isScrolled, setIsScrolled] = useState(false);
+  const elementObserver = useConstant(() => {
+    if (!isBrowser()) return;
+    return new IntersectionObserver(
+      ([entry]) => {
+        if (!entry) return;
+        setIsScrolled(!entry.isIntersecting);
+      },
+      { rootMargin, ...restOfOptions }
+    );
+  });
+  const observedElementRef = useCallbackRef((element) => {
+    const scrollWatcher = document.createElement("span");
+    scrollWatcher.dataset.scrollWatcher = "";
+    element?.before(scrollWatcher);
+    if (!elementObserver) return;
+    elementObserver.observe(scrollWatcher);
+    const cleanupFn = () => {
+      scrollWatcher.remove();
+      elementObserver.disconnect();
+    };
+    if (!element) {
+      cleanupFn();
+      return;
+    }
+    return cleanupFn;
+  });
+  return { isScrolled, observedElementRef };
+};
+var isSerializable = (item) => typeof item === "string" || typeof item === "number" || typeof item === "boolean";
+var checkObjectPropsForQuery = (item, query) => {
+  for (const value of Object.values(item)) {
+    if (isSerializable(value) && value.toString().toLowerCase().includes(query)) {
+      return true;
+    }
+  }
+  return false;
+};
+var useSearch = (initialData, delay) => {
+  const [searchQuery, setSearchQuery] = useState("");
+  const [filteredData, setFilteredData] = useState(initialData);
+  const [isLoading, setIsLoading] = useState(false);
+  const handleDebouncedSearch = useDebouncedFn(() => {
+    const query = searchQuery.toLowerCase();
+    const filteredResults = initialData.filter((item) => {
+      if (isSerializable(item)) {
+        return item.toString().toLowerCase().includes(query);
+      }
+      if (isPlainObject(item)) {
+        return checkObjectPropsForQuery(item, query);
+      }
+      return false;
+    });
+    setFilteredData(filteredResults);
+    setIsLoading(false);
+  }, delay);
+  useAfterMountEffect(() => {
+    setIsLoading(true);
+    handleDebouncedSearch();
+  }, [searchQuery]);
+  return { data: filteredData, isLoading, query: searchQuery, setQuery: setSearchQuery };
+};
+var useSearchParams = (options) => {
+  const { action = "push", locationOptions } = options ?? {};
+  const [searchParams, setLocation] = useLocation((state) => state.search, locationOptions);
+  const setSearchParams = (newQueryParams) => {
+    const params = isFunction(newQueryParams) ? newQueryParams(searchParams) : newQueryParams;
+    const nextSearchParams = createSearchParams(params);
+    if (Object.is(searchParams.toString(), nextSearchParams.toString())) return;
+    setLocation[action]({ search: nextSearchParams });
+  };
+  setSearchParams.triggerPopstate = setLocation.triggerPopstate;
+  return [searchParams, setSearchParams];
+};
+var useSearchParamsObject = (options) => {
+  const [searchParams, setSearchParams] = useSearchParams(options);
+  const searchParamsObject = Object.fromEntries(searchParams);
+  const setSearchParamsObject = (newQueryParams) => {
+    const params = isFunction(newQueryParams) ? newQueryParams(searchParamsObject) : newQueryParams;
+    setSearchParams(params);
+  };
+  return [searchParamsObject, setSearchParamsObject];
+};
+var useStorageState = (...params) => {
+  const [keyOrOptions, $initialValue, options] = params;
+  const _key = isString(keyOrOptions) ? keyOrOptions : keyOrOptions.key;
+  const _initialValue = isString(keyOrOptions) ? $initialValue : keyOrOptions.initialValue;
+  const {
+    initialValue = _initialValue,
+    key = _key,
+    select = (value) => value,
+    ...restOfOptions
+  } = isString(keyOrOptions) ? options ?? {} : keyOrOptions;
+  const externalStore = useConstant(
+    () => createExternalStorageStore({ initialValue, key, ...restOfOptions })
+  );
+  const stateInStorage = useStore(externalStore, select);
+  return [stateInStorage, externalStore.setState, externalStore];
+};
+var useThrottleBySetTimeout = (callbackFn, delay) => {
+  const latestCallback = useCallbackRef(callbackFn);
+  const throttledCallback = useConstant(() => throttleBySetTimeout(latestCallback, delay));
+  useOnUnmountEffect(() => throttledCallback.cancelTimeout());
+  return throttledCallback;
+};
+var useThrottleByTimer = (callbackFn, delay) => {
+  const latestCallback = useCallbackRef(callbackFn);
+  const throttledCallback = useConstant(() => throttleByTime(latestCallback, delay));
+  return throttledCallback;
+};
+var useThrottleByFrame = (callbackFn) => {
+  const latestCallback = useCallbackRef(callbackFn);
+  const throttledCallback = useConstant(() => throttleByFrame(latestCallback));
+  useOnUnmountEffect(() => throttledCallback.cancelAnimation());
+  return throttledCallback;
+};
+
+export { ContextError, createCustomContext, getErrorMessage, useAfterMountEffect, useAnimateElementRefs, useAnimationInterval, useCallbackRef, useConstant, useCopyToClipboard, useDebouncedFn, useDebouncedState, useDisclosure, useEffectOnce, useIsServer, useLifeCycle, useLocation, useMountEffect, useOnUnmountEffect, usePresence, useScrollObserver, useSearch, useSearchParams, useSearchParamsObject, useStorageState, useStore, useThrottleByFrame, useThrottleBySetTimeout, useThrottleByTimer, useToggle };
+//# sourceMappingURL=chunk-AHVBSEEO.js.map
+//# sourceMappingURL=chunk-AHVBSEEO.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/hooks/createCustomContext.ts","../../src/hooks/useCallbackRef.ts","../../src/hooks/effects/useAfterMountEffect.ts","../../src/hooks/effects/useEffectOnce.ts","../../src/hooks/effects/useLifeCycle.ts","../../src/hooks/effects/useOnMountEffect.ts","../../src/hooks/effects/useOnUnMountEffect.ts","../../src/hooks/useAnimateElementRefs.ts","../../src/hooks/useConstant.ts","../../src/hooks/useAnimationInterval.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"],"mappings":"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","file":"chunk-AHVBSEEO.js","sourcesContent":["import { createContext, useContext } from \"react\";\n\nexport class ContextError extends Error {\n\toverride name = \"ContextError\";\n}\n\nexport const getErrorMessage = (hook: string, provider: string) => {\n\treturn `${hook} returned \"null\". Did you forget to wrap the necessary components within ${provider}?`;\n};\n\nexport type CustomContextOptions<TDefaultContextValue, TStrict extends boolean> = {\n\tdefaultValue?: TDefaultContextValue | null;\n\terrorMessage?: string;\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\thookName = \"Unnamed Context hook\",\n\t\tname = \"Unnamed Context\",\n\t\tproviderName = \"Unnamed Provider\",\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 = useContext(Context);\n\n\t\tif (strict && contextValue === null) {\n\t\t\tthrow new ContextError(errorMessage ?? getErrorMessage(hookName, providerName));\n\t\t}\n\n\t\treturn contextValue as UseCustomContextResult<TContextValue, TStrict>;\n\t};\n\n\treturn [Context.Provider, useCustomContext] as const;\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, 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 useOnUnmountEffect = (cleanUpFn: Destructor) => useLifeCycle({ onUnmount: cleanUpFn });\n\nexport { useOnUnmountEffect };\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 { useState } from \"react\";\n\nconst useConstant = <TResult>(initCallbackFn: () => TResult) => useState(initCallbackFn)[0];\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 { 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 { useOnUnmountEffect } from \"./effects/useOnUnMountEffect\";\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\tuseOnUnmountEffect(() => {\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\tuseOnUnmountEffect(() => {\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 handleScrollControl = useCallbackRef(\n\t\t(state: boolean) => hasScrollControl && lockScroll({ isActive: state })\n\t);\n\n\tconst onOpen = useCallbackRef(<TValue>(value?: TValue) => {\n\t\tconst booleanValue = typeof value === \"boolean\" && value ? value : true;\n\t\ttoggleIsOpen(booleanValue);\n\t\thandleScrollControl(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\thandleScrollControl(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 useStore = <TState, TSlice>(store: StoreApi<TState>, selector: SelectorFn<TState, TSlice>) => {\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 { isBrowser } from \"@zayne-labs/toolkit-core\";\nimport { useState } from \"react\";\nimport type { RefCallback } from \"../utils\";\nimport { useCallbackRef } from \"./useCallbackRef\";\nimport { useConstant } from \"./useConstant\";\n\nconst useScrollObserver = <TElement extends HTMLElement>(options: IntersectionObserverInit = {}) => {\n\tconst { rootMargin = \"10px 0px 0px 0px\", ...restOfOptions } = options;\n\n\tconst [isScrolled, setIsScrolled] = useState(false);\n\n\tconst elementObserver = useConstant(() => {\n\t\tif (!isBrowser()) return;\n\n\t\treturn new IntersectionObserver(\n\t\t\t([entry]) => {\n\t\t\t\tif (!entry) return;\n\t\t\t\tsetIsScrolled(!entry.isIntersecting);\n\t\t\t},\n\t\t\t{ rootMargin, ...restOfOptions }\n\t\t);\n\t});\n\n\tconst observedElementRef: RefCallback<TElement> = useCallbackRef((element) => {\n\t\tconst scrollWatcher = document.createElement(\"span\");\n\t\tscrollWatcher.dataset.scrollWatcher = \"\";\n\n\t\telement?.before(scrollWatcher);\n\n\t\tif (!elementObserver) return;\n\n\t\telementObserver.observe(scrollWatcher);\n\n\t\tconst cleanupFn = () => {\n\t\t\tscrollWatcher.remove();\n\t\t\telementObserver.disconnect();\n\t\t};\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 SetStorageState,\n\ttype StorageOptions,\n\tcreateExternalStorageStore,\n} from \"@zayne-labs/toolkit-core\";\nimport { type SelectorFn, isString } from \"@zayne-labs/toolkit-type-helpers\";\nimport { useConstant } from \"./useConstant\";\nimport { useStore } from \"./useStore\";\n\ntype UseStorageStateOptions<TValue, TSlice = TValue> = StorageOptions<TValue> & {\n\tselect?: SelectorFn<TValue, TSlice>;\n};\n\ntype StorageStoreApi<TValue> = ReturnType<typeof createExternalStorageStore<TValue>>;\n\ntype ParamsOne<TValue, TSlice> = [\n\tkey: string,\n\tinitialValue?: TValue,\n\toptions?: Omit<UseStorageStateOptions<TValue, TSlice>, \"initialValue\" | \"key\">,\n];\n\ntype ParamsTwo<TValue, TSlice> = [options: UseStorageStateOptions<TValue, TSlice>];\n\ntype UseStorageStateParams<TValue, TSlice> = ParamsOne<TValue, TSlice> | ParamsTwo<TValue, TSlice>;\n\n// TODO: Add createImpl that returns a hook for react later\nconst useStorageState = <TValue, TSlice = TValue>(...params: UseStorageStateParams<TValue, TSlice>) => {\n\tconst [keyOrOptions, $initialValue, options] = params;\n\n\tconst _key = isString(keyOrOptions) ? keyOrOptions : keyOrOptions.key;\n\tconst _initialValue = isString(keyOrOptions) ? $initialValue : keyOrOptions.initialValue;\n\n\tconst {\n\t\tinitialValue = _initialValue,\n\t\tkey = _key,\n\t\tselect = (value: TValue) => value,\n\t\t...restOfOptions\n\t} = isString(keyOrOptions)\n\t\t? ((options as UseStorageStateOptions<TValue, TSlice> | undefined) ?? {})\n\t\t: keyOrOptions;\n\n\tconst externalStore = useConstant(() =>\n\t\tcreateExternalStorageStore({ initialValue, key, ...restOfOptions })\n\t);\n\n\tconst stateInStorage = useStore(externalStore as never, select as never);\n\n\treturn [stateInStorage, externalStore.setState, externalStore] as [\n\t\tstate: TValue,\n\t\tsetState: SetStorageState<TValue>,\n\t\tstoreApi: StorageStoreApi<TValue>,\n\t];\n};\n\nexport { useStorageState };\n","import { throttleByFrame, throttleBySetTimeout, throttleByTime } from \"@zayne-labs/toolkit-core\";\nimport type { CallbackFn } from \"@zayne-labs/toolkit-type-helpers\";\nimport { useOnUnmountEffect } 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\tuseOnUnmountEffect(() => 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\tuseOnUnmountEffect(() => throttledCallback.cancelAnimation());\n\n\treturn throttledCallback;\n};\n"]}

package/dist/esm/createCustomContext-b8lQCth3.d.ts

@@ -0,0 +1,18 @@
+import * as react from 'react';
+
+declare class ContextError extends Error {
+    name: string;
+}
+declare const getErrorMessage: (hook: string, provider: string) => string;
+type CustomContextOptions<TDefaultContextValue, TStrict extends boolean> = {
+    defaultValue?: TDefaultContextValue | null;
+    errorMessage?: string;
+    hookName?: string;
+    name?: string;
+    providerName?: string;
+    strict?: TStrict;
+};
+type UseCustomContextResult<TContextValue, TStrict extends boolean> = TStrict extends true ? TContextValue : TContextValue | null;
+declare const createCustomContext: <TContextValue, TStrict extends boolean = true>(options?: CustomContextOptions<TContextValue, TStrict>) => readonly [react.Provider<TContextValue | null>, () => UseCustomContextResult<TContextValue, TStrict>];
+
+export { ContextError as C, type CustomContextOptions as a, createCustomContext as c, getErrorMessage as g };

package/dist/esm/global-DMxqhOh1.d.ts

@@ -0,0 +1,26 @@
+import { AnyFunction } from '@zayne-labs/toolkit-type-helpers';
+
+type ForwardedRefType<TComponent extends HTMLElement | React.ElementType> = TComponent extends React.ElementType ? React.ForwardedRef<React.Ref<TComponent>> : React.ForwardedRef<TComponent>;
+type InferProps<TComponent extends HTMLElement | React.ElementType> = TComponent extends React.ElementType ? React.ComponentPropsWithRef<TComponent> : React.HTMLAttributes<TComponent>;
+type StateSetter<TSetter = unknown> = React.Dispatch<React.SetStateAction<TSetter>>;
+type MyCustomCss<TExtra extends Record<string, string> = NonNullable<unknown>> = React.CSSProperties & Record<`--${string}`, string> & TExtra;
+/**
+ *  @description Using this instead of the official react one to avoid build errors
+ */
+type RefCallback<TElement> = (instance: TElement | null) => void | (() => void);
+/**
+ * @description Represents a set of props that can be used to render a component conditionally based on a discriminated union type.
+ * This type allows for the use of either a render prop or children prop, but not both at the same time.
+ * If both are provided, a TypeScript error will be thrown.
+ * @template TRenderPropType The type of the function that will be called to render the component when using the render prop.
+ * @template TMessage A message to display when the render prop is not used and the children prop is instead used.
+ */
+type DiscriminatedRenderProps<TRenderPropType extends AnyFunction, TMessage extends string = "Hey, Sorry but since you're currently using the children prop, the render prop is therefore redundant"> = {
+    children: TRenderPropType;
+    render?: TMessage;
+} | {
+    children?: TMessage;
+    render: TRenderPropType;
+};
+
+export type { DiscriminatedRenderProps as D, ForwardedRefType as F, InferProps as I, MyCustomCss as M, RefCallback as R, StateSetter as S };

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

@@ -0,0 +1,192 @@
+export { C as ContextError, a as CustomContextOptions, c as createCustomContext, g as getErrorMessage } from '../createCustomContext-b8lQCth3.js';
+import * as react from 'react';
+import { useEffect } from 'react';
+import { NonEmptyArray, Prettify, AnyFunction, CallbackFn, SelectorFn } from '@zayne-labs/toolkit-type-helpers';
+import * as _zayne_labs_toolkit_core from '@zayne-labs/toolkit-core';
+import { AnimationIntervalOptions, LocationInfo, LocationStoreOptions, createLocationStore, URLSearchParamsInit, SetStorageState, createExternalStorageStore, StorageOptions, StoreApi } from '@zayne-labs/toolkit-core';
+import { R as RefCallback } from '../global-DMxqhOh1.js';
+
+declare const useAfterMountEffect: typeof useEffect;
+
+declare const useEffectOnce: (callBackFn: React.EffectCallback) => void;
+
+type Destructor = ReturnType<React.EffectCallback>;
+type LifeCycleOptions = {
+    onMount?: () => void;
+    onUnmount?: Destructor;
+};
+declare const useLifeCycle: ({ onMount, onUnmount }: LifeCycleOptions) => void;
+
+declare const useMountEffect: (callBackFn: () => void) => void;
+
+declare const useOnUnmountEffect: (cleanUpFn: Destructor) => void;
+
+type ElementsInfoArray<TTargetElement extends string> = NonEmptyArray<{
+    animationClass: string;
+    targetElement: TTargetElement;
+}>;
+/**
+ * This is a custom React hook that adds and removes animation classes to specified HTML elements.
+ * @param elementsInfoArray - An array of objects that contain information about the animation class and the target HTML element.
+ * @returns - An object containing the refs of the animated elements and a function to handle the initiation and removal animation.
+ */
+declare const useAnimateElementRefs: <TTargetElement extends string>(elementsInfoArray: ElementsInfoArray<TTargetElement>) => {
+    animatedElements: Record<TTargetElement, HTMLElement | null>;
+    handleElementsAnimation: () => void;
+};
+
+type AnimationOptions = Prettify<AnimationIntervalOptions & {
+    intervalDuration: number | null;
+    onAnimation: () => void;
+}>;
+declare const useAnimationInterval: (options: AnimationOptions) => {
+    start: () => void;
+    stop: () => void;
+};
+
+/**
+ * Returns a stable function that always points to the latest version of the callback function.
+ * @param callbackFn - The function to reference
+ * @returns a stable function that always points to the latest version of the callback function
+ */
+declare const useCallbackRef: <TCallback = AnyFunction>(callbackFn: TCallback | undefined) => TCallback;
+
+declare const useConstant: <TResult>(initCallbackFn: () => TResult) => TResult;
+
+declare const useCopyToClipboard: () => {
+    copiedValue: string;
+    handleCopy: (value: string) => void;
+};
+
+declare const useDebouncedFn: <TParams>(callBackFn: CallbackFn<TParams>, delay: number | undefined) => {
+    (...params: TParams[]): void;
+    (params: TParams | TParams[], overrideOptions: {
+        $delay: number;
+    }): void;
+    cancel: () => void;
+    cancelMaxWait(): void;
+};
+declare const useDebouncedState: <TValue>(defaultValue: TValue, delay: number | undefined) => readonly [TValue, {
+    (...params: react.SetStateAction<TValue>[]): void;
+    (params: react.SetStateAction<TValue> | react.SetStateAction<TValue>[], overrideOptions: {
+        $delay: number;
+    }): void;
+    cancel: () => void;
+    cancelMaxWait(): void;
+}, react.Dispatch<react.SetStateAction<TValue>>];
+
+type DisclosureOptions = {
+    hasScrollControl?: boolean;
+    initialState?: boolean | (() => boolean);
+};
+declare const useDisclosure: (options?: DisclosureOptions) => {
+    isOpen: boolean;
+    onClose: <TValue>(value?: TValue) => void;
+    onOpen: <TValue>(value?: TValue) => void;
+    onToggle: <TValue>(value?: TValue) => void;
+};
+
+/**
+ * @description Returns whether the component is currently being server side rendered or
+ * hydrated on the client. Can be used to delay browser-specific rendering
+ * until after hydration.
+ */
+declare const useIsServer: () => boolean;
+
+type LocationStore = ReturnType<typeof createLocationStore>;
+type UseLocationResult<TSlice> = [
+    state: TSlice,
+    setState: {
+        push: LocationStore["push"];
+        replace: LocationStore["replace"];
+        triggerPopstate: LocationStore["triggerPopstateEvent"];
+    }
+];
+declare const useLocation: <TSlice = LocationInfo>(selector: SelectorFn<LocationInfo, TSlice>, options?: LocationStoreOptions) => UseLocationResult<TSlice>;
+
+type InitialState = boolean | (() => boolean);
+declare const useToggle: (initialValue?: InitialState) => readonly [boolean, <TValue>(newValue?: TValue) => void];
+
+type UsePresenceOptions<TDuration extends number | undefined> = {
+    defaultValue?: boolean;
+    /**
+     * @description The duration of the animation or transition
+     */
+    duration?: TDuration;
+    /**
+     * @description A callback function that will be called when the animation or transition ends
+     */
+    onExitComplete?: () => void;
+};
+type UsePresenceResult<TElement, TDuration> = Prettify<(TDuration extends undefined ? {
+    elementRef: React.RefObject<TElement>;
+} : unknown) & {
+    isPresent: boolean;
+    isVisible: boolean;
+    toggleVisibility: ReturnType<typeof useToggle>[1];
+}>;
+type TypeOption = {
+    /**
+     * @description The type of animation, whether animation or transition
+     * @default "transition"
+     */
+    type?: "animation" | "transition";
+};
+type UsePresence = <TElement extends HTMLElement, TDuration extends number | undefined = undefined>(options?: Prettify<TypeOption & UsePresenceOptions<TDuration>>) => UsePresenceResult<TElement, TDuration>;
+
+/**
+ * usePresence hook provides a way to animate an element, before removing it from the DOM.
+ * @param defaultValue - The default value for the presence state. Defaults to `true`.
+ * @param options - The options for the usePresence hook.
+ * @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.
+ */
+declare const usePresence: UsePresence;
+
+declare const useScrollObserver: <TElement extends HTMLElement>(options?: IntersectionObserverInit) => {
+    isScrolled: boolean;
+    observedElementRef: RefCallback<TElement>;
+};
+
+declare const useSearch: <TData>(initialData: TData[], delay?: number) => {
+    data: TData[];
+    isLoading: boolean;
+    query: string;
+    setQuery: react.Dispatch<react.SetStateAction<string>>;
+};
+
+type UseSearchParamsOptions = {
+    action?: "push" | "replace";
+    locationOptions?: LocationStoreOptions;
+};
+declare const useSearchParams: <TSearchParams extends URLSearchParamsInit>(options?: UseSearchParamsOptions) => readonly [URLSearchParams, {
+    (newQueryParams: TSearchParams | ((prev: URLSearchParams) => TSearchParams)): void;
+    triggerPopstate: (state?: _zayne_labs_toolkit_core.LocationInfo["state"]) => void;
+}];
+declare const useSearchParamsObject: <TSearchParams extends Record<string, string>>(options?: UseSearchParamsOptions) => readonly [TSearchParams, (newQueryParams: TSearchParams | ((prev: TSearchParams) => TSearchParams)) => void];
+
+type UseStorageStateOptions<TValue, TSlice = TValue> = StorageOptions<TValue> & {
+    select?: SelectorFn<TValue, TSlice>;
+};
+type StorageStoreApi<TValue> = ReturnType<typeof createExternalStorageStore<TValue>>;
+type ParamsOne<TValue, TSlice> = [
+    key: string,
+    initialValue?: TValue,
+    options?: Omit<UseStorageStateOptions<TValue, TSlice>, "initialValue" | "key">
+];
+type ParamsTwo<TValue, TSlice> = [options: UseStorageStateOptions<TValue, TSlice>];
+type UseStorageStateParams<TValue, TSlice> = ParamsOne<TValue, TSlice> | ParamsTwo<TValue, TSlice>;
+declare const useStorageState: <TValue, TSlice = TValue>(...params: UseStorageStateParams<TValue, TSlice>) => [state: TValue, setState: SetStorageState<TValue>, storeApi: StorageStoreApi<TValue>];
+
+declare const useStore: <TState, TSlice>(store: StoreApi<TState>, selector: SelectorFn<TState, TSlice>) => TSlice;
+
+declare const useThrottleBySetTimeout: <TParams>(callbackFn: CallbackFn<TParams>, delay: number) => {
+    (...params: TParams[]): void;
+    cancelTimeout(): void;
+};
+declare const useThrottleByTimer: <TParams>(callbackFn: CallbackFn<TParams>, delay: number) => (...params: TParams[]) => void;
+declare const useThrottleByFrame: <TParams>(callbackFn: CallbackFn<TParams>) => {
+    (...params: TParams[]): void;
+    cancelAnimation(): void;
+};
+
+export { useAfterMountEffect, useAnimateElementRefs, useAnimationInterval, useCallbackRef, useConstant, useCopyToClipboard, useDebouncedFn, useDebouncedState, useDisclosure, useEffectOnce, useIsServer, useLifeCycle, useLocation, useMountEffect, useOnUnmountEffect, usePresence, useScrollObserver, useSearch, useSearchParams, useSearchParamsObject, useStorageState, useStore, useThrottleByFrame, useThrottleBySetTimeout, useThrottleByTimer, useToggle };

package/dist/esm/hooks/index.js

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

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

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}

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

@@ -0,0 +1,31 @@
+import { R as RefCallback } from '../global-DMxqhOh1.js';
+export { D as DiscriminatedRenderProps, F as ForwardedRefType, I as InferProps, M as MyCustomCss, S as StateSetter } from '../global-DMxqhOh1.js';
+import * as react from 'react';
+import '@zayne-labs/toolkit-type-helpers';
+
+type AsProp<TElement extends React.ElementType> = {
+    as?: TElement;
+};
+type PropsWithOptionalAs<TElement extends React.ElementType, TProps> = "as" extends keyof TProps ? TProps : AsProp<TElement> & TProps;
+type InferOtherProps<TElement extends React.ElementType, TProps> = Omit<React.ComponentPropsWithRef<TElement>, keyof PropsWithOptionalAs<TElement, TProps>>;
+type PolymorphicProps<TElement extends React.ElementType, TProps extends Record<string, unknown> = AsProp<TElement>> = InferOtherProps<TElement, TProps> & PropsWithOptionalAs<TElement, TProps>;
+
+/**
+ * @description A utility to compose refs together.
+ *
+ * Accepts callback refs and RefObject(s)
+ */
+declare const composeRefs: <TRef>(refs: Array<React.Ref<TRef>>) => RefCallback<TRef>;
+
+declare const isSlotElement: <TProps>(child: React.ReactNode, SlotWrapper: React.FunctionComponent<TProps>) => boolean;
+type SlotOptions = {
+    errorMessage?: string;
+    throwOnMultipleSlotMatch?: boolean;
+};
+declare const getSlotElement: <TProps>(children: React.ReactNode, SlotWrapper: React.FunctionComponent<TProps>, options?: SlotOptions) => React.ReactElement<TProps> | undefined;
+declare const getOtherChildren: <TProps, TChildren extends React.ReactNode = react.ReactNode>(children: TChildren, SlotWrapperOrWrappers: Array<React.FunctionComponent<TProps>> | React.FunctionComponent<TProps>) => TChildren extends unknown[] ? TChildren : TChildren[];
+
+type UnknownProps = Record<string, unknown>;
+declare const mergeProps: (slotProps: UnknownProps, childProps: UnknownProps) => UnknownProps;
+
+export { type AsProp, type PolymorphicProps, RefCallback, composeRefs, getOtherChildren, getSlotElement, isSlotElement, mergeProps };

package/dist/esm/utils/index.js

@@ -0,0 +1,86 @@
+import { AssertionError, isArray, isPlainObject, isFunction } from '@zayne-labs/toolkit-type-helpers';
+import { toArray } from '@zayne-labs/toolkit-core';
+import { isValidElement } from 'react';
+
+// src/utils/composeRefs.ts
+var setRef = (ref, value) => {
+  if (!ref) return;
+  if (isFunction(ref)) {
+    return ref(value);
+  }
+  ref.current = value;
+};
+var composeRefs = (refs) => {
+  const refCallBack = (node) => {
+    const cleanupFnArray = refs.map((ref) => setRef(ref, node)).filter(Boolean);
+    const cleanupFn = () => cleanupFnArray.forEach((cleanup) => cleanup?.());
+    if (!node) {
+      cleanupFn();
+      return;
+    }
+    return cleanupFn;
+  };
+  return refCallBack;
+};
+var isSlotElement = (child, SlotWrapper) => {
+  if (!isValidElement(child)) {
+    return false;
+  }
+  if (child.type.slot === SlotWrapper.slot) {
+    return true;
+  }
+  if (child.type.name === SlotWrapper.name) {
+    return true;
+  }
+  if (child.type === SlotWrapper) {
+    return true;
+  }
+  return child.type.toString() === SlotWrapper.toString();
+};
+var getSlotElement = (children, SlotWrapper, options = {}) => {
+  const {
+    errorMessage = "Only one instance of the SlotComponent is allowed",
+    throwOnMultipleSlotMatch = false
+  } = options;
+  const childrenArray = toArray(children);
+  const Slot = childrenArray.filter((child) => isSlotElement(child, SlotWrapper));
+  if (throwOnMultipleSlotMatch && Slot.length > 1) {
+    throw new AssertionError(errorMessage);
+  }
+  return Slot[0];
+};
+var isSlotElementMultiple = (child, SlotWrapperArray) => SlotWrapperArray.some((slotWrapper) => isSlotElement(child, slotWrapper));
+var getOtherChildren = (children, SlotWrapperOrWrappers) => {
+  const childrenArray = toArray(children);
+  const otherChildren = isArray(SlotWrapperOrWrappers) ? childrenArray.filter((child) => !isSlotElementMultiple(child, SlotWrapperOrWrappers)) : childrenArray.filter((child) => !isSlotElement(child, SlotWrapperOrWrappers));
+  return otherChildren;
+};
+var mergeProps = (slotProps, childProps) => {
+  const overrideProps = { ...childProps };
+  for (const propName of Object.keys(slotProps)) {
+    const slotPropValue = slotProps[propName];
+    const childPropValue = childProps[propName];
+    if (propName === "style" && isPlainObject(slotPropValue) && isPlainObject(childPropValue)) {
+      overrideProps[propName] = { ...slotPropValue, ...childPropValue };
+    }
+    if (propName === "className") {
+      overrideProps[propName] = [slotPropValue, childPropValue].filter(Boolean).join(" ");
+    }
+    const isHandler = propName.startsWith("on");
+    if (!isHandler) continue;
+    if (isFunction(slotPropValue) && isFunction(childPropValue)) {
+      overrideProps[propName] = (...args) => {
+        childPropValue(...args);
+        slotPropValue(...args);
+      };
+    }
+    if (isFunction(slotPropValue)) {
+      overrideProps[propName] = slotPropValue;
+    }
+  }
+  return { ...slotProps, ...overrideProps };
+};
+
+export { composeRefs, getOtherChildren, getSlotElement, isSlotElement, mergeProps };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/utils/composeRefs.ts","../../../src/utils/getSlotElement.ts","../../../src/utils/mergeProps.ts"],"names":["isFunction"],"mappings":"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","file":"index.js","sourcesContent":["import { isFunction } from \"@zayne-labs/toolkit-type-helpers\";\nimport type { RefCallback } from \"./types\";\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 */\nconst setRef = <TRef>(ref: React.Ref<TRef>, value: TRef) => {\n\tif (!ref) return;\n\n\tif (isFunction(ref)) {\n\t\treturn ref(value);\n\t}\n\n\t// eslint-disable-next-line no-param-reassign -- Mutation is needed here\n\tref.current = value;\n};\n\n/**\n * @description A utility to compose refs together.\n *\n * Accepts callback refs and RefObject(s)\n */\nconst composeRefs = <TRef>(refs: Array<React.Ref<TRef>>): RefCallback<TRef> => {\n\tconst refCallBack: RefCallback<TRef> = (node) => {\n\t\tconst cleanupFnArray = refs.map((ref) => setRef(ref, node)).filter(Boolean);\n\n\t\tconst cleanupFn = () => cleanupFnArray.forEach((cleanup) => cleanup?.());\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 (!node) {\n\t\t\tcleanupFn();\n\t\t\treturn;\n\t\t}\n\n\t\treturn cleanupFn;\n\t};\n\n\treturn refCallBack;\n};\n\nexport { composeRefs };\n","import { toArray } from \"@zayne-labs/toolkit-core\";\nimport { AssertionError, isArray } from \"@zayne-labs/toolkit-type-helpers\";\nimport { isValidElement } from \"react\";\n\ntype Noop = () => void;\ntype WithSlot = { slot?: string };\n\nexport const isSlotElement = <TProps>(\n\tchild: React.ReactNode,\n\tSlotWrapper: React.FunctionComponent<TProps>\n) => {\n\tif (!isValidElement(child)) {\n\t\treturn false;\n\t}\n\n\tif ((child.type as WithSlot).slot === (SlotWrapper as WithSlot).slot) {\n\t\treturn true;\n\t}\n\n\tif ((child.type as Noop).name === (SlotWrapper as Noop).name) {\n\t\treturn true;\n\t}\n\n\tif (child.type === SlotWrapper) {\n\t\treturn true;\n\t}\n\n\treturn child.type.toString() === SlotWrapper.toString();\n};\n\ntype SlotOptions = {\n\terrorMessage?: string;\n\tthrowOnMultipleSlotMatch?: boolean;\n};\n\nexport const getSlotElement = <TProps>(\n\tchildren: React.ReactNode,\n\tSlotWrapper: React.FunctionComponent<TProps>,\n\toptions: SlotOptions = {}\n) => {\n\tconst {\n\t\terrorMessage = \"Only one instance of the SlotComponent is allowed\",\n\t\tthrowOnMultipleSlotMatch = false,\n\t} = options;\n\n\tconst childrenArray = toArray<React.ReactNode>(children);\n\n\tconst Slot = childrenArray.filter((child) => isSlotElement(child, SlotWrapper));\n\n\tif (throwOnMultipleSlotMatch && Slot.length > 1) {\n\t\tthrow new AssertionError(errorMessage);\n\t}\n\n\treturn Slot[0] as React.ReactElement<TProps> | undefined;\n};\n\nconst isSlotElementMultiple = <TProps>(\n\tchild: React.ReactNode,\n\tSlotWrapperArray: Array<React.FunctionComponent<TProps>>\n) => SlotWrapperArray.some((slotWrapper) => isSlotElement(child, slotWrapper));\n\n// Check if the child is a Slot element by matching any in the SlotWrapperArray\nexport const getOtherChildren = <TProps, TChildren extends React.ReactNode = React.ReactNode>(\n\tchildren: TChildren,\n\tSlotWrapperOrWrappers: Array<React.FunctionComponent<TProps>> | React.FunctionComponent<TProps>\n) => {\n\tconst childrenArray = toArray<TChildren>(children);\n\n\tconst otherChildren = isArray(SlotWrapperOrWrappers)\n\t\t? childrenArray.filter((child) => !isSlotElementMultiple(child, SlotWrapperOrWrappers))\n\t\t: childrenArray.filter((child) => !isSlotElement(child, SlotWrapperOrWrappers));\n\n\treturn otherChildren as TChildren extends unknown[] ? TChildren : TChildren[];\n};\n","import { isFunction, isPlainObject } from \"@zayne-labs/toolkit-type-helpers\";\n\ntype UnknownProps = Record<string, unknown>;\n\nconst mergeProps = (slotProps: UnknownProps, childProps: UnknownProps): UnknownProps => {\n\t// all child props should override slotProps\n\tconst overrideProps = { ...childProps };\n\n\tfor (const propName of Object.keys(slotProps)) {\n\t\tconst slotPropValue = slotProps[propName];\n\t\tconst childPropValue = childProps[propName];\n\n\t\t// == if it's `style`, we merge them\n\t\tif (propName === \"style\" && isPlainObject(slotPropValue) && isPlainObject(childPropValue)) {\n\t\t\toverrideProps[propName] = { ...slotPropValue, ...childPropValue };\n\t\t}\n\n\t\tif (propName === \"className\") {\n\t\t\toverrideProps[propName] = [slotPropValue, childPropValue].filter(Boolean).join(\" \");\n\t\t}\n\n\t\tconst isHandler = propName.startsWith(\"on\");\n\n\t\tif (!isHandler) continue;\n\n\t\t// == if the handler exists on both, we compose them\n\t\tif (isFunction(slotPropValue) && isFunction(childPropValue)) {\n\t\t\toverrideProps[propName] = (...args: unknown[]) => {\n\t\t\t\tchildPropValue(...args);\n\t\t\t\tslotPropValue(...args);\n\t\t\t};\n\t\t}\n\n\t\t// == but if it exists only on the slot, we use only that one\n\t\tif (isFunction(slotPropValue)) {\n\t\t\toverrideProps[propName] = slotPropValue;\n\t\t}\n\t}\n\n\treturn { ...slotProps, ...overrideProps };\n};\n\nexport { mergeProps };\n"]}

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

@@ -0,0 +1,20 @@
+import * as react from 'react';
+import { SelectorFn, AnyObject } from '@zayne-labs/toolkit-type-helpers';
+import * as zustand from 'zustand';
+import { UseBoundStore, StoreApi, StoreMutatorIdentifier, StateCreator } from 'zustand';
+import { a as CustomContextOptions } from '../createCustomContext-b8lQCth3.js';
+
+declare const createZustandContext: <TState extends Record<string, unknown>, TUseBoundStore extends UseBoundStore<StoreApi<TState>> = UseBoundStore<StoreApi<TState>>>(options?: CustomContextOptions<TUseBoundStore, true>) => [ZustandProvider: (props: {
+    children: React.ReactNode;
+    createStore: () => TUseBoundStore;
+} | {
+    children: React.ReactNode;
+    value: TUseBoundStore;
+}) => react.FunctionComponentElement<react.ProviderProps<TUseBoundStore | null>>, useBoundStore: <TResult>(selector: SelectorFn<TState, TResult>) => TResult];
+
+type Combine = <TInitialState extends AnyObject, TExtraState extends AnyObject, Mps extends Array<[StoreMutatorIdentifier, unknown]> = [], Mcs extends Array<[StoreMutatorIdentifier, unknown]> = []>(initialState: TInitialState, additionalStateCreator: StateCreator<TInitialState, Mps, Mcs, TExtraState>) => StateCreator<TExtraState & TInitialState>;
+declare const combine: Combine;
+declare const createStoreWithCombine: <TInitialState extends AnyObject, TExtraState extends AnyObject>(initialState: TInitialState, additionalStateCreator: StateCreator<TInitialState, [], [], TExtraState>) => zustand.StoreApi<TExtraState & TInitialState>;
+declare const createWithCombine: <TInitialState extends AnyObject, TExtraState extends AnyObject>(initialState: TInitialState, additionalStateCreator: StateCreator<TInitialState, [], [], TExtraState>) => zustand.UseBoundStore<zustand.StoreApi<TExtraState & TInitialState>>;
+
+export { type Combine, combine, createStoreWithCombine, createWithCombine, createZustandContext };

package/dist/esm/zustand/index.js

@@ -0,0 +1,29 @@
+import { createCustomContext, useConstant } from '../chunk-AHVBSEEO.js';
+import { createElement } from 'react';
+import { createStore, create } from 'zustand';
+
+var createZustandContext = (options) => {
+  const [Provider, useCustomContext] = createCustomContext(options);
+  function ZustandProvider(props) {
+    const { children, ...restOfProps } = props;
+    const useZustandStore = useConstant(
+      () => "createStore" in restOfProps ? restOfProps.createStore() : restOfProps.value
+    );
+    return createElement(Provider, { value: useZustandStore }, children);
+  }
+  const useBoundStore = (selector) => useCustomContext()(selector);
+  return [ZustandProvider, useBoundStore];
+};
+var combine = (initialState, storeCreator) => (
+  // eslint-disable-next-line ts-eslint/no-unsafe-return -- We don't know what the storeCreator will return
+  (...params) => ({
+    ...initialState,
+    ...storeCreator(...params)
+  })
+);
+var createStoreWithCombine = (...params) => createStore(combine(...params));
+var createWithCombine = (...params) => create(combine(...params));
+
+export { combine, createStoreWithCombine, createWithCombine, createZustandContext };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/zustand/createZustandContext.ts","../../../src/zustand/createZustandStoreWithCombine.ts"],"names":[],"mappings":";;;;AAKM,IAAA,oBAAA,GAAuB,CAI5B,OACI,KAAA;AACJ,EAAA,MAAM,CAAC,QAAA,EAAU,gBAAgB,CAAA,GAAI,oBAAoB,OAAO,CAAA;AAYhE,EAAA,SAAS,gBAAgB,KAA6B,EAAA;AACrD,IAAA,MAAM,EAAE,QAAA,EAAU,GAAG,WAAA,EAAgB,GAAA,KAAA;AAErC,IAAA,MAAM,eAAkB,GAAA,WAAA;AAAA,MAAY,MACnC,aAAiB,IAAA,WAAA,GAAc,WAAY,CAAA,WAAA,KAAgB,WAAY,CAAA;AAAA,KACxE;AAEA,IAAA,OAAO,cAAc,QAAU,EAAA,EAAE,KAAO,EAAA,eAAA,IAAmB,QAAQ,CAAA;AAAA;AAGpE,EAAA,MAAM,aAAgB,GAAA,CAAU,QAA0C,KAAA,gBAAA,GAAmB,QAAQ,CAAA;AAErG,EAAO,OAAA,CAAC,iBAAiB,aAAa,CAAA;AAIvC;AC1Ba,IAAA,OAAA,GACZ,CAAC,YAAc,EAAA,YAAA;AAAA;AAAA,EAEf,IAAI,MAAY,MAAA;AAAA,IACf,GAAG,YAAA;AAAA,IACH,GAAI,YAA6B,CAAA,GAAG,MAAM;AAAA,GAC3C;AAAA;AAEM,IAAM,yBAAyB,CAClC,GAAA,MAAA,KACC,YAAY,OAAQ,CAAA,GAAG,MAAM,CAAC;AAE5B,IAAM,oBAAoB,CAC7B,GAAA,MAAA,KACC,OAAO,OAAQ,CAAA,GAAG,MAAM,CAAC","file":"index.js","sourcesContent":["import type { SelectorFn } from \"@zayne-labs/toolkit-type-helpers\";\nimport { createElement } from \"react\";\nimport type { StoreApi, UseBoundStore } from \"zustand\";\nimport { type CustomContextOptions, createCustomContext, useConstant } from \"../hooks\";\n\nconst createZustandContext = <\n\tTState extends Record<string, unknown>,\n\tTUseBoundStore extends UseBoundStore<StoreApi<TState>> = UseBoundStore<StoreApi<TState>>,\n>(\n\toptions?: CustomContextOptions<TUseBoundStore, true>\n) => {\n\tconst [Provider, useCustomContext] = createCustomContext(options);\n\n\ttype ZustandProviderProps =\n\t\t| {\n\t\t\t\tchildren: React.ReactNode;\n\t\t\t\tcreateStore: () => TUseBoundStore;\n\t\t  }\n\t\t| {\n\t\t\t\tchildren: React.ReactNode;\n\t\t\t\tvalue: TUseBoundStore;\n\t\t  };\n\n\tfunction ZustandProvider(props: ZustandProviderProps) {\n\t\tconst { children, ...restOfProps } = props;\n\n\t\tconst useZustandStore = useConstant(() =>\n\t\t\t\"createStore\" in restOfProps ? restOfProps.createStore() : restOfProps.value\n\t\t);\n\n\t\treturn createElement(Provider, { value: useZustandStore }, children);\n\t}\n\n\tconst useBoundStore = <TResult>(selector: SelectorFn<TState, TResult>) => useCustomContext()(selector);\n\n\treturn [ZustandProvider, useBoundStore] as [\n\t\tZustandProvider: typeof ZustandProvider,\n\t\tuseBoundStore: typeof useBoundStore,\n\t];\n};\n\nexport { createZustandContext };\n","import type { AnyFunction, AnyObject } from \"@zayne-labs/toolkit-type-helpers\";\nimport { type StateCreator, type StoreMutatorIdentifier, create, createStore } from \"zustand\";\n\nexport type Combine = <\n\tTInitialState extends AnyObject,\n\tTExtraState extends AnyObject,\n\tMps extends Array<[StoreMutatorIdentifier, unknown]> = [],\n\tMcs extends Array<[StoreMutatorIdentifier, unknown]> = [],\n>(\n\tinitialState: TInitialState,\n\tadditionalStateCreator: StateCreator<TInitialState, Mps, Mcs, TExtraState>\n) => StateCreator<TExtraState & TInitialState>;\n\nexport const combine: Combine =\n\t(initialState, storeCreator) =>\n\t// eslint-disable-next-line ts-eslint/no-unsafe-return -- We don't know what the storeCreator will return\n\t(...params) => ({\n\t\t...initialState,\n\t\t...(storeCreator as AnyFunction)(...params),\n\t});\n\nexport const createStoreWithCombine = <TInitialState extends AnyObject, TExtraState extends AnyObject>(\n\t...params: Parameters<typeof combine<TInitialState, TExtraState>>\n) => createStore(combine(...params));\n\nexport const createWithCombine = <TInitialState extends AnyObject, TExtraState extends AnyObject>(\n\t...params: Parameters<typeof combine<TInitialState, TExtraState>>\n) => create(combine(...params));\n"]}

package/package.json

@@ -0,0 +1,111 @@
+{
+  "name": "@zayne-labs/toolkit-react",
+  "type": "module",
+  "version": "0.8.22",
+  "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",
+  "homepage": "https://github.com/zayne-labs/toolkit#readme",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/zayne-labs/toolkit.git"
+  },
+  "bugs": {
+    "url": "https://github.com/zayne-labs/toolkit/issues"
+  },
+  "keywords": [
+    "utilities",
+    "types",
+    "hooks"
+  ],
+  "sideEffects": false,
+  "exports": {
+    ".": "./dist/esm/hooks/index.js",
+    "./utils": "./dist/esm/utils/index.js",
+    "./zustand": "./dist/esm/zustand/index.js"
+  },
+  "main": "./dist/esm/hooks/index.js",
+  "module": "./dist/esm/hooks/index.js",
+  "types": "./dist/esm/hooks/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=18.x"
+  },
+  "peerDependencies": {
+    "react": ">=18.0.0",
+    "react-dom": ">=18.0.0",
+    "zustand": ">=4.0.0"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    },
+    "react-dom": {
+      "optional": true
+    },
+    "zustand": {
+      "optional": true
+    }
+  },
+  "dependencies": {
+    "@zayne-labs/toolkit-core": "0.8.22",
+    "@zayne-labs/toolkit-type-helpers": "0.8.22"
+  },
+  "devDependencies": {
+    "@arethetypeswrong/cli": "^0.17.2",
+    "@changesets/cli": "^2.27.11",
+    "@size-limit/esbuild-why": "^11.1.6",
+    "@size-limit/preset-small-lib": "^11.1.6",
+    "@total-typescript/ts-reset": "^0.6.1",
+    "@types/node": "^22.10.3",
+    "@types/react": "^19.0.2",
+    "@types/react-dom": "^19.0.2",
+    "@zayne-labs/tsconfig": "0.2.1",
+    "concurrently": "^9.1.2",
+    "cross-env": "^7.0.3",
+    "prettier-plugin-classnames": "^0.7.5",
+    "prettier-plugin-merge": "^0.7.2",
+    "prettier-plugin-tailwindcss": "^0.6.9",
+    "publint": "^0.2.12",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "size-limit": "^11.1.6",
+    "tailwindcss": "^3.4.17",
+    "terser": "^5.37.0",
+    "tsup": "^8.3.5",
+    "typescript": "^5.7.2",
+    "zustand": "^5.0.2"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/",
+    "provenance": true
+  },
+  "size-limit": [
+    {
+      "path": "./src/hooks/index.ts",
+      "limit": "5.2 kb"
+    },
+    {
+      "path": "./src/utils/index.ts",
+      "limit": "1 kb"
+    },
+    {
+      "path": "./src/zustand/index.ts",
+      "limit": "600 b"
+    }
+  ],
+  "scripts": {
+    "build": "tsup",
+    "build:dev": "cross-env NODE_ENV=development tsup",
+    "build:test": "concurrently --prefix-colors \"yellow.bold,#7da4f8.bold,magenta\" --names PUBLINT,TSUP 'pnpm:lint:publint' 'pnpm:build:dev'",
+    "lint:attw": "attw --pack . --ignore-rules=cjs-resolves-to-esm",
+    "lint:check-types": "tsc --pretty --incremental -p tsconfig.json",
+    "lint:publint": "publint --strict .",
+    "lint:size": "size-limit",
+    "release": "pnpm publish --no-git-checks",
+    "test:release": "pnpx pkg-pr-new publish"
+  }
+}