@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.
Files changed (243) hide show
  1. package/README.md +17 -2
  2. package/dist/async-batcher/useAsyncBatchedCallback.d.ts +2 -5
  3. package/dist/async-batcher/useAsyncBatchedCallback.js +1 -2
  4. package/dist/async-batcher/useAsyncBatcher.d.ts +4 -8
  5. package/dist/async-batcher/useAsyncBatcher.js +1 -3
  6. package/dist/async-debouncer/useAsyncDebouncedCallback.d.ts +6 -7
  7. package/dist/async-debouncer/useAsyncDebouncedCallback.js +5 -4
  8. package/dist/async-debouncer/useAsyncDebouncer.d.ts +4 -7
  9. package/dist/async-debouncer/useAsyncDebouncer.js +1 -2
  10. package/dist/async-queuer/useAsyncQueuedState.d.ts +4 -7
  11. package/dist/async-queuer/useAsyncQueuedState.js +3 -4
  12. package/dist/async-queuer/useAsyncQueuer.d.ts +6 -9
  13. package/dist/async-queuer/useAsyncQueuer.js +3 -4
  14. package/dist/async-rate-limiter/useAsyncRateLimitedCallback.d.ts +2 -5
  15. package/dist/async-rate-limiter/useAsyncRateLimitedCallback.js +1 -2
  16. package/dist/async-rate-limiter/useAsyncRateLimiter.d.ts +4 -7
  17. package/dist/async-rate-limiter/useAsyncRateLimiter.js +1 -2
  18. package/dist/async-throttler/useAsyncThrottledCallback.d.ts +7 -9
  19. package/dist/async-throttler/useAsyncThrottledCallback.js +6 -6
  20. package/dist/async-throttler/useAsyncThrottler.d.ts +4 -7
  21. package/dist/async-throttler/useAsyncThrottler.js +1 -2
  22. package/dist/batcher/useBatchedCallback.d.ts +2 -5
  23. package/dist/batcher/useBatchedCallback.js +1 -2
  24. package/dist/batcher/useBatcher.d.ts +6 -11
  25. package/dist/batcher/useBatcher.js +3 -6
  26. package/dist/debouncer/useDebouncedCallback.d.ts +2 -5
  27. package/dist/debouncer/useDebouncedCallback.js +1 -2
  28. package/dist/debouncer/useDebouncedState.d.ts +2 -5
  29. package/dist/debouncer/useDebouncedState.js +1 -2
  30. package/dist/debouncer/useDebouncedValue.d.ts +2 -5
  31. package/dist/debouncer/useDebouncedValue.js +1 -2
  32. package/dist/debouncer/useDebouncer.d.ts +4 -7
  33. package/dist/debouncer/useDebouncer.js +1 -2
  34. package/dist/provider/PacerProvider.d.ts +6 -13
  35. package/dist/provider/PacerProvider.js +1 -2
  36. package/dist/queuer/useQueuedState.d.ts +2 -5
  37. package/dist/queuer/useQueuedState.js +1 -2
  38. package/dist/queuer/useQueuedValue.d.ts +2 -5
  39. package/dist/queuer/useQueuedValue.js +1 -2
  40. package/dist/queuer/useQueuer.d.ts +4 -7
  41. package/dist/queuer/useQueuer.js +1 -2
  42. package/dist/rate-limiter/useRateLimitedCallback.d.ts +2 -5
  43. package/dist/rate-limiter/useRateLimitedCallback.js +1 -2
  44. package/dist/rate-limiter/useRateLimitedState.d.ts +2 -5
  45. package/dist/rate-limiter/useRateLimitedState.js +1 -2
  46. package/dist/rate-limiter/useRateLimitedValue.d.ts +2 -5
  47. package/dist/rate-limiter/useRateLimitedValue.js +1 -2
  48. package/dist/rate-limiter/useRateLimiter.d.ts +4 -7
  49. package/dist/rate-limiter/useRateLimiter.js +1 -2
  50. package/dist/throttler/useThrottledCallback.d.ts +2 -5
  51. package/dist/throttler/useThrottledCallback.js +1 -2
  52. package/dist/throttler/useThrottledState.d.ts +2 -5
  53. package/dist/throttler/useThrottledState.js +1 -2
  54. package/dist/throttler/useThrottledValue.d.ts +2 -5
  55. package/dist/throttler/useThrottledValue.js +1 -2
  56. package/dist/throttler/useThrottler.d.ts +4 -7
  57. package/dist/throttler/useThrottler.js +1 -2
  58. package/package.json +24 -72
  59. package/dist/async-batcher/index.cjs +0 -13
  60. package/dist/async-batcher/index.d.cts +0 -4
  61. package/dist/async-batcher/useAsyncBatchedCallback.cjs +0 -51
  62. package/dist/async-batcher/useAsyncBatchedCallback.cjs.map +0 -1
  63. package/dist/async-batcher/useAsyncBatchedCallback.d.cts +0 -44
  64. package/dist/async-batcher/useAsyncBatchedCallback.js.map +0 -1
  65. package/dist/async-batcher/useAsyncBatcher.cjs +0 -217
  66. package/dist/async-batcher/useAsyncBatcher.cjs.map +0 -1
  67. package/dist/async-batcher/useAsyncBatcher.d.cts +0 -224
  68. package/dist/async-batcher/useAsyncBatcher.js.map +0 -1
  69. package/dist/async-debouncer/index.cjs +0 -13
  70. package/dist/async-debouncer/index.d.cts +0 -4
  71. package/dist/async-debouncer/useAsyncDebouncedCallback.cjs +0 -50
  72. package/dist/async-debouncer/useAsyncDebouncedCallback.cjs.map +0 -1
  73. package/dist/async-debouncer/useAsyncDebouncedCallback.d.cts +0 -46
  74. package/dist/async-debouncer/useAsyncDebouncedCallback.js.map +0 -1
  75. package/dist/async-debouncer/useAsyncDebouncer.cjs +0 -195
  76. package/dist/async-debouncer/useAsyncDebouncer.cjs.map +0 -1
  77. package/dist/async-debouncer/useAsyncDebouncer.d.cts +0 -203
  78. package/dist/async-debouncer/useAsyncDebouncer.js.map +0 -1
  79. package/dist/async-queuer/index.cjs +0 -13
  80. package/dist/async-queuer/index.d.cts +0 -4
  81. package/dist/async-queuer/useAsyncQueuedState.cjs +0 -154
  82. package/dist/async-queuer/useAsyncQueuedState.cjs.map +0 -1
  83. package/dist/async-queuer/useAsyncQueuedState.d.cts +0 -151
  84. package/dist/async-queuer/useAsyncQueuedState.js.map +0 -1
  85. package/dist/async-queuer/useAsyncQueuer.cjs +0 -217
  86. package/dist/async-queuer/useAsyncQueuer.cjs.map +0 -1
  87. package/dist/async-queuer/useAsyncQueuer.d.cts +0 -224
  88. package/dist/async-queuer/useAsyncQueuer.js.map +0 -1
  89. package/dist/async-rate-limiter/index.cjs +0 -13
  90. package/dist/async-rate-limiter/index.d.cts +0 -4
  91. package/dist/async-rate-limiter/useAsyncRateLimitedCallback.cjs +0 -65
  92. package/dist/async-rate-limiter/useAsyncRateLimitedCallback.cjs.map +0 -1
  93. package/dist/async-rate-limiter/useAsyncRateLimitedCallback.d.cts +0 -61
  94. package/dist/async-rate-limiter/useAsyncRateLimitedCallback.js.map +0 -1
  95. package/dist/async-rate-limiter/useAsyncRateLimiter.cjs +0 -209
  96. package/dist/async-rate-limiter/useAsyncRateLimiter.cjs.map +0 -1
  97. package/dist/async-rate-limiter/useAsyncRateLimiter.d.cts +0 -220
  98. package/dist/async-rate-limiter/useAsyncRateLimiter.js.map +0 -1
  99. package/dist/async-retryer/index.cjs +0 -9
  100. package/dist/async-retryer/index.d.cts +0 -1
  101. package/dist/async-throttler/index.cjs +0 -13
  102. package/dist/async-throttler/index.d.cts +0 -4
  103. package/dist/async-throttler/useAsyncThrottledCallback.cjs +0 -48
  104. package/dist/async-throttler/useAsyncThrottledCallback.cjs.map +0 -1
  105. package/dist/async-throttler/useAsyncThrottledCallback.d.cts +0 -44
  106. package/dist/async-throttler/useAsyncThrottledCallback.js.map +0 -1
  107. package/dist/async-throttler/useAsyncThrottler.cjs +0 -206
  108. package/dist/async-throttler/useAsyncThrottler.cjs.map +0 -1
  109. package/dist/async-throttler/useAsyncThrottler.d.cts +0 -214
  110. package/dist/async-throttler/useAsyncThrottler.js.map +0 -1
  111. package/dist/batcher/index.cjs +0 -13
  112. package/dist/batcher/index.d.cts +0 -4
  113. package/dist/batcher/useBatchedCallback.cjs +0 -47
  114. package/dist/batcher/useBatchedCallback.cjs.map +0 -1
  115. package/dist/batcher/useBatchedCallback.d.cts +0 -42
  116. package/dist/batcher/useBatchedCallback.js.map +0 -1
  117. package/dist/batcher/useBatcher.cjs +0 -165
  118. package/dist/batcher/useBatcher.cjs.map +0 -1
  119. package/dist/batcher/useBatcher.d.cts +0 -175
  120. package/dist/batcher/useBatcher.js.map +0 -1
  121. package/dist/debouncer/index.cjs +0 -17
  122. package/dist/debouncer/index.d.cts +0 -6
  123. package/dist/debouncer/useDebouncedCallback.cjs +0 -48
  124. package/dist/debouncer/useDebouncedCallback.cjs.map +0 -1
  125. package/dist/debouncer/useDebouncedCallback.d.cts +0 -44
  126. package/dist/debouncer/useDebouncedCallback.js.map +0 -1
  127. package/dist/debouncer/useDebouncedState.cjs +0 -89
  128. package/dist/debouncer/useDebouncedState.cjs.map +0 -1
  129. package/dist/debouncer/useDebouncedState.d.cts +0 -81
  130. package/dist/debouncer/useDebouncedState.js.map +0 -1
  131. package/dist/debouncer/useDebouncedValue.cjs +0 -96
  132. package/dist/debouncer/useDebouncedValue.cjs.map +0 -1
  133. package/dist/debouncer/useDebouncedValue.d.cts +0 -90
  134. package/dist/debouncer/useDebouncedValue.js.map +0 -1
  135. package/dist/debouncer/useDebouncer.cjs +0 -141
  136. package/dist/debouncer/useDebouncer.cjs.map +0 -1
  137. package/dist/debouncer/useDebouncer.d.cts +0 -152
  138. package/dist/debouncer/useDebouncer.js.map +0 -1
  139. package/dist/index.cjs +0 -67
  140. package/dist/index.d.cts +0 -30
  141. package/dist/provider/PacerProvider.cjs +0 -26
  142. package/dist/provider/PacerProvider.cjs.map +0 -1
  143. package/dist/provider/PacerProvider.d.cts +0 -33
  144. package/dist/provider/PacerProvider.js.map +0 -1
  145. package/dist/provider/index.cjs +0 -6
  146. package/dist/provider/index.d.cts +0 -2
  147. package/dist/queuer/index.cjs +0 -15
  148. package/dist/queuer/index.d.cts +0 -5
  149. package/dist/queuer/useQueuedState.cjs +0 -129
  150. package/dist/queuer/useQueuedState.cjs.map +0 -1
  151. package/dist/queuer/useQueuedState.d.cts +0 -122
  152. package/dist/queuer/useQueuedState.js.map +0 -1
  153. package/dist/queuer/useQueuedValue.cjs +0 -115
  154. package/dist/queuer/useQueuedValue.cjs.map +0 -1
  155. package/dist/queuer/useQueuedValue.d.cts +0 -105
  156. package/dist/queuer/useQueuedValue.js.map +0 -1
  157. package/dist/queuer/useQueuer.cjs +0 -176
  158. package/dist/queuer/useQueuer.cjs.map +0 -1
  159. package/dist/queuer/useQueuer.d.cts +0 -186
  160. package/dist/queuer/useQueuer.js.map +0 -1
  161. package/dist/rate-limiter/index.cjs +0 -17
  162. package/dist/rate-limiter/index.d.cts +0 -6
  163. package/dist/rate-limiter/useRateLimitedCallback.cjs +0 -65
  164. package/dist/rate-limiter/useRateLimitedCallback.cjs.map +0 -1
  165. package/dist/rate-limiter/useRateLimitedCallback.d.cts +0 -61
  166. package/dist/rate-limiter/useRateLimitedCallback.js.map +0 -1
  167. package/dist/rate-limiter/useRateLimitedState.cjs +0 -115
  168. package/dist/rate-limiter/useRateLimitedState.cjs.map +0 -1
  169. package/dist/rate-limiter/useRateLimitedState.d.cts +0 -107
  170. package/dist/rate-limiter/useRateLimitedState.js.map +0 -1
  171. package/dist/rate-limiter/useRateLimitedValue.cjs +0 -102
  172. package/dist/rate-limiter/useRateLimitedValue.cjs.map +0 -1
  173. package/dist/rate-limiter/useRateLimitedValue.d.cts +0 -96
  174. package/dist/rate-limiter/useRateLimitedValue.js.map +0 -1
  175. package/dist/rate-limiter/useRateLimiter.cjs +0 -167
  176. package/dist/rate-limiter/useRateLimiter.cjs.map +0 -1
  177. package/dist/rate-limiter/useRateLimiter.d.cts +0 -179
  178. package/dist/rate-limiter/useRateLimiter.js.map +0 -1
  179. package/dist/throttler/index.cjs +0 -17
  180. package/dist/throttler/index.d.cts +0 -6
  181. package/dist/throttler/useThrottledCallback.cjs +0 -49
  182. package/dist/throttler/useThrottledCallback.cjs.map +0 -1
  183. package/dist/throttler/useThrottledCallback.d.cts +0 -45
  184. package/dist/throttler/useThrottledCallback.js.map +0 -1
  185. package/dist/throttler/useThrottledState.cjs +0 -100
  186. package/dist/throttler/useThrottledState.cjs.map +0 -1
  187. package/dist/throttler/useThrottledState.d.cts +0 -92
  188. package/dist/throttler/useThrottledState.js.map +0 -1
  189. package/dist/throttler/useThrottledValue.cjs +0 -91
  190. package/dist/throttler/useThrottledValue.cjs.map +0 -1
  191. package/dist/throttler/useThrottledValue.d.cts +0 -85
  192. package/dist/throttler/useThrottledValue.js.map +0 -1
  193. package/dist/throttler/useThrottler.cjs +0 -146
  194. package/dist/throttler/useThrottler.cjs.map +0 -1
  195. package/dist/throttler/useThrottler.d.cts +0 -157
  196. package/dist/throttler/useThrottler.js.map +0 -1
  197. package/dist/types/index.cjs +0 -9
  198. package/dist/types/index.d.cts +0 -1
  199. package/dist/utils/index.cjs +0 -9
  200. package/dist/utils/index.d.cts +0 -1
  201. package/src/async-batcher/index.ts +0 -4
  202. package/src/async-batcher/useAsyncBatchedCallback.ts +0 -53
  203. package/src/async-batcher/useAsyncBatcher.ts +0 -293
  204. package/src/async-debouncer/index.ts +0 -5
  205. package/src/async-debouncer/useAsyncDebouncedCallback.ts +0 -54
  206. package/src/async-debouncer/useAsyncDebouncer.ts +0 -274
  207. package/src/async-queuer/index.ts +0 -4
  208. package/src/async-queuer/useAsyncQueuedState.ts +0 -165
  209. package/src/async-queuer/useAsyncQueuer.ts +0 -293
  210. package/src/async-rate-limiter/index.ts +0 -5
  211. package/src/async-rate-limiter/useAsyncRateLimitedCallback.ts +0 -69
  212. package/src/async-rate-limiter/useAsyncRateLimiter.ts +0 -294
  213. package/src/async-retryer/index.ts +0 -2
  214. package/src/async-throttler/index.ts +0 -5
  215. package/src/async-throttler/useAsyncThrottledCallback.ts +0 -52
  216. package/src/async-throttler/useAsyncThrottler.ts +0 -285
  217. package/src/batcher/index.ts +0 -4
  218. package/src/batcher/useBatchedCallback.ts +0 -46
  219. package/src/batcher/useBatcher.ts +0 -241
  220. package/src/debouncer/index.ts +0 -7
  221. package/src/debouncer/useDebouncedCallback.ts +0 -51
  222. package/src/debouncer/useDebouncedState.ts +0 -106
  223. package/src/debouncer/useDebouncedValue.ts +0 -109
  224. package/src/debouncer/useDebouncer.ts +0 -219
  225. package/src/index.ts +0 -56
  226. package/src/provider/PacerProvider.tsx +0 -70
  227. package/src/provider/index.ts +0 -1
  228. package/src/queuer/index.ts +0 -5
  229. package/src/queuer/useQueuedState.ts +0 -133
  230. package/src/queuer/useQueuedValue.ts +0 -129
  231. package/src/queuer/useQueuer.ts +0 -251
  232. package/src/rate-limiter/index.ts +0 -6
  233. package/src/rate-limiter/useRateLimitedCallback.ts +0 -68
  234. package/src/rate-limiter/useRateLimitedState.ts +0 -124
  235. package/src/rate-limiter/useRateLimitedValue.ts +0 -110
  236. package/src/rate-limiter/useRateLimiter.ts +0 -244
  237. package/src/throttler/index.ts +0 -7
  238. package/src/throttler/useThrottledCallback.ts +0 -52
  239. package/src/throttler/useThrottledState.ts +0 -118
  240. package/src/throttler/useThrottledValue.ts +0 -104
  241. package/src/throttler/useThrottler.ts +0 -224
  242. package/src/types/index.ts +0 -1
  243. 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"}
@@ -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;
@@ -1,2 +0,0 @@
1
- import { PacerProvider, PacerProviderOptions, PacerProviderProps, useDefaultPacerOptions, usePacerContext } from "./PacerProvider.cjs";
2
- export { PacerProvider, PacerProviderOptions, PacerProviderProps, useDefaultPacerOptions, usePacerContext };