feat(signal): add debounce feature

packages/signal/package.json

@@ -40,6 +40,7 @@
   },
   "dependencies": {
     "@gecut/logger": "workspace:^",
-    "@gecut/types": "workspace:^"
+    "@gecut/types": "workspace:^",
+    "@gecut/utilities": "workspace:^"
   }
 }

packages/signal/src/libraries/_signal.ts

@@ -1,4 +1,5 @@
 import {GecutLogger} from '@gecut/logger';
+import debounce from '@gecut/utilities/debounce.js';
 
 import type {SubscribeOptions, Subscriber} from '../type.js';
 
@@ -20,6 +21,7 @@ export abstract class Signal<T> {
   protected value: T | undefined;
   protected hasDispatched = false;
   protected log: GecutLogger;
+  protected debounceConfig: false | 'AnimationFrame' | 'IdleCallback' | number = false;
 
   /**
    * Unsubscribes a previously registered callback from the signal.
@@ -67,9 +69,10 @@ export abstract class Signal<T> {
     this.hasDispatched = true;
     this.value = newValue;
 
-    setTimeout(() => this.__$dispatch(newValue), 0);
+    this.__$debouncedDispatch(newValue);
   }
 
+  protected __$debouncedDispatch = debounce(this.__$dispatch, this.debounceConfig !== false ? this.debounceConfig : 0);
   protected __$dispatch(newValue: T): void {
     for (const subscriber of this.subscribers) {
       if (subscriber && !subscriber.options.disabled) {

packages/signal/src/libraries/context.ts

@@ -1,8 +1,10 @@
 import {Signal} from './_signal.js';
 
 export class ContextSignal<T> extends Signal<T> {
-  constructor(name: string) {
+  constructor(name: string, debounce: false | 'AnimationFrame' | 'IdleCallback' | number = false) {
     super(name, 'context');
+
+    this.debounceConfig = debounce;
   }
 
   /**

packages/signal/tsconfig.json

@@ -9,5 +9,5 @@
 
   "include": ["src/**/*.ts"],
   "exclude": [],
-  "references": [{"path": "../logger"}, {"path": "../types"}]
+  "references": [{"path": "../logger"}, {"path": "../types"}, {"path": "../utilities"}]
 }