@tanstack/angular-pacer 0.20.0 → 0.22.0

package/dist/debouncer/injectDebouncer.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_debouncer = require("@tanstack/pacer/debouncer");
 
@@ -34,6 +35,18 @@ let _tanstack_pacer_debouncer = require("@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 @@ let _tanstack_pacer_debouncer = require("@tanstack/pacer/debouncer");
 * ```
 */
 function injectDebouncer(fn, options, selector = () => ({})) {
-	const debouncer = new _tanstack_pacer_debouncer.Debouncer(fn, {
+	const mergedOptions = {
 		...require_pacer_context.injectPacerOptions().debouncer,
 		...options
-	});
+	};
+	const debouncer = new _tanstack_pacer_debouncer.Debouncer(fn, mergedOptions);
 	const state = (0, _tanstack_angular_store.injectStore)(debouncer.store, selector);
-	return {
+	const result = {
 		...debouncer,
 		state
 	};
+	(0, _angular_core.inject)(_angular_core.DestroyRef, { optional: true })?.onDestroy(() => {
+		if (mergedOptions.onUnmount) mergedOptions.onUnmount(result);
+		else debouncer.cancel();
+	});
+	return result;
 }
 
 //#endregion

package/dist/debouncer/injectDebouncer.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"injectDebouncer.cjs","names":["Debouncer","injectPacerOptions"],"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,IAAIA,oCAAe,IALf;EACpB,GAAGC,0CAAoB,CAAC;EACxB,GAAG;EACJ,CAEsD;CACvD,MAAM,iDAAoB,UAAU,OAAO,SAAS;AAEpD,QAAO;EACL,GAAG;EACH;EACD"}
+{"version":3,"file":"injectDebouncer.cjs","names":["injectPacerOptions","Debouncer","DestroyRef"],"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,GAAGA,0CAAoB,CAAC;EACxB,GAAG;EACJ;CAED,MAAM,YAAY,IAAIC,oCAAe,IAAI,cAAc;CACvD,MAAM,iDAAoB,UAAU,OAAO,SAAS;CAEpD,MAAM,SAAS;EACb,GAAG;EACH;EACD;AAGD,2BAD0BC,0BAAY,EAAE,UAAU,MAAM,CAAC,EAC7C,gBAAgB;AAC1B,MAAI,cAAc,UAChB,eAAc,UAAU,OAAO;MAE/B,WAAU,QAAQ;GAEpB;AAEF,QAAO"}

package/dist/debouncer/injectDebouncer.d.cts

@@ -1,9 +1,16 @@
 import { Signal } from "@angular/core";
-import { Store } from "@tanstack/store";
+import { Store } from "@tanstack/angular-store";
 import { AnyFunction } from "@tanstack/pacer/types";
 import { Debouncer, DebouncerOptions, DebouncerState } from "@tanstack/pacer/debouncer";
 
 //#region src/debouncer/injectDebouncer.d.ts
+interface AngularDebouncerOptions<TFn extends AnyFunction, TSelected = {}> extends DebouncerOptions<TFn> {
+  /**
+   * Optional callback invoked when the component is destroyed. Receives the debouncer instance.
+   * When provided, replaces the default cleanup (cancel); use it to call flush(), cancel(), add logging, etc.
+   */
+  onUnmount?: (debouncer: AngularDebouncer<TFn, TSelected>) => void;
+}
 interface AngularDebouncer<TFn extends AnyFunction, TSelected = {}> extends Omit<Debouncer<TFn>, 'store'> {
   /**
    * Reactive state signal that will be updated when the debouncer state changes
@@ -48,6 +55,18 @@ interface AngularDebouncer<TFn extends AnyFunction, TSelected = {}> extends Omit
  * - `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
@@ -73,7 +92,7 @@ interface AngularDebouncer<TFn extends AnyFunction, TSelected = {}> extends Omit
  * const { isPending } = debouncer.state();
  * ```
  */
-declare function injectDebouncer<TFn extends AnyFunction, TSelected = {}>(fn: TFn, options: DebouncerOptions<TFn>, selector?: (state: DebouncerState<TFn>) => TSelected): AngularDebouncer<TFn, TSelected>;
+declare function injectDebouncer<TFn extends AnyFunction, TSelected = {}>(fn: TFn, options: AngularDebouncerOptions<TFn, TSelected>, selector?: (state: DebouncerState<TFn>) => TSelected): AngularDebouncer<TFn, TSelected>;
 //#endregion
-export { AngularDebouncer, injectDebouncer };
+export { AngularDebouncer, AngularDebouncerOptions, injectDebouncer };
 //# sourceMappingURL=injectDebouncer.d.cts.map

package/dist/debouncer/injectDebouncer.d.ts

@@ -1,9 +1,16 @@
 import { Signal } from "@angular/core";
+import { Store } from "@tanstack/angular-store";
 import { Debouncer, DebouncerOptions, DebouncerState } from "@tanstack/pacer/debouncer";
 import { AnyFunction } from "@tanstack/pacer/types";
-import { Store } from "@tanstack/store";
 
 //#region src/debouncer/injectDebouncer.d.ts
+interface AngularDebouncerOptions<TFn extends AnyFunction, TSelected = {}> extends DebouncerOptions<TFn> {
+  /**
+   * Optional callback invoked when the component is destroyed. Receives the debouncer instance.
+   * When provided, replaces the default cleanup (cancel); use it to call flush(), cancel(), add logging, etc.
+   */
+  onUnmount?: (debouncer: AngularDebouncer<TFn, TSelected>) => void;
+}
 interface AngularDebouncer<TFn extends AnyFunction, TSelected = {}> extends Omit<Debouncer<TFn>, 'store'> {
   /**
    * Reactive state signal that will be updated when the debouncer state changes
@@ -48,6 +55,18 @@ interface AngularDebouncer<TFn extends AnyFunction, TSelected = {}> extends Omit
  * - `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
@@ -73,7 +92,7 @@ interface AngularDebouncer<TFn extends AnyFunction, TSelected = {}> extends Omit
  * const { isPending } = debouncer.state();
  * ```
  */
-declare function injectDebouncer<TFn extends AnyFunction, TSelected = {}>(fn: TFn, options: DebouncerOptions<TFn>, selector?: (state: DebouncerState<TFn>) => TSelected): AngularDebouncer<TFn, TSelected>;
+declare function injectDebouncer<TFn extends AnyFunction, TSelected = {}>(fn: TFn, options: AngularDebouncerOptions<TFn, TSelected>, selector?: (state: DebouncerState<TFn>) => TSelected): AngularDebouncer<TFn, TSelected>;
 //#endregion
-export { AngularDebouncer, injectDebouncer };
+export { AngularDebouncer, AngularDebouncerOptions, injectDebouncer };
 //# sourceMappingURL=injectDebouncer.d.ts.map

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/injectQueuedSignal.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"injectQueuedSignal.cjs","names":["injectQueuer"],"sources":["../../src/queuer/injectQueuedSignal.ts"],"sourcesContent":["import { computed } from '@angular/core'\nimport { injectQueuer } from './injectQueuer'\nimport type { AngularQueuer } from './injectQueuer'\nimport type { QueuerOptions, QueuerState } from '@tanstack/pacer/queuer'\n\nexport type QueuedSignal<TValue, TSelected = {}> = (() => Array<TValue>) & {\n  /**\n   * Add an item to the queue.\n   */\n  readonly addItem: AngularQueuer<TValue, TSelected>['addItem']\n  /**\n   * The queuer instance with additional control methods and state signals.\n   */\n  readonly queuer: AngularQueuer<TValue, TSelected>\n}\n\n/**\n * An Angular function that creates a queuer with managed state, combining Angular's signals with queuing functionality.\n * This function provides both the current queue state and queue control methods.\n *\n * The queue state is automatically updated whenever items are added, removed, or reordered in the queue.\n * All queue operations are reflected in the state array returned by the function.\n *\n * The function returns a callable object:\n * - `queued()`: Get the current queue items as an array\n * - `queued.addItem(...)`: Add an item to the queue\n * - `queued.queue`: The queuer instance with additional control methods\n *\n * @example\n * ```ts\n * // Default behavior - track items\n * const queued = injectQueuedSignal(\n *   (item) => console.log('Processing:', item),\n *   { started: true, wait: 1000 }\n * );\n *\n * // Add items\n * queued.addItem('task1');\n *\n * // Access items\n * console.log(queued()); // ['task1']\n *\n * // Control the queue\n * queued.queuer.start();\n * queued.queuer.stop();\n * ```\n */\nexport function injectQueuedSignal<\n  TValue,\n  TSelected extends Pick<QueuerState<TValue>, 'items'> = Pick<\n    QueuerState<TValue>,\n    'items'\n  >,\n>(\n  fn: (item: TValue) => void,\n  options: QueuerOptions<TValue> = {},\n  selector: (state: QueuerState<TValue>) => TSelected = (state) =>\n    ({ items: state.items }) as TSelected,\n): QueuedSignal<TValue, TSelected> {\n  const queuer = injectQueuer(fn, options, selector)\n\n  const items = computed(() => queuer.state().items as Array<TValue>)\n\n  const queued = Object.assign(items, {\n    addItem: queuer.addItem.bind(queuer),\n    queuer,\n  }) as QueuedSignal<TValue, TSelected>\n\n  return queued\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA+CA,SAAgB,mBAOd,IACA,UAAiC,EAAE,EACnC,YAAuD,WACpD,EAAE,OAAO,MAAM,OAAO,GACQ;CACjC,MAAM,SAASA,kCAAa,IAAI,SAAS,SAAS;CAElD,MAAM,0CAAuB,OAAO,OAAO,CAAC,MAAuB;AAOnE,QALe,OAAO,OAAO,OAAO;EAClC,SAAS,OAAO,QAAQ,KAAK,OAAO;EACpC;EACD,CAAC"}
+{"version":3,"file":"injectQueuedSignal.cjs","names":["injectQueuer"],"sources":["../../src/queuer/injectQueuedSignal.ts"],"sourcesContent":["import { computed } from '@angular/core'\nimport { injectQueuer } from './injectQueuer'\nimport type { AngularQueuer } from './injectQueuer'\nimport type { QueuerOptions, QueuerState } from '@tanstack/pacer/queuer'\n\nexport interface QueuedSignal<TValue, TSelected = {}> {\n  (): Array<TValue>\n  addItem: AngularQueuer<TValue, TSelected>['addItem']\n  queuer: AngularQueuer<TValue, TSelected>\n}\n\n/**\n * An Angular function that creates a queuer with managed state, combining Angular's signals with queuing functionality.\n * This function provides both the current queue state and queue control methods.\n *\n * The queue state is automatically updated whenever items are added, removed, or reordered in the queue.\n * All queue operations are reflected in the state array returned by the function.\n *\n * The function returns a callable object:\n * - `queued()`: Get the current queue items as an array\n * - `queued.addItem(...)`: Add an item to the queue\n * - `queued.queue`: The queuer instance with additional control methods\n *\n * @example\n * ```ts\n * // Default behavior - track items\n * const queued = injectQueuedSignal(\n *   (item) => console.log('Processing:', item),\n *   { started: true, wait: 1000 }\n * );\n *\n * // Add items\n * queued.addItem('task1');\n *\n * // Access items\n * console.log(queued()); // ['task1']\n *\n * // Control the queue\n * queued.queuer.start();\n * queued.queuer.stop();\n * ```\n */\nexport function injectQueuedSignal<\n  TValue,\n  TSelected extends Pick<QueuerState<TValue>, 'items'> = Pick<\n    QueuerState<TValue>,\n    'items'\n  >,\n>(\n  fn: (item: TValue) => void,\n  options: QueuerOptions<TValue> = {},\n  selector: (state: QueuerState<TValue>) => TSelected = (state) =>\n    ({ items: state.items }) as TSelected,\n): QueuedSignal<TValue, TSelected> {\n  const queuer = injectQueuer(fn, options, selector)\n\n  const items = computed(() => queuer.state().items as Array<TValue>)\n\n  const queued = Object.assign(items, {\n    addItem: queuer.addItem.bind(queuer),\n    queuer,\n  }) as QueuedSignal<TValue, TSelected>\n\n  return queued\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA0CA,SAAgB,mBAOd,IACA,UAAiC,EAAE,EACnC,YAAuD,WACpD,EAAE,OAAO,MAAM,OAAO,GACQ;CACjC,MAAM,SAASA,kCAAa,IAAI,SAAS,SAAS;CAElD,MAAM,0CAAuB,OAAO,OAAO,CAAC,MAAuB;AAOnE,QALe,OAAO,OAAO,OAAO;EAClC,SAAS,OAAO,QAAQ,KAAK,OAAO;EACpC;EACD,CAAC"}

package/dist/queuer/injectQueuedSignal.d.cts

@@ -2,16 +2,11 @@ import { AngularQueuer } from "./injectQueuer.cjs";
 import { QueuerOptions, QueuerState } from "@tanstack/pacer/queuer";
 
 //#region src/queuer/injectQueuedSignal.d.ts
-type QueuedSignal<TValue, TSelected = {}> = (() => Array<TValue>) & {
-  /**
-   * Add an item to the queue.
-   */
-  readonly addItem: AngularQueuer<TValue, TSelected>['addItem'];
-  /**
-   * The queuer instance with additional control methods and state signals.
-   */
-  readonly queuer: AngularQueuer<TValue, TSelected>;
-};
+interface QueuedSignal<TValue, TSelected = {}> {
+  (): Array<TValue>;
+  addItem: AngularQueuer<TValue, TSelected>['addItem'];
+  queuer: AngularQueuer<TValue, TSelected>;
+}
 /**
  * An Angular function that creates a queuer with managed state, combining Angular's signals with queuing functionality.
  * This function provides both the current queue state and queue control methods.

package/dist/queuer/injectQueuedSignal.d.ts

@@ -2,16 +2,11 @@ import { AngularQueuer } from "./injectQueuer.js";
 import { QueuerOptions, QueuerState } from "@tanstack/pacer/queuer";
 
 //#region src/queuer/injectQueuedSignal.d.ts
-type QueuedSignal<TValue, TSelected = {}> = (() => Array<TValue>) & {
-  /**
-   * Add an item to the queue.
-   */
-  readonly addItem: AngularQueuer<TValue, TSelected>['addItem'];
-  /**
-   * The queuer instance with additional control methods and state signals.
-   */
-  readonly queuer: AngularQueuer<TValue, TSelected>;
-};
+interface QueuedSignal<TValue, TSelected = {}> {
+  (): Array<TValue>;
+  addItem: AngularQueuer<TValue, TSelected>['addItem'];
+  queuer: AngularQueuer<TValue, TSelected>;
+}
 /**
  * An Angular function that creates a queuer with managed state, combining Angular's signals with queuing functionality.
  * This function provides both the current queue state and queue control methods.

package/dist/queuer/injectQueuedSignal.js.map

@@ -1 +1 @@
-{"version":3,"file":"injectQueuedSignal.js","names":[],"sources":["../../src/queuer/injectQueuedSignal.ts"],"sourcesContent":["import { computed } from '@angular/core'\nimport { injectQueuer } from './injectQueuer'\nimport type { AngularQueuer } from './injectQueuer'\nimport type { QueuerOptions, QueuerState } from '@tanstack/pacer/queuer'\n\nexport type QueuedSignal<TValue, TSelected = {}> = (() => Array<TValue>) & {\n  /**\n   * Add an item to the queue.\n   */\n  readonly addItem: AngularQueuer<TValue, TSelected>['addItem']\n  /**\n   * The queuer instance with additional control methods and state signals.\n   */\n  readonly queuer: AngularQueuer<TValue, TSelected>\n}\n\n/**\n * An Angular function that creates a queuer with managed state, combining Angular's signals with queuing functionality.\n * This function provides both the current queue state and queue control methods.\n *\n * The queue state is automatically updated whenever items are added, removed, or reordered in the queue.\n * All queue operations are reflected in the state array returned by the function.\n *\n * The function returns a callable object:\n * - `queued()`: Get the current queue items as an array\n * - `queued.addItem(...)`: Add an item to the queue\n * - `queued.queue`: The queuer instance with additional control methods\n *\n * @example\n * ```ts\n * // Default behavior - track items\n * const queued = injectQueuedSignal(\n *   (item) => console.log('Processing:', item),\n *   { started: true, wait: 1000 }\n * );\n *\n * // Add items\n * queued.addItem('task1');\n *\n * // Access items\n * console.log(queued()); // ['task1']\n *\n * // Control the queue\n * queued.queuer.start();\n * queued.queuer.stop();\n * ```\n */\nexport function injectQueuedSignal<\n  TValue,\n  TSelected extends Pick<QueuerState<TValue>, 'items'> = Pick<\n    QueuerState<TValue>,\n    'items'\n  >,\n>(\n  fn: (item: TValue) => void,\n  options: QueuerOptions<TValue> = {},\n  selector: (state: QueuerState<TValue>) => TSelected = (state) =>\n    ({ items: state.items }) as TSelected,\n): QueuedSignal<TValue, TSelected> {\n  const queuer = injectQueuer(fn, options, selector)\n\n  const items = computed(() => queuer.state().items as Array<TValue>)\n\n  const queued = Object.assign(items, {\n    addItem: queuer.addItem.bind(queuer),\n    queuer,\n  }) as QueuedSignal<TValue, TSelected>\n\n  return queued\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA+CA,SAAgB,mBAOd,IACA,UAAiC,EAAE,EACnC,YAAuD,WACpD,EAAE,OAAO,MAAM,OAAO,GACQ;CACjC,MAAM,SAAS,aAAa,IAAI,SAAS,SAAS;CAElD,MAAM,QAAQ,eAAe,OAAO,OAAO,CAAC,MAAuB;AAOnE,QALe,OAAO,OAAO,OAAO;EAClC,SAAS,OAAO,QAAQ,KAAK,OAAO;EACpC;EACD,CAAC"}
+{"version":3,"file":"injectQueuedSignal.js","names":[],"sources":["../../src/queuer/injectQueuedSignal.ts"],"sourcesContent":["import { computed } from '@angular/core'\nimport { injectQueuer } from './injectQueuer'\nimport type { AngularQueuer } from './injectQueuer'\nimport type { QueuerOptions, QueuerState } from '@tanstack/pacer/queuer'\n\nexport interface QueuedSignal<TValue, TSelected = {}> {\n  (): Array<TValue>\n  addItem: AngularQueuer<TValue, TSelected>['addItem']\n  queuer: AngularQueuer<TValue, TSelected>\n}\n\n/**\n * An Angular function that creates a queuer with managed state, combining Angular's signals with queuing functionality.\n * This function provides both the current queue state and queue control methods.\n *\n * The queue state is automatically updated whenever items are added, removed, or reordered in the queue.\n * All queue operations are reflected in the state array returned by the function.\n *\n * The function returns a callable object:\n * - `queued()`: Get the current queue items as an array\n * - `queued.addItem(...)`: Add an item to the queue\n * - `queued.queue`: The queuer instance with additional control methods\n *\n * @example\n * ```ts\n * // Default behavior - track items\n * const queued = injectQueuedSignal(\n *   (item) => console.log('Processing:', item),\n *   { started: true, wait: 1000 }\n * );\n *\n * // Add items\n * queued.addItem('task1');\n *\n * // Access items\n * console.log(queued()); // ['task1']\n *\n * // Control the queue\n * queued.queuer.start();\n * queued.queuer.stop();\n * ```\n */\nexport function injectQueuedSignal<\n  TValue,\n  TSelected extends Pick<QueuerState<TValue>, 'items'> = Pick<\n    QueuerState<TValue>,\n    'items'\n  >,\n>(\n  fn: (item: TValue) => void,\n  options: QueuerOptions<TValue> = {},\n  selector: (state: QueuerState<TValue>) => TSelected = (state) =>\n    ({ items: state.items }) as TSelected,\n): QueuedSignal<TValue, TSelected> {\n  const queuer = injectQueuer(fn, options, selector)\n\n  const items = computed(() => queuer.state().items as Array<TValue>)\n\n  const queued = Object.assign(items, {\n    addItem: queuer.addItem.bind(queuer),\n    queuer,\n  }) as QueuedSignal<TValue, TSelected>\n\n  return queued\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA0CA,SAAgB,mBAOd,IACA,UAAiC,EAAE,EACnC,YAAuD,WACpD,EAAE,OAAO,MAAM,OAAO,GACQ;CACjC,MAAM,SAAS,aAAa,IAAI,SAAS,SAAS;CAElD,MAAM,QAAQ,eAAe,OAAO,OAAO,CAAC,MAAuB;AAOnE,QALe,OAAO,OAAO,OAAO;EAClC,SAAS,OAAO,QAAQ,KAAK,OAAO;EACpC;EACD,CAAC"}

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