@codeleap/hooks 7.0.0 → 7.0.1

package/dist/index.js

@@ -0,0 +1,32 @@
+import { useEffect, useRef, useState, useImperativeHandle, useMemo, useCallback, useContext, useLayoutEffect, useDebugValue, useReducer, } from 'react';
+export * from './useConditionalState';
+export * from './usePromise';
+export * from './useUncontrolled';
+export * from './useForceRender';
+export * from './useDebounce';
+export * from './useInterval';
+export * from './onMount';
+export * from './onUpdate';
+export * from './usePrevious';
+export * from './useToggle';
+export * from './useBooleanToggle';
+export * from './useModal';
+export * from './usePlaces';
+export * from './usePlacesAutocompleteUtils';
+export * from './useEffectOnce';
+export * from './useUnmount';
+export * from './useSearch';
+export * from './usePartialState';
+export * from './useIsMounted';
+export * from './useComponentTestId';
+export * from './useId';
+export * from './useDebounceCallback';
+export * from './useDerivedRef';
+export * from './useDerivedState';
+export * from './useFilteredList';
+export * from './useLazyStore';
+export * from './useStableReference';
+export * from './useOptions';
+export * from './useRenderCall';
+export { useEffect, useRef, useState, useImperativeHandle, useMemo, useCallback, useContext, useLayoutEffect, useDebugValue, useReducer, };
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EACT,MAAM,EACN,QAAQ,EACR,mBAAmB,EACnB,OAAO,EACP,WAAW,EACX,UAAU,EACV,eAAe,EACf,aAAa,EACb,UAAU,GACX,MAAM,OAAO,CAAA;AAEd,cAAc,uBAAuB,CAAA;AACrC,cAAc,cAAc,CAAA;AAC5B,cAAc,mBAAmB,CAAA;AACjC,cAAc,kBAAkB,CAAA;AAChC,cAAc,eAAe,CAAA;AAC7B,cAAc,eAAe,CAAA;AAC7B,cAAc,WAAW,CAAA;AACzB,cAAc,YAAY,CAAA;AAC1B,cAAc,eAAe,CAAA;AAC7B,cAAc,aAAa,CAAA;AAC3B,cAAc,oBAAoB,CAAA;AAClC,cAAc,YAAY,CAAA;AAC1B,cAAc,aAAa,CAAA;AAC3B,cAAc,8BAA8B,CAAA;AAC5C,cAAc,iBAAiB,CAAA;AAC/B,cAAc,cAAc,CAAA;AAC5B,cAAc,aAAa,CAAA;AAC3B,cAAc,mBAAmB,CAAA;AACjC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,sBAAsB,CAAA;AACpC,cAAc,SAAS,CAAA;AACvB,cAAc,uBAAuB,CAAA;AACrC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,mBAAmB,CAAA;AACjC,cAAc,mBAAmB,CAAA;AACjC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,sBAAsB,CAAA;AACpC,cAAc,cAAc,CAAA;AAC5B,cAAc,iBAAiB,CAAA;AAE/B,OAAO,EACL,SAAS,EACT,MAAM,EACN,QAAQ,EACR,mBAAmB,EACnB,OAAO,EACP,WAAW,EACX,UAAU,EACV,eAAe,EACf,aAAa,EACb,UAAU,GACX,CAAA"}

package/dist/onMount.js

@@ -0,0 +1,16 @@
+import { useEffect } from 'react';
+/**
+ * Hook that runs a function once when the component mounts.
+ *
+ * @example
+ * onMount(() => {
+ *   console.log('Component mounted')
+ *   return () => console.log('Component unmounted')
+ * })
+ */
+export const onMount = (func) => {
+    useEffect(() => {
+        return func();
+    }, []);
+};
+//# sourceMappingURL=onMount.js.map

package/dist/onMount.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"onMount.js","sourceRoot":"","sources":["../src/onMount.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAGjC;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,IAAiB,EAAE,EAAE;IAC3C,SAAS,CAAC,GAAG,EAAE;QACb,OAAO,IAAI,EAAE,CAAA;IACf,CAAC,EAAE,EAAE,CAAC,CAAA;AACR,CAAC,CAAA"}

package/dist/onUpdate.js

@@ -0,0 +1,15 @@
+import { useEffect } from 'react';
+/**
+ * Hook that runs a function when specified dependencies change.
+ *
+ * @example
+ * onUpdate(() => {
+ *   console.log('Count changed:', count)
+ * }, [count])
+ */
+export const onUpdate = (func, listeners = []) => {
+    useEffect(() => {
+        return func();
+    }, listeners);
+};
+//# sourceMappingURL=onUpdate.js.map

package/dist/onUpdate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"onUpdate.js","sourceRoot":"","sources":["../src/onUpdate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAGjC;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,IAAiB,EAAE,SAAS,GAAG,EAAE,EAAE,EAAE;IAC5D,SAAS,CAAC,GAAG,EAAE;QACb,OAAO,IAAI,EAAE,CAAA;IACf,CAAC,EAAE,SAAS,CAAC,CAAA;AACf,CAAC,CAAA"}

package/dist/useBooleanToggle.js

@@ -0,0 +1,22 @@
+import { useState } from 'react';
+/**
+ * Hook that manages a boolean state with toggle functionality.
+ *
+ * @example
+ * const [isOpen, toggleOpen] = useBooleanToggle(false)
+ * toggleOpen() // Toggles the value
+ * toggleOpen(true) // Sets to true
+ */
+export function useBooleanToggle(initial) {
+    const [v, setV] = useState(initial);
+    function toggleOrSet(value) {
+        if (typeof value === 'boolean') {
+            setV(value);
+        }
+        else {
+            setV((previous) => !previous);
+        }
+    }
+    return [v, toggleOrSet];
+}
+//# sourceMappingURL=useBooleanToggle.js.map

package/dist/useBooleanToggle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useBooleanToggle.js","sourceRoot":"","sources":["../src/useBooleanToggle.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AAEhC;;;;;;;GAOG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAgB;IAC/C,MAAM,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAA;IAEnC,SAAS,WAAW,CAAC,KAAe;QAClC,IAAI,OAAO,KAAK,KAAK,SAAS,EAAE,CAAC;YAC/B,IAAI,CAAC,KAAK,CAAC,CAAA;QACb,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAA;QAC/B,CAAC;IACH,CAAC;IAED,OAAO,CAAC,CAAC,EAAE,WAAW,CAAU,CAAA;AAClC,CAAC"}

package/dist/useComponentTestId.js

@@ -0,0 +1,43 @@
+import { useRef, Children } from 'react';
+const simpleHash = (str) => {
+    let hash = 0;
+    for (let i = 0; i < str.length; i++) {
+        hash = (hash << 5) - hash + str.charCodeAt(i);
+        hash |= 0;
+    }
+    return Math.abs(hash).toString();
+};
+const normalizeProps = (props, keys) => {
+    return keys.reduce((acc, key) => {
+        if (key === 'children') {
+            acc[key] = Children.map(props[key], (child) => typeof child === 'object' ? '[Component]' : child);
+        }
+        else {
+            acc[key] = props[key];
+        }
+        return acc;
+    }, {});
+};
+const normalizeDebugName = (debugName) => {
+    return debugName.trim().replace(/\s+/g, '-').toLowerCase();
+};
+const generateComponentTestId = (componentName, props, keys) => {
+    const hasDebugName = typeof (props === null || props === void 0 ? void 0 : props.debugName) === 'string';
+    if (hasDebugName)
+        return `${componentName}:${normalizeDebugName(props === null || props === void 0 ? void 0 : props.debugName)}`;
+    const extractedProps = normalizeProps(props, keys);
+    return `${componentName}:${simpleHash(JSON.stringify(extractedProps))}`;
+};
+/**
+ * Hook that generates a stable test ID for a component based on its props.
+ * Uses debugName if available, otherwise generates a hash from specified prop keys.
+ *
+ * @example
+ * const testId = useComponentTestId(Button, props, ['label', 'variant'])
+ * // Returns: "Button:debug-name" or "Button:123456"
+ */
+export const useComponentTestId = (Component, props, keys) => {
+    const testIdRef = useRef(generateComponentTestId(Component.styleRegistryName, props, keys));
+    return testIdRef.current;
+};
+//# sourceMappingURL=useComponentTestId.js.map

package/dist/useComponentTestId.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useComponentTestId.js","sourceRoot":"","sources":["../src/useComponentTestId.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AAExC,MAAM,UAAU,GAAG,CAAC,GAAW,EAAU,EAAE;IACzC,IAAI,IAAI,GAAG,CAAC,CAAA;IACZ,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACpC,IAAI,GAAG,CAAC,IAAI,IAAI,CAAC,CAAC,GAAG,IAAI,GAAG,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAA;QAC7C,IAAI,IAAI,CAAC,CAAA;IACX,CAAC;IACD,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAA;AAClC,CAAC,CAAA;AAED,MAAM,cAAc,GAAG,CAAsB,KAAQ,EAAE,IAAoB,EAAc,EAAE;IACzF,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE;QAC9B,IAAI,GAAG,KAAK,UAAU,EAAE,CAAC;YACvB,GAAG,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,KAAK,CAC/F,CAAA;QACH,CAAC;aAAM,CAAC;YACN,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,CAAA;QACvB,CAAC;QACD,OAAO,GAAG,CAAA;IACZ,CAAC,EAAE,EAAgB,CAAC,CAAA;AACtB,CAAC,CAAA;AAED,MAAM,kBAAkB,GAAG,CAAC,SAAiB,EAAE,EAAE;IAC/C,OAAO,SAAS,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,WAAW,EAAE,CAAA;AAC5D,CAAC,CAAA;AAED,MAAM,uBAAuB,GAAG,CAAsB,aAAqB,EAAE,KAAQ,EAAE,IAAoB,EAAE,EAAE;IAC7G,MAAM,YAAY,GAAG,OAAO,CAAA,KAAK,aAAL,KAAK,uBAAL,KAAK,CAAE,SAAS,CAAA,KAAK,QAAQ,CAAA;IACzD,IAAI,YAAY;QAAE,OAAO,GAAG,aAAa,IAAI,kBAAkB,CAAC,KAAK,aAAL,KAAK,uBAAL,KAAK,CAAE,SAAS,CAAC,EAAE,CAAA;IACnF,MAAM,cAAc,GAAG,cAAc,CAAC,KAAK,EAAE,IAAI,CAAC,CAAA;IAClD,OAAO,GAAG,aAAa,IAAI,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC,EAAE,CAAA;AACzE,CAAC,CAAA;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAChC,SAAc,EACd,KAAQ,EACR,IAAoB,EACpB,EAAE;IACF,MAAM,SAAS,GAAG,MAAM,CAAC,uBAAuB,CAAC,SAAS,CAAC,iBAAiB,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC,CAAA;IAC3F,OAAO,SAAS,CAAC,OAAO,CAAA;AAC1B,CAAC,CAAA"}

package/dist/useConditionalState.js

@@ -0,0 +1,23 @@
+import { useState } from 'react';
+import { useBooleanToggle } from './useBooleanToggle';
+/**
+ * Hook that uses external state if provided, otherwise creates internal state.
+ * Useful for creating controlled/uncontrolled component patterns.
+ *
+ * @example
+ * // Controlled mode
+ * const [value, setValue] = useConditionalState(props.value, props.onChange)
+ *
+ * // Uncontrolled mode
+ * const [value, setValue] = useConditionalState(undefined, undefined, { initialValue: 'default' })
+ */
+export const useConditionalState = (value, setter, options = {}) => {
+    const state = (options === null || options === void 0 ? void 0 : options.isBooleanToggle)
+        ? useBooleanToggle(options === null || options === void 0 ? void 0 : options.initialValue)
+        : useState(options === null || options === void 0 ? void 0 : options.initialValue);
+    if (typeof value !== 'undefined' && typeof setter === 'function') {
+        return [value, setter];
+    }
+    return state;
+};
+//# sourceMappingURL=useConditionalState.js.map

package/dist/useConditionalState.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useConditionalState.js","sourceRoot":"","sources":["../src/useConditionalState.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAA4B,MAAM,OAAO,CAAA;AAE1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AASrD;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CACjC,KAAoB,EACpB,MAAmB,EACnB,UAAyC,EAAE,EACzB,EAAE;IACpB,MAAM,KAAK,GAAG,CAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,eAAe;QACpC,CAAC,CAAC,gBAAgB,CAAC,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,YAAuB,CAAC;QACpD,CAAC,CAAC,QAAQ,CAAC,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,YAAY,CAAC,CAAA;IAEnC,IAAI,OAAO,KAAK,KAAK,WAAW,IAAI,OAAO,MAAM,KAAK,UAAU,EAAE,CAAC;QACjE,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,CAAA;IACxB,CAAC;IAED,OAAO,KAAoC,CAAA;AAC7C,CAAC,CAAA"}

package/dist/useDebounce.js

@@ -0,0 +1,25 @@
+import { useEffect, useRef, useState } from 'react';
+/**
+ * Hook that debounces a value, updating it after a specified delay.
+ *
+ * @example
+ * const [debouncedSearch, resetDebounce] = useDebounce(searchTerm, 500)
+ * // debouncedSearch updates 500ms after searchTerm stops changing
+ */
+export function useDebounce(value, debounce) {
+    const [debouncedValue, setDebouncedValue] = useState(value);
+    const timeoutRef = useRef(null);
+    const reset = () => {
+        if (timeoutRef.current) {
+            clearTimeout(timeoutRef.current);
+        }
+    };
+    useEffect(() => {
+        timeoutRef.current = setTimeout(() => {
+            setDebouncedValue(value);
+        }, debounce);
+        return reset;
+    }, [value]);
+    return [debouncedValue, reset];
+}
+//# sourceMappingURL=useDebounce.js.map

package/dist/useDebounce.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDebounce.js","sourceRoot":"","sources":["../src/useDebounce.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AAEnD;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CACzB,KAAQ,EACR,QAAgB;IAEhB,MAAM,CAAC,cAAc,EAAE,iBAAiB,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAA;IAE3D,MAAM,UAAU,GAAG,MAAM,CAAuC,IAAI,CAAC,CAAA;IAErE,MAAM,KAAK,GAAG,GAAG,EAAE;QACjB,IAAI,UAAU,CAAC,OAAO,EAAE,CAAC;YACvB,YAAY,CAAC,UAAU,CAAC,OAAO,CAAC,CAAA;QAClC,CAAC;IACH,CAAC,CAAA;IACD,SAAS,CAAC,GAAG,EAAE;QACb,UAAU,CAAC,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE;YACnC,iBAAiB,CAAC,KAAK,CAAC,CAAA;QAC1B,CAAC,EAAE,QAAQ,CAAC,CAAA;QAEZ,OAAO,KAAK,CAAA;IACd,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAA;IAEX,OAAO,CAAC,cAAc,EAAE,KAAK,CAAC,CAAA;AAChC,CAAC"}

package/dist/useDebounceCallback.js

@@ -0,0 +1,39 @@
+import { useRef, useCallback } from 'react';
+/**
+ * Hook that creates debounced, flush, and cancel functions for a callback.
+ *
+ * @example
+ * const { debounce, flush, cancel } = useDebounceCallback((value) => {
+ *   console.log(value)
+ * }, 500)
+ *
+ * debounce('hello') // Will call callback after 500ms
+ * flush('immediate') // Calls callback immediately
+ * cancel() // Cancels pending debounced call
+ */
+export function useDebounceCallback(callback, delay = 1000) {
+    const timeoutRef = useRef(null);
+    const debounce = useCallback((...args) => {
+        cancel();
+        timeoutRef.current = setTimeout(() => {
+            callback(...args);
+            timeoutRef.current = null;
+        }, delay);
+    }, [callback]);
+    const flush = useCallback((...args) => {
+        cancel();
+        callback(...args);
+    }, [callback]);
+    const cancel = useCallback(() => {
+        if (timeoutRef.current) {
+            clearTimeout(timeoutRef.current);
+            timeoutRef.current = null;
+        }
+    }, []);
+    return {
+        debounce,
+        flush,
+        cancel,
+    };
+}
+//# sourceMappingURL=useDebounceCallback.js.map

package/dist/useDebounceCallback.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDebounceCallback.js","sourceRoot":"","sources":["../src/useDebounceCallback.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,OAAO,CAAA;AAE3C;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,mBAAmB,CACjC,QAA8B,EAC9B,KAAK,GAAG,IAAI;IAEZ,MAAM,UAAU,GAAG,MAAM,CAAuC,IAAI,CAAC,CAAA;IAErE,MAAM,QAAQ,GAAG,WAAW,CAAC,CAAC,GAAG,IAAO,EAAE,EAAE;QAC1C,MAAM,EAAE,CAAA;QAER,UAAU,CAAC,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE;YACnC,QAAQ,CAAC,GAAG,IAAI,CAAC,CAAA;YACjB,UAAU,CAAC,OAAO,GAAG,IAAI,CAAA;QAC3B,CAAC,EAAE,KAAK,CAAC,CAAA;IACX,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAA;IAEd,MAAM,KAAK,GAAG,WAAW,CAAC,CAAC,GAAG,IAAO,EAAE,EAAE;QACvC,MAAM,EAAE,CAAA;QACR,QAAQ,CAAC,GAAG,IAAI,CAAC,CAAA;IACnB,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAA;IAEd,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,EAAE;QAC9B,IAAI,UAAU,CAAC,OAAO,EAAE,CAAC;YACvB,YAAY,CAAC,UAAU,CAAC,OAAO,CAAC,CAAA;YAChC,UAAU,CAAC,OAAO,GAAG,IAAI,CAAA;QAC3B,CAAC;IACH,CAAC,EAAE,EAAE,CAAC,CAAA;IAEN,OAAO;QACL,QAAQ;QACR,KAAK;QACL,MAAM;KACP,CAAA;AACH,CAAC"}

package/dist/useDerivedRef.js

@@ -0,0 +1,16 @@
+import { useEffect, useRef } from 'react';
+/**
+ * Hook that creates a ref that automatically updates when a derived value changes.
+ *
+ * @example
+ * const userNameRef = useDerivedRef(user, (u) => u.name)
+ * // userNameRef.current will always contain the latest user name
+ */
+export const useDerivedRef = (derivedValue, getValue) => {
+    const ref = useRef(getValue(derivedValue));
+    useEffect(() => {
+        ref.current = getValue(derivedValue);
+    }, [derivedValue]);
+    return ref;
+};
+//# sourceMappingURL=useDerivedRef.js.map

package/dist/useDerivedRef.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDerivedRef.js","sourceRoot":"","sources":["../src/useDerivedRef.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,OAAO,CAAA;AAEzC;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAC3B,YAAe,EACf,QAAgC,EACL,EAAE;IAC7B,MAAM,GAAG,GAAG,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,CAAA;IAE1C,SAAS,CAAC,GAAG,EAAE;QACb,GAAG,CAAC,OAAO,GAAG,QAAQ,CAAC,YAAY,CAAC,CAAA;IACtC,CAAC,EAAE,CAAC,YAAY,CAAC,CAAC,CAAA;IAElB,OAAO,GAAG,CAAA;AACZ,CAAC,CAAA"}

package/dist/useDerivedState.js

@@ -0,0 +1,24 @@
+import { deepEqual } from '@codeleap/utils';
+import { useState, useEffect } from 'react';
+/**
+ * Hook that creates a state that synchronizes with a derived value, with customizable equality check.
+ *
+ * @example
+ * const [state, setState] = useDerivedState(props.value, {
+ *   getValue: (v) => v.id,
+ *   areEqual: (a, b) => a === b.id
+ * })
+ */
+export const useDerivedState = (derivedValue, options = {}) => {
+    const { getValue = (value) => value, transform = (value) => value, areEqual = (currentState, derivedValue) => deepEqual(currentState, derivedValue), } = options;
+    const [state, setState] = useState(() => getValue(derivedValue));
+    useEffect(() => {
+        const newValue = getValue(derivedValue);
+        const stateAreEqual = areEqual(transform(state), transform(derivedValue));
+        if (!stateAreEqual) {
+            setState(newValue);
+        }
+    }, [derivedValue]);
+    return [state, setState];
+};
+//# sourceMappingURL=useDerivedState.js.map

package/dist/useDerivedState.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDerivedState.js","sourceRoot":"","sources":["../src/useDerivedState.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAC3C,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAQ3C;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAC7B,YAAe,EACf,UAAyB,EAAE,EACmB,EAAE;IAChD,MAAM,EACJ,QAAQ,GAAG,CAAC,KAAU,EAAE,EAAE,CAAC,KAAU,EACrC,SAAS,GAAG,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,EAC5B,QAAQ,GAAG,CAAC,YAAY,EAAE,YAAY,EAAE,EAAE,CAAC,SAAS,CAAC,YAAY,EAAE,YAAY,CAAC,GACjF,GAAG,OAAO,CAAA;IAEX,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAI,GAAG,EAAE,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,CAAA;IAEnE,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,QAAQ,GAAG,QAAQ,CAAC,YAAY,CAAC,CAAA;QAEvC,MAAM,aAAa,GAAG,QAAQ,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,SAAS,CAAC,YAAY,CAAC,CAAC,CAAA;QAEzE,IAAI,CAAC,aAAa,EAAE,CAAC;YACnB,QAAQ,CAAC,QAAQ,CAAC,CAAA;QACpB,CAAC;IACH,CAAC,EAAE,CAAC,YAAY,CAAC,CAAC,CAAA;IAElB,OAAO,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAA;AAC1B,CAAC,CAAA"}

package/dist/useEffectOnce.js

@@ -0,0 +1,14 @@
+import { useEffect } from 'react';
+/**
+ * Hook that runs an effect only once when the component mounts.
+ *
+ * @example
+ * useEffectOnce(() => {
+ *   console.log('Runs only once on mount')
+ *   return () => console.log('Cleanup on unmount')
+ * })
+ */
+export const useEffectOnce = (effect) => {
+    useEffect(effect, []);
+};
+//# sourceMappingURL=useEffectOnce.js.map

package/dist/useEffectOnce.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useEffectOnce.js","sourceRoot":"","sources":["../src/useEffectOnce.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,SAAS,EAAE,MAAM,OAAO,CAAA;AAEjD;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,MAAsB,EAAE,EAAE;IACtD,SAAS,CAAC,MAAM,EAAE,EAAE,CAAC,CAAA;AACvB,CAAC,CAAA"}

package/dist/useFilteredList.js

@@ -0,0 +1,21 @@
+import { useMemo } from 'react';
+/**
+ * Hook that filters out the first item from a list that matches a predicate.
+ *
+ * @example
+ * const filteredUsers = useFilteredList(users, (user) => user.id === deletedId)
+ * // Returns users array without the first user matching the predicate
+ */
+export function useFilteredList(list, predicate) {
+    return useMemo(() => {
+        if (!list)
+            return [];
+        const index = list.findIndex(predicate);
+        if (index === -1)
+            return list;
+        const newList = [...list];
+        newList.splice(index, 1);
+        return newList;
+    }, [list, predicate]);
+}
+//# sourceMappingURL=useFilteredList.js.map

package/dist/useFilteredList.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFilteredList.js","sourceRoot":"","sources":["../src/useFilteredList.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAA;AAE/B;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAAI,IAAS,EAAE,SAA+B;IAC3E,OAAO,OAAO,CAAC,GAAG,EAAE;QAClB,IAAI,CAAC,IAAI;YAAE,OAAO,EAAE,CAAA;QAEpB,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,CAAA;QACvC,IAAI,KAAK,KAAK,CAAC,CAAC;YAAE,OAAO,IAAI,CAAA;QAE7B,MAAM,OAAO,GAAG,CAAC,GAAG,IAAI,CAAC,CAAA;QACzB,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAA;QACxB,OAAO,OAAO,CAAA;IAChB,CAAC,EAAE,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC,CAAA;AACvB,CAAC"}

package/dist/useForceRender.js

@@ -0,0 +1,13 @@
+import { useReducer } from 'react';
+/**
+ * Hook that returns a function to force a component re-render.
+ *
+ * @example
+ * const forceRender = useForceRender()
+ * forceRender() // Forces component to re-render
+ */
+export function useForceRender() {
+    const [_, forceRender] = useReducer((x) => x + 1, 0);
+    return forceRender;
+}
+//# sourceMappingURL=useForceRender.js.map

package/dist/useForceRender.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useForceRender.js","sourceRoot":"","sources":["../src/useForceRender.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,OAAO,CAAA;AAElC;;;;;;GAMG;AACH,MAAM,UAAU,cAAc;IAC5B,MAAM,CAAC,CAAC,EAAE,WAAW,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAA;IACpD,OAAO,WAAW,CAAA;AACpB,CAAC"}

package/dist/useId.js

@@ -0,0 +1,15 @@
+import { useRef, useId as _useId } from 'react';
+/**
+ * Hook that returns a stable ID, using provided ID if available or generating one.
+ *
+ * @example
+ * const id = useId('custom-id') // Returns 'custom-id'
+ * const id = useId() // Returns generated ID like ':r1:'
+ */
+export function useId(id) {
+    var _a;
+    const defaultId = _useId();
+    const idRef = useRef(id);
+    return (_a = idRef.current) !== null && _a !== void 0 ? _a : defaultId;
+}
+//# sourceMappingURL=useId.js.map

package/dist/useId.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useId.js","sourceRoot":"","sources":["../src/useId.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,KAAK,IAAI,MAAM,EAAE,MAAM,OAAO,CAAA;AAE/C;;;;;;GAMG;AACH,MAAM,UAAU,KAAK,CAAI,EAAM;;IAC7B,MAAM,SAAS,GAAG,MAAM,EAAE,CAAA;IAC1B,MAAM,KAAK,GAAG,MAAM,CAAC,EAAE,CAAC,CAAA;IAExB,OAAO,MAAA,KAAK,CAAC,OAAO,mCAAI,SAAS,CAAA;AACnC,CAAC"}

package/dist/useInterval.js

@@ -0,0 +1,46 @@
+import { useRef, useCallback, useEffect } from 'react';
+/**
+ * Hook that manages an interval with start and clear controls.
+ * The handler receives a clear function to stop the interval from within.
+ *
+ * @example
+ * const { start, clear } = useInterval((clearFn) => {
+ *   console.log('Tick')
+ *   if (shouldStop) clearFn()
+ * }, 1000)
+ *
+ * start() // Starts the interval
+ * clear() // Stops the interval
+ */
+export function useInterval(handler, interval) {
+    const intervalRef = useRef(null);
+    const handlerRef = useRef(handler);
+    useEffect(() => {
+        handlerRef.current = handler;
+    }, [handler]);
+    const clear = useCallback(() => {
+        if (intervalRef.current != null) {
+            clearInterval(intervalRef.current);
+            intervalRef.current = null;
+        }
+    }, []);
+    const start = useCallback(() => {
+        clear();
+        if (intervalRef.current == null) {
+            intervalRef.current = setInterval(() => {
+                handlerRef.current(clear);
+            }, interval);
+        }
+    }, []);
+    useEffect(() => {
+        return () => {
+            clear();
+        };
+    }, [clear]);
+    return {
+        clear,
+        start,
+        interval: intervalRef.current,
+    };
+}
+//# sourceMappingURL=useInterval.js.map

package/dist/useInterval.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useInterval.js","sourceRoot":"","sources":["../src/useInterval.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAKtD;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,WAAW,CAAC,OAA2B,EAAE,QAAgB;IACvE,MAAM,WAAW,GAAG,MAAM,CAAwC,IAAI,CAAC,CAAA;IACvE,MAAM,UAAU,GAAG,MAAM,CAAqB,OAAO,CAAC,CAAA;IAEtD,SAAS,CAAC,GAAG,EAAE;QACb,UAAU,CAAC,OAAO,GAAG,OAAO,CAAA;IAC9B,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAA;IAEb,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE;QAC7B,IAAI,WAAW,CAAC,OAAO,IAAI,IAAI,EAAE,CAAC;YAChC,aAAa,CAAC,WAAW,CAAC,OAAO,CAAC,CAAA;YAClC,WAAW,CAAC,OAAO,GAAG,IAAI,CAAA;QAC5B,CAAC;IACH,CAAC,EAAE,EAAE,CAAC,CAAA;IAEN,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE;QAC7B,KAAK,EAAE,CAAA;QAEP,IAAI,WAAW,CAAC,OAAO,IAAI,IAAI,EAAE,CAAC;YAChC,WAAW,CAAC,OAAO,GAAG,WAAW,CAAC,GAAG,EAAE;gBACrC,UAAU,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;YAC3B,CAAC,EAAE,QAAQ,CAAC,CAAA;QACd,CAAC;IACH,CAAC,EAAE,EAAE,CAAC,CAAA;IAEN,SAAS,CAAC,GAAG,EAAE;QACb,OAAO,GAAG,EAAE;YACV,KAAK,EAAE,CAAA;QACT,CAAC,CAAA;IACH,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAA;IAEX,OAAO;QACL,KAAK;QACL,KAAK;QACL,QAAQ,EAAE,WAAW,CAAC,OAAO;KAC9B,CAAA;AACH,CAAC"}

package/dist/useIsMounted.js

@@ -0,0 +1,35 @@
+import { useEffect, useLayoutEffect, useState } from 'react';
+const isReactNativeOrServer = typeof navigator !== 'undefined';
+const useIsomorphicLayoutEffect = isReactNativeOrServer ? useLayoutEffect : useEffect;
+/**
+ * Hook to check if the component has mounted. SSR safe.
+ *
+ * @example
+ * const isMounted = useIsMounted()
+ * if (isMounted) {
+ *   // Safe to use browser APIs
+ * }
+ */
+export function useIsMounted() {
+    const [mounted, setMounted] = useState(false);
+    useIsomorphicLayoutEffect(() => {
+        setMounted(true);
+    }, []);
+    return mounted;
+}
+/**
+ * Hook to check if the code is running on the client-side.
+ * NOTE: This is just a mirror of `useIsMounted` for retrocompatibility reasons
+ *
+ * @example
+ * const { isClient } = useIsClient()
+ * if (isClient) {
+ *   // Safe to use browser APIs
+ * }
+ */
+export function useIsClient() {
+    return {
+        isClient: useIsMounted(),
+    };
+}
+//# sourceMappingURL=useIsMounted.js.map

package/dist/useIsMounted.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useIsMounted.js","sourceRoot":"","sources":["../src/useIsMounted.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AAE5D,MAAM,qBAAqB,GAAG,OAAO,SAAS,KAAK,WAAW,CAAA;AAE9D,MAAM,yBAAyB,GAC7B,qBAAqB,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,SAAS,CAAA;AAErD;;;;;;;;GAQG;AACH,MAAM,UAAU,YAAY;IAC1B,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAA;IAE7C,yBAAyB,CAAC,GAAG,EAAE;QAC7B,UAAU,CAAC,IAAI,CAAC,CAAA;IAClB,CAAC,EAAE,EAAE,CAAC,CAAA;IAEN,OAAO,OAAO,CAAA;AAChB,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,WAAW;IACzB,OAAO;QACL,QAAQ,EAAE,YAAY,EAAE;KACzB,CAAA;AACH,CAAC"}

package/dist/useLazyStore.js

@@ -0,0 +1,17 @@
+import { globalState } from '@codeleap/store';
+import { useMemo } from 'react';
+/**
+ * Hook that lazily creates a global store with an initial value.
+ * The store is created only once and persists across re-renders.
+ *
+ * @example
+ * const counterStore = useLazyStore(0)
+ * // Store is created once and can be used across components
+ */
+export function useLazyStore(initialValue) {
+    const store = useMemo(() => {
+        return globalState(initialValue);
+    }, []);
+    return store;
+}
+//# sourceMappingURL=useLazyStore.js.map

package/dist/useLazyStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useLazyStore.js","sourceRoot":"","sources":["../src/useLazyStore.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAC7C,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAA;AAE/B;;;;;;;GAOG;AACH,MAAM,UAAU,YAAY,CAAI,YAAe;IAC7C,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,EAAE;QACzB,OAAO,WAAW,CAAC,YAAY,CAAC,CAAA;IAClC,CAAC,EAAE,EAAE,CAAC,CAAA;IAEN,OAAO,KAAK,CAAA;AACd,CAAC"}

package/dist/useModal.js

@@ -0,0 +1,31 @@
+import { TypeGuards } from '@codeleap/types';
+import { useState } from 'react';
+/**
+ * Hook that manages modal visibility state with open, close, and toggle functions.
+ *
+ * @example
+ * const modal = useModal()
+ * modal.open() // Opens modal
+ * modal.close() // Closes modal
+ * modal.toggle() // Toggles visibility
+ * modal.toggle(true) // Forces open
+ */
+export function useModal(startsOpen = false) {
+    const [visible, setVisible] = useState(startsOpen);
+    function open() {
+        setVisible(true);
+    }
+    function close() {
+        setVisible(false);
+    }
+    function toggle(forceVisible) {
+        setVisible(prev => TypeGuards.isBoolean(forceVisible) ? forceVisible : !prev);
+    }
+    return {
+        visible,
+        toggle,
+        open,
+        close,
+    };
+}
+//# sourceMappingURL=useModal.js.map

package/dist/useModal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useModal.js","sourceRoot":"","sources":["../src/useModal.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AAEhC;;;;;;;;;GASG;AACH,MAAM,UAAU,QAAQ,CAAC,UAAU,GAAG,KAAK;IACzC,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,QAAQ,CAAC,UAAU,CAAC,CAAA;IAElD,SAAS,IAAI;QACX,UAAU,CAAC,IAAI,CAAC,CAAA;IAClB,CAAC;IAED,SAAS,KAAK;QACZ,UAAU,CAAC,KAAK,CAAC,CAAA;IACnB,CAAC;IAED,SAAS,MAAM,CAAC,YAAsB;QACpC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAA;IAC/E,CAAC;IAED,OAAO;QACL,OAAO;QACP,MAAM;QACN,IAAI;QACJ,KAAK;KACN,CAAA;AACH,CAAC"}

package/dist/useOptions.js

@@ -0,0 +1,25 @@
+import { useMemo, useState } from 'react';
+/**
+ * Hook that manages selected option state with boolean flags for each option.
+ *
+ * @example
+ * const { selectedOption, setSelectedOption, isSelected } = useOptions(['light', 'dark'] as const)
+ * // isSelected = { light: true, dark: false }
+ * setSelectedOption('dark')
+ * // isSelected = { light: false, dark: true }
+ */
+export function useOptions(options, initialOptions = options[0]) {
+    const [selectedOption, setSelectedOption] = useState(initialOptions);
+    const isSelected = useMemo(() => {
+        return options.reduce((acc, option) => {
+            acc[option] = option === selectedOption;
+            return acc;
+        }, {});
+    }, [selectedOption, options]);
+    return {
+        selectedOption,
+        setSelectedOption,
+        isSelected,
+    };
+}
+//# sourceMappingURL=useOptions.js.map

package/dist/useOptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useOptions.js","sourceRoot":"","sources":["../src/useOptions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AAEzC;;;;;;;;GAQG;AACH,MAAM,UAAU,UAAU,CAAmB,OAAqB,EAAE,iBAAoB,OAAO,CAAC,CAAC,CAAC;IAChG,MAAM,CAAC,cAAc,EAAE,iBAAiB,CAAC,GAAG,QAAQ,CAAI,cAAc,CAAC,CAAA;IAEvE,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,EAAE;QAC9B,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE;YACpC,GAAG,CAAC,MAAM,CAAC,GAAG,MAAM,KAAK,cAAc,CAAA;YACvC,OAAO,GAAG,CAAA;QACZ,CAAC,EAAE,EAAwB,CAAC,CAAA;IAC9B,CAAC,EAAE,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC,CAAA;IAE7B,OAAO;QACL,cAAc;QACd,iBAAiB;QACjB,UAAU;KACX,CAAA;AACH,CAAC"}

package/dist/usePartialState.js

@@ -0,0 +1,23 @@
+import { useState } from 'react';
+import { deepMerge } from '@codeleap/utils';
+/**
+ * Hook that manages state with partial updates using deep merge.
+ *
+ * @example
+ * const [user, setUser] = usePartialState({ name: 'John', age: 30 })
+ * setUser({ age: 31 }) // Only updates age, keeps name
+ * setUser(prev => ({ age: prev.age + 1 })) // Functional update
+ */
+export function usePartialState(initial) {
+    const [state, setState] = useState(initial);
+    function setPartial(value) {
+        if (typeof value === 'function') {
+            setState((v) => deepMerge(v, value(v)));
+        }
+        else {
+            setState(deepMerge(state, value));
+        }
+    }
+    return [state, setPartial];
+}
+//# sourceMappingURL=usePartialState.js.map

package/dist/usePartialState.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePartialState.js","sourceRoot":"","sources":["../src/usePartialState.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AAEhC,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAI3C;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe,CAAyB,OAAsB;IAC5E,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAA;IAE3C,SAAS,UAAU,CACjB,KAAkD;QAElD,IAAI,OAAO,KAAK,KAAK,UAAU,EAAE,CAAC;YAChC,QAAQ,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,CAAC,EAAE,KAAK,CAAC,CAAM,CAAC,CAAC,CAAC,CAAA;QAC9C,CAAC;aAAM,CAAC;YACN,QAAQ,CAAC,SAAS,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAA;QACnC,CAAC;IACH,CAAC;IAED,OAAO,CAAC,KAAU,EAAE,UAAU,CAAU,CAAA;AAC1C,CAAC"}

package/dist/usePlaces.js

@@ -0,0 +1,73 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import axios from 'axios';
+import { useQuery } from '@tanstack/react-query';
+const BASE_URL = 'https://maps.googleapis.com/maps/api/place/autocomplete/json';
+const BASE_URL_DETAILS = 'https://maps.googleapis.com/maps/api/place/details/json';
+const BASE_URL_GEOCODING = 'https://maps.googleapis.com/maps/api/geocode/json';
+const latLngRegex = /^-?\d+(\.\d+)?,-?\d+(\.\d+)?$/;
+/**
+ * Retrieves detailed information for a specific Google Place.
+ */
+export const retrievePlaceDetails = (placeId, apiKey) => __awaiter(void 0, void 0, void 0, function* () {
+    var _a;
+    const response = yield axios.get(BASE_URL_DETAILS, {
+        params: {
+            place_id: placeId,
+            key: apiKey,
+        },
+    });
+    return (_a = response === null || response === void 0 ? void 0 : response.data) === null || _a === void 0 ? void 0 : _a.result;
+});
+/**
+ * Retrieves places from Google Places API or Geocoding API.
+ * Supports both text search and lat/lng coordinates.
+ */
+export const retrievePlaces = (params) => __awaiter(void 0, void 0, void 0, function* () {
+    var _a, _b, _c, _d, _e;
+    let response;
+    const inputWithoutSpaces = (_b = (_a = params === null || params === void 0 ? void 0 : params.input) === null || _a === void 0 ? void 0 : _a.replace(/\s/g, '')) !== null && _b !== void 0 ? _b : '';
+    const isLatLng = latLngRegex === null || latLngRegex === void 0 ? void 0 : latLngRegex.test(inputWithoutSpaces);
+    if (isLatLng) {
+        response = yield (axios === null || axios === void 0 ? void 0 : axios.get(BASE_URL_GEOCODING, { params: { latlng: params === null || params === void 0 ? void 0 : params.input, key: params === null || params === void 0 ? void 0 : params.key } }));
+    }
+    else {
+        response = yield (axios === null || axios === void 0 ? void 0 : axios.get(BASE_URL, { params }));
+    }
+    let places = ((_c = response === null || response === void 0 ? void 0 : response.data) === null || _c === void 0 ? void 0 : _c.results) || ((_d = response === null || response === void 0 ? void 0 : response.data) === null || _d === void 0 ? void 0 : _d.predictions);
+    if (params === null || params === void 0 ? void 0 : params.showDetails) {
+        const apiKey = (_e = params === null || params === void 0 ? void 0 : params.key) !== null && _e !== void 0 ? _e : '';
+        places = yield Promise.all(places === null || places === void 0 ? void 0 : places.map((place) => __awaiter(void 0, void 0, void 0, function* () {
+            const placeId = place === null || place === void 0 ? void 0 : place.place_id;
+            const details = yield retrievePlaceDetails(placeId, apiKey);
+            return Object.assign(Object.assign({}, place), { details });
+        })));
+    }
+    return places;
+});
+/**
+ * Hook that fetches Google Places using React Query.
+ * Automatically handles caching and refetching.
+ *
+ * @example
+ * const places = usePlaces({
+ *   input: 'New York',
+ *   key: 'YOUR_API_KEY',
+ *   showDetails: true
+ * })
+ */
+export const usePlaces = (params) => {
+    const places = useQuery({
+        queryKey: ['places', params],
+        queryFn: () => retrievePlaces(params),
+    });
+    return places;
+};
+//# sourceMappingURL=usePlaces.js.map

package/dist/usePlaces.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePlaces.js","sourceRoot":"","sources":["../src/usePlaces.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AACzB,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAA;AAEhD,MAAM,QAAQ,GAAG,8DAA8D,CAAA;AAC/E,MAAM,gBAAgB,GAAG,yDAAyD,CAAA;AAClF,MAAM,kBAAkB,GAAG,mDAAmD,CAAA;AAE9E,MAAM,WAAW,GAAG,+BAA+B,CAAA;AAQnD;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAO,OAAe,EAAE,MAAc,EAAE,EAAE;;IAC5E,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,gBAAgB,EAAE;QACjD,MAAM,EAAE;YACN,QAAQ,EAAE,OAAO;YACjB,GAAG,EAAE,MAAM;SACZ;KACF,CAAC,CAAA;IAEF,OAAO,MAAA,QAAQ,aAAR,QAAQ,uBAAR,QAAQ,CAAE,IAAI,0CAAE,MAAM,CAAA;AAC/B,CAAC,CAAA,CAAA;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAO,MAAc,EAAE,EAAE;;IACrD,IAAI,QAAQ,CAAA;IACZ,MAAM,kBAAkB,GAAG,MAAA,MAAA,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,KAAK,0CAAE,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,mCAAI,EAAE,CAAA;IAClE,MAAM,QAAQ,GAAG,WAAW,aAAX,WAAW,uBAAX,WAAW,CAAE,IAAI,CAAC,kBAAkB,CAAC,CAAA;IAEtD,IAAI,QAAQ,EAAE,CAAC;QACb,QAAQ,GAAG,MAAM,CAAA,KAAK,aAAL,KAAK,uBAAL,KAAK,CAAE,GAAG,CAAC,kBAAkB,EAAE,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,KAAK,EAAE,GAAG,EAAE,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,GAAG,EAAE,EAAE,CAAC,CAAA,CAAA;IAC1G,CAAC;SAAM,CAAC;QACN,QAAQ,GAAG,MAAM,CAAA,KAAK,aAAL,KAAK,uBAAL,KAAK,CAAE,GAAG,CAAC,QAAQ,EAAE,EAAE,MAAM,EAAE,CAAC,CAAA,CAAA;IACnD,CAAC;IAED,IAAI,MAAM,GAAG,CAAA,MAAA,QAAQ,aAAR,QAAQ,uBAAR,QAAQ,CAAE,IAAI,0CAAE,OAAO,MAAI,MAAA,QAAQ,aAAR,QAAQ,uBAAR,QAAQ,CAAE,IAAI,0CAAE,WAAW,CAAA,CAAA;IAEnE,IAAI,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,WAAW,EAAE,CAAC;QACxB,MAAM,MAAM,GAAG,MAAA,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,GAAG,mCAAI,EAAE,CAAA;QAChC,MAAM,GAAG,MAAM,OAAO,CAAC,GAAG,CACxB,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,GAAG,CAAC,CAAO,KAAU,EAAE,EAAE;YAC/B,MAAM,OAAO,GAAG,KAAK,aAAL,KAAK,uBAAL,KAAK,CAAE,QAAQ,CAAA;YAC/B,MAAM,OAAO,GAAG,MAAM,oBAAoB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAA;YAC3D,uCAAY,KAAK,KAAE,OAAO,IAAE;QAC9B,CAAC,CAAA,CAAC,CACH,CAAA;IACH,CAAC;IAED,OAAO,MAAM,CAAA;AACf,CAAC,CAAA,CAAA;AAID;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,MAAc,EAAE,EAAE;IAC1C,MAAM,MAAM,GAAG,QAAQ,CAAC;QACtB,QAAQ,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC;QAC5B,OAAO,EAAE,GAAG,EAAE,CAAC,cAAc,CAAC,MAAM,CAAC;KACtC,CAAC,CAAA;IAEF,OAAO,MAAM,CAAA;AACf,CAAC,CAAA"}

package/dist/usePlacesAutocompleteUtils.js

@@ -0,0 +1,58 @@
+import React from 'react';
+import { TypeGuards } from '@codeleap/types';
+/**
+ * Hook that manages address autocomplete state with debounced input handling.
+ * Useful for Google Places autocomplete implementations.
+ *
+ * @example
+ * const {
+ *   address,
+ *   handleChangeAddress,
+ *   handlePressAddress,
+ *   isTyping
+ * } = usePlacesAutocompleteUtils({
+ *   debounce: 500,
+ *   onValueChange: (addr) => fetchPlaces(addr),
+ *   onPress: (addr, item) => console.log('Selected:', item)
+ * })
+ */
+export const usePlacesAutocompleteUtils = (props) => {
+    const { debounce = 250, onValueChange, onPress, } = props;
+    const [address, setAddress] = React.useState('');
+    const [isTyping, setIsTyping] = React.useState(false);
+    const setSearchTimeout = React.useRef(null);
+    const handleChangeAddress = (address) => {
+        setAddress(address);
+        if (TypeGuards.isNil(debounce)) {
+            onValueChange === null || onValueChange === void 0 ? void 0 : onValueChange(address);
+            setTimeout(() => setIsTyping(false), 250);
+        }
+        else {
+            if (setSearchTimeout.current) {
+                clearTimeout(setSearchTimeout.current);
+                setSearchTimeout.current = null;
+            }
+            setSearchTimeout.current = setTimeout(() => {
+                onValueChange === null || onValueChange === void 0 ? void 0 : onValueChange(address);
+                setIsTyping(false);
+            }, debounce !== null && debounce !== void 0 ? debounce : 0);
+        }
+    };
+    const handlePressAddress = (address, item) => {
+        setAddress(address);
+        onPress === null || onPress === void 0 ? void 0 : onPress(address, item);
+    };
+    const handleClearAddress = () => {
+        setAddress('');
+        onValueChange === null || onValueChange === void 0 ? void 0 : onValueChange('');
+    };
+    return {
+        handleChangeAddress,
+        handlePressAddress,
+        handleClearAddress,
+        address,
+        isTyping,
+        setIsTyping,
+    };
+};
+//# sourceMappingURL=usePlacesAutocompleteUtils.js.map

package/dist/usePlacesAutocompleteUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePlacesAutocompleteUtils.js","sourceRoot":"","sources":["../src/usePlacesAutocompleteUtils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AACzB,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAQ5C;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAgC,KAAyC,EAAE,EAAE;IACrH,MAAM,EACJ,QAAQ,GAAG,GAAG,EACd,aAAa,EACb,OAAO,GACR,GAAG,KAAK,CAAA;IAET,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAA;IAChD,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAA;IAErD,MAAM,gBAAgB,GAAG,KAAK,CAAC,MAAM,CAAuC,IAAI,CAAC,CAAA;IAEjF,MAAM,mBAAmB,GAAG,CAAC,OAAe,EAAE,EAAE;QAC9C,UAAU,CAAC,OAAO,CAAC,CAAA;QAEnB,IAAI,UAAU,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC/B,aAAa,aAAb,aAAa,uBAAb,aAAa,CAAG,OAAO,CAAC,CAAA;YACxB,UAAU,CAAC,GAAG,EAAE,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC,CAAA;QAC3C,CAAC;aAAM,CAAC;YACN,IAAI,gBAAgB,CAAC,OAAO,EAAE,CAAC;gBAC7B,YAAY,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAA;gBACtC,gBAAgB,CAAC,OAAO,GAAG,IAAI,CAAA;YACjC,CAAC;YAED,gBAAgB,CAAC,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE;gBACzC,aAAa,aAAb,aAAa,uBAAb,aAAa,CAAG,OAAO,CAAC,CAAA;gBACxB,WAAW,CAAC,KAAK,CAAC,CAAA;YACpB,CAAC,EAAE,QAAQ,aAAR,QAAQ,cAAR,QAAQ,GAAI,CAAC,CAAC,CAAA;QACnB,CAAC;IACH,CAAC,CAAA;IAED,MAAM,kBAAkB,GAAG,CAAC,OAAe,EAAE,IAAO,EAAE,EAAE;QACtD,UAAU,CAAC,OAAO,CAAC,CAAA;QACnB,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAG,OAAO,EAAE,IAAI,CAAC,CAAA;IAC1B,CAAC,CAAA;IAED,MAAM,kBAAkB,GAAG,GAAG,EAAE;QAC9B,UAAU,CAAC,EAAE,CAAC,CAAA;QACd,aAAa,aAAb,aAAa,uBAAb,aAAa,CAAG,EAAE,CAAC,CAAA;IACrB,CAAC,CAAA;IAED,OAAO;QACL,mBAAmB;QACnB,kBAAkB;QAClB,kBAAkB;QAClB,OAAO;QACP,QAAQ;QACR,WAAW;KACZ,CAAA;AACH,CAAC,CAAA"}

package/dist/usePrevious.js

@@ -0,0 +1,19 @@
+import { useEffect, useRef } from 'react';
+/**
+ * Hook that returns the previous value of a variable.
+ * The value is updated after render is committed to the DOM.
+ *
+ * @example
+ * const [count, setCount] = useState(0)
+ * const prevCount = usePrevious(count)
+ * // On first render: count=0, prevCount=null
+ * // After setCount(1): count=1, prevCount=0
+ */
+export const usePrevious = (value) => {
+    const ref = useRef(null);
+    useEffect(() => {
+        ref.current = value;
+    });
+    return ref.current;
+};
+//# sourceMappingURL=usePrevious.js.map

package/dist/usePrevious.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePrevious.js","sourceRoot":"","sources":["../src/usePrevious.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,OAAO,CAAA;AAEzC;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAI,KAAQ,EAAE,EAAE;IACzC,MAAM,GAAG,GAAG,MAAM,CAAI,IAAI,CAAC,CAAA;IAC3B,SAAS,CAAC,GAAG,EAAE;QACb,GAAG,CAAC,OAAO,GAAG,KAAK,CAAA;IACrB,CAAC,CAAC,CAAA;IACF,OAAO,GAAG,CAAC,OAAO,CAAA;AACpB,CAAC,CAAA"}

package/dist/usePromise.js

@@ -0,0 +1,62 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import { useRef } from 'react';
+import { TypeGuards } from '@codeleap/types';
+/**
+ * Hook that creates a deferred promise with manual resolve/reject control.
+ * Useful for coordinating asynchronous operations across component lifecycle.
+ *
+ * @example
+ * const promise = usePromise({ timeout: 5000 })
+ * const handleClick = async () => {
+ *   const result = await promise._await()
+ *   console.log(result)
+ * }
+ * // Later, from another callback:
+ * promise.resolve('success')
+ */
+export const usePromise = (options) => {
+    const rejectRef = useRef(null);
+    const resolveRef = useRef(null);
+    const timeoutRef = useRef(null);
+    const reject = (err) => __awaiter(void 0, void 0, void 0, function* () {
+        var _a, _b;
+        yield ((_a = rejectRef.current) === null || _a === void 0 ? void 0 : _a.call(rejectRef, err));
+        (_b = options === null || options === void 0 ? void 0 : options.onReject) === null || _b === void 0 ? void 0 : _b.call(options, err);
+        if (timeoutRef.current)
+            clearTimeout(timeoutRef.current);
+        rejectRef.current = null;
+    });
+    const resolve = (value) => __awaiter(void 0, void 0, void 0, function* () {
+        var _a, _b;
+        yield ((_a = resolveRef.current) === null || _a === void 0 ? void 0 : _a.call(resolveRef, value));
+        (_b = options === null || options === void 0 ? void 0 : options.onResolve) === null || _b === void 0 ? void 0 : _b.call(options, value);
+        if (timeoutRef.current)
+            clearTimeout(timeoutRef.current);
+        resolveRef.current = null;
+    });
+    const _await = () => {
+        return new Promise((resolve, reject) => {
+            rejectRef.current = reject;
+            resolveRef.current = resolve;
+            if (TypeGuards.isNumber(options === null || options === void 0 ? void 0 : options.timeout) && (options === null || options === void 0 ? void 0 : options.timeout) > 0) {
+                timeoutRef.current = setTimeout(() => {
+                    reject(new Error(`usePromise: ${(options === null || options === void 0 ? void 0 : options.debugName) || ''} timed out after ${options === null || options === void 0 ? void 0 : options.timeout}ms`));
+                }, options === null || options === void 0 ? void 0 : options.timeout);
+            }
+        });
+    };
+    return {
+        _await,
+        resolve,
+        reject,
+    };
+};
+//# sourceMappingURL=usePromise.js.map

package/dist/usePromise.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePromise.js","sourceRoot":"","sources":["../src/usePromise.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,OAAO,CAAA;AAC9B,OAAO,EAAE,UAAU,EAAe,MAAM,iBAAiB,CAAA;AASzD;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAU,OAA8B,EAAE,EAAE;IACpE,MAAM,SAAS,GAAG,MAAM,CAAc,IAAI,CAAC,CAAA;IAC3C,MAAM,UAAU,GAAG,MAAM,CAAe,IAAI,CAAC,CAAA;IAC7C,MAAM,UAAU,GAAG,MAAM,CAAuC,IAAI,CAAC,CAAA;IAErE,MAAM,MAAM,GAAG,CAAO,GAAQ,EAAE,EAAE;;QAChC,MAAM,CAAA,MAAA,SAAS,CAAC,OAAO,0DAAG,GAAG,CAAC,CAAA,CAAA;QAC9B,MAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,QAAQ,wDAAG,GAAG,CAAC,CAAA;QACxB,IAAI,UAAU,CAAC,OAAO;YAAE,YAAY,CAAC,UAAU,CAAC,OAAO,CAAC,CAAA;QACxD,SAAS,CAAC,OAAO,GAAG,IAAI,CAAA;IAC1B,CAAC,CAAA,CAAA;IAED,MAAM,OAAO,GAAG,CAAO,KAAQ,EAAE,EAAE;;QACjC,MAAM,CAAA,MAAA,UAAU,CAAC,OAAO,2DAAG,KAAK,CAAC,CAAA,CAAA;QACjC,MAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,SAAS,wDAAG,KAAK,CAAC,CAAA;QAC3B,IAAI,UAAU,CAAC,OAAO;YAAE,YAAY,CAAC,UAAU,CAAC,OAAO,CAAC,CAAA;QACxD,UAAU,CAAC,OAAO,GAAG,IAAI,CAAA;IAC3B,CAAC,CAAA,CAAA;IAED,MAAM,MAAM,GAAG,GAAG,EAAE;QAClB,OAAO,IAAI,OAAO,CAAI,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACxC,SAAS,CAAC,OAAO,GAAG,MAAM,CAAA;YAC1B,UAAU,CAAC,OAAO,GAAG,OAAO,CAAA;YAC5B,IAAI,UAAU,CAAC,QAAQ,CAAC,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,OAAO,CAAC,IAAI,CAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,OAAO,IAAG,CAAC,EAAE,CAAC;gBAClE,UAAU,CAAC,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE;oBACnC,MAAM,CAAC,IAAI,KAAK,CAAC,eAAe,CAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,SAAS,KAAI,EAAE,oBAAoB,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,OAAO,IAAI,CAAC,CAAC,CAAA;gBACpG,CAAC,EAAE,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,OAAO,CAAC,CAAA;YACtB,CAAC;QACH,CAAC,CAAC,CAAA;IACJ,CAAC,CAAA;IAED,OAAO;QACL,MAAM;QACN,OAAO;QACP,MAAM;KACP,CAAA;AACH,CAAC,CAAA"}

package/dist/useRenderCall.js

@@ -0,0 +1,10 @@
+import { useRef } from 'react';
+/** Calls `fn` synchronously during render, capped at `maxRunCount` renders (default 1). Does not use effects — execution happens inline during the render phase. */
+export function useRenderCall(fn, maxRunCount = 1) {
+    const callCount = useRef(0);
+    if (callCount.current < maxRunCount) {
+        callCount.current++;
+        fn();
+    }
+}
+//# sourceMappingURL=useRenderCall.js.map

package/dist/useRenderCall.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useRenderCall.js","sourceRoot":"","sources":["../src/useRenderCall.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,OAAO,CAAA;AAE9B,oKAAoK;AACpK,MAAM,UAAU,aAAa,CAAC,EAAc,EAAE,WAAW,GAAG,CAAC;IAC3D,MAAM,SAAS,GAAG,MAAM,CAAC,CAAC,CAAC,CAAA;IAC3B,IAAI,SAAS,CAAC,OAAO,GAAG,WAAW,EAAE,CAAC;QACpC,SAAS,CAAC,OAAO,EAAE,CAAA;QACnB,EAAE,EAAE,CAAA;IACN,CAAC;AACH,CAAC"}

package/dist/useSearch/index.js

@@ -0,0 +1,80 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import { useState } from 'react';
+import { useBooleanToggle } from '../useBooleanToggle';
+import { TypeGuards } from '@codeleap/types';
+/**
+ * Hook that manages searchable select/autocomplete state with async loading support.
+ * Handles both local filtering and remote data fetching.
+ *
+ * @example
+ * const search = useSearch({
+ *   value: 'selected-value',
+ *   multiple: false,
+ *   defaultOptions: [...],
+ *   loadOptions: async (query) => fetchOptions(query),
+ *   filterItems: (query, opts) => opts.filter(o => o.label.includes(query))
+ * })
+ *
+ * search.onChangeSearch('query')
+ * search.load()
+ */
+export function useSearch(props) {
+    const { value, multiple, options, filterItems, debugName, defaultOptions, loadOptions, onLoadOptionsError, } = Object.assign({}, props);
+    const [loading, setLoading] = useBooleanToggle(false);
+    const isValueArray = TypeGuards.isArray(value) && multiple;
+    const [labelOptions, setLabelOptions] = useState(() => {
+        if (isValueArray) {
+            return defaultOptions.filter(o => value.includes(o.value));
+        }
+        const _option = defaultOptions.find(o => o.value === value);
+        if (!_option) {
+            return [];
+        }
+        return [_option];
+    });
+    const [filteredOptions, setFilteredOptions] = useState(defaultOptions);
+    const [, setSearchInput] = useState('');
+    function load() {
+        return __awaiter(this, void 0, void 0, function* () {
+            setLoading(true);
+            try {
+                const options = yield loadOptions('');
+                setFilteredOptions(options);
+            }
+            catch (e) {
+                onLoadOptionsError(e);
+            }
+            setLoading(false);
+        });
+    }
+    const onChangeSearch = (searchValue) => __awaiter(this, void 0, void 0, function* () {
+        setSearchInput(searchValue);
+        if (!!loadOptions) {
+            setLoading(true);
+            try {
+                const _opts = yield loadOptions(searchValue);
+                setFilteredOptions(_opts);
+            }
+            catch (e) {
+                console.error(`Error loading select options [${debugName}], e`);
+                onLoadOptionsError === null || onLoadOptionsError === void 0 ? void 0 : onLoadOptionsError(e);
+            }
+            setTimeout(() => {
+                setLoading(false);
+            }, 0);
+            return;
+        }
+        const _opts = filterItems(searchValue, options);
+        setFilteredOptions(_opts);
+    });
+    return { loading, setLoading, labelOptions, setLabelOptions, filteredOptions, load, onChangeSearch };
+}
+//# sourceMappingURL=index.js.map

package/dist/useSearch/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/useSearch/index.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AAChC,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AAEtD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAE5C;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,SAAS,CAAkE,KAAgC;IACzH,MAAM,EACJ,KAAK,EACL,QAAQ,EACR,OAAO,EACP,WAAW,EACX,SAAS,EACT,cAAc,EAEd,WAAW,EACX,kBAAkB,GACnB,qBAAQ,KAAK,CAAE,CAAA;IAEhB,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAA;IACrD,MAAM,YAAY,GAAG,UAAU,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,QAAQ,CAAA;IAC1D,MAAM,CAAC,YAAY,EAAE,eAAe,CAAC,GAAG,QAAQ,CAAC,GAAG,EAAE;QACpD,IAAI,YAAY,EAAE,CAAC;YACjB,OAAO,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAA;QAC5D,CAAC;QAED,MAAM,OAAO,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,KAAK,CAAC,CAAA;QAE3D,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,EAAE,CAAA;QACX,CAAC;QAED,OAAO,CAAC,OAAO,CAAC,CAAA;IAClB,CAAC,CAAC,CAAA;IAEF,MAAM,CAAC,eAAe,EAAE,kBAAkB,CAAC,GAAG,QAAQ,CAAC,cAAc,CAAC,CAAA;IACtE,MAAM,CAAC,EAAE,cAAc,CAAC,GAAG,QAAQ,CAAC,EAAE,CAAC,CAAA;IAEvC,SAAe,IAAI;;YACjB,UAAU,CAAC,IAAI,CAAC,CAAA;YAChB,IAAI,CAAC;gBACH,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,EAAE,CAAC,CAAA;gBACrC,kBAAkB,CAAC,OAAO,CAAC,CAAA;YAC7B,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,kBAAkB,CAAC,CAAC,CAAC,CAAA;YACvB,CAAC;YACD,UAAU,CAAC,KAAK,CAAC,CAAA;QACnB,CAAC;KAAA;IAED,MAAM,cAAc,GAAG,CAAO,WAAkB,EAAE,EAAE;QAClD,cAAc,CAAC,WAAW,CAAC,CAAA;QAE3B,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;YAClB,UAAU,CAAC,IAAI,CAAC,CAAA;YAChB,IAAI,CAAC;gBACH,MAAM,KAAK,GAAG,MAAM,WAAW,CAAC,WAAW,CAAC,CAAA;gBAC5C,kBAAkB,CAAC,KAAK,CAAC,CAAA;YAC3B,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,OAAO,CAAC,KAAK,CAAC,iCAAiC,SAAS,MAAM,CAAC,CAAA;gBAC/D,kBAAkB,aAAlB,kBAAkB,uBAAlB,kBAAkB,CAAG,CAAC,CAAC,CAAA;YACzB,CAAC;YACD,UAAU,CAAC,GAAG,EAAE;gBACd,UAAU,CAAC,KAAK,CAAC,CAAA;YACnB,CAAC,EAAE,CAAC,CAAC,CAAA;YACL,OAAM;QACR,CAAC;QACD,MAAM,KAAK,GAAG,WAAW,CAAC,WAAW,EAAE,OAAO,CAAC,CAAA;QAC/C,kBAAkB,CAAC,KAAK,CAAC,CAAA;IAC3B,CAAC,CAAA,CAAA;IAED,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,IAAI,EAAE,cAAc,EAAE,CAAA;AACtG,CAAC"}

package/dist/useSearch/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/useSearch/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/useSearch/types.ts"],"names":[],"mappings":""}

package/dist/useStableReference.js

@@ -0,0 +1,12 @@
+import { deepEqual } from '@codeleap/utils';
+import { useRef } from 'react';
+/** Returns the previous ref value when the object is deeply equal to the last render, preventing unnecessary re-renders caused by referential inequality. */
+export function useStableReference(value) {
+    const ref = useRef(value);
+    const hasChanged = !deepEqual(ref.current, value);
+    if (hasChanged) {
+        ref.current = value;
+    }
+    return ref.current;
+}
+//# sourceMappingURL=useStableReference.js.map

package/dist/useStableReference.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useStableReference.js","sourceRoot":"","sources":["../src/useStableReference.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAC3C,OAAO,EAAE,MAAM,EAAE,MAAM,OAAO,CAAA;AAE9B,6JAA6J;AAC7J,MAAM,UAAU,kBAAkB,CAAgC,KAAQ;IACxE,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,CAAA;IAEzB,MAAM,UAAU,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,CAAC,CAAA;IAEjD,IAAI,UAAU,EAAE,CAAC;QACf,GAAG,CAAC,OAAO,GAAG,KAAK,CAAA;IACrB,CAAC;IAED,OAAO,GAAG,CAAC,OAAO,CAAA;AACpB,CAAC"}

package/dist/useToggle.js

@@ -0,0 +1,18 @@
+import { useState } from 'react';
+/**
+ * Hook that toggles between two values.
+ *
+ * @example
+ * const [theme, toggleTheme] = useToggle(['light', 'dark'] as const, 'light')
+ * toggleTheme() // Switches to 'dark'
+ * toggleTheme('light') // Sets to 'light'
+ */
+export function useToggle(options, initial) {
+    const [value, setValue] = useState(initial);
+    function toggleOrSetValue(newValue) {
+        const v = newValue || (value === options[0] ? options[1] : options[0]);
+        setValue(v);
+    }
+    return [value, toggleOrSetValue];
+}
+//# sourceMappingURL=useToggle.js.map

package/dist/useToggle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useToggle.js","sourceRoot":"","sources":["../src/useToggle.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AAEhC;;;;;;;GAOG;AACH,MAAM,UAAU,SAAS,CACvB,OAAU,EACV,OAAU;IAEV,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAA;IAE3C,SAAS,gBAAgB,CAAC,QAAY;QACpC,MAAM,CAAC,GAAM,QAAQ,IAAI,CAAC,KAAK,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAA;QAEzE,QAAQ,CAAC,CAAC,CAAC,CAAA;IACb,CAAC;IAED,OAAO,CAAC,KAAK,EAAE,gBAAgB,CAAU,CAAA;AAC3C,CAAC"}

package/dist/useUncontrolled.js

@@ -0,0 +1,55 @@
+import { useEffect, useRef, useState } from 'react';
+/**
+ * Hook that manages controlled/uncontrolled component pattern with smooth transitions.
+ *
+ * @example
+ * const [value, handleChange, mode] = useUncontrolled({
+ *   value: props.value,
+ *   defaultValue: 'default',
+ *   finalValue: '',
+ *   rule: (v) => v !== undefined,
+ *   onChange: (v) => props.onChange?.(v)
+ * })
+ */
+export function useUncontrolled({ value, defaultValue, finalValue, rule, onChange, onValueUpdate, }) {
+    var _a;
+    // determine, whether new props indicate controlled state
+    const shouldBeControlled = rule(value);
+    // initialize state
+    const modeRef = useRef('initial');
+    const initialValue = rule(defaultValue) ? defaultValue : finalValue;
+    const [uncontrolledValue, setUncontrolledValue] = useState(initialValue);
+    // compute effective value
+    let effectiveValue = (_a = (shouldBeControlled ? value : uncontrolledValue)) !== null && _a !== void 0 ? _a : null;
+    if (!shouldBeControlled && modeRef.current === 'controlled') {
+        // We are transitioning from controlled to uncontrolled
+        // this transition is special as it happens when clearing out
+        // the input using "invalid" value (typically null or undefined).
+        //
+        // Since the value is invalid, doing nothing would mean just
+        // transitioning to uncontrolled state and using whatever value
+        // it currently holds which is likely not the behavior
+        // user expects, so lets change the state to finalValue.
+        //
+        // The value will be propagated to internal state by useEffect below.
+        effectiveValue = finalValue;
+    }
+    modeRef.current = shouldBeControlled ? 'controlled' : 'uncontrolled';
+    const mode = modeRef.current;
+    const handleChange = (nextValue) => {
+        typeof onChange === 'function' && onChange(nextValue);
+        // Controlled input only triggers onChange event and expects
+        // the controller to propagate new value back.
+        if (mode === 'uncontrolled') {
+            setUncontrolledValue(nextValue);
+        }
+    };
+    useEffect(() => {
+        if (mode === 'uncontrolled') {
+            setUncontrolledValue(effectiveValue);
+        }
+        typeof onValueUpdate === 'function' && onValueUpdate(effectiveValue);
+    }, [mode, effectiveValue]);
+    return [effectiveValue, handleChange, modeRef.current];
+}
+//# sourceMappingURL=useUncontrolled.js.map

package/dist/useUncontrolled.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useUncontrolled.js","sourceRoot":"","sources":["../src/useUncontrolled.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AAanD;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,eAAe,CAAI,EACjC,KAAK,EACL,YAAY,EACZ,UAAU,EACV,IAAI,EACJ,QAAQ,EACR,aAAa,GACU;;IACvB,yDAAyD;IACzD,MAAM,kBAAkB,GAAG,IAAI,CAAC,KAAK,CAAC,CAAA;IAEtC,mBAAmB;IACnB,MAAM,OAAO,GAAG,MAAM,CAAmB,SAAS,CAAC,CAAA;IACnD,MAAM,YAAY,GAAG,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,UAAU,CAAA;IACnE,MAAM,CAAC,iBAAiB,EAAE,oBAAoB,CAAC,GAAG,QAAQ,CAAC,YAAY,CAAC,CAAA;IAExE,0BAA0B;IAC1B,IAAI,cAAc,GAAa,MAAA,CAAC,kBAAkB,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,iBAAiB,CAAC,mCAAI,IAAI,CAAA;IAEvF,IAAI,CAAC,kBAAkB,IAAI,OAAO,CAAC,OAAO,KAAK,YAAY,EAAE,CAAC;QAC5D,uDAAuD;QACvD,6DAA6D;QAC7D,iEAAiE;QACjE,EAAE;QACF,4DAA4D;QAC5D,+DAA+D;QAC/D,sDAAsD;QACtD,wDAAwD;QACxD,EAAE;QACF,qEAAqE;QAErE,cAAc,GAAG,UAAU,CAAA;IAC7B,CAAC;IAED,OAAO,CAAC,OAAO,GAAG,kBAAkB,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,cAAc,CAAA;IACpE,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAA;IAE5B,MAAM,YAAY,GAAG,CAAC,SAAmB,EAAE,EAAE;QAC3C,OAAO,QAAQ,KAAK,UAAU,IAAI,QAAQ,CAAC,SAAS,CAAC,CAAA;QAErD,4DAA4D;QAC5D,8CAA8C;QAC9C,IAAI,IAAI,KAAK,cAAc,EAAE,CAAC;YAC5B,oBAAoB,CAAC,SAAS,CAAC,CAAA;QACjC,CAAC;IACH,CAAC,CAAA;IAED,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,IAAI,KAAK,cAAc,EAAE,CAAC;YAC5B,oBAAoB,CAAC,cAAc,CAAC,CAAA;QACtC,CAAC;QACD,OAAO,aAAa,KAAK,UAAU,IAAI,aAAa,CAAC,cAAc,CAAC,CAAA;IACtE,CAAC,EAAE,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC,CAAA;IAE1B,OAAO,CAAC,cAAc,EAAE,YAAY,EAAE,OAAO,CAAC,OAAO,CAAU,CAAA;AACjE,CAAC"}

package/dist/useUnmount.js

@@ -0,0 +1,19 @@
+import { useRef } from 'react';
+import { useEffectOnce } from './useEffectOnce';
+/**
+ * Hook that runs a cleanup function when the component unmounts.
+ * The function reference is updated on each render to always use the latest version.
+ *
+ * @example
+ * useUnmount(() => {
+ *   console.log('Component unmounting')
+ *   // Cleanup logic here
+ * })
+ */
+export const useUnmount = (fn) => {
+    const fnRef = useRef(fn);
+    // update the ref each render so if it change the newest callback will be invoked
+    fnRef.current = fn;
+    useEffectOnce(() => () => fnRef.current());
+};
+//# sourceMappingURL=useUnmount.js.map

package/dist/useUnmount.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useUnmount.js","sourceRoot":"","sources":["../src/useUnmount.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,OAAO,CAAA;AAC9B,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAE/C;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,EAAa,EAAQ,EAAE;IAChD,MAAM,KAAK,GAAG,MAAM,CAAC,EAAE,CAAC,CAAA;IAExB,iFAAiF;IACjF,KAAK,CAAC,OAAO,GAAG,EAAE,CAAA;IAElB,aAAa,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAA;AAC5C,CAAC,CAAA"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@codeleap/hooks",
-  "version": "7.0.0",
-  "main": "src/index.ts",
+  "version": "7.0.1",
+  "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "exports": {
     ".": {
@@ -22,10 +22,10 @@
     "directory": "packages/hooks"
   },
   "devDependencies": {
-    "@codeleap/config": "7.0.0",
-    "@codeleap/types": "7.0.0",
-    "@codeleap/utils": "7.0.0",
-    "@codeleap/logger": "7.0.0",
+    "@codeleap/config": "7.0.1",
+    "@codeleap/types": "7.0.1",
+    "@codeleap/utils": "7.0.1",
+    "@codeleap/logger": "7.0.1",
     "ts-node-dev": "1.1.8"
   },
   "scripts": {
@@ -33,9 +33,9 @@
     "typecheck": "bun tsc --noEmit -p ./tsconfig.json"
   },
   "peerDependencies": {
-    "@codeleap/types": "7.0.0",
-    "@codeleap/utils": "7.0.0",
-    "@codeleap/logger": "7.0.0",
+    "@codeleap/types": "7.0.1",
+    "@codeleap/utils": "7.0.1",
+    "@codeleap/logger": "7.0.1",
     "axios": "^1.7.9",
     "typescript": "6.0.3",
     "react": "19.1.0",