use-debounce-hook-web 1.0.0

package/babel.config.json

@@ -0,0 +1,3 @@
+{
+  "presets": ["@babel/preset-env", "@babel/preset-react"]
+}

package/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "use-debounce-hook-web",
+  "version": "1.0.0",
+  "description": "A simple and reusable debounce hook for React",
+  "main": "src/index.js",
+  "keywords": [
+    "react",
+    "debounce",
+    "hook",
+    "react-hooks",
+    "useDebounce"
+  ],
+  "author": "Yogesh Negi",
+  "license": "MIT",
+  "peerDependencies": {
+    "react": ">=16.8.0"
+  },
+  "scripts": {
+    "test": "echo \"No tests yet\""
+  },
+  "devDependencies": {
+    "@babel/core": "^7.28.5",
+    "@babel/preset-env": "^7.28.5",
+    "@babel/preset-react": "^7.28.5"
+  }
+}

package/src/index.js

@@ -0,0 +1 @@
+export { default as useDebounce } from "./useDebounce";

package/src/useDebounce.js

@@ -0,0 +1,47 @@
+import { useEffect, useRef, useState } from "react";
+
+const useDebounce = (
+  value,
+  delay = 500,
+  options = { immediate: false, maxWait: null }
+) => {
+  const [debouncedValue, setDebouncedValue] = useState(value);
+
+  const timeoutRef = useRef(null);
+  const maxWaitRef = useRef(null);
+  const firstRender = useRef(true);
+
+  useEffect(() => {
+    // Immediate execution (first call)
+    if (options.immediate && firstRender.current) {
+      setDebouncedValue(value);
+      firstRender.current = false;
+      return;
+    }
+
+    // Clear previous timers
+    if (timeoutRef.current) clearTimeout(timeoutRef.current);
+    if (maxWaitRef.current) clearTimeout(maxWaitRef.current);
+
+    // Main debounce timer
+    timeoutRef.current = setTimeout(() => {
+      setDebouncedValue(value);
+    }, delay);
+
+    // Max wait support
+    if (options.maxWait) {
+      maxWaitRef.current = setTimeout(() => {
+        setDebouncedValue(value);
+      }, options.maxWait);
+    }
+
+    return () => {
+      clearTimeout(timeoutRef.current);
+      clearTimeout(maxWaitRef.current);
+    };
+  }, [value, delay, options.immediate, options.maxWait]);
+
+  return debouncedValue;
+};
+
+export default useDebounce;