@tanstack/angular-pacer 0.20.0

package/dist/batcher/injectBatcher.cjs

@@ -0,0 +1,56 @@
+const require_pacer_context = require('../provider/pacer-context.cjs');
+let _tanstack_angular_store = require("@tanstack/angular-store");
+let _tanstack_pacer_batcher = require("@tanstack/pacer/batcher");
+
+//#region src/batcher/injectBatcher.ts
+/**
+* An Angular function that creates and manages a Batcher instance.
+*
+* This is a lower-level function that provides direct access to the Batcher's functionality.
+* This allows you to integrate it with any state management solution you prefer.
+*
+* The Batcher collects items and processes them in batches based on configurable conditions:
+* - Maximum batch size
+* - Time-based batching (process after X milliseconds)
+* - Custom batch processing logic via getShouldExecute
+*
+* ## State Management and Selector
+*
+* The function uses TanStack Store for state management and wraps it with Angular signals.
+* The `selector` parameter allows you to specify which state changes will trigger signal updates,
+* optimizing performance by preventing unnecessary updates when irrelevant state changes occur.
+*
+* **By default, there will be no reactive state subscriptions** and you must opt-in to state
+* tracking by providing a selector function. This prevents unnecessary updates and gives you
+* full control over when your component tracks state changes.
+*
+* @example
+* ```ts
+* // Default behavior - no reactive state subscriptions
+* const batcher = injectBatcher(
+*   (items) => console.log('Processing batch:', items),
+*   { maxSize: 5, wait: 2000 }
+* );
+*
+* // Add items
+* batcher.addItem('task1');
+*
+* // Access the selected state
+* const { items, isPending } = batcher.state();
+* ```
+*/
+function injectBatcher(fn, options = {}, selector = () => ({})) {
+	const batcher = new _tanstack_pacer_batcher.Batcher(fn, {
+		...require_pacer_context.injectPacerOptions().batcher,
+		...options
+	});
+	const state = (0, _tanstack_angular_store.injectStore)(batcher.store, selector);
+	return {
+		...batcher,
+		state
+	};
+}
+
+//#endregion
+exports.injectBatcher = injectBatcher;
+//# sourceMappingURL=injectBatcher.cjs.map

package/dist/batcher/injectBatcher.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"injectBatcher.cjs","names":["Batcher","injectPacerOptions"],"sources":["../../src/batcher/injectBatcher.ts"],"sourcesContent":["import { injectStore } from '@tanstack/angular-store'\nimport { Batcher } from '@tanstack/pacer/batcher'\nimport { injectPacerOptions } from '../provider/pacer-context'\nimport type { Signal } from '@angular/core'\nimport type { Store } from '@tanstack/store'\nimport type { BatcherOptions, BatcherState } from '@tanstack/pacer/batcher'\n\nexport interface AngularBatcher<TValue, TSelected = {}> extends Omit<\n  Batcher<TValue>,\n  'store'\n> {\n  /**\n   * Reactive state signal that will be updated when the batcher state changes\n   *\n   * Use this instead of `batcher.store.state`\n   */\n  readonly state: Signal<Readonly<TSelected>>\n  /**\n   * @deprecated Use `batcher.state` instead of `batcher.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<BatcherState<TValue>>>\n}\n\n/**\n * An Angular function that creates and manages a Batcher instance.\n *\n * This is a lower-level function that provides direct access to the Batcher's functionality.\n * This allows you to integrate it with any state management solution you prefer.\n *\n * The Batcher collects items and processes them in batches based on configurable conditions:\n * - Maximum batch size\n * - Time-based batching (process after X milliseconds)\n * - Custom batch processing logic via getShouldExecute\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 batcher = injectBatcher(\n *   (items) => console.log('Processing batch:', items),\n *   { maxSize: 5, wait: 2000 }\n * );\n *\n * // Add items\n * batcher.addItem('task1');\n *\n * // Access the selected state\n * const { items, isPending } = batcher.state();\n * ```\n */\nexport function injectBatcher<TValue, TSelected = {}>(\n  fn: (items: Array<TValue>) => void,\n  options: BatcherOptions<TValue> = {},\n  selector: (state: BatcherState<TValue>) => TSelected = () =>\n    ({}) as TSelected,\n): AngularBatcher<TValue, TSelected> {\n  const mergedOptions = {\n    ...injectPacerOptions().batcher,\n    ...options,\n  } as BatcherOptions<TValue>\n\n  const batcher = new Batcher<TValue>(fn, mergedOptions)\n  const state = injectStore(batcher.store, selector)\n\n  return {\n    ...batcher,\n    state,\n  } as AngularBatcher<TValue, TSelected>\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA4DA,SAAgB,cACd,IACA,UAAkC,EAAE,EACpC,kBACG,EAAE,GAC8B;CAMnC,MAAM,UAAU,IAAIA,gCAAgB,IALd;EACpB,GAAGC,0CAAoB,CAAC;EACxB,GAAG;EACJ,CAEqD;CACtD,MAAM,iDAAoB,QAAQ,OAAO,SAAS;AAElD,QAAO;EACL,GAAG;EACH;EACD"}

package/dist/batcher/injectBatcher.d.cts

@@ -0,0 +1,58 @@
+import { Signal } from "@angular/core";
+import { Store } from "@tanstack/store";
+import { Batcher, BatcherOptions, BatcherState } from "@tanstack/pacer/batcher";
+
+//#region src/batcher/injectBatcher.d.ts
+interface AngularBatcher<TValue, TSelected = {}> extends Omit<Batcher<TValue>, 'store'> {
+  /**
+   * Reactive state signal that will be updated when the batcher state changes
+   *
+   * Use this instead of `batcher.store.state`
+   */
+  readonly state: Signal<Readonly<TSelected>>;
+  /**
+   * @deprecated Use `batcher.state` instead of `batcher.store.state` if you want to read reactive state.
+   * The state on the store object is not reactive in Angular signals.
+   */
+  readonly store: Store<Readonly<BatcherState<TValue>>>;
+}
+/**
+ * An Angular function that creates and manages a Batcher instance.
+ *
+ * This is a lower-level function that provides direct access to the Batcher's functionality.
+ * This allows you to integrate it with any state management solution you prefer.
+ *
+ * The Batcher collects items and processes them in batches based on configurable conditions:
+ * - Maximum batch size
+ * - Time-based batching (process after X milliseconds)
+ * - Custom batch processing logic via getShouldExecute
+ *
+ * ## State Management and Selector
+ *
+ * The function uses TanStack Store for state management and wraps it with Angular signals.
+ * The `selector` parameter allows you to specify which state changes will trigger signal updates,
+ * optimizing performance by preventing unnecessary updates when irrelevant state changes occur.
+ *
+ * **By default, there will be no reactive state subscriptions** and you must opt-in to state
+ * tracking by providing a selector function. This prevents unnecessary updates and gives you
+ * full control over when your component tracks state changes.
+ *
+ * @example
+ * ```ts
+ * // Default behavior - no reactive state subscriptions
+ * const batcher = injectBatcher(
+ *   (items) => console.log('Processing batch:', items),
+ *   { maxSize: 5, wait: 2000 }
+ * );
+ *
+ * // Add items
+ * batcher.addItem('task1');
+ *
+ * // Access the selected state
+ * const { items, isPending } = batcher.state();
+ * ```
+ */
+declare function injectBatcher<TValue, TSelected = {}>(fn: (items: Array<TValue>) => void, options?: BatcherOptions<TValue>, selector?: (state: BatcherState<TValue>) => TSelected): AngularBatcher<TValue, TSelected>;
+//#endregion
+export { AngularBatcher, injectBatcher };
+//# sourceMappingURL=injectBatcher.d.cts.map

package/dist/batcher/injectBatcher.d.ts

@@ -0,0 +1,58 @@
+import { Signal } from "@angular/core";
+import { Batcher, BatcherOptions, BatcherState } from "@tanstack/pacer/batcher";
+import { Store } from "@tanstack/store";
+
+//#region src/batcher/injectBatcher.d.ts
+interface AngularBatcher<TValue, TSelected = {}> extends Omit<Batcher<TValue>, 'store'> {
+  /**
+   * Reactive state signal that will be updated when the batcher state changes
+   *
+   * Use this instead of `batcher.store.state`
+   */
+  readonly state: Signal<Readonly<TSelected>>;
+  /**
+   * @deprecated Use `batcher.state` instead of `batcher.store.state` if you want to read reactive state.
+   * The state on the store object is not reactive in Angular signals.
+   */
+  readonly store: Store<Readonly<BatcherState<TValue>>>;
+}
+/**
+ * An Angular function that creates and manages a Batcher instance.
+ *
+ * This is a lower-level function that provides direct access to the Batcher's functionality.
+ * This allows you to integrate it with any state management solution you prefer.
+ *
+ * The Batcher collects items and processes them in batches based on configurable conditions:
+ * - Maximum batch size
+ * - Time-based batching (process after X milliseconds)
+ * - Custom batch processing logic via getShouldExecute
+ *
+ * ## State Management and Selector
+ *
+ * The function uses TanStack Store for state management and wraps it with Angular signals.
+ * The `selector` parameter allows you to specify which state changes will trigger signal updates,
+ * optimizing performance by preventing unnecessary updates when irrelevant state changes occur.
+ *
+ * **By default, there will be no reactive state subscriptions** and you must opt-in to state
+ * tracking by providing a selector function. This prevents unnecessary updates and gives you
+ * full control over when your component tracks state changes.
+ *
+ * @example
+ * ```ts
+ * // Default behavior - no reactive state subscriptions
+ * const batcher = injectBatcher(
+ *   (items) => console.log('Processing batch:', items),
+ *   { maxSize: 5, wait: 2000 }
+ * );
+ *
+ * // Add items
+ * batcher.addItem('task1');
+ *
+ * // Access the selected state
+ * const { items, isPending } = batcher.state();
+ * ```
+ */
+declare function injectBatcher<TValue, TSelected = {}>(fn: (items: Array<TValue>) => void, options?: BatcherOptions<TValue>, selector?: (state: BatcherState<TValue>) => TSelected): AngularBatcher<TValue, TSelected>;
+//#endregion
+export { AngularBatcher, injectBatcher };
+//# sourceMappingURL=injectBatcher.d.ts.map

package/dist/batcher/injectBatcher.js

@@ -0,0 +1,56 @@
+import { injectPacerOptions } from "../provider/pacer-context.js";
+import { injectStore } from "@tanstack/angular-store";
+import { Batcher } from "@tanstack/pacer/batcher";
+
+//#region src/batcher/injectBatcher.ts
+/**
+* An Angular function that creates and manages a Batcher instance.
+*
+* This is a lower-level function that provides direct access to the Batcher's functionality.
+* This allows you to integrate it with any state management solution you prefer.
+*
+* The Batcher collects items and processes them in batches based on configurable conditions:
+* - Maximum batch size
+* - Time-based batching (process after X milliseconds)
+* - Custom batch processing logic via getShouldExecute
+*
+* ## State Management and Selector
+*
+* The function uses TanStack Store for state management and wraps it with Angular signals.
+* The `selector` parameter allows you to specify which state changes will trigger signal updates,
+* optimizing performance by preventing unnecessary updates when irrelevant state changes occur.
+*
+* **By default, there will be no reactive state subscriptions** and you must opt-in to state
+* tracking by providing a selector function. This prevents unnecessary updates and gives you
+* full control over when your component tracks state changes.
+*
+* @example
+* ```ts
+* // Default behavior - no reactive state subscriptions
+* const batcher = injectBatcher(
+*   (items) => console.log('Processing batch:', items),
+*   { maxSize: 5, wait: 2000 }
+* );
+*
+* // Add items
+* batcher.addItem('task1');
+*
+* // Access the selected state
+* const { items, isPending } = batcher.state();
+* ```
+*/
+function injectBatcher(fn, options = {}, selector = () => ({})) {
+	const batcher = new Batcher(fn, {
+		...injectPacerOptions().batcher,
+		...options
+	});
+	const state = injectStore(batcher.store, selector);
+	return {
+		...batcher,
+		state
+	};
+}
+
+//#endregion
+export { injectBatcher };
+//# sourceMappingURL=injectBatcher.js.map

package/dist/batcher/injectBatcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"injectBatcher.js","names":[],"sources":["../../src/batcher/injectBatcher.ts"],"sourcesContent":["import { injectStore } from '@tanstack/angular-store'\nimport { Batcher } from '@tanstack/pacer/batcher'\nimport { injectPacerOptions } from '../provider/pacer-context'\nimport type { Signal } from '@angular/core'\nimport type { Store } from '@tanstack/store'\nimport type { BatcherOptions, BatcherState } from '@tanstack/pacer/batcher'\n\nexport interface AngularBatcher<TValue, TSelected = {}> extends Omit<\n  Batcher<TValue>,\n  'store'\n> {\n  /**\n   * Reactive state signal that will be updated when the batcher state changes\n   *\n   * Use this instead of `batcher.store.state`\n   */\n  readonly state: Signal<Readonly<TSelected>>\n  /**\n   * @deprecated Use `batcher.state` instead of `batcher.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<BatcherState<TValue>>>\n}\n\n/**\n * An Angular function that creates and manages a Batcher instance.\n *\n * This is a lower-level function that provides direct access to the Batcher's functionality.\n * This allows you to integrate it with any state management solution you prefer.\n *\n * The Batcher collects items and processes them in batches based on configurable conditions:\n * - Maximum batch size\n * - Time-based batching (process after X milliseconds)\n * - Custom batch processing logic via getShouldExecute\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 batcher = injectBatcher(\n *   (items) => console.log('Processing batch:', items),\n *   { maxSize: 5, wait: 2000 }\n * );\n *\n * // Add items\n * batcher.addItem('task1');\n *\n * // Access the selected state\n * const { items, isPending } = batcher.state();\n * ```\n */\nexport function injectBatcher<TValue, TSelected = {}>(\n  fn: (items: Array<TValue>) => void,\n  options: BatcherOptions<TValue> = {},\n  selector: (state: BatcherState<TValue>) => TSelected = () =>\n    ({}) as TSelected,\n): AngularBatcher<TValue, TSelected> {\n  const mergedOptions = {\n    ...injectPacerOptions().batcher,\n    ...options,\n  } as BatcherOptions<TValue>\n\n  const batcher = new Batcher<TValue>(fn, mergedOptions)\n  const state = injectStore(batcher.store, selector)\n\n  return {\n    ...batcher,\n    state,\n  } as AngularBatcher<TValue, TSelected>\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA4DA,SAAgB,cACd,IACA,UAAkC,EAAE,EACpC,kBACG,EAAE,GAC8B;CAMnC,MAAM,UAAU,IAAI,QAAgB,IALd;EACpB,GAAG,oBAAoB,CAAC;EACxB,GAAG;EACJ,CAEqD;CACtD,MAAM,QAAQ,YAAY,QAAQ,OAAO,SAAS;AAElD,QAAO;EACL,GAAG;EACH;EACD"}

package/dist/debouncer/index.cjs

@@ -0,0 +1,17 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_injectDebouncer = require('./injectDebouncer.cjs');
+const require_injectDebouncedCallback = require('./injectDebouncedCallback.cjs');
+const require_injectDebouncedSignal = require('./injectDebouncedSignal.cjs');
+const require_injectDebouncedValue = require('./injectDebouncedValue.cjs');
+
+exports.injectDebouncedCallback = require_injectDebouncedCallback.injectDebouncedCallback;
+exports.injectDebouncedSignal = require_injectDebouncedSignal.injectDebouncedSignal;
+exports.injectDebouncedValue = require_injectDebouncedValue.injectDebouncedValue;
+exports.injectDebouncer = require_injectDebouncer.injectDebouncer;
+var _tanstack_pacer_debouncer = require("@tanstack/pacer/debouncer");
+Object.keys(_tanstack_pacer_debouncer).forEach(function (k) {
+  if (k !== 'default' && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
+    enumerable: true,
+    get: function () { return _tanstack_pacer_debouncer[k]; }
+  });
+});

package/dist/debouncer/index.d.cts

@@ -0,0 +1,6 @@
+import { injectDebouncedCallback } from "./injectDebouncedCallback.cjs";
+import { AngularDebouncer, injectDebouncer } from "./injectDebouncer.cjs";
+import { DebouncedSignal, injectDebouncedSignal } from "./injectDebouncedSignal.cjs";
+import { injectDebouncedValue } from "./injectDebouncedValue.cjs";
+export * from "@tanstack/pacer/debouncer";
+export { AngularDebouncer, DebouncedSignal, injectDebouncedCallback, injectDebouncedSignal, injectDebouncedValue, injectDebouncer };

package/dist/debouncer/index.d.ts

@@ -0,0 +1,6 @@
+import { injectDebouncedCallback } from "./injectDebouncedCallback.js";
+import { AngularDebouncer, injectDebouncer } from "./injectDebouncer.js";
+import { DebouncedSignal, injectDebouncedSignal } from "./injectDebouncedSignal.js";
+import { injectDebouncedValue } from "./injectDebouncedValue.js";
+export * from "@tanstack/pacer/debouncer";
+export { AngularDebouncer, DebouncedSignal, injectDebouncedCallback, injectDebouncedSignal, injectDebouncedValue, injectDebouncer };

package/dist/debouncer/index.js

@@ -0,0 +1,8 @@
+import { injectDebouncer } from "./injectDebouncer.js";
+import { injectDebouncedCallback } from "./injectDebouncedCallback.js";
+import { injectDebouncedSignal } from "./injectDebouncedSignal.js";
+import { injectDebouncedValue } from "./injectDebouncedValue.js";
+
+export * from "@tanstack/pacer/debouncer"
+
+export { injectDebouncedCallback, injectDebouncedSignal, injectDebouncedValue, injectDebouncer };

package/dist/debouncer/injectDebouncedCallback.cjs

@@ -0,0 +1,46 @@
+const require_injectDebouncer = require('./injectDebouncer.cjs');
+
+//#region src/debouncer/injectDebouncedCallback.ts
+/**
+* An Angular function that creates a debounced version of a callback function.
+* This function is essentially a wrapper around `injectDebouncer` that provides
+* a simplified API for basic debouncing needs.
+*
+* The debounced function will only execute after the specified wait time has elapsed
+* since its last invocation. If called again before the wait time expires, the timer
+* resets and starts waiting again.
+*
+* This function provides a simpler API compared to `injectDebouncer`, making it ideal for basic
+* debouncing needs. However, it does not expose the underlying Debouncer instance.
+*
+* For advanced usage requiring features like:
+* - Manual cancellation
+* - Access to execution counts
+* - State tracking
+*
+* Consider using the `injectDebouncer` function instead.
+*
+* @example
+* ```ts
+* // Debounce a search handler
+* const handleSearch = injectDebouncedCallback((query: string) => {
+*   fetchSearchResults(query);
+* }, {
+*   wait: 500 // Wait 500ms between executions
+* });
+*
+* // Use in an input
+* <input
+*   type="search"
+*   (input)="handleSearch($event.target.value)"
+* />
+* ```
+*/
+function injectDebouncedCallback(fn, options) {
+	const debouncer = require_injectDebouncer.injectDebouncer(fn, options);
+	return (...args) => debouncer.maybeExecute(...args);
+}
+
+//#endregion
+exports.injectDebouncedCallback = injectDebouncedCallback;
+//# sourceMappingURL=injectDebouncedCallback.cjs.map

package/dist/debouncer/injectDebouncedCallback.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"injectDebouncedCallback.cjs","names":["injectDebouncer"],"sources":["../../src/debouncer/injectDebouncedCallback.ts"],"sourcesContent":["import { injectDebouncer } from './injectDebouncer'\nimport type { DebouncerOptions } from '@tanstack/pacer/debouncer'\nimport type { AnyFunction } from '@tanstack/pacer/types'\n\n/**\n * An Angular function that creates a debounced version of a callback function.\n * This function is essentially a wrapper around `injectDebouncer` that provides\n * a simplified API for basic debouncing needs.\n *\n * The debounced function will only execute after the specified wait time has elapsed\n * since its last invocation. If called again before the wait time expires, the timer\n * resets and starts waiting again.\n *\n * This function provides a simpler API compared to `injectDebouncer`, making it ideal for basic\n * debouncing needs. However, it does not expose the underlying Debouncer instance.\n *\n * For advanced usage requiring features like:\n * - Manual cancellation\n * - Access to execution counts\n * - State tracking\n *\n * Consider using the `injectDebouncer` function instead.\n *\n * @example\n * ```ts\n * // Debounce a search handler\n * const handleSearch = injectDebouncedCallback((query: string) => {\n *   fetchSearchResults(query);\n * }, {\n *   wait: 500 // Wait 500ms between executions\n * });\n *\n * // Use in an input\n * <input\n *   type=\"search\"\n *   (input)=\"handleSearch($event.target.value)\"\n * />\n * ```\n */\nexport function injectDebouncedCallback<TFn extends AnyFunction>(\n  fn: TFn,\n  options: DebouncerOptions<TFn>,\n): (...args: Parameters<TFn>) => void {\n  const debouncer = injectDebouncer(fn, options)\n  return (...args: Parameters<TFn>) => debouncer.maybeExecute(...args)\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAuCA,SAAgB,wBACd,IACA,SACoC;CACpC,MAAM,YAAYA,wCAAgB,IAAI,QAAQ;AAC9C,SAAQ,GAAG,SAA0B,UAAU,aAAa,GAAG,KAAK"}

package/dist/debouncer/injectDebouncedCallback.d.cts

@@ -0,0 +1,43 @@
+import { AnyFunction } from "@tanstack/pacer/types";
+import { DebouncerOptions } from "@tanstack/pacer/debouncer";
+
+//#region src/debouncer/injectDebouncedCallback.d.ts
+/**
+ * An Angular function that creates a debounced version of a callback function.
+ * This function is essentially a wrapper around `injectDebouncer` that provides
+ * a simplified API for basic debouncing needs.
+ *
+ * The debounced function will only execute after the specified wait time has elapsed
+ * since its last invocation. If called again before the wait time expires, the timer
+ * resets and starts waiting again.
+ *
+ * This function provides a simpler API compared to `injectDebouncer`, making it ideal for basic
+ * debouncing needs. However, it does not expose the underlying Debouncer instance.
+ *
+ * For advanced usage requiring features like:
+ * - Manual cancellation
+ * - Access to execution counts
+ * - State tracking
+ *
+ * Consider using the `injectDebouncer` function instead.
+ *
+ * @example
+ * ```ts
+ * // Debounce a search handler
+ * const handleSearch = injectDebouncedCallback((query: string) => {
+ *   fetchSearchResults(query);
+ * }, {
+ *   wait: 500 // Wait 500ms between executions
+ * });
+ *
+ * // Use in an input
+ * <input
+ *   type="search"
+ *   (input)="handleSearch($event.target.value)"
+ * />
+ * ```
+ */
+declare function injectDebouncedCallback<TFn extends AnyFunction>(fn: TFn, options: DebouncerOptions<TFn>): (...args: Parameters<TFn>) => void;
+//#endregion
+export { injectDebouncedCallback };
+//# sourceMappingURL=injectDebouncedCallback.d.cts.map

package/dist/debouncer/injectDebouncedCallback.d.ts

@@ -0,0 +1,43 @@
+import { DebouncerOptions } from "@tanstack/pacer/debouncer";
+import { AnyFunction } from "@tanstack/pacer/types";
+
+//#region src/debouncer/injectDebouncedCallback.d.ts
+/**
+ * An Angular function that creates a debounced version of a callback function.
+ * This function is essentially a wrapper around `injectDebouncer` that provides
+ * a simplified API for basic debouncing needs.
+ *
+ * The debounced function will only execute after the specified wait time has elapsed
+ * since its last invocation. If called again before the wait time expires, the timer
+ * resets and starts waiting again.
+ *
+ * This function provides a simpler API compared to `injectDebouncer`, making it ideal for basic
+ * debouncing needs. However, it does not expose the underlying Debouncer instance.
+ *
+ * For advanced usage requiring features like:
+ * - Manual cancellation
+ * - Access to execution counts
+ * - State tracking
+ *
+ * Consider using the `injectDebouncer` function instead.
+ *
+ * @example
+ * ```ts
+ * // Debounce a search handler
+ * const handleSearch = injectDebouncedCallback((query: string) => {
+ *   fetchSearchResults(query);
+ * }, {
+ *   wait: 500 // Wait 500ms between executions
+ * });
+ *
+ * // Use in an input
+ * <input
+ *   type="search"
+ *   (input)="handleSearch($event.target.value)"
+ * />
+ * ```
+ */
+declare function injectDebouncedCallback<TFn extends AnyFunction>(fn: TFn, options: DebouncerOptions<TFn>): (...args: Parameters<TFn>) => void;
+//#endregion
+export { injectDebouncedCallback };
+//# sourceMappingURL=injectDebouncedCallback.d.ts.map

package/dist/debouncer/injectDebouncedCallback.js

@@ -0,0 +1,46 @@
+import { injectDebouncer } from "./injectDebouncer.js";
+
+//#region src/debouncer/injectDebouncedCallback.ts
+/**
+* An Angular function that creates a debounced version of a callback function.
+* This function is essentially a wrapper around `injectDebouncer` that provides
+* a simplified API for basic debouncing needs.
+*
+* The debounced function will only execute after the specified wait time has elapsed
+* since its last invocation. If called again before the wait time expires, the timer
+* resets and starts waiting again.
+*
+* This function provides a simpler API compared to `injectDebouncer`, making it ideal for basic
+* debouncing needs. However, it does not expose the underlying Debouncer instance.
+*
+* For advanced usage requiring features like:
+* - Manual cancellation
+* - Access to execution counts
+* - State tracking
+*
+* Consider using the `injectDebouncer` function instead.
+*
+* @example
+* ```ts
+* // Debounce a search handler
+* const handleSearch = injectDebouncedCallback((query: string) => {
+*   fetchSearchResults(query);
+* }, {
+*   wait: 500 // Wait 500ms between executions
+* });
+*
+* // Use in an input
+* <input
+*   type="search"
+*   (input)="handleSearch($event.target.value)"
+* />
+* ```
+*/
+function injectDebouncedCallback(fn, options) {
+	const debouncer = injectDebouncer(fn, options);
+	return (...args) => debouncer.maybeExecute(...args);
+}
+
+//#endregion
+export { injectDebouncedCallback };
+//# sourceMappingURL=injectDebouncedCallback.js.map

package/dist/debouncer/injectDebouncedCallback.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"injectDebouncedCallback.js","names":[],"sources":["../../src/debouncer/injectDebouncedCallback.ts"],"sourcesContent":["import { injectDebouncer } from './injectDebouncer'\nimport type { DebouncerOptions } from '@tanstack/pacer/debouncer'\nimport type { AnyFunction } from '@tanstack/pacer/types'\n\n/**\n * An Angular function that creates a debounced version of a callback function.\n * This function is essentially a wrapper around `injectDebouncer` that provides\n * a simplified API for basic debouncing needs.\n *\n * The debounced function will only execute after the specified wait time has elapsed\n * since its last invocation. If called again before the wait time expires, the timer\n * resets and starts waiting again.\n *\n * This function provides a simpler API compared to `injectDebouncer`, making it ideal for basic\n * debouncing needs. However, it does not expose the underlying Debouncer instance.\n *\n * For advanced usage requiring features like:\n * - Manual cancellation\n * - Access to execution counts\n * - State tracking\n *\n * Consider using the `injectDebouncer` function instead.\n *\n * @example\n * ```ts\n * // Debounce a search handler\n * const handleSearch = injectDebouncedCallback((query: string) => {\n *   fetchSearchResults(query);\n * }, {\n *   wait: 500 // Wait 500ms between executions\n * });\n *\n * // Use in an input\n * <input\n *   type=\"search\"\n *   (input)=\"handleSearch($event.target.value)\"\n * />\n * ```\n */\nexport function injectDebouncedCallback<TFn extends AnyFunction>(\n  fn: TFn,\n  options: DebouncerOptions<TFn>,\n): (...args: Parameters<TFn>) => void {\n  const debouncer = injectDebouncer(fn, options)\n  return (...args: Parameters<TFn>) => debouncer.maybeExecute(...args)\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAuCA,SAAgB,wBACd,IACA,SACoC;CACpC,MAAM,YAAY,gBAAgB,IAAI,QAAQ;AAC9C,SAAQ,GAAG,SAA0B,UAAU,aAAa,GAAG,KAAK"}

package/dist/debouncer/injectDebouncedSignal.cjs

@@ -0,0 +1,68 @@
+const require_injectDebouncer = require('./injectDebouncer.cjs');
+let _angular_core = require("@angular/core");
+
+//#region src/debouncer/injectDebouncedSignal.ts
+/**
+* An Angular function that creates a debounced state signal, combining Angular's signal with debouncing functionality.
+* This function provides both the current debounced value and methods to update it.
+*
+* The state value is only updated after the specified wait time has elapsed since the last update attempt.
+* If another update is attempted before the wait time expires, the timer resets and starts waiting again.
+* This is useful for handling frequent state updates that should be throttled, like search input values
+* or window resize dimensions.
+*
+* The function returns a callable object:
+* - `debounced()`: Get the current debounced value
+* - `debounced.set(...)`: Set or update the debounced value (debounced via maybeExecute)
+* - `debounced.debouncer`: The debouncer instance with additional control methods and state signals
+*
+* ## State Management and Selector
+*
+* The function uses TanStack Store for reactive state management via the underlying debouncer instance.
+* The `selector` parameter allows you to specify which debouncer state changes will trigger signal updates,
+* optimizing performance by preventing unnecessary subscriptions when irrelevant state changes occur.
+*
+* **By default, there will be no reactive state subscriptions** and you must opt-in to state
+* tracking by providing a selector function. This prevents unnecessary updates and gives you
+* full control over when your component tracks state changes. Only when you provide a selector will
+* the reactive system track the selected state values.
+*
+* Available debouncer state properties:
+* - `canLeadingExecute`: Whether the debouncer can execute on the leading edge
+* - `executionCount`: Number of function executions that have been completed
+* - `isPending`: Whether the debouncer is waiting for the timeout to trigger execution
+* - `lastArgs`: The arguments from the most recent call to maybeExecute
+* - `status`: Current execution status ('disabled' | 'idle' | 'pending')
+*
+* @example
+* ```ts
+* const debouncedQuery = injectDebouncedSignal('', { wait: 500 })
+*
+* // Get value
+* console.log(debouncedQuery())
+*
+* // Set/update value (debounced)
+* debouncedQuery.set('hello')
+*
+* // Access debouncer
+* console.log(debouncedQuery.debouncer.state().isPending)
+* ```
+*/
+function injectDebouncedSignal(value, initialOptions, selector) {
+	const debouncedValue = (0, _angular_core.signal)(value);
+	const debouncer = require_injectDebouncer.injectDebouncer((newValue) => {
+		if (typeof newValue === "function") debouncedValue.update(newValue);
+		else debouncedValue.set(newValue);
+	}, initialOptions, selector);
+	const set = (newValue) => {
+		debouncer.maybeExecute(newValue);
+	};
+	return Object.assign(() => debouncedValue(), {
+		set,
+		debouncer
+	});
+}
+
+//#endregion
+exports.injectDebouncedSignal = injectDebouncedSignal;
+//# sourceMappingURL=injectDebouncedSignal.cjs.map

package/dist/debouncer/injectDebouncedSignal.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"injectDebouncedSignal.cjs","names":["injectDebouncer"],"sources":["../../src/debouncer/injectDebouncedSignal.ts"],"sourcesContent":["import { signal } from '@angular/core'\nimport { injectDebouncer } from './injectDebouncer'\nimport type { AngularDebouncer } from './injectDebouncer'\nimport type {\n  DebouncerOptions,\n  DebouncerState,\n} from '@tanstack/pacer/debouncer'\n\ntype Setter<T> = (value: T | ((prev: T) => T)) => void\n\nexport type DebouncedSignal<TValue, TSelected = {}> = ((\n  ...args: []\n) => TValue) & {\n  /**\n   * Set or update the debounced value. This calls `debouncer.maybeExecute(...)`.\n   */\n  readonly set: Setter<TValue>\n  /**\n   * The debouncer instance with additional control methods and state signals.\n   */\n  readonly debouncer: AngularDebouncer<Setter<TValue>, TSelected>\n}\n\n/**\n * An Angular function that creates a debounced state signal, combining Angular's signal with debouncing functionality.\n * This function provides both the current debounced value and methods to update it.\n *\n * The state value is only updated after the specified wait time has elapsed since the last update attempt.\n * If another update is attempted before the wait time expires, the timer resets and starts waiting again.\n * This is useful for handling frequent state updates that should be throttled, like search input values\n * or window resize dimensions.\n *\n * The function returns a callable object:\n * - `debounced()`: Get the current debounced value\n * - `debounced.set(...)`: Set or update the debounced value (debounced via maybeExecute)\n * - `debounced.debouncer`: The debouncer instance with additional control methods and state signals\n *\n * ## State Management and Selector\n *\n * The function uses TanStack Store for reactive state management via the underlying debouncer instance.\n * The `selector` parameter allows you to specify which debouncer state changes will trigger signal updates,\n * optimizing performance by preventing unnecessary subscriptions 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. Only when you provide a selector will\n * the reactive system track the selected state values.\n *\n * Available debouncer state properties:\n * - `canLeadingExecute`: Whether the debouncer can execute on the leading edge\n * - `executionCount`: Number of function executions that have been completed\n * - `isPending`: Whether the debouncer is waiting for the timeout to trigger execution\n * - `lastArgs`: The arguments from the most recent call to maybeExecute\n * - `status`: Current execution status ('disabled' | 'idle' | 'pending')\n *\n * @example\n * ```ts\n * const debouncedQuery = injectDebouncedSignal('', { wait: 500 })\n *\n * // Get value\n * console.log(debouncedQuery())\n *\n * // Set/update value (debounced)\n * debouncedQuery.set('hello')\n *\n * // Access debouncer\n * console.log(debouncedQuery.debouncer.state().isPending)\n * ```\n */\nexport function injectDebouncedSignal<TValue, TSelected = {}>(\n  value: TValue,\n  initialOptions: DebouncerOptions<Setter<TValue>>,\n  selector?: (state: DebouncerState<Setter<TValue>>) => TSelected,\n): DebouncedSignal<TValue, TSelected> {\n  const debouncedValue = signal<TValue>(value)\n\n  const debouncer = injectDebouncer(\n    (newValue: TValue | ((prev: TValue) => TValue)) => {\n      if (typeof newValue === 'function') {\n        debouncedValue.update(newValue as (prev: TValue) => TValue)\n      } else {\n        debouncedValue.set(newValue)\n      }\n    },\n    initialOptions,\n    selector,\n  )\n\n  const set: Setter<TValue> = (\n    newValue: TValue | ((prev: TValue) => TValue),\n  ) => {\n    debouncer.maybeExecute(newValue)\n  }\n\n  const debounced = Object.assign(() => debouncedValue(), {\n    set,\n    debouncer,\n  }) as DebouncedSignal<TValue, TSelected>\n\n  return debounced\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAqEA,SAAgB,sBACd,OACA,gBACA,UACoC;CACpC,MAAM,2CAAgC,MAAM;CAE5C,MAAM,YAAYA,yCACf,aAAkD;AACjD,MAAI,OAAO,aAAa,WACtB,gBAAe,OAAO,SAAqC;MAE3D,gBAAe,IAAI,SAAS;IAGhC,gBACA,SACD;CAED,MAAM,OACJ,aACG;AACH,YAAU,aAAa,SAAS;;AAQlC,QALkB,OAAO,aAAa,gBAAgB,EAAE;EACtD;EACA;EACD,CAAC"}

package/dist/debouncer/injectDebouncedSignal.d.cts

@@ -0,0 +1,65 @@
+import { AngularDebouncer } from "./injectDebouncer.cjs";
+import { DebouncerOptions, DebouncerState } from "@tanstack/pacer/debouncer";
+
+//#region src/debouncer/injectDebouncedSignal.d.ts
+type Setter<T> = (value: T | ((prev: T) => T)) => void;
+type DebouncedSignal<TValue, TSelected = {}> = ((...args: []) => TValue) & {
+  /**
+   * Set or update the debounced value. This calls `debouncer.maybeExecute(...)`.
+   */
+  readonly set: Setter<TValue>;
+  /**
+   * The debouncer instance with additional control methods and state signals.
+   */
+  readonly debouncer: AngularDebouncer<Setter<TValue>, TSelected>;
+};
+/**
+ * An Angular function that creates a debounced state signal, combining Angular's signal with debouncing functionality.
+ * This function provides both the current debounced value and methods to update it.
+ *
+ * The state value is only updated after the specified wait time has elapsed since the last update attempt.
+ * If another update is attempted before the wait time expires, the timer resets and starts waiting again.
+ * This is useful for handling frequent state updates that should be throttled, like search input values
+ * or window resize dimensions.
+ *
+ * The function returns a callable object:
+ * - `debounced()`: Get the current debounced value
+ * - `debounced.set(...)`: Set or update the debounced value (debounced via maybeExecute)
+ * - `debounced.debouncer`: The debouncer instance with additional control methods and state signals
+ *
+ * ## State Management and Selector
+ *
+ * The function uses TanStack Store for reactive state management via the underlying debouncer instance.
+ * The `selector` parameter allows you to specify which debouncer state changes will trigger signal updates,
+ * optimizing performance by preventing unnecessary subscriptions when irrelevant state changes occur.
+ *
+ * **By default, there will be no reactive state subscriptions** and you must opt-in to state
+ * tracking by providing a selector function. This prevents unnecessary updates and gives you
+ * full control over when your component tracks state changes. Only when you provide a selector will
+ * the reactive system track the selected state values.
+ *
+ * Available debouncer state properties:
+ * - `canLeadingExecute`: Whether the debouncer can execute on the leading edge
+ * - `executionCount`: Number of function executions that have been completed
+ * - `isPending`: Whether the debouncer is waiting for the timeout to trigger execution
+ * - `lastArgs`: The arguments from the most recent call to maybeExecute
+ * - `status`: Current execution status ('disabled' | 'idle' | 'pending')
+ *
+ * @example
+ * ```ts
+ * const debouncedQuery = injectDebouncedSignal('', { wait: 500 })
+ *
+ * // Get value
+ * console.log(debouncedQuery())
+ *
+ * // Set/update value (debounced)
+ * debouncedQuery.set('hello')
+ *
+ * // Access debouncer
+ * console.log(debouncedQuery.debouncer.state().isPending)
+ * ```
+ */
+declare function injectDebouncedSignal<TValue, TSelected = {}>(value: TValue, initialOptions: DebouncerOptions<Setter<TValue>>, selector?: (state: DebouncerState<Setter<TValue>>) => TSelected): DebouncedSignal<TValue, TSelected>;
+//#endregion
+export { DebouncedSignal, injectDebouncedSignal };
+//# sourceMappingURL=injectDebouncedSignal.d.cts.map