feat: useCallback variants of hooks and turn on react compiler linting

Author: KevinVandy

docs/config.json

@@ -101,6 +101,10 @@
               "label": "useDebouncer",
               "to": "framework/react/reference/functions/usedebouncer"
             },
+            {
+              "label": "useDebouncedCallback",
+              "to": "framework/react/reference/functions/usedebouncedcallback"
+            },
             {
               "label": "useDebouncedState",
               "to": "framework/react/reference/functions/usedebouncedstate"
@@ -136,6 +140,10 @@
               "label": "useDebouncer",
               "to": "framework/react/examples/useDebouncer"
             },
+            {
+              "label": "useDebouncedCallback",
+              "to": "framework/react/examples/useDebouncedCallback"
+            },
             {
               "label": "useDebouncedState",
               "to": "framework/react/examples/useDebouncedState"
@@ -186,6 +194,10 @@
               "label": "useThrottler",
               "to": "framework/react/reference/functions/usethrottler"
             },
+            {
+              "label": "useThrottledCallback",
+              "to": "framework/react/reference/functions/usethrottledcallback"
+            },
             {
               "label": "useThrottledState",
               "to": "framework/react/reference/functions/usethrottledstate"
@@ -221,6 +233,10 @@
               "label": "useThrottler",
               "to": "framework/react/examples/useThrottler"
             },
+            {
+              "label": "useThrottledCallback",
+              "to": "framework/react/examples/useThrottledCallback"
+            },
             {
               "label": "useThrottledState",
               "to": "framework/react/examples/useThrottledState"
@@ -275,6 +291,10 @@
               "label": "useRateLimiter",
               "to": "framework/react/reference/functions/useratelimiter"
             },
+            {
+              "label": "useRateLimitedCallback",
+              "to": "framework/react/reference/functions/useratelimitedcallback"
+            },
             {
               "label": "useRateLimitedState",
               "to": "framework/react/reference/functions/useratelimitedstate"
@@ -310,6 +330,10 @@
               "label": "useRateLimiter",
               "to": "framework/react/examples/useRateLimiter"
             },
+            {
+              "label": "useRateLimitedCallback",
+              "to": "framework/react/examples/useRateLimitedCallback"
+            },
             {
               "label": "useRateLimitedState",
               "to": "framework/react/examples/useRateLimitedState"

docs/framework/react/reference/functions/useasyncdebouncer.md

@@ -8,7 +8,7 @@ title: useAsyncDebouncer
 # Function: useAsyncDebouncer()
 
 ```ts
-function useAsyncDebouncer<TFn, TArgs>(fn, options): AsyncDebouncer<TFn, TArgs>
+function useAsyncDebouncer<TFn, TArgs>(fn, options): object
 ```
 
 Defined in: [react-pacer/src/async-debouncer/useAsyncDebouncer.ts:40](https://github.com/TanStack/pacer/blob/main/packages/react-pacer/src/async-debouncer/useAsyncDebouncer.ts#L40)
@@ -40,7 +40,50 @@ wait for user input to settle before making expensive async calls.
 
 ## Returns
 
-`AsyncDebouncer`\<`TFn`, `TArgs`\>
+`object`
+
+### cancel()
+
+```ts
+readonly cancel: () => void;
+```
+
+Cancels any pending execution
+
+#### Returns
+
+`void`
+
+### getExecutionCount()
+
+```ts
+readonly getExecutionCount: () => number;
+```
+
+Returns the number of times the function has been executed
+
+#### Returns
+
+`number`
+
+### maybeExecute()
+
+```ts
+readonly maybeExecute: (...args) => Promise<void>;
+```
+
+Attempts to execute the debounced function
+If a call is already in progress, it will be queued
+
+#### Parameters
+
+##### args
+
+...`TArgs`
+
+#### Returns
+
+`Promise`\<`void`\>
 
 ## Example
 

docs/framework/react/reference/functions/useasyncqueuer.md

@@ -48,7 +48,7 @@ The hook returns an object containing methods to:
 ### addItem()
 
 ```ts
-addItem: (fn, position?) => Promise<TValue>;
+readonly addItem: (fn, position?) => Promise<TValue>;
 ```
 
 Adds a task to the queuer
@@ -70,7 +70,7 @@ Adds a task to the queuer
 ### clear()
 
 ```ts
-clear: () => void;
+readonly clear: () => void;
 ```
 
 Removes all items from the queuer
@@ -82,7 +82,7 @@ Removes all items from the queuer
 ### getActiveItems()
 
 ```ts
-getActiveItems: () => () => Promise<TValue>[];
+readonly getActiveItems: () => () => Promise<TValue>[];
 ```
 
 Returns the active items
@@ -94,7 +94,7 @@ Returns the active items
 ### getAllItems()
 
 ```ts
-getAllItems: () => () => Promise<TValue>[];
+readonly getAllItems: () => () => Promise<TValue>[];
 ```
 
 Returns a copy of all items in the queuer
@@ -106,7 +106,7 @@ Returns a copy of all items in the queuer
 ### getExecutionCount()
 
 ```ts
-getExecutionCount: () => number;
+readonly getExecutionCount: () => number;
 ```
 
 Returns the number of items that have been removed from the queuer
@@ -118,7 +118,7 @@ Returns the number of items that have been removed from the queuer
 ### getNextItem()
 
 ```ts
-getNextItem: (position?) => undefined | () => Promise<TValue>;
+readonly getNextItem: (position?) => undefined | () => Promise<TValue>;
 ```
 
 Removes and returns an item from the queuer
@@ -136,7 +136,7 @@ Removes and returns an item from the queuer
 ### getPendingItems()
 
 ```ts
-getPendingItems: () => () => Promise<TValue>[];
+readonly getPendingItems: () => () => Promise<TValue>[];
 ```
 
 Returns the pending items
@@ -148,7 +148,7 @@ Returns the pending items
 ### isEmpty()
 
 ```ts
-isEmpty: () => boolean;
+readonly isEmpty: () => boolean;
 ```
 
 Returns true if the queuer is empty
@@ -160,7 +160,7 @@ Returns true if the queuer is empty
 ### isFull()
 
 ```ts
-isFull: () => boolean;
+readonly isFull: () => boolean;
 ```
 
 Returns true if the queuer is full
@@ -172,7 +172,7 @@ Returns true if the queuer is full
 ### isIdle()
 
 ```ts
-isIdle: () => boolean;
+readonly isIdle: () => boolean;
 ```
 
 Returns true if the queuer is running but has no items to process
@@ -184,7 +184,7 @@ Returns true if the queuer is running but has no items to process
 ### isRunning()
 
 ```ts
-isRunning: () => boolean;
+readonly isRunning: () => boolean;
 ```
 
 Returns true if the queuer is running
@@ -196,7 +196,7 @@ Returns true if the queuer is running
 ### onError()
 
 ```ts
-onError: (cb) => () => void;
+readonly onError: (cb) => () => void;
 ```
 
 Adds a callback to be called when a task errors
@@ -218,7 +218,7 @@ Adds a callback to be called when a task errors
 ### onSettled()
 
 ```ts
-onSettled: (cb) => () => void;
+readonly onSettled: (cb) => () => void;
 ```
 
 Adds a callback to be called when a task is settled
@@ -240,7 +240,7 @@ Adds a callback to be called when a task is settled
 ### onSuccess()
 
 ```ts
-onSuccess: (cb) => () => void;
+readonly onSuccess: (cb) => () => void;
 ```
 
 Adds a callback to be called when a task succeeds
@@ -262,7 +262,7 @@ Adds a callback to be called when a task succeeds
 ### peek()
 
 ```ts
-peek: (position?) => undefined | () => Promise<TValue>;
+readonly peek: (position?) => undefined | () => Promise<TValue>;
 ```
 
 Returns an item without removing it
@@ -280,7 +280,7 @@ Returns an item without removing it
 ### reset()
 
 ```ts
-reset: (withInitialItems?) => void;
+readonly reset: (withInitialItems?) => void;
 ```
 
 Resets the queuer to its initial state
@@ -298,7 +298,7 @@ Resets the queuer to its initial state
 ### size()
 
 ```ts
-size: () => number;
+readonly size: () => number;
 ```
 
 Returns the current size of the queuer
@@ -310,7 +310,7 @@ Returns the current size of the queuer
 ### start()
 
 ```ts
-start: () => Promise<void>;
+readonly start: () => Promise<void>;
 ```
 
 Starts the queuer and processes items
@@ -322,7 +322,7 @@ Starts the queuer and processes items
 ### stop()
 
 ```ts
-stop: () => void;
+readonly stop: () => void;
 ```
 
 Stops the queuer from processing items
@@ -334,7 +334,7 @@ Stops the queuer from processing items
 ### throttle()
 
 ```ts
-throttle: (n) => void;
+readonly throttle: (n) => void;
 ```
 
 Throttles the number of concurrent items that can run at once

docs/framework/react/reference/functions/useasyncratelimiter.md

@@ -11,7 +11,7 @@ title: useAsyncRateLimiter
 function useAsyncRateLimiter<TFn, TArgs>(fn, options): object
 ```
 
-Defined in: [react-pacer/src/async-rate-limiter/useAsyncRateLimiter.ts:42](https://github.com/TanStack/pacer/blob/main/packages/react-pacer/src/async-rate-limiter/useAsyncRateLimiter.ts#L42)
+Defined in: [react-pacer/src/async-rate-limiter/useAsyncRateLimiter.ts:41](https://github.com/TanStack/pacer/blob/main/packages/react-pacer/src/async-rate-limiter/useAsyncRateLimiter.ts#L41)
 
 A low-level React hook that creates an `AsyncRateLimiter` instance to limit how many times an async function can execute within a time window.
 

docs/framework/react/reference/functions/usedebouncedcallback.md

@@ -0,0 +1,80 @@
+---
+id: useDebouncedCallback
+title: useDebouncedCallback
+---
+
+<!-- DO NOT EDIT: this page is autogenerated from the type comments -->
+
+# Function: useDebouncedCallback()
+
+```ts
+function useDebouncedCallback<TFn, TArgs>(fn, options): (...args) => void
+```
+
+Defined in: react-pacer/src/debouncer/useDebouncedCallback.ts:41
+
+A React hook that creates a debounced version of a callback function.
+This hook is essentially a wrapper around the basic `debounce` function
+that is exported from `@tanstack/pacer`,
+but optimized for React with reactive options and a stable function reference.
+
+The debounced function will only execute after the specified wait time has elapsed
+since its last invocation. If called again before the wait time expires, the timer
+resets and starts waiting again.
+
+This hook provides a simpler API compared to `useDebouncer`, making it ideal for basic
+debouncing needs. However, it does not expose the underlying Debouncer instance.
+
+For advanced usage requiring features like:
+- Manual cancellation
+- Access to execution counts
+- Custom useCallback dependencies
+
+Consider using the `useDebouncer` hook instead.
+
+## Type Parameters
+
+• **TFn** *extends* (...`args`) => `any`
+
+• **TArgs** *extends* `any`[]
+
+## Parameters
+
+### fn
+
+`TFn`
+
+### options
+
+`DebouncerOptions`
+
+## Returns
+
+`Function`
+
+### Parameters
+
+#### args
+
+...`TArgs`
+
+### Returns
+
+`void`
+
+## Example
+
+```tsx
+// Debounce a search handler
+const handleSearch = useDebouncedCallback((query: string) => {
+  fetchSearchResults(query);
+}, {
+  wait: 500 // Wait 500ms between executions
+});
+
+// Use in an input
+<input
+  type="text"
+  onChange={(e) => handleSearch(e.target.value)}
+/>
+```