BREAKING CHANGE(watchers): Replace polling-based write stabilization with debounce-based event coalescing and simplify watcher options

2025-12-08 16:06:18 +00:00
parent 5a6d9a2575
commit 097ea96e99
9 changed files with 106 additions and 288 deletions
--- a/ts/watchers/interfaces.ts
+++ b/ts/watchers/interfaces.ts
@@ -26,12 +26,8 @@ export interface IWatcherOptions {
  depth: number;
  /** Whether to follow symbolic links */
  followSymlinks: boolean;
-  /** Stability threshold for write detection (ms) */
-  stabilityThreshold: number;
-  /** Poll interval for write detection (ms) */
-  pollInterval: number;
-  /** Maximum time to wait for write stabilization (ms) */
-  maxWaitTime: number;
+  /** Debounce time in ms - events for the same file within this window are coalesced */
+  debounceMs: number;
 }

 /**