feat(macro): Support cancelling debounced calls

Sources/interfaces.d.ts

@@ -16,6 +16,14 @@ export interface vtkRange {
 	max: number;
 }
 
+/**
+ * Represents a debounced function.
+ */
+export interface vtkDebouncedFunction {
+  (...args: any) : any;
+  cancel() : void;
+}
+
 export interface vtkOutputPort {
 	filter: vtkAlgorithm;
 }

Sources/macro.d.ts

@@ -1,4 +1,4 @@
-import { vtkSubscription, vtkProperty, vtkPropertyDomain } from "./interfaces";
+import { vtkSubscription, vtkDebouncedFunction, vtkProperty, vtkPropertyDomain } from "./interfaces";
 
 /**
  * Allow user to redefine vtkXXXMacro method call.
@@ -305,8 +305,10 @@ export function traverseInstanceTree(
  * @param func
  * @param wait
  * @param immediate (default false)
+ * @returns vtkDebouncedFunction A debounced function that can be called.
+ *          Use .cancel() to clear any pending debounced call.
  */
-export function debounce(func: (...args: any) => any, wait: number, immediate?: boolean): (...args: any) => any;
+export function debounce(func: (...args: any) => any, wait: number, immediate?: boolean): vtkDebouncedFunction;
 
 /**
  * Creates a throttled function that only invokes `func` at most once per

Sources/macro.js

@@ -985,7 +985,7 @@ export function traverseInstanceTree(
 
 export function debounce(func, wait, immediate) {
   let timeout;
-  return (...args) => {
+  const debounced = (...args) => {
     const context = this;
     const later = () => {
       timeout = null;
@@ -1000,6 +1000,10 @@ export function debounce(func, wait, immediate) {
       func.apply(context, args);
     }
   };
+
+  debounced.cancel = () => clearTimeout(timeout);
+
+  return debounced;
 }
 
 // ----------------------------------------------------------------------------