@cadenza.io/core 3.13.3 → 3.15.0

package/dist/index.d.mts

@@ -1000,6 +1000,7 @@ declare class Task extends SignalEmitter implements Graph {
      * @return {any[]} An array containing the results of applying the callback function to each predecessor task.
      */
     mapPrevious(callback: (task: Task) => any): any[];
+    makeRoutine(name: string, description: string): this;
     /**
      * Adds the specified signals to the current instance, making it observe them.
      * If the instance is already observing a signal, it will be skipped.
@@ -1027,11 +1028,10 @@ declare class Task extends SignalEmitter implements Graph {
     /**
      * Attaches a signal to the current context and emits metadata if the register flag is set.
      *
-     * @param {string} signal - The name of the signal to attach.
-     * @param {boolean} [isOnFail=false] - Indicates if the signal should be marked as "on fail".
+     * @param {...string} signals - The names of the signals to attach.
      * @return {void} This method does not return a value.
      */
-    attachSignal(signal: string, isOnFail?: boolean): void;
+    attachSignal(...signals: string[]): Task;
     /**
      * Unsubscribes the current instance from the specified signals.
      * This method removes the signals from the observedSignals set, unsubscribes
@@ -1358,7 +1358,6 @@ declare class GraphRunner extends SignalEmitter {
      * @edge Creates 'Start run' meta-task chained to registry gets.
      */
     constructor(isMeta?: boolean);
-    init(): void;
     /**
      * Adds tasks or routines to the current execution pipeline. Supports both individual tasks,
      * routines, or arrays of tasks and routines. Handles metadata and execution context management.
@@ -1405,7 +1404,6 @@ declare class GraphRunner extends SignalEmitter {
      * @return {void}
      */
     setStrategy(strategy: GraphRunStrategy): void;
-    startRun(context: AnyObject, emit: (signal: string, ctx: AnyObject) => void): boolean;
 }
 
 /**
@@ -1431,6 +1429,7 @@ declare class SignalBroker {
     validateSignalName(signalName: string): void;
     runner: GraphRunner | undefined;
     metaRunner: GraphRunner | undefined;
+    debouncedEmitters: Map<string, any>;
     clearSignalsTask: Task | undefined;
     getSignalsTask: Task | undefined;
     registerSignalTask: Task | undefined;
@@ -1439,6 +1438,7 @@ declare class SignalBroker {
         tasks: Set<Task | GraphRoutine>;
         registered: boolean;
     }>;
+    emittedSignalsRegistry: Set<string>;
     emitStacks: Map<string, Map<string, AnyObject>>;
     constructor();
     /**
@@ -1460,6 +1460,7 @@ declare class SignalBroker {
      * @edge Duplicates ignored; supports wildcards for broad listening.
      */
     observe(signal: string, routineOrTask: Task | GraphRoutine): void;
+    registerEmittedSignal(signal: string): void;
     /**
      * Unsubscribes a routine/task from a signal.
      * @param signal The signal.
@@ -1488,6 +1489,7 @@ declare class SignalBroker {
      * @returns a handle with `clear()` to stop the loop.
      */
     throttle(signal: string, context: AnyObject, intervalMs?: number, leading?: boolean, startDateTime?: Date): ThrottleHandle;
+    debounce(signal: string, context: any, delayMs?: number): void;
     /**
      * Emits a signal with the specified context, triggering any associated handlers for that signal.
      *
@@ -1532,6 +1534,7 @@ declare class SignalBroker {
      * @returns Array of signals.
      */
     listObservedSignals(): string[];
+    listEmittedSignals(): string[];
     reset(): void;
 }
 
@@ -1804,6 +1807,7 @@ declare class Cadenza {
     static emit(event: string, data?: AnyObject): void;
     static schedule(taskName: string, context: AnyObject, timeoutMs: number, exactDateTime?: Date): void;
     static throttle(taskName: string, context: AnyObject, intervalMs: number, leading?: boolean, startDateTime?: Date): void;
+    static debounce(signalName: string, context: any, delayMs: number): void;
     static get(taskName: string): Task | undefined;
     /**
      * Creates and registers a new task with the specified parameters and options.

package/dist/index.d.ts

@@ -1000,6 +1000,7 @@ declare class Task extends SignalEmitter implements Graph {
      * @return {any[]} An array containing the results of applying the callback function to each predecessor task.
      */
     mapPrevious(callback: (task: Task) => any): any[];
+    makeRoutine(name: string, description: string): this;
     /**
      * Adds the specified signals to the current instance, making it observe them.
      * If the instance is already observing a signal, it will be skipped.
@@ -1027,11 +1028,10 @@ declare class Task extends SignalEmitter implements Graph {
     /**
      * Attaches a signal to the current context and emits metadata if the register flag is set.
      *
-     * @param {string} signal - The name of the signal to attach.
-     * @param {boolean} [isOnFail=false] - Indicates if the signal should be marked as "on fail".
+     * @param {...string} signals - The names of the signals to attach.
      * @return {void} This method does not return a value.
      */
-    attachSignal(signal: string, isOnFail?: boolean): void;
+    attachSignal(...signals: string[]): Task;
     /**
      * Unsubscribes the current instance from the specified signals.
      * This method removes the signals from the observedSignals set, unsubscribes
@@ -1358,7 +1358,6 @@ declare class GraphRunner extends SignalEmitter {
      * @edge Creates 'Start run' meta-task chained to registry gets.
      */
     constructor(isMeta?: boolean);
-    init(): void;
     /**
      * Adds tasks or routines to the current execution pipeline. Supports both individual tasks,
      * routines, or arrays of tasks and routines. Handles metadata and execution context management.
@@ -1405,7 +1404,6 @@ declare class GraphRunner extends SignalEmitter {
      * @return {void}
      */
     setStrategy(strategy: GraphRunStrategy): void;
-    startRun(context: AnyObject, emit: (signal: string, ctx: AnyObject) => void): boolean;
 }
 
 /**
@@ -1431,6 +1429,7 @@ declare class SignalBroker {
     validateSignalName(signalName: string): void;
     runner: GraphRunner | undefined;
     metaRunner: GraphRunner | undefined;
+    debouncedEmitters: Map<string, any>;
     clearSignalsTask: Task | undefined;
     getSignalsTask: Task | undefined;
     registerSignalTask: Task | undefined;
@@ -1439,6 +1438,7 @@ declare class SignalBroker {
         tasks: Set<Task | GraphRoutine>;
         registered: boolean;
     }>;
+    emittedSignalsRegistry: Set<string>;
     emitStacks: Map<string, Map<string, AnyObject>>;
     constructor();
     /**
@@ -1460,6 +1460,7 @@ declare class SignalBroker {
      * @edge Duplicates ignored; supports wildcards for broad listening.
      */
     observe(signal: string, routineOrTask: Task | GraphRoutine): void;
+    registerEmittedSignal(signal: string): void;
     /**
      * Unsubscribes a routine/task from a signal.
      * @param signal The signal.
@@ -1488,6 +1489,7 @@ declare class SignalBroker {
      * @returns a handle with `clear()` to stop the loop.
      */
     throttle(signal: string, context: AnyObject, intervalMs?: number, leading?: boolean, startDateTime?: Date): ThrottleHandle;
+    debounce(signal: string, context: any, delayMs?: number): void;
     /**
      * Emits a signal with the specified context, triggering any associated handlers for that signal.
      *
@@ -1532,6 +1534,7 @@ declare class SignalBroker {
      * @returns Array of signals.
      */
     listObservedSignals(): string[];
+    listEmittedSignals(): string[];
     reset(): void;
 }
 
@@ -1804,6 +1807,7 @@ declare class Cadenza {
     static emit(event: string, data?: AnyObject): void;
     static schedule(taskName: string, context: AnyObject, timeoutMs: number, exactDateTime?: Date): void;
     static throttle(taskName: string, context: AnyObject, intervalMs: number, leading?: boolean, startDateTime?: Date): void;
+    static debounce(signalName: string, context: any, delayMs: number): void;
     static get(taskName: string): Task | undefined;
     /**
      * Creates and registers a new task with the specified parameters and options.