@tanstack/solid-pacer 0.2.0

package/dist/esm/async-queuer/createAsyncQueuer.d.ts

@@ -0,0 +1,90 @@
+import { AsyncQueuer, AsyncQueuerOptions } from '@tanstack/pacer/async-queuer';
+import { Accessor } from 'solid-js';
+export interface SolidAsyncQueuer<TValue> extends Omit<AsyncQueuer<TValue>, 'getActiveItems' | 'getAllItems' | 'getExecutionCount' | 'getIsEmpty' | 'getIsFull' | 'getIsIdle' | 'getIsRunning' | 'getPeek' | 'getPendingItems' | 'getSize'> {
+    /**
+     * Signal version of `getActiveItems`
+     */
+    activeItems: Accessor<Array<() => Promise<TValue>>>;
+    /**
+     * Signal version of `getAllItems`
+     */
+    allItems: Accessor<Array<() => Promise<TValue>>>;
+    /**
+     * Signal version of `getExecutionCount`
+     */
+    executionCount: Accessor<number>;
+    /**
+     * Signal version of `getIsEmpty`
+     */
+    isEmpty: Accessor<boolean>;
+    /**
+     * Signal version of `getIsFull`
+     */
+    isFull: Accessor<boolean>;
+    /**
+     * Signal version of `getIsIdle`
+     */
+    isIdle: Accessor<boolean>;
+    /**
+     * Signal version of `getIsRunning`
+     */
+    isRunning: Accessor<boolean>;
+    /**
+     * Signal version of `getPeek`
+     */
+    peek: Accessor<TValue | undefined>;
+    /**
+     * Signal version of `getPendingItems`
+     */
+    pendingItems: Accessor<Array<() => Promise<TValue>>>;
+    /**
+     * Signal version of `getSize`
+     */
+    size: Accessor<number>;
+}
+/**
+ * A lower-level React hook that creates an `AsyncQueuer` instance for managing an async queue of items.
+ *
+ * This hook provides a flexible, state-management agnostic way to handle queued async operations.
+ * It returns a queuer instance with methods to add items, control queue execution, and monitor queue state.
+ *
+ * The queue can be configured with:
+ * - Maximum concurrent operations
+ * - Maximum queue size
+ * - Processing function for queue items
+ * - Various lifecycle callbacks
+ *
+ * The hook returns an object containing methods to:
+ * - Add/remove items from the queue
+ * - Start/stop queue processing
+ * - Get queue status and items
+ * - Register event handlers
+ * - Control execution throttling
+ *
+ * @example
+ * ```tsx
+ * // Basic async queuer for API requests
+ * const asyncQueuer = createAsyncQueuer({
+ *   initialItems: [],
+ *   concurrency: 2,
+ *   maxSize: 100,
+ *   started: false,
+ * });
+ *
+ * // Add items to queue
+ * asyncQueuer.addItem(newItem);
+ *
+ * // Start processing
+ * asyncQueuer.start();
+ *
+ * // Handle results
+ * asyncQueuer.onSuccess((result) => {
+ *   console.log('Item processed:', result);
+ * });
+ *
+ * asyncQueuer.onError((error) => {
+ *   console.error('Processing failed:', error);
+ * });
+ * ```
+ */
+export declare function createAsyncQueuer<TValue>(initialOptions?: AsyncQueuerOptions<TValue>): SolidAsyncQueuer<TValue>;

package/dist/esm/async-queuer/createAsyncQueuer.js

@@ -0,0 +1,69 @@
+import { AsyncQueuer } from "@tanstack/pacer/async-queuer";
+import { createSignal } from "solid-js";
+import { bindInstanceMethods } from "@tanstack/pacer/utils";
+function createAsyncQueuer(initialOptions = {}) {
+  const asyncQueuer = new AsyncQueuer(initialOptions);
+  const [executionCount, setExecutionCount] = createSignal(
+    asyncQueuer.getExecutionCount()
+  );
+  const [rejectionCount, setRejectionCount] = createSignal(
+    asyncQueuer.getRejectionCount()
+  );
+  const [isEmpty, setIsEmpty] = createSignal(asyncQueuer.getIsEmpty());
+  const [isFull, setIsFull] = createSignal(asyncQueuer.getIsFull());
+  const [isIdle, setIsIdle] = createSignal(asyncQueuer.getIsIdle());
+  const [isRunning, setIsRunning] = createSignal(asyncQueuer.getIsRunning());
+  const [allItems, setAllItems] = createSignal(
+    asyncQueuer.getAllItems()
+  );
+  const [activeItems, setActiveItems] = createSignal(asyncQueuer.getActiveItems());
+  const [pendingItems, setPendingItems] = createSignal(asyncQueuer.getPendingItems());
+  const [peek, setPeek] = createSignal(
+    asyncQueuer.getPeek()
+  );
+  const [size, setSize] = createSignal(asyncQueuer.getSize());
+  asyncQueuer.setOptions({
+    onItemsChange: (queuer) => {
+      var _a;
+      setExecutionCount(queuer.getExecutionCount());
+      setIsEmpty(queuer.getIsEmpty());
+      setIsFull(queuer.getIsFull());
+      setIsIdle(queuer.getIsIdle());
+      setAllItems(queuer.getAllItems());
+      setActiveItems(queuer.getActiveItems());
+      setPendingItems(queuer.getPendingItems());
+      setPeek(() => queuer.getPeek());
+      setSize(queuer.getSize());
+      (_a = initialOptions.onItemsChange) == null ? void 0 : _a.call(initialOptions, queuer);
+    },
+    onIsRunningChange: (queuer) => {
+      var _a;
+      setIsRunning(queuer.getIsRunning());
+      setIsIdle(queuer.getIsIdle());
+      (_a = initialOptions.onIsRunningChange) == null ? void 0 : _a.call(initialOptions, queuer);
+    },
+    onReject: (item, queuer) => {
+      var _a;
+      setRejectionCount(queuer.getRejectionCount());
+      (_a = initialOptions.onReject) == null ? void 0 : _a.call(initialOptions, item, queuer);
+    }
+  });
+  return {
+    ...bindInstanceMethods(asyncQueuer),
+    activeItems,
+    executionCount,
+    isEmpty,
+    isFull,
+    isIdle,
+    isRunning,
+    allItems,
+    peek,
+    pendingItems,
+    rejectionCount,
+    size
+  };
+}
+export {
+  createAsyncQueuer
+};
+//# sourceMappingURL=createAsyncQueuer.js.map

package/dist/esm/async-queuer/createAsyncQueuer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createAsyncQueuer.js","sources":["../../../src/async-queuer/createAsyncQueuer.ts"],"sourcesContent":["import { AsyncQueuer } from '@tanstack/pacer/async-queuer'\nimport { createSignal } from 'solid-js'\nimport { bindInstanceMethods } from '@tanstack/pacer/utils'\nimport type { Accessor } from 'solid-js'\nimport type { AsyncQueuerOptions } from '@tanstack/pacer/async-queuer'\n\nexport interface SolidAsyncQueuer<TValue>\n  extends Omit<\n    AsyncQueuer<TValue>,\n    | 'getActiveItems'\n    | 'getAllItems'\n    | 'getExecutionCount'\n    | 'getIsEmpty'\n    | 'getIsFull'\n    | 'getIsIdle'\n    | 'getIsRunning'\n    | 'getPeek'\n    | 'getPendingItems'\n    | 'getSize'\n  > {\n  /**\n   * Signal version of `getActiveItems`\n   */\n  activeItems: Accessor<Array<() => Promise<TValue>>>\n  /**\n   * Signal version of `getAllItems`\n   */\n  allItems: Accessor<Array<() => Promise<TValue>>>\n  /**\n   * Signal version of `getExecutionCount`\n   */\n  executionCount: Accessor<number>\n  /**\n   * Signal version of `getIsEmpty`\n   */\n  isEmpty: Accessor<boolean>\n  /**\n   * Signal version of `getIsFull`\n   */\n  isFull: Accessor<boolean>\n  /**\n   * Signal version of `getIsIdle`\n   */\n  isIdle: Accessor<boolean>\n  /**\n   * Signal version of `getIsRunning`\n   */\n  isRunning: Accessor<boolean>\n  /**\n   * Signal version of `getPeek`\n   */\n  peek: Accessor<TValue | undefined>\n  /**\n   * Signal version of `getPendingItems`\n   */\n  pendingItems: Accessor<Array<() => Promise<TValue>>>\n  /**\n   * Signal version of `getSize`\n   */\n  size: Accessor<number>\n}\n\n/**\n * A lower-level React hook that creates an `AsyncQueuer` instance for managing an async queue of items.\n *\n * This hook provides a flexible, state-management agnostic way to handle queued async operations.\n * It returns a queuer instance with methods to add items, control queue execution, and monitor queue state.\n *\n * The queue can be configured with:\n * - Maximum concurrent operations\n * - Maximum queue size\n * - Processing function for queue items\n * - Various lifecycle callbacks\n *\n * The hook returns an object containing methods to:\n * - Add/remove items from the queue\n * - Start/stop queue processing\n * - Get queue status and items\n * - Register event handlers\n * - Control execution throttling\n *\n * @example\n * ```tsx\n * // Basic async queuer for API requests\n * const asyncQueuer = createAsyncQueuer({\n *   initialItems: [],\n *   concurrency: 2,\n *   maxSize: 100,\n *   started: false,\n * });\n *\n * // Add items to queue\n * asyncQueuer.addItem(newItem);\n *\n * // Start processing\n * asyncQueuer.start();\n *\n * // Handle results\n * asyncQueuer.onSuccess((result) => {\n *   console.log('Item processed:', result);\n * });\n *\n * asyncQueuer.onError((error) => {\n *   console.error('Processing failed:', error);\n * });\n * ```\n */\nexport function createAsyncQueuer<TValue>(\n  initialOptions: AsyncQueuerOptions<TValue> = {},\n): SolidAsyncQueuer<TValue> {\n  const asyncQueuer = new AsyncQueuer<TValue>(initialOptions)\n\n  const [executionCount, setExecutionCount] = createSignal(\n    asyncQueuer.getExecutionCount(),\n  )\n  const [rejectionCount, setRejectionCount] = createSignal(\n    asyncQueuer.getRejectionCount(),\n  )\n  const [isEmpty, setIsEmpty] = createSignal(asyncQueuer.getIsEmpty())\n  const [isFull, setIsFull] = createSignal(asyncQueuer.getIsFull())\n  const [isIdle, setIsIdle] = createSignal(asyncQueuer.getIsIdle())\n  const [isRunning, setIsRunning] = createSignal(asyncQueuer.getIsRunning())\n  const [allItems, setAllItems] = createSignal<Array<() => Promise<TValue>>>(\n    asyncQueuer.getAllItems(),\n  )\n  const [activeItems, setActiveItems] = createSignal<\n    Array<() => Promise<TValue>>\n  >(asyncQueuer.getActiveItems())\n  const [pendingItems, setPendingItems] = createSignal<\n    Array<() => Promise<TValue>>\n  >(asyncQueuer.getPendingItems())\n  const [peek, setPeek] = createSignal<(() => Promise<TValue>) | undefined>(\n    asyncQueuer.getPeek(),\n  )\n  const [size, setSize] = createSignal(asyncQueuer.getSize())\n\n  asyncQueuer.setOptions({\n    onItemsChange: (queuer) => {\n      setExecutionCount(queuer.getExecutionCount())\n      setIsEmpty(queuer.getIsEmpty())\n      setIsFull(queuer.getIsFull())\n      setIsIdle(queuer.getIsIdle())\n      setAllItems(queuer.getAllItems())\n      setActiveItems(queuer.getActiveItems())\n      setPendingItems(queuer.getPendingItems())\n      setPeek(() => queuer.getPeek())\n      setSize(queuer.getSize())\n      initialOptions.onItemsChange?.(queuer)\n    },\n    onIsRunningChange: (queuer) => {\n      setIsRunning(queuer.getIsRunning())\n      setIsIdle(queuer.getIsIdle())\n      initialOptions.onIsRunningChange?.(queuer)\n    },\n    onReject: (item, queuer) => {\n      setRejectionCount(queuer.getRejectionCount())\n      initialOptions.onReject?.(item, queuer)\n    },\n  })\n\n  return {\n    ...bindInstanceMethods(asyncQueuer),\n    activeItems,\n    executionCount,\n    isEmpty,\n    isFull,\n    isIdle,\n    isRunning,\n    allItems,\n    peek,\n    pendingItems,\n    rejectionCount,\n    size,\n  }\n}\n"],"names":[],"mappings":";;;AA2GgB,SAAA,kBACd,iBAA6C,IACnB;AACpB,QAAA,cAAc,IAAI,YAAoB,cAAc;AAEpD,QAAA,CAAC,gBAAgB,iBAAiB,IAAI;AAAA,IAC1C,YAAY,kBAAkB;AAAA,EAChC;AACM,QAAA,CAAC,gBAAgB,iBAAiB,IAAI;AAAA,IAC1C,YAAY,kBAAkB;AAAA,EAChC;AACA,QAAM,CAAC,SAAS,UAAU,IAAI,aAAa,YAAY,YAAY;AACnE,QAAM,CAAC,QAAQ,SAAS,IAAI,aAAa,YAAY,WAAW;AAChE,QAAM,CAAC,QAAQ,SAAS,IAAI,aAAa,YAAY,WAAW;AAChE,QAAM,CAAC,WAAW,YAAY,IAAI,aAAa,YAAY,cAAc;AACnE,QAAA,CAAC,UAAU,WAAW,IAAI;AAAA,IAC9B,YAAY,YAAY;AAAA,EAC1B;AACA,QAAM,CAAC,aAAa,cAAc,IAAI,aAEpC,YAAY,gBAAgB;AAC9B,QAAM,CAAC,cAAc,eAAe,IAAI,aAEtC,YAAY,iBAAiB;AACzB,QAAA,CAAC,MAAM,OAAO,IAAI;AAAA,IACtB,YAAY,QAAQ;AAAA,EACtB;AACA,QAAM,CAAC,MAAM,OAAO,IAAI,aAAa,YAAY,SAAS;AAE1D,cAAY,WAAW;AAAA,IACrB,eAAe,CAAC,WAAW;;AACP,wBAAA,OAAO,mBAAmB;AACjC,iBAAA,OAAO,YAAY;AACpB,gBAAA,OAAO,WAAW;AAClB,gBAAA,OAAO,WAAW;AAChB,kBAAA,OAAO,aAAa;AACjB,qBAAA,OAAO,gBAAgB;AACtB,sBAAA,OAAO,iBAAiB;AAChC,cAAA,MAAM,OAAO,SAAS;AACtB,cAAA,OAAO,SAAS;AACxB,2BAAe,kBAAf,wCAA+B;AAAA,IACjC;AAAA,IACA,mBAAmB,CAAC,WAAW;;AAChB,mBAAA,OAAO,cAAc;AACxB,gBAAA,OAAO,WAAW;AAC5B,2BAAe,sBAAf,wCAAmC;AAAA,IACrC;AAAA,IACA,UAAU,CAAC,MAAM,WAAW;;AACR,wBAAA,OAAO,mBAAmB;AAC7B,2BAAA,aAAA,wCAAW,MAAM;AAAA,IAAM;AAAA,EACxC,CACD;AAEM,SAAA;AAAA,IACL,GAAG,oBAAoB,WAAW;AAAA,IAClC;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACF;"}

package/dist/esm/async-queuer/index.d.ts

@@ -0,0 +1,2 @@
+export * from '@tanstack/pacer/async-queuer';
+export * from './createAsyncQueuer.js';

package/dist/esm/async-queuer/index.js

@@ -0,0 +1,6 @@
+export * from "@tanstack/pacer/async-queuer";
+import { createAsyncQueuer } from "./createAsyncQueuer.js";
+export {
+  createAsyncQueuer
+};
+//# sourceMappingURL=index.js.map

package/dist/esm/async-queuer/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;"}

package/dist/esm/async-rate-limiter/createAsyncRateLimiter.d.ts

@@ -0,0 +1,46 @@
+import { AsyncRateLimiter, AsyncRateLimiterOptions } from '@tanstack/pacer/async-rate-limiter';
+import { Accessor } from 'solid-js';
+import { AnyAsyncFunction } from '@tanstack/pacer/types';
+export interface SolidAsyncRateLimiter<TFn extends AnyAsyncFunction, TArgs extends Parameters<TFn>> extends Omit<AsyncRateLimiter<TFn, TArgs>, 'getExecutionCount' | 'getRejectionCount' | 'getRemainingInWindow' | 'getMsUntilNextWindow'> {
+    executionCount: Accessor<number>;
+    rejectionCount: Accessor<number>;
+    remainingInWindow: Accessor<number>;
+    msUntilNextWindow: Accessor<number>;
+}
+/**
+ * A low-level Solid hook that creates an `AsyncRateLimiter` instance to limit how many times an async function can execute within a time window.
+ *
+ * This hook is designed to be flexible and state-management agnostic - it simply returns a rate limiter instance that
+ * you can integrate with any state management solution (createSignal, etc).
+ *
+ * Rate limiting allows an async function to execute up to a specified limit within a time window,
+ * then blocks subsequent calls until the window passes. This is useful for respecting API rate limits,
+ * managing resource constraints, or controlling bursts of async operations.
+ *
+ * @example
+ * ```tsx
+ * // Basic API call rate limiting
+ * const { maybeExecute } = createAsyncRateLimiter(
+ *   async (id: string) => {
+ *     const data = await api.fetchData(id);
+ *     return data;
+ *   },
+ *   { limit: 5, window: 1000 } // 5 calls per second
+ * );
+ *
+ * // With state management
+ * const [data, setData] = createSignal(null);
+ * const { maybeExecute } = createAsyncRateLimiter(
+ *   async (query) => {
+ *     const result = await searchAPI(query);
+ *     setData(result);
+ *   },
+ *   {
+ *     limit: 10,
+ *     window: 60000, // 10 calls per minute
+ *     onReject: (info) => console.log(`Rate limit exceeded: ${info.nextValidTime - Date.now()}ms until next window`)
+ *   }
+ * );
+ * ```
+ */
+export declare function createAsyncRateLimiter<TFn extends AnyAsyncFunction, TArgs extends Parameters<TFn>>(fn: TFn, initialOptions: AsyncRateLimiterOptions<TFn, TArgs>): SolidAsyncRateLimiter<TFn, TArgs>;

package/dist/esm/async-rate-limiter/createAsyncRateLimiter.js

@@ -0,0 +1,50 @@
+import { AsyncRateLimiter } from "@tanstack/pacer/async-rate-limiter";
+import { createSignal } from "solid-js";
+import { bindInstanceMethods } from "@tanstack/pacer/utils";
+function createAsyncRateLimiter(fn, initialOptions) {
+  const asyncRateLimiter = new AsyncRateLimiter(fn, initialOptions);
+  const [executionCount, setExecutionCount] = createSignal(
+    asyncRateLimiter.getExecutionCount()
+  );
+  const [rejectionCount, setRejectionCount] = createSignal(
+    asyncRateLimiter.getRejectionCount()
+  );
+  const [remainingInWindow, setRemainingInWindow] = createSignal(
+    asyncRateLimiter.getRemainingInWindow()
+  );
+  const [msUntilNextWindow, setMsUntilNextWindow] = createSignal(
+    asyncRateLimiter.getMsUntilNextWindow()
+  );
+  function setOptions(newOptions) {
+    asyncRateLimiter.setOptions({
+      ...newOptions,
+      onExecute: (rateLimiter) => {
+        setExecutionCount(rateLimiter.getExecutionCount());
+        setRemainingInWindow(rateLimiter.getRemainingInWindow());
+        setMsUntilNextWindow(rateLimiter.getMsUntilNextWindow());
+        const onExecute = newOptions.onExecute ?? initialOptions.onExecute;
+        onExecute == null ? void 0 : onExecute(rateLimiter);
+      },
+      onReject: (rateLimiter) => {
+        setRejectionCount(rateLimiter.getRejectionCount());
+        setRemainingInWindow(rateLimiter.getRemainingInWindow());
+        setMsUntilNextWindow(rateLimiter.getMsUntilNextWindow());
+        const onReject = newOptions.onReject ?? initialOptions.onReject;
+        onReject == null ? void 0 : onReject(rateLimiter);
+      }
+    });
+  }
+  setOptions(initialOptions);
+  return {
+    ...bindInstanceMethods(asyncRateLimiter),
+    executionCount,
+    rejectionCount,
+    remainingInWindow,
+    msUntilNextWindow,
+    setOptions
+  };
+}
+export {
+  createAsyncRateLimiter
+};
+//# sourceMappingURL=createAsyncRateLimiter.js.map

package/dist/esm/async-rate-limiter/createAsyncRateLimiter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createAsyncRateLimiter.js","sources":["../../../src/async-rate-limiter/createAsyncRateLimiter.ts"],"sourcesContent":["import { AsyncRateLimiter } from '@tanstack/pacer/async-rate-limiter'\nimport { createSignal } from 'solid-js'\nimport { bindInstanceMethods } from '@tanstack/pacer/utils'\nimport type { Accessor } from 'solid-js'\nimport type { AnyAsyncFunction } from '@tanstack/pacer/types'\nimport type { AsyncRateLimiterOptions } from '@tanstack/pacer/async-rate-limiter'\n\nexport interface SolidAsyncRateLimiter<\n  TFn extends AnyAsyncFunction,\n  TArgs extends Parameters<TFn>,\n> extends Omit<\n    AsyncRateLimiter<TFn, TArgs>,\n    | 'getExecutionCount'\n    | 'getRejectionCount'\n    | 'getRemainingInWindow'\n    | 'getMsUntilNextWindow'\n  > {\n  executionCount: Accessor<number>\n  rejectionCount: Accessor<number>\n  remainingInWindow: Accessor<number>\n  msUntilNextWindow: Accessor<number>\n}\n\n/**\n * A low-level Solid hook that creates an `AsyncRateLimiter` instance to limit how many times an async function can execute within a time window.\n *\n * This hook is designed to be flexible and state-management agnostic - it simply returns a rate limiter instance that\n * you can integrate with any state management solution (createSignal, etc).\n *\n * Rate limiting allows an async function to execute up to a specified limit within a time window,\n * then blocks subsequent calls until the window passes. This is useful for respecting API rate limits,\n * managing resource constraints, or controlling bursts of async operations.\n *\n * @example\n * ```tsx\n * // Basic API call rate limiting\n * const { maybeExecute } = createAsyncRateLimiter(\n *   async (id: string) => {\n *     const data = await api.fetchData(id);\n *     return data;\n *   },\n *   { limit: 5, window: 1000 } // 5 calls per second\n * );\n *\n * // With state management\n * const [data, setData] = createSignal(null);\n * const { maybeExecute } = createAsyncRateLimiter(\n *   async (query) => {\n *     const result = await searchAPI(query);\n *     setData(result);\n *   },\n *   {\n *     limit: 10,\n *     window: 60000, // 10 calls per minute\n *     onReject: (info) => console.log(`Rate limit exceeded: ${info.nextValidTime - Date.now()}ms until next window`)\n *   }\n * );\n * ```\n */\nexport function createAsyncRateLimiter<\n  TFn extends AnyAsyncFunction,\n  TArgs extends Parameters<TFn>,\n>(\n  fn: TFn,\n  initialOptions: AsyncRateLimiterOptions<TFn, TArgs>,\n): SolidAsyncRateLimiter<TFn, TArgs> {\n  const asyncRateLimiter = new AsyncRateLimiter<TFn, TArgs>(fn, initialOptions)\n\n  const [executionCount, setExecutionCount] = createSignal(\n    asyncRateLimiter.getExecutionCount(),\n  )\n  const [rejectionCount, setRejectionCount] = createSignal(\n    asyncRateLimiter.getRejectionCount(),\n  )\n  const [remainingInWindow, setRemainingInWindow] = createSignal(\n    asyncRateLimiter.getRemainingInWindow(),\n  )\n  const [msUntilNextWindow, setMsUntilNextWindow] = createSignal(\n    asyncRateLimiter.getMsUntilNextWindow(),\n  )\n\n  function setOptions(\n    newOptions: Partial<AsyncRateLimiterOptions<TFn, TArgs>>,\n  ) {\n    asyncRateLimiter.setOptions({\n      ...newOptions,\n      onExecute: (rateLimiter) => {\n        setExecutionCount(rateLimiter.getExecutionCount())\n        setRemainingInWindow(rateLimiter.getRemainingInWindow())\n        setMsUntilNextWindow(rateLimiter.getMsUntilNextWindow())\n\n        const onExecute = newOptions.onExecute ?? initialOptions.onExecute\n        onExecute?.(rateLimiter)\n      },\n      onReject: (rateLimiter) => {\n        setRejectionCount(rateLimiter.getRejectionCount())\n        setRemainingInWindow(rateLimiter.getRemainingInWindow())\n        setMsUntilNextWindow(rateLimiter.getMsUntilNextWindow())\n\n        const onReject = newOptions.onReject ?? initialOptions.onReject\n        onReject?.(rateLimiter)\n      },\n    })\n  }\n\n  setOptions(initialOptions)\n\n  return {\n    ...bindInstanceMethods(asyncRateLimiter),\n    executionCount,\n    rejectionCount,\n    remainingInWindow,\n    msUntilNextWindow,\n    setOptions,\n  }\n}\n"],"names":[],"mappings":";;;AA2DgB,SAAA,uBAId,IACA,gBACmC;AACnC,QAAM,mBAAmB,IAAI,iBAA6B,IAAI,cAAc;AAEtE,QAAA,CAAC,gBAAgB,iBAAiB,IAAI;AAAA,IAC1C,iBAAiB,kBAAkB;AAAA,EACrC;AACM,QAAA,CAAC,gBAAgB,iBAAiB,IAAI;AAAA,IAC1C,iBAAiB,kBAAkB;AAAA,EACrC;AACM,QAAA,CAAC,mBAAmB,oBAAoB,IAAI;AAAA,IAChD,iBAAiB,qBAAqB;AAAA,EACxC;AACM,QAAA,CAAC,mBAAmB,oBAAoB,IAAI;AAAA,IAChD,iBAAiB,qBAAqB;AAAA,EACxC;AAEA,WAAS,WACP,YACA;AACA,qBAAiB,WAAW;AAAA,MAC1B,GAAG;AAAA,MACH,WAAW,CAAC,gBAAgB;AACR,0BAAA,YAAY,mBAAmB;AAC5B,6BAAA,YAAY,sBAAsB;AAClC,6BAAA,YAAY,sBAAsB;AAEjD,cAAA,YAAY,WAAW,aAAa,eAAe;AACzD,+CAAY;AAAA,MACd;AAAA,MACA,UAAU,CAAC,gBAAgB;AACP,0BAAA,YAAY,mBAAmB;AAC5B,6BAAA,YAAY,sBAAsB;AAClC,6BAAA,YAAY,sBAAsB;AAEjD,cAAA,WAAW,WAAW,YAAY,eAAe;AACvD,6CAAW;AAAA,MAAW;AAAA,IACxB,CACD;AAAA,EAAA;AAGH,aAAW,cAAc;AAElB,SAAA;AAAA,IACL,GAAG,oBAAoB,gBAAgB;AAAA,IACvC;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACF;"}

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

@@ -0,0 +1,2 @@
+export * from '@tanstack/pacer/async-rate-limiter';
+export * from './createAsyncRateLimiter.js';

package/dist/esm/async-rate-limiter/index.js

@@ -0,0 +1,6 @@
+export * from "@tanstack/pacer/async-rate-limiter";
+import { createAsyncRateLimiter } from "./createAsyncRateLimiter.js";
+export {
+  createAsyncRateLimiter
+};
+//# sourceMappingURL=index.js.map

package/dist/esm/async-rate-limiter/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;"}

package/dist/esm/async-throttler/createAsyncThrottler.d.ts

@@ -0,0 +1,46 @@
+import { AsyncThrottler, AsyncThrottlerOptions } from '@tanstack/pacer/async-throttler';
+import { Accessor } from 'solid-js';
+import { AnyAsyncFunction } from '@tanstack/pacer/types';
+export interface SolidAsyncThrottler<TFn extends AnyAsyncFunction, TArgs extends Parameters<TFn>> extends Omit<AsyncThrottler<TFn, TArgs>, 'getExecutionCount' | 'getIsPending' | 'getLastExecutionTime' | 'getNextExecutionTime'> {
+    executionCount: Accessor<number>;
+    isPending: Accessor<boolean>;
+    lastExecutionTime: Accessor<number>;
+    nextExecutionTime: Accessor<number>;
+}
+/**
+ * A low-level Solid hook that creates an `AsyncThrottler` instance to limit how often an async function can execute.
+ *
+ * This hook is designed to be flexible and state-management agnostic - it simply returns a throttler instance that
+ * you can integrate with any state management solution (createSignal, etc).
+ *
+ * Async throttling ensures an async function executes at most once within a specified time window,
+ * regardless of how many times it is called. This is useful for rate-limiting expensive API calls,
+ * database operations, or other async tasks.
+ *
+ * @example
+ * ```tsx
+ * // Basic API call throttling
+ * const { maybeExecute } = createAsyncThrottler(
+ *   async (id: string) => {
+ *     const data = await api.fetchData(id);
+ *     return data;
+ *   },
+ *   { wait: 1000 }
+ * );
+ *
+ * // With state management
+ * const [data, setData] = createSignal(null);
+ * const { maybeExecute } = createAsyncThrottler(
+ *   async (query) => {
+ *     const result = await searchAPI(query);
+ *     setData(result);
+ *   },
+ *   {
+ *     wait: 2000,
+ *     leading: true,   // Execute immediately on first call
+ *     trailing: false  // Skip trailing edge updates
+ *   }
+ * );
+ * ```
+ */
+export declare function createAsyncThrottler<TFn extends AnyAsyncFunction, TArgs extends Parameters<TFn>>(fn: TFn, initialOptions: AsyncThrottlerOptions<TFn, TArgs>): SolidAsyncThrottler<TFn, TArgs>;

package/dist/esm/async-throttler/createAsyncThrottler.js

@@ -0,0 +1,42 @@
+import { AsyncThrottler } from "@tanstack/pacer/async-throttler";
+import { createSignal } from "solid-js";
+import { bindInstanceMethods } from "@tanstack/pacer/utils";
+function createAsyncThrottler(fn, initialOptions) {
+  const asyncThrottler = new AsyncThrottler(fn, initialOptions);
+  const [executionCount, setExecutionCount] = createSignal(
+    asyncThrottler.getExecutionCount()
+  );
+  const [isPending, setIsPending] = createSignal(asyncThrottler.getIsPending());
+  const [lastExecutionTime, setLastExecutionTime] = createSignal(
+    asyncThrottler.getLastExecutionTime()
+  );
+  const [nextExecutionTime, setNextExecutionTime] = createSignal(
+    asyncThrottler.getNextExecutionTime()
+  );
+  function setOptions(newOptions) {
+    asyncThrottler.setOptions({
+      ...newOptions,
+      onExecute: (throttler) => {
+        setExecutionCount(throttler.getExecutionCount());
+        setIsPending(throttler.getIsPending());
+        setLastExecutionTime(throttler.getLastExecutionTime());
+        setNextExecutionTime(throttler.getNextExecutionTime());
+        const onExecute = newOptions.onExecute ?? initialOptions.onExecute;
+        onExecute == null ? void 0 : onExecute(throttler);
+      }
+    });
+  }
+  setOptions(initialOptions);
+  return {
+    ...bindInstanceMethods(asyncThrottler),
+    executionCount,
+    isPending,
+    lastExecutionTime,
+    nextExecutionTime,
+    setOptions
+  };
+}
+export {
+  createAsyncThrottler
+};
+//# sourceMappingURL=createAsyncThrottler.js.map

package/dist/esm/async-throttler/createAsyncThrottler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createAsyncThrottler.js","sources":["../../../src/async-throttler/createAsyncThrottler.ts"],"sourcesContent":["import { AsyncThrottler } from '@tanstack/pacer/async-throttler'\nimport { createSignal } from 'solid-js'\nimport { bindInstanceMethods } from '@tanstack/pacer/utils'\nimport type { Accessor } from 'solid-js'\nimport type { AnyAsyncFunction } from '@tanstack/pacer/types'\nimport type { AsyncThrottlerOptions } from '@tanstack/pacer/async-throttler'\n\nexport interface SolidAsyncThrottler<\n  TFn extends AnyAsyncFunction,\n  TArgs extends Parameters<TFn>,\n> extends Omit<\n    AsyncThrottler<TFn, TArgs>,\n    | 'getExecutionCount'\n    | 'getIsPending'\n    | 'getLastExecutionTime'\n    | 'getNextExecutionTime'\n  > {\n  executionCount: Accessor<number>\n  isPending: Accessor<boolean>\n  lastExecutionTime: Accessor<number>\n  nextExecutionTime: Accessor<number>\n}\n\n/**\n * A low-level Solid hook that creates an `AsyncThrottler` instance to limit how often an async function can execute.\n *\n * This hook is designed to be flexible and state-management agnostic - it simply returns a throttler instance that\n * you can integrate with any state management solution (createSignal, etc).\n *\n * Async throttling ensures an async function executes at most once within a specified time window,\n * regardless of how many times it is called. This is useful for rate-limiting expensive API calls,\n * database operations, or other async tasks.\n *\n * @example\n * ```tsx\n * // Basic API call throttling\n * const { maybeExecute } = createAsyncThrottler(\n *   async (id: string) => {\n *     const data = await api.fetchData(id);\n *     return data;\n *   },\n *   { wait: 1000 }\n * );\n *\n * // With state management\n * const [data, setData] = createSignal(null);\n * const { maybeExecute } = createAsyncThrottler(\n *   async (query) => {\n *     const result = await searchAPI(query);\n *     setData(result);\n *   },\n *   {\n *     wait: 2000,\n *     leading: true,   // Execute immediately on first call\n *     trailing: false  // Skip trailing edge updates\n *   }\n * );\n * ```\n */\n\nexport function createAsyncThrottler<\n  TFn extends AnyAsyncFunction,\n  TArgs extends Parameters<TFn>,\n>(\n  fn: TFn,\n  initialOptions: AsyncThrottlerOptions<TFn, TArgs>,\n): SolidAsyncThrottler<TFn, TArgs> {\n  const asyncThrottler = new AsyncThrottler<TFn, TArgs>(fn, initialOptions)\n\n  const [executionCount, setExecutionCount] = createSignal(\n    asyncThrottler.getExecutionCount(),\n  )\n  const [isPending, setIsPending] = createSignal(asyncThrottler.getIsPending())\n  const [lastExecutionTime, setLastExecutionTime] = createSignal(\n    asyncThrottler.getLastExecutionTime(),\n  )\n  const [nextExecutionTime, setNextExecutionTime] = createSignal(\n    asyncThrottler.getNextExecutionTime(),\n  )\n\n  function setOptions(newOptions: Partial<AsyncThrottlerOptions<TFn, TArgs>>) {\n    asyncThrottler.setOptions({\n      ...newOptions,\n      onExecute: (throttler) => {\n        setExecutionCount(throttler.getExecutionCount())\n        setIsPending(throttler.getIsPending())\n        setLastExecutionTime(throttler.getLastExecutionTime())\n        setNextExecutionTime(throttler.getNextExecutionTime())\n\n        const onExecute = newOptions.onExecute ?? initialOptions.onExecute\n        onExecute?.(throttler)\n      },\n    })\n  }\n\n  setOptions(initialOptions)\n\n  return {\n    ...bindInstanceMethods(asyncThrottler),\n    executionCount,\n    isPending,\n    lastExecutionTime,\n    nextExecutionTime,\n    setOptions,\n  }\n}\n"],"names":[],"mappings":";;;AA4DgB,SAAA,qBAId,IACA,gBACiC;AACjC,QAAM,iBAAiB,IAAI,eAA2B,IAAI,cAAc;AAElE,QAAA,CAAC,gBAAgB,iBAAiB,IAAI;AAAA,IAC1C,eAAe,kBAAkB;AAAA,EACnC;AACA,QAAM,CAAC,WAAW,YAAY,IAAI,aAAa,eAAe,cAAc;AACtE,QAAA,CAAC,mBAAmB,oBAAoB,IAAI;AAAA,IAChD,eAAe,qBAAqB;AAAA,EACtC;AACM,QAAA,CAAC,mBAAmB,oBAAoB,IAAI;AAAA,IAChD,eAAe,qBAAqB;AAAA,EACtC;AAEA,WAAS,WAAW,YAAwD;AAC1E,mBAAe,WAAW;AAAA,MACxB,GAAG;AAAA,MACH,WAAW,CAAC,cAAc;AACN,0BAAA,UAAU,mBAAmB;AAClC,qBAAA,UAAU,cAAc;AAChB,6BAAA,UAAU,sBAAsB;AAChC,6BAAA,UAAU,sBAAsB;AAE/C,cAAA,YAAY,WAAW,aAAa,eAAe;AACzD,+CAAY;AAAA,MAAS;AAAA,IACvB,CACD;AAAA,EAAA;AAGH,aAAW,cAAc;AAElB,SAAA;AAAA,IACL,GAAG,oBAAoB,cAAc;AAAA,IACrC;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACF;"}

package/dist/esm/async-throttler/index.d.ts

@@ -0,0 +1,2 @@
+export * from '@tanstack/pacer/async-throttler';
+export * from './createAsyncThrottler.js';

package/dist/esm/async-throttler/index.js

@@ -0,0 +1,6 @@
+export * from "@tanstack/pacer/async-throttler";
+import { createAsyncThrottler } from "./createAsyncThrottler.js";
+export {
+  createAsyncThrottler
+};
+//# sourceMappingURL=index.js.map

package/dist/esm/async-throttler/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;"}

package/dist/esm/compare/index.d.ts

@@ -0,0 +1 @@
+export * from '@tanstack/pacer/compare';

package/dist/esm/compare/index.js

@@ -0,0 +1,2 @@
+export * from "@tanstack/pacer/compare";
+//# sourceMappingURL=index.js.map

package/dist/esm/compare/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";"}

package/dist/esm/debouncer/createDebouncedSignal.d.ts

@@ -0,0 +1,47 @@
+import { SolidDebouncer } from './createDebouncer.js';
+import { Accessor, Setter } from 'solid-js';
+import { DebouncerOptions } from '@tanstack/pacer/debouncer';
+/**
+ * A Solid hook that creates a debounced state value, combining Solid's createSignal with debouncing functionality.
+ * This hook 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 hook returns a tuple containing:
+ * - The current debounced value accessor
+ * - A function to update the debounced value
+ * - The debouncer instance with additional control methods and state signals
+ *
+ * @example
+ * ```tsx
+ * // Debounced search input
+ * const [searchTerm, setSearchTerm, debouncer] = createDebouncedSignal('', {
+ *   wait: 500 // Wait 500ms after last keystroke
+ * });
+ *
+ * // Update value - will be debounced
+ * const handleChange = (e) => {
+ *   setSearchTerm(e.target.value);
+ * };
+ *
+ * // Access debouncer state via signals
+ * console.log('Executions:', debouncer.executionCount());
+ * console.log('Is pending:', debouncer.isPending());
+ *
+ * // In onExecute callback, use get* methods
+ * const [searchTerm, setSearchTerm, debouncer] = createDebouncedSignal('', {
+ *   wait: 500,
+ *   onExecute: (debouncer) => {
+ *     console.log('Total executions:', debouncer.getExecutionCount());
+ *   }
+ * });
+ * ```
+ */
+export declare function createDebouncedSignal<TValue>(value: TValue, initialOptions: DebouncerOptions<Setter<TValue>, [Accessor<TValue>]>): [
+    Accessor<TValue>,
+    Setter<TValue>,
+    SolidDebouncer<Setter<TValue>, [Accessor<TValue>]>
+];

package/dist/esm/debouncer/createDebouncedSignal.js

@@ -0,0 +1,11 @@
+import { createSignal } from "solid-js";
+import { createDebouncer } from "./createDebouncer.js";
+function createDebouncedSignal(value, initialOptions) {
+  const [debouncedValue, setDebouncedValue] = createSignal(value);
+  const debouncer = createDebouncer(setDebouncedValue, initialOptions);
+  return [debouncedValue, debouncer.maybeExecute, debouncer];
+}
+export {
+  createDebouncedSignal
+};
+//# sourceMappingURL=createDebouncedSignal.js.map

package/dist/esm/debouncer/createDebouncedSignal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createDebouncedSignal.js","sources":["../../../src/debouncer/createDebouncedSignal.ts"],"sourcesContent":["import { createSignal } from 'solid-js'\nimport { createDebouncer } from './createDebouncer'\nimport type { SolidDebouncer } from './createDebouncer'\nimport type { Accessor, Setter } from 'solid-js'\nimport type { DebouncerOptions } from '@tanstack/pacer/debouncer'\n\n/**\n * A Solid hook that creates a debounced state value, combining Solid's createSignal with debouncing functionality.\n * This hook 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 hook returns a tuple containing:\n * - The current debounced value accessor\n * - A function to update the debounced value\n * - The debouncer instance with additional control methods and state signals\n *\n * @example\n * ```tsx\n * // Debounced search input\n * const [searchTerm, setSearchTerm, debouncer] = createDebouncedSignal('', {\n *   wait: 500 // Wait 500ms after last keystroke\n * });\n *\n * // Update value - will be debounced\n * const handleChange = (e) => {\n *   setSearchTerm(e.target.value);\n * };\n *\n * // Access debouncer state via signals\n * console.log('Executions:', debouncer.executionCount());\n * console.log('Is pending:', debouncer.isPending());\n *\n * // In onExecute callback, use get* methods\n * const [searchTerm, setSearchTerm, debouncer] = createDebouncedSignal('', {\n *   wait: 500,\n *   onExecute: (debouncer) => {\n *     console.log('Total executions:', debouncer.getExecutionCount());\n *   }\n * });\n * ```\n */\nexport function createDebouncedSignal<TValue>(\n  value: TValue,\n  initialOptions: DebouncerOptions<Setter<TValue>, [Accessor<TValue>]>,\n): [\n  Accessor<TValue>,\n  Setter<TValue>,\n  SolidDebouncer<Setter<TValue>, [Accessor<TValue>]>,\n] {\n  const [debouncedValue, setDebouncedValue] = createSignal<TValue>(value)\n\n  const debouncer = createDebouncer(setDebouncedValue, initialOptions)\n\n  return [debouncedValue, debouncer.maybeExecute as Setter<TValue>, debouncer]\n}\n"],"names":[],"mappings":";;AA6CgB,SAAA,sBACd,OACA,gBAKA;AACA,QAAM,CAAC,gBAAgB,iBAAiB,IAAI,aAAqB,KAAK;AAEhE,QAAA,YAAY,gBAAgB,mBAAmB,cAAc;AAEnE,SAAO,CAAC,gBAAgB,UAAU,cAAgC,SAAS;AAC7E;"}

package/dist/esm/debouncer/createDebouncedValue.d.ts

@@ -0,0 +1,44 @@
+import { SolidDebouncer } from './createDebouncer.js';
+import { Accessor, Setter } from 'solid-js';
+import { DebouncerOptions } from '@tanstack/pacer/debouncer';
+/**
+ * A Solid hook that creates a debounced value that updates only after a specified delay.
+ * Unlike createDebouncedSignal, this hook automatically tracks changes to the input value
+ * and updates the debounced value accordingly.
+ *
+ * The debounced value will only update after the specified wait time has elapsed since
+ * the last change to the input value. If the input value changes again before the wait
+ * time expires, the timer resets and starts waiting again.
+ *
+ * This is useful for deriving debounced values from props or state that change frequently,
+ * like search queries or form inputs, where you want to limit how often downstream effects
+ * or calculations occur.
+ *
+ * The hook returns a tuple containing:
+ * - The current debounced value (as an Accessor)
+ * - The debouncer instance with control methods and state signals
+ *
+ * @example
+ * ```tsx
+ * // Debounce a search query
+ * const [searchQuery, setSearchQuery] = createSignal('');
+ * const [debouncedQuery, debouncer] = createDebouncedValue(searchQuery, {
+ *   wait: 500 // Wait 500ms after last change
+ * });
+ *
+ * // debouncedQuery will update 500ms after searchQuery stops changing
+ * createEffect(() => {
+ *   fetchSearchResults(debouncedQuery());
+ * });
+ *
+ * // Access debouncer state via signals
+ * console.log('Executions:', debouncer.executionCount());
+ * console.log('Is pending:', debouncer.isPending());
+ *
+ * // Handle input changes
+ * const handleChange = (e) => {
+ *   setSearchQuery(e.target.value);
+ * };
+ * ```
+ */
+export declare function createDebouncedValue<TValue>(value: Accessor<TValue>, initialOptions: DebouncerOptions<Setter<TValue>, [Accessor<TValue>]>): [Accessor<TValue>, SolidDebouncer<Setter<TValue>, [Accessor<TValue>]>];

package/dist/esm/debouncer/createDebouncedValue.js

@@ -0,0 +1,19 @@
+import { createEffect, onCleanup } from "solid-js";
+import { createDebouncedSignal } from "./createDebouncedSignal.js";
+function createDebouncedValue(value, initialOptions) {
+  const [debouncedValue, setDebouncedValue, debouncer] = createDebouncedSignal(
+    value(),
+    initialOptions
+  );
+  createEffect(() => {
+    setDebouncedValue(value());
+    onCleanup(() => {
+      debouncer.cancel();
+    });
+  });
+  return [debouncedValue, debouncer];
+}
+export {
+  createDebouncedValue
+};
+//# sourceMappingURL=createDebouncedValue.js.map

package/dist/esm/debouncer/createDebouncedValue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createDebouncedValue.js","sources":["../../../src/debouncer/createDebouncedValue.ts"],"sourcesContent":["import { createEffect, onCleanup } from 'solid-js'\nimport { createDebouncedSignal } from './createDebouncedSignal'\nimport type { SolidDebouncer } from './createDebouncer'\nimport type { Accessor, Setter } from 'solid-js'\nimport type { DebouncerOptions } from '@tanstack/pacer/debouncer'\n\n/**\n * A Solid hook that creates a debounced value that updates only after a specified delay.\n * Unlike createDebouncedSignal, this hook automatically tracks changes to the input value\n * and updates the debounced value accordingly.\n *\n * The debounced value will only update after the specified wait time has elapsed since\n * the last change to the input value. If the input value changes again before the wait\n * time expires, the timer resets and starts waiting again.\n *\n * This is useful for deriving debounced values from props or state that change frequently,\n * like search queries or form inputs, where you want to limit how often downstream effects\n * or calculations occur.\n *\n * The hook returns a tuple containing:\n * - The current debounced value (as an Accessor)\n * - The debouncer instance with control methods and state signals\n *\n * @example\n * ```tsx\n * // Debounce a search query\n * const [searchQuery, setSearchQuery] = createSignal('');\n * const [debouncedQuery, debouncer] = createDebouncedValue(searchQuery, {\n *   wait: 500 // Wait 500ms after last change\n * });\n *\n * // debouncedQuery will update 500ms after searchQuery stops changing\n * createEffect(() => {\n *   fetchSearchResults(debouncedQuery());\n * });\n *\n * // Access debouncer state via signals\n * console.log('Executions:', debouncer.executionCount());\n * console.log('Is pending:', debouncer.isPending());\n *\n * // Handle input changes\n * const handleChange = (e) => {\n *   setSearchQuery(e.target.value);\n * };\n * ```\n */\nexport function createDebouncedValue<TValue>(\n  value: Accessor<TValue>,\n  initialOptions: DebouncerOptions<Setter<TValue>, [Accessor<TValue>]>,\n): [Accessor<TValue>, SolidDebouncer<Setter<TValue>, [Accessor<TValue>]>] {\n  const [debouncedValue, setDebouncedValue, debouncer] = createDebouncedSignal(\n    value(),\n    initialOptions,\n  )\n\n  createEffect(() => {\n    setDebouncedValue(value() as any)\n    onCleanup(() => {\n      debouncer.cancel()\n    })\n  })\n\n  return [debouncedValue, debouncer]\n}\n"],"names":[],"mappings":";;AA8CgB,SAAA,qBACd,OACA,gBACwE;AACxE,QAAM,CAAC,gBAAgB,mBAAmB,SAAS,IAAI;AAAA,IACrD,MAAM;AAAA,IACN;AAAA,EACF;AAEA,eAAa,MAAM;AACjB,sBAAkB,OAAc;AAChC,cAAU,MAAM;AACd,gBAAU,OAAO;AAAA,IAAA,CAClB;AAAA,EAAA,CACF;AAEM,SAAA,CAAC,gBAAgB,SAAS;AACnC;"}

package/dist/esm/debouncer/createDebouncer.d.ts

@@ -0,0 +1,47 @@
+import { Debouncer, DebouncerOptions } from '@tanstack/pacer/debouncer';
+import { Accessor } from 'solid-js';
+import { AnyFunction } from '@tanstack/pacer/types';
+/**
+ * An extension of the Debouncer class that adds Solid signals to access the internal state of the debouncer
+ */
+export interface SolidDebouncer<TFn extends AnyFunction, TArgs extends Parameters<TFn>> extends Omit<Debouncer<TFn, TArgs>, 'getExecutionCount' | 'getIsPending'> {
+    executionCount: Accessor<number>;
+    isPending: Accessor<boolean>;
+}
+/**
+ * A Solid hook that creates and manages a Debouncer instance.
+ *
+ * This is a lower-level hook that provides direct access to the Debouncer's functionality without
+ * any built-in state management. This allows you to integrate it with any state management solution
+ * you prefer (createSignal, Redux, Zustand, etc.).
+ *
+ * This hook provides debouncing functionality to limit how often a function can be called,
+ * waiting for a specified delay before executing the latest call. This is useful for handling
+ * frequent events like window resizing, scroll events, or real-time search inputs.
+ *
+ * The debouncer will only execute the function after the specified wait time has elapsed
+ * since the last call. If the function is called again before the wait time expires, the
+ * timer resets and starts waiting again.
+ *
+ * @example
+ * ```tsx
+ * // Debounce a search function to limit API calls
+ * const debouncer = createDebouncer(
+ *   (query: string) => fetchSearchResults(query),
+ *   { wait: 500 } // Wait 500ms after last keystroke
+ * );
+ *
+ * // In an event handler
+ * const handleChange = (e) => {
+ *   debouncer.maybeExecute(e.target.value);
+ * };
+ *
+ * // Access debouncer state via signals
+ * console.log('Executions:', debouncer.executionCount());
+ * console.log('Is pending:', debouncer.isPending());
+ *
+ * // Update options
+ * debouncer.setOptions({ wait: 1000 });
+ * ```
+ */
+export declare function createDebouncer<TFn extends AnyFunction, TArgs extends Parameters<TFn>>(fn: TFn, initialOptions: DebouncerOptions<TFn, TArgs>): SolidDebouncer<TFn, TArgs>;