![\"usefy](\"https://raw.githubusercontent.com/mirunamu00/usefy/master/assets/logo.png\"){kind=logo}
\n\n \n
\n A powerful React hook for debounced callbacks with cancel, flush, and pending methods\n
\n\n\n \n ![\"npm](\"https://img.shields.io/npm/v/@usefy/use-debounce-callback.svg?style=flat-square&color=007acc\")
\n \n \n ![\"npm](\"https://img.shields.io/npm/dm/@usefy/use-debounce-callback.svg?style=flat-square&color=007acc\")
\n \n \n ![\"bundle](\"https://img.shields.io/bundlephobia/minzip/@usefy/use-debounce-callback?style=flat-square&color=007acc\")
![\"license\"](\"https://img.shields.io/npm/l/@usefy/use-debounce-callback.svg?style=flat-square&color=007acc\")
\n \n
\n Installation β’\n Quick Start β’\n API Reference β’\n Examples β’\n License\n
\n\n\n \n π View Storybook Demo\n \n
\n\n---\n\n## Overview\n\n`@usefy/use-debounce-callback` provides a debounced version of your callback function with full control methods: `cancel()`, `flush()`, and `pending()`. Perfect for API calls, form submissions, event handlers, and any scenario requiring debounced function execution with fine-grained control.\n\n**Part of the [@usefy](https://www.npmjs.com/org/usefy) ecosystem** β a collection of production-ready React hooks designed for modern applications.\n\n### Why use-debounce-callback?\n\n- **Zero Dependencies** β Pure React implementation with no external dependencies\n- **TypeScript First** β Full type safety with generics and exported interfaces\n- **Full Control** β `cancel()`, `flush()`, and `pending()` methods\n- **Flexible Options** β Leading edge, trailing edge, and maxWait support\n- **SSR Compatible** β Works seamlessly with Next.js, Remix, and other SSR frameworks\n- **Lightweight** β Minimal bundle footprint (~500B minified + gzipped)\n- **Well Tested** β Comprehensive test coverage with Vitest\n\n---\n\n## Installation\n\n```bash\n# npm\nnpm install @usefy/use-debounce-callback\n\n# yarn\nyarn add @usefy/use-debounce-callback\n\n# pnpm\npnpm add @usefy/use-debounce-callback\n```\n\n### Peer Dependencies\n\nThis package requires React 18 or 19:\n\n```json\n{\n \"peerDependencies\": {\n \"react\": \"^18.0.0 || ^19.0.0\"\n }\n}\n```\n\n---\n\n## Quick Start\n\n```tsx\nimport { useDebounceCallback } from \"@usefy/use-debounce-callback\";\n\nfunction SearchInput() {\n const [query, setQuery] = useState(\"\");\n\n const debouncedSearch = useDebounceCallback((searchTerm: string) => {\n fetchSearchResults(searchTerm);\n }, 300);\n\n const handleChange = (e: React.ChangeEvent\n Built with care by the usefy team\n
\n","readmeFilename":"README.md"}