@tanstack/angular-pacer 0.20.0 → 0.21.0

package/dist/debouncer/injectDebouncer.js

@@ -1,4 +1,5 @@
 import { injectPacerOptions } from "../provider/pacer-context.js";
+import { DestroyRef, inject } from "@angular/core";
 import { injectStore } from "@tanstack/angular-store";
 import { Debouncer } from "@tanstack/pacer/debouncer";
 
@@ -34,6 +35,18 @@ import { Debouncer } from "@tanstack/pacer/debouncer";
 * - `lastArgs`: The arguments from the most recent call to maybeExecute
 * - `status`: Current execution status ('disabled' | 'idle' | 'pending')
 *
+* ## Cleanup on Destroy
+*
+* By default, the function cancels any pending execution when the component is destroyed.
+* Use the `onUnmount` option to customize this. For example, to flush pending work instead:
+*
+* ```ts
+* const debouncer = injectDebouncer(fn, {
+*   wait: 500,
+*   onUnmount: (d) => d.flush()
+* });
+* ```
+*
 * @example
 * ```ts
 * // Default behavior - no reactive state subscriptions
@@ -60,15 +73,21 @@ import { Debouncer } from "@tanstack/pacer/debouncer";
 * ```
 */
 function injectDebouncer(fn, options, selector = () => ({})) {
-	const debouncer = new Debouncer(fn, {
+	const mergedOptions = {
 		...injectPacerOptions().debouncer,
 		...options
-	});
+	};
+	const debouncer = new Debouncer(fn, mergedOptions);
 	const state = injectStore(debouncer.store, selector);
-	return {
+	const result = {
 		...debouncer,
 		state
 	};
+	inject(DestroyRef, { optional: true })?.onDestroy(() => {
+		if (mergedOptions.onUnmount) mergedOptions.onUnmount(result);
+		else debouncer.cancel();
+	});
+	return result;
 }
 
 //#endregion

package/dist/debouncer/injectDebouncer.js.map

@@ -1 +1 @@
-{"version":3,"file":"injectDebouncer.js","names":[],"sources":["../../src/debouncer/injectDebouncer.ts"],"sourcesContent":["import { injectStore } from '@tanstack/angular-store'\nimport { Debouncer } from '@tanstack/pacer/debouncer'\nimport { injectPacerOptions } from '../provider/pacer-context'\nimport type { Signal } from '@angular/core'\nimport type { Store } from '@tanstack/store'\nimport type { AnyFunction } from '@tanstack/pacer/types'\nimport type {\n  DebouncerOptions,\n  DebouncerState,\n} from '@tanstack/pacer/debouncer'\n\nexport interface AngularDebouncer<\n  TFn extends AnyFunction,\n  TSelected = {},\n> extends Omit<Debouncer<TFn>, 'store'> {\n  /**\n   * Reactive state signal that will be updated when the debouncer state changes\n   *\n   * Use this instead of `debouncer.store.state`\n   */\n  readonly state: Signal<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 in Angular signals.\n   */\n  readonly store: Store<Readonly<DebouncerState<TFn>>>\n}\n\n/**\n * An Angular function that creates and manages a Debouncer instance.\n *\n * This is a lower-level function that provides direct access to the Debouncer's functionality.\n * This allows you to integrate it with any state management solution you prefer.\n *\n * This function 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 function uses TanStack Store for state management and wraps it with Angular signals.\n * The `selector` parameter allows you to specify which state changes will trigger signal updates,\n * optimizing performance by preventing unnecessary updates 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 updates and gives you\n * full control over when your component tracks state changes.\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 * @example\n * ```ts\n * // Default behavior - no reactive state subscriptions\n * const debouncer = injectDebouncer(\n *   (query: string) => fetchSearchResults(query),\n *   { wait: 500 }\n * );\n *\n * // Opt-in to track isPending changes (optimized for loading states)\n * const debouncer = injectDebouncer(\n *   (query: string) => fetchSearchResults(query),\n *   { wait: 500 },\n *   (state) => ({ isPending: state.isPending })\n * );\n *\n * // In an event handler\n * const handleChange = (e: Event) => {\n *   const target = e.target as HTMLInputElement\n *   debouncer.maybeExecute(target.value);\n * };\n *\n * // Access the selected state (will be empty object {} unless selector provided)\n * const { isPending } = debouncer.state();\n * ```\n */\nexport function injectDebouncer<TFn extends AnyFunction, TSelected = {}>(\n  fn: TFn,\n  options: DebouncerOptions<TFn>,\n  selector: (state: DebouncerState<TFn>) => TSelected = () => ({}) as TSelected,\n): AngularDebouncer<TFn, TSelected> {\n  const mergedOptions = {\n    ...injectPacerOptions().debouncer,\n    ...options,\n  } as DebouncerOptions<TFn>\n\n  const debouncer = new Debouncer<TFn>(fn, mergedOptions)\n  const state = injectStore(debouncer.store, selector)\n\n  return {\n    ...debouncer,\n    state,\n  } as AngularDebouncer<TFn, TSelected>\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAoFA,SAAgB,gBACd,IACA,SACA,kBAA6D,EAAE,GAC7B;CAMlC,MAAM,YAAY,IAAI,UAAe,IALf;EACpB,GAAG,oBAAoB,CAAC;EACxB,GAAG;EACJ,CAEsD;CACvD,MAAM,QAAQ,YAAY,UAAU,OAAO,SAAS;AAEpD,QAAO;EACL,GAAG;EACH;EACD"}
+{"version":3,"file":"injectDebouncer.js","names":[],"sources":["../../src/debouncer/injectDebouncer.ts"],"sourcesContent":["import { DestroyRef, inject } from '@angular/core'\nimport { injectStore } from '@tanstack/angular-store'\nimport { Debouncer } from '@tanstack/pacer/debouncer'\nimport { injectPacerOptions } from '../provider/pacer-context'\nimport type { Signal } from '@angular/core'\nimport type { Store } from '@tanstack/angular-store'\nimport type { AnyFunction } from '@tanstack/pacer/types'\nimport type {\n  DebouncerOptions,\n  DebouncerState,\n} from '@tanstack/pacer/debouncer'\n\nexport interface AngularDebouncerOptions<\n  TFn extends AnyFunction,\n  TSelected = {},\n> extends DebouncerOptions<TFn> {\n  /**\n   * Optional callback invoked when the component is destroyed. Receives the debouncer instance.\n   * When provided, replaces the default cleanup (cancel); use it to call flush(), cancel(), add logging, etc.\n   */\n  onUnmount?: (debouncer: AngularDebouncer<TFn, TSelected>) => void\n}\n\nexport interface AngularDebouncer<\n  TFn extends AnyFunction,\n  TSelected = {},\n> extends Omit<Debouncer<TFn>, 'store'> {\n  /**\n   * Reactive state signal that will be updated when the debouncer state changes\n   *\n   * Use this instead of `debouncer.store.state`\n   */\n  readonly state: Signal<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 in Angular signals.\n   */\n  readonly store: Store<Readonly<DebouncerState<TFn>>>\n}\n\n/**\n * An Angular function that creates and manages a Debouncer instance.\n *\n * This is a lower-level function that provides direct access to the Debouncer's functionality.\n * This allows you to integrate it with any state management solution you prefer.\n *\n * This function 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 function uses TanStack Store for state management and wraps it with Angular signals.\n * The `selector` parameter allows you to specify which state changes will trigger signal updates,\n * optimizing performance by preventing unnecessary updates 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 updates and gives you\n * full control over when your component tracks state changes.\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 * ## Cleanup on Destroy\n *\n * By default, the function cancels any pending execution when the component is destroyed.\n * Use the `onUnmount` option to customize this. For example, to flush pending work instead:\n *\n * ```ts\n * const debouncer = injectDebouncer(fn, {\n *   wait: 500,\n *   onUnmount: (d) => d.flush()\n * });\n * ```\n *\n * @example\n * ```ts\n * // Default behavior - no reactive state subscriptions\n * const debouncer = injectDebouncer(\n *   (query: string) => fetchSearchResults(query),\n *   { wait: 500 }\n * );\n *\n * // Opt-in to track isPending changes (optimized for loading states)\n * const debouncer = injectDebouncer(\n *   (query: string) => fetchSearchResults(query),\n *   { wait: 500 },\n *   (state) => ({ isPending: state.isPending })\n * );\n *\n * // In an event handler\n * const handleChange = (e: Event) => {\n *   const target = e.target as HTMLInputElement\n *   debouncer.maybeExecute(target.value);\n * };\n *\n * // Access the selected state (will be empty object {} unless selector provided)\n * const { isPending } = debouncer.state();\n * ```\n */\nexport function injectDebouncer<TFn extends AnyFunction, TSelected = {}>(\n  fn: TFn,\n  options: AngularDebouncerOptions<TFn, TSelected>,\n  selector: (state: DebouncerState<TFn>) => TSelected = () => ({}) as TSelected,\n): AngularDebouncer<TFn, TSelected> {\n  const mergedOptions = {\n    ...injectPacerOptions().debouncer,\n    ...options,\n  } as AngularDebouncerOptions<TFn, TSelected>\n\n  const debouncer = new Debouncer<TFn>(fn, mergedOptions)\n  const state = injectStore(debouncer.store, selector)\n\n  const result = {\n    ...debouncer,\n    state,\n  } as AngularDebouncer<TFn, TSelected>\n\n  const destroyRef = inject(DestroyRef, { optional: true })\n  destroyRef?.onDestroy(() => {\n    if (mergedOptions.onUnmount) {\n      mergedOptions.onUnmount(result)\n    } else {\n      debouncer.cancel()\n    }\n  })\n\n  return result\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA4GA,SAAgB,gBACd,IACA,SACA,kBAA6D,EAAE,GAC7B;CAClC,MAAM,gBAAgB;EACpB,GAAG,oBAAoB,CAAC;EACxB,GAAG;EACJ;CAED,MAAM,YAAY,IAAI,UAAe,IAAI,cAAc;CACvD,MAAM,QAAQ,YAAY,UAAU,OAAO,SAAS;CAEpD,MAAM,SAAS;EACb,GAAG;EACH;EACD;AAGD,CADmB,OAAO,YAAY,EAAE,UAAU,MAAM,CAAC,EAC7C,gBAAgB;AAC1B,MAAI,cAAc,UAChB,eAAc,UAAU,OAAO;MAE/B,WAAU,QAAQ;GAEpB;AAEF,QAAO"}

package/dist/index.d.cts

@@ -1,30 +1,30 @@
 import { injectAsyncBatchedCallback } from "./async-batcher/injectAsyncBatchedCallback.cjs";
-import { AngularAsyncBatcher, injectAsyncBatcher } from "./async-batcher/injectAsyncBatcher.cjs";
+import { AngularAsyncBatcher, AngularAsyncBatcherOptions, injectAsyncBatcher } from "./async-batcher/injectAsyncBatcher.cjs";
 import { injectAsyncDebouncedCallback } from "./async-debouncer/injectAsyncDebouncedCallback.cjs";
-import { AngularAsyncDebouncer, injectAsyncDebouncer } from "./async-debouncer/injectAsyncDebouncer.cjs";
-import { AngularAsyncQueuer, injectAsyncQueuer } from "./async-queuer/injectAsyncQueuer.cjs";
+import { AngularAsyncDebouncer, AngularAsyncDebouncerOptions, injectAsyncDebouncer } from "./async-debouncer/injectAsyncDebouncer.cjs";
+import { AngularAsyncQueuer, AngularAsyncQueuerOptions, injectAsyncQueuer } from "./async-queuer/injectAsyncQueuer.cjs";
 import { AsyncQueuedSignal, injectAsyncQueuedSignal } from "./async-queuer/injectAsyncQueuedSignal.cjs";
 import { injectAsyncRateLimitedCallback } from "./async-rate-limiter/injectAsyncRateLimitedCallback.cjs";
-import { AngularAsyncRateLimiter, injectAsyncRateLimiter } from "./async-rate-limiter/injectAsyncRateLimiter.cjs";
+import { AngularAsyncRateLimiter, AngularAsyncRateLimiterOptions, injectAsyncRateLimiter } from "./async-rate-limiter/injectAsyncRateLimiter.cjs";
 import { injectAsyncThrottledCallback } from "./async-throttler/injectAsyncThrottledCallback.cjs";
-import { AngularAsyncThrottler, injectAsyncThrottler } from "./async-throttler/injectAsyncThrottler.cjs";
+import { AngularAsyncThrottler, AngularAsyncThrottlerOptions, injectAsyncThrottler } from "./async-throttler/injectAsyncThrottler.cjs";
 import { injectBatchedCallback } from "./batcher/injectBatchedCallback.cjs";
-import { AngularBatcher, injectBatcher } from "./batcher/injectBatcher.cjs";
+import { AngularBatcher, AngularBatcherOptions, injectBatcher } from "./batcher/injectBatcher.cjs";
 import { injectDebouncedCallback } from "./debouncer/injectDebouncedCallback.cjs";
-import { AngularDebouncer, injectDebouncer } from "./debouncer/injectDebouncer.cjs";
+import { AngularDebouncer, AngularDebouncerOptions, injectDebouncer } from "./debouncer/injectDebouncer.cjs";
 import { DebouncedSignal, injectDebouncedSignal } from "./debouncer/injectDebouncedSignal.cjs";
 import { injectDebouncedValue } from "./debouncer/injectDebouncedValue.cjs";
 import { providePacerOptions } from "./provider/pacer-provider.cjs";
-import { AngularQueuer, injectQueuer } from "./queuer/injectQueuer.cjs";
+import { AngularQueuer, AngularQueuerOptions, injectQueuer } from "./queuer/injectQueuer.cjs";
 import { QueuedSignal, injectQueuedSignal } from "./queuer/injectQueuedSignal.cjs";
 import { injectQueuedValue } from "./queuer/injectQueuedValue.cjs";
 import { injectRateLimitedCallback } from "./rate-limiter/injectRateLimitedCallback.cjs";
-import { AngularRateLimiter, injectRateLimiter } from "./rate-limiter/injectRateLimiter.cjs";
+import { AngularRateLimiter, AngularRateLimiterOptions, injectRateLimiter } from "./rate-limiter/injectRateLimiter.cjs";
 import { RateLimitedSignal, injectRateLimitedSignal } from "./rate-limiter/injectRateLimitedSignal.cjs";
 import { injectRateLimitedValue } from "./rate-limiter/injectRateLimitedValue.cjs";
 import { injectThrottledCallback } from "./throttler/injectThrottledCallback.cjs";
-import { AngularThrottler, injectThrottler } from "./throttler/injectThrottler.cjs";
+import { AngularThrottler, AngularThrottlerOptions, injectThrottler } from "./throttler/injectThrottler.cjs";
 import { ThrottledSignal, injectThrottledSignal } from "./throttler/injectThrottledSignal.cjs";
 import { injectThrottledValue } from "./throttler/injectThrottledValue.cjs";
 export * from "@tanstack/pacer";
-export { AngularAsyncBatcher, AngularAsyncDebouncer, AngularAsyncQueuer, AngularAsyncRateLimiter, AngularAsyncThrottler, AngularBatcher, AngularDebouncer, AngularQueuer, AngularRateLimiter, AngularThrottler, AsyncQueuedSignal, DebouncedSignal, QueuedSignal, RateLimitedSignal, ThrottledSignal, injectAsyncBatchedCallback, injectAsyncBatcher, injectAsyncDebouncedCallback, injectAsyncDebouncer, injectAsyncQueuedSignal, injectAsyncQueuer, injectAsyncRateLimitedCallback, injectAsyncRateLimiter, injectAsyncThrottledCallback, injectAsyncThrottler, injectBatchedCallback, injectBatcher, injectDebouncedCallback, injectDebouncedSignal, injectDebouncedValue, injectDebouncer, injectQueuedSignal, injectQueuedValue, injectQueuer, injectRateLimitedCallback, injectRateLimitedSignal, injectRateLimitedValue, injectRateLimiter, injectThrottledCallback, injectThrottledSignal, injectThrottledValue, injectThrottler, providePacerOptions };
+export { AngularAsyncBatcher, AngularAsyncBatcherOptions, AngularAsyncDebouncer, AngularAsyncDebouncerOptions, AngularAsyncQueuer, AngularAsyncQueuerOptions, AngularAsyncRateLimiter, AngularAsyncRateLimiterOptions, AngularAsyncThrottler, AngularAsyncThrottlerOptions, AngularBatcher, AngularBatcherOptions, AngularDebouncer, AngularDebouncerOptions, AngularQueuer, AngularQueuerOptions, AngularRateLimiter, AngularRateLimiterOptions, AngularThrottler, AngularThrottlerOptions, AsyncQueuedSignal, DebouncedSignal, QueuedSignal, RateLimitedSignal, ThrottledSignal, injectAsyncBatchedCallback, injectAsyncBatcher, injectAsyncDebouncedCallback, injectAsyncDebouncer, injectAsyncQueuedSignal, injectAsyncQueuer, injectAsyncRateLimitedCallback, injectAsyncRateLimiter, injectAsyncThrottledCallback, injectAsyncThrottler, injectBatchedCallback, injectBatcher, injectDebouncedCallback, injectDebouncedSignal, injectDebouncedValue, injectDebouncer, injectQueuedSignal, injectQueuedValue, injectQueuer, injectRateLimitedCallback, injectRateLimitedSignal, injectRateLimitedValue, injectRateLimiter, injectThrottledCallback, injectThrottledSignal, injectThrottledValue, injectThrottler, providePacerOptions };

package/dist/index.d.ts

@@ -1,30 +1,30 @@
 import { injectAsyncBatchedCallback } from "./async-batcher/injectAsyncBatchedCallback.js";
-import { AngularAsyncBatcher, injectAsyncBatcher } from "./async-batcher/injectAsyncBatcher.js";
+import { AngularAsyncBatcher, AngularAsyncBatcherOptions, injectAsyncBatcher } from "./async-batcher/injectAsyncBatcher.js";
 import { injectAsyncDebouncedCallback } from "./async-debouncer/injectAsyncDebouncedCallback.js";
-import { AngularAsyncDebouncer, injectAsyncDebouncer } from "./async-debouncer/injectAsyncDebouncer.js";
-import { AngularAsyncQueuer, injectAsyncQueuer } from "./async-queuer/injectAsyncQueuer.js";
+import { AngularAsyncDebouncer, AngularAsyncDebouncerOptions, injectAsyncDebouncer } from "./async-debouncer/injectAsyncDebouncer.js";
+import { AngularAsyncQueuer, AngularAsyncQueuerOptions, injectAsyncQueuer } from "./async-queuer/injectAsyncQueuer.js";
 import { AsyncQueuedSignal, injectAsyncQueuedSignal } from "./async-queuer/injectAsyncQueuedSignal.js";
 import { injectAsyncRateLimitedCallback } from "./async-rate-limiter/injectAsyncRateLimitedCallback.js";
-import { AngularAsyncRateLimiter, injectAsyncRateLimiter } from "./async-rate-limiter/injectAsyncRateLimiter.js";
+import { AngularAsyncRateLimiter, AngularAsyncRateLimiterOptions, injectAsyncRateLimiter } from "./async-rate-limiter/injectAsyncRateLimiter.js";
 import { injectAsyncThrottledCallback } from "./async-throttler/injectAsyncThrottledCallback.js";
-import { AngularAsyncThrottler, injectAsyncThrottler } from "./async-throttler/injectAsyncThrottler.js";
+import { AngularAsyncThrottler, AngularAsyncThrottlerOptions, injectAsyncThrottler } from "./async-throttler/injectAsyncThrottler.js";
 import { injectBatchedCallback } from "./batcher/injectBatchedCallback.js";
-import { AngularBatcher, injectBatcher } from "./batcher/injectBatcher.js";
+import { AngularBatcher, AngularBatcherOptions, injectBatcher } from "./batcher/injectBatcher.js";
 import { injectDebouncedCallback } from "./debouncer/injectDebouncedCallback.js";
-import { AngularDebouncer, injectDebouncer } from "./debouncer/injectDebouncer.js";
+import { AngularDebouncer, AngularDebouncerOptions, injectDebouncer } from "./debouncer/injectDebouncer.js";
 import { DebouncedSignal, injectDebouncedSignal } from "./debouncer/injectDebouncedSignal.js";
 import { injectDebouncedValue } from "./debouncer/injectDebouncedValue.js";
 import { providePacerOptions } from "./provider/pacer-provider.js";
-import { AngularQueuer, injectQueuer } from "./queuer/injectQueuer.js";
+import { AngularQueuer, AngularQueuerOptions, injectQueuer } from "./queuer/injectQueuer.js";
 import { QueuedSignal, injectQueuedSignal } from "./queuer/injectQueuedSignal.js";
 import { injectQueuedValue } from "./queuer/injectQueuedValue.js";
 import { injectRateLimitedCallback } from "./rate-limiter/injectRateLimitedCallback.js";
-import { AngularRateLimiter, injectRateLimiter } from "./rate-limiter/injectRateLimiter.js";
+import { AngularRateLimiter, AngularRateLimiterOptions, injectRateLimiter } from "./rate-limiter/injectRateLimiter.js";
 import { RateLimitedSignal, injectRateLimitedSignal } from "./rate-limiter/injectRateLimitedSignal.js";
 import { injectRateLimitedValue } from "./rate-limiter/injectRateLimitedValue.js";
 import { injectThrottledCallback } from "./throttler/injectThrottledCallback.js";
-import { AngularThrottler, injectThrottler } from "./throttler/injectThrottler.js";
+import { AngularThrottler, AngularThrottlerOptions, injectThrottler } from "./throttler/injectThrottler.js";
 import { ThrottledSignal, injectThrottledSignal } from "./throttler/injectThrottledSignal.js";
 import { injectThrottledValue } from "./throttler/injectThrottledValue.js";
 export * from "@tanstack/pacer";
-export { AngularAsyncBatcher, AngularAsyncDebouncer, AngularAsyncQueuer, AngularAsyncRateLimiter, AngularAsyncThrottler, AngularBatcher, AngularDebouncer, AngularQueuer, AngularRateLimiter, AngularThrottler, AsyncQueuedSignal, DebouncedSignal, QueuedSignal, RateLimitedSignal, ThrottledSignal, injectAsyncBatchedCallback, injectAsyncBatcher, injectAsyncDebouncedCallback, injectAsyncDebouncer, injectAsyncQueuedSignal, injectAsyncQueuer, injectAsyncRateLimitedCallback, injectAsyncRateLimiter, injectAsyncThrottledCallback, injectAsyncThrottler, injectBatchedCallback, injectBatcher, injectDebouncedCallback, injectDebouncedSignal, injectDebouncedValue, injectDebouncer, injectQueuedSignal, injectQueuedValue, injectQueuer, injectRateLimitedCallback, injectRateLimitedSignal, injectRateLimitedValue, injectRateLimiter, injectThrottledCallback, injectThrottledSignal, injectThrottledValue, injectThrottler, providePacerOptions };
+export { AngularAsyncBatcher, AngularAsyncBatcherOptions, AngularAsyncDebouncer, AngularAsyncDebouncerOptions, AngularAsyncQueuer, AngularAsyncQueuerOptions, AngularAsyncRateLimiter, AngularAsyncRateLimiterOptions, AngularAsyncThrottler, AngularAsyncThrottlerOptions, AngularBatcher, AngularBatcherOptions, AngularDebouncer, AngularDebouncerOptions, AngularQueuer, AngularQueuerOptions, AngularRateLimiter, AngularRateLimiterOptions, AngularThrottler, AngularThrottlerOptions, AsyncQueuedSignal, DebouncedSignal, QueuedSignal, RateLimitedSignal, ThrottledSignal, injectAsyncBatchedCallback, injectAsyncBatcher, injectAsyncDebouncedCallback, injectAsyncDebouncer, injectAsyncQueuedSignal, injectAsyncQueuer, injectAsyncRateLimitedCallback, injectAsyncRateLimiter, injectAsyncThrottledCallback, injectAsyncThrottler, injectBatchedCallback, injectBatcher, injectDebouncedCallback, injectDebouncedSignal, injectDebouncedValue, injectDebouncer, injectQueuedSignal, injectQueuedValue, injectQueuer, injectRateLimitedCallback, injectRateLimitedSignal, injectRateLimitedValue, injectRateLimiter, injectThrottledCallback, injectThrottledSignal, injectThrottledValue, injectThrottler, providePacerOptions };

package/dist/queuer/index.d.cts

@@ -1,5 +1,5 @@
-import { AngularQueuer, injectQueuer } from "./injectQueuer.cjs";
+import { AngularQueuer, AngularQueuerOptions, injectQueuer } from "./injectQueuer.cjs";
 import { QueuedSignal, injectQueuedSignal } from "./injectQueuedSignal.cjs";
 import { injectQueuedValue } from "./injectQueuedValue.cjs";
 export * from "@tanstack/pacer/queuer";
-export { AngularQueuer, QueuedSignal, injectQueuedSignal, injectQueuedValue, injectQueuer };
+export { AngularQueuer, AngularQueuerOptions, QueuedSignal, injectQueuedSignal, injectQueuedValue, injectQueuer };

package/dist/queuer/index.d.ts

@@ -1,5 +1,5 @@
-import { AngularQueuer, injectQueuer } from "./injectQueuer.js";
+import { AngularQueuer, AngularQueuerOptions, injectQueuer } from "./injectQueuer.js";
 import { QueuedSignal, injectQueuedSignal } from "./injectQueuedSignal.js";
 import { injectQueuedValue } from "./injectQueuedValue.js";
 export * from "@tanstack/pacer/queuer";
-export { AngularQueuer, QueuedSignal, injectQueuedSignal, injectQueuedValue, injectQueuer };
+export { AngularQueuer, AngularQueuerOptions, QueuedSignal, injectQueuedSignal, injectQueuedValue, injectQueuer };

package/dist/queuer/injectQueuer.cjs

@@ -1,4 +1,5 @@
 const require_pacer_context = require('../provider/pacer-context.cjs');
+let _angular_core = require("@angular/core");
 let _tanstack_angular_store = require("@tanstack/angular-store");
 let _tanstack_pacer_queuer = require("@tanstack/pacer/queuer");
 
@@ -43,17 +44,35 @@ let _tanstack_pacer_queuer = require("@tanstack/pacer/queuer");
 * // Access the selected state
 * const { items, isRunning } = queue.state();
 * ```
+*
+* ## Cleanup on Destroy
+*
+* By default, the function stops the queuer when the component is destroyed.
+* Use the `onUnmount` option to customize this. For example, to flush pending items instead:
+*
+* ```ts
+* const queue = injectQueuer(fn, {
+*   started: true,
+*   onUnmount: (q) => q.flush()
+* });
+* ```
 */
 function injectQueuer(fn, options = {}, selector = () => ({})) {
-	const queuer = new _tanstack_pacer_queuer.Queuer(fn, {
+	const mergedOptions = {
 		...require_pacer_context.injectPacerOptions().queuer,
 		...options
-	});
+	};
+	const queuer = new _tanstack_pacer_queuer.Queuer(fn, mergedOptions);
 	const state = (0, _tanstack_angular_store.injectStore)(queuer.store, selector);
-	return {
+	const result = {
 		...queuer,
 		state
 	};
+	(0, _angular_core.inject)(_angular_core.DestroyRef, { optional: true })?.onDestroy(() => {
+		if (mergedOptions.onUnmount) mergedOptions.onUnmount(result);
+		else queuer.stop();
+	});
+	return result;
 }
 
 //#endregion

package/dist/queuer/injectQueuer.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"injectQueuer.cjs","names":["Queuer","injectPacerOptions"],"sources":["../../src/queuer/injectQueuer.ts"],"sourcesContent":["import { injectStore } from '@tanstack/angular-store'\nimport { Queuer } from '@tanstack/pacer/queuer'\nimport { injectPacerOptions } from '../provider/pacer-context'\nimport type { Signal } from '@angular/core'\nimport type { Store } from '@tanstack/store'\nimport type { QueuerOptions, QueuerState } from '@tanstack/pacer/queuer'\n\nexport interface AngularQueuer<TValue, TSelected = {}> extends Omit<\n  Queuer<TValue>,\n  'store'\n> {\n  /**\n   * Reactive state signal that will be updated when the queuer state changes\n   *\n   * Use this instead of `queuer.store.state`\n   */\n  readonly state: Signal<Readonly<TSelected>>\n  /**\n   * @deprecated Use `queuer.state` instead of `queuer.store.state` if you want to read reactive state.\n   * The state on the store object is not reactive in Angular signals.\n   */\n  readonly store: Store<Readonly<QueuerState<TValue>>>\n}\n\n/**\n * An Angular function that creates and manages a Queuer instance.\n *\n * This is a lower-level function that provides direct access to the Queuer's functionality.\n * This allows you to integrate it with any state management solution you prefer.\n *\n * The Queuer processes items synchronously in order, with optional delays between processing each item.\n * The queuer includes an internal tick mechanism that can be started and stopped, making it useful as a scheduler.\n *\n * ## State Management and Selector\n *\n * The function uses TanStack Store for state management and wraps it with Angular signals.\n * The `selector` parameter allows you to specify which state changes will trigger signal updates,\n * optimizing performance by preventing unnecessary updates 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 updates and gives you\n * full control over when your component tracks state changes.\n *\n * @example\n * ```ts\n * // Default behavior - no reactive state subscriptions\n * const queue = injectQueuer(\n *   (item) => console.log('Processing:', item),\n *   { started: true, wait: 1000 }\n * );\n *\n * // Opt-in to track queue contents changes\n * const queue = injectQueuer(\n *   (item) => console.log('Processing:', item),\n *   { started: true, wait: 1000 },\n *   (state) => ({ items: state.items, size: state.size })\n * );\n *\n * // Add items\n * queue.addItem('task1');\n *\n * // Access the selected state\n * const { items, isRunning } = queue.state();\n * ```\n */\nexport function injectQueuer<TValue, TSelected = {}>(\n  fn: (item: TValue) => void,\n  options: QueuerOptions<TValue> = {},\n  selector: (state: QueuerState<TValue>) => TSelected = () => ({}) as TSelected,\n): AngularQueuer<TValue, TSelected> {\n  const mergedOptions = {\n    ...injectPacerOptions().queuer,\n    ...options,\n  } as QueuerOptions<TValue>\n\n  const queuer = new Queuer<TValue>(fn, mergedOptions)\n  const state = injectStore(queuer.store, selector)\n\n  return {\n    ...queuer,\n    state,\n  } as AngularQueuer<TValue, TSelected>\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAiEA,SAAgB,aACd,IACA,UAAiC,EAAE,EACnC,kBAA6D,EAAE,GAC7B;CAMlC,MAAM,SAAS,IAAIA,8BAAe,IALZ;EACpB,GAAGC,0CAAoB,CAAC;EACxB,GAAG;EACJ,CAEmD;CACpD,MAAM,iDAAoB,OAAO,OAAO,SAAS;AAEjD,QAAO;EACL,GAAG;EACH;EACD"}
+{"version":3,"file":"injectQueuer.cjs","names":["injectPacerOptions","Queuer","DestroyRef"],"sources":["../../src/queuer/injectQueuer.ts"],"sourcesContent":["import { DestroyRef, inject } from '@angular/core'\nimport { injectStore } from '@tanstack/angular-store'\nimport { Queuer } from '@tanstack/pacer/queuer'\nimport { injectPacerOptions } from '../provider/pacer-context'\nimport type { Signal } from '@angular/core'\nimport type { Store } from '@tanstack/angular-store'\nimport type { QueuerOptions, QueuerState } from '@tanstack/pacer/queuer'\n\nexport interface AngularQueuerOptions<\n  TValue,\n  TSelected = {},\n> extends QueuerOptions<TValue> {\n  /**\n   * Optional callback invoked when the component is destroyed. Receives the queuer instance.\n   * When provided, replaces the default cleanup (stop); use it to call flush(), stop(), add logging, etc.\n   */\n  onUnmount?: (queuer: AngularQueuer<TValue, TSelected>) => void\n}\n\nexport interface AngularQueuer<TValue, TSelected = {}> extends Omit<\n  Queuer<TValue>,\n  'store'\n> {\n  /**\n   * Reactive state signal that will be updated when the queuer state changes\n   *\n   * Use this instead of `queuer.store.state`\n   */\n  readonly state: Signal<Readonly<TSelected>>\n  /**\n   * @deprecated Use `queuer.state` instead of `queuer.store.state` if you want to read reactive state.\n   * The state on the store object is not reactive in Angular signals.\n   */\n  readonly store: Store<Readonly<QueuerState<TValue>>>\n}\n\n/**\n * An Angular function that creates and manages a Queuer instance.\n *\n * This is a lower-level function that provides direct access to the Queuer's functionality.\n * This allows you to integrate it with any state management solution you prefer.\n *\n * The Queuer processes items synchronously in order, with optional delays between processing each item.\n * The queuer includes an internal tick mechanism that can be started and stopped, making it useful as a scheduler.\n *\n * ## State Management and Selector\n *\n * The function uses TanStack Store for state management and wraps it with Angular signals.\n * The `selector` parameter allows you to specify which state changes will trigger signal updates,\n * optimizing performance by preventing unnecessary updates 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 updates and gives you\n * full control over when your component tracks state changes.\n *\n * @example\n * ```ts\n * // Default behavior - no reactive state subscriptions\n * const queue = injectQueuer(\n *   (item) => console.log('Processing:', item),\n *   { started: true, wait: 1000 }\n * );\n *\n * // Opt-in to track queue contents changes\n * const queue = injectQueuer(\n *   (item) => console.log('Processing:', item),\n *   { started: true, wait: 1000 },\n *   (state) => ({ items: state.items, size: state.size })\n * );\n *\n * // Add items\n * queue.addItem('task1');\n *\n * // Access the selected state\n * const { items, isRunning } = queue.state();\n * ```\n *\n * ## Cleanup on Destroy\n *\n * By default, the function stops the queuer when the component is destroyed.\n * Use the `onUnmount` option to customize this. For example, to flush pending items instead:\n *\n * ```ts\n * const queue = injectQueuer(fn, {\n *   started: true,\n *   onUnmount: (q) => q.flush()\n * });\n * ```\n */\nexport function injectQueuer<TValue, TSelected = {}>(\n  fn: (item: TValue) => void,\n  options: AngularQueuerOptions<TValue, TSelected> = {},\n  selector: (state: QueuerState<TValue>) => TSelected = () => ({}) as TSelected,\n): AngularQueuer<TValue, TSelected> {\n  const mergedOptions = {\n    ...injectPacerOptions().queuer,\n    ...options,\n  } as AngularQueuerOptions<TValue, TSelected>\n\n  const queuer = new Queuer<TValue>(fn, mergedOptions)\n  const state = injectStore(queuer.store, selector)\n\n  const result = {\n    ...queuer,\n    state,\n  } as AngularQueuer<TValue, TSelected>\n\n  const destroyRef = inject(DestroyRef, { optional: true })\n  destroyRef?.onDestroy(() => {\n    if (mergedOptions.onUnmount) {\n      mergedOptions.onUnmount(result)\n    } else {\n      queuer.stop()\n    }\n  })\n\n  return result\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAyFA,SAAgB,aACd,IACA,UAAmD,EAAE,EACrD,kBAA6D,EAAE,GAC7B;CAClC,MAAM,gBAAgB;EACpB,GAAGA,0CAAoB,CAAC;EACxB,GAAG;EACJ;CAED,MAAM,SAAS,IAAIC,8BAAe,IAAI,cAAc;CACpD,MAAM,iDAAoB,OAAO,OAAO,SAAS;CAEjD,MAAM,SAAS;EACb,GAAG;EACH;EACD;AAGD,2BAD0BC,0BAAY,EAAE,UAAU,MAAM,CAAC,EAC7C,gBAAgB;AAC1B,MAAI,cAAc,UAChB,eAAc,UAAU,OAAO;MAE/B,QAAO,MAAM;GAEf;AAEF,QAAO"}

package/dist/queuer/injectQueuer.d.cts

@@ -1,8 +1,15 @@
 import { Signal } from "@angular/core";
-import { Store } from "@tanstack/store";
+import { Store } from "@tanstack/angular-store";
 import { Queuer, QueuerOptions, QueuerState } from "@tanstack/pacer/queuer";
 
 //#region src/queuer/injectQueuer.d.ts
+interface AngularQueuerOptions<TValue, TSelected = {}> extends QueuerOptions<TValue> {
+  /**
+   * Optional callback invoked when the component is destroyed. Receives the queuer instance.
+   * When provided, replaces the default cleanup (stop); use it to call flush(), stop(), add logging, etc.
+   */
+  onUnmount?: (queuer: AngularQueuer<TValue, TSelected>) => void;
+}
 interface AngularQueuer<TValue, TSelected = {}> extends Omit<Queuer<TValue>, 'store'> {
   /**
    * Reactive state signal that will be updated when the queuer state changes
@@ -56,8 +63,20 @@ interface AngularQueuer<TValue, TSelected = {}> extends Omit<Queuer<TValue>, 'st
  * // Access the selected state
  * const { items, isRunning } = queue.state();
  * ```
+ *
+ * ## Cleanup on Destroy
+ *
+ * By default, the function stops the queuer when the component is destroyed.
+ * Use the `onUnmount` option to customize this. For example, to flush pending items instead:
+ *
+ * ```ts
+ * const queue = injectQueuer(fn, {
+ *   started: true,
+ *   onUnmount: (q) => q.flush()
+ * });
+ * ```
  */
-declare function injectQueuer<TValue, TSelected = {}>(fn: (item: TValue) => void, options?: QueuerOptions<TValue>, selector?: (state: QueuerState<TValue>) => TSelected): AngularQueuer<TValue, TSelected>;
+declare function injectQueuer<TValue, TSelected = {}>(fn: (item: TValue) => void, options?: AngularQueuerOptions<TValue, TSelected>, selector?: (state: QueuerState<TValue>) => TSelected): AngularQueuer<TValue, TSelected>;
 //#endregion
-export { AngularQueuer, injectQueuer };
+export { AngularQueuer, AngularQueuerOptions, injectQueuer };
 //# sourceMappingURL=injectQueuer.d.cts.map

package/dist/queuer/injectQueuer.d.ts

@@ -1,8 +1,15 @@
 import { Signal } from "@angular/core";
+import { Store } from "@tanstack/angular-store";
 import { Queuer, QueuerOptions, QueuerState } from "@tanstack/pacer/queuer";
-import { Store } from "@tanstack/store";
 
 //#region src/queuer/injectQueuer.d.ts
+interface AngularQueuerOptions<TValue, TSelected = {}> extends QueuerOptions<TValue> {
+  /**
+   * Optional callback invoked when the component is destroyed. Receives the queuer instance.
+   * When provided, replaces the default cleanup (stop); use it to call flush(), stop(), add logging, etc.
+   */
+  onUnmount?: (queuer: AngularQueuer<TValue, TSelected>) => void;
+}
 interface AngularQueuer<TValue, TSelected = {}> extends Omit<Queuer<TValue>, 'store'> {
   /**
    * Reactive state signal that will be updated when the queuer state changes
@@ -56,8 +63,20 @@ interface AngularQueuer<TValue, TSelected = {}> extends Omit<Queuer<TValue>, 'st
  * // Access the selected state
  * const { items, isRunning } = queue.state();
  * ```
+ *
+ * ## Cleanup on Destroy
+ *
+ * By default, the function stops the queuer when the component is destroyed.
+ * Use the `onUnmount` option to customize this. For example, to flush pending items instead:
+ *
+ * ```ts
+ * const queue = injectQueuer(fn, {
+ *   started: true,
+ *   onUnmount: (q) => q.flush()
+ * });
+ * ```
  */
-declare function injectQueuer<TValue, TSelected = {}>(fn: (item: TValue) => void, options?: QueuerOptions<TValue>, selector?: (state: QueuerState<TValue>) => TSelected): AngularQueuer<TValue, TSelected>;
+declare function injectQueuer<TValue, TSelected = {}>(fn: (item: TValue) => void, options?: AngularQueuerOptions<TValue, TSelected>, selector?: (state: QueuerState<TValue>) => TSelected): AngularQueuer<TValue, TSelected>;
 //#endregion
-export { AngularQueuer, injectQueuer };
+export { AngularQueuer, AngularQueuerOptions, injectQueuer };
 //# sourceMappingURL=injectQueuer.d.ts.map

package/dist/queuer/injectQueuer.js

@@ -1,4 +1,5 @@
 import { injectPacerOptions } from "../provider/pacer-context.js";
+import { DestroyRef, inject } from "@angular/core";
 import { injectStore } from "@tanstack/angular-store";
 import { Queuer } from "@tanstack/pacer/queuer";
 
@@ -43,17 +44,35 @@ import { Queuer } from "@tanstack/pacer/queuer";
 * // Access the selected state
 * const { items, isRunning } = queue.state();
 * ```
+*
+* ## Cleanup on Destroy
+*
+* By default, the function stops the queuer when the component is destroyed.
+* Use the `onUnmount` option to customize this. For example, to flush pending items instead:
+*
+* ```ts
+* const queue = injectQueuer(fn, {
+*   started: true,
+*   onUnmount: (q) => q.flush()
+* });
+* ```
 */
 function injectQueuer(fn, options = {}, selector = () => ({})) {
-	const queuer = new Queuer(fn, {
+	const mergedOptions = {
 		...injectPacerOptions().queuer,
 		...options
-	});
+	};
+	const queuer = new Queuer(fn, mergedOptions);
 	const state = injectStore(queuer.store, selector);
-	return {
+	const result = {
 		...queuer,
 		state
 	};
+	inject(DestroyRef, { optional: true })?.onDestroy(() => {
+		if (mergedOptions.onUnmount) mergedOptions.onUnmount(result);
+		else queuer.stop();
+	});
+	return result;
 }
 
 //#endregion

package/dist/queuer/injectQueuer.js.map

@@ -1 +1 @@
-{"version":3,"file":"injectQueuer.js","names":[],"sources":["../../src/queuer/injectQueuer.ts"],"sourcesContent":["import { injectStore } from '@tanstack/angular-store'\nimport { Queuer } from '@tanstack/pacer/queuer'\nimport { injectPacerOptions } from '../provider/pacer-context'\nimport type { Signal } from '@angular/core'\nimport type { Store } from '@tanstack/store'\nimport type { QueuerOptions, QueuerState } from '@tanstack/pacer/queuer'\n\nexport interface AngularQueuer<TValue, TSelected = {}> extends Omit<\n  Queuer<TValue>,\n  'store'\n> {\n  /**\n   * Reactive state signal that will be updated when the queuer state changes\n   *\n   * Use this instead of `queuer.store.state`\n   */\n  readonly state: Signal<Readonly<TSelected>>\n  /**\n   * @deprecated Use `queuer.state` instead of `queuer.store.state` if you want to read reactive state.\n   * The state on the store object is not reactive in Angular signals.\n   */\n  readonly store: Store<Readonly<QueuerState<TValue>>>\n}\n\n/**\n * An Angular function that creates and manages a Queuer instance.\n *\n * This is a lower-level function that provides direct access to the Queuer's functionality.\n * This allows you to integrate it with any state management solution you prefer.\n *\n * The Queuer processes items synchronously in order, with optional delays between processing each item.\n * The queuer includes an internal tick mechanism that can be started and stopped, making it useful as a scheduler.\n *\n * ## State Management and Selector\n *\n * The function uses TanStack Store for state management and wraps it with Angular signals.\n * The `selector` parameter allows you to specify which state changes will trigger signal updates,\n * optimizing performance by preventing unnecessary updates 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 updates and gives you\n * full control over when your component tracks state changes.\n *\n * @example\n * ```ts\n * // Default behavior - no reactive state subscriptions\n * const queue = injectQueuer(\n *   (item) => console.log('Processing:', item),\n *   { started: true, wait: 1000 }\n * );\n *\n * // Opt-in to track queue contents changes\n * const queue = injectQueuer(\n *   (item) => console.log('Processing:', item),\n *   { started: true, wait: 1000 },\n *   (state) => ({ items: state.items, size: state.size })\n * );\n *\n * // Add items\n * queue.addItem('task1');\n *\n * // Access the selected state\n * const { items, isRunning } = queue.state();\n * ```\n */\nexport function injectQueuer<TValue, TSelected = {}>(\n  fn: (item: TValue) => void,\n  options: QueuerOptions<TValue> = {},\n  selector: (state: QueuerState<TValue>) => TSelected = () => ({}) as TSelected,\n): AngularQueuer<TValue, TSelected> {\n  const mergedOptions = {\n    ...injectPacerOptions().queuer,\n    ...options,\n  } as QueuerOptions<TValue>\n\n  const queuer = new Queuer<TValue>(fn, mergedOptions)\n  const state = injectStore(queuer.store, selector)\n\n  return {\n    ...queuer,\n    state,\n  } as AngularQueuer<TValue, TSelected>\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAiEA,SAAgB,aACd,IACA,UAAiC,EAAE,EACnC,kBAA6D,EAAE,GAC7B;CAMlC,MAAM,SAAS,IAAI,OAAe,IALZ;EACpB,GAAG,oBAAoB,CAAC;EACxB,GAAG;EACJ,CAEmD;CACpD,MAAM,QAAQ,YAAY,OAAO,OAAO,SAAS;AAEjD,QAAO;EACL,GAAG;EACH;EACD"}
+{"version":3,"file":"injectQueuer.js","names":[],"sources":["../../src/queuer/injectQueuer.ts"],"sourcesContent":["import { DestroyRef, inject } from '@angular/core'\nimport { injectStore } from '@tanstack/angular-store'\nimport { Queuer } from '@tanstack/pacer/queuer'\nimport { injectPacerOptions } from '../provider/pacer-context'\nimport type { Signal } from '@angular/core'\nimport type { Store } from '@tanstack/angular-store'\nimport type { QueuerOptions, QueuerState } from '@tanstack/pacer/queuer'\n\nexport interface AngularQueuerOptions<\n  TValue,\n  TSelected = {},\n> extends QueuerOptions<TValue> {\n  /**\n   * Optional callback invoked when the component is destroyed. Receives the queuer instance.\n   * When provided, replaces the default cleanup (stop); use it to call flush(), stop(), add logging, etc.\n   */\n  onUnmount?: (queuer: AngularQueuer<TValue, TSelected>) => void\n}\n\nexport interface AngularQueuer<TValue, TSelected = {}> extends Omit<\n  Queuer<TValue>,\n  'store'\n> {\n  /**\n   * Reactive state signal that will be updated when the queuer state changes\n   *\n   * Use this instead of `queuer.store.state`\n   */\n  readonly state: Signal<Readonly<TSelected>>\n  /**\n   * @deprecated Use `queuer.state` instead of `queuer.store.state` if you want to read reactive state.\n   * The state on the store object is not reactive in Angular signals.\n   */\n  readonly store: Store<Readonly<QueuerState<TValue>>>\n}\n\n/**\n * An Angular function that creates and manages a Queuer instance.\n *\n * This is a lower-level function that provides direct access to the Queuer's functionality.\n * This allows you to integrate it with any state management solution you prefer.\n *\n * The Queuer processes items synchronously in order, with optional delays between processing each item.\n * The queuer includes an internal tick mechanism that can be started and stopped, making it useful as a scheduler.\n *\n * ## State Management and Selector\n *\n * The function uses TanStack Store for state management and wraps it with Angular signals.\n * The `selector` parameter allows you to specify which state changes will trigger signal updates,\n * optimizing performance by preventing unnecessary updates 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 updates and gives you\n * full control over when your component tracks state changes.\n *\n * @example\n * ```ts\n * // Default behavior - no reactive state subscriptions\n * const queue = injectQueuer(\n *   (item) => console.log('Processing:', item),\n *   { started: true, wait: 1000 }\n * );\n *\n * // Opt-in to track queue contents changes\n * const queue = injectQueuer(\n *   (item) => console.log('Processing:', item),\n *   { started: true, wait: 1000 },\n *   (state) => ({ items: state.items, size: state.size })\n * );\n *\n * // Add items\n * queue.addItem('task1');\n *\n * // Access the selected state\n * const { items, isRunning } = queue.state();\n * ```\n *\n * ## Cleanup on Destroy\n *\n * By default, the function stops the queuer when the component is destroyed.\n * Use the `onUnmount` option to customize this. For example, to flush pending items instead:\n *\n * ```ts\n * const queue = injectQueuer(fn, {\n *   started: true,\n *   onUnmount: (q) => q.flush()\n * });\n * ```\n */\nexport function injectQueuer<TValue, TSelected = {}>(\n  fn: (item: TValue) => void,\n  options: AngularQueuerOptions<TValue, TSelected> = {},\n  selector: (state: QueuerState<TValue>) => TSelected = () => ({}) as TSelected,\n): AngularQueuer<TValue, TSelected> {\n  const mergedOptions = {\n    ...injectPacerOptions().queuer,\n    ...options,\n  } as AngularQueuerOptions<TValue, TSelected>\n\n  const queuer = new Queuer<TValue>(fn, mergedOptions)\n  const state = injectStore(queuer.store, selector)\n\n  const result = {\n    ...queuer,\n    state,\n  } as AngularQueuer<TValue, TSelected>\n\n  const destroyRef = inject(DestroyRef, { optional: true })\n  destroyRef?.onDestroy(() => {\n    if (mergedOptions.onUnmount) {\n      mergedOptions.onUnmount(result)\n    } else {\n      queuer.stop()\n    }\n  })\n\n  return result\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAyFA,SAAgB,aACd,IACA,UAAmD,EAAE,EACrD,kBAA6D,EAAE,GAC7B;CAClC,MAAM,gBAAgB;EACpB,GAAG,oBAAoB,CAAC;EACxB,GAAG;EACJ;CAED,MAAM,SAAS,IAAI,OAAe,IAAI,cAAc;CACpD,MAAM,QAAQ,YAAY,OAAO,OAAO,SAAS;CAEjD,MAAM,SAAS;EACb,GAAG;EACH;EACD;AAGD,CADmB,OAAO,YAAY,EAAE,UAAU,MAAM,CAAC,EAC7C,gBAAgB;AAC1B,MAAI,cAAc,UAChB,eAAc,UAAU,OAAO;MAE/B,QAAO,MAAM;GAEf;AAEF,QAAO"}

package/dist/rate-limiter/index.d.cts

@@ -1,6 +1,6 @@
 import { injectRateLimitedCallback } from "./injectRateLimitedCallback.cjs";
-import { AngularRateLimiter, injectRateLimiter } from "./injectRateLimiter.cjs";
+import { AngularRateLimiter, AngularRateLimiterOptions, injectRateLimiter } from "./injectRateLimiter.cjs";
 import { RateLimitedSignal, injectRateLimitedSignal } from "./injectRateLimitedSignal.cjs";
 import { injectRateLimitedValue } from "./injectRateLimitedValue.cjs";
 export * from "@tanstack/pacer/rate-limiter";
-export { AngularRateLimiter, RateLimitedSignal, injectRateLimitedCallback, injectRateLimitedSignal, injectRateLimitedValue, injectRateLimiter };
+export { AngularRateLimiter, AngularRateLimiterOptions, RateLimitedSignal, injectRateLimitedCallback, injectRateLimitedSignal, injectRateLimitedValue, injectRateLimiter };

package/dist/rate-limiter/index.d.ts

@@ -1,6 +1,6 @@
 import { injectRateLimitedCallback } from "./injectRateLimitedCallback.js";
-import { AngularRateLimiter, injectRateLimiter } from "./injectRateLimiter.js";
+import { AngularRateLimiter, AngularRateLimiterOptions, injectRateLimiter } from "./injectRateLimiter.js";
 import { RateLimitedSignal, injectRateLimitedSignal } from "./injectRateLimitedSignal.js";
 import { injectRateLimitedValue } from "./injectRateLimitedValue.js";
 export * from "@tanstack/pacer/rate-limiter";
-export { AngularRateLimiter, RateLimitedSignal, injectRateLimitedCallback, injectRateLimitedSignal, injectRateLimitedValue, injectRateLimiter };
+export { AngularRateLimiter, AngularRateLimiterOptions, RateLimitedSignal, injectRateLimitedCallback, injectRateLimitedSignal, injectRateLimitedValue, injectRateLimiter };

package/dist/rate-limiter/injectRateLimiter.cjs

@@ -1,4 +1,5 @@
 const require_pacer_context = require('../provider/pacer-context.cjs');
+let _angular_core = require("@angular/core");
 let _tanstack_angular_store = require("@tanstack/angular-store");
 let _tanstack_pacer_rate_limiter = require("@tanstack/pacer/rate-limiter");
 
@@ -39,6 +40,10 @@ let _tanstack_pacer_rate_limiter = require("@tanstack/pacer/rate-limiter");
 * - `executionTimes`: Array of timestamps when executions occurred for rate limiting calculations
 * - `rejectionCount`: Number of function executions that have been rejected due to rate limiting
 *
+* ## Cleanup on Destroy
+*
+* Use the `onUnmount` option to run a callback when the component is destroyed.
+*
 * @example
 * ```ts
 * // Default behavior - no reactive state subscriptions
@@ -74,15 +79,20 @@ let _tanstack_pacer_rate_limiter = require("@tanstack/pacer/rate-limiter");
 * ```
 */
 function injectRateLimiter(fn, options, selector = () => ({})) {
-	const rateLimiter = new _tanstack_pacer_rate_limiter.RateLimiter(fn, {
+	const mergedOptions = {
 		...require_pacer_context.injectPacerOptions().rateLimiter,
 		...options
-	});
+	};
+	const rateLimiter = new _tanstack_pacer_rate_limiter.RateLimiter(fn, mergedOptions);
 	const state = (0, _tanstack_angular_store.injectStore)(rateLimiter.store, selector);
-	return {
+	const result = {
 		...rateLimiter,
 		state
 	};
+	(0, _angular_core.inject)(_angular_core.DestroyRef, { optional: true })?.onDestroy(() => {
+		if (mergedOptions.onUnmount) mergedOptions.onUnmount(result);
+	});
+	return result;
 }
 
 //#endregion

package/dist/rate-limiter/injectRateLimiter.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"injectRateLimiter.cjs","names":["RateLimiter","injectPacerOptions"],"sources":["../../src/rate-limiter/injectRateLimiter.ts"],"sourcesContent":["import { injectStore } from '@tanstack/angular-store'\nimport { RateLimiter } from '@tanstack/pacer/rate-limiter'\nimport { injectPacerOptions } from '../provider/pacer-context'\nimport type { Signal } from '@angular/core'\nimport type { Store } from '@tanstack/store'\nimport type { AnyFunction } from '@tanstack/pacer/types'\nimport type {\n  RateLimiterOptions,\n  RateLimiterState,\n} from '@tanstack/pacer/rate-limiter'\n\nexport interface AngularRateLimiter<\n  TFn extends AnyFunction,\n  TSelected = {},\n> extends Omit<RateLimiter<TFn>, 'store'> {\n  /**\n   * Reactive state signal that will be updated when the rate limiter state changes\n   *\n   * Use this instead of `rateLimiter.store.state`\n   */\n  readonly state: Signal<Readonly<TSelected>>\n  /**\n   * @deprecated Use `rateLimiter.state` instead of `rateLimiter.store.state` if you want to read reactive state.\n   * The state on the store object is not reactive in Angular signals.\n   */\n  readonly store: Store<Readonly<RateLimiterState>>\n}\n\n/**\n * An Angular function that creates and manages a RateLimiter instance.\n *\n * This is a lower-level function that provides direct access to the RateLimiter's functionality.\n * This allows you to integrate it with any state management solution you prefer.\n *\n * Rate limiting is a simple \"hard limit\" approach that allows executions until a maximum count is reached within\n * a time window, then blocks all subsequent calls until the window resets. Unlike throttling or debouncing,\n * it does not attempt to space out or collapse executions intelligently.\n *\n * The rate limiter supports two types of windows:\n * - 'fixed': A strict window that resets after the window period. All executions within the window count\n *   towards the limit, and the window resets completely after the period.\n * - 'sliding': A rolling window that allows executions as old ones expire. This provides a more\n *   consistent rate of execution over time.\n *\n * For smoother execution patterns:\n * - Use throttling when you want consistent spacing between executions (e.g. UI updates)\n * - Use debouncing when you want to collapse rapid-fire events (e.g. search input)\n * - Use rate limiting only when you need to enforce hard limits (e.g. API rate limits)\n *\n * ## State Management and Selector\n *\n * The function uses TanStack Store for state management and wraps it with Angular signals.\n * The `selector` parameter allows you to specify which state changes will trigger signal updates,\n * optimizing performance by preventing unnecessary updates 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 updates and gives you\n * full control over when your component tracks state changes.\n *\n * Available state properties:\n * - `executionCount`: Number of function executions that have been completed\n * - `executionTimes`: Array of timestamps when executions occurred for rate limiting calculations\n * - `rejectionCount`: Number of function executions that have been rejected due to rate limiting\n *\n * @example\n * ```ts\n * // Default behavior - no reactive state subscriptions\n * const rateLimiter = injectRateLimiter(apiCall, {\n *   limit: 5,\n *   window: 60000,\n *   windowType: 'sliding',\n * });\n *\n * // Opt-in to track execution count changes\n * const rateLimiter = injectRateLimiter(\n *   apiCall,\n *   {\n *     limit: 5,\n *     window: 60000,\n *     windowType: 'sliding',\n *   },\n *   (state) => ({ executionCount: state.executionCount })\n * );\n *\n * // Monitor rate limit status\n * const handleClick = () => {\n *   const remaining = rateLimiter.getRemainingInWindow();\n *   if (remaining > 0) {\n *     rateLimiter.maybeExecute(data);\n *   } else {\n *     showRateLimitWarning();\n *   }\n * };\n *\n * // Access the selected state (will be empty object {} unless selector provided)\n * const { executionCount, rejectionCount } = rateLimiter.state();\n * ```\n */\nexport function injectRateLimiter<TFn extends AnyFunction, TSelected = {}>(\n  fn: TFn,\n  options: RateLimiterOptions<TFn>,\n  selector: (state: RateLimiterState) => TSelected = () => ({}) as TSelected,\n): AngularRateLimiter<TFn, TSelected> {\n  const mergedOptions = {\n    ...injectPacerOptions().rateLimiter,\n    ...options,\n  } as RateLimiterOptions<TFn>\n\n  const rateLimiter = new RateLimiter<TFn>(fn, mergedOptions)\n  const state = injectStore(rateLimiter.store, selector)\n\n  return {\n    ...rateLimiter,\n    state,\n  } as AngularRateLimiter<TFn, TSelected>\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAkGA,SAAgB,kBACd,IACA,SACA,kBAA0D,EAAE,GACxB;CAMpC,MAAM,cAAc,IAAIA,yCAAiB,IALnB;EACpB,GAAGC,0CAAoB,CAAC;EACxB,GAAG;EACJ,CAE0D;CAC3D,MAAM,iDAAoB,YAAY,OAAO,SAAS;AAEtD,QAAO;EACL,GAAG;EACH;EACD"}
+{"version":3,"file":"injectRateLimiter.cjs","names":["injectPacerOptions","RateLimiter","DestroyRef"],"sources":["../../src/rate-limiter/injectRateLimiter.ts"],"sourcesContent":["import { DestroyRef, inject } from '@angular/core'\nimport { injectStore } from '@tanstack/angular-store'\nimport { RateLimiter } from '@tanstack/pacer/rate-limiter'\nimport { injectPacerOptions } from '../provider/pacer-context'\nimport type { Signal } from '@angular/core'\nimport type { Store } from '@tanstack/angular-store'\nimport type { AnyFunction } from '@tanstack/pacer/types'\nimport type {\n  RateLimiterOptions,\n  RateLimiterState,\n} from '@tanstack/pacer/rate-limiter'\n\nexport interface AngularRateLimiterOptions<\n  TFn extends AnyFunction,\n  TSelected = {},\n> extends RateLimiterOptions<TFn> {\n  /**\n   * Optional callback invoked when the component is destroyed. Receives the rate limiter instance.\n   */\n  onUnmount?: (rateLimiter: AngularRateLimiter<TFn, TSelected>) => void\n}\n\nexport interface AngularRateLimiter<\n  TFn extends AnyFunction,\n  TSelected = {},\n> extends Omit<RateLimiter<TFn>, 'store'> {\n  /**\n   * Reactive state signal that will be updated when the rate limiter state changes\n   *\n   * Use this instead of `rateLimiter.store.state`\n   */\n  readonly state: Signal<Readonly<TSelected>>\n  /**\n   * @deprecated Use `rateLimiter.state` instead of `rateLimiter.store.state` if you want to read reactive state.\n   * The state on the store object is not reactive in Angular signals.\n   */\n  readonly store: Store<Readonly<RateLimiterState>>\n}\n\n/**\n * An Angular function that creates and manages a RateLimiter instance.\n *\n * This is a lower-level function that provides direct access to the RateLimiter's functionality.\n * This allows you to integrate it with any state management solution you prefer.\n *\n * Rate limiting is a simple \"hard limit\" approach that allows executions until a maximum count is reached within\n * a time window, then blocks all subsequent calls until the window resets. Unlike throttling or debouncing,\n * it does not attempt to space out or collapse executions intelligently.\n *\n * The rate limiter supports two types of windows:\n * - 'fixed': A strict window that resets after the window period. All executions within the window count\n *   towards the limit, and the window resets completely after the period.\n * - 'sliding': A rolling window that allows executions as old ones expire. This provides a more\n *   consistent rate of execution over time.\n *\n * For smoother execution patterns:\n * - Use throttling when you want consistent spacing between executions (e.g. UI updates)\n * - Use debouncing when you want to collapse rapid-fire events (e.g. search input)\n * - Use rate limiting only when you need to enforce hard limits (e.g. API rate limits)\n *\n * ## State Management and Selector\n *\n * The function uses TanStack Store for state management and wraps it with Angular signals.\n * The `selector` parameter allows you to specify which state changes will trigger signal updates,\n * optimizing performance by preventing unnecessary updates 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 updates and gives you\n * full control over when your component tracks state changes.\n *\n * Available state properties:\n * - `executionCount`: Number of function executions that have been completed\n * - `executionTimes`: Array of timestamps when executions occurred for rate limiting calculations\n * - `rejectionCount`: Number of function executions that have been rejected due to rate limiting\n *\n * ## Cleanup on Destroy\n *\n * Use the `onUnmount` option to run a callback when the component is destroyed.\n *\n * @example\n * ```ts\n * // Default behavior - no reactive state subscriptions\n * const rateLimiter = injectRateLimiter(apiCall, {\n *   limit: 5,\n *   window: 60000,\n *   windowType: 'sliding',\n * });\n *\n * // Opt-in to track execution count changes\n * const rateLimiter = injectRateLimiter(\n *   apiCall,\n *   {\n *     limit: 5,\n *     window: 60000,\n *     windowType: 'sliding',\n *   },\n *   (state) => ({ executionCount: state.executionCount })\n * );\n *\n * // Monitor rate limit status\n * const handleClick = () => {\n *   const remaining = rateLimiter.getRemainingInWindow();\n *   if (remaining > 0) {\n *     rateLimiter.maybeExecute(data);\n *   } else {\n *     showRateLimitWarning();\n *   }\n * };\n *\n * // Access the selected state (will be empty object {} unless selector provided)\n * const { executionCount, rejectionCount } = rateLimiter.state();\n * ```\n */\nexport function injectRateLimiter<TFn extends AnyFunction, TSelected = {}>(\n  fn: TFn,\n  options: AngularRateLimiterOptions<TFn, TSelected>,\n  selector: (state: RateLimiterState) => TSelected = () => ({}) as TSelected,\n): AngularRateLimiter<TFn, TSelected> {\n  const mergedOptions = {\n    ...injectPacerOptions().rateLimiter,\n    ...options,\n  } as AngularRateLimiterOptions<TFn, TSelected>\n\n  const rateLimiter = new RateLimiter<TFn>(fn, mergedOptions)\n  const state = injectStore(rateLimiter.store, selector)\n\n  const result = {\n    ...rateLimiter,\n    state,\n  } as AngularRateLimiter<TFn, TSelected>\n\n  const destroyRef = inject(DestroyRef, { optional: true })\n  destroyRef?.onDestroy(() => {\n    if (mergedOptions.onUnmount) {\n      mergedOptions.onUnmount(result)\n    }\n  })\n\n  return result\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAiHA,SAAgB,kBACd,IACA,SACA,kBAA0D,EAAE,GACxB;CACpC,MAAM,gBAAgB;EACpB,GAAGA,0CAAoB,CAAC;EACxB,GAAG;EACJ;CAED,MAAM,cAAc,IAAIC,yCAAiB,IAAI,cAAc;CAC3D,MAAM,iDAAoB,YAAY,OAAO,SAAS;CAEtD,MAAM,SAAS;EACb,GAAG;EACH;EACD;AAGD,2BAD0BC,0BAAY,EAAE,UAAU,MAAM,CAAC,EAC7C,gBAAgB;AAC1B,MAAI,cAAc,UAChB,eAAc,UAAU,OAAO;GAEjC;AAEF,QAAO"}

package/dist/rate-limiter/injectRateLimiter.d.cts

@@ -1,9 +1,15 @@
 import { Signal } from "@angular/core";
-import { Store } from "@tanstack/store";
+import { Store } from "@tanstack/angular-store";
 import { AnyFunction } from "@tanstack/pacer/types";
 import { RateLimiter, RateLimiterOptions, RateLimiterState } from "@tanstack/pacer/rate-limiter";
 
 //#region src/rate-limiter/injectRateLimiter.d.ts
+interface AngularRateLimiterOptions<TFn extends AnyFunction, TSelected = {}> extends RateLimiterOptions<TFn> {
+  /**
+   * Optional callback invoked when the component is destroyed. Receives the rate limiter instance.
+   */
+  onUnmount?: (rateLimiter: AngularRateLimiter<TFn, TSelected>) => void;
+}
 interface AngularRateLimiter<TFn extends AnyFunction, TSelected = {}> extends Omit<RateLimiter<TFn>, 'store'> {
   /**
    * Reactive state signal that will be updated when the rate limiter state changes
@@ -53,6 +59,10 @@ interface AngularRateLimiter<TFn extends AnyFunction, TSelected = {}> extends Om
  * - `executionTimes`: Array of timestamps when executions occurred for rate limiting calculations
  * - `rejectionCount`: Number of function executions that have been rejected due to rate limiting
  *
+ * ## Cleanup on Destroy
+ *
+ * Use the `onUnmount` option to run a callback when the component is destroyed.
+ *
  * @example
  * ```ts
  * // Default behavior - no reactive state subscriptions
@@ -87,7 +97,7 @@ interface AngularRateLimiter<TFn extends AnyFunction, TSelected = {}> extends Om
  * const { executionCount, rejectionCount } = rateLimiter.state();
  * ```
  */
-declare function injectRateLimiter<TFn extends AnyFunction, TSelected = {}>(fn: TFn, options: RateLimiterOptions<TFn>, selector?: (state: RateLimiterState) => TSelected): AngularRateLimiter<TFn, TSelected>;
+declare function injectRateLimiter<TFn extends AnyFunction, TSelected = {}>(fn: TFn, options: AngularRateLimiterOptions<TFn, TSelected>, selector?: (state: RateLimiterState) => TSelected): AngularRateLimiter<TFn, TSelected>;
 //#endregion
-export { AngularRateLimiter, injectRateLimiter };
+export { AngularRateLimiter, AngularRateLimiterOptions, injectRateLimiter };
 //# sourceMappingURL=injectRateLimiter.d.cts.map

package/dist/rate-limiter/injectRateLimiter.d.ts

@@ -1,9 +1,15 @@
 import { Signal } from "@angular/core";
+import { Store } from "@tanstack/angular-store";
 import { RateLimiter, RateLimiterOptions, RateLimiterState } from "@tanstack/pacer/rate-limiter";
 import { AnyFunction } from "@tanstack/pacer/types";
-import { Store } from "@tanstack/store";
 
 //#region src/rate-limiter/injectRateLimiter.d.ts
+interface AngularRateLimiterOptions<TFn extends AnyFunction, TSelected = {}> extends RateLimiterOptions<TFn> {
+  /**
+   * Optional callback invoked when the component is destroyed. Receives the rate limiter instance.
+   */
+  onUnmount?: (rateLimiter: AngularRateLimiter<TFn, TSelected>) => void;
+}
 interface AngularRateLimiter<TFn extends AnyFunction, TSelected = {}> extends Omit<RateLimiter<TFn>, 'store'> {
   /**
    * Reactive state signal that will be updated when the rate limiter state changes
@@ -53,6 +59,10 @@ interface AngularRateLimiter<TFn extends AnyFunction, TSelected = {}> extends Om
  * - `executionTimes`: Array of timestamps when executions occurred for rate limiting calculations
  * - `rejectionCount`: Number of function executions that have been rejected due to rate limiting
  *
+ * ## Cleanup on Destroy
+ *
+ * Use the `onUnmount` option to run a callback when the component is destroyed.
+ *
  * @example
  * ```ts
  * // Default behavior - no reactive state subscriptions
@@ -87,7 +97,7 @@ interface AngularRateLimiter<TFn extends AnyFunction, TSelected = {}> extends Om
  * const { executionCount, rejectionCount } = rateLimiter.state();
  * ```
  */
-declare function injectRateLimiter<TFn extends AnyFunction, TSelected = {}>(fn: TFn, options: RateLimiterOptions<TFn>, selector?: (state: RateLimiterState) => TSelected): AngularRateLimiter<TFn, TSelected>;
+declare function injectRateLimiter<TFn extends AnyFunction, TSelected = {}>(fn: TFn, options: AngularRateLimiterOptions<TFn, TSelected>, selector?: (state: RateLimiterState) => TSelected): AngularRateLimiter<TFn, TSelected>;
 //#endregion
-export { AngularRateLimiter, injectRateLimiter };
+export { AngularRateLimiter, AngularRateLimiterOptions, injectRateLimiter };
 //# sourceMappingURL=injectRateLimiter.d.ts.map

package/dist/rate-limiter/injectRateLimiter.js

@@ -1,4 +1,5 @@
 import { injectPacerOptions } from "../provider/pacer-context.js";
+import { DestroyRef, inject } from "@angular/core";
 import { injectStore } from "@tanstack/angular-store";
 import { RateLimiter } from "@tanstack/pacer/rate-limiter";
 
@@ -39,6 +40,10 @@ import { RateLimiter } from "@tanstack/pacer/rate-limiter";
 * - `executionTimes`: Array of timestamps when executions occurred for rate limiting calculations
 * - `rejectionCount`: Number of function executions that have been rejected due to rate limiting
 *
+* ## Cleanup on Destroy
+*
+* Use the `onUnmount` option to run a callback when the component is destroyed.
+*
 * @example
 * ```ts
 * // Default behavior - no reactive state subscriptions
@@ -74,15 +79,20 @@ import { RateLimiter } from "@tanstack/pacer/rate-limiter";
 * ```
 */
 function injectRateLimiter(fn, options, selector = () => ({})) {
-	const rateLimiter = new RateLimiter(fn, {
+	const mergedOptions = {
 		...injectPacerOptions().rateLimiter,
 		...options
-	});
+	};
+	const rateLimiter = new RateLimiter(fn, mergedOptions);
 	const state = injectStore(rateLimiter.store, selector);
-	return {
+	const result = {
 		...rateLimiter,
 		state
 	};
+	inject(DestroyRef, { optional: true })?.onDestroy(() => {
+		if (mergedOptions.onUnmount) mergedOptions.onUnmount(result);
+	});
+	return result;
 }
 
 //#endregion