@x-oasis/batchinate-last 0.1.36 → 0.1.38

package/.turbo/turbo-build.log

@@ -1,21 +1,15 @@
 
-> @x-oasis/batchinate-last@0.1.36 build /home/runner/work/x-oasis/x-oasis/packages/schedule/batchinate-last
+> @x-oasis/batchinate-last@0.1.38 build /home/runner/work/x-oasis/x-oasis/packages/schedule/batchinate-last
 > tsdx build --tsconfig tsconfig.build.json
 
 @rollup/plugin-replace: 'preventAssignment' currently defaults to false. It is recommended to set this option to `true`, as the next major version will default this option to `true`.
 @rollup/plugin-replace: 'preventAssignment' currently defaults to false. It is recommended to set this option to `true`, as the next major version will default this option to `true`.
 ⠙ Creating entry file
-⠙ Building modules
-✓ Creating entry file 4.7 secs
-⠹ Building modules
+✓ Creating entry file 2.4 secs
+⠙ Building modules
+⠹ Building modules
 ⠸ Building modules
-⠼ Building modules
-⠴ Building modules
-⠦ Building modules
-⠧ Building modules
-⠇ Building modules
 [tsdx]: Your rootDir is currently set to "./". Please change your rootDir to "./src".
 TSDX has deprecated setting tsconfig.compilerOptions.rootDir to "./" as it caused buggy output for declarationMaps and more.
 You may also need to change your include to remove "test", which also caused declarations to be unnecessarily created for test files.
-⠏ Building modules
-✓ Building modules 9.8 secs
+✓ Building modules 4 secs

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # @x-oasis/batchinate-last
 
+## 0.1.38
+
+### Patch Changes
+
+- f1aae14: bump version
+- Updated dependencies [f1aae14]
+  - @x-oasis/debounce@0.1.38
+
+## 0.1.37
+
+### Patch Changes
+
+- 8cb524c: trigger next
+
 ## 0.1.36
 
 ### Patch Changes

package/README.md

@@ -1,19 +1,284 @@
 # @x-oasis/batchinate-last
 
+Executes the callback with the last arguments after a delay. If `schedule` is called multiple times within the delay period, only the last call's arguments will be used when the callback executes.
+
+This is useful for scenarios where you want to batch multiple rapid calls and only process the final state.
+
 ## Installation
 
 ```bash
-$ npm i @x-oasis/batchinate-last
+npm install @x-oasis/batchinate-last
+# or
+pnpm add @x-oasis/batchinate-last
+# or
+yarn add @x-oasis/batchinate-last
 ```
 
-## How to use
+## Usage
+
+### Basic Usage
 
 ```typescript
-import Batchinator from '@x-oasis/batchinate-last'
+import BatchinateLast from '@x-oasis/batchinate-last';
+
+const callback = (message: string) => {
+  console.log(message);
+};
+
+const batchinator = new BatchinateLast(callback, 100);
+
+// Schedule multiple calls
+batchinator.schedule('First');
+batchinator.schedule('Second');
+batchinator.schedule('Third');
+
+// Only 'Third' will execute after 100ms
 ```
 
-## How to run test
+### Flush Scheduled Task
 
-```bash
-$ pnpm test
-```
+Immediately execute the scheduled task:
+
+```typescript
+import BatchinateLast from '@x-oasis/batchinate-last';
+
+const batchinator = new BatchinateLast(callback, 100);
+
+batchinator.schedule('First');
+batchinator.schedule('Second');
+batchinator.flush();  // Executes immediately with 'Second'
+
+// Or flush with new arguments
+batchinator.flush('Custom');
+```
+
+### Dispose
+
+Cancel the scheduled task and optionally execute it:
+
+```typescript
+import BatchinateLast from '@x-oasis/batchinate-last';
+
+const batchinator = new BatchinateLast(callback, 100);
+
+batchinator.schedule('First');
+batchinator.schedule('Second');
+
+// Dispose and execute
+batchinator.dispose();  // Executes with 'Second'
+
+// Dispose without executing
+batchinator.dispose({ abort: true });  // Cancels without executing
+```
+
+### Check Schedule Status
+
+Check if a task is currently scheduled:
+
+```typescript
+import BatchinateLast from '@x-oasis/batchinate-last';
+
+const batchinator = new BatchinateLast(callback, 100);
+
+batchinator.schedule('First');
+console.log(batchinator.inSchedule());  // true
+
+// After execution or cancel
+batchinator.flush();
+console.log(batchinator.inSchedule());  // false
+```
+
+### Continuous Scheduling
+
+If new calls are made during execution, the handler will automatically reschedule:
+
+```typescript
+import BatchinateLast from '@x-oasis/batchinate-last';
+
+const batchinator = new BatchinateLast(callback, 100);
+
+batchinator.schedule('First');
+// ... 50ms later
+batchinator.schedule('Second');
+// ... 50ms later (during execution)
+batchinator.schedule('Third');
+// Handler will reschedule to execute 'Third'
+```
+
+## API
+
+### `new BatchinateLast(callback, delayMS)`
+
+Creates a new BatchinateLast instance.
+
+#### Parameters
+
+- `callback` (`Function`): The function to execute with the last arguments.
+- `delayMS` (`number`): The delay in milliseconds before executing the callback.
+
+#### Returns
+
+Returns a new `BatchinateLast` instance.
+
+### Instance Methods
+
+#### `schedule(...args)`
+
+Schedule the callback to execute after `delayMS`. If called multiple times, only the last call's arguments will be used.
+
+- `args` (`...any[]`): Arguments to pass to the callback.
+
+#### `flush(...args)`
+
+Immediately execute the scheduled task. If arguments are provided, they will be used instead of stored arguments.
+
+- `args` (`...any[]`, optional): Optional arguments to use instead of stored args.
+
+#### `dispose(options?)`
+
+Dispose the scheduled task. By default, executes the callback with stored arguments unless `abort` is `true`.
+
+- `options` (`Object`, optional): Configuration options.
+  - `abort` (`boolean`, default: `false`): If `true`, cancel without executing callback.
+
+#### `inSchedule()`
+
+Check if a task is currently scheduled.
+
+- Returns: `boolean` - `true` if a task is scheduled, `false` otherwise.
+
+## Examples
+
+### Search Input
+
+```typescript
+import BatchinateLast from '@x-oasis/batchinate-last';
+
+const performSearch = (query: string) => {
+  // Perform search with query
+  console.log('Searching for:', query);
+};
+
+const batchinator = new BatchinateLast(performSearch, 300);
+
+// User types in search box
+input.addEventListener('input', (e) => {
+  batchinator.schedule(e.target.value);
+});
+
+// Only the final query executes after user stops typing
+```
+
+### Window Resize Handler
+
+```typescript
+import BatchinateLast from '@x-oasis/batchinate-last';
+
+const handleResize = (width: number, height: number) => {
+  // Recalculate layout
+  console.log('Resized to:', width, height);
+};
+
+const batchinator = new BatchinateLast(handleResize, 200);
+
+window.addEventListener('resize', () => {
+  batchinator.schedule(window.innerWidth, window.innerHeight);
+});
+
+// Only the final dimensions are processed
+```
+
+### Form Auto-save
+
+```typescript
+import BatchinateLast from '@x-oasis/batchinate-last';
+
+const saveForm = (formData: any) => {
+  // Save form data
+  console.log('Saving form:', formData);
+};
+
+const batchinator = new BatchinateLast(saveForm, 1000);
+
+form.addEventListener('input', () => {
+  const formData = new FormData(form);
+  batchinator.schedule(Object.fromEntries(formData));
+});
+
+// Form saves 1 second after user stops editing
+```
+
+### Scroll Position Tracking
+
+```typescript
+import BatchinateLast from '@x-oasis/batchinate-last';
+
+const updateScrollPosition = (x: number, y: number) => {
+  // Update scroll position in state
+  console.log('Scroll position:', x, y);
+};
+
+const batchinator = new BatchinateLast(updateScrollPosition, 100);
+
+window.addEventListener('scroll', () => {
+  batchinator.schedule(window.scrollX, window.scrollY);
+});
+
+// Only the final scroll position is tracked
+```
+
+### Cleanup on Component Unmount
+
+```typescript
+import BatchinateLast from '@x-oasis/batchinate-last';
+import { useEffect } from 'react';
+
+function MyComponent() {
+  const batchinator = new BatchinateLast(handleUpdate, 100);
+
+  useEffect(() => {
+    // Use batchinator
+    batchinator.schedule(data);
+
+    // Cleanup on unmount
+    return () => {
+      batchinator.dispose({ abort: true });
+    };
+  }, []);
+}
+```
+
+## Differences from Other Utilities
+
+### vs Debounce
+
+- **BatchinateLast**: Always uses the last arguments, executes after a fixed delay.
+- **Debounce**: Resets the delay timer on each call, executes only after a period of inactivity.
+
+### vs Throttle
+
+- **BatchinateLast**: Executes once with the last arguments after the delay.
+- **Throttle**: Executes at most once per period, regardless of call frequency.
+
+### vs Batchinator
+
+- **BatchinateLast**: Simpler, always executes with last arguments after delay.
+- **Batchinator**: More configurable, supports leading/trailing execution options.
+
+## When to Use BatchinateLast
+
+- Search input debouncing
+- Window resize handlers
+- Form auto-save
+- Scroll position tracking
+- Any scenario where you want to batch rapid calls and only process the final state
+
+## See Also
+
+- [@x-oasis/batchinator](../batchinator/README.md) - Batches with leading/trailing options
+- [@x-oasis/debounce](../debounce/README.md) - Creates a debounced function
+- [@x-oasis/throttle](../throttle/README.md) - Creates a throttled function
+
+## License
+
+ISC

package/dist/batchinate-last.cjs.development.js

@@ -2,13 +2,50 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
+function _interopDefault (ex) { return (ex && (typeof ex === 'object') && 'default' in ex) ? ex['default'] : ex; }
+
+var debounce = _interopDefault(require('@x-oasis/debounce'));
+
 var BatchinateLast = /*#__PURE__*/function () {
   function BatchinateLast(cb, delayMS) {
+    var _this = this;
+    this._storedArgs = null;
+    this._isScheduled = false;
+    this._clockTime = 0;
+    this._lastTime = 0;
+    this._rescheduleHandler = null;
     this._callback = cb;
     this._delayMS = delayMS;
-    this._taskHandler = null;
-    this._args = null;
-    this.handler = this.handler.bind(this);
+    var executeAndReschedule = function executeAndReschedule() {
+      var savedClockTime = _this._clockTime;
+      _this._isScheduled = false;
+      if (_this._rescheduleHandler) {
+        _this._rescheduleHandler.cancel();
+        _this._rescheduleHandler = null;
+      }
+      if (_this._storedArgs !== null) {
+        _this._callback.apply(_this, _this._storedArgs);
+      }
+      if (_this._delayMS && savedClockTime !== _this._lastTime) {
+        var now = Date.now();
+        var elapsedTime = now - _this._lastTime;
+        var timeoutTime = Math.max(_this._delayMS - elapsedTime, 0);
+        _this._clockTime = now;
+        var timeoutHandle = setTimeout(function () {
+          executeAndReschedule();
+        }, timeoutTime);
+        _this._rescheduleHandler = {
+          cancel: function cancel() {
+            return clearTimeout(timeoutHandle);
+          }
+        };
+        _this._isScheduled = true;
+      }
+    };
+    this._debounced = debounce(executeAndReschedule, delayMS, {
+      leading: false,
+      trailing: true
+    });
   }
   var _proto = BatchinateLast.prototype;
   _proto.dispose = function dispose(options) {
@@ -18,67 +55,58 @@ var BatchinateLast = /*#__PURE__*/function () {
       };
     }
     var _options = options,
-      abort = _options.abort;
-    if (this._taskHandler) {
-      this._taskHandler.cancel();
-      this._taskHandler = null;
-    }
-    if (typeof this._callback === 'function' && !abort) {
-      this._callback.apply(this, this._args);
+      _options$abort = _options.abort,
+      abort = _options$abort === void 0 ? false : _options$abort;
+    if (abort) {
+      this._debounced.cancel();
+      if (this._rescheduleHandler) {
+        this._rescheduleHandler.cancel();
+        this._rescheduleHandler = null;
+      }
+      this._isScheduled = false;
+      this._storedArgs = null;
+    } else {
+      if (this._storedArgs !== null) {
+        this._debounced.flush();
+      }
     }
   };
   _proto.inSchedule = function inSchedule() {
-    return !!this._taskHandler;
+    return this._isScheduled || this._rescheduleHandler !== null;
   };
   _proto.flush = function flush() {
     for (var _len = arguments.length, args = new Array(_len), _key = 0; _key < _len; _key++) {
       args[_key] = arguments[_key];
     }
-    if (args.length) this._args = args;
-  };
-  _proto.handler = function handler() {
-    var _this = this;
-    if (this._taskHandler) {
-      this._taskHandler.cancel();
-      this._taskHandler = null;
+    if (args.length > 0) {
+      this._storedArgs = args;
     }
-    this._callback.apply(this, this._args);
-    if (this._delayMS && this._clockTime !== this._lastTime) {
-      var elapsedTime = Date.now() - this._lastTime;
-      var timeoutTime = Math.max(this._delayMS - elapsedTime, 0);
-      this._clockTime = Date.now();
-      var timeoutHandler = setTimeout(function () {
-        _this.handler();
-      }, timeoutTime);
-      this._taskHandler = {
-        cancel: function cancel() {
-          return clearTimeout(timeoutHandler);
-        }
-      };
+    this._debounced.flush();
+    if (this._rescheduleHandler) {
+      this._rescheduleHandler.cancel();
+      this._rescheduleHandler = null;
     }
+    this._isScheduled = false;
   };
   _proto.schedule = function schedule() {
-    var _this2 = this;
     for (var _len2 = arguments.length, args = new Array(_len2), _key2 = 0; _key2 < _len2; _key2++) {
       args[_key2] = arguments[_key2];
     }
-    this._args = args;
+    this._storedArgs = args;
     var now = Date.now();
     this._lastTime = now;
-    if (this._taskHandler) return;
     if (!this._delayMS) {
-      this.handler();
+      if (this._storedArgs !== null) {
+        this._callback.apply(this, this._storedArgs);
+      }
       return;
     }
+    if (this._isScheduled) {
+      return;
+    }
+    this._isScheduled = true;
     this._clockTime = now;
-    var timeoutHandler = setTimeout(function () {
-      _this2.handler();
-    }, this._delayMS);
-    this._taskHandler = {
-      cancel: function cancel() {
-        return clearTimeout(timeoutHandler);
-      }
-    };
+    this._debounced();
   };
   return BatchinateLast;
 }();

package/dist/batchinate-last.cjs.development.js.map

@@ -1 +1 @@
-{"version":3,"file":"batchinate-last.cjs.development.js","sources":["../src/index.ts"],"sourcesContent":["class BatchinateLast {\n  readonly _delayMS: number;\n  private _args: Array<any>;\n\n  private _callback: Function;\n\n  private _clockTime: number;\n  private _lastTime: number;\n  private _taskHandler: {\n    cancel: () => void;\n  };\n\n  constructor(cb: Function, delayMS: number) {\n    this._callback = cb;\n    this._delayMS = delayMS;\n    this._taskHandler = null;\n    this._args = null;\n    this.handler = this.handler.bind(this);\n  }\n\n  dispose(\n    options: {\n      abort: boolean;\n    } = {\n      abort: false,\n    }\n  ) {\n    const { abort } = options;\n    if (this._taskHandler) {\n      this._taskHandler.cancel();\n      this._taskHandler = null;\n    }\n    if (typeof this._callback === 'function' && !abort) {\n      this._callback.apply(this, this._args); // eslint-disable-line\n    }\n  }\n\n  inSchedule() {\n    return !!this._taskHandler;\n  }\n\n  flush(...args) {\n    if (args.length) this._args = args;\n  }\n\n  handler() {\n    if (this._taskHandler) {\n      this._taskHandler.cancel();\n      this._taskHandler = null;\n    }\n    this._callback.apply(this, this._args); // eslint-disable-line\n\n    if (this._delayMS && this._clockTime !== this._lastTime) {\n      const elapsedTime = Date.now() - this._lastTime;\n      const timeoutTime = Math.max(this._delayMS - elapsedTime, 0);\n      this._clockTime = Date.now();\n      const timeoutHandler = setTimeout(() => {\n        this.handler();\n      }, timeoutTime);\n\n      this._taskHandler = { cancel: () => clearTimeout(timeoutHandler) };\n    }\n  }\n\n  schedule(...args) {\n    this._args = args;\n    const now = Date.now();\n    this._lastTime = now;\n\n    if (this._taskHandler) return;\n\n    if (!this._delayMS) {\n      this.handler();\n      return;\n    }\n\n    this._clockTime = now;\n    const timeoutHandler = setTimeout(() => {\n      this.handler();\n    }, this._delayMS);\n\n    this._taskHandler = { cancel: () => clearTimeout(timeoutHandler) };\n  }\n}\n\nexport default BatchinateLast;\n"],"names":["BatchinateLast","cb","delayMS","_callback","_delayMS","_taskHandler","_args","handler","bind","_proto","prototype","dispose","options","abort","_options","cancel","apply","inSchedule","flush","args","Array","_len","_key","arguments","length","_clockTime","_lastTime","elapsedTime","Date","now","timeoutTime","Math","max","timeoutHandler","setTimeout","_this","clearTimeout","schedule","_len2","_key2","_this2"],"mappings":"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"}
+{"version":3,"file":"batchinate-last.cjs.development.js","sources":["../src/index.ts"],"sourcesContent":["import debounce from '@x-oasis/debounce';\n\n/**\n * BatchinateLast - Executes the callback with the last arguments after a delay.\n * If schedule is called multiple times within the delay period, only the last\n * call's arguments will be used when the callback executes.\n */\ntype TaskHandler = {\n  cancel: () => void;\n};\n\nclass BatchinateLast {\n  readonly _delayMS: number;\n  private _callback: (...args: any[]) => void;\n  private _debounced: ReturnType<typeof debounce>;\n  private _storedArgs: any[] | null = null;\n  private _isScheduled = false;\n  private _clockTime = 0;\n  private _lastTime = 0;\n  private _rescheduleHandler: TaskHandler | null = null;\n\n  constructor(cb: (...args: any[]) => void, delayMS: number) {\n    this._callback = cb;\n    this._delayMS = delayMS;\n\n    // Helper function to handle execution and potential rescheduling\n    const executeAndReschedule = (): void => {\n      const savedClockTime = this._clockTime;\n      this._isScheduled = false;\n      if (this._rescheduleHandler) {\n        this._rescheduleHandler.cancel();\n        this._rescheduleHandler = null;\n      }\n\n      if (this._storedArgs !== null) {\n        this._callback(...this._storedArgs);\n      }\n\n      // Check if there were new calls during execution\n      // If lastTime was updated (clockTime !== lastTime), reschedule\n      if (this._delayMS && savedClockTime !== this._lastTime) {\n        const now = Date.now();\n        const elapsedTime = now - this._lastTime;\n        const timeoutTime = Math.max(this._delayMS - elapsedTime, 0);\n        this._clockTime = now;\n\n        // Reschedule with remaining time\n        const timeoutHandle = setTimeout(() => {\n          executeAndReschedule();\n        }, timeoutTime);\n        this._rescheduleHandler = { cancel: () => clearTimeout(timeoutHandle) };\n        this._isScheduled = true;\n      }\n    };\n\n    // Create a debounced function\n    // Special behavior: if new calls occur during execution, reschedule\n    this._debounced = debounce(executeAndReschedule, delayMS, {\n      leading: false,\n      trailing: true,\n    });\n  }\n\n  /**\n   * Dispose the scheduled task\n   * @param options - Configuration options\n   * @param options.abort - If true, cancel without executing callback\n   */\n  dispose(\n    options: {\n      abort?: boolean;\n    } = {\n      abort: false,\n    }\n  ): void {\n    const { abort = false } = options;\n    if (abort) {\n      this._debounced.cancel();\n      if (this._rescheduleHandler) {\n        this._rescheduleHandler.cancel();\n        this._rescheduleHandler = null;\n      }\n      this._isScheduled = false;\n      this._storedArgs = null;\n    } else {\n      // Execute with current args if any\n      if (this._storedArgs !== null) {\n        this._debounced.flush();\n      }\n    }\n  }\n\n  /**\n   * Check if a task is currently scheduled\n   */\n  inSchedule(): boolean {\n    return this._isScheduled || this._rescheduleHandler !== null;\n  }\n\n  /**\n   * Flush the scheduled task immediately\n   * @param args - Optional arguments to use instead of stored args\n   */\n  flush(...args: any[]): void {\n    if (args.length > 0) {\n      this._storedArgs = args;\n    }\n    this._debounced.flush();\n    if (this._rescheduleHandler) {\n      this._rescheduleHandler.cancel();\n      this._rescheduleHandler = null;\n    }\n    this._isScheduled = false;\n  }\n\n  /**\n   * Schedule the callback to execute after delayMS\n   * If called multiple times, only the last call's arguments will be used\n   * @param args - Arguments to pass to the callback\n   */\n  schedule(...args: any[]): void {\n    this._storedArgs = args;\n    const now = Date.now();\n    this._lastTime = now;\n\n    // Handle zero delay case - execute immediately\n    if (!this._delayMS) {\n      if (this._storedArgs !== null) {\n        this._callback(...this._storedArgs);\n      }\n      return;\n    }\n\n    // If already scheduled, just update args and return (don't reset timer)\n    if (this._isScheduled) {\n      return;\n    }\n\n    // First call - mark as scheduled and call debounce\n    this._isScheduled = true;\n    this._clockTime = now;\n    this._debounced();\n  }\n}\n\nexport default BatchinateLast;\n"],"names":["BatchinateLast","cb","delayMS","_callback","_delayMS","executeAndReschedule","savedClockTime","_this","_clockTime","_isScheduled","_rescheduleHandler","cancel","_storedArgs","apply","_lastTime","now","Date","elapsedTime","timeoutTime","Math","max","timeoutHandle","setTimeout","clearTimeout","_debounced","debounce","leading","trailing","_proto","prototype","dispose","options","abort","_options","_options$abort","flush","inSchedule","args","Array","_len","_key","arguments","length","schedule","_len2","_key2"],"mappings":"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"}

package/dist/batchinate-last.cjs.production.min.js

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.default=function(){function t(t,a){this._callback=t,this._delayMS=a,this._taskHandler=null,this._args=null,this.handler=this.handler.bind(this)}var a=t.prototype;return a.dispose=function(t){void 0===t&&(t={abort:!1});var a=t.abort;this._taskHandler&&(this._taskHandler.cancel(),this._taskHandler=null),"function"!=typeof this._callback||a||this._callback.apply(this,this._args)},a.inSchedule=function(){return!!this._taskHandler},a.flush=function(){for(var t=arguments.length,a=new Array(t),e=0;e<t;e++)a[e]=arguments[e];a.length&&(this._args=a)},a.handler=function(){var t=this;if(this._taskHandler&&(this._taskHandler.cancel(),this._taskHandler=null),this._callback.apply(this,this._args),this._delayMS&&this._clockTime!==this._lastTime){var a=Date.now()-this._lastTime,e=Math.max(this._delayMS-a,0);this._clockTime=Date.now();var i=setTimeout((function(){t.handler()}),e);this._taskHandler={cancel:function(){return clearTimeout(i)}}}},a.schedule=function(){for(var t=this,a=arguments.length,e=new Array(a),i=0;i<a;i++)e[i]=arguments[i];this._args=e;var s=Date.now();if(this._lastTime=s,!this._taskHandler)if(this._delayMS){this._clockTime=s;var n=setTimeout((function(){t.handler()}),this._delayMS);this._taskHandler={cancel:function(){return clearTimeout(n)}}}else this.handler()},t}();
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0});var e,l=(e=require("@x-oasis/debounce"))&&"object"==typeof e&&"default"in e?e.default:e;exports.default=function(){function e(e,s){var t=this;this._storedArgs=null,this._isScheduled=!1,this._clockTime=0,this._lastTime=0,this._rescheduleHandler=null,this._callback=e,this._delayMS=s,this._debounced=l((function e(){var l=t._clockTime;if(t._isScheduled=!1,t._rescheduleHandler&&(t._rescheduleHandler.cancel(),t._rescheduleHandler=null),null!==t._storedArgs&&t._callback.apply(t,t._storedArgs),t._delayMS&&l!==t._lastTime){var s=Date.now(),i=Math.max(t._delayMS-(s-t._lastTime),0);t._clockTime=s;var r=setTimeout((function(){e()}),i);t._rescheduleHandler={cancel:function(){return clearTimeout(r)}},t._isScheduled=!0}}),s,{leading:!1,trailing:!0})}var s=e.prototype;return s.dispose=function(e){void 0===e&&(e={abort:!1});var l=e.abort;void 0!==l&&l?(this._debounced.cancel(),this._rescheduleHandler&&(this._rescheduleHandler.cancel(),this._rescheduleHandler=null),this._isScheduled=!1,this._storedArgs=null):null!==this._storedArgs&&this._debounced.flush()},s.inSchedule=function(){return this._isScheduled||null!==this._rescheduleHandler},s.flush=function(){for(var e=arguments.length,l=new Array(e),s=0;s<e;s++)l[s]=arguments[s];l.length>0&&(this._storedArgs=l),this._debounced.flush(),this._rescheduleHandler&&(this._rescheduleHandler.cancel(),this._rescheduleHandler=null),this._isScheduled=!1},s.schedule=function(){for(var e=arguments.length,l=new Array(e),s=0;s<e;s++)l[s]=arguments[s];this._storedArgs=l;var t=Date.now();this._lastTime=t,this._delayMS?this._isScheduled||(this._isScheduled=!0,this._clockTime=t,this._debounced()):null!==this._storedArgs&&this._callback.apply(this,this._storedArgs)},e}();
 //# sourceMappingURL=batchinate-last.cjs.production.min.js.map

package/dist/batchinate-last.cjs.production.min.js.map

@@ -1 +1 @@
-{"version":3,"file":"batchinate-last.cjs.production.min.js","sources":["../src/index.ts"],"sourcesContent":["class BatchinateLast {\n  readonly _delayMS: number;\n  private _args: Array<any>;\n\n  private _callback: Function;\n\n  private _clockTime: number;\n  private _lastTime: number;\n  private _taskHandler: {\n    cancel: () => void;\n  };\n\n  constructor(cb: Function, delayMS: number) {\n    this._callback = cb;\n    this._delayMS = delayMS;\n    this._taskHandler = null;\n    this._args = null;\n    this.handler = this.handler.bind(this);\n  }\n\n  dispose(\n    options: {\n      abort: boolean;\n    } = {\n      abort: false,\n    }\n  ) {\n    const { abort } = options;\n    if (this._taskHandler) {\n      this._taskHandler.cancel();\n      this._taskHandler = null;\n    }\n    if (typeof this._callback === 'function' && !abort) {\n      this._callback.apply(this, this._args); // eslint-disable-line\n    }\n  }\n\n  inSchedule() {\n    return !!this._taskHandler;\n  }\n\n  flush(...args) {\n    if (args.length) this._args = args;\n  }\n\n  handler() {\n    if (this._taskHandler) {\n      this._taskHandler.cancel();\n      this._taskHandler = null;\n    }\n    this._callback.apply(this, this._args); // eslint-disable-line\n\n    if (this._delayMS && this._clockTime !== this._lastTime) {\n      const elapsedTime = Date.now() - this._lastTime;\n      const timeoutTime = Math.max(this._delayMS - elapsedTime, 0);\n      this._clockTime = Date.now();\n      const timeoutHandler = setTimeout(() => {\n        this.handler();\n      }, timeoutTime);\n\n      this._taskHandler = { cancel: () => clearTimeout(timeoutHandler) };\n    }\n  }\n\n  schedule(...args) {\n    this._args = args;\n    const now = Date.now();\n    this._lastTime = now;\n\n    if (this._taskHandler) return;\n\n    if (!this._delayMS) {\n      this.handler();\n      return;\n    }\n\n    this._clockTime = now;\n    const timeoutHandler = setTimeout(() => {\n      this.handler();\n    }, this._delayMS);\n\n    this._taskHandler = { cancel: () => clearTimeout(timeoutHandler) };\n  }\n}\n\nexport default BatchinateLast;\n"],"names":["BatchinateLast","cb","delayMS","this","_callback","_delayMS","_taskHandler","_args","handler","bind","_proto","prototype","dispose","options","abort","cancel","apply","inSchedule","flush","args","Array","_len","_key","arguments","length","_clockTime","_lastTime","elapsedTime","Date","now","timeoutTime","Math","max","timeoutHandler","setTimeout","_this","clearTimeout","schedule","_len2","_key2","_this2"],"mappings":"+FAYE,SAAAA,EAAYC,EAAcC,GACxBC,KAAKC,UAAYH,EACjBE,KAAKE,SAAWH,EAChBC,KAAKG,aAAe,KACpBH,KAAKI,MAAQ,KACbJ,KAAKK,QAAUL,KAAKK,QAAQC,KAAKN,MAClC,IAAAO,EAAAV,EAAAW,UAgEA,OAhEAD,EAEDE,QAAA,SACEC,YAAAA,IAAAA,EAEI,CACFC,OAAO,IAGT,IAAQA,EAAUD,EAAVC,MACJX,KAAKG,eACPH,KAAKG,aAAaS,SAClBZ,KAAKG,aAAe,MAEQ,mBAAnBH,KAAKC,WAA6BU,GAC3CX,KAAKC,UAAUY,MAAMb,KAAMA,KAAKI,QAEnCG,EAEDO,WAAA,WACE,QAASd,KAAKG,cACfI,EAEDQ,MAAA,sCAASC,MAAIC,MAAAC,GAAAC,IAAAA,EAAAD,EAAAC,IAAJH,EAAIG,GAAAC,UAAAD,GACPH,EAAKK,SAAQrB,KAAKI,MAAQY,IAC/BT,EAEDF,QAAA,sBAOE,GANIL,KAAKG,eACPH,KAAKG,aAAaS,SAClBZ,KAAKG,aAAe,MAEtBH,KAAKC,UAAUY,MAAMb,KAAMA,KAAKI,OAE5BJ,KAAKE,UAAYF,KAAKsB,aAAetB,KAAKuB,UAAW,CACvD,IAAMC,EAAcC,KAAKC,MAAQ1B,KAAKuB,UAChCI,EAAcC,KAAKC,IAAI7B,KAAKE,SAAWsB,EAAa,GAC1DxB,KAAKsB,WAAaG,KAAKC,MACvB,IAAMI,EAAiBC,YAAW,WAChCC,EAAK3B,YACJsB,GAEH3B,KAAKG,aAAe,CAAES,OAAQ,WAAA,OAAMqB,aAAaH,OAEpDvB,EAED2B,SAAA,6CAAYlB,MAAIC,MAAAkB,GAAAC,IAAAA,EAAAD,EAAAC,IAAJpB,EAAIoB,GAAAhB,UAAAgB,GACdpC,KAAKI,MAAQY,EACb,IAAMU,EAAMD,KAAKC,MAGjB,GAFA1B,KAAKuB,UAAYG,GAEb1B,KAAKG,aAET,GAAKH,KAAKE,SAAV,CAKAF,KAAKsB,WAAaI,EAClB,IAAMI,EAAiBC,YAAW,WAChCM,EAAKhC,YACJL,KAAKE,UAERF,KAAKG,aAAe,CAAES,OAAQ,WAAA,OAAMqB,aAAaH,UAT/C9B,KAAKK,WAURR"}
+{"version":3,"file":"batchinate-last.cjs.production.min.js","sources":["../src/index.ts"],"sourcesContent":["import debounce from '@x-oasis/debounce';\n\n/**\n * BatchinateLast - Executes the callback with the last arguments after a delay.\n * If schedule is called multiple times within the delay period, only the last\n * call's arguments will be used when the callback executes.\n */\ntype TaskHandler = {\n  cancel: () => void;\n};\n\nclass BatchinateLast {\n  readonly _delayMS: number;\n  private _callback: (...args: any[]) => void;\n  private _debounced: ReturnType<typeof debounce>;\n  private _storedArgs: any[] | null = null;\n  private _isScheduled = false;\n  private _clockTime = 0;\n  private _lastTime = 0;\n  private _rescheduleHandler: TaskHandler | null = null;\n\n  constructor(cb: (...args: any[]) => void, delayMS: number) {\n    this._callback = cb;\n    this._delayMS = delayMS;\n\n    // Helper function to handle execution and potential rescheduling\n    const executeAndReschedule = (): void => {\n      const savedClockTime = this._clockTime;\n      this._isScheduled = false;\n      if (this._rescheduleHandler) {\n        this._rescheduleHandler.cancel();\n        this._rescheduleHandler = null;\n      }\n\n      if (this._storedArgs !== null) {\n        this._callback(...this._storedArgs);\n      }\n\n      // Check if there were new calls during execution\n      // If lastTime was updated (clockTime !== lastTime), reschedule\n      if (this._delayMS && savedClockTime !== this._lastTime) {\n        const now = Date.now();\n        const elapsedTime = now - this._lastTime;\n        const timeoutTime = Math.max(this._delayMS - elapsedTime, 0);\n        this._clockTime = now;\n\n        // Reschedule with remaining time\n        const timeoutHandle = setTimeout(() => {\n          executeAndReschedule();\n        }, timeoutTime);\n        this._rescheduleHandler = { cancel: () => clearTimeout(timeoutHandle) };\n        this._isScheduled = true;\n      }\n    };\n\n    // Create a debounced function\n    // Special behavior: if new calls occur during execution, reschedule\n    this._debounced = debounce(executeAndReschedule, delayMS, {\n      leading: false,\n      trailing: true,\n    });\n  }\n\n  /**\n   * Dispose the scheduled task\n   * @param options - Configuration options\n   * @param options.abort - If true, cancel without executing callback\n   */\n  dispose(\n    options: {\n      abort?: boolean;\n    } = {\n      abort: false,\n    }\n  ): void {\n    const { abort = false } = options;\n    if (abort) {\n      this._debounced.cancel();\n      if (this._rescheduleHandler) {\n        this._rescheduleHandler.cancel();\n        this._rescheduleHandler = null;\n      }\n      this._isScheduled = false;\n      this._storedArgs = null;\n    } else {\n      // Execute with current args if any\n      if (this._storedArgs !== null) {\n        this._debounced.flush();\n      }\n    }\n  }\n\n  /**\n   * Check if a task is currently scheduled\n   */\n  inSchedule(): boolean {\n    return this._isScheduled || this._rescheduleHandler !== null;\n  }\n\n  /**\n   * Flush the scheduled task immediately\n   * @param args - Optional arguments to use instead of stored args\n   */\n  flush(...args: any[]): void {\n    if (args.length > 0) {\n      this._storedArgs = args;\n    }\n    this._debounced.flush();\n    if (this._rescheduleHandler) {\n      this._rescheduleHandler.cancel();\n      this._rescheduleHandler = null;\n    }\n    this._isScheduled = false;\n  }\n\n  /**\n   * Schedule the callback to execute after delayMS\n   * If called multiple times, only the last call's arguments will be used\n   * @param args - Arguments to pass to the callback\n   */\n  schedule(...args: any[]): void {\n    this._storedArgs = args;\n    const now = Date.now();\n    this._lastTime = now;\n\n    // Handle zero delay case - execute immediately\n    if (!this._delayMS) {\n      if (this._storedArgs !== null) {\n        this._callback(...this._storedArgs);\n      }\n      return;\n    }\n\n    // If already scheduled, just update args and return (don't reset timer)\n    if (this._isScheduled) {\n      return;\n    }\n\n    // First call - mark as scheduled and call debounce\n    this._isScheduled = true;\n    this._clockTime = now;\n    this._debounced();\n  }\n}\n\nexport default BatchinateLast;\n"],"names":["BatchinateLast","cb","delayMS","this","_callback","_delayMS","_debounced","debounce","executeAndReschedule","savedClockTime","_this","_clockTime","_isScheduled","_rescheduleHandler","cancel","_storedArgs","apply","_lastTime","now","Date","timeoutTime","Math","max","timeoutHandle","setTimeout","clearTimeout","leading","trailing","_proto","prototype","dispose","options","abort","_options$abort","flush","inSchedule","args","Array","_len","_key","arguments","length","schedule","_len2","_key2"],"mappings":"uLAqBE,SAAAA,EAAYC,EAA8BC,cANlCC,iBAA4B,KAC5BA,mBAAe,EACfA,gBAAa,EACbA,eAAY,EACZA,wBAAyC,KAG/CA,KAAKC,UAAYH,EACjBE,KAAKE,SAAWH,EAkChBC,KAAKG,WAAaC,GA/BW,SAAvBC,IACJ,IAAMC,EAAiBC,EAAKC,WAa5B,GAZAD,EAAKE,cAAe,EAChBF,EAAKG,qBACPH,EAAKG,mBAAmBC,SACxBJ,EAAKG,mBAAqB,MAGH,OAArBH,EAAKK,aACPL,EAAKN,UAASY,MAAdN,EAAkBA,EAAKK,aAKrBL,EAAKL,UAAYI,IAAmBC,EAAKO,UAAW,CACtD,IAAMC,EAAMC,KAAKD,MAEXE,EAAcC,KAAKC,IAAIZ,EAAKL,UADda,EAAMR,EAAKO,WAC2B,GAC1DP,EAAKC,WAAaO,EAGlB,IAAMK,EAAgBC,YAAW,WAC/BhB,MACCY,GACHV,EAAKG,mBAAqB,CAAEC,OAAQ,WAAA,OAAMW,aAAaF,KACvDb,EAAKE,cAAe,KAMyBV,EAAS,CACxDwB,SAAS,EACTC,UAAU,IAEb,IAAAC,EAAA5B,EAAA6B,UAiFA,OAjFAD,EAODE,QAAA,SACEC,YAAAA,IAAAA,EAEI,CACFC,OAAO,IAGT,IAAiCC,EAAPF,EAAlBC,eAAKC,GAAQA,GAEnB9B,KAAKG,WAAWQ,SACZX,KAAKU,qBACPV,KAAKU,mBAAmBC,SACxBX,KAAKU,mBAAqB,MAE5BV,KAAKS,cAAe,EACpBT,KAAKY,YAAc,MAGM,OAArBZ,KAAKY,aACPZ,KAAKG,WAAW4B,SAGrBN,EAKDO,WAAA,WACE,OAAOhC,KAAKS,cAA4C,OAA5BT,KAAKU,oBAClCe,EAMDM,MAAA,sCAASE,MAAWC,MAAAC,GAAAC,IAAAA,EAAAD,EAAAC,IAAXH,EAAWG,GAAAC,UAAAD,GACdH,EAAKK,OAAS,IAChBtC,KAAKY,YAAcqB,GAErBjC,KAAKG,WAAW4B,QACZ/B,KAAKU,qBACPV,KAAKU,mBAAmBC,SACxBX,KAAKU,mBAAqB,MAE5BV,KAAKS,cAAe,GACrBgB,EAODc,SAAA,sCAAYN,MAAWC,MAAAM,GAAAC,IAAAA,EAAAD,EAAAC,IAAXR,EAAWQ,GAAAJ,UAAAI,GACrBzC,KAAKY,YAAcqB,EACnB,IAAMlB,EAAMC,KAAKD,MACjBf,KAAKc,UAAYC,EAGZf,KAAKE,SAQNF,KAAKS,eAKTT,KAAKS,cAAe,EACpBT,KAAKQ,WAAaO,EAClBf,KAAKG,cAdsB,OAArBH,KAAKY,aACPZ,KAAKC,UAASY,MAAdb,KAAkBA,KAAKY,cAc5Bf"}

package/dist/batchinate-last.esm.js

@@ -1,10 +1,45 @@
+import debounce from '@x-oasis/debounce';
+
 var BatchinateLast = /*#__PURE__*/function () {
   function BatchinateLast(cb, delayMS) {
+    var _this = this;
+    this._storedArgs = null;
+    this._isScheduled = false;
+    this._clockTime = 0;
+    this._lastTime = 0;
+    this._rescheduleHandler = null;
     this._callback = cb;
     this._delayMS = delayMS;
-    this._taskHandler = null;
-    this._args = null;
-    this.handler = this.handler.bind(this);
+    var executeAndReschedule = function executeAndReschedule() {
+      var savedClockTime = _this._clockTime;
+      _this._isScheduled = false;
+      if (_this._rescheduleHandler) {
+        _this._rescheduleHandler.cancel();
+        _this._rescheduleHandler = null;
+      }
+      if (_this._storedArgs !== null) {
+        _this._callback.apply(_this, _this._storedArgs);
+      }
+      if (_this._delayMS && savedClockTime !== _this._lastTime) {
+        var now = Date.now();
+        var elapsedTime = now - _this._lastTime;
+        var timeoutTime = Math.max(_this._delayMS - elapsedTime, 0);
+        _this._clockTime = now;
+        var timeoutHandle = setTimeout(function () {
+          executeAndReschedule();
+        }, timeoutTime);
+        _this._rescheduleHandler = {
+          cancel: function cancel() {
+            return clearTimeout(timeoutHandle);
+          }
+        };
+        _this._isScheduled = true;
+      }
+    };
+    this._debounced = debounce(executeAndReschedule, delayMS, {
+      leading: false,
+      trailing: true
+    });
   }
   var _proto = BatchinateLast.prototype;
   _proto.dispose = function dispose(options) {
@@ -14,67 +49,58 @@ var BatchinateLast = /*#__PURE__*/function () {
       };
     }
     var _options = options,
-      abort = _options.abort;
-    if (this._taskHandler) {
-      this._taskHandler.cancel();
-      this._taskHandler = null;
-    }
-    if (typeof this._callback === 'function' && !abort) {
-      this._callback.apply(this, this._args);
+      _options$abort = _options.abort,
+      abort = _options$abort === void 0 ? false : _options$abort;
+    if (abort) {
+      this._debounced.cancel();
+      if (this._rescheduleHandler) {
+        this._rescheduleHandler.cancel();
+        this._rescheduleHandler = null;
+      }
+      this._isScheduled = false;
+      this._storedArgs = null;
+    } else {
+      if (this._storedArgs !== null) {
+        this._debounced.flush();
+      }
     }
   };
   _proto.inSchedule = function inSchedule() {
-    return !!this._taskHandler;
+    return this._isScheduled || this._rescheduleHandler !== null;
   };
   _proto.flush = function flush() {
     for (var _len = arguments.length, args = new Array(_len), _key = 0; _key < _len; _key++) {
       args[_key] = arguments[_key];
     }
-    if (args.length) this._args = args;
-  };
-  _proto.handler = function handler() {
-    var _this = this;
-    if (this._taskHandler) {
-      this._taskHandler.cancel();
-      this._taskHandler = null;
+    if (args.length > 0) {
+      this._storedArgs = args;
     }
-    this._callback.apply(this, this._args);
-    if (this._delayMS && this._clockTime !== this._lastTime) {
-      var elapsedTime = Date.now() - this._lastTime;
-      var timeoutTime = Math.max(this._delayMS - elapsedTime, 0);
-      this._clockTime = Date.now();
-      var timeoutHandler = setTimeout(function () {
-        _this.handler();
-      }, timeoutTime);
-      this._taskHandler = {
-        cancel: function cancel() {
-          return clearTimeout(timeoutHandler);
-        }
-      };
+    this._debounced.flush();
+    if (this._rescheduleHandler) {
+      this._rescheduleHandler.cancel();
+      this._rescheduleHandler = null;
     }
+    this._isScheduled = false;
   };
   _proto.schedule = function schedule() {
-    var _this2 = this;
     for (var _len2 = arguments.length, args = new Array(_len2), _key2 = 0; _key2 < _len2; _key2++) {
       args[_key2] = arguments[_key2];
     }
-    this._args = args;
+    this._storedArgs = args;
     var now = Date.now();
     this._lastTime = now;
-    if (this._taskHandler) return;
     if (!this._delayMS) {
-      this.handler();
+      if (this._storedArgs !== null) {
+        this._callback.apply(this, this._storedArgs);
+      }
       return;
     }
+    if (this._isScheduled) {
+      return;
+    }
+    this._isScheduled = true;
     this._clockTime = now;
-    var timeoutHandler = setTimeout(function () {
-      _this2.handler();
-    }, this._delayMS);
-    this._taskHandler = {
-      cancel: function cancel() {
-        return clearTimeout(timeoutHandler);
-      }
-    };
+    this._debounced();
   };
   return BatchinateLast;
 }();

package/dist/batchinate-last.esm.js.map

@@ -1 +1 @@
-{"version":3,"file":"batchinate-last.esm.js","sources":["../src/index.ts"],"sourcesContent":["class BatchinateLast {\n  readonly _delayMS: number;\n  private _args: Array<any>;\n\n  private _callback: Function;\n\n  private _clockTime: number;\n  private _lastTime: number;\n  private _taskHandler: {\n    cancel: () => void;\n  };\n\n  constructor(cb: Function, delayMS: number) {\n    this._callback = cb;\n    this._delayMS = delayMS;\n    this._taskHandler = null;\n    this._args = null;\n    this.handler = this.handler.bind(this);\n  }\n\n  dispose(\n    options: {\n      abort: boolean;\n    } = {\n      abort: false,\n    }\n  ) {\n    const { abort } = options;\n    if (this._taskHandler) {\n      this._taskHandler.cancel();\n      this._taskHandler = null;\n    }\n    if (typeof this._callback === 'function' && !abort) {\n      this._callback.apply(this, this._args); // eslint-disable-line\n    }\n  }\n\n  inSchedule() {\n    return !!this._taskHandler;\n  }\n\n  flush(...args) {\n    if (args.length) this._args = args;\n  }\n\n  handler() {\n    if (this._taskHandler) {\n      this._taskHandler.cancel();\n      this._taskHandler = null;\n    }\n    this._callback.apply(this, this._args); // eslint-disable-line\n\n    if (this._delayMS && this._clockTime !== this._lastTime) {\n      const elapsedTime = Date.now() - this._lastTime;\n      const timeoutTime = Math.max(this._delayMS - elapsedTime, 0);\n      this._clockTime = Date.now();\n      const timeoutHandler = setTimeout(() => {\n        this.handler();\n      }, timeoutTime);\n\n      this._taskHandler = { cancel: () => clearTimeout(timeoutHandler) };\n    }\n  }\n\n  schedule(...args) {\n    this._args = args;\n    const now = Date.now();\n    this._lastTime = now;\n\n    if (this._taskHandler) return;\n\n    if (!this._delayMS) {\n      this.handler();\n      return;\n    }\n\n    this._clockTime = now;\n    const timeoutHandler = setTimeout(() => {\n      this.handler();\n    }, this._delayMS);\n\n    this._taskHandler = { cancel: () => clearTimeout(timeoutHandler) };\n  }\n}\n\nexport default BatchinateLast;\n"],"names":["BatchinateLast","cb","delayMS","_callback","_delayMS","_taskHandler","_args","handler","bind","_proto","prototype","dispose","options","abort","_options","cancel","apply","inSchedule","flush","args","Array","_len","_key","arguments","length","_clockTime","_lastTime","elapsedTime","Date","now","timeoutTime","Math","max","timeoutHandler","setTimeout","_this","clearTimeout","schedule","_len2","_key2","_this2"],"mappings":"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"}
+{"version":3,"file":"batchinate-last.esm.js","sources":["../src/index.ts"],"sourcesContent":["import debounce from '@x-oasis/debounce';\n\n/**\n * BatchinateLast - Executes the callback with the last arguments after a delay.\n * If schedule is called multiple times within the delay period, only the last\n * call's arguments will be used when the callback executes.\n */\ntype TaskHandler = {\n  cancel: () => void;\n};\n\nclass BatchinateLast {\n  readonly _delayMS: number;\n  private _callback: (...args: any[]) => void;\n  private _debounced: ReturnType<typeof debounce>;\n  private _storedArgs: any[] | null = null;\n  private _isScheduled = false;\n  private _clockTime = 0;\n  private _lastTime = 0;\n  private _rescheduleHandler: TaskHandler | null = null;\n\n  constructor(cb: (...args: any[]) => void, delayMS: number) {\n    this._callback = cb;\n    this._delayMS = delayMS;\n\n    // Helper function to handle execution and potential rescheduling\n    const executeAndReschedule = (): void => {\n      const savedClockTime = this._clockTime;\n      this._isScheduled = false;\n      if (this._rescheduleHandler) {\n        this._rescheduleHandler.cancel();\n        this._rescheduleHandler = null;\n      }\n\n      if (this._storedArgs !== null) {\n        this._callback(...this._storedArgs);\n      }\n\n      // Check if there were new calls during execution\n      // If lastTime was updated (clockTime !== lastTime), reschedule\n      if (this._delayMS && savedClockTime !== this._lastTime) {\n        const now = Date.now();\n        const elapsedTime = now - this._lastTime;\n        const timeoutTime = Math.max(this._delayMS - elapsedTime, 0);\n        this._clockTime = now;\n\n        // Reschedule with remaining time\n        const timeoutHandle = setTimeout(() => {\n          executeAndReschedule();\n        }, timeoutTime);\n        this._rescheduleHandler = { cancel: () => clearTimeout(timeoutHandle) };\n        this._isScheduled = true;\n      }\n    };\n\n    // Create a debounced function\n    // Special behavior: if new calls occur during execution, reschedule\n    this._debounced = debounce(executeAndReschedule, delayMS, {\n      leading: false,\n      trailing: true,\n    });\n  }\n\n  /**\n   * Dispose the scheduled task\n   * @param options - Configuration options\n   * @param options.abort - If true, cancel without executing callback\n   */\n  dispose(\n    options: {\n      abort?: boolean;\n    } = {\n      abort: false,\n    }\n  ): void {\n    const { abort = false } = options;\n    if (abort) {\n      this._debounced.cancel();\n      if (this._rescheduleHandler) {\n        this._rescheduleHandler.cancel();\n        this._rescheduleHandler = null;\n      }\n      this._isScheduled = false;\n      this._storedArgs = null;\n    } else {\n      // Execute with current args if any\n      if (this._storedArgs !== null) {\n        this._debounced.flush();\n      }\n    }\n  }\n\n  /**\n   * Check if a task is currently scheduled\n   */\n  inSchedule(): boolean {\n    return this._isScheduled || this._rescheduleHandler !== null;\n  }\n\n  /**\n   * Flush the scheduled task immediately\n   * @param args - Optional arguments to use instead of stored args\n   */\n  flush(...args: any[]): void {\n    if (args.length > 0) {\n      this._storedArgs = args;\n    }\n    this._debounced.flush();\n    if (this._rescheduleHandler) {\n      this._rescheduleHandler.cancel();\n      this._rescheduleHandler = null;\n    }\n    this._isScheduled = false;\n  }\n\n  /**\n   * Schedule the callback to execute after delayMS\n   * If called multiple times, only the last call's arguments will be used\n   * @param args - Arguments to pass to the callback\n   */\n  schedule(...args: any[]): void {\n    this._storedArgs = args;\n    const now = Date.now();\n    this._lastTime = now;\n\n    // Handle zero delay case - execute immediately\n    if (!this._delayMS) {\n      if (this._storedArgs !== null) {\n        this._callback(...this._storedArgs);\n      }\n      return;\n    }\n\n    // If already scheduled, just update args and return (don't reset timer)\n    if (this._isScheduled) {\n      return;\n    }\n\n    // First call - mark as scheduled and call debounce\n    this._isScheduled = true;\n    this._clockTime = now;\n    this._debounced();\n  }\n}\n\nexport default BatchinateLast;\n"],"names":["BatchinateLast","cb","delayMS","_callback","_delayMS","executeAndReschedule","savedClockTime","_this","_clockTime","_isScheduled","_rescheduleHandler","cancel","_storedArgs","apply","_lastTime","now","Date","elapsedTime","timeoutTime","Math","max","timeoutHandle","setTimeout","clearTimeout","_debounced","debounce","leading","trailing","_proto","prototype","dispose","options","abort","_options","_options$abort","flush","inSchedule","args","Array","_len","_key","arguments","length","schedule","_len2","_key2"],"mappings":"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"}

package/dist/index.d.ts

@@ -1,17 +1,18 @@
 declare class BatchinateLast {
     readonly _delayMS: number;
-    private _args;
     private _callback;
+    private _debounced;
+    private _storedArgs;
+    private _isScheduled;
     private _clockTime;
     private _lastTime;
-    private _taskHandler;
-    constructor(cb: Function, delayMS: number);
+    private _rescheduleHandler;
+    constructor(cb: (...args: any[]) => void, delayMS: number);
     dispose(options?: {
-        abort: boolean;
+        abort?: boolean;
     }): void;
     inSchedule(): boolean;
     flush(...args: any[]): void;
-    handler(): void;
     schedule(...args: any[]): void;
 }
 export default BatchinateLast;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@x-oasis/batchinate-last",
-  "version": "0.1.36",
+  "version": "0.1.38",
   "description": "batchinate-last function",
   "main": "dist/index.js",
   "typings": "dist/index.d.ts",
@@ -13,6 +13,9 @@
   "devDependencies": {
     "tsdx": "^0.14.1"
   },
+  "dependencies": {
+    "@x-oasis/debounce": "0.1.38"
+  },
   "scripts": {
     "build": "tsdx build --tsconfig tsconfig.build.json",
     "clean": "rimraf ./dist",

package/src/index.ts

@@ -1,85 +1,145 @@
-class BatchinateLast {
-  readonly _delayMS: number;
-  private _args: Array<any>;
+import debounce from '@x-oasis/debounce';
 
-  private _callback: Function;
+/**
+ * BatchinateLast - Executes the callback with the last arguments after a delay.
+ * If schedule is called multiple times within the delay period, only the last
+ * call's arguments will be used when the callback executes.
+ */
+type TaskHandler = {
+  cancel: () => void;
+};
 
-  private _clockTime: number;
-  private _lastTime: number;
-  private _taskHandler: {
-    cancel: () => void;
-  };
+class BatchinateLast {
+  readonly _delayMS: number;
+  private _callback: (...args: any[]) => void;
+  private _debounced: ReturnType<typeof debounce>;
+  private _storedArgs: any[] | null = null;
+  private _isScheduled = false;
+  private _clockTime = 0;
+  private _lastTime = 0;
+  private _rescheduleHandler: TaskHandler | null = null;
 
-  constructor(cb: Function, delayMS: number) {
+  constructor(cb: (...args: any[]) => void, delayMS: number) {
     this._callback = cb;
     this._delayMS = delayMS;
-    this._taskHandler = null;
-    this._args = null;
-    this.handler = this.handler.bind(this);
+
+    // Helper function to handle execution and potential rescheduling
+    const executeAndReschedule = (): void => {
+      const savedClockTime = this._clockTime;
+      this._isScheduled = false;
+      if (this._rescheduleHandler) {
+        this._rescheduleHandler.cancel();
+        this._rescheduleHandler = null;
+      }
+
+      if (this._storedArgs !== null) {
+        this._callback(...this._storedArgs);
+      }
+
+      // Check if there were new calls during execution
+      // If lastTime was updated (clockTime !== lastTime), reschedule
+      if (this._delayMS && savedClockTime !== this._lastTime) {
+        const now = Date.now();
+        const elapsedTime = now - this._lastTime;
+        const timeoutTime = Math.max(this._delayMS - elapsedTime, 0);
+        this._clockTime = now;
+
+        // Reschedule with remaining time
+        const timeoutHandle = setTimeout(() => {
+          executeAndReschedule();
+        }, timeoutTime);
+        this._rescheduleHandler = { cancel: () => clearTimeout(timeoutHandle) };
+        this._isScheduled = true;
+      }
+    };
+
+    // Create a debounced function
+    // Special behavior: if new calls occur during execution, reschedule
+    this._debounced = debounce(executeAndReschedule, delayMS, {
+      leading: false,
+      trailing: true,
+    });
   }
 
+  /**
+   * Dispose the scheduled task
+   * @param options - Configuration options
+   * @param options.abort - If true, cancel without executing callback
+   */
   dispose(
     options: {
-      abort: boolean;
+      abort?: boolean;
     } = {
       abort: false,
     }
-  ) {
-    const { abort } = options;
-    if (this._taskHandler) {
-      this._taskHandler.cancel();
-      this._taskHandler = null;
-    }
-    if (typeof this._callback === 'function' && !abort) {
-      this._callback.apply(this, this._args); // eslint-disable-line
+  ): void {
+    const { abort = false } = options;
+    if (abort) {
+      this._debounced.cancel();
+      if (this._rescheduleHandler) {
+        this._rescheduleHandler.cancel();
+        this._rescheduleHandler = null;
+      }
+      this._isScheduled = false;
+      this._storedArgs = null;
+    } else {
+      // Execute with current args if any
+      if (this._storedArgs !== null) {
+        this._debounced.flush();
+      }
     }
   }
 
-  inSchedule() {
-    return !!this._taskHandler;
+  /**
+   * Check if a task is currently scheduled
+   */
+  inSchedule(): boolean {
+    return this._isScheduled || this._rescheduleHandler !== null;
   }
 
-  flush(...args) {
-    if (args.length) this._args = args;
-  }
-
-  handler() {
-    if (this._taskHandler) {
-      this._taskHandler.cancel();
-      this._taskHandler = null;
+  /**
+   * Flush the scheduled task immediately
+   * @param args - Optional arguments to use instead of stored args
+   */
+  flush(...args: any[]): void {
+    if (args.length > 0) {
+      this._storedArgs = args;
     }
-    this._callback.apply(this, this._args); // eslint-disable-line
-
-    if (this._delayMS && this._clockTime !== this._lastTime) {
-      const elapsedTime = Date.now() - this._lastTime;
-      const timeoutTime = Math.max(this._delayMS - elapsedTime, 0);
-      this._clockTime = Date.now();
-      const timeoutHandler = setTimeout(() => {
-        this.handler();
-      }, timeoutTime);
-
-      this._taskHandler = { cancel: () => clearTimeout(timeoutHandler) };
+    this._debounced.flush();
+    if (this._rescheduleHandler) {
+      this._rescheduleHandler.cancel();
+      this._rescheduleHandler = null;
     }
+    this._isScheduled = false;
   }
 
-  schedule(...args) {
-    this._args = args;
+  /**
+   * Schedule the callback to execute after delayMS
+   * If called multiple times, only the last call's arguments will be used
+   * @param args - Arguments to pass to the callback
+   */
+  schedule(...args: any[]): void {
+    this._storedArgs = args;
     const now = Date.now();
     this._lastTime = now;
 
-    if (this._taskHandler) return;
-
+    // Handle zero delay case - execute immediately
     if (!this._delayMS) {
-      this.handler();
+      if (this._storedArgs !== null) {
+        this._callback(...this._storedArgs);
+      }
       return;
     }
 
-    this._clockTime = now;
-    const timeoutHandler = setTimeout(() => {
-      this.handler();
-    }, this._delayMS);
+    // If already scheduled, just update args and return (don't reset timer)
+    if (this._isScheduled) {
+      return;
+    }
 
-    this._taskHandler = { cancel: () => clearTimeout(timeoutHandler) };
+    // First call - mark as scheduled and call debounce
+    this._isScheduled = true;
+    this._clockTime = now;
+    this._debounced();
   }
 }
 

package/test/test.spec.ts

@@ -1,5 +1,249 @@
-import { expect, test } from 'vitest';
+import { expect, test, vi, beforeEach, afterEach } from 'vitest';
+import BatchinateLast from '../src/index';
 
-test('vitest', async () => {
-  expect('vitest').toBe('vitest');
+beforeEach(() => {
+  vi.useFakeTimers();
+});
+
+afterEach(() => {
+  vi.restoreAllMocks();
+});
+
+test('BatchinateLast basic functionality - uses last arguments', () => {
+  const fn = vi.fn();
+  const batchinator = new BatchinateLast(fn, 100);
+
+  batchinator.schedule('First');
+  batchinator.schedule('Second');
+  batchinator.schedule('Third');
+
+  expect(fn).not.toHaveBeenCalled();
+
+  vi.advanceTimersByTime(100);
+
+  expect(fn).toHaveBeenCalledTimes(1);
+  expect(fn).toHaveBeenCalledWith('Third');
+});
+
+test('BatchinateLast flush', () => {
+  const fn = vi.fn();
+  const batchinator = new BatchinateLast(fn, 100);
+
+  batchinator.schedule('First');
+  batchinator.schedule('Second');
+  batchinator.flush();
+
+  expect(fn).toHaveBeenCalledTimes(1);
+  expect(fn).toHaveBeenCalledWith('Second');
+
+  vi.advanceTimersByTime(100);
+  expect(fn).toHaveBeenCalledTimes(1); // Already flushed
+});
+
+test('BatchinateLast flush with new arguments', () => {
+  const fn = vi.fn();
+  const batchinator = new BatchinateLast(fn, 100);
+
+  batchinator.schedule('First');
+  batchinator.flush('Custom');
+
+  expect(fn).toHaveBeenCalledTimes(1);
+  expect(fn).toHaveBeenCalledWith('Custom');
+});
+
+test('BatchinateLast dispose without abort', () => {
+  const fn = vi.fn();
+  const batchinator = new BatchinateLast(fn, 100);
+
+  batchinator.schedule('First');
+  batchinator.schedule('Second');
+  batchinator.dispose();
+
+  expect(fn).toHaveBeenCalledTimes(1);
+  expect(fn).toHaveBeenCalledWith('Second');
+
+  vi.advanceTimersByTime(100);
+  expect(fn).toHaveBeenCalledTimes(1); // Already disposed
+});
+
+test('BatchinateLast dispose with abort', () => {
+  const fn = vi.fn();
+  const batchinator = new BatchinateLast(fn, 100);
+
+  batchinator.schedule('First');
+  batchinator.schedule('Second');
+  batchinator.dispose({ abort: true });
+
+  expect(fn).not.toHaveBeenCalled();
+
+  vi.advanceTimersByTime(100);
+  expect(fn).not.toHaveBeenCalled();
+});
+
+test('BatchinateLast inSchedule', () => {
+  const fn = vi.fn();
+  const batchinator = new BatchinateLast(fn, 100);
+
+  expect(batchinator.inSchedule()).toBe(false);
+
+  batchinator.schedule('First');
+  expect(batchinator.inSchedule()).toBe(true);
+
+  batchinator.flush();
+  expect(batchinator.inSchedule()).toBe(false);
+});
+
+test('BatchinateLast inSchedule after dispose', () => {
+  const fn = vi.fn();
+  const batchinator = new BatchinateLast(fn, 100);
+
+  batchinator.schedule('First');
+  expect(batchinator.inSchedule()).toBe(true);
+
+  batchinator.dispose({ abort: true });
+  expect(batchinator.inSchedule()).toBe(false);
+});
+
+test('BatchinateLast with zero delay', () => {
+  const fn = vi.fn();
+  const batchinator = new BatchinateLast(fn, 0);
+
+  batchinator.schedule('First');
+  expect(fn).toHaveBeenCalledTimes(1);
+  expect(fn).toHaveBeenCalledWith('First');
+});
+
+test('BatchinateLast preserves this context', () => {
+  const obj = {
+    value: 42,
+    fn: function (this: any, arg: number) {
+      return this.value + arg;
+    },
+  };
+
+  const batchinator = new BatchinateLast(obj.fn, 100);
+  batchinator.schedule(10);
+
+  vi.advanceTimersByTime(100);
+  // Function executes with correct context
+  expect(obj.value).toBe(42);
+});
+
+test('BatchinateLast multiple rapid calls', () => {
+  const fn = vi.fn();
+  const batchinator = new BatchinateLast(fn, 100);
+
+  for (let i = 0; i < 10; i++) {
+    batchinator.schedule(i);
+  }
+
+  expect(fn).not.toHaveBeenCalled();
+
+  vi.advanceTimersByTime(100);
+  expect(fn).toHaveBeenCalledTimes(1);
+  expect(fn).toHaveBeenCalledWith(9); // Last call
+});
+
+test('BatchinateLast with multiple arguments', () => {
+  const fn = vi.fn();
+  const batchinator = new BatchinateLast(fn, 100);
+
+  batchinator.schedule(1, 'a', true);
+  batchinator.schedule(2, 'b', false);
+  batchinator.schedule(3, 'c', true);
+
+  vi.advanceTimersByTime(100);
+  expect(fn).toHaveBeenCalledTimes(1);
+  expect(fn).toHaveBeenCalledWith(3, 'c', true);
+});
+
+test('BatchinateLast reschedules if new calls during execution', () => {
+  const fn = vi.fn();
+  const batchinator = new BatchinateLast(fn, 100);
+
+  batchinator.schedule('First');
+
+  // Advance time to trigger execution
+  vi.advanceTimersByTime(50);
+  batchinator.schedule('Second'); // New call during wait period
+
+  vi.advanceTimersByTime(50);
+  // Handler executes with 'First', then checks for new calls
+  expect(fn).toHaveBeenCalled();
+
+  // If there were new calls, it should reschedule
+  vi.advanceTimersByTime(100);
+  // Should execute with 'Second'
+  expect(fn.mock.calls.length).toBeGreaterThan(1);
+});
+
+test('BatchinateLast schedule after flush', () => {
+  const fn = vi.fn();
+  const batchinator = new BatchinateLast(fn, 100);
+
+  batchinator.schedule('First');
+  batchinator.flush();
+  expect(fn).toHaveBeenCalledTimes(1);
+
+  batchinator.schedule('Second');
+  vi.advanceTimersByTime(100);
+  expect(fn).toHaveBeenCalledTimes(2);
+  expect(fn).toHaveBeenCalledWith('Second');
+});
+
+test('BatchinateLast schedule after dispose', () => {
+  const fn = vi.fn();
+  const batchinator = new BatchinateLast(fn, 100);
+
+  batchinator.schedule('First');
+  batchinator.dispose({ abort: true });
+  expect(fn).not.toHaveBeenCalled();
+
+  batchinator.schedule('Second');
+  vi.advanceTimersByTime(100);
+  expect(fn).toHaveBeenCalledTimes(1);
+  expect(fn).toHaveBeenCalledWith('Second');
+});
+
+test('BatchinateLast continuous scheduling', () => {
+  const fn = vi.fn();
+  const batchinator = new BatchinateLast(fn, 100);
+
+  batchinator.schedule('First');
+  vi.advanceTimersByTime(50);
+  batchinator.schedule('Second');
+  vi.advanceTimersByTime(50);
+  batchinator.schedule('Third');
+
+  // Should eventually execute with 'Third'
+  vi.advanceTimersByTime(100);
+  expect(fn).toHaveBeenCalled();
+});
+
+test('BatchinateLast flush empty schedule', () => {
+  const fn = vi.fn();
+  const batchinator = new BatchinateLast(fn, 100);
+
+  // Flush without scheduling
+  batchinator.flush();
+  expect(fn).not.toHaveBeenCalled();
+});
+
+test('BatchinateLast dispose empty schedule', () => {
+  const fn = vi.fn();
+  const batchinator = new BatchinateLast(fn, 100);
+
+  // Dispose without scheduling
+  batchinator.dispose();
+  expect(fn).not.toHaveBeenCalled();
+});
+
+test('BatchinateLast flush with empty args after scheduling', () => {
+  const fn = vi.fn();
+  const batchinator = new BatchinateLast(fn, 100);
+
+  batchinator.schedule('First');
+  batchinator.flush(); // No new args provided
+  expect(fn).toHaveBeenCalledTimes(1);
+  expect(fn).toHaveBeenCalledWith('First');
 });