@tanstack/preact-pacer 0.22.1 → 0.24.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +17 -2
- package/dist/async-batcher/useAsyncBatchedCallback.d.ts +2 -5
- package/dist/async-batcher/useAsyncBatchedCallback.js +1 -2
- package/dist/async-batcher/useAsyncBatcher.d.ts +4 -8
- package/dist/async-batcher/useAsyncBatcher.js +1 -3
- package/dist/async-debouncer/useAsyncDebouncedCallback.d.ts +6 -7
- package/dist/async-debouncer/useAsyncDebouncedCallback.js +5 -4
- package/dist/async-debouncer/useAsyncDebouncer.d.ts +4 -7
- package/dist/async-debouncer/useAsyncDebouncer.js +1 -2
- package/dist/async-queuer/useAsyncQueuedState.d.ts +4 -7
- package/dist/async-queuer/useAsyncQueuedState.js +3 -4
- package/dist/async-queuer/useAsyncQueuer.d.ts +6 -9
- package/dist/async-queuer/useAsyncQueuer.js +3 -4
- package/dist/async-rate-limiter/useAsyncRateLimitedCallback.d.ts +2 -5
- package/dist/async-rate-limiter/useAsyncRateLimitedCallback.js +1 -2
- package/dist/async-rate-limiter/useAsyncRateLimiter.d.ts +4 -7
- package/dist/async-rate-limiter/useAsyncRateLimiter.js +1 -2
- package/dist/async-throttler/useAsyncThrottledCallback.d.ts +7 -9
- package/dist/async-throttler/useAsyncThrottledCallback.js +6 -6
- package/dist/async-throttler/useAsyncThrottler.d.ts +4 -7
- package/dist/async-throttler/useAsyncThrottler.js +1 -2
- package/dist/batcher/useBatchedCallback.d.ts +2 -5
- package/dist/batcher/useBatchedCallback.js +1 -2
- package/dist/batcher/useBatcher.d.ts +6 -11
- package/dist/batcher/useBatcher.js +3 -6
- package/dist/debouncer/useDebouncedCallback.d.ts +2 -5
- package/dist/debouncer/useDebouncedCallback.js +1 -2
- package/dist/debouncer/useDebouncedState.d.ts +2 -5
- package/dist/debouncer/useDebouncedState.js +1 -2
- package/dist/debouncer/useDebouncedValue.d.ts +2 -5
- package/dist/debouncer/useDebouncedValue.js +1 -2
- package/dist/debouncer/useDebouncer.d.ts +4 -7
- package/dist/debouncer/useDebouncer.js +1 -2
- package/dist/provider/PacerProvider.d.ts +6 -13
- package/dist/provider/PacerProvider.js +1 -2
- package/dist/queuer/useQueuedState.d.ts +2 -5
- package/dist/queuer/useQueuedState.js +1 -2
- package/dist/queuer/useQueuedValue.d.ts +2 -5
- package/dist/queuer/useQueuedValue.js +1 -2
- package/dist/queuer/useQueuer.d.ts +4 -7
- package/dist/queuer/useQueuer.js +1 -2
- package/dist/rate-limiter/useRateLimitedCallback.d.ts +2 -5
- package/dist/rate-limiter/useRateLimitedCallback.js +1 -2
- package/dist/rate-limiter/useRateLimitedState.d.ts +2 -5
- package/dist/rate-limiter/useRateLimitedState.js +1 -2
- package/dist/rate-limiter/useRateLimitedValue.d.ts +2 -5
- package/dist/rate-limiter/useRateLimitedValue.js +1 -2
- package/dist/rate-limiter/useRateLimiter.d.ts +4 -7
- package/dist/rate-limiter/useRateLimiter.js +1 -2
- package/dist/throttler/useThrottledCallback.d.ts +2 -5
- package/dist/throttler/useThrottledCallback.js +1 -2
- package/dist/throttler/useThrottledState.d.ts +2 -5
- package/dist/throttler/useThrottledState.js +1 -2
- package/dist/throttler/useThrottledValue.d.ts +2 -5
- package/dist/throttler/useThrottledValue.js +1 -2
- package/dist/throttler/useThrottler.d.ts +4 -7
- package/dist/throttler/useThrottler.js +1 -2
- package/package.json +24 -72
- package/dist/async-batcher/index.cjs +0 -13
- package/dist/async-batcher/index.d.cts +0 -4
- package/dist/async-batcher/useAsyncBatchedCallback.cjs +0 -51
- package/dist/async-batcher/useAsyncBatchedCallback.cjs.map +0 -1
- package/dist/async-batcher/useAsyncBatchedCallback.d.cts +0 -44
- package/dist/async-batcher/useAsyncBatchedCallback.js.map +0 -1
- package/dist/async-batcher/useAsyncBatcher.cjs +0 -217
- package/dist/async-batcher/useAsyncBatcher.cjs.map +0 -1
- package/dist/async-batcher/useAsyncBatcher.d.cts +0 -224
- package/dist/async-batcher/useAsyncBatcher.js.map +0 -1
- package/dist/async-debouncer/index.cjs +0 -13
- package/dist/async-debouncer/index.d.cts +0 -4
- package/dist/async-debouncer/useAsyncDebouncedCallback.cjs +0 -50
- package/dist/async-debouncer/useAsyncDebouncedCallback.cjs.map +0 -1
- package/dist/async-debouncer/useAsyncDebouncedCallback.d.cts +0 -46
- package/dist/async-debouncer/useAsyncDebouncedCallback.js.map +0 -1
- package/dist/async-debouncer/useAsyncDebouncer.cjs +0 -195
- package/dist/async-debouncer/useAsyncDebouncer.cjs.map +0 -1
- package/dist/async-debouncer/useAsyncDebouncer.d.cts +0 -203
- package/dist/async-debouncer/useAsyncDebouncer.js.map +0 -1
- package/dist/async-queuer/index.cjs +0 -13
- package/dist/async-queuer/index.d.cts +0 -4
- package/dist/async-queuer/useAsyncQueuedState.cjs +0 -154
- package/dist/async-queuer/useAsyncQueuedState.cjs.map +0 -1
- package/dist/async-queuer/useAsyncQueuedState.d.cts +0 -151
- package/dist/async-queuer/useAsyncQueuedState.js.map +0 -1
- package/dist/async-queuer/useAsyncQueuer.cjs +0 -217
- package/dist/async-queuer/useAsyncQueuer.cjs.map +0 -1
- package/dist/async-queuer/useAsyncQueuer.d.cts +0 -224
- package/dist/async-queuer/useAsyncQueuer.js.map +0 -1
- package/dist/async-rate-limiter/index.cjs +0 -13
- package/dist/async-rate-limiter/index.d.cts +0 -4
- package/dist/async-rate-limiter/useAsyncRateLimitedCallback.cjs +0 -65
- package/dist/async-rate-limiter/useAsyncRateLimitedCallback.cjs.map +0 -1
- package/dist/async-rate-limiter/useAsyncRateLimitedCallback.d.cts +0 -61
- package/dist/async-rate-limiter/useAsyncRateLimitedCallback.js.map +0 -1
- package/dist/async-rate-limiter/useAsyncRateLimiter.cjs +0 -209
- package/dist/async-rate-limiter/useAsyncRateLimiter.cjs.map +0 -1
- package/dist/async-rate-limiter/useAsyncRateLimiter.d.cts +0 -220
- package/dist/async-rate-limiter/useAsyncRateLimiter.js.map +0 -1
- package/dist/async-retryer/index.cjs +0 -9
- package/dist/async-retryer/index.d.cts +0 -1
- package/dist/async-throttler/index.cjs +0 -13
- package/dist/async-throttler/index.d.cts +0 -4
- package/dist/async-throttler/useAsyncThrottledCallback.cjs +0 -48
- package/dist/async-throttler/useAsyncThrottledCallback.cjs.map +0 -1
- package/dist/async-throttler/useAsyncThrottledCallback.d.cts +0 -44
- package/dist/async-throttler/useAsyncThrottledCallback.js.map +0 -1
- package/dist/async-throttler/useAsyncThrottler.cjs +0 -206
- package/dist/async-throttler/useAsyncThrottler.cjs.map +0 -1
- package/dist/async-throttler/useAsyncThrottler.d.cts +0 -214
- package/dist/async-throttler/useAsyncThrottler.js.map +0 -1
- package/dist/batcher/index.cjs +0 -13
- package/dist/batcher/index.d.cts +0 -4
- package/dist/batcher/useBatchedCallback.cjs +0 -47
- package/dist/batcher/useBatchedCallback.cjs.map +0 -1
- package/dist/batcher/useBatchedCallback.d.cts +0 -42
- package/dist/batcher/useBatchedCallback.js.map +0 -1
- package/dist/batcher/useBatcher.cjs +0 -165
- package/dist/batcher/useBatcher.cjs.map +0 -1
- package/dist/batcher/useBatcher.d.cts +0 -175
- package/dist/batcher/useBatcher.js.map +0 -1
- package/dist/debouncer/index.cjs +0 -17
- package/dist/debouncer/index.d.cts +0 -6
- package/dist/debouncer/useDebouncedCallback.cjs +0 -48
- package/dist/debouncer/useDebouncedCallback.cjs.map +0 -1
- package/dist/debouncer/useDebouncedCallback.d.cts +0 -44
- package/dist/debouncer/useDebouncedCallback.js.map +0 -1
- package/dist/debouncer/useDebouncedState.cjs +0 -89
- package/dist/debouncer/useDebouncedState.cjs.map +0 -1
- package/dist/debouncer/useDebouncedState.d.cts +0 -81
- package/dist/debouncer/useDebouncedState.js.map +0 -1
- package/dist/debouncer/useDebouncedValue.cjs +0 -96
- package/dist/debouncer/useDebouncedValue.cjs.map +0 -1
- package/dist/debouncer/useDebouncedValue.d.cts +0 -90
- package/dist/debouncer/useDebouncedValue.js.map +0 -1
- package/dist/debouncer/useDebouncer.cjs +0 -141
- package/dist/debouncer/useDebouncer.cjs.map +0 -1
- package/dist/debouncer/useDebouncer.d.cts +0 -152
- package/dist/debouncer/useDebouncer.js.map +0 -1
- package/dist/index.cjs +0 -67
- package/dist/index.d.cts +0 -30
- package/dist/provider/PacerProvider.cjs +0 -26
- package/dist/provider/PacerProvider.cjs.map +0 -1
- package/dist/provider/PacerProvider.d.cts +0 -33
- package/dist/provider/PacerProvider.js.map +0 -1
- package/dist/provider/index.cjs +0 -6
- package/dist/provider/index.d.cts +0 -2
- package/dist/queuer/index.cjs +0 -15
- package/dist/queuer/index.d.cts +0 -5
- package/dist/queuer/useQueuedState.cjs +0 -129
- package/dist/queuer/useQueuedState.cjs.map +0 -1
- package/dist/queuer/useQueuedState.d.cts +0 -122
- package/dist/queuer/useQueuedState.js.map +0 -1
- package/dist/queuer/useQueuedValue.cjs +0 -115
- package/dist/queuer/useQueuedValue.cjs.map +0 -1
- package/dist/queuer/useQueuedValue.d.cts +0 -105
- package/dist/queuer/useQueuedValue.js.map +0 -1
- package/dist/queuer/useQueuer.cjs +0 -176
- package/dist/queuer/useQueuer.cjs.map +0 -1
- package/dist/queuer/useQueuer.d.cts +0 -186
- package/dist/queuer/useQueuer.js.map +0 -1
- package/dist/rate-limiter/index.cjs +0 -17
- package/dist/rate-limiter/index.d.cts +0 -6
- package/dist/rate-limiter/useRateLimitedCallback.cjs +0 -65
- package/dist/rate-limiter/useRateLimitedCallback.cjs.map +0 -1
- package/dist/rate-limiter/useRateLimitedCallback.d.cts +0 -61
- package/dist/rate-limiter/useRateLimitedCallback.js.map +0 -1
- package/dist/rate-limiter/useRateLimitedState.cjs +0 -115
- package/dist/rate-limiter/useRateLimitedState.cjs.map +0 -1
- package/dist/rate-limiter/useRateLimitedState.d.cts +0 -107
- package/dist/rate-limiter/useRateLimitedState.js.map +0 -1
- package/dist/rate-limiter/useRateLimitedValue.cjs +0 -102
- package/dist/rate-limiter/useRateLimitedValue.cjs.map +0 -1
- package/dist/rate-limiter/useRateLimitedValue.d.cts +0 -96
- package/dist/rate-limiter/useRateLimitedValue.js.map +0 -1
- package/dist/rate-limiter/useRateLimiter.cjs +0 -167
- package/dist/rate-limiter/useRateLimiter.cjs.map +0 -1
- package/dist/rate-limiter/useRateLimiter.d.cts +0 -179
- package/dist/rate-limiter/useRateLimiter.js.map +0 -1
- package/dist/throttler/index.cjs +0 -17
- package/dist/throttler/index.d.cts +0 -6
- package/dist/throttler/useThrottledCallback.cjs +0 -49
- package/dist/throttler/useThrottledCallback.cjs.map +0 -1
- package/dist/throttler/useThrottledCallback.d.cts +0 -45
- package/dist/throttler/useThrottledCallback.js.map +0 -1
- package/dist/throttler/useThrottledState.cjs +0 -100
- package/dist/throttler/useThrottledState.cjs.map +0 -1
- package/dist/throttler/useThrottledState.d.cts +0 -92
- package/dist/throttler/useThrottledState.js.map +0 -1
- package/dist/throttler/useThrottledValue.cjs +0 -91
- package/dist/throttler/useThrottledValue.cjs.map +0 -1
- package/dist/throttler/useThrottledValue.d.cts +0 -85
- package/dist/throttler/useThrottledValue.js.map +0 -1
- package/dist/throttler/useThrottler.cjs +0 -146
- package/dist/throttler/useThrottler.cjs.map +0 -1
- package/dist/throttler/useThrottler.d.cts +0 -157
- package/dist/throttler/useThrottler.js.map +0 -1
- package/dist/types/index.cjs +0 -9
- package/dist/types/index.d.cts +0 -1
- package/dist/utils/index.cjs +0 -9
- package/dist/utils/index.d.cts +0 -1
- package/src/async-batcher/index.ts +0 -4
- package/src/async-batcher/useAsyncBatchedCallback.ts +0 -53
- package/src/async-batcher/useAsyncBatcher.ts +0 -293
- package/src/async-debouncer/index.ts +0 -5
- package/src/async-debouncer/useAsyncDebouncedCallback.ts +0 -54
- package/src/async-debouncer/useAsyncDebouncer.ts +0 -274
- package/src/async-queuer/index.ts +0 -4
- package/src/async-queuer/useAsyncQueuedState.ts +0 -165
- package/src/async-queuer/useAsyncQueuer.ts +0 -293
- package/src/async-rate-limiter/index.ts +0 -5
- package/src/async-rate-limiter/useAsyncRateLimitedCallback.ts +0 -69
- package/src/async-rate-limiter/useAsyncRateLimiter.ts +0 -294
- package/src/async-retryer/index.ts +0 -2
- package/src/async-throttler/index.ts +0 -5
- package/src/async-throttler/useAsyncThrottledCallback.ts +0 -52
- package/src/async-throttler/useAsyncThrottler.ts +0 -285
- package/src/batcher/index.ts +0 -4
- package/src/batcher/useBatchedCallback.ts +0 -46
- package/src/batcher/useBatcher.ts +0 -241
- package/src/debouncer/index.ts +0 -7
- package/src/debouncer/useDebouncedCallback.ts +0 -51
- package/src/debouncer/useDebouncedState.ts +0 -106
- package/src/debouncer/useDebouncedValue.ts +0 -109
- package/src/debouncer/useDebouncer.ts +0 -219
- package/src/index.ts +0 -56
- package/src/provider/PacerProvider.tsx +0 -70
- package/src/provider/index.ts +0 -1
- package/src/queuer/index.ts +0 -5
- package/src/queuer/useQueuedState.ts +0 -133
- package/src/queuer/useQueuedValue.ts +0 -129
- package/src/queuer/useQueuer.ts +0 -251
- package/src/rate-limiter/index.ts +0 -6
- package/src/rate-limiter/useRateLimitedCallback.ts +0 -68
- package/src/rate-limiter/useRateLimitedState.ts +0 -124
- package/src/rate-limiter/useRateLimitedValue.ts +0 -110
- package/src/rate-limiter/useRateLimiter.ts +0 -244
- package/src/throttler/index.ts +0 -7
- package/src/throttler/useThrottledCallback.ts +0 -52
- package/src/throttler/useThrottledState.ts +0 -118
- package/src/throttler/useThrottledValue.ts +0 -104
- package/src/throttler/useThrottler.ts +0 -224
- package/src/types/index.ts +0 -1
- package/src/utils/index.ts +0 -1
|
@@ -1,90 +0,0 @@
|
|
|
1
|
-
import { PreactDebouncer, PreactDebouncerOptions } from "./useDebouncer.cjs";
|
|
2
|
-
import { DebouncerState } from "@tanstack/pacer/debouncer";
|
|
3
|
-
import { Dispatch, StateUpdater } from "preact/hooks";
|
|
4
|
-
|
|
5
|
-
//#region src/debouncer/useDebouncedValue.d.ts
|
|
6
|
-
/**
|
|
7
|
-
* A Preact hook that creates a debounced value that updates only after a specified delay.
|
|
8
|
-
* Unlike useDebouncedState, this hook automatically tracks changes to the input value
|
|
9
|
-
* and updates the debounced value accordingly.
|
|
10
|
-
*
|
|
11
|
-
* The debounced value will only update after the specified wait time has elapsed since
|
|
12
|
-
* the last change to the input value. If the input value changes again before the wait
|
|
13
|
-
* time expires, the timer resets and starts waiting again.
|
|
14
|
-
*
|
|
15
|
-
* This is useful for deriving debounced values from props or state that change frequently,
|
|
16
|
-
* like search queries or form inputs, where you want to limit how often downstream effects
|
|
17
|
-
* or calculations occur.
|
|
18
|
-
*
|
|
19
|
-
* The hook returns the current debounced value and the underlying debouncer instance.
|
|
20
|
-
* The debouncer instance can be used to access additional functionality like cancellation
|
|
21
|
-
* and execution counts.
|
|
22
|
-
*
|
|
23
|
-
* ## State Management and Selector
|
|
24
|
-
*
|
|
25
|
-
* The hook uses TanStack Store for reactive state management via the underlying debouncer instance.
|
|
26
|
-
* The `selector` parameter allows you to specify which debouncer state changes will trigger a re-render,
|
|
27
|
-
* optimizing performance by preventing unnecessary re-renders when irrelevant state changes occur.
|
|
28
|
-
*
|
|
29
|
-
* **By default, there will be no reactive state subscriptions** and you must opt-in to state
|
|
30
|
-
* tracking by providing a selector function. This prevents unnecessary re-renders and gives you
|
|
31
|
-
* full control over when your component updates. Only when you provide a selector will the
|
|
32
|
-
* component re-render when the selected state values change.
|
|
33
|
-
*
|
|
34
|
-
* Available debouncer state properties:
|
|
35
|
-
* - `canLeadingExecute`: Whether the debouncer can execute on the leading edge
|
|
36
|
-
* - `executionCount`: Number of function executions that have been completed
|
|
37
|
-
* - `isPending`: Whether the debouncer is waiting for the timeout to trigger execution
|
|
38
|
-
* - `lastArgs`: The arguments from the most recent call to maybeExecute
|
|
39
|
-
* - `status`: Current execution status ('disabled' | 'idle' | 'pending')
|
|
40
|
-
*
|
|
41
|
-
* @example
|
|
42
|
-
* ```tsx
|
|
43
|
-
* // Default behavior - no reactive state subscriptions
|
|
44
|
-
* const [searchQuery, setSearchQuery] = useState('');
|
|
45
|
-
* const [debouncedQuery, debouncer] = useDebouncedValue(searchQuery, {
|
|
46
|
-
* wait: 500 // Wait 500ms after last change
|
|
47
|
-
* });
|
|
48
|
-
*
|
|
49
|
-
* // Opt-in to re-render when pending state changes (optimized for loading indicators)
|
|
50
|
-
* const [debouncedQuery, debouncer] = useDebouncedValue(
|
|
51
|
-
* searchQuery,
|
|
52
|
-
* { wait: 500 },
|
|
53
|
-
* (state) => ({ isPending: state.isPending })
|
|
54
|
-
* );
|
|
55
|
-
*
|
|
56
|
-
* // Opt-in to re-render when execution count changes (optimized for tracking executions)
|
|
57
|
-
* const [debouncedQuery, debouncer] = useDebouncedValue(
|
|
58
|
-
* searchQuery,
|
|
59
|
-
* { wait: 500 },
|
|
60
|
-
* (state) => ({ executionCount: state.executionCount })
|
|
61
|
-
* );
|
|
62
|
-
*
|
|
63
|
-
* // Opt-in to re-render when debouncing status changes (optimized for status display)
|
|
64
|
-
* const [debouncedQuery, debouncer] = useDebouncedValue(
|
|
65
|
-
* searchQuery,
|
|
66
|
-
* { wait: 500 },
|
|
67
|
-
* (state) => ({
|
|
68
|
-
* status: state.status,
|
|
69
|
-
* canLeadingExecute: state.canLeadingExecute
|
|
70
|
-
* })
|
|
71
|
-
* );
|
|
72
|
-
*
|
|
73
|
-
* // debouncedQuery will update 500ms after searchQuery stops changing
|
|
74
|
-
* useEffect(() => {
|
|
75
|
-
* fetchSearchResults(debouncedQuery);
|
|
76
|
-
* }, [debouncedQuery]);
|
|
77
|
-
*
|
|
78
|
-
* // Handle input changes
|
|
79
|
-
* const handleChange = (e) => {
|
|
80
|
-
* setSearchQuery(e.target.value);
|
|
81
|
-
* };
|
|
82
|
-
*
|
|
83
|
-
* // Access the selected debouncer state (will be empty object {} unless selector provided)
|
|
84
|
-
* const { isPending, executionCount } = debouncer.state;
|
|
85
|
-
* ```
|
|
86
|
-
*/
|
|
87
|
-
declare function useDebouncedValue<TValue, TSelected = DebouncerState<Dispatch<StateUpdater<TValue>>>>(value: TValue, options: PreactDebouncerOptions<Dispatch<StateUpdater<TValue>>, TSelected>, selector?: (state: DebouncerState<Dispatch<StateUpdater<TValue>>>) => TSelected): [TValue, PreactDebouncer<Dispatch<StateUpdater<TValue>>, TSelected>];
|
|
88
|
-
//#endregion
|
|
89
|
-
export { useDebouncedValue };
|
|
90
|
-
//# sourceMappingURL=useDebouncedValue.d.cts.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"useDebouncedValue.js","names":[],"sources":["../../src/debouncer/useDebouncedValue.ts"],"sourcesContent":["import { useEffect } from 'preact/hooks'\nimport { useDebouncedState } from './useDebouncedState'\nimport type { PreactDebouncer, PreactDebouncerOptions } from './useDebouncer'\nimport type { Dispatch, StateUpdater } from 'preact/hooks'\nimport type { DebouncerState } from '@tanstack/pacer/debouncer'\n\n/**\n * A Preact hook that creates a debounced value that updates only after a specified delay.\n * Unlike useDebouncedState, this hook automatically tracks changes to the input value\n * and updates the debounced value accordingly.\n *\n * The debounced value will only update after the specified wait time has elapsed since\n * the last change to the input value. If the input value changes again before the wait\n * time expires, the timer resets and starts waiting again.\n *\n * This is useful for deriving debounced values from props or state that change frequently,\n * like search queries or form inputs, where you want to limit how often downstream effects\n * or calculations occur.\n *\n * The hook returns the current debounced value and the underlying debouncer instance.\n * The debouncer instance can be used to access additional functionality like cancellation\n * and execution counts.\n *\n * ## State Management and Selector\n *\n * The hook uses TanStack Store for reactive state management via the underlying debouncer instance.\n * The `selector` parameter allows you to specify which debouncer state changes will trigger a re-render,\n * optimizing performance by preventing unnecessary re-renders when irrelevant state changes occur.\n *\n * **By default, there will be no reactive state subscriptions** and you must opt-in to state\n * tracking by providing a selector function. This prevents unnecessary re-renders and gives you\n * full control over when your component updates. Only when you provide a selector will the\n * component re-render when the selected state values change.\n *\n * Available debouncer state properties:\n * - `canLeadingExecute`: Whether the debouncer can execute on the leading edge\n * - `executionCount`: Number of function executions that have been completed\n * - `isPending`: Whether the debouncer is waiting for the timeout to trigger execution\n * - `lastArgs`: The arguments from the most recent call to maybeExecute\n * - `status`: Current execution status ('disabled' | 'idle' | 'pending')\n *\n * @example\n * ```tsx\n * // Default behavior - no reactive state subscriptions\n * const [searchQuery, setSearchQuery] = useState('');\n * const [debouncedQuery, debouncer] = useDebouncedValue(searchQuery, {\n * wait: 500 // Wait 500ms after last change\n * });\n *\n * // Opt-in to re-render when pending state changes (optimized for loading indicators)\n * const [debouncedQuery, debouncer] = useDebouncedValue(\n * searchQuery,\n * { wait: 500 },\n * (state) => ({ isPending: state.isPending })\n * );\n *\n * // Opt-in to re-render when execution count changes (optimized for tracking executions)\n * const [debouncedQuery, debouncer] = useDebouncedValue(\n * searchQuery,\n * { wait: 500 },\n * (state) => ({ executionCount: state.executionCount })\n * );\n *\n * // Opt-in to re-render when debouncing status changes (optimized for status display)\n * const [debouncedQuery, debouncer] = useDebouncedValue(\n * searchQuery,\n * { wait: 500 },\n * (state) => ({\n * status: state.status,\n * canLeadingExecute: state.canLeadingExecute\n * })\n * );\n *\n * // debouncedQuery will update 500ms after searchQuery stops changing\n * useEffect(() => {\n * fetchSearchResults(debouncedQuery);\n * }, [debouncedQuery]);\n *\n * // Handle input changes\n * const handleChange = (e) => {\n * setSearchQuery(e.target.value);\n * };\n *\n * // Access the selected debouncer state (will be empty object {} unless selector provided)\n * const { isPending, executionCount } = debouncer.state;\n * ```\n */\nexport function useDebouncedValue<\n TValue,\n TSelected = DebouncerState<Dispatch<StateUpdater<TValue>>>,\n>(\n value: TValue,\n options: PreactDebouncerOptions<Dispatch<StateUpdater<TValue>>, TSelected>,\n selector?: (\n state: DebouncerState<Dispatch<StateUpdater<TValue>>>,\n ) => TSelected,\n): [TValue, PreactDebouncer<Dispatch<StateUpdater<TValue>>, TSelected>] {\n const [debouncedValue, setDebouncedValue, debouncer] = useDebouncedState(\n value,\n options,\n selector,\n )\n\n useEffect(() => {\n ;(setDebouncedValue as (value: TValue) => void)(value)\n }, [value, setDebouncedValue])\n\n return [debouncedValue, debouncer]\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAuFA,SAAgB,kBAId,OACA,SACA,UAGsE;CACtE,MAAM,CAAC,gBAAgB,mBAAmB,aAAa,kBACrD,OACA,SACA,SACD;CAED,gBAAgB;EACb,AAAC,kBAA8C,MAAM;IACrD,CAAC,OAAO,kBAAkB,CAAC;CAE9B,OAAO,CAAC,gBAAgB,UAAU"}
|
|
@@ -1,141 +0,0 @@
|
|
|
1
|
-
const require_PacerProvider = require('../provider/PacerProvider.cjs');
|
|
2
|
-
let preact_hooks = require("preact/hooks");
|
|
3
|
-
let _tanstack_preact_store = require("@tanstack/preact-store");
|
|
4
|
-
let _tanstack_pacer_debouncer = require("@tanstack/pacer/debouncer");
|
|
5
|
-
|
|
6
|
-
//#region src/debouncer/useDebouncer.ts
|
|
7
|
-
/**
|
|
8
|
-
* A Preact hook that creates and manages a Debouncer instance.
|
|
9
|
-
*
|
|
10
|
-
* This is a lower-level hook that provides direct access to the Debouncer's functionality without
|
|
11
|
-
* any built-in state management. This allows you to integrate it with any state management solution
|
|
12
|
-
* you prefer (useState, Redux, Zustand, etc.).
|
|
13
|
-
*
|
|
14
|
-
* This hook provides debouncing functionality to limit how often a function can be called,
|
|
15
|
-
* waiting for a specified delay before executing the latest call. This is useful for handling
|
|
16
|
-
* frequent events like window resizing, scroll events, or real-time search inputs.
|
|
17
|
-
*
|
|
18
|
-
* The debouncer will only execute the function after the specified wait time has elapsed
|
|
19
|
-
* since the last call. If the function is called again before the wait time expires, the
|
|
20
|
-
* timer resets and starts waiting again.
|
|
21
|
-
*
|
|
22
|
-
* ## State Management and Selector
|
|
23
|
-
*
|
|
24
|
-
* The hook uses TanStack Store for reactive state management. You can subscribe to state changes
|
|
25
|
-
* in two ways:
|
|
26
|
-
*
|
|
27
|
-
* **1. Using `debouncer.Subscribe` HOC (Recommended for component tree subscriptions)**
|
|
28
|
-
*
|
|
29
|
-
* Use the `Subscribe` HOC to subscribe to state changes deep in your component tree without
|
|
30
|
-
* needing to pass a selector to the hook. This is ideal when you want to subscribe to state
|
|
31
|
-
* in child components.
|
|
32
|
-
*
|
|
33
|
-
* **2. Using the `selector` parameter (For hook-level subscriptions)**
|
|
34
|
-
*
|
|
35
|
-
* The `selector` parameter allows you to specify which state changes will trigger a re-render
|
|
36
|
-
* at the hook level, optimizing performance by preventing unnecessary re-renders when irrelevant
|
|
37
|
-
* state changes occur.
|
|
38
|
-
*
|
|
39
|
-
* **By default, there will be no reactive state subscriptions** and you must opt-in to state
|
|
40
|
-
* tracking by providing a selector function or using the `Subscribe` HOC. This prevents unnecessary
|
|
41
|
-
* re-renders and gives you full control over when your component updates.
|
|
42
|
-
*
|
|
43
|
-
* Available state properties:
|
|
44
|
-
* - `canLeadingExecute`: Whether the debouncer can execute on the leading edge
|
|
45
|
-
* - `executionCount`: Number of function executions that have been completed
|
|
46
|
-
* - `isPending`: Whether the debouncer is waiting for the timeout to trigger execution
|
|
47
|
-
* - `lastArgs`: The arguments from the most recent call to maybeExecute
|
|
48
|
-
* - `status`: Current execution status ('disabled' | 'idle' | 'pending')
|
|
49
|
-
*
|
|
50
|
-
* ## Unmount behavior
|
|
51
|
-
*
|
|
52
|
-
* By default, the hook cancels any pending execution when the component unmounts.
|
|
53
|
-
* Use the `onUnmount` option to customize this. For example, to flush pending work instead:
|
|
54
|
-
*
|
|
55
|
-
* ```tsx
|
|
56
|
-
* const debouncer = useDebouncer(fn, {
|
|
57
|
-
* wait: 500,
|
|
58
|
-
* onUnmount: (d) => d.flush()
|
|
59
|
-
* });
|
|
60
|
-
* ```
|
|
61
|
-
*
|
|
62
|
-
* @example
|
|
63
|
-
* ```tsx
|
|
64
|
-
* // Default behavior - no reactive state subscriptions
|
|
65
|
-
* const searchDebouncer = useDebouncer(
|
|
66
|
-
* (query: string) => fetchSearchResults(query),
|
|
67
|
-
* { wait: 500 }
|
|
68
|
-
* );
|
|
69
|
-
*
|
|
70
|
-
* // Subscribe to state changes deep in component tree using Subscribe HOC
|
|
71
|
-
* <searchDebouncer.Subscribe selector={(state) => ({ isPending: state.isPending })}>
|
|
72
|
-
* {({ isPending }) => (
|
|
73
|
-
* <div>{isPending ? 'Searching...' : 'Ready'}</div>
|
|
74
|
-
* )}
|
|
75
|
-
* </searchDebouncer.Subscribe>
|
|
76
|
-
*
|
|
77
|
-
* // Opt-in to re-render when isPending changes at hook level (optimized for loading states)
|
|
78
|
-
* const searchDebouncer = useDebouncer(
|
|
79
|
-
* (query: string) => fetchSearchResults(query),
|
|
80
|
-
* { wait: 500 },
|
|
81
|
-
* (state) => ({ isPending: state.isPending })
|
|
82
|
-
* );
|
|
83
|
-
*
|
|
84
|
-
* // Opt-in to re-render when executionCount changes (optimized for tracking execution)
|
|
85
|
-
* const searchDebouncer = useDebouncer(
|
|
86
|
-
* (query: string) => fetchSearchResults(query),
|
|
87
|
-
* { wait: 500 },
|
|
88
|
-
* (state) => ({ executionCount: state.executionCount })
|
|
89
|
-
* );
|
|
90
|
-
*
|
|
91
|
-
* // Multiple state properties - re-render when any of these change
|
|
92
|
-
* const searchDebouncer = useDebouncer(
|
|
93
|
-
* (query: string) => fetchSearchResults(query),
|
|
94
|
-
* { wait: 500 },
|
|
95
|
-
* (state) => ({
|
|
96
|
-
* isPending: state.isPending,
|
|
97
|
-
* executionCount: state.executionCount,
|
|
98
|
-
* status: state.status
|
|
99
|
-
* })
|
|
100
|
-
* );
|
|
101
|
-
*
|
|
102
|
-
* // In an event handler
|
|
103
|
-
* const handleChange = (e) => {
|
|
104
|
-
* searchDebouncer.maybeExecute(e.target.value);
|
|
105
|
-
* };
|
|
106
|
-
*
|
|
107
|
-
* // Access the selected state (will be empty object {} unless selector provided)
|
|
108
|
-
* const { isPending } = searchDebouncer.state;
|
|
109
|
-
* ```
|
|
110
|
-
*/
|
|
111
|
-
function useDebouncer(fn, options, selector = () => ({})) {
|
|
112
|
-
const mergedOptions = {
|
|
113
|
-
...require_PacerProvider.useDefaultPacerOptions().debouncer,
|
|
114
|
-
...options
|
|
115
|
-
};
|
|
116
|
-
const [debouncer] = (0, preact_hooks.useState)(() => {
|
|
117
|
-
const debouncerInstance = new _tanstack_pacer_debouncer.Debouncer(fn, mergedOptions);
|
|
118
|
-
debouncerInstance.Subscribe = function Subscribe(props) {
|
|
119
|
-
const selected = (0, _tanstack_preact_store.useSelector)(debouncerInstance.store, props.selector, { compare: _tanstack_preact_store.shallow });
|
|
120
|
-
return typeof props.children === "function" ? props.children(selected) : props.children;
|
|
121
|
-
};
|
|
122
|
-
return debouncerInstance;
|
|
123
|
-
});
|
|
124
|
-
debouncer.fn = fn;
|
|
125
|
-
debouncer.setOptions(mergedOptions);
|
|
126
|
-
(0, preact_hooks.useEffect)(() => {
|
|
127
|
-
return () => {
|
|
128
|
-
if (mergedOptions.onUnmount) mergedOptions.onUnmount(debouncer);
|
|
129
|
-
else debouncer.cancel();
|
|
130
|
-
};
|
|
131
|
-
}, []);
|
|
132
|
-
const state = (0, _tanstack_preact_store.useSelector)(debouncer.store, selector, { compare: _tanstack_preact_store.shallow });
|
|
133
|
-
return (0, preact_hooks.useMemo)(() => ({
|
|
134
|
-
...debouncer,
|
|
135
|
-
state
|
|
136
|
-
}), [debouncer, state]);
|
|
137
|
-
}
|
|
138
|
-
|
|
139
|
-
//#endregion
|
|
140
|
-
exports.useDebouncer = useDebouncer;
|
|
141
|
-
//# sourceMappingURL=useDebouncer.cjs.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"useDebouncer.cjs","names":["useDefaultPacerOptions","Debouncer","shallow"],"sources":["../../src/debouncer/useDebouncer.ts"],"sourcesContent":["import { useEffect, useMemo, useState } from 'preact/hooks'\nimport { Debouncer } from '@tanstack/pacer/debouncer'\nimport { shallow, useSelector } from '@tanstack/preact-store'\nimport { useDefaultPacerOptions } from '../provider/PacerProvider'\nimport type { Store } from '@tanstack/preact-store'\nimport type {\n DebouncerOptions,\n DebouncerState,\n} from '@tanstack/pacer/debouncer'\nimport type { AnyFunction } from '@tanstack/pacer/types'\nimport type { ComponentChildren } from 'preact'\n\nexport interface PreactDebouncerOptions<\n TFn extends AnyFunction,\n TSelected = {},\n> extends DebouncerOptions<TFn> {\n /**\n * Optional callback invoked when the component unmounts. Receives the debouncer instance.\n * When provided, replaces the default cleanup (cancel); use it to call flush(), reset(), cancel(), add logging, etc.\n */\n onUnmount?: (debouncer: PreactDebouncer<TFn, TSelected>) => void\n}\n\nexport interface PreactDebouncer<\n TFn extends AnyFunction,\n TSelected = {},\n> extends Omit<Debouncer<TFn>, 'store'> {\n /**\n * A Preact HOC (Higher Order Component) that allows you to subscribe to the debouncer state.\n *\n * This is useful for opting into state re-renders for specific parts of the debouncer state\n * deep in your component tree without needing to pass a selector to the hook.\n *\n * @example\n * <debouncer.Subscribe selector={(state) => ({ isPending: state.isPending })}>\n * {({ isPending }) => (\n * <div>{isPending ? 'Loading...' : 'Ready'}</div>\n * )}\n * </debouncer.Subscribe>\n */\n Subscribe: <TSelected>(props: {\n selector: (state: DebouncerState<TFn>) => TSelected\n children: ((state: TSelected) => ComponentChildren) | ComponentChildren\n }) => ComponentChildren\n /**\n * Reactive state that will be updated and re-rendered when the debouncer state changes\n *\n * Use this instead of `debouncer.store.state`\n */\n readonly state: Readonly<TSelected>\n /**\n * @deprecated Use `debouncer.state` instead of `debouncer.store.state` if you want to read reactive state.\n * The state on the store object is not reactive, as it has not been wrapped in a `useSelector` hook internally.\n * Although, you can make the state reactive by using the `useSelector` in your own usage.\n */\n readonly store: Store<Readonly<DebouncerState<TFn>>>\n}\n\n/**\n * A Preact hook that creates and manages a Debouncer instance.\n *\n * This is a lower-level hook that provides direct access to the Debouncer's functionality without\n * any built-in state management. This allows you to integrate it with any state management solution\n * you prefer (useState, Redux, Zustand, etc.).\n *\n * This hook provides debouncing functionality to limit how often a function can be called,\n * waiting for a specified delay before executing the latest call. This is useful for handling\n * frequent events like window resizing, scroll events, or real-time search inputs.\n *\n * The debouncer will only execute the function after the specified wait time has elapsed\n * since the last call. If the function is called again before the wait time expires, the\n * timer resets and starts waiting again.\n *\n * ## State Management and Selector\n *\n * The hook uses TanStack Store for reactive state management. You can subscribe to state changes\n * in two ways:\n *\n * **1. Using `debouncer.Subscribe` HOC (Recommended for component tree subscriptions)**\n *\n * Use the `Subscribe` HOC to subscribe to state changes deep in your component tree without\n * needing to pass a selector to the hook. This is ideal when you want to subscribe to state\n * in child components.\n *\n * **2. Using the `selector` parameter (For hook-level subscriptions)**\n *\n * The `selector` parameter allows you to specify which state changes will trigger a re-render\n * at the hook level, optimizing performance by preventing unnecessary re-renders when irrelevant\n * state changes occur.\n *\n * **By default, there will be no reactive state subscriptions** and you must opt-in to state\n * tracking by providing a selector function or using the `Subscribe` HOC. This prevents unnecessary\n * re-renders and gives you full control over when your component updates.\n *\n * Available state properties:\n * - `canLeadingExecute`: Whether the debouncer can execute on the leading edge\n * - `executionCount`: Number of function executions that have been completed\n * - `isPending`: Whether the debouncer is waiting for the timeout to trigger execution\n * - `lastArgs`: The arguments from the most recent call to maybeExecute\n * - `status`: Current execution status ('disabled' | 'idle' | 'pending')\n *\n * ## Unmount behavior\n *\n * By default, the hook cancels any pending execution when the component unmounts.\n * Use the `onUnmount` option to customize this. For example, to flush pending work instead:\n *\n * ```tsx\n * const debouncer = useDebouncer(fn, {\n * wait: 500,\n * onUnmount: (d) => d.flush()\n * });\n * ```\n *\n * @example\n * ```tsx\n * // Default behavior - no reactive state subscriptions\n * const searchDebouncer = useDebouncer(\n * (query: string) => fetchSearchResults(query),\n * { wait: 500 }\n * );\n *\n * // Subscribe to state changes deep in component tree using Subscribe HOC\n * <searchDebouncer.Subscribe selector={(state) => ({ isPending: state.isPending })}>\n * {({ isPending }) => (\n * <div>{isPending ? 'Searching...' : 'Ready'}</div>\n * )}\n * </searchDebouncer.Subscribe>\n *\n * // Opt-in to re-render when isPending changes at hook level (optimized for loading states)\n * const searchDebouncer = useDebouncer(\n * (query: string) => fetchSearchResults(query),\n * { wait: 500 },\n * (state) => ({ isPending: state.isPending })\n * );\n *\n * // Opt-in to re-render when executionCount changes (optimized for tracking execution)\n * const searchDebouncer = useDebouncer(\n * (query: string) => fetchSearchResults(query),\n * { wait: 500 },\n * (state) => ({ executionCount: state.executionCount })\n * );\n *\n * // Multiple state properties - re-render when any of these change\n * const searchDebouncer = useDebouncer(\n * (query: string) => fetchSearchResults(query),\n * { wait: 500 },\n * (state) => ({\n * isPending: state.isPending,\n * executionCount: state.executionCount,\n * status: state.status\n * })\n * );\n *\n * // In an event handler\n * const handleChange = (e) => {\n * searchDebouncer.maybeExecute(e.target.value);\n * };\n *\n * // Access the selected state (will be empty object {} unless selector provided)\n * const { isPending } = searchDebouncer.state;\n * ```\n */\nexport function useDebouncer<TFn extends AnyFunction, TSelected = {}>(\n fn: TFn,\n options: PreactDebouncerOptions<TFn, TSelected>,\n selector: (state: DebouncerState<TFn>) => TSelected = () => ({}) as TSelected,\n): PreactDebouncer<TFn, TSelected> {\n const mergedOptions = {\n ...useDefaultPacerOptions().debouncer,\n ...options,\n } as PreactDebouncerOptions<TFn, TSelected>\n const [debouncer] = useState(() => {\n const debouncerInstance = new Debouncer(\n fn,\n mergedOptions,\n ) as unknown as PreactDebouncer<TFn, TSelected>\n\n debouncerInstance.Subscribe = function Subscribe<TSelected>(props: {\n selector: (state: DebouncerState<TFn>) => TSelected\n children: ((state: TSelected) => ComponentChildren) | ComponentChildren\n }) {\n const selected = useSelector(debouncerInstance.store, props.selector, {\n compare: shallow,\n })\n\n return typeof props.children === 'function'\n ? props.children(selected)\n : props.children\n }\n\n return debouncerInstance\n })\n\n debouncer.fn = fn\n debouncer.setOptions(mergedOptions)\n\n /* eslint-disable react-hooks/exhaustive-deps -- cleanup only; runs on unmount */\n useEffect(() => {\n return () => {\n if (mergedOptions.onUnmount) {\n mergedOptions.onUnmount(debouncer)\n } else {\n debouncer.cancel()\n }\n }\n }, [])\n /* eslint-enable react-hooks/exhaustive-deps */\n\n const state = useSelector(debouncer.store, selector, { compare: shallow })\n\n return useMemo(\n () =>\n ({\n ...debouncer,\n state,\n }) as PreactDebouncer<TFn, TSelected>, // omit `store` in favor of `state`\n [debouncer, state],\n )\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAkKA,SAAgB,aACd,IACA,SACA,kBAA6D,EAAE,GAC9B;CACjC,MAAM,gBAAgB;EACpB,GAAGA,8CAAwB,CAAC;EAC5B,GAAG;EACJ;CACD,MAAM,CAAC,8CAA4B;EACjC,MAAM,oBAAoB,IAAIC,oCAC5B,IACA,cACD;EAED,kBAAkB,YAAY,SAAS,UAAqB,OAGzD;GACD,MAAM,mDAAuB,kBAAkB,OAAO,MAAM,UAAU,EACpE,SAASC,gCACV,CAAC;GAEF,OAAO,OAAO,MAAM,aAAa,aAC7B,MAAM,SAAS,SAAS,GACxB,MAAM;;EAGZ,OAAO;GACP;CAEF,UAAU,KAAK;CACf,UAAU,WAAW,cAAc;CAGnC,kCAAgB;EACd,aAAa;GACX,IAAI,cAAc,WAChB,cAAc,UAAU,UAAU;QAElC,UAAU,QAAQ;;IAGrB,EAAE,CAAC;CAGN,MAAM,gDAAoB,UAAU,OAAO,UAAU,EAAE,SAASA,gCAAS,CAAC;CAE1E,wCAEK;EACC,GAAG;EACH;EACD,GACH,CAAC,WAAW,MAAM,CACnB"}
|
|
@@ -1,152 +0,0 @@
|
|
|
1
|
-
import { Store } from "@tanstack/preact-store";
|
|
2
|
-
import { ComponentChildren } from "preact";
|
|
3
|
-
import { AnyFunction } from "@tanstack/pacer/types";
|
|
4
|
-
import { Debouncer, DebouncerOptions, DebouncerState } from "@tanstack/pacer/debouncer";
|
|
5
|
-
|
|
6
|
-
//#region src/debouncer/useDebouncer.d.ts
|
|
7
|
-
interface PreactDebouncerOptions<TFn extends AnyFunction, TSelected = {}> extends DebouncerOptions<TFn> {
|
|
8
|
-
/**
|
|
9
|
-
* Optional callback invoked when the component unmounts. Receives the debouncer instance.
|
|
10
|
-
* When provided, replaces the default cleanup (cancel); use it to call flush(), reset(), cancel(), add logging, etc.
|
|
11
|
-
*/
|
|
12
|
-
onUnmount?: (debouncer: PreactDebouncer<TFn, TSelected>) => void;
|
|
13
|
-
}
|
|
14
|
-
interface PreactDebouncer<TFn extends AnyFunction, TSelected = {}> extends Omit<Debouncer<TFn>, 'store'> {
|
|
15
|
-
/**
|
|
16
|
-
* A Preact HOC (Higher Order Component) that allows you to subscribe to the debouncer state.
|
|
17
|
-
*
|
|
18
|
-
* This is useful for opting into state re-renders for specific parts of the debouncer state
|
|
19
|
-
* deep in your component tree without needing to pass a selector to the hook.
|
|
20
|
-
*
|
|
21
|
-
* @example
|
|
22
|
-
* <debouncer.Subscribe selector={(state) => ({ isPending: state.isPending })}>
|
|
23
|
-
* {({ isPending }) => (
|
|
24
|
-
* <div>{isPending ? 'Loading...' : 'Ready'}</div>
|
|
25
|
-
* )}
|
|
26
|
-
* </debouncer.Subscribe>
|
|
27
|
-
*/
|
|
28
|
-
Subscribe: <TSelected>(props: {
|
|
29
|
-
selector: (state: DebouncerState<TFn>) => TSelected;
|
|
30
|
-
children: ((state: TSelected) => ComponentChildren) | ComponentChildren;
|
|
31
|
-
}) => ComponentChildren;
|
|
32
|
-
/**
|
|
33
|
-
* Reactive state that will be updated and re-rendered when the debouncer state changes
|
|
34
|
-
*
|
|
35
|
-
* Use this instead of `debouncer.store.state`
|
|
36
|
-
*/
|
|
37
|
-
readonly state: Readonly<TSelected>;
|
|
38
|
-
/**
|
|
39
|
-
* @deprecated Use `debouncer.state` instead of `debouncer.store.state` if you want to read reactive state.
|
|
40
|
-
* The state on the store object is not reactive, as it has not been wrapped in a `useSelector` hook internally.
|
|
41
|
-
* Although, you can make the state reactive by using the `useSelector` in your own usage.
|
|
42
|
-
*/
|
|
43
|
-
readonly store: Store<Readonly<DebouncerState<TFn>>>;
|
|
44
|
-
}
|
|
45
|
-
/**
|
|
46
|
-
* A Preact hook that creates and manages a Debouncer instance.
|
|
47
|
-
*
|
|
48
|
-
* This is a lower-level hook that provides direct access to the Debouncer's functionality without
|
|
49
|
-
* any built-in state management. This allows you to integrate it with any state management solution
|
|
50
|
-
* you prefer (useState, Redux, Zustand, etc.).
|
|
51
|
-
*
|
|
52
|
-
* This hook provides debouncing functionality to limit how often a function can be called,
|
|
53
|
-
* waiting for a specified delay before executing the latest call. This is useful for handling
|
|
54
|
-
* frequent events like window resizing, scroll events, or real-time search inputs.
|
|
55
|
-
*
|
|
56
|
-
* The debouncer will only execute the function after the specified wait time has elapsed
|
|
57
|
-
* since the last call. If the function is called again before the wait time expires, the
|
|
58
|
-
* timer resets and starts waiting again.
|
|
59
|
-
*
|
|
60
|
-
* ## State Management and Selector
|
|
61
|
-
*
|
|
62
|
-
* The hook uses TanStack Store for reactive state management. You can subscribe to state changes
|
|
63
|
-
* in two ways:
|
|
64
|
-
*
|
|
65
|
-
* **1. Using `debouncer.Subscribe` HOC (Recommended for component tree subscriptions)**
|
|
66
|
-
*
|
|
67
|
-
* Use the `Subscribe` HOC to subscribe to state changes deep in your component tree without
|
|
68
|
-
* needing to pass a selector to the hook. This is ideal when you want to subscribe to state
|
|
69
|
-
* in child components.
|
|
70
|
-
*
|
|
71
|
-
* **2. Using the `selector` parameter (For hook-level subscriptions)**
|
|
72
|
-
*
|
|
73
|
-
* The `selector` parameter allows you to specify which state changes will trigger a re-render
|
|
74
|
-
* at the hook level, optimizing performance by preventing unnecessary re-renders when irrelevant
|
|
75
|
-
* state changes occur.
|
|
76
|
-
*
|
|
77
|
-
* **By default, there will be no reactive state subscriptions** and you must opt-in to state
|
|
78
|
-
* tracking by providing a selector function or using the `Subscribe` HOC. This prevents unnecessary
|
|
79
|
-
* re-renders and gives you full control over when your component updates.
|
|
80
|
-
*
|
|
81
|
-
* Available state properties:
|
|
82
|
-
* - `canLeadingExecute`: Whether the debouncer can execute on the leading edge
|
|
83
|
-
* - `executionCount`: Number of function executions that have been completed
|
|
84
|
-
* - `isPending`: Whether the debouncer is waiting for the timeout to trigger execution
|
|
85
|
-
* - `lastArgs`: The arguments from the most recent call to maybeExecute
|
|
86
|
-
* - `status`: Current execution status ('disabled' | 'idle' | 'pending')
|
|
87
|
-
*
|
|
88
|
-
* ## Unmount behavior
|
|
89
|
-
*
|
|
90
|
-
* By default, the hook cancels any pending execution when the component unmounts.
|
|
91
|
-
* Use the `onUnmount` option to customize this. For example, to flush pending work instead:
|
|
92
|
-
*
|
|
93
|
-
* ```tsx
|
|
94
|
-
* const debouncer = useDebouncer(fn, {
|
|
95
|
-
* wait: 500,
|
|
96
|
-
* onUnmount: (d) => d.flush()
|
|
97
|
-
* });
|
|
98
|
-
* ```
|
|
99
|
-
*
|
|
100
|
-
* @example
|
|
101
|
-
* ```tsx
|
|
102
|
-
* // Default behavior - no reactive state subscriptions
|
|
103
|
-
* const searchDebouncer = useDebouncer(
|
|
104
|
-
* (query: string) => fetchSearchResults(query),
|
|
105
|
-
* { wait: 500 }
|
|
106
|
-
* );
|
|
107
|
-
*
|
|
108
|
-
* // Subscribe to state changes deep in component tree using Subscribe HOC
|
|
109
|
-
* <searchDebouncer.Subscribe selector={(state) => ({ isPending: state.isPending })}>
|
|
110
|
-
* {({ isPending }) => (
|
|
111
|
-
* <div>{isPending ? 'Searching...' : 'Ready'}</div>
|
|
112
|
-
* )}
|
|
113
|
-
* </searchDebouncer.Subscribe>
|
|
114
|
-
*
|
|
115
|
-
* // Opt-in to re-render when isPending changes at hook level (optimized for loading states)
|
|
116
|
-
* const searchDebouncer = useDebouncer(
|
|
117
|
-
* (query: string) => fetchSearchResults(query),
|
|
118
|
-
* { wait: 500 },
|
|
119
|
-
* (state) => ({ isPending: state.isPending })
|
|
120
|
-
* );
|
|
121
|
-
*
|
|
122
|
-
* // Opt-in to re-render when executionCount changes (optimized for tracking execution)
|
|
123
|
-
* const searchDebouncer = useDebouncer(
|
|
124
|
-
* (query: string) => fetchSearchResults(query),
|
|
125
|
-
* { wait: 500 },
|
|
126
|
-
* (state) => ({ executionCount: state.executionCount })
|
|
127
|
-
* );
|
|
128
|
-
*
|
|
129
|
-
* // Multiple state properties - re-render when any of these change
|
|
130
|
-
* const searchDebouncer = useDebouncer(
|
|
131
|
-
* (query: string) => fetchSearchResults(query),
|
|
132
|
-
* { wait: 500 },
|
|
133
|
-
* (state) => ({
|
|
134
|
-
* isPending: state.isPending,
|
|
135
|
-
* executionCount: state.executionCount,
|
|
136
|
-
* status: state.status
|
|
137
|
-
* })
|
|
138
|
-
* );
|
|
139
|
-
*
|
|
140
|
-
* // In an event handler
|
|
141
|
-
* const handleChange = (e) => {
|
|
142
|
-
* searchDebouncer.maybeExecute(e.target.value);
|
|
143
|
-
* };
|
|
144
|
-
*
|
|
145
|
-
* // Access the selected state (will be empty object {} unless selector provided)
|
|
146
|
-
* const { isPending } = searchDebouncer.state;
|
|
147
|
-
* ```
|
|
148
|
-
*/
|
|
149
|
-
declare function useDebouncer<TFn extends AnyFunction, TSelected = {}>(fn: TFn, options: PreactDebouncerOptions<TFn, TSelected>, selector?: (state: DebouncerState<TFn>) => TSelected): PreactDebouncer<TFn, TSelected>;
|
|
150
|
-
//#endregion
|
|
151
|
-
export { PreactDebouncer, PreactDebouncerOptions, useDebouncer };
|
|
152
|
-
//# sourceMappingURL=useDebouncer.d.cts.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"useDebouncer.js","names":[],"sources":["../../src/debouncer/useDebouncer.ts"],"sourcesContent":["import { useEffect, useMemo, useState } from 'preact/hooks'\nimport { Debouncer } from '@tanstack/pacer/debouncer'\nimport { shallow, useSelector } from '@tanstack/preact-store'\nimport { useDefaultPacerOptions } from '../provider/PacerProvider'\nimport type { Store } from '@tanstack/preact-store'\nimport type {\n DebouncerOptions,\n DebouncerState,\n} from '@tanstack/pacer/debouncer'\nimport type { AnyFunction } from '@tanstack/pacer/types'\nimport type { ComponentChildren } from 'preact'\n\nexport interface PreactDebouncerOptions<\n TFn extends AnyFunction,\n TSelected = {},\n> extends DebouncerOptions<TFn> {\n /**\n * Optional callback invoked when the component unmounts. Receives the debouncer instance.\n * When provided, replaces the default cleanup (cancel); use it to call flush(), reset(), cancel(), add logging, etc.\n */\n onUnmount?: (debouncer: PreactDebouncer<TFn, TSelected>) => void\n}\n\nexport interface PreactDebouncer<\n TFn extends AnyFunction,\n TSelected = {},\n> extends Omit<Debouncer<TFn>, 'store'> {\n /**\n * A Preact HOC (Higher Order Component) that allows you to subscribe to the debouncer state.\n *\n * This is useful for opting into state re-renders for specific parts of the debouncer state\n * deep in your component tree without needing to pass a selector to the hook.\n *\n * @example\n * <debouncer.Subscribe selector={(state) => ({ isPending: state.isPending })}>\n * {({ isPending }) => (\n * <div>{isPending ? 'Loading...' : 'Ready'}</div>\n * )}\n * </debouncer.Subscribe>\n */\n Subscribe: <TSelected>(props: {\n selector: (state: DebouncerState<TFn>) => TSelected\n children: ((state: TSelected) => ComponentChildren) | ComponentChildren\n }) => ComponentChildren\n /**\n * Reactive state that will be updated and re-rendered when the debouncer state changes\n *\n * Use this instead of `debouncer.store.state`\n */\n readonly state: Readonly<TSelected>\n /**\n * @deprecated Use `debouncer.state` instead of `debouncer.store.state` if you want to read reactive state.\n * The state on the store object is not reactive, as it has not been wrapped in a `useSelector` hook internally.\n * Although, you can make the state reactive by using the `useSelector` in your own usage.\n */\n readonly store: Store<Readonly<DebouncerState<TFn>>>\n}\n\n/**\n * A Preact hook that creates and manages a Debouncer instance.\n *\n * This is a lower-level hook that provides direct access to the Debouncer's functionality without\n * any built-in state management. This allows you to integrate it with any state management solution\n * you prefer (useState, Redux, Zustand, etc.).\n *\n * This hook provides debouncing functionality to limit how often a function can be called,\n * waiting for a specified delay before executing the latest call. This is useful for handling\n * frequent events like window resizing, scroll events, or real-time search inputs.\n *\n * The debouncer will only execute the function after the specified wait time has elapsed\n * since the last call. If the function is called again before the wait time expires, the\n * timer resets and starts waiting again.\n *\n * ## State Management and Selector\n *\n * The hook uses TanStack Store for reactive state management. You can subscribe to state changes\n * in two ways:\n *\n * **1. Using `debouncer.Subscribe` HOC (Recommended for component tree subscriptions)**\n *\n * Use the `Subscribe` HOC to subscribe to state changes deep in your component tree without\n * needing to pass a selector to the hook. This is ideal when you want to subscribe to state\n * in child components.\n *\n * **2. Using the `selector` parameter (For hook-level subscriptions)**\n *\n * The `selector` parameter allows you to specify which state changes will trigger a re-render\n * at the hook level, optimizing performance by preventing unnecessary re-renders when irrelevant\n * state changes occur.\n *\n * **By default, there will be no reactive state subscriptions** and you must opt-in to state\n * tracking by providing a selector function or using the `Subscribe` HOC. This prevents unnecessary\n * re-renders and gives you full control over when your component updates.\n *\n * Available state properties:\n * - `canLeadingExecute`: Whether the debouncer can execute on the leading edge\n * - `executionCount`: Number of function executions that have been completed\n * - `isPending`: Whether the debouncer is waiting for the timeout to trigger execution\n * - `lastArgs`: The arguments from the most recent call to maybeExecute\n * - `status`: Current execution status ('disabled' | 'idle' | 'pending')\n *\n * ## Unmount behavior\n *\n * By default, the hook cancels any pending execution when the component unmounts.\n * Use the `onUnmount` option to customize this. For example, to flush pending work instead:\n *\n * ```tsx\n * const debouncer = useDebouncer(fn, {\n * wait: 500,\n * onUnmount: (d) => d.flush()\n * });\n * ```\n *\n * @example\n * ```tsx\n * // Default behavior - no reactive state subscriptions\n * const searchDebouncer = useDebouncer(\n * (query: string) => fetchSearchResults(query),\n * { wait: 500 }\n * );\n *\n * // Subscribe to state changes deep in component tree using Subscribe HOC\n * <searchDebouncer.Subscribe selector={(state) => ({ isPending: state.isPending })}>\n * {({ isPending }) => (\n * <div>{isPending ? 'Searching...' : 'Ready'}</div>\n * )}\n * </searchDebouncer.Subscribe>\n *\n * // Opt-in to re-render when isPending changes at hook level (optimized for loading states)\n * const searchDebouncer = useDebouncer(\n * (query: string) => fetchSearchResults(query),\n * { wait: 500 },\n * (state) => ({ isPending: state.isPending })\n * );\n *\n * // Opt-in to re-render when executionCount changes (optimized for tracking execution)\n * const searchDebouncer = useDebouncer(\n * (query: string) => fetchSearchResults(query),\n * { wait: 500 },\n * (state) => ({ executionCount: state.executionCount })\n * );\n *\n * // Multiple state properties - re-render when any of these change\n * const searchDebouncer = useDebouncer(\n * (query: string) => fetchSearchResults(query),\n * { wait: 500 },\n * (state) => ({\n * isPending: state.isPending,\n * executionCount: state.executionCount,\n * status: state.status\n * })\n * );\n *\n * // In an event handler\n * const handleChange = (e) => {\n * searchDebouncer.maybeExecute(e.target.value);\n * };\n *\n * // Access the selected state (will be empty object {} unless selector provided)\n * const { isPending } = searchDebouncer.state;\n * ```\n */\nexport function useDebouncer<TFn extends AnyFunction, TSelected = {}>(\n fn: TFn,\n options: PreactDebouncerOptions<TFn, TSelected>,\n selector: (state: DebouncerState<TFn>) => TSelected = () => ({}) as TSelected,\n): PreactDebouncer<TFn, TSelected> {\n const mergedOptions = {\n ...useDefaultPacerOptions().debouncer,\n ...options,\n } as PreactDebouncerOptions<TFn, TSelected>\n const [debouncer] = useState(() => {\n const debouncerInstance = new Debouncer(\n fn,\n mergedOptions,\n ) as unknown as PreactDebouncer<TFn, TSelected>\n\n debouncerInstance.Subscribe = function Subscribe<TSelected>(props: {\n selector: (state: DebouncerState<TFn>) => TSelected\n children: ((state: TSelected) => ComponentChildren) | ComponentChildren\n }) {\n const selected = useSelector(debouncerInstance.store, props.selector, {\n compare: shallow,\n })\n\n return typeof props.children === 'function'\n ? props.children(selected)\n : props.children\n }\n\n return debouncerInstance\n })\n\n debouncer.fn = fn\n debouncer.setOptions(mergedOptions)\n\n /* eslint-disable react-hooks/exhaustive-deps -- cleanup only; runs on unmount */\n useEffect(() => {\n return () => {\n if (mergedOptions.onUnmount) {\n mergedOptions.onUnmount(debouncer)\n } else {\n debouncer.cancel()\n }\n }\n }, [])\n /* eslint-enable react-hooks/exhaustive-deps */\n\n const state = useSelector(debouncer.store, selector, { compare: shallow })\n\n return useMemo(\n () =>\n ({\n ...debouncer,\n state,\n }) as PreactDebouncer<TFn, TSelected>, // omit `store` in favor of `state`\n [debouncer, state],\n )\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAkKA,SAAgB,aACd,IACA,SACA,kBAA6D,EAAE,GAC9B;CACjC,MAAM,gBAAgB;EACpB,GAAG,wBAAwB,CAAC;EAC5B,GAAG;EACJ;CACD,MAAM,CAAC,aAAa,eAAe;EACjC,MAAM,oBAAoB,IAAI,UAC5B,IACA,cACD;EAED,kBAAkB,YAAY,SAAS,UAAqB,OAGzD;GACD,MAAM,WAAW,YAAY,kBAAkB,OAAO,MAAM,UAAU,EACpE,SAAS,SACV,CAAC;GAEF,OAAO,OAAO,MAAM,aAAa,aAC7B,MAAM,SAAS,SAAS,GACxB,MAAM;;EAGZ,OAAO;GACP;CAEF,UAAU,KAAK;CACf,UAAU,WAAW,cAAc;CAGnC,gBAAgB;EACd,aAAa;GACX,IAAI,cAAc,WAChB,cAAc,UAAU,UAAU;QAElC,UAAU,QAAQ;;IAGrB,EAAE,CAAC;CAGN,MAAM,QAAQ,YAAY,UAAU,OAAO,UAAU,EAAE,SAAS,SAAS,CAAC;CAE1E,OAAO,eAEF;EACC,GAAG;EACH;EACD,GACH,CAAC,WAAW,MAAM,CACnB"}
|
package/dist/index.cjs
DELETED
|
@@ -1,67 +0,0 @@
|
|
|
1
|
-
Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
|
|
2
|
-
const require_PacerProvider = require('./provider/PacerProvider.cjs');
|
|
3
|
-
const require_useAsyncBatcher = require('./async-batcher/useAsyncBatcher.cjs');
|
|
4
|
-
const require_useAsyncBatchedCallback = require('./async-batcher/useAsyncBatchedCallback.cjs');
|
|
5
|
-
const require_useAsyncDebouncer = require('./async-debouncer/useAsyncDebouncer.cjs');
|
|
6
|
-
const require_useAsyncDebouncedCallback = require('./async-debouncer/useAsyncDebouncedCallback.cjs');
|
|
7
|
-
const require_useAsyncQueuer = require('./async-queuer/useAsyncQueuer.cjs');
|
|
8
|
-
const require_useAsyncQueuedState = require('./async-queuer/useAsyncQueuedState.cjs');
|
|
9
|
-
const require_useAsyncRateLimiter = require('./async-rate-limiter/useAsyncRateLimiter.cjs');
|
|
10
|
-
const require_useAsyncRateLimitedCallback = require('./async-rate-limiter/useAsyncRateLimitedCallback.cjs');
|
|
11
|
-
const require_useAsyncThrottler = require('./async-throttler/useAsyncThrottler.cjs');
|
|
12
|
-
const require_useAsyncThrottledCallback = require('./async-throttler/useAsyncThrottledCallback.cjs');
|
|
13
|
-
const require_useBatcher = require('./batcher/useBatcher.cjs');
|
|
14
|
-
const require_useBatchedCallback = require('./batcher/useBatchedCallback.cjs');
|
|
15
|
-
const require_useDebouncer = require('./debouncer/useDebouncer.cjs');
|
|
16
|
-
const require_useDebouncedCallback = require('./debouncer/useDebouncedCallback.cjs');
|
|
17
|
-
const require_useDebouncedState = require('./debouncer/useDebouncedState.cjs');
|
|
18
|
-
const require_useDebouncedValue = require('./debouncer/useDebouncedValue.cjs');
|
|
19
|
-
const require_useQueuer = require('./queuer/useQueuer.cjs');
|
|
20
|
-
const require_useQueuedState = require('./queuer/useQueuedState.cjs');
|
|
21
|
-
const require_useQueuedValue = require('./queuer/useQueuedValue.cjs');
|
|
22
|
-
const require_useRateLimiter = require('./rate-limiter/useRateLimiter.cjs');
|
|
23
|
-
const require_useRateLimitedCallback = require('./rate-limiter/useRateLimitedCallback.cjs');
|
|
24
|
-
const require_useRateLimitedState = require('./rate-limiter/useRateLimitedState.cjs');
|
|
25
|
-
const require_useRateLimitedValue = require('./rate-limiter/useRateLimitedValue.cjs');
|
|
26
|
-
const require_useThrottler = require('./throttler/useThrottler.cjs');
|
|
27
|
-
const require_useThrottledCallback = require('./throttler/useThrottledCallback.cjs');
|
|
28
|
-
const require_useThrottledState = require('./throttler/useThrottledState.cjs');
|
|
29
|
-
const require_useThrottledValue = require('./throttler/useThrottledValue.cjs');
|
|
30
|
-
|
|
31
|
-
exports.PacerProvider = require_PacerProvider.PacerProvider;
|
|
32
|
-
exports.useAsyncBatchedCallback = require_useAsyncBatchedCallback.useAsyncBatchedCallback;
|
|
33
|
-
exports.useAsyncBatcher = require_useAsyncBatcher.useAsyncBatcher;
|
|
34
|
-
exports.useAsyncDebouncedCallback = require_useAsyncDebouncedCallback.useAsyncDebouncedCallback;
|
|
35
|
-
exports.useAsyncDebouncer = require_useAsyncDebouncer.useAsyncDebouncer;
|
|
36
|
-
exports.useAsyncQueuedState = require_useAsyncQueuedState.useAsyncQueuedState;
|
|
37
|
-
exports.useAsyncQueuer = require_useAsyncQueuer.useAsyncQueuer;
|
|
38
|
-
exports.useAsyncRateLimitedCallback = require_useAsyncRateLimitedCallback.useAsyncRateLimitedCallback;
|
|
39
|
-
exports.useAsyncRateLimiter = require_useAsyncRateLimiter.useAsyncRateLimiter;
|
|
40
|
-
exports.useAsyncThrottledCallback = require_useAsyncThrottledCallback.useAsyncThrottledCallback;
|
|
41
|
-
exports.useAsyncThrottler = require_useAsyncThrottler.useAsyncThrottler;
|
|
42
|
-
exports.useBatchedCallback = require_useBatchedCallback.useBatchedCallback;
|
|
43
|
-
exports.useBatcher = require_useBatcher.useBatcher;
|
|
44
|
-
exports.useDebouncedCallback = require_useDebouncedCallback.useDebouncedCallback;
|
|
45
|
-
exports.useDebouncedState = require_useDebouncedState.useDebouncedState;
|
|
46
|
-
exports.useDebouncedValue = require_useDebouncedValue.useDebouncedValue;
|
|
47
|
-
exports.useDebouncer = require_useDebouncer.useDebouncer;
|
|
48
|
-
exports.useDefaultPacerOptions = require_PacerProvider.useDefaultPacerOptions;
|
|
49
|
-
exports.usePacerContext = require_PacerProvider.usePacerContext;
|
|
50
|
-
exports.useQueuedState = require_useQueuedState.useQueuedState;
|
|
51
|
-
exports.useQueuedValue = require_useQueuedValue.useQueuedValue;
|
|
52
|
-
exports.useQueuer = require_useQueuer.useQueuer;
|
|
53
|
-
exports.useRateLimitedCallback = require_useRateLimitedCallback.useRateLimitedCallback;
|
|
54
|
-
exports.useRateLimitedState = require_useRateLimitedState.useRateLimitedState;
|
|
55
|
-
exports.useRateLimitedValue = require_useRateLimitedValue.useRateLimitedValue;
|
|
56
|
-
exports.useRateLimiter = require_useRateLimiter.useRateLimiter;
|
|
57
|
-
exports.useThrottledCallback = require_useThrottledCallback.useThrottledCallback;
|
|
58
|
-
exports.useThrottledState = require_useThrottledState.useThrottledState;
|
|
59
|
-
exports.useThrottledValue = require_useThrottledValue.useThrottledValue;
|
|
60
|
-
exports.useThrottler = require_useThrottler.useThrottler;
|
|
61
|
-
var _tanstack_pacer = require("@tanstack/pacer");
|
|
62
|
-
Object.keys(_tanstack_pacer).forEach(function (k) {
|
|
63
|
-
if (k !== 'default' && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
|
|
64
|
-
enumerable: true,
|
|
65
|
-
get: function () { return _tanstack_pacer[k]; }
|
|
66
|
-
});
|
|
67
|
-
});
|
package/dist/index.d.cts
DELETED
|
@@ -1,30 +0,0 @@
|
|
|
1
|
-
import { PreactAsyncBatcher, PreactAsyncBatcherOptions, useAsyncBatcher } from "./async-batcher/useAsyncBatcher.cjs";
|
|
2
|
-
import { useAsyncBatchedCallback } from "./async-batcher/useAsyncBatchedCallback.cjs";
|
|
3
|
-
import { PreactAsyncDebouncer, PreactAsyncDebouncerOptions, useAsyncDebouncer } from "./async-debouncer/useAsyncDebouncer.cjs";
|
|
4
|
-
import { useAsyncDebouncedCallback } from "./async-debouncer/useAsyncDebouncedCallback.cjs";
|
|
5
|
-
import { PreactAsyncQueuer, PreactAsyncQueuerOptions, useAsyncQueuer } from "./async-queuer/useAsyncQueuer.cjs";
|
|
6
|
-
import { useAsyncQueuedState } from "./async-queuer/useAsyncQueuedState.cjs";
|
|
7
|
-
import { PreactAsyncRateLimiter, PreactAsyncRateLimiterOptions, useAsyncRateLimiter } from "./async-rate-limiter/useAsyncRateLimiter.cjs";
|
|
8
|
-
import { useAsyncRateLimitedCallback } from "./async-rate-limiter/useAsyncRateLimitedCallback.cjs";
|
|
9
|
-
import { PreactAsyncThrottler, PreactAsyncThrottlerOptions, useAsyncThrottler } from "./async-throttler/useAsyncThrottler.cjs";
|
|
10
|
-
import { useAsyncThrottledCallback } from "./async-throttler/useAsyncThrottledCallback.cjs";
|
|
11
|
-
import { PreactBatcher, PreactBatcherOptions, useBatcher } from "./batcher/useBatcher.cjs";
|
|
12
|
-
import { useBatchedCallback } from "./batcher/useBatchedCallback.cjs";
|
|
13
|
-
import { PreactDebouncer, PreactDebouncerOptions, useDebouncer } from "./debouncer/useDebouncer.cjs";
|
|
14
|
-
import { useDebouncedCallback } from "./debouncer/useDebouncedCallback.cjs";
|
|
15
|
-
import { useDebouncedState } from "./debouncer/useDebouncedState.cjs";
|
|
16
|
-
import { useDebouncedValue } from "./debouncer/useDebouncedValue.cjs";
|
|
17
|
-
import { PacerProvider, PacerProviderOptions, PacerProviderProps, useDefaultPacerOptions, usePacerContext } from "./provider/PacerProvider.cjs";
|
|
18
|
-
import { PreactQueuer, PreactQueuerOptions, useQueuer } from "./queuer/useQueuer.cjs";
|
|
19
|
-
import { useQueuedState } from "./queuer/useQueuedState.cjs";
|
|
20
|
-
import { useQueuedValue } from "./queuer/useQueuedValue.cjs";
|
|
21
|
-
import { PreactRateLimiter, PreactRateLimiterOptions, useRateLimiter } from "./rate-limiter/useRateLimiter.cjs";
|
|
22
|
-
import { useRateLimitedCallback } from "./rate-limiter/useRateLimitedCallback.cjs";
|
|
23
|
-
import { useRateLimitedState } from "./rate-limiter/useRateLimitedState.cjs";
|
|
24
|
-
import { useRateLimitedValue } from "./rate-limiter/useRateLimitedValue.cjs";
|
|
25
|
-
import { PreactThrottler, PreactThrottlerOptions, useThrottler } from "./throttler/useThrottler.cjs";
|
|
26
|
-
import { useThrottledCallback } from "./throttler/useThrottledCallback.cjs";
|
|
27
|
-
import { useThrottledState } from "./throttler/useThrottledState.cjs";
|
|
28
|
-
import { useThrottledValue } from "./throttler/useThrottledValue.cjs";
|
|
29
|
-
export * from "@tanstack/pacer";
|
|
30
|
-
export { PacerProvider, PacerProviderOptions, PacerProviderProps, PreactAsyncBatcher, PreactAsyncBatcherOptions, PreactAsyncDebouncer, PreactAsyncDebouncerOptions, PreactAsyncQueuer, PreactAsyncQueuerOptions, PreactAsyncRateLimiter, PreactAsyncRateLimiterOptions, PreactAsyncThrottler, PreactAsyncThrottlerOptions, PreactBatcher, PreactBatcherOptions, PreactDebouncer, PreactDebouncerOptions, PreactQueuer, PreactQueuerOptions, PreactRateLimiter, PreactRateLimiterOptions, PreactThrottler, PreactThrottlerOptions, useAsyncBatchedCallback, useAsyncBatcher, useAsyncDebouncedCallback, useAsyncDebouncer, useAsyncQueuedState, useAsyncQueuer, useAsyncRateLimitedCallback, useAsyncRateLimiter, useAsyncThrottledCallback, useAsyncThrottler, useBatchedCallback, useBatcher, useDebouncedCallback, useDebouncedState, useDebouncedValue, useDebouncer, useDefaultPacerOptions, usePacerContext, useQueuedState, useQueuedValue, useQueuer, useRateLimitedCallback, useRateLimitedState, useRateLimitedValue, useRateLimiter, useThrottledCallback, useThrottledState, useThrottledValue, useThrottler };
|
|
@@ -1,26 +0,0 @@
|
|
|
1
|
-
let preact_hooks = require("preact/hooks");
|
|
2
|
-
let preact = require("preact");
|
|
3
|
-
let preact_jsx_runtime = require("preact/jsx-runtime");
|
|
4
|
-
|
|
5
|
-
//#region src/provider/PacerProvider.tsx
|
|
6
|
-
const PacerContext = (0, preact.createContext)(null);
|
|
7
|
-
const DEFAULT_OPTIONS = {};
|
|
8
|
-
function PacerProvider({ children, defaultOptions = DEFAULT_OPTIONS }) {
|
|
9
|
-
const contextValue = (0, preact_hooks.useMemo)(() => ({ defaultOptions }), [defaultOptions]);
|
|
10
|
-
return /* @__PURE__ */ (0, preact_jsx_runtime.jsx)(PacerContext.Provider, {
|
|
11
|
-
value: contextValue,
|
|
12
|
-
children
|
|
13
|
-
});
|
|
14
|
-
}
|
|
15
|
-
function usePacerContext() {
|
|
16
|
-
return (0, preact_hooks.useContext)(PacerContext);
|
|
17
|
-
}
|
|
18
|
-
function useDefaultPacerOptions() {
|
|
19
|
-
return (0, preact_hooks.useContext)(PacerContext)?.defaultOptions ?? {};
|
|
20
|
-
}
|
|
21
|
-
|
|
22
|
-
//#endregion
|
|
23
|
-
exports.PacerProvider = PacerProvider;
|
|
24
|
-
exports.useDefaultPacerOptions = useDefaultPacerOptions;
|
|
25
|
-
exports.usePacerContext = usePacerContext;
|
|
26
|
-
//# sourceMappingURL=PacerProvider.cjs.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"PacerProvider.cjs","names":[],"sources":["../../src/provider/PacerProvider.tsx"],"sourcesContent":["import { useContext, useMemo } from 'preact/hooks'\nimport { createContext } from 'preact'\nimport type { ComponentChildren } from 'preact'\nimport type {\n AnyAsyncFunction,\n AnyFunction,\n AsyncBatcherOptions,\n AsyncDebouncerOptions,\n AsyncQueuerOptions,\n AsyncRateLimiterOptions,\n AsyncThrottlerOptions,\n BatcherOptions,\n DebouncerOptions,\n QueuerOptions,\n RateLimiterOptions,\n ThrottlerOptions,\n} from '@tanstack/pacer'\n\nexport interface PacerProviderOptions {\n asyncBatcher?: Partial<AsyncBatcherOptions<any>>\n asyncDebouncer?: Partial<AsyncDebouncerOptions<AnyAsyncFunction>>\n asyncQueuer?: Partial<AsyncQueuerOptions<any>>\n asyncRateLimiter?: Partial<AsyncRateLimiterOptions<AnyAsyncFunction>>\n asyncThrottler?: Partial<AsyncThrottlerOptions<AnyAsyncFunction>>\n batcher?: Partial<BatcherOptions<any>>\n debouncer?: Partial<DebouncerOptions<AnyFunction>>\n queuer?: Partial<QueuerOptions<any>>\n rateLimiter?: Partial<RateLimiterOptions<AnyFunction>>\n throttler?: Partial<ThrottlerOptions<AnyFunction>>\n}\n\ninterface PacerContextValue {\n defaultOptions: PacerProviderOptions\n}\n\nconst PacerContext = createContext<PacerContextValue | null>(null)\n\nexport interface PacerProviderProps {\n children: ComponentChildren\n defaultOptions?: PacerProviderOptions\n}\n\nconst DEFAULT_OPTIONS: PacerProviderOptions = {}\n\nexport function PacerProvider({\n children,\n defaultOptions = DEFAULT_OPTIONS,\n}: PacerProviderProps) {\n const contextValue: PacerContextValue = useMemo(\n () => ({\n defaultOptions,\n }),\n [defaultOptions],\n )\n\n return (\n <PacerContext.Provider value={contextValue}>\n {children}\n </PacerContext.Provider>\n )\n}\n\nexport function usePacerContext() {\n return useContext(PacerContext)\n}\n\nexport function useDefaultPacerOptions() {\n const context = useContext(PacerContext)\n return context?.defaultOptions ?? {}\n}\n"],"mappings":";;;;;AAmCA,MAAM,yCAAuD,KAAK;AAOlE,MAAM,kBAAwC,EAAE;AAEhD,SAAgB,cAAc,EAC5B,UACA,iBAAiB,mBACI;CACrB,MAAM,gDACG,EACL,gBACD,GACD,CAAC,eAAe,CACjB;CAED,OACE,4CAAC,aAAa,UAAd;EAAuB,OAAO;EAC3B;EACqB;;AAI5B,SAAgB,kBAAkB;CAChC,oCAAkB,aAAa;;AAGjC,SAAgB,yBAAyB;CAEvC,oCAD2B,aACb,EAAE,kBAAkB,EAAE"}
|
|
@@ -1,33 +0,0 @@
|
|
|
1
|
-
import * as _$preact from "preact";
|
|
2
|
-
import { ComponentChildren } from "preact";
|
|
3
|
-
import { AnyAsyncFunction, AnyFunction, AsyncBatcherOptions, AsyncDebouncerOptions, AsyncQueuerOptions, AsyncRateLimiterOptions, AsyncThrottlerOptions, BatcherOptions, DebouncerOptions, QueuerOptions, RateLimiterOptions, ThrottlerOptions } from "@tanstack/pacer";
|
|
4
|
-
|
|
5
|
-
//#region src/provider/PacerProvider.d.ts
|
|
6
|
-
interface PacerProviderOptions {
|
|
7
|
-
asyncBatcher?: Partial<AsyncBatcherOptions<any>>;
|
|
8
|
-
asyncDebouncer?: Partial<AsyncDebouncerOptions<AnyAsyncFunction>>;
|
|
9
|
-
asyncQueuer?: Partial<AsyncQueuerOptions<any>>;
|
|
10
|
-
asyncRateLimiter?: Partial<AsyncRateLimiterOptions<AnyAsyncFunction>>;
|
|
11
|
-
asyncThrottler?: Partial<AsyncThrottlerOptions<AnyAsyncFunction>>;
|
|
12
|
-
batcher?: Partial<BatcherOptions<any>>;
|
|
13
|
-
debouncer?: Partial<DebouncerOptions<AnyFunction>>;
|
|
14
|
-
queuer?: Partial<QueuerOptions<any>>;
|
|
15
|
-
rateLimiter?: Partial<RateLimiterOptions<AnyFunction>>;
|
|
16
|
-
throttler?: Partial<ThrottlerOptions<AnyFunction>>;
|
|
17
|
-
}
|
|
18
|
-
interface PacerContextValue {
|
|
19
|
-
defaultOptions: PacerProviderOptions;
|
|
20
|
-
}
|
|
21
|
-
interface PacerProviderProps {
|
|
22
|
-
children: ComponentChildren;
|
|
23
|
-
defaultOptions?: PacerProviderOptions;
|
|
24
|
-
}
|
|
25
|
-
declare function PacerProvider({
|
|
26
|
-
children,
|
|
27
|
-
defaultOptions
|
|
28
|
-
}: PacerProviderProps): _$preact.JSX.Element;
|
|
29
|
-
declare function usePacerContext(): PacerContextValue | null;
|
|
30
|
-
declare function useDefaultPacerOptions(): PacerProviderOptions;
|
|
31
|
-
//#endregion
|
|
32
|
-
export { PacerProvider, PacerProviderOptions, PacerProviderProps, useDefaultPacerOptions, usePacerContext };
|
|
33
|
-
//# sourceMappingURL=PacerProvider.d.cts.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"PacerProvider.js","names":[],"sources":["../../src/provider/PacerProvider.tsx"],"sourcesContent":["import { useContext, useMemo } from 'preact/hooks'\nimport { createContext } from 'preact'\nimport type { ComponentChildren } from 'preact'\nimport type {\n AnyAsyncFunction,\n AnyFunction,\n AsyncBatcherOptions,\n AsyncDebouncerOptions,\n AsyncQueuerOptions,\n AsyncRateLimiterOptions,\n AsyncThrottlerOptions,\n BatcherOptions,\n DebouncerOptions,\n QueuerOptions,\n RateLimiterOptions,\n ThrottlerOptions,\n} from '@tanstack/pacer'\n\nexport interface PacerProviderOptions {\n asyncBatcher?: Partial<AsyncBatcherOptions<any>>\n asyncDebouncer?: Partial<AsyncDebouncerOptions<AnyAsyncFunction>>\n asyncQueuer?: Partial<AsyncQueuerOptions<any>>\n asyncRateLimiter?: Partial<AsyncRateLimiterOptions<AnyAsyncFunction>>\n asyncThrottler?: Partial<AsyncThrottlerOptions<AnyAsyncFunction>>\n batcher?: Partial<BatcherOptions<any>>\n debouncer?: Partial<DebouncerOptions<AnyFunction>>\n queuer?: Partial<QueuerOptions<any>>\n rateLimiter?: Partial<RateLimiterOptions<AnyFunction>>\n throttler?: Partial<ThrottlerOptions<AnyFunction>>\n}\n\ninterface PacerContextValue {\n defaultOptions: PacerProviderOptions\n}\n\nconst PacerContext = createContext<PacerContextValue | null>(null)\n\nexport interface PacerProviderProps {\n children: ComponentChildren\n defaultOptions?: PacerProviderOptions\n}\n\nconst DEFAULT_OPTIONS: PacerProviderOptions = {}\n\nexport function PacerProvider({\n children,\n defaultOptions = DEFAULT_OPTIONS,\n}: PacerProviderProps) {\n const contextValue: PacerContextValue = useMemo(\n () => ({\n defaultOptions,\n }),\n [defaultOptions],\n )\n\n return (\n <PacerContext.Provider value={contextValue}>\n {children}\n </PacerContext.Provider>\n )\n}\n\nexport function usePacerContext() {\n return useContext(PacerContext)\n}\n\nexport function useDefaultPacerOptions() {\n const context = useContext(PacerContext)\n return context?.defaultOptions ?? {}\n}\n"],"mappings":";;;;;AAmCA,MAAM,eAAe,cAAwC,KAAK;AAOlE,MAAM,kBAAwC,EAAE;AAEhD,SAAgB,cAAc,EAC5B,UACA,iBAAiB,mBACI;CACrB,MAAM,eAAkC,eAC/B,EACL,gBACD,GACD,CAAC,eAAe,CACjB;CAED,OACE,oBAAC,aAAa,UAAd;EAAuB,OAAO;EAC3B;EACqB;;AAI5B,SAAgB,kBAAkB;CAChC,OAAO,WAAW,aAAa;;AAGjC,SAAgB,yBAAyB;CAEvC,OADgB,WAAW,aACb,EAAE,kBAAkB,EAAE"}
|
package/dist/provider/index.cjs
DELETED
|
@@ -1,6 +0,0 @@
|
|
|
1
|
-
Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
|
|
2
|
-
const require_PacerProvider = require('./PacerProvider.cjs');
|
|
3
|
-
|
|
4
|
-
exports.PacerProvider = require_PacerProvider.PacerProvider;
|
|
5
|
-
exports.useDefaultPacerOptions = require_PacerProvider.useDefaultPacerOptions;
|
|
6
|
-
exports.usePacerContext = require_PacerProvider.usePacerContext;
|