@tanstack/solid-pacer 0.21.1 → 0.23.0

package/dist/batcher/createBatcher.d.cts

@@ -1,147 +0,0 @@
-import { Store } from "@tanstack/solid-store";
-import { Accessor, JSX } from "solid-js";
-import { Batcher, BatcherOptions, BatcherState } from "@tanstack/pacer/batcher";
-
-//#region src/batcher/createBatcher.d.ts
-interface SolidBatcherOptions<TValue, TSelected = {}> extends BatcherOptions<TValue> {
-  /**
-   * Optional callback invoked when the owning component unmounts. Receives the batcher instance.
-   * When provided, replaces the default cleanup (cancel); use it to call flush(), reset(), cancel(), add logging, etc.
-   */
-  onUnmount?: (batcher: SolidBatcher<TValue, TSelected>) => void;
-}
-interface SolidBatcher<TValue, TSelected = {}> extends Omit<Batcher<TValue>, 'store'> {
-  /**
-   * A Solid component that allows you to subscribe to the batcher state.
-   *
-   * This is useful for tracking specific parts of the batcher state
-   * deep in your component tree without needing to pass a selector to the hook.
-   *
-   * @example
-   * <batcher.Subscribe selector={(state) => ({ size: state.size, isRunning: state.isRunning })}>
-   *   {(state) => (
-   *     <div>Batch: {state().size} items, {state().isRunning ? 'Processing' : 'Idle'}</div>
-   *   )}
-   * </batcher.Subscribe>
-   */
-  Subscribe: <TSelected>(props: {
-    selector: (state: BatcherState<TValue>) => TSelected;
-    children: ((state: Accessor<TSelected>) => JSX.Element) | JSX.Element;
-  }) => JSX.Element;
-  /**
-   * Reactive state that will be updated when the batcher state changes
-   *
-   * Use this instead of `batcher.store.state`
-   */
-  readonly state: Accessor<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, as it has not been wrapped in a `useSelector` hook internally.
-   * Although, you can make the state reactive by using the `useSelector` in your own usage.
-   */
-  readonly store: Store<Readonly<BatcherState<TValue>>>;
-}
-/**
- * Creates a Solid-compatible Batcher instance for managing batches of items, exposing Solid signals for all stateful properties.
- *
- * Features:
- * - Batch processing of items using the provided `fn` function
- * - Configurable batch size and wait time
- * - Custom batch processing logic via getShouldExecute
- * - Event callbacks for monitoring batch operations
- * - All stateful properties (items, counts, etc.) are exposed as Solid signals for reactivity
- *
- * The batcher collects items and processes them in batches based on:
- * - Maximum batch size
- * - Time-based batching (process after X milliseconds)
- * - Custom batch processing logic via getShouldExecute
- *
- * ## State Management and Selector
- *
- * The hook uses TanStack Store for reactive state management. You can subscribe to state changes
- * in two ways:
- *
- * **1. Using `batcher.Subscribe` component (Recommended for component tree subscriptions)**
- *
- * Use the `Subscribe` component to subscribe to state changes deep in your component tree without
- * needing to pass a selector to the hook. This is ideal when you want to subscribe to state
- * in child components.
- *
- * **2. Using the `selector` parameter (For hook-level subscriptions)**
- *
- * The `selector` parameter allows you to specify which state changes will trigger reactive updates
- * at the hook level, 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 or using the `Subscribe` component. This prevents unnecessary
- * updates and gives you full control over when your component tracks state changes.
- *
- * Available state properties:
- * - `executionCount`: Number of batch executions that have been completed
- * - `isRunning`: Whether the batcher is currently running (not stopped)
- * - `items`: Array of items currently queued for batching
- * - `totalItemsProcessed`: Total number of individual items that have been processed across all batches
- *
- * ## Unmount behavior
- *
- * By default, the primitive cancels any pending batch when the owning component unmounts.
- * Use the `onUnmount` option to customize this. For example, to flush pending work instead:
- *
- * ```tsx
- * const batcher = createBatcher(fn, {
- *   maxSize: 10,
- *   wait: 2000,
- *   onUnmount: (b) => b.flush()
- * });
- * ```
- *
- * Example usage:
- * ```tsx
- * // Default behavior - no reactive state subscriptions
- * const batcher = createBatcher(
- *   (items) => {
- *     // Process batch of items
- *     console.log('Processing batch:', items);
- *   },
- *   {
- *     maxSize: 5,
- *     wait: 2000,
- *     onExecute: (batcher) => console.log('Batch executed'),
- *     getShouldExecute: (items) => items.length >= 3
- *   }
- * );
- *
- * // Opt-in to track items or isRunning changes (optimized for UI updates)
- * const batcher = createBatcher(
- *   (items) => console.log('Processing batch:', items),
- *   { maxSize: 5, wait: 2000 },
- *   (state) => ({ items: state.items, isRunning: state.isRunning })
- * );
- *
- * // Opt-in to track execution metrics changes (optimized for tracking progress)
- * const batcher = createBatcher(
- *   (items) => console.log('Processing batch:', items),
- *   { maxSize: 5, wait: 2000 },
- *   (state) => ({
- *     executionCount: state.executionCount,
- *     totalItemsProcessed: state.totalItemsProcessed
- *   })
- * );
- *
- * // Add items to batch
- * batcher.addItem('task1');
- * batcher.addItem('task2');
- *
- * // Control the batcher
- * batcher.stop();  // Pause processing
- * batcher.start(); // Resume processing
- *
- * // Access the selected state (will be empty object {} unless selector provided)
- * const { items, isRunning } = batcher.state();
- * ```
- */
-declare function createBatcher<TValue, TSelected = {}>(fn: (items: Array<TValue>) => void, options?: SolidBatcherOptions<TValue, TSelected>, selector?: (state: BatcherState<TValue>) => TSelected): SolidBatcher<TValue, TSelected>;
-//#endregion
-export { SolidBatcher, SolidBatcherOptions, createBatcher };
-//# sourceMappingURL=createBatcher.d.cts.map

package/dist/batcher/createBatcher.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"createBatcher.js","names":[],"sources":["../../src/batcher/createBatcher.ts"],"sourcesContent":["import { Batcher } from '@tanstack/pacer/batcher'\nimport { shallow, useSelector } from '@tanstack/solid-store'\nimport { createEffect, onCleanup } from 'solid-js'\nimport { useDefaultPacerOptions } from '../provider/PacerProvider'\nimport type { Store } from '@tanstack/solid-store'\nimport type { Accessor, JSX } from 'solid-js'\nimport type { BatcherOptions, BatcherState } from '@tanstack/pacer/batcher'\n\nexport interface SolidBatcherOptions<\n  TValue,\n  TSelected = {},\n> extends BatcherOptions<TValue> {\n  /**\n   * Optional callback invoked when the owning component unmounts. Receives the batcher instance.\n   * When provided, replaces the default cleanup (cancel); use it to call flush(), reset(), cancel(), add logging, etc.\n   */\n  onUnmount?: (batcher: SolidBatcher<TValue, TSelected>) => void\n}\n\nexport interface SolidBatcher<TValue, TSelected = {}> extends Omit<\n  Batcher<TValue>,\n  'store'\n> {\n  /**\n   * A Solid component that allows you to subscribe to the batcher state.\n   *\n   * This is useful for tracking specific parts of the batcher state\n   * deep in your component tree without needing to pass a selector to the hook.\n   *\n   * @example\n   * <batcher.Subscribe selector={(state) => ({ size: state.size, isRunning: state.isRunning })}>\n   *   {(state) => (\n   *     <div>Batch: {state().size} items, {state().isRunning ? 'Processing' : 'Idle'}</div>\n   *   )}\n   * </batcher.Subscribe>\n   */\n  Subscribe: <TSelected>(props: {\n    selector: (state: BatcherState<TValue>) => TSelected\n    children: ((state: Accessor<TSelected>) => JSX.Element) | JSX.Element\n  }) => JSX.Element\n  /**\n   * Reactive state that will be updated when the batcher state changes\n   *\n   * Use this instead of `batcher.store.state`\n   */\n  readonly state: Accessor<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, as it has not been wrapped in a `useSelector` hook internally.\n   * Although, you can make the state reactive by using the `useSelector` in your own usage.\n   */\n  readonly store: Store<Readonly<BatcherState<TValue>>>\n}\n\n/**\n * Creates a Solid-compatible Batcher instance for managing batches of items, exposing Solid signals for all stateful properties.\n *\n * Features:\n * - Batch processing of items using the provided `fn` function\n * - Configurable batch size and wait time\n * - Custom batch processing logic via getShouldExecute\n * - Event callbacks for monitoring batch operations\n * - All stateful properties (items, counts, etc.) are exposed as Solid signals for reactivity\n *\n * The batcher collects items and processes them in batches based on:\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 hook uses TanStack Store for reactive state management. You can subscribe to state changes\n * in two ways:\n *\n * **1. Using `batcher.Subscribe` component (Recommended for component tree subscriptions)**\n *\n * Use the `Subscribe` component to subscribe to state changes deep in your component tree without\n * needing to pass a selector to the hook. This is ideal when you want to subscribe to state\n * in child components.\n *\n * **2. Using the `selector` parameter (For hook-level subscriptions)**\n *\n * The `selector` parameter allows you to specify which state changes will trigger reactive updates\n * at the hook level, optimizing performance by preventing unnecessary updates when irrelevant\n * state changes occur.\n *\n * **By default, there will be no reactive state subscriptions** and you must opt-in to state\n * tracking by providing a selector function or using the `Subscribe` component. This prevents unnecessary\n * updates and gives you full control over when your component tracks state changes.\n *\n * Available state properties:\n * - `executionCount`: Number of batch executions that have been completed\n * - `isRunning`: Whether the batcher is currently running (not stopped)\n * - `items`: Array of items currently queued for batching\n * - `totalItemsProcessed`: Total number of individual items that have been processed across all batches\n *\n * ## Unmount behavior\n *\n * By default, the primitive cancels any pending batch when the owning component unmounts.\n * Use the `onUnmount` option to customize this. For example, to flush pending work instead:\n *\n * ```tsx\n * const batcher = createBatcher(fn, {\n *   maxSize: 10,\n *   wait: 2000,\n *   onUnmount: (b) => b.flush()\n * });\n * ```\n *\n * Example usage:\n * ```tsx\n * // Default behavior - no reactive state subscriptions\n * const batcher = createBatcher(\n *   (items) => {\n *     // Process batch of items\n *     console.log('Processing batch:', items);\n *   },\n *   {\n *     maxSize: 5,\n *     wait: 2000,\n *     onExecute: (batcher) => console.log('Batch executed'),\n *     getShouldExecute: (items) => items.length >= 3\n *   }\n * );\n *\n * // Opt-in to track items or isRunning changes (optimized for UI updates)\n * const batcher = createBatcher(\n *   (items) => console.log('Processing batch:', items),\n *   { maxSize: 5, wait: 2000 },\n *   (state) => ({ items: state.items, isRunning: state.isRunning })\n * );\n *\n * // Opt-in to track execution metrics changes (optimized for tracking progress)\n * const batcher = createBatcher(\n *   (items) => console.log('Processing batch:', items),\n *   { maxSize: 5, wait: 2000 },\n *   (state) => ({\n *     executionCount: state.executionCount,\n *     totalItemsProcessed: state.totalItemsProcessed\n *   })\n * );\n *\n * // Add items to batch\n * batcher.addItem('task1');\n * batcher.addItem('task2');\n *\n * // Control the batcher\n * batcher.stop();  // Pause processing\n * batcher.start(); // Resume processing\n *\n * // Access the selected state (will be empty object {} unless selector provided)\n * const { items, isRunning } = batcher.state();\n * ```\n */\nexport function createBatcher<TValue, TSelected = {}>(\n  fn: (items: Array<TValue>) => void,\n  options: SolidBatcherOptions<TValue, TSelected> = {},\n  selector: (state: BatcherState<TValue>) => TSelected = () =>\n    ({}) as TSelected,\n): SolidBatcher<TValue, TSelected> {\n  const mergedOptions = {\n    ...useDefaultPacerOptions().batcher,\n    ...options,\n  } as SolidBatcherOptions<TValue, TSelected>\n  const batcher = new Batcher(fn, mergedOptions) as unknown as SolidBatcher<\n    TValue,\n    TSelected\n  >\n\n  batcher.Subscribe = function Subscribe<TSelected>(props: {\n    selector: (state: BatcherState<TValue>) => TSelected\n    children: ((state: Accessor<TSelected>) => JSX.Element) | JSX.Element\n  }) {\n    const selected = useSelector(batcher.store, props.selector, {\n      compare: shallow,\n    })\n\n    return typeof props.children === 'function'\n      ? props.children(selected)\n      : props.children\n  }\n\n  const state = useSelector(batcher.store, selector, { compare: shallow })\n\n  createEffect(() => {\n    onCleanup(() => {\n      if (mergedOptions.onUnmount) {\n        mergedOptions.onUnmount(batcher)\n      } else {\n        batcher.cancel()\n      }\n    })\n  })\n\n  return {\n    ...batcher,\n    state,\n  } as SolidBatcher<TValue, TSelected>\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA0JA,SAAgB,cACd,IACA,UAAkD,EAAE,EACpD,kBACG,EAAE,GAC4B;CACjC,MAAM,gBAAgB;EACpB,GAAG,wBAAwB,CAAC;EAC5B,GAAG;EACJ;CACD,MAAM,UAAU,IAAI,QAAQ,IAAI,cAAc;CAK9C,QAAQ,YAAY,SAAS,UAAqB,OAG/C;EACD,MAAM,WAAW,YAAY,QAAQ,OAAO,MAAM,UAAU,EAC1D,SAAS,SACV,CAAC;EAEF,OAAO,OAAO,MAAM,aAAa,aAC7B,MAAM,SAAS,SAAS,GACxB,MAAM;;CAGZ,MAAM,QAAQ,YAAY,QAAQ,OAAO,UAAU,EAAE,SAAS,SAAS,CAAC;CAExE,mBAAmB;EACjB,gBAAgB;GACd,IAAI,cAAc,WAChB,cAAc,UAAU,QAAQ;QAEhC,QAAQ,QAAQ;IAElB;GACF;CAEF,OAAO;EACL,GAAG;EACH;EACD"}

package/dist/batcher/index.cjs

@@ -1,11 +0,0 @@
-Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_createBatcher = require('./createBatcher.cjs');
-
-exports.createBatcher = require_createBatcher.createBatcher;
-var _tanstack_pacer_batcher = require("@tanstack/pacer/batcher");
-Object.keys(_tanstack_pacer_batcher).forEach(function (k) {
-  if (k !== 'default' && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
-    enumerable: true,
-    get: function () { return _tanstack_pacer_batcher[k]; }
-  });
-});

package/dist/batcher/index.d.cts

@@ -1,3 +0,0 @@
-import { SolidBatcher, SolidBatcherOptions, createBatcher } from "./createBatcher.cjs";
-export * from "@tanstack/pacer/batcher";
-export { SolidBatcher, SolidBatcherOptions, createBatcher };

package/dist/debouncer/createDebouncedSignal.cjs

@@ -1,88 +0,0 @@
-const require_createDebouncer = require('./createDebouncer.cjs');
-let solid_js = require("solid-js");
-
-//#region src/debouncer/createDebouncedSignal.ts
-/**
-* 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
-*
-* ## State Management and Selector
-*
-* The hook 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 reactive 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 reactive updates and gives you
-* full control over when your component subscribes to 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
-* ```tsx
-* // Default behavior - no reactive state subscriptions
-* const [searchTerm, setSearchTerm, debouncer] = createDebouncedSignal('', {
-*   wait: 500 // Wait 500ms after last keystroke
-* });
-*
-* // Opt-in to reactive updates when pending state changes (optimized for loading indicators)
-* const [searchTerm, setSearchTerm, debouncer] = createDebouncedSignal(
-*   '',
-*   { wait: 500 },
-*   (state) => ({ isPending: state.isPending })
-* );
-*
-* // Opt-in to reactive updates when execution count changes (optimized for tracking executions)
-* const [searchTerm, setSearchTerm, debouncer] = createDebouncedSignal(
-*   '',
-*   { wait: 500 },
-*   (state) => ({ executionCount: state.executionCount })
-* );
-*
-* // Update value - will be debounced
-* const handleChange = (e) => {
-*   setSearchTerm(e.target.value);
-* };
-*
-* // Access debouncer state via signals
-* console.log('Executions:', debouncer.state().executionCount);
-* console.log('Is pending:', debouncer.state().isPending);
-*
-* // In onExecute callback, use get* methods
-* const [searchTerm, setSearchTerm, debouncer] = createDebouncedSignal('', {
-*   wait: 500,
-*   onExecute: (debouncer) => {
-*     console.log('Total executions:', debouncer.getExecutionCount());
-*   }
-* });
-* ```
-*/
-function createDebouncedSignal(value, initialOptions, selector) {
-	const [debouncedValue, setDebouncedValue] = (0, solid_js.createSignal)(value);
-	const debouncer = require_createDebouncer.createDebouncer(setDebouncedValue, initialOptions, selector);
-	return [
-		debouncedValue,
-		debouncer.maybeExecute,
-		debouncer
-	];
-}
-
-//#endregion
-exports.createDebouncedSignal = createDebouncedSignal;
-//# sourceMappingURL=createDebouncedSignal.cjs.map

package/dist/debouncer/createDebouncedSignal.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"createDebouncedSignal.cjs","names":["createDebouncer"],"sources":["../../src/debouncer/createDebouncedSignal.ts"],"sourcesContent":["import { createSignal } from 'solid-js'\nimport { createDebouncer } from './createDebouncer'\nimport type { SolidDebouncer, SolidDebouncerOptions } from './createDebouncer'\nimport type { Accessor, Setter } from 'solid-js'\nimport type { DebouncerState } 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 * ## State Management and Selector\n *\n * The hook uses TanStack Store for reactive state management via the underlying debouncer instance.\n * The `selector` parameter allows you to specify which debouncer state changes will trigger reactive 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 reactive updates and gives you\n * full control over when your component subscribes to 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 * ```tsx\n * // Default behavior - no reactive state subscriptions\n * const [searchTerm, setSearchTerm, debouncer] = createDebouncedSignal('', {\n *   wait: 500 // Wait 500ms after last keystroke\n * });\n *\n * // Opt-in to reactive updates when pending state changes (optimized for loading indicators)\n * const [searchTerm, setSearchTerm, debouncer] = createDebouncedSignal(\n *   '',\n *   { wait: 500 },\n *   (state) => ({ isPending: state.isPending })\n * );\n *\n * // Opt-in to reactive updates when execution count changes (optimized for tracking executions)\n * const [searchTerm, setSearchTerm, debouncer] = createDebouncedSignal(\n *   '',\n *   { wait: 500 },\n *   (state) => ({ executionCount: state.executionCount })\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.state().executionCount);\n * console.log('Is pending:', debouncer.state().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, TSelected = {}>(\n  value: TValue,\n  initialOptions: SolidDebouncerOptions<Setter<TValue>, TSelected>,\n  selector?: (state: DebouncerState<Setter<TValue>>) => TSelected,\n): [\n  Accessor<TValue>,\n  Setter<TValue>,\n  SolidDebouncer<Setter<TValue>, TSelected>,\n] {\n  const [debouncedValue, setDebouncedValue] = createSignal<TValue>(value)\n\n  const debouncer = createDebouncer(setDebouncedValue, initialOptions, selector)\n\n  return [debouncedValue, debouncer.maybeExecute as Setter<TValue>, debouncer]\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6EA,SAAgB,sBACd,OACA,gBACA,UAKA;CACA,MAAM,CAAC,gBAAgB,gDAA0C,MAAM;CAEvE,MAAM,YAAYA,wCAAgB,mBAAmB,gBAAgB,SAAS;CAE9E,OAAO;EAAC;EAAgB,UAAU;EAAgC;EAAU"}

package/dist/debouncer/createDebouncedSignal.d.cts

@@ -1,80 +0,0 @@
-import { SolidDebouncer, SolidDebouncerOptions } from "./createDebouncer.cjs";
-import { Accessor, Setter } from "solid-js";
-import { DebouncerState } from "@tanstack/pacer/debouncer";
-
-//#region src/debouncer/createDebouncedSignal.d.ts
-/**
- * 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
- *
- * ## State Management and Selector
- *
- * The hook 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 reactive 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 reactive updates and gives you
- * full control over when your component subscribes to 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
- * ```tsx
- * // Default behavior - no reactive state subscriptions
- * const [searchTerm, setSearchTerm, debouncer] = createDebouncedSignal('', {
- *   wait: 500 // Wait 500ms after last keystroke
- * });
- *
- * // Opt-in to reactive updates when pending state changes (optimized for loading indicators)
- * const [searchTerm, setSearchTerm, debouncer] = createDebouncedSignal(
- *   '',
- *   { wait: 500 },
- *   (state) => ({ isPending: state.isPending })
- * );
- *
- * // Opt-in to reactive updates when execution count changes (optimized for tracking executions)
- * const [searchTerm, setSearchTerm, debouncer] = createDebouncedSignal(
- *   '',
- *   { wait: 500 },
- *   (state) => ({ executionCount: state.executionCount })
- * );
- *
- * // Update value - will be debounced
- * const handleChange = (e) => {
- *   setSearchTerm(e.target.value);
- * };
- *
- * // Access debouncer state via signals
- * console.log('Executions:', debouncer.state().executionCount);
- * console.log('Is pending:', debouncer.state().isPending);
- *
- * // In onExecute callback, use get* methods
- * const [searchTerm, setSearchTerm, debouncer] = createDebouncedSignal('', {
- *   wait: 500,
- *   onExecute: (debouncer) => {
- *     console.log('Total executions:', debouncer.getExecutionCount());
- *   }
- * });
- * ```
- */
-declare function createDebouncedSignal<TValue, TSelected = {}>(value: TValue, initialOptions: SolidDebouncerOptions<Setter<TValue>, TSelected>, selector?: (state: DebouncerState<Setter<TValue>>) => TSelected): [Accessor<TValue>, Setter<TValue>, SolidDebouncer<Setter<TValue>, TSelected>];
-//#endregion
-export { createDebouncedSignal };
-//# sourceMappingURL=createDebouncedSignal.d.cts.map

package/dist/debouncer/createDebouncedSignal.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"createDebouncedSignal.js","names":[],"sources":["../../src/debouncer/createDebouncedSignal.ts"],"sourcesContent":["import { createSignal } from 'solid-js'\nimport { createDebouncer } from './createDebouncer'\nimport type { SolidDebouncer, SolidDebouncerOptions } from './createDebouncer'\nimport type { Accessor, Setter } from 'solid-js'\nimport type { DebouncerState } 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 * ## State Management and Selector\n *\n * The hook uses TanStack Store for reactive state management via the underlying debouncer instance.\n * The `selector` parameter allows you to specify which debouncer state changes will trigger reactive 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 reactive updates and gives you\n * full control over when your component subscribes to 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 * ```tsx\n * // Default behavior - no reactive state subscriptions\n * const [searchTerm, setSearchTerm, debouncer] = createDebouncedSignal('', {\n *   wait: 500 // Wait 500ms after last keystroke\n * });\n *\n * // Opt-in to reactive updates when pending state changes (optimized for loading indicators)\n * const [searchTerm, setSearchTerm, debouncer] = createDebouncedSignal(\n *   '',\n *   { wait: 500 },\n *   (state) => ({ isPending: state.isPending })\n * );\n *\n * // Opt-in to reactive updates when execution count changes (optimized for tracking executions)\n * const [searchTerm, setSearchTerm, debouncer] = createDebouncedSignal(\n *   '',\n *   { wait: 500 },\n *   (state) => ({ executionCount: state.executionCount })\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.state().executionCount);\n * console.log('Is pending:', debouncer.state().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, TSelected = {}>(\n  value: TValue,\n  initialOptions: SolidDebouncerOptions<Setter<TValue>, TSelected>,\n  selector?: (state: DebouncerState<Setter<TValue>>) => TSelected,\n): [\n  Accessor<TValue>,\n  Setter<TValue>,\n  SolidDebouncer<Setter<TValue>, TSelected>,\n] {\n  const [debouncedValue, setDebouncedValue] = createSignal<TValue>(value)\n\n  const debouncer = createDebouncer(setDebouncedValue, initialOptions, selector)\n\n  return [debouncedValue, debouncer.maybeExecute as Setter<TValue>, debouncer]\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6EA,SAAgB,sBACd,OACA,gBACA,UAKA;CACA,MAAM,CAAC,gBAAgB,qBAAqB,aAAqB,MAAM;CAEvE,MAAM,YAAY,gBAAgB,mBAAmB,gBAAgB,SAAS;CAE9E,OAAO;EAAC;EAAgB,UAAU;EAAgC;EAAU"}

package/dist/debouncer/createDebouncedValue.cjs

@@ -1,77 +0,0 @@
-const require_createDebouncedSignal = require('./createDebouncedSignal.cjs');
-let solid_js = require("solid-js");
-
-//#region src/debouncer/createDebouncedValue.ts
-/**
-* 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:
-* - An Accessor that provides the current debounced value
-* - The debouncer instance with control methods
-*
-* ## State Management and Selector
-*
-* The hook 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 reactive 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 reactive updates and gives you
-* full control over when your component subscribes to 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
-* ```tsx
-* // Default behavior - no reactive state subscriptions
-* const [searchQuery, setSearchQuery] = createSignal('');
-* const [debouncedQuery, debouncer] = createDebouncedValue(searchQuery, {
-*   wait: 500 // Wait 500ms after last change
-* });
-*
-* // Opt-in to reactive updates when pending state changes (optimized for loading indicators)
-* const [debouncedQuery, debouncer] = createDebouncedValue(
-*   searchQuery,
-*   { wait: 500 },
-*   (state) => ({ isPending: state.isPending })
-* );
-*
-* // debouncedQuery will update 500ms after searchQuery stops changing
-* createEffect(() => {
-*   fetchSearchResults(debouncedQuery());
-* });
-*
-* // Access debouncer state via signals
-* console.log('Is pending:', debouncer.state().isPending);
-*
-* // Control the debouncer
-* debouncer.cancel(); // Cancel any pending updates
-* ```
-*/
-function createDebouncedValue(value, initialOptions, selector) {
-	const [debouncedValue, setDebouncedValue, debouncer] = require_createDebouncedSignal.createDebouncedSignal(value(), initialOptions, selector);
-	(0, solid_js.createEffect)(() => {
-		setDebouncedValue(value());
-	});
-	return [debouncedValue, debouncer];
-}
-
-//#endregion
-exports.createDebouncedValue = createDebouncedValue;
-//# sourceMappingURL=createDebouncedValue.cjs.map

package/dist/debouncer/createDebouncedValue.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"createDebouncedValue.cjs","names":["createDebouncedSignal"],"sources":["../../src/debouncer/createDebouncedValue.ts"],"sourcesContent":["import { createEffect } from 'solid-js'\nimport { createDebouncedSignal } from './createDebouncedSignal'\nimport type { SolidDebouncer, SolidDebouncerOptions } from './createDebouncer'\nimport type { Accessor, Setter } from 'solid-js'\nimport type { DebouncerState } 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 * - An Accessor that provides the current debounced value\n * - The debouncer instance with control methods\n *\n * ## State Management and Selector\n *\n * The hook uses TanStack Store for reactive state management via the underlying debouncer instance.\n * The `selector` parameter allows you to specify which debouncer state changes will trigger reactive 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 reactive updates and gives you\n * full control over when your component subscribes to 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 * ```tsx\n * // Default behavior - no reactive state subscriptions\n * const [searchQuery, setSearchQuery] = createSignal('');\n * const [debouncedQuery, debouncer] = createDebouncedValue(searchQuery, {\n *   wait: 500 // Wait 500ms after last change\n * });\n *\n * // Opt-in to reactive updates when pending state changes (optimized for loading indicators)\n * const [debouncedQuery, debouncer] = createDebouncedValue(\n *   searchQuery,\n *   { wait: 500 },\n *   (state) => ({ isPending: state.isPending })\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('Is pending:', debouncer.state().isPending);\n *\n * // Control the debouncer\n * debouncer.cancel(); // Cancel any pending updates\n * ```\n */\nexport function createDebouncedValue<TValue, TSelected = {}>(\n  value: Accessor<TValue>,\n  initialOptions: SolidDebouncerOptions<Setter<TValue>, TSelected>,\n  selector?: (state: DebouncerState<Setter<TValue>>) => TSelected,\n): [Accessor<TValue>, SolidDebouncer<Setter<TValue>, TSelected>] {\n  const [debouncedValue, setDebouncedValue, debouncer] = createDebouncedSignal(\n    value(),\n    initialOptions,\n    selector,\n  )\n\n  createEffect(() => {\n    setDebouncedValue(value() as any)\n  })\n\n  return [debouncedValue, debouncer]\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAoEA,SAAgB,qBACd,OACA,gBACA,UAC+D;CAC/D,MAAM,CAAC,gBAAgB,mBAAmB,aAAaA,oDACrD,OAAO,EACP,gBACA,SACD;CAED,iCAAmB;EACjB,kBAAkB,OAAO,CAAQ;GACjC;CAEF,OAAO,CAAC,gBAAgB,UAAU"}

package/dist/debouncer/createDebouncedValue.d.cts

@@ -1,71 +0,0 @@
-import { SolidDebouncer, SolidDebouncerOptions } from "./createDebouncer.cjs";
-import { Accessor, Setter } from "solid-js";
-import { DebouncerState } from "@tanstack/pacer/debouncer";
-
-//#region src/debouncer/createDebouncedValue.d.ts
-/**
- * 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:
- * - An Accessor that provides the current debounced value
- * - The debouncer instance with control methods
- *
- * ## State Management and Selector
- *
- * The hook 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 reactive 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 reactive updates and gives you
- * full control over when your component subscribes to 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
- * ```tsx
- * // Default behavior - no reactive state subscriptions
- * const [searchQuery, setSearchQuery] = createSignal('');
- * const [debouncedQuery, debouncer] = createDebouncedValue(searchQuery, {
- *   wait: 500 // Wait 500ms after last change
- * });
- *
- * // Opt-in to reactive updates when pending state changes (optimized for loading indicators)
- * const [debouncedQuery, debouncer] = createDebouncedValue(
- *   searchQuery,
- *   { wait: 500 },
- *   (state) => ({ isPending: state.isPending })
- * );
- *
- * // debouncedQuery will update 500ms after searchQuery stops changing
- * createEffect(() => {
- *   fetchSearchResults(debouncedQuery());
- * });
- *
- * // Access debouncer state via signals
- * console.log('Is pending:', debouncer.state().isPending);
- *
- * // Control the debouncer
- * debouncer.cancel(); // Cancel any pending updates
- * ```
- */
-declare function createDebouncedValue<TValue, TSelected = {}>(value: Accessor<TValue>, initialOptions: SolidDebouncerOptions<Setter<TValue>, TSelected>, selector?: (state: DebouncerState<Setter<TValue>>) => TSelected): [Accessor<TValue>, SolidDebouncer<Setter<TValue>, TSelected>];
-//#endregion
-export { createDebouncedValue };
-//# sourceMappingURL=createDebouncedValue.d.cts.map

package/dist/debouncer/createDebouncedValue.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"createDebouncedValue.js","names":[],"sources":["../../src/debouncer/createDebouncedValue.ts"],"sourcesContent":["import { createEffect } from 'solid-js'\nimport { createDebouncedSignal } from './createDebouncedSignal'\nimport type { SolidDebouncer, SolidDebouncerOptions } from './createDebouncer'\nimport type { Accessor, Setter } from 'solid-js'\nimport type { DebouncerState } 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 * - An Accessor that provides the current debounced value\n * - The debouncer instance with control methods\n *\n * ## State Management and Selector\n *\n * The hook uses TanStack Store for reactive state management via the underlying debouncer instance.\n * The `selector` parameter allows you to specify which debouncer state changes will trigger reactive 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 reactive updates and gives you\n * full control over when your component subscribes to 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 * ```tsx\n * // Default behavior - no reactive state subscriptions\n * const [searchQuery, setSearchQuery] = createSignal('');\n * const [debouncedQuery, debouncer] = createDebouncedValue(searchQuery, {\n *   wait: 500 // Wait 500ms after last change\n * });\n *\n * // Opt-in to reactive updates when pending state changes (optimized for loading indicators)\n * const [debouncedQuery, debouncer] = createDebouncedValue(\n *   searchQuery,\n *   { wait: 500 },\n *   (state) => ({ isPending: state.isPending })\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('Is pending:', debouncer.state().isPending);\n *\n * // Control the debouncer\n * debouncer.cancel(); // Cancel any pending updates\n * ```\n */\nexport function createDebouncedValue<TValue, TSelected = {}>(\n  value: Accessor<TValue>,\n  initialOptions: SolidDebouncerOptions<Setter<TValue>, TSelected>,\n  selector?: (state: DebouncerState<Setter<TValue>>) => TSelected,\n): [Accessor<TValue>, SolidDebouncer<Setter<TValue>, TSelected>] {\n  const [debouncedValue, setDebouncedValue, debouncer] = createDebouncedSignal(\n    value(),\n    initialOptions,\n    selector,\n  )\n\n  createEffect(() => {\n    setDebouncedValue(value() as any)\n  })\n\n  return [debouncedValue, debouncer]\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAoEA,SAAgB,qBACd,OACA,gBACA,UAC+D;CAC/D,MAAM,CAAC,gBAAgB,mBAAmB,aAAa,sBACrD,OAAO,EACP,gBACA,SACD;CAED,mBAAmB;EACjB,kBAAkB,OAAO,CAAQ;GACjC;CAEF,OAAO,CAAC,gBAAgB,UAAU"}