@raystack/apsara 0.53.1 → 0.53.2

package/dist/hooks/index.cjs

@@ -3,10 +3,12 @@
 var useCopyToClipboard = require('./useCopyToClipboard.cjs');
 var useMouse = require('./useMouse.cjs');
 var useIsomorphicLayoutEffect = require('./useIsomorphicLayoutEffect.cjs');
+var useDebouncedState = require('./useDebouncedState.cjs');
 
 
 
 exports.useCopyToClipboard = useCopyToClipboard.useCopyToClipboard;
 exports.useMouse = useMouse.useMouse;
 exports.useIsomorphicLayoutEffect = useIsomorphicLayoutEffect.useIsomorphicLayoutEffect;
+exports.useDebouncedState = useDebouncedState.useDebouncedState;
 //# sourceMappingURL=index.cjs.map

package/dist/hooks/index.cjs.map

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

package/dist/hooks/index.d.ts

@@ -1,4 +1,5 @@
 export { useCopyToClipboard } from './useCopyToClipboard';
 export { useMouse } from './useMouse';
 export { useIsomorphicLayoutEffect } from './useIsomorphicLayoutEffect';
+export { useDebouncedState } from './useDebouncedState';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../hooks/index.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../hooks/index.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AACxE,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/hooks/index.js

@@ -1,4 +1,5 @@
 export { useCopyToClipboard } from './useCopyToClipboard.js';
 export { useMouse } from './useMouse.js';
 export { useIsomorphicLayoutEffect } from './useIsomorphicLayoutEffect.js';
+export { useDebouncedState } from './useDebouncedState.js';
 //# sourceMappingURL=index.js.map

package/dist/hooks/index.js.map

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

package/dist/hooks/useDebouncedState.cjs

@@ -0,0 +1,41 @@
+'use strict';
+
+var react = require('react');
+
+/**
+ * A hook that debounces the state update.
+ * @param defaultValue - The default value of the state.
+ * @param delay - The delay time in milliseconds.
+ * @param options - The options for the hook.
+ * @returns A tuple containing the current value and the debounced set value function.
+ *
+ * @example
+ * const [value, setValue] = useDebouncedState('Hello', 1000);
+
+ * @example
+ * const [value, setValue] = useDebouncedState('Hello', 1000, { leading: true });
+ */
+function useDebouncedState(defaultValue, delay, options = { leading: false }) {
+    const [value, setValue] = react.useState(defaultValue);
+    const timeoutRef = react.useRef(null);
+    const leadingRef = react.useRef(true);
+    const clearTimeout = react.useCallback(() => window.clearTimeout(timeoutRef.current), []);
+    react.useEffect(() => clearTimeout, [clearTimeout]);
+    const debouncedSetValue = react.useCallback((newValue) => {
+        clearTimeout();
+        if (leadingRef.current && options.leading) {
+            setValue(newValue);
+        }
+        else {
+            timeoutRef.current = window.setTimeout(() => {
+                leadingRef.current = true;
+                setValue(newValue);
+            }, delay);
+        }
+        leadingRef.current = false;
+    }, [options.leading, clearTimeout, delay]);
+    return [value, debouncedSetValue];
+}
+
+exports.useDebouncedState = useDebouncedState;
+//# sourceMappingURL=useDebouncedState.cjs.map

package/dist/hooks/useDebouncedState.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDebouncedState.cjs","sources":["../../hooks/useDebouncedState.tsx"],"sourcesContent":["import {\n  SetStateAction,\n  useCallback,\n  useEffect,\n  useRef,\n  useState\n} from 'react';\n\nexport interface UseDebouncedStateOptions {\n  /**\n   * If `true`, the state will be updated immediately on the first call (leading edge).\n   * Subsequent calls within the delay period will be debounced.\n   * @default false\n   */\n  leading?: boolean;\n}\n\nexport type UseDebouncedStateReturnValue<T> = [\n  T,\n  (newValue: SetStateAction<T>) => void\n];\n\n/**\n * A hook that debounces the state update.\n * @param defaultValue - The default value of the state.\n * @param delay - The delay time in milliseconds.\n * @param options - The options for the hook.\n * @returns A tuple containing the current value and the debounced set value function.\n *\n * @example\n * const [value, setValue] = useDebouncedState('Hello', 1000);\n\n * @example\n * const [value, setValue] = useDebouncedState('Hello', 1000, { leading: true });\n */\nexport function useDebouncedState<T = any>(\n  defaultValue: T,\n  delay: number,\n  options: UseDebouncedStateOptions = { leading: false }\n): UseDebouncedStateReturnValue<T> {\n  const [value, setValue] = useState(defaultValue);\n  const timeoutRef = useRef<number | null>(null);\n  const leadingRef = useRef(true);\n\n  const clearTimeout = useCallback(\n    () => window.clearTimeout(timeoutRef.current!),\n    []\n  );\n  useEffect(() => clearTimeout, [clearTimeout]);\n\n  const debouncedSetValue = useCallback(\n    (newValue: SetStateAction<T>) => {\n      clearTimeout();\n      if (leadingRef.current && options.leading) {\n        setValue(newValue);\n      } else {\n        timeoutRef.current = window.setTimeout(() => {\n          leadingRef.current = true;\n          setValue(newValue);\n        }, delay);\n      }\n      leadingRef.current = false;\n    },\n    [options.leading, clearTimeout, delay]\n  );\n\n  return [value, debouncedSetValue] as const;\n}\n"],"names":["useState","useRef","useCallback","useEffect"],"mappings":";;;;AAsBA;;;;;;;;;;;;AAYG;AACa,SAAA,iBAAiB,CAC/B,YAAe,EACf,KAAa,EACb,OAAA,GAAoC,EAAE,OAAO,EAAE,KAAK,EAAE,EAAA;IAEtD,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAGA,cAAQ,CAAC,YAAY,CAAC,CAAC;AACjD,IAAA,MAAM,UAAU,GAAGC,YAAM,CAAgB,IAAI,CAAC,CAAC;AAC/C,IAAA,MAAM,UAAU,GAAGA,YAAM,CAAC,IAAI,CAAC,CAAC;AAEhC,IAAA,MAAM,YAAY,GAAGC,iBAAW,CAC9B,MAAM,MAAM,CAAC,YAAY,CAAC,UAAU,CAAC,OAAQ,CAAC,EAC9C,EAAE,CACH,CAAC;IACFC,eAAS,CAAC,MAAM,YAAY,EAAE,CAAC,YAAY,CAAC,CAAC,CAAC;AAE9C,IAAA,MAAM,iBAAiB,GAAGD,iBAAW,CACnC,CAAC,QAA2B,KAAI;AAC9B,QAAA,YAAY,EAAE,CAAC;QACf,IAAI,UAAU,CAAC,OAAO,IAAI,OAAO,CAAC,OAAO,EAAE;YACzC,QAAQ,CAAC,QAAQ,CAAC,CAAC;SACpB;aAAM;YACL,UAAU,CAAC,OAAO,GAAG,MAAM,CAAC,UAAU,CAAC,MAAK;AAC1C,gBAAA,UAAU,CAAC,OAAO,GAAG,IAAI,CAAC;gBAC1B,QAAQ,CAAC,QAAQ,CAAC,CAAC;aACpB,EAAE,KAAK,CAAC,CAAC;SACX;AACD,QAAA,UAAU,CAAC,OAAO,GAAG,KAAK,CAAC;KAC5B,EACD,CAAC,OAAO,CAAC,OAAO,EAAE,YAAY,EAAE,KAAK,CAAC,CACvC,CAAC;AAEF,IAAA,OAAO,CAAC,KAAK,EAAE,iBAAiB,CAAU,CAAC;AAC7C;;;;"}

package/dist/hooks/useDebouncedState.d.ts

@@ -0,0 +1,28 @@
+import { SetStateAction } from 'react';
+export interface UseDebouncedStateOptions {
+    /**
+     * If `true`, the state will be updated immediately on the first call (leading edge).
+     * Subsequent calls within the delay period will be debounced.
+     * @default false
+     */
+    leading?: boolean;
+}
+export type UseDebouncedStateReturnValue<T> = [
+    T,
+    (newValue: SetStateAction<T>) => void
+];
+/**
+ * A hook that debounces the state update.
+ * @param defaultValue - The default value of the state.
+ * @param delay - The delay time in milliseconds.
+ * @param options - The options for the hook.
+ * @returns A tuple containing the current value and the debounced set value function.
+ *
+ * @example
+ * const [value, setValue] = useDebouncedState('Hello', 1000);
+
+ * @example
+ * const [value, setValue] = useDebouncedState('Hello', 1000, { leading: true });
+ */
+export declare function useDebouncedState<T = any>(defaultValue: T, delay: number, options?: UseDebouncedStateOptions): UseDebouncedStateReturnValue<T>;
+//# sourceMappingURL=useDebouncedState.d.ts.map

package/dist/hooks/useDebouncedState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDebouncedState.d.ts","sourceRoot":"","sources":["../../hooks/useDebouncedState.tsx"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EAKf,MAAM,OAAO,CAAC;AAEf,MAAM,WAAW,wBAAwB;IACvC;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,MAAM,4BAA4B,CAAC,CAAC,IAAI;IAC5C,CAAC;IACD,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC,CAAC,KAAK,IAAI;CACtC,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,GAAG,GAAG,EACvC,YAAY,EAAE,CAAC,EACf,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,wBAA6C,GACrD,4BAA4B,CAAC,CAAC,CAAC,CA4BjC"}

package/dist/hooks/useDebouncedState.js

@@ -0,0 +1,39 @@
+import { useState, useRef, useCallback, useEffect } from 'react';
+
+/**
+ * A hook that debounces the state update.
+ * @param defaultValue - The default value of the state.
+ * @param delay - The delay time in milliseconds.
+ * @param options - The options for the hook.
+ * @returns A tuple containing the current value and the debounced set value function.
+ *
+ * @example
+ * const [value, setValue] = useDebouncedState('Hello', 1000);
+
+ * @example
+ * const [value, setValue] = useDebouncedState('Hello', 1000, { leading: true });
+ */
+function useDebouncedState(defaultValue, delay, options = { leading: false }) {
+    const [value, setValue] = useState(defaultValue);
+    const timeoutRef = useRef(null);
+    const leadingRef = useRef(true);
+    const clearTimeout = useCallback(() => window.clearTimeout(timeoutRef.current), []);
+    useEffect(() => clearTimeout, [clearTimeout]);
+    const debouncedSetValue = useCallback((newValue) => {
+        clearTimeout();
+        if (leadingRef.current && options.leading) {
+            setValue(newValue);
+        }
+        else {
+            timeoutRef.current = window.setTimeout(() => {
+                leadingRef.current = true;
+                setValue(newValue);
+            }, delay);
+        }
+        leadingRef.current = false;
+    }, [options.leading, clearTimeout, delay]);
+    return [value, debouncedSetValue];
+}
+
+export { useDebouncedState };
+//# sourceMappingURL=useDebouncedState.js.map

package/dist/hooks/useDebouncedState.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDebouncedState.js","sources":["../../hooks/useDebouncedState.tsx"],"sourcesContent":["import {\n  SetStateAction,\n  useCallback,\n  useEffect,\n  useRef,\n  useState\n} from 'react';\n\nexport interface UseDebouncedStateOptions {\n  /**\n   * If `true`, the state will be updated immediately on the first call (leading edge).\n   * Subsequent calls within the delay period will be debounced.\n   * @default false\n   */\n  leading?: boolean;\n}\n\nexport type UseDebouncedStateReturnValue<T> = [\n  T,\n  (newValue: SetStateAction<T>) => void\n];\n\n/**\n * A hook that debounces the state update.\n * @param defaultValue - The default value of the state.\n * @param delay - The delay time in milliseconds.\n * @param options - The options for the hook.\n * @returns A tuple containing the current value and the debounced set value function.\n *\n * @example\n * const [value, setValue] = useDebouncedState('Hello', 1000);\n\n * @example\n * const [value, setValue] = useDebouncedState('Hello', 1000, { leading: true });\n */\nexport function useDebouncedState<T = any>(\n  defaultValue: T,\n  delay: number,\n  options: UseDebouncedStateOptions = { leading: false }\n): UseDebouncedStateReturnValue<T> {\n  const [value, setValue] = useState(defaultValue);\n  const timeoutRef = useRef<number | null>(null);\n  const leadingRef = useRef(true);\n\n  const clearTimeout = useCallback(\n    () => window.clearTimeout(timeoutRef.current!),\n    []\n  );\n  useEffect(() => clearTimeout, [clearTimeout]);\n\n  const debouncedSetValue = useCallback(\n    (newValue: SetStateAction<T>) => {\n      clearTimeout();\n      if (leadingRef.current && options.leading) {\n        setValue(newValue);\n      } else {\n        timeoutRef.current = window.setTimeout(() => {\n          leadingRef.current = true;\n          setValue(newValue);\n        }, delay);\n      }\n      leadingRef.current = false;\n    },\n    [options.leading, clearTimeout, delay]\n  );\n\n  return [value, debouncedSetValue] as const;\n}\n"],"names":[],"mappings":";;AAsBA;;;;;;;;;;;;AAYG;AACa,SAAA,iBAAiB,CAC/B,YAAe,EACf,KAAa,EACb,OAAA,GAAoC,EAAE,OAAO,EAAE,KAAK,EAAE,EAAA;IAEtD,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAC,YAAY,CAAC,CAAC;AACjD,IAAA,MAAM,UAAU,GAAG,MAAM,CAAgB,IAAI,CAAC,CAAC;AAC/C,IAAA,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;AAEhC,IAAA,MAAM,YAAY,GAAG,WAAW,CAC9B,MAAM,MAAM,CAAC,YAAY,CAAC,UAAU,CAAC,OAAQ,CAAC,EAC9C,EAAE,CACH,CAAC;IACF,SAAS,CAAC,MAAM,YAAY,EAAE,CAAC,YAAY,CAAC,CAAC,CAAC;AAE9C,IAAA,MAAM,iBAAiB,GAAG,WAAW,CACnC,CAAC,QAA2B,KAAI;AAC9B,QAAA,YAAY,EAAE,CAAC;QACf,IAAI,UAAU,CAAC,OAAO,IAAI,OAAO,CAAC,OAAO,EAAE;YACzC,QAAQ,CAAC,QAAQ,CAAC,CAAC;SACpB;aAAM;YACL,UAAU,CAAC,OAAO,GAAG,MAAM,CAAC,UAAU,CAAC,MAAK;AAC1C,gBAAA,UAAU,CAAC,OAAO,GAAG,IAAI,CAAC;gBAC1B,QAAQ,CAAC,QAAQ,CAAC,CAAC;aACpB,EAAE,KAAK,CAAC,CAAC;SACX;AACD,QAAA,UAAU,CAAC,OAAO,GAAG,KAAK,CAAC;KAC5B,EACD,CAAC,OAAO,CAAC,OAAO,EAAE,YAAY,EAAE,KAAK,CAAC,CACvC,CAAC;AAEF,IAAA,OAAO,CAAC,KAAK,EAAE,iBAAiB,CAAU,CAAC;AAC7C;;;;"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@raystack/apsara",
-  "version": "0.53.1",
+  "version": "0.53.2",
   "types": "dist/index.d.ts",
   "sideEffects": false,
   "engines": {