@alwatr/debounce 1.1.20 → 2.0.0

package/dist/debounce.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"debounce.d.ts","sourceRoot":"","sources":["../src/debounce.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,WAAW,CAAC;AAE/C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,qBAAa,SAAS,CAAC,CAAC,SAAS,OAAO;IAK1B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAJrC,OAAO,CAAC,SAAS,CAAC,CAA0B;IAC5C,OAAO,CAAC,gBAAgB,CAAC,CAA0B;IACnD,OAAO,CAAC,UAAU,CAAC,CAAgB;gBAEN,QAAQ,EAAE,eAAe,CAAC,CAAC,CAAC;IAKzD;;;OAGG;IACH,IAAW,SAAS,IAAI,OAAO,CAE9B;IAED;;;;;;;;;;;;;;;;OAgBG;IACI,OAAO,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,IAAI;IAwB5C;;;;;;;;;;;;;;;OAeG;IACI,MAAM,IAAI,IAAI;IAUrB;;OAEG;IACH,OAAO,CAAC,SAAS;IAMjB;;;;;;;;;;;;;;;;;OAiBG;IACI,KAAK,IAAI,IAAI;IAOpB;;OAEG;IACH,OAAO,CAAC,QAAQ;CAOjB"}
+{"version":3,"file":"debounce.d.ts","sourceRoot":"","sources":["../src/debounce.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,WAAW,CAAC;AAE/C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,qBAAa,SAAS,CAAC,CAAC,SAAS,OAAO;IAK1B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAJrC,OAAO,CAAC,SAAS,CAAC,CAA0B;IAC5C,OAAO,CAAC,gBAAgB,CAAC,CAA0B;IACnD,OAAO,CAAC,UAAU,CAAC,CAAgB;gBAEN,QAAQ,EAAE,eAAe,CAAC,CAAC,CAAC;IAOzD;;;OAGG;IACH,IAAW,SAAS,IAAI,OAAO,CAE9B;IAED;;;;;;;;;;;;;;;;OAgBG;IACI,OAAO,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,IAAI;IAwB5C;;;;;;;;;;;;;;;OAeG;IACI,MAAM,IAAI,IAAI;IAUrB;;OAEG;IACH,OAAO,CAAC,SAAS;IAMjB;;;;;;;;;;;;;;;;;OAiBG;IACI,KAAK,IAAI,IAAI;IAOpB;;OAEG;IACH,OAAO,CAAC,QAAQ;CAOjB"}

package/dist/main.js

@@ -0,0 +1,5 @@
+/* 📦 @alwatr/debounce v2.0.0 */
+class z{config__;timerId__;maxWaitTimerId__;lastArgs__;constructor(q){this.config__=q;this.config__.trailing??=!0,this.flush=this.flush.bind(this),this.trigger=this.trigger.bind(this),this.cancel=this.cancel.bind(this)}get isPending(){return this.timerId__!==void 0}trigger(...q){if(this.lastArgs__=q,!this.isPending){if(this.config__.maxWait)this.maxWaitTimerId__=setTimeout(this.flush,this.config__.maxWait);if(this.config__.leading===!0)this.invoke__()}else clearTimeout(this.timerId__);this.timerId__=setTimeout(()=>{if(this.config__.trailing===!0)this.invoke__();this.cleanup__()},this.config__.delay)}cancel(){if(this.timerId__)clearTimeout(this.timerId__);if(this.maxWaitTimerId__)clearTimeout(this.maxWaitTimerId__);this.cleanup__()}cleanup__(){delete this.timerId__,delete this.maxWaitTimerId__,delete this.lastArgs__}flush(){if(this.isPending)this.invoke__();this.cancel()}invoke__(){if(this.lastArgs__)this.config__.func.apply(this.config__.thisContext,this.lastArgs__),this.lastArgs__=void 0}}function G(q){return new z(q)}export{G as createDebouncer,z as Debouncer};
+
+//# debugId=D7DE4832A046BAB664756E2164756E21
+//# sourceMappingURL=main.js.map

package/dist/main.js.map

@@ -0,0 +1,11 @@
+{
+  "version": 3,
+  "sources": ["../src/debounce.ts", "../src/main.ts"],
+  "sourcesContent": [
+    "import type {DebouncerConfig} from './type.ts';\n\n/**\n * A powerful and type-safe Debouncer class.\n *\n * It encapsulates the debouncing logic, state, and provides a rich control API.\n * Debouncing delays function execution until after a specified delay has passed since the last invocation.\n * Useful for optimizing performance in scenarios like search inputs, resize events, or API calls.\n *\n * @example\n * ```typescript\n * const debouncer = new Debouncer({\n *   func: (text: string) => console.log('Searching:', text),\n *   delay: 300,\n *   leading: false,\n *   trailing: true,\n * });\n *\n * // Debounce search input\n * debouncer.trigger('hello');\n * debouncer.trigger('hello world'); // Only 'hello world' will log after 300ms\n *\n * // Advanced: With leading edge\n * const leadingDebouncer = new Debouncer({\n *   func: () => console.log('Immediate and delayed'),\n *   delay: 500,\n *   leading: true,\n *   trailing: true,\n * });\n * leadingDebouncer.trigger(); // Logs immediately, then again after 500ms if not cancelled\n * ```\n */\nexport class Debouncer<F extends AnyFunc> {\n  private timerId__?: number | NodeJS.Timeout;\n  private maxWaitTimerId__?: number | NodeJS.Timeout;\n  private lastArgs__?: Parameters<F>;\n\n  constructor(private readonly config__: DebouncerConfig<F>) {\n    this.config__.trailing ??= true;\n    this.flush = this.flush.bind(this);\n    this.trigger = this.trigger.bind(this);\n    this.cancel = this.cancel.bind(this);\n  }\n\n  /**\n   * Checks if there is a pending execution scheduled.\n   * Returns true if a timer is active, indicating a debounced call is waiting.\n   */\n  public get isPending(): boolean {\n    return this.timerId__ !== undefined;\n  }\n\n  /**\n   * Triggers the debounced function with the stored `thisContext`.\n   * @param args The arguments to pass to the `func`.\n   *\n   * @example\n   * ```typescript\n   * const debouncer = new Debouncer({\n   *   func: (value: number) => console.log('Value:', value),\n   *   delay: 500,\n   * });\n   * debouncer.trigger(42); // Logs after 500ms if not triggered again\n   *\n   * // Edge case: Rapid triggers only execute the last one\n   * debouncer.trigger(1);\n   * debouncer.trigger(2); // Only 2 will execute after delay\n   * ```\n   */\n  public trigger(...args: Parameters<F>): void {\n    this.lastArgs__ = args; // its an array even if triggered without any args\n    const firstTrigger = !this.isPending;\n\n    if (firstTrigger) {\n      if (this.config__.maxWait) {\n        this.maxWaitTimerId__ = setTimeout(this.flush, this.config__.maxWait);\n      }\n      if (this.config__.leading === true) {\n        this.invoke__();\n      }\n    }\n    else {\n      clearTimeout(this.timerId__!);\n    }\n\n    this.timerId__ = setTimeout(() => {\n      if (this.config__.trailing === true) {\n        this.invoke__();\n      }\n      this.cleanup__();\n    }, this.config__.delay);\n  }\n\n  /**\n   * Cancels any pending debounced execution and cleans up internal state.\n   * Useful for stopping execution when the operation is no longer needed (e.g., component unmount).\n   *\n   * @example\n   * ```typescript\n   * const debouncer = new Debouncer({\n   *   func: () => console.log('Executed'),\n   *   delay: 1000,\n   * });\n   * debouncer.trigger();\n   * debouncer.cancel(); // Prevents execution\n   *\n   * // Note: After cancel, isPending becomes false\n   * ```\n   */\n  public cancel(): void {\n    if (this.timerId__) {\n      clearTimeout(this.timerId__);\n    }\n    if (this.maxWaitTimerId__) {\n      clearTimeout(this.maxWaitTimerId__);\n    }\n    this.cleanup__();\n  }\n\n  /**\n   * Cleans up internal state by deleting timer and arguments.\n   */\n  private cleanup__(): void {\n    delete this.timerId__;\n    delete this.maxWaitTimerId__;\n    delete this.lastArgs__;\n  }\n\n  /**\n   * Immediately executes the pending function if one exists.\n   * Bypasses the delay and cleans up state. If no pending call, does nothing.\n   *\n   * @example\n   * ```typescript\n   * const debouncer = new Debouncer({\n   *   func: () => console.log('Flushed'),\n   *   delay: 1000,\n   * });\n   * debouncer.trigger();\n   * setTimeout(() => debouncer.flush(), 500); // Executes immediately\n   *\n   * // Edge case: Flush after cancel does nothing\n   * debouncer.cancel();\n   * debouncer.flush(); // No execution\n   * ```\n   */\n  public flush(): void {\n    if (this.isPending) {\n      this.invoke__();\n    }\n    this.cancel();\n  }\n\n  /**\n   * The core execution logic.\n   */\n  private invoke__(): void {\n    if (this.lastArgs__) {\n      // only call if we have new args (skip trailing call if leading already called)\n      this.config__.func.apply(this.config__.thisContext, this.lastArgs__);\n      this.lastArgs__ = undefined;\n    }\n  }\n}\n",
+    "import {Debouncer} from './debounce.js';\n\nimport type {DebouncerConfig} from './type.js';\n\nexport * from './debounce.js';\nexport type * from './type.js';\n\n/**\n * Factory function for creating a Debouncer instance for better type inference.\n * @param config Configuration for the debouncer.\n *\n * @example\n * ```typescript\n * const debouncer = createDebouncer({\n *   func: (text: string) => console.log('Searching:', text),\n *   delay: 300,\n *   leading: false,\n *   trailing: true,\n * });\n *\n * // Debounce search input\n * debouncer.trigger('hello');\n * debouncer.trigger('hello world'); // Only 'hello world' will log after 300ms\n *\n * // With custom thisContext\n * const obj = { log: (msg: string) => console.log('Obj:', msg) };\n * const debouncerWithContext = createDebouncer({\n *   func: obj.log,\n *   thisContext: obj,\n *   delay: 200,\n * });\n * debouncerWithContext.trigger('test'); // Logs 'Obj: test'\n * ```\n */\nexport function createDebouncer<F extends AnyFunc>(config: DebouncerConfig<F>): Debouncer<F> {\n  return new Debouncer(config);\n}\n"
+  ],
+  "mappings": ";AAgCO,MAAM,CAA6B,CAKX,SAJrB,UACA,iBACA,WAER,WAAW,CAAkB,EAA8B,CAA9B,gBAC3B,KAAK,SAAS,WAAa,GAC3B,KAAK,MAAQ,KAAK,MAAM,KAAK,IAAI,EACjC,KAAK,QAAU,KAAK,QAAQ,KAAK,IAAI,EACrC,KAAK,OAAS,KAAK,OAAO,KAAK,IAAI,KAO1B,UAAS,EAAY,CAC9B,OAAO,KAAK,YAAc,OAoBrB,OAAO,IAAI,EAA2B,CAI3C,GAHA,KAAK,WAAa,EACG,CAAC,KAAK,UAET,CAChB,GAAI,KAAK,SAAS,QAChB,KAAK,iBAAmB,WAAW,KAAK,MAAO,KAAK,SAAS,OAAO,EAEtE,GAAI,KAAK,SAAS,UAAY,GAC5B,KAAK,SAAS,EAIhB,kBAAa,KAAK,SAAU,EAG9B,KAAK,UAAY,WAAW,IAAM,CAChC,GAAI,KAAK,SAAS,WAAa,GAC7B,KAAK,SAAS,EAEhB,KAAK,UAAU,GACd,KAAK,SAAS,KAAK,EAmBjB,MAAM,EAAS,CACpB,GAAI,KAAK,UACP,aAAa,KAAK,SAAS,EAE7B,GAAI,KAAK,iBACP,aAAa,KAAK,gBAAgB,EAEpC,KAAK,UAAU,EAMT,SAAS,EAAS,CACxB,OAAO,KAAK,UACZ,OAAO,KAAK,iBACZ,OAAO,KAAK,WAqBP,KAAK,EAAS,CACnB,GAAI,KAAK,UACP,KAAK,SAAS,EAEhB,KAAK,OAAO,EAMN,QAAQ,EAAS,CACvB,GAAI,KAAK,WAEP,KAAK,SAAS,KAAK,MAAM,KAAK,SAAS,YAAa,KAAK,UAAU,EACnE,KAAK,WAAa,OAGxB,CCjIO,SAAS,CAAkC,CAAC,EAA0C,CAC3F,OAAO,IAAI,EAAU,CAAM",
+  "debugId": "D7DE4832A046BAB664756E2164756E21",
+  "names": []
+}

package/package.json

@@ -1,26 +1,26 @@
 {
   "name": "@alwatr/debounce",
   "description": "A powerful, modern, and type-safe debouncer utility designed for high-performance applications. It's framework-agnostic, works seamlessly in both Node.js and browsers, and provides a rich API for fine-grained control over function execution.",
-  "version": "1.1.20",
+  "version": "2.0.0",
   "author": "S. Ali Mihandoost <ali.mihandoost@gmail.com>",
   "bugs": "https://github.com/Alwatr/nanolib/issues",
   "devDependencies": {
-    "@alwatr/nano-build": "6.4.2",
-    "@alwatr/prettier-config": "6.0.2",
-    "@alwatr/tsconfig-base": "6.0.4",
-    "@alwatr/type-helper": "7.0.2",
+    "@alwatr/nano-build": "7.0.0",
+    "@alwatr/prettier-config": "7.0.0",
+    "@alwatr/tsconfig-base": "7.0.0",
+    "@alwatr/type-helper": "8.0.0",
     "@types/node": "^24.12.0",
     "typescript": "^5.9.3"
   },
   "exports": {
     ".": {
       "types": "./dist/main.d.ts",
-      "import": "./dist/main.mjs",
-      "require": "./dist/main.cjs"
+      "default": "./dist/main.js"
     }
   },
   "files": [
-    "**/*.{js,mjs,cjs,map,d.ts,html,md,LEGAL.txt}",
+    "**/*.{js,mjs,cjs,ts,map,d.ts,html,LEGAL.txt}",
+    "README.md",
     "LICENSE",
     "!demo/**/*",
     "!**/*.test.js"
@@ -51,8 +51,6 @@
     "utility"
   ],
   "license": "MPL-2.0",
-  "main": "./dist/main.cjs",
-  "module": "./dist/main.mjs",
   "prettier": "@alwatr/prettier-config",
   "publishConfig": {
     "access": "public"
@@ -65,12 +63,12 @@
   "scripts": {
     "b": "bun run build",
     "build": "bun run build:ts && bun run build:es",
-    "build:es": "nano-build --preset=module",
+    "build:es": "nano-build --preset=module src/main.ts",
     "build:ts": "tsc --build",
     "c": "bun run clean",
     "cb": "bun run clean && bun run build",
     "clean": "rm -rfv dist *.tsbuildinfo",
-    "d": "bun run build:es && bun --enable-source-maps --trace-warnings",
+    "d": "bun run build:es && bun",
     "w": "bun run watch",
     "watch": "bun run watch:ts & bun run watch:es",
     "watch:es": "bun run build:es --watch",
@@ -79,5 +77,5 @@
   "sideEffects": false,
   "type": "module",
   "types": "./dist/main.d.ts",
-  "gitHead": "c3889e3756b0a0f9b935a1b702a1373ac52cb379"
+  "gitHead": "056102a1c8a563bbae8a290b6830450f467322a3"
 }

package/src/debounce.ts

@@ -0,0 +1,164 @@
+import type {DebouncerConfig} from './type.ts';
+
+/**
+ * A powerful and type-safe Debouncer class.
+ *
+ * It encapsulates the debouncing logic, state, and provides a rich control API.
+ * Debouncing delays function execution until after a specified delay has passed since the last invocation.
+ * Useful for optimizing performance in scenarios like search inputs, resize events, or API calls.
+ *
+ * @example
+ * ```typescript
+ * const debouncer = new Debouncer({
+ *   func: (text: string) => console.log('Searching:', text),
+ *   delay: 300,
+ *   leading: false,
+ *   trailing: true,
+ * });
+ *
+ * // Debounce search input
+ * debouncer.trigger('hello');
+ * debouncer.trigger('hello world'); // Only 'hello world' will log after 300ms
+ *
+ * // Advanced: With leading edge
+ * const leadingDebouncer = new Debouncer({
+ *   func: () => console.log('Immediate and delayed'),
+ *   delay: 500,
+ *   leading: true,
+ *   trailing: true,
+ * });
+ * leadingDebouncer.trigger(); // Logs immediately, then again after 500ms if not cancelled
+ * ```
+ */
+export class Debouncer<F extends AnyFunc> {
+  private timerId__?: number | NodeJS.Timeout;
+  private maxWaitTimerId__?: number | NodeJS.Timeout;
+  private lastArgs__?: Parameters<F>;
+
+  constructor(private readonly config__: DebouncerConfig<F>) {
+    this.config__.trailing ??= true;
+    this.flush = this.flush.bind(this);
+    this.trigger = this.trigger.bind(this);
+    this.cancel = this.cancel.bind(this);
+  }
+
+  /**
+   * Checks if there is a pending execution scheduled.
+   * Returns true if a timer is active, indicating a debounced call is waiting.
+   */
+  public get isPending(): boolean {
+    return this.timerId__ !== undefined;
+  }
+
+  /**
+   * Triggers the debounced function with the stored `thisContext`.
+   * @param args The arguments to pass to the `func`.
+   *
+   * @example
+   * ```typescript
+   * const debouncer = new Debouncer({
+   *   func: (value: number) => console.log('Value:', value),
+   *   delay: 500,
+   * });
+   * debouncer.trigger(42); // Logs after 500ms if not triggered again
+   *
+   * // Edge case: Rapid triggers only execute the last one
+   * debouncer.trigger(1);
+   * debouncer.trigger(2); // Only 2 will execute after delay
+   * ```
+   */
+  public trigger(...args: Parameters<F>): void {
+    this.lastArgs__ = args; // its an array even if triggered without any args
+    const firstTrigger = !this.isPending;
+
+    if (firstTrigger) {
+      if (this.config__.maxWait) {
+        this.maxWaitTimerId__ = setTimeout(this.flush, this.config__.maxWait);
+      }
+      if (this.config__.leading === true) {
+        this.invoke__();
+      }
+    }
+    else {
+      clearTimeout(this.timerId__!);
+    }
+
+    this.timerId__ = setTimeout(() => {
+      if (this.config__.trailing === true) {
+        this.invoke__();
+      }
+      this.cleanup__();
+    }, this.config__.delay);
+  }
+
+  /**
+   * Cancels any pending debounced execution and cleans up internal state.
+   * Useful for stopping execution when the operation is no longer needed (e.g., component unmount).
+   *
+   * @example
+   * ```typescript
+   * const debouncer = new Debouncer({
+   *   func: () => console.log('Executed'),
+   *   delay: 1000,
+   * });
+   * debouncer.trigger();
+   * debouncer.cancel(); // Prevents execution
+   *
+   * // Note: After cancel, isPending becomes false
+   * ```
+   */
+  public cancel(): void {
+    if (this.timerId__) {
+      clearTimeout(this.timerId__);
+    }
+    if (this.maxWaitTimerId__) {
+      clearTimeout(this.maxWaitTimerId__);
+    }
+    this.cleanup__();
+  }
+
+  /**
+   * Cleans up internal state by deleting timer and arguments.
+   */
+  private cleanup__(): void {
+    delete this.timerId__;
+    delete this.maxWaitTimerId__;
+    delete this.lastArgs__;
+  }
+
+  /**
+   * Immediately executes the pending function if one exists.
+   * Bypasses the delay and cleans up state. If no pending call, does nothing.
+   *
+   * @example
+   * ```typescript
+   * const debouncer = new Debouncer({
+   *   func: () => console.log('Flushed'),
+   *   delay: 1000,
+   * });
+   * debouncer.trigger();
+   * setTimeout(() => debouncer.flush(), 500); // Executes immediately
+   *
+   * // Edge case: Flush after cancel does nothing
+   * debouncer.cancel();
+   * debouncer.flush(); // No execution
+   * ```
+   */
+  public flush(): void {
+    if (this.isPending) {
+      this.invoke__();
+    }
+    this.cancel();
+  }
+
+  /**
+   * The core execution logic.
+   */
+  private invoke__(): void {
+    if (this.lastArgs__) {
+      // only call if we have new args (skip trailing call if leading already called)
+      this.config__.func.apply(this.config__.thisContext, this.lastArgs__);
+      this.lastArgs__ = undefined;
+    }
+  }
+}

package/src/main.ts

@@ -0,0 +1,37 @@
+import {Debouncer} from './debounce.js';
+
+import type {DebouncerConfig} from './type.js';
+
+export * from './debounce.js';
+export type * from './type.js';
+
+/**
+ * Factory function for creating a Debouncer instance for better type inference.
+ * @param config Configuration for the debouncer.
+ *
+ * @example
+ * ```typescript
+ * const debouncer = createDebouncer({
+ *   func: (text: string) => console.log('Searching:', text),
+ *   delay: 300,
+ *   leading: false,
+ *   trailing: true,
+ * });
+ *
+ * // Debounce search input
+ * debouncer.trigger('hello');
+ * debouncer.trigger('hello world'); // Only 'hello world' will log after 300ms
+ *
+ * // With custom thisContext
+ * const obj = { log: (msg: string) => console.log('Obj:', msg) };
+ * const debouncerWithContext = createDebouncer({
+ *   func: obj.log,
+ *   thisContext: obj,
+ *   delay: 200,
+ * });
+ * debouncerWithContext.trigger('test'); // Logs 'Obj: test'
+ * ```
+ */
+export function createDebouncer<F extends AnyFunc>(config: DebouncerConfig<F>): Debouncer<F> {
+  return new Debouncer(config);
+}

package/src/type.ts

@@ -0,0 +1,53 @@
+import type {} from '@alwatr/type-helper';
+
+/**
+ * A single configuration object for creating a Debouncer.
+ * This groups all settings for a cleaner API.
+ *
+ * Key notes:
+ * - `leading` and `trailing` control execution timing: leading executes immediately on first trigger, trailing after delay.
+ * - If both are true, execution happens on first trigger and last trigger (after delay).
+ * - `thisContext` ensures the `func` is bound to the correct `this` value, useful in class methods or event handlers.
+ * - `delay` must be a positive number.
+ */
+export interface DebouncerConfig<F extends AnyFunc> {
+  /**
+   * The function to be executed after the delay.
+   * Can be any function type, with type safety enforced by generics.
+   */
+  func: F;
+
+  /**
+   * The `this` context to be used when invoking the func.
+   * If provided, it will be stored and used for all invocations.
+   * Omit if the func doesn't rely on `this` or uses arrow functions.
+   */
+  thisContext?: ThisParameterType<F>;
+
+  /**
+   * The delay in milliseconds before the function is executed.
+   * Must be a positive integer; affects performance and responsiveness.
+   */
+  delay: number;
+
+  /**
+   * The maximum time the `func` is allowed to be delayed before it's invoked.
+   * This is useful for guaranteeing execution of a function that's continuously triggered.
+   * If set, the function will be called after `maxWait` milliseconds, even if triggers are still occurring.
+   */
+  maxWait?: number;
+
+  /**
+   * If `true`, the function is called on the leading edge of the timeout.
+   * Useful for immediate feedback (e.g., button press).
+   * @default false
+   */
+  leading?: boolean;
+
+  /**
+   * If `true`, the function is called on the trailing edge of the timeout.
+   * Ensures the last call is executed after inactivity.
+   * @default true
+   */
+  trailing?: boolean;
+}

package/CHANGELOG.md

@@ -1,165 +0,0 @@
-# Change Log
-
-All notable changes to this project will be documented in this file.
-See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
-
-## [1.1.20](https://github.com/Alwatr/nanolib/compare/@alwatr/debounce@1.1.19...@alwatr/debounce@1.1.20) (2026-03-16)
-
-### 🔨 Code Refactoring
-
-* migrate build scripts from yarn to bun across multiple packages ([d90e962](https://github.com/Alwatr/nanolib/commit/d90e962f15e5c951e191d5f02341279b6472abc3))
-
-### 🔗 Dependencies update
-
-* bump the npm-dependencies group with 10 updates ([c48d9ba](https://github.com/Alwatr/nanolib/commit/c48d9baa1cd7c2dc144b3e01e0fda60bf87c074c))
-
-## [1.1.19](https://github.com/Alwatr/nanolib/compare/@alwatr/debounce@1.1.18...@alwatr/debounce@1.1.19) (2026-02-18)
-
-### 🔗 Dependencies update
-
-* update @types/node to version 24.10.13 across multiple packages ([4c6d2a3](https://github.com/Alwatr/nanolib/commit/4c6d2a37ab26b1c86812b2aa38b2eca4ee097cb6))
-
-## [1.1.18](https://github.com/Alwatr/nanolib/compare/@alwatr/debounce@1.1.17...@alwatr/debounce@1.1.18) (2025-12-23)
-
-### 🔗 Dependencies update
-
-* upgrade @types/node to version 24.10.4 and update related dependencies ([acf04df](https://github.com/Alwatr/nanolib/commit/acf04df71647f5a401ef5e6bbfffcc478e4326d2))
-
-## [1.1.17](https://github.com/Alwatr/nanolib/compare/@alwatr/debounce@1.1.16...@alwatr/debounce@1.1.17) (2025-12-13)
-
-### 🐛 Bug Fixes
-
-* rename `AnyFunction` type alias to `AnyFunc` ([9865edc](https://github.com/Alwatr/nanolib/commit/9865edced9d377390454a8cbe7b6c5a6551195cb))
-
-## [1.1.16](https://github.com/Alwatr/nanolib/compare/@alwatr/debounce@1.1.15...@alwatr/debounce@1.1.16) (2025-12-13)
-
-### 🔗 Dependencies update
-
-* update `@types/node` and `[@lerna-lite](https://github.com/lerna-lite)` dependencies. ([8daa8fd](https://github.com/Alwatr/nanolib/commit/8daa8fd023d5414c9f95feb4319353c6ea34be31))
-
-## [1.1.15](https://github.com/Alwatr/nanolib/compare/@alwatr/debounce@1.1.14...@alwatr/debounce@1.1.15) (2025-12-10)
-
-### 🔗 Dependencies update
-
-* Upgrade lerna-lite, prettier, types/node, and yarn dependencies. ([42a7fca](https://github.com/Alwatr/nanolib/commit/42a7fca15430aca2ac1eaa19496c2a2ebfc8c470))
-
-## [1.1.14](https://github.com/Alwatr/nanolib/compare/@alwatr/debounce@1.1.13...@alwatr/debounce@1.1.14) (2025-11-18)
-
-### 🔨 Code Refactoring
-
-* remove unnecessary type declarations from tsconfig.json files ([89bcc7d](https://github.com/Alwatr/nanolib/commit/89bcc7db839807110b80f8ba34414ea9734d9c75))
-
-## [1.1.13](https://github.com/Alwatr/nanolib/compare/@alwatr/debounce@1.1.12...@alwatr/debounce@1.1.13) (2025-11-15)
-
-### 🔗 Dependencies update
-
-* bump the npm-dependencies group with 2 updates ([a80b84d](https://github.com/Alwatr/nanolib/commit/a80b84dada6c09b5e5621e7487c8ec13fff3c23a))
-
-## [1.1.12](https://github.com/Alwatr/nanolib/compare/@alwatr/debounce@1.1.11...@alwatr/debounce@1.1.12) (2025-11-15)
-
-**Note:** Version bump only for package @alwatr/debounce
-
-## [1.1.11](https://github.com/Alwatr/nanolib/compare/@alwatr/debounce@1.1.10...@alwatr/debounce@1.1.11) (2025-11-04)
-
-### 🔗 Dependencies update
-
-* bump the npm-dependencies group across 1 directory with 9 updates ([fdf29d5](https://github.com/Alwatr/nanolib/commit/fdf29d5aa89983cb06f79d42650a364521f5c4b9))
-* update @types/node from ^22.18.12 to ^24.10.0 across multiple packages ([1169a86](https://github.com/Alwatr/nanolib/commit/1169a86001da2abfbe99a7da33c8e92183f553f6))
-
-## [1.1.10](https://github.com/Alwatr/nanolib/compare/@alwatr/debounce@1.1.9...@alwatr/debounce@1.1.10) (2025-10-06)
-
-### 🔗 Dependencies update
-
-* bump the npm-dependencies group with 4 updates ([9825815](https://github.com/Alwatr/nanolib/commit/982581552bbb4b97dca52af5e93a80937f0c3109))
-
-## [1.1.9](https://github.com/Alwatr/nanolib/compare/@alwatr/debounce@1.1.8...@alwatr/debounce@1.1.9) (2025-09-27)
-
-### 🧹 Miscellaneous Chores
-
-* exclude test files from package distribution ([86f4f2f](https://github.com/Alwatr/nanolib/commit/86f4f2f5985845c5cf3a3a9398de7b2f98ce53e7))
-
-## [1.1.8](https://github.com/Alwatr/nanolib/compare/@alwatr/debounce@1.1.7...@alwatr/debounce@1.1.8) (2025-09-22)
-
-**Note:** Version bump only for package @alwatr/debounce
-
-## [1.1.7](https://github.com/Alwatr/nanolib/compare/@alwatr/debounce@1.1.6...@alwatr/debounce@1.1.7) (2025-09-22)
-
-**Note:** Version bump only for package @alwatr/debounce
-
-## [1.1.6](https://github.com/Alwatr/nanolib/compare/@alwatr/debounce@1.1.5...@alwatr/debounce@1.1.6) (2025-09-21)
-
-**Note:** Version bump only for package @alwatr/debounce
-
-## [1.1.5](https://github.com/Alwatr/nanolib/compare/@alwatr/debounce@1.1.4...@alwatr/debounce@1.1.5) (2025-09-20)
-
-### 🐛 Bug Fixes
-
-* add sideEffects property to package.json files for better tree-shaking ([c7b9e74](https://github.com/Alwatr/nanolib/commit/c7b9e74e1920c8e35b438742de61883ca62da58c))
-* add sideEffects property to package.json files for better tree-shaking ([e8402c4](https://github.com/Alwatr/nanolib/commit/e8402c481a14a1f807a37aaa862a936713d26176))
-
-### 🧹 Miscellaneous Chores
-
-* remove duplicate sideEffects property from multiple package.json files ([b123f86](https://github.com/Alwatr/nanolib/commit/b123f86be81481de2314aae9bb2eeb629743d24c))
-
-## [1.1.4](https://github.com/Alwatr/nanolib/compare/@alwatr/debounce@1.1.3...@alwatr/debounce@1.1.4) (2025-09-20)
-
-### 🐛 Bug Fixes
-
-* bind flush method in Debouncer constructor for proper context handling ([bdbeaed](https://github.com/Alwatr/nanolib/commit/bdbeaeddb2492da65476c374e9707e335cc39726))
-
-## [1.1.3](https://github.com/Alwatr/nanolib/compare/@alwatr/debounce@1.1.2...@alwatr/debounce@1.1.3) (2025-09-19)
-
-**Note:** Version bump only for package @alwatr/debounce
-
-## [1.1.2](https://github.com/Alwatr/nanolib/compare/@alwatr/debounce@1.1.1...@alwatr/debounce@1.1.2) (2025-09-15)
-
-**Note:** Version bump only for package @alwatr/debounce
-
-## [1.1.1](https://github.com/Alwatr/nanolib/compare/@alwatr/debounce@1.1.0...@alwatr/debounce@1.1.1) (2025-09-15)
-
-### 🐛 Bug Fixes
-
-* bind flush method correctly in Debouncer and improve readability of invoke logic ([5ddb12c](https://github.com/Alwatr/nanolib/commit/5ddb12c7d5d6040edad0f37ae79b3f725481d1f7))
-
-## [1.1.0](https://github.com/Alwatr/nanolib/compare/@alwatr/debounce@1.0.1...@alwatr/debounce@1.1.0) (2025-09-14)
-
-### ✨ Features
-
-* add maxWait option to Debouncer for guaranteed execution ([a305a6e](https://github.com/Alwatr/nanolib/commit/a305a6e82f96feebe2e895cdd35676da0f8b79f6))
-
-### 🐛 Bug Fixes
-
-* bind flush method in constructor for correct context ([671315c](https://github.com/Alwatr/nanolib/commit/671315cdadab448df660ae53c973eb71d4124699))
-
-### 🔨 Code Refactoring
-
-* add missing type import for DebouncerConfig ([d0c5808](https://github.com/Alwatr/nanolib/commit/d0c5808f2b6eb6fe856f8a38f5a79d2c427cf928))
-* improve trigger logic and clean up documentation comments ([cce9162](https://github.com/Alwatr/nanolib/commit/cce9162f2ee1c1fa2978ba04cd1be2eac5302b9e))
-* simplify trailing call logic and ensure lastArgs are cleared after invocation ([e8f74da](https://github.com/Alwatr/nanolib/commit/e8f74da9660c0c44d2704eb863bb082bce9a5978))
-* streamline invoke logic and restore createDebouncer function ([9bdc412](https://github.com/Alwatr/nanolib/commit/9bdc4124cdea3b267c040ec770a002ed64a814ac))
-
-## [1.0.1](https://github.com/Alwatr/nanolib/compare/@alwatr/debounce@1.0.0...@alwatr/debounce@1.0.1) (2025-09-14)
-
-### 🔨 Code Refactoring
-
-* **debounce:** rename 'callback' to 'func' for consistency in API ([df7ede1](https://github.com/Alwatr/nanolib/commit/df7ede1a78109831cca22389bd2d69df2e0ae366))
-
-## [1.0.0](https://github.com/Alwatr/nanolib/compare/@alwatr/debounce@1.0.0-rc.0...@alwatr/debounce@1.0.0) (2025-09-14)
-
-### 🔨 Code Refactoring
-
-* **package:** update keywords in package.json for debounce, local-storage, and synapse packages ([09c9cca](https://github.com/Alwatr/nanolib/commit/09c9cca3cd600e9ffaf600fb1926c0ee884a1aa8))
-
-## 1.0.0-rc.0 (2025-09-13)
-
-### ✨ Features
-
-* add debounce package with initial implementation and configuration files ([6293660](https://github.com/Alwatr/nanolib/commit/62936605c246c825f15178b68ac22ee474b95cf5))
-
-### 🔨 Code Refactoring
-
-* update Debouncer class and configuration interface for improved type safety and clarity ([f064a98](https://github.com/Alwatr/nanolib/commit/f064a98dfce1a7e997badac3002f02a16dffc57e))
-
-### 🔗 Dependencies update
-
-* update @types/node version to ^22.18.3 in multiple package.json files ([13db6fc](https://github.com/Alwatr/nanolib/commit/13db6fc176bc6cdcefedc50d77ac550bd5052c9a))

package/dist/main.cjs

@@ -1,3 +0,0 @@
-/** 📦 @alwatr/debounce v1.1.20 */
-"use strict";var __defProp=Object.defineProperty;var __getOwnPropDesc=Object.getOwnPropertyDescriptor;var __getOwnPropNames=Object.getOwnPropertyNames;var __hasOwnProp=Object.prototype.hasOwnProperty;var __export=(target,all)=>{for(var name in all)__defProp(target,name,{get:all[name],enumerable:true})};var __copyProps=(to,from,except,desc)=>{if(from&&typeof from==="object"||typeof from==="function"){for(let key of __getOwnPropNames(from))if(!__hasOwnProp.call(to,key)&&key!==except)__defProp(to,key,{get:()=>from[key],enumerable:!(desc=__getOwnPropDesc(from,key))||desc.enumerable})}return to};var __toCommonJS=mod=>__copyProps(__defProp({},"__esModule",{value:true}),mod);var main_exports={};__export(main_exports,{Debouncer:()=>Debouncer,createDebouncer:()=>createDebouncer});module.exports=__toCommonJS(main_exports);var Debouncer=class{constructor(config__){this.config__=config__;this.config__.trailing??=true;this.flush=this.flush.bind(this)}get isPending(){return this.timerId__!==void 0}trigger(...args){this.lastArgs__=args;const firstTrigger=!this.isPending;if(firstTrigger){if(this.config__.maxWait){this.maxWaitTimerId__=setTimeout(this.flush,this.config__.maxWait)}if(this.config__.leading===true){this.invoke__()}}else{clearTimeout(this.timerId__)}this.timerId__=setTimeout(()=>{if(this.config__.trailing===true){this.invoke__()}this.cleanup__()},this.config__.delay)}cancel(){if(this.timerId__){clearTimeout(this.timerId__)}if(this.maxWaitTimerId__){clearTimeout(this.maxWaitTimerId__)}this.cleanup__()}cleanup__(){delete this.timerId__;delete this.maxWaitTimerId__;delete this.lastArgs__}flush(){if(this.isPending){this.invoke__()}this.cancel()}invoke__(){if(this.lastArgs__){this.config__.func.apply(this.config__.thisContext,this.lastArgs__);this.lastArgs__=void 0}}};function createDebouncer(config){return new Debouncer(config)}0&&(module.exports={Debouncer,createDebouncer});
-//# sourceMappingURL=main.cjs.map

package/dist/main.cjs.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../src/main.ts", "../src/debounce.ts"],
-  "sourcesContent": ["import {Debouncer} from './debounce.js';\n\nimport type {DebouncerConfig} from './type.js';\n\nexport * from './debounce.js';\nexport type * from './type.js';\n\n/**\n * Factory function for creating a Debouncer instance for better type inference.\n * @param config Configuration for the debouncer.\n *\n * @example\n * ```typescript\n * const debouncer = createDebouncer({\n *   func: (text: string) => console.log('Searching:', text),\n *   delay: 300,\n *   leading: false,\n *   trailing: true,\n * });\n *\n * // Debounce search input\n * debouncer.trigger('hello');\n * debouncer.trigger('hello world'); // Only 'hello world' will log after 300ms\n *\n * // With custom thisContext\n * const obj = { log: (msg: string) => console.log('Obj:', msg) };\n * const debouncerWithContext = createDebouncer({\n *   func: obj.log,\n *   thisContext: obj,\n *   delay: 200,\n * });\n * debouncerWithContext.trigger('test'); // Logs 'Obj: test'\n * ```\n */\nexport function createDebouncer<F extends AnyFunc>(config: DebouncerConfig<F>): Debouncer<F> {\n  return new Debouncer(config);\n}\n", "import type {DebouncerConfig} from './type.ts';\n\n/**\n * A powerful and type-safe Debouncer class.\n *\n * It encapsulates the debouncing logic, state, and provides a rich control API.\n * Debouncing delays function execution until after a specified delay has passed since the last invocation.\n * Useful for optimizing performance in scenarios like search inputs, resize events, or API calls.\n *\n * @example\n * ```typescript\n * const debouncer = new Debouncer({\n *   func: (text: string) => console.log('Searching:', text),\n *   delay: 300,\n *   leading: false,\n *   trailing: true,\n * });\n *\n * // Debounce search input\n * debouncer.trigger('hello');\n * debouncer.trigger('hello world'); // Only 'hello world' will log after 300ms\n *\n * // Advanced: With leading edge\n * const leadingDebouncer = new Debouncer({\n *   func: () => console.log('Immediate and delayed'),\n *   delay: 500,\n *   leading: true,\n *   trailing: true,\n * });\n * leadingDebouncer.trigger(); // Logs immediately, then again after 500ms if not cancelled\n * ```\n */\nexport class Debouncer<F extends AnyFunc> {\n  private timerId__?: number | NodeJS.Timeout;\n  private maxWaitTimerId__?: number | NodeJS.Timeout;\n  private lastArgs__?: Parameters<F>;\n\n  constructor(private readonly config__: DebouncerConfig<F>) {\n    this.config__.trailing ??= true;\n    this.flush = this.flush.bind(this);\n  }\n\n  /**\n   * Checks if there is a pending execution scheduled.\n   * Returns true if a timer is active, indicating a debounced call is waiting.\n   */\n  public get isPending(): boolean {\n    return this.timerId__ !== undefined;\n  }\n\n  /**\n   * Triggers the debounced function with the stored `thisContext`.\n   * @param args The arguments to pass to the `func`.\n   *\n   * @example\n   * ```typescript\n   * const debouncer = new Debouncer({\n   *   func: (value: number) => console.log('Value:', value),\n   *   delay: 500,\n   * });\n   * debouncer.trigger(42); // Logs after 500ms if not triggered again\n   *\n   * // Edge case: Rapid triggers only execute the last one\n   * debouncer.trigger(1);\n   * debouncer.trigger(2); // Only 2 will execute after delay\n   * ```\n   */\n  public trigger(...args: Parameters<F>): void {\n    this.lastArgs__ = args; // its an array even if triggered without any args\n    const firstTrigger = !this.isPending;\n\n    if (firstTrigger) {\n      if (this.config__.maxWait) {\n        this.maxWaitTimerId__ = setTimeout(this.flush, this.config__.maxWait);\n      }\n      if (this.config__.leading === true) {\n        this.invoke__();\n      }\n    }\n    else {\n      clearTimeout(this.timerId__!);\n    }\n\n    this.timerId__ = setTimeout(() => {\n      if (this.config__.trailing === true) {\n        this.invoke__();\n      }\n      this.cleanup__();\n    }, this.config__.delay);\n  }\n\n  /**\n   * Cancels any pending debounced execution and cleans up internal state.\n   * Useful for stopping execution when the operation is no longer needed (e.g., component unmount).\n   *\n   * @example\n   * ```typescript\n   * const debouncer = new Debouncer({\n   *   func: () => console.log('Executed'),\n   *   delay: 1000,\n   * });\n   * debouncer.trigger();\n   * debouncer.cancel(); // Prevents execution\n   *\n   * // Note: After cancel, isPending becomes false\n   * ```\n   */\n  public cancel(): void {\n    if (this.timerId__) {\n      clearTimeout(this.timerId__);\n    }\n    if (this.maxWaitTimerId__) {\n      clearTimeout(this.maxWaitTimerId__);\n    }\n    this.cleanup__();\n  }\n\n  /**\n   * Cleans up internal state by deleting timer and arguments.\n   */\n  private cleanup__(): void {\n    delete this.timerId__;\n    delete this.maxWaitTimerId__;\n    delete this.lastArgs__;\n  }\n\n  /**\n   * Immediately executes the pending function if one exists.\n   * Bypasses the delay and cleans up state. If no pending call, does nothing.\n   *\n   * @example\n   * ```typescript\n   * const debouncer = new Debouncer({\n   *   func: () => console.log('Flushed'),\n   *   delay: 1000,\n   * });\n   * debouncer.trigger();\n   * setTimeout(() => debouncer.flush(), 500); // Executes immediately\n   *\n   * // Edge case: Flush after cancel does nothing\n   * debouncer.cancel();\n   * debouncer.flush(); // No execution\n   * ```\n   */\n  public flush(): void {\n    if (this.isPending) {\n      this.invoke__();\n    }\n    this.cancel();\n  }\n\n  /**\n   * The core execution logic.\n   */\n  private invoke__(): void {\n    if (this.lastArgs__) {\n      // only call if we have new args (skip trailing call if leading already called)\n      this.config__.func.apply(this.config__.thisContext, this.lastArgs__);\n      this.lastArgs__ = undefined;\n    }\n  }\n}\n"],
-  "mappings": ";qqBAAA,mJCgCO,IAAM,UAAN,KAAmC,CAKxC,YAA6B,SAA8B,CAA9B,uBAC3B,KAAK,SAAS,WAAa,KAC3B,KAAK,MAAQ,KAAK,MAAM,KAAK,IAAI,CACnC,CAMA,IAAW,WAAqB,CAC9B,OAAO,KAAK,YAAc,MAC5B,CAmBO,WAAW,KAA2B,CAC3C,KAAK,WAAa,KAClB,MAAM,aAAe,CAAC,KAAK,UAE3B,GAAI,aAAc,CAChB,GAAI,KAAK,SAAS,QAAS,CACzB,KAAK,iBAAmB,WAAW,KAAK,MAAO,KAAK,SAAS,OAAO,CACtE,CACA,GAAI,KAAK,SAAS,UAAY,KAAM,CAClC,KAAK,SAAS,CAChB,CACF,KACK,CACH,aAAa,KAAK,SAAU,CAC9B,CAEA,KAAK,UAAY,WAAW,IAAM,CAChC,GAAI,KAAK,SAAS,WAAa,KAAM,CACnC,KAAK,SAAS,CAChB,CACA,KAAK,UAAU,CACjB,EAAG,KAAK,SAAS,KAAK,CACxB,CAkBO,QAAe,CACpB,GAAI,KAAK,UAAW,CAClB,aAAa,KAAK,SAAS,CAC7B,CACA,GAAI,KAAK,iBAAkB,CACzB,aAAa,KAAK,gBAAgB,CACpC,CACA,KAAK,UAAU,CACjB,CAKQ,WAAkB,CACxB,OAAO,KAAK,UACZ,OAAO,KAAK,iBACZ,OAAO,KAAK,UACd,CAoBO,OAAc,CACnB,GAAI,KAAK,UAAW,CAClB,KAAK,SAAS,CAChB,CACA,KAAK,OAAO,CACd,CAKQ,UAAiB,CACvB,GAAI,KAAK,WAAY,CAEnB,KAAK,SAAS,KAAK,MAAM,KAAK,SAAS,YAAa,KAAK,UAAU,EACnE,KAAK,WAAa,MACpB,CACF,CACF,ED/HO,SAAS,gBAAmC,OAA0C,CAC3F,OAAO,IAAI,UAAU,MAAM,CAC7B",
-  "names": []
-}

package/dist/main.mjs

@@ -1,3 +0,0 @@
-/** 📦 @alwatr/debounce v1.1.20 */
-var Debouncer=class{constructor(config__){this.config__=config__;this.config__.trailing??=true;this.flush=this.flush.bind(this)}get isPending(){return this.timerId__!==void 0}trigger(...args){this.lastArgs__=args;const firstTrigger=!this.isPending;if(firstTrigger){if(this.config__.maxWait){this.maxWaitTimerId__=setTimeout(this.flush,this.config__.maxWait)}if(this.config__.leading===true){this.invoke__()}}else{clearTimeout(this.timerId__)}this.timerId__=setTimeout(()=>{if(this.config__.trailing===true){this.invoke__()}this.cleanup__()},this.config__.delay)}cancel(){if(this.timerId__){clearTimeout(this.timerId__)}if(this.maxWaitTimerId__){clearTimeout(this.maxWaitTimerId__)}this.cleanup__()}cleanup__(){delete this.timerId__;delete this.maxWaitTimerId__;delete this.lastArgs__}flush(){if(this.isPending){this.invoke__()}this.cancel()}invoke__(){if(this.lastArgs__){this.config__.func.apply(this.config__.thisContext,this.lastArgs__);this.lastArgs__=void 0}}};function createDebouncer(config){return new Debouncer(config)}export{Debouncer,createDebouncer};
-//# sourceMappingURL=main.mjs.map

package/dist/main.mjs.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../src/debounce.ts", "../src/main.ts"],
-  "sourcesContent": ["import type {DebouncerConfig} from './type.ts';\n\n/**\n * A powerful and type-safe Debouncer class.\n *\n * It encapsulates the debouncing logic, state, and provides a rich control API.\n * Debouncing delays function execution until after a specified delay has passed since the last invocation.\n * Useful for optimizing performance in scenarios like search inputs, resize events, or API calls.\n *\n * @example\n * ```typescript\n * const debouncer = new Debouncer({\n *   func: (text: string) => console.log('Searching:', text),\n *   delay: 300,\n *   leading: false,\n *   trailing: true,\n * });\n *\n * // Debounce search input\n * debouncer.trigger('hello');\n * debouncer.trigger('hello world'); // Only 'hello world' will log after 300ms\n *\n * // Advanced: With leading edge\n * const leadingDebouncer = new Debouncer({\n *   func: () => console.log('Immediate and delayed'),\n *   delay: 500,\n *   leading: true,\n *   trailing: true,\n * });\n * leadingDebouncer.trigger(); // Logs immediately, then again after 500ms if not cancelled\n * ```\n */\nexport class Debouncer<F extends AnyFunc> {\n  private timerId__?: number | NodeJS.Timeout;\n  private maxWaitTimerId__?: number | NodeJS.Timeout;\n  private lastArgs__?: Parameters<F>;\n\n  constructor(private readonly config__: DebouncerConfig<F>) {\n    this.config__.trailing ??= true;\n    this.flush = this.flush.bind(this);\n  }\n\n  /**\n   * Checks if there is a pending execution scheduled.\n   * Returns true if a timer is active, indicating a debounced call is waiting.\n   */\n  public get isPending(): boolean {\n    return this.timerId__ !== undefined;\n  }\n\n  /**\n   * Triggers the debounced function with the stored `thisContext`.\n   * @param args The arguments to pass to the `func`.\n   *\n   * @example\n   * ```typescript\n   * const debouncer = new Debouncer({\n   *   func: (value: number) => console.log('Value:', value),\n   *   delay: 500,\n   * });\n   * debouncer.trigger(42); // Logs after 500ms if not triggered again\n   *\n   * // Edge case: Rapid triggers only execute the last one\n   * debouncer.trigger(1);\n   * debouncer.trigger(2); // Only 2 will execute after delay\n   * ```\n   */\n  public trigger(...args: Parameters<F>): void {\n    this.lastArgs__ = args; // its an array even if triggered without any args\n    const firstTrigger = !this.isPending;\n\n    if (firstTrigger) {\n      if (this.config__.maxWait) {\n        this.maxWaitTimerId__ = setTimeout(this.flush, this.config__.maxWait);\n      }\n      if (this.config__.leading === true) {\n        this.invoke__();\n      }\n    }\n    else {\n      clearTimeout(this.timerId__!);\n    }\n\n    this.timerId__ = setTimeout(() => {\n      if (this.config__.trailing === true) {\n        this.invoke__();\n      }\n      this.cleanup__();\n    }, this.config__.delay);\n  }\n\n  /**\n   * Cancels any pending debounced execution and cleans up internal state.\n   * Useful for stopping execution when the operation is no longer needed (e.g., component unmount).\n   *\n   * @example\n   * ```typescript\n   * const debouncer = new Debouncer({\n   *   func: () => console.log('Executed'),\n   *   delay: 1000,\n   * });\n   * debouncer.trigger();\n   * debouncer.cancel(); // Prevents execution\n   *\n   * // Note: After cancel, isPending becomes false\n   * ```\n   */\n  public cancel(): void {\n    if (this.timerId__) {\n      clearTimeout(this.timerId__);\n    }\n    if (this.maxWaitTimerId__) {\n      clearTimeout(this.maxWaitTimerId__);\n    }\n    this.cleanup__();\n  }\n\n  /**\n   * Cleans up internal state by deleting timer and arguments.\n   */\n  private cleanup__(): void {\n    delete this.timerId__;\n    delete this.maxWaitTimerId__;\n    delete this.lastArgs__;\n  }\n\n  /**\n   * Immediately executes the pending function if one exists.\n   * Bypasses the delay and cleans up state. If no pending call, does nothing.\n   *\n   * @example\n   * ```typescript\n   * const debouncer = new Debouncer({\n   *   func: () => console.log('Flushed'),\n   *   delay: 1000,\n   * });\n   * debouncer.trigger();\n   * setTimeout(() => debouncer.flush(), 500); // Executes immediately\n   *\n   * // Edge case: Flush after cancel does nothing\n   * debouncer.cancel();\n   * debouncer.flush(); // No execution\n   * ```\n   */\n  public flush(): void {\n    if (this.isPending) {\n      this.invoke__();\n    }\n    this.cancel();\n  }\n\n  /**\n   * The core execution logic.\n   */\n  private invoke__(): void {\n    if (this.lastArgs__) {\n      // only call if we have new args (skip trailing call if leading already called)\n      this.config__.func.apply(this.config__.thisContext, this.lastArgs__);\n      this.lastArgs__ = undefined;\n    }\n  }\n}\n", "import {Debouncer} from './debounce.js';\n\nimport type {DebouncerConfig} from './type.js';\n\nexport * from './debounce.js';\nexport type * from './type.js';\n\n/**\n * Factory function for creating a Debouncer instance for better type inference.\n * @param config Configuration for the debouncer.\n *\n * @example\n * ```typescript\n * const debouncer = createDebouncer({\n *   func: (text: string) => console.log('Searching:', text),\n *   delay: 300,\n *   leading: false,\n *   trailing: true,\n * });\n *\n * // Debounce search input\n * debouncer.trigger('hello');\n * debouncer.trigger('hello world'); // Only 'hello world' will log after 300ms\n *\n * // With custom thisContext\n * const obj = { log: (msg: string) => console.log('Obj:', msg) };\n * const debouncerWithContext = createDebouncer({\n *   func: obj.log,\n *   thisContext: obj,\n *   delay: 200,\n * });\n * debouncerWithContext.trigger('test'); // Logs 'Obj: test'\n * ```\n */\nexport function createDebouncer<F extends AnyFunc>(config: DebouncerConfig<F>): Debouncer<F> {\n  return new Debouncer(config);\n}\n"],
-  "mappings": ";AAgCO,IAAM,UAAN,KAAmC,CAKxC,YAA6B,SAA8B,CAA9B,uBAC3B,KAAK,SAAS,WAAa,KAC3B,KAAK,MAAQ,KAAK,MAAM,KAAK,IAAI,CACnC,CAMA,IAAW,WAAqB,CAC9B,OAAO,KAAK,YAAc,MAC5B,CAmBO,WAAW,KAA2B,CAC3C,KAAK,WAAa,KAClB,MAAM,aAAe,CAAC,KAAK,UAE3B,GAAI,aAAc,CAChB,GAAI,KAAK,SAAS,QAAS,CACzB,KAAK,iBAAmB,WAAW,KAAK,MAAO,KAAK,SAAS,OAAO,CACtE,CACA,GAAI,KAAK,SAAS,UAAY,KAAM,CAClC,KAAK,SAAS,CAChB,CACF,KACK,CACH,aAAa,KAAK,SAAU,CAC9B,CAEA,KAAK,UAAY,WAAW,IAAM,CAChC,GAAI,KAAK,SAAS,WAAa,KAAM,CACnC,KAAK,SAAS,CAChB,CACA,KAAK,UAAU,CACjB,EAAG,KAAK,SAAS,KAAK,CACxB,CAkBO,QAAe,CACpB,GAAI,KAAK,UAAW,CAClB,aAAa,KAAK,SAAS,CAC7B,CACA,GAAI,KAAK,iBAAkB,CACzB,aAAa,KAAK,gBAAgB,CACpC,CACA,KAAK,UAAU,CACjB,CAKQ,WAAkB,CACxB,OAAO,KAAK,UACZ,OAAO,KAAK,iBACZ,OAAO,KAAK,UACd,CAoBO,OAAc,CACnB,GAAI,KAAK,UAAW,CAClB,KAAK,SAAS,CAChB,CACA,KAAK,OAAO,CACd,CAKQ,UAAiB,CACvB,GAAI,KAAK,WAAY,CAEnB,KAAK,SAAS,KAAK,MAAM,KAAK,SAAS,YAAa,KAAK,UAAU,EACnE,KAAK,WAAa,MACpB,CACF,CACF,EC/HO,SAAS,gBAAmC,OAA0C,CAC3F,OAAO,IAAI,UAAU,MAAM,CAC7B",
-  "names": []
-}