@gesslar/actioneer 2.2.0 → 2.3.1

package/src/browser/lib/Activity.js

@@ -1,6 +1,10 @@
 import {Data} from "@gesslar/toolkit"
 
-/** @typedef {import("./ActionHooks.js").default} ActionHooks */
+/**
+ * @import {default as ActionBuilder} from "./ActionBuilder.js"
+ * @import {default as ActionHooks} from "./ActionHooks.js"
+ * @import {default as ActionWrapper} from "./ActionWrapper.js"
+ **/
 
 /**
  * Activity bit flags recognised by the builder. The flag decides
@@ -29,13 +33,13 @@ export default class Activity {
   #action = null
   /** @type {unknown} */
   #context = null
-  /** @type {ActionHooks|null} */
+  /** @type {ActionHooks?} */
   #hooks = null
-  /** @type {number|null} */
+  /** @type {number?} */
   #kind = null
   /** @type {string|symbol} */
   #name = null
-  /** @type {((context: unknown) => unknown|Promise<unknown>)|import("./ActionBuilder.js").default} */
+  /** @type {((context: unknown) => unknown|Promise<unknown>)|ActionBuilder} */
   #op = null
   /** @type {((context: unknown) => boolean|Promise<boolean>)|null} */
   #pred = null
@@ -43,7 +47,7 @@ export default class Activity {
   #rejoiner = null
   /** @type {((context: unknown) => unknown)|null} */
   #splitter = null
-  /** @type {import("./ActionWrapper.js").default|null} */
+  /** @type {ActionWrapper?} */
   #wrapper = null
   /** @type {symbol} */
   #id = Symbol(performance.now())
@@ -54,13 +58,13 @@ export default class Activity {
    * @param {object} init - Initial properties describing the activity operation, loop semantics, and predicate
    * @param {unknown} init.action - Parent action instance
    * @param {string|symbol} init.name - Activity identifier
-   * @param {(context: unknown) => unknown|Promise<unknown>|import("./ActionBuilder.js").default} init.op - Operation to execute
+   * @param {(context: unknown) => unknown|Promise<unknown>|ActionBuilder} init.op - Operation to execute
    * @param {number} [init.kind] - Optional loop semantics flags
    * @param {(context: unknown) => boolean|Promise<boolean>} [init.pred] - Optional predicate for WHILE/UNTIL
    * @param {ActionHooks} [init.hooks] - Optional hooks instance
    * @param {(context: unknown) => unknown} [init.splitter] - Optional splitter function for SPLIT activities
    * @param {(originalContext: unknown, splitResults: unknown) => unknown} [init.rejoiner] - Optional rejoiner function for SPLIT activities
-   * @param {import("./ActionWrapper.js").default} [init.wrapper] - Optional wrapper containing this activity
+   * @param {ActionWrapper} [init.wrapper] - Optional wrapper containing this activity
    */
   constructor({action,name,op,kind,pred,hooks,splitter,rejoiner,wrapper}) {
     this.#action = action
@@ -131,7 +135,7 @@ export default class Activity {
   /**
    * The operator to execute (function or nested ActionBuilder).
    *
-   * @returns {(context: unknown) => unknown|Promise<unknown>|import("./ActionBuilder.js").default} - Activity operation
+   * @returns {(context: unknown) => unknown|Promise<unknown>|ActionBuilder} - Activity operation
    */
   get op() {
     return this.#op
@@ -140,7 +144,7 @@ export default class Activity {
   /**
    * The splitter function for SPLIT activities.
    *
-   * @returns {((context: unknown) => unknown)|null} Splitter function or null
+   * @returns {((context: unknown) => unknown)?} Splitter function or null
    */
   get splitter() {
     return this.#splitter
@@ -149,7 +153,7 @@ export default class Activity {
   /**
    * The rejoiner function for SPLIT activities.
    *
-   * @returns {((originalContext: unknown, splitResults: unknown) => unknown)|null} Rejoiner function or null
+   * @returns {((originalContext: unknown, splitResults: unknown) => unknown)?} Rejoiner function or null
    */
   get rejoiner() {
     return this.#rejoiner
@@ -168,7 +172,7 @@ export default class Activity {
    * Get the ActionWrapper containing this activity.
    * Used by BREAK/CONTINUE to signal the parent loop.
    *
-   * @returns {import("./ActionWrapper.js").default|null} The wrapper or null
+   * @returns {ActionWrapper?} The wrapper or null
    */
   get wrapper() {
     return this.#wrapper ?? null
@@ -209,7 +213,7 @@ export default class Activity {
   /**
    * Get the hooks instance attached to this activity.
    *
-   * @returns {ActionHooks|null} The hooks instance or null
+   * @returns {ActionHooks?} The hooks instance or null
    */
   get hooks() {
     return this.#hooks

package/src/browser/lib/Piper.js

@@ -9,10 +9,12 @@
  * - Error handling and reporting
  */
 
-import {Promised, Sass, Tantrum} from "@gesslar/toolkit"
+import {Data, Disposer, NotifyClass, Promised, Sass, Tantrum} from "@gesslar/toolkit"
 
-export default class Piper {
+export default class Piper extends NotifyClass {
   #debug
+  #disposer = Disposer
+  #abortedReason
 
   #lifeCycle = new Map([
     ["setup", new Set()],
@@ -23,18 +25,32 @@ export default class Piper {
   /**
    * Create a Piper instance.
    *
-   * @param {{debug?: (message: string, level?: number, ...args: Array<unknown>) => void}} [config] Optional configuration with debug function
+   * @param {{debug?: (message: string, level?: number, ...args: Array<unknown>) => void}} [config] - Optional configuration with debug function
    */
   constructor({debug = (() => {})} = {}) {
+    super()
+
     this.#debug = debug
+
+    this.#disposer.register(
+      this.on("abort", this.#abortCalled.bind(this))
+    )
+  }
+
+  #abortCalled(reason) {
+    this.#abortedReason = reason
+  }
+
+  get reason() {
+    return this.#abortedReason
   }
 
   /**
    * Add a processing step to the pipeline
    *
-   * @param {(context: unknown) => Promise<unknown>|unknown} fn Function that processes an item
-   * @param {{name?: string, required?: boolean}} [options] Step options
-   * @param {unknown} [newThis] Optional this binding
+   * @param {(context: unknown) => Promise<unknown>|unknown} fn - Function that processes an item
+   * @param {{name?: string, required?: boolean}} [options] - Step options
+   * @param {unknown} [newThis] - Optional this binding
    * @returns {Piper} The pipeline instance (for chaining)
    */
   addStep(fn, options = {}, newThis) {
@@ -90,7 +106,7 @@ export default class Piper {
     const allResults = new Array(items.length)
 
     const processWorker = async() => {
-      while(true) {
+      while(true && !this.reason) {
         const currentIndex = itemIndex++
 
         if(currentIndex >= items.length)
@@ -101,7 +117,10 @@ export default class Piper {
         try {
           const result = await this.#processItem(item)
 
-          allResults[currentIndex] = {status: "fulfilled", value: result}
+          if(Data.isType(result, "Error"))
+            allResults[currentIndex] = {status: "rejected", reason: result}
+          else
+            allResults[currentIndex] = {status: "fulfilled", value: result}
         } catch(error) {
           allResults[currentIndex] = {status: "rejected", reason: error}
         }
@@ -133,30 +152,31 @@ export default class Piper {
       this.#processResult("Tearing down the pipeline.", teardownResult)
     }
 
+    if(this.reason)
+      this.emit("aborted", this.reason)
+
     return allResults
   }
 
   /**
    * Validate settleAll results and throw a combined error when rejected.
    *
-   * @param {string} message Context message
-   * @param {Array<unknown>} settled Results from settleAll
    * @private
+   * @param {string} message - Context message
+   * @param {Array<unknown>} settled - Results from settleAll
+   * @throws {Tantrum} - If any rejected
    */
   #processResult(message, settled) {
-    if(settled.some(r => r.status === "rejected"))
-      throw Tantrum.new(
-        message,
-        settled.filter(r => r.status==="rejected").map(r => r.reason)
-      )
+    if(Promised.hasRejected(settled))
+      Promised.throw(settled)
   }
 
   /**
    * Process a single item through all pipeline steps
    *
-   * @param {unknown} item The item to process
-   * @returns {Promise<unknown>} Result from the final step
    * @private
+   * @param {unknown} item - The item to process
+   * @returns {Promise<unknown>} Result from the final step
    */
   async #processItem(item) {
     // Execute each step in sequence

package/src/types/browser/lib/ActionBuilder.d.ts

@@ -1,28 +1,26 @@
-/** @typedef {import("./ActionRunner.js").default} ActionRunner */
-/** @typedef {typeof import("./Activity.js").ACTIVITY} ActivityFlags */
 /**
+ * Type imports and definitions.
+ *
+ * @import {default as ActionRunner} from "./ActionRunner.js"
+ *
  * @typedef {(message: string, level?: number, ...args: Array<unknown>) => void} DebugFn
- */
-/**
+ *
  * @typedef {object} ActionBuilderAction
- * @property {(builder: ActionBuilder) => void} setup Function invoked during {@link ActionBuilder#build} to register activities.
- * @property {symbol} [tag] Optional tag to reuse when reconstructing builders.
- */
-/**
+ * @property {(builder: ActionBuilder) => void} setup - Function invoked during {@link ActionBuilder} to register activities.
+ * @property {symbol} [tag] - Optional tag to reuse when reconstructing builders.
+ *
  * @typedef {object} ActionBuilderConfig
- * @property {symbol} [tag] Optional tag for the builder instance.
- * @property {DebugFn} [debug] Logger used by the pipeline internals.
- */
-/**
+ * @property {symbol} [tag] - Optional tag for the builder instance.
+ * @property {DebugFn} [debug] - Logger used by the pipeline internals.
+ *
  * @typedef {object} ActivityDefinition
- * @property {ActionBuilderAction|null} action Parent action instance when available.
- * @property {DebugFn|null} debug Logger function.
- * @property {string|symbol} name Activity identifier.
- * @property {ActionFunction|import("./ActionWrapper.js").default} op Operation to execute.
- * @property {number} [kind] Optional kind flags from {@link ActivityFlags}.
- * @property {(context: unknown) => boolean|Promise<boolean>} [pred] Loop predicate.
- */
-/**
+ * @property {ActionBuilderAction|null} action - Parent action instance when available.
+ * @property {DebugFn|null} debug - Logger function.
+ * @property {string|symbol} name - Activity identifier.
+ * @property {ActionFunction|import("./ActionWrapper.js").default} op - Operation to execute.
+ * @property {number} [kind] - Optional kind flags from {@link ACTIVITY}.
+ * @property {(context: unknown) => boolean|Promise<boolean>} [pred] - Loop predicate.
+ *
  * @typedef {(context: unknown) => unknown|Promise<unknown>} ActionFunction
  */
 /**
@@ -49,8 +47,8 @@ export default class ActionBuilder {
     /**
      * Creates a new ActionBuilder instance with the provided action callback.
      *
-     * @param {ActionBuilderAction} [action] Base action invoked by the runner when a block satisfies the configured structure.
-     * @param {ActionBuilderConfig} [config] Options
+     * @param {ActionBuilderAction} [action] - Base action invoked by the runner when a block satisfies the configured structure.
+     * @param {ActionBuilderConfig} [config] - Options
      */
     constructor(action?: ActionBuilderAction, { tag, debug }?: ActionBuilderConfig);
     get tag(): symbol | null;
@@ -64,67 +62,67 @@ export default class ActionBuilder {
      * - do(name, kind, splitter, rejoiner, opOrWrapper) - SPLIT with parallel execution
      *
      * @overload
-     * @param {string|symbol} name Activity name
-     * @param {ActionFunction} op Operation to execute once.
+     * @param {string|symbol} name - Activity name
+     * @param {ActionFunction} op - Operation to execute once.
      * @returns {ActionBuilder}
      */
     do(name: string | symbol, op: ActionFunction): ActionBuilder;
     /**
      * @overload
-     * @param {string|symbol} name Activity name
-     * @param {number} kind ACTIVITY.BREAK or ACTIVITY.CONTINUE flag.
-     * @param {(context: unknown) => boolean|Promise<boolean>} pred Predicate to evaluate for control flow.
+     * @param {string|symbol} name - Activity name
+     * @param {number} kind - ACTIVITY.BREAK or ACTIVITY.CONTINUE flag.
+     * @param {(context: unknown) => boolean|Promise<boolean>} pred - Predicate to evaluate for control flow.
      * @returns {ActionBuilder}
      */
     do(name: string | symbol, kind: number, pred: (context: unknown) => boolean | Promise<boolean>): ActionBuilder;
     /**
      * @overload
-     * @param {string|symbol} name Activity name
-     * @param {number} kind Activity kind (WHILE, UNTIL, or IF) from {@link ActivityFlags}.
-     * @param {(context: unknown) => boolean|Promise<boolean>} pred Predicate executed before/after the op.
-     * @param {ActionFunction|ActionBuilder} op Operation or nested builder to execute.
+     * @param {string|symbol} name - Activity name
+     * @param {number} kind - Activity kind (WHILE, UNTIL, or IF) from {@link ACTIVITY}.
+     * @param {(context: unknown) => boolean|Promise<boolean>} pred - Predicate executed before/after the op.
+     * @param {ActionFunction|ActionBuilder} op - Operation or nested builder to execute.
      * @returns {ActionBuilder}
      */
     do(name: string | symbol, kind: number, pred: (context: unknown) => boolean | Promise<boolean>, op: ActionFunction | ActionBuilder): ActionBuilder;
     /**
      * @overload
-     * @param {string|symbol} name Activity name
-     * @param {number} kind ACTIVITY.SPLIT flag.
-     * @param {(context: unknown) => unknown} splitter Splitter function for SPLIT mode.
-     * @param {(originalContext: unknown, splitResults: unknown) => unknown} rejoiner Rejoiner function for SPLIT mode.
-     * @param {ActionFunction|ActionBuilder} op Operation or nested builder to execute.
+     * @param {string|symbol} name - Activity name
+     * @param {number} kind - ACTIVITY.SPLIT flag.
+     * @param {(context: unknown) => unknown} splitter - Splitter function for SPLIT mode.
+     * @param {(originalContext: unknown, splitResults: unknown) => unknown} rejoiner - Rejoiner function for SPLIT mode.
+     * @param {ActionFunction|ActionBuilder} op - Operation or nested builder to execute.
      * @returns {ActionBuilder}
      */
     do(name: string | symbol, kind: number, splitter: (context: unknown) => unknown, rejoiner: (originalContext: unknown, splitResults: unknown) => unknown, op: ActionFunction | ActionBuilder): ActionBuilder;
     /**
      * Configure hooks to be loaded from a file when the action is built.
      *
-     * @param {string} hooksFile Path to the hooks module file.
-     * @param {string} hooksKind Name of the exported hooks class to instantiate.
-     * @returns {ActionBuilder} The builder instance for chaining.
+     * @param {string} hooksFile - Path to the hooks module file.
+     * @param {string} hooksKind - Name of the exported hooks class to instantiate.
+     * @returns {ActionBuilder} - The builder instance for chaining.
      * @throws {Sass} If hooks have already been configured.
      */
     withHooksFile(hooksFile: string, hooksKind: string): ActionBuilder;
     /**
      * Configure hooks using a pre-instantiated hooks object.
      *
-     * @param {import("./ActionHooks.js").default} hooks An already-instantiated hooks instance.
-     * @returns {ActionBuilder} The builder instance for chaining.
+     * @param {ActionHooks} hooks - An already-instantiated hooks instance.
+     * @returns {ActionBuilder} - The builder instance for chaining.
      * @throws {Sass} If hooks have already been configured with a different instance.
      */
-    withHooks(hooks: import("./ActionHooks.js").default): ActionBuilder;
+    withHooks(hooks: ActionHooks): ActionBuilder;
     /**
      * Configure the action instance if not already set.
      * Used to propagate parent action context to nested builders.
      *
-     * @param {ActionBuilderAction} action The action instance to inherit.
+     * @param {ActionBuilderAction} action - The action instance to inherit.
      * @returns {ActionBuilder} The builder instance for chaining.
      */
     withAction(action: ActionBuilderAction): ActionBuilder;
     /**
      * Register a callback to be executed after all activities complete.
      *
-     * @param {ActionFunction} callback Function to execute at the end of the pipeline.
+     * @param {ActionFunction} callback - Function to execute at the end of the pipeline.
      * @returns {ActionBuilder} The builder instance for chaining.
      */
     done(callback: ActionFunction): ActionBuilder;
@@ -132,59 +130,74 @@ export default class ActionBuilder {
      * Finalises the builder and returns a payload that can be consumed by the
      * runner.
      *
-     * @returns {Promise<import("./ActionWrapper.js").default>} Payload consumed by the {@link ActionRunner} constructor.
+     * @returns {Promise<ActionWrapper>} Payload consumed by the {@link ActionRunner} constructor.
      */
-    build(): Promise<import("./ActionWrapper.js").default>;
+    build(runner: any): Promise<ActionWrapper>;
     #private;
 }
-export type ActionRunner = import("./ActionRunner.js").default;
-export type ActivityFlags = typeof import("./Activity.js").ACTIVITY;
+/**
+ * Type imports and definitions.
+ */
 export type DebugFn = (message: string, level?: number, ...args: Array<unknown>) => void;
+/**
+ * Type imports and definitions.
+ */
 export type ActionBuilderAction = {
     /**
-     * Function invoked during {@link ActionBuilder#build} to register activities.
+     * - Function invoked during {@link ActionBuilder} to register activities.
      */
     setup: (builder: ActionBuilder) => void;
     /**
-     * Optional tag to reuse when reconstructing builders.
+     * - Optional tag to reuse when reconstructing builders.
      */
     tag?: symbol | undefined;
 };
+/**
+ * Type imports and definitions.
+ */
 export type ActionBuilderConfig = {
     /**
-     * Optional tag for the builder instance.
+     * - Optional tag for the builder instance.
      */
     tag?: symbol | undefined;
     /**
-     * Logger used by the pipeline internals.
+     * - Logger used by the pipeline internals.
      */
     debug?: DebugFn | undefined;
 };
+/**
+ * Type imports and definitions.
+ */
 export type ActivityDefinition = {
     /**
-     * Parent action instance when available.
+     * - Parent action instance when available.
      */
     action: ActionBuilderAction | null;
     /**
-     * Logger function.
+     * - Logger function.
      */
     debug: DebugFn | null;
     /**
-     * Activity identifier.
+     * - Activity identifier.
      */
     name: string | symbol;
     /**
-     * Operation to execute.
+     * - Operation to execute.
      */
     op: ActionFunction | import("./ActionWrapper.js").default;
     /**
-     * Optional kind flags from {@link ActivityFlags}.
+     * - Optional kind flags from {@link ACTIVITY}.
      */
     kind?: number | undefined;
     /**
-     * Loop predicate.
+     * - Loop predicate.
      */
     pred?: ((context: unknown) => boolean | Promise<boolean>) | undefined;
 };
+/**
+ * Type imports and definitions.
+ */
 export type ActionFunction = (context: unknown) => unknown | Promise<unknown>;
+import ActionHooks from "./ActionHooks.js";
+import ActionWrapper from "./ActionWrapper.js";
 //# sourceMappingURL=ActionBuilder.d.ts.map

package/src/types/browser/lib/ActionBuilder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ActionBuilder.d.ts","sourceRoot":"","sources":["../../../browser/lib/ActionBuilder.js"],"names":[],"mappings":"AAMA,kEAAkE;AAClE,uEAAuE;AAEvE;;GAEG;AAEH;;;;GAIG;AAEH;;;;GAIG;AAEH;;;;;;;;GAQG;AAEH;;GAEG;AAEH;;;;;;;;;;;;;;;;;;;GAmBG;AACH;IAkBE;;;;;OAKG;IACH,qBAHW,mBAAmB,mBACnB,mBAAmB,EAe7B;IAED,yBAEC;;;;;;;;;;;;;;;IAWE,SACQ,MAAM,GAAC,MAAM,MACb,cAAc,GACZ,aAAa,CACzB;;;;;;;;IAGE,SACQ,MAAM,GAAC,MAAM,QACb,MAAM,QACN,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,GAAC,OAAO,CAAC,OAAO,CAAC,GAC5C,aAAa,CACzB;;;;;;;;;IAGE,SACQ,MAAM,GAAC,MAAM,QACb,MAAM,QACN,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,GAAC,OAAO,CAAC,OAAO,CAAC,MAC9C,cAAc,GAAC,aAAa,GAC1B,aAAa,CACzB;;;;;;;;;;IAGE,SACQ,MAAM,GAAC,MAAM,QACb,MAAM,YACN,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,YAC7B,CAAC,eAAe,EAAE,OAAO,EAAE,YAAY,EAAE,OAAO,KAAK,OAAO,MAC5D,cAAc,GAAC,aAAa,GAC1B,aAAa,CACzB;IAkED;;;;;;;OAOG;IACH,yBALW,MAAM,aACN,MAAM,GACJ,aAAa,CAYzB;IAED;;;;;;OAMG;IACH,iBAJW,OAAO,kBAAkB,EAAE,OAAO,GAChC,aAAa,CAgBzB;IAED;;;;;;OAMG;IACH,mBAHW,mBAAmB,GACjB,aAAa,CAczB;IAED;;;;;OAKG;IACH,eAHW,cAAc,GACZ,aAAa,CAOzB;IAeD;;;;;OAKG;IACH,SAFa,OAAO,CAAC,OAAO,oBAAoB,EAAE,OAAO,CAAC,CAqBzD;;CAqBF;2BAhVa,OAAO,mBAAmB,EAAE,OAAO;4BACnC,cAAc,eAAe,EAAE,QAAQ;sBAGxC,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,KAAK,IAAI;;;;;WAKjE,CAAC,OAAO,EAAE,aAAa,KAAK,IAAI;;;;;;;;;;;;;;;;;;;;YAYhC,mBAAmB,GAAC,IAAI;;;;WACxB,OAAO,GAAC,IAAI;;;;UACZ,MAAM,GAAC,MAAM;;;;QACb,cAAc,GAAC,OAAO,oBAAoB,EAAE,OAAO;;;;;;;;sBAEzC,OAAO,KAAK,OAAO,GAAC,OAAO,CAAC,OAAO,CAAC;;6BAI/C,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,GAAC,OAAO,CAAC,OAAO,CAAC"}
+{"version":3,"file":"ActionBuilder.d.ts","sourceRoot":"","sources":["../../../browser/lib/ActionBuilder.js"],"names":[],"mappings":"AAMA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH;;;;;;;;;;;;;;;;;;;GAmBG;AACH;IAkBE;;;;;OAKG;IACH,qBAHW,mBAAmB,mBACnB,mBAAmB,EAkB7B;IAED,yBAEC;;;;;;;;;;;;;;;IAWE,SACQ,MAAM,GAAC,MAAM,MACb,cAAc,GACZ,aAAa,CACzB;;;;;;;;IAGE,SACQ,MAAM,GAAC,MAAM,QACb,MAAM,QACN,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,GAAC,OAAO,CAAC,OAAO,CAAC,GAC5C,aAAa,CACzB;;;;;;;;;IAGE,SACQ,MAAM,GAAC,MAAM,QACb,MAAM,QACN,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,GAAC,OAAO,CAAC,OAAO,CAAC,MAC9C,cAAc,GAAC,aAAa,GAC1B,aAAa,CACzB;;;;;;;;;;IAGE,SACQ,MAAM,GAAC,MAAM,QACb,MAAM,YACN,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,YAC7B,CAAC,eAAe,EAAE,OAAO,EAAE,YAAY,EAAE,OAAO,KAAK,OAAO,MAC5D,cAAc,GAAC,aAAa,GAC1B,aAAa,CACzB;IAkED;;;;;;;OAOG;IACH,yBALW,MAAM,aACN,MAAM,GACJ,aAAa,CAYzB;IAED;;;;;;OAMG;IACH,iBAJW,WAAW,GACT,aAAa,CAgBzB;IAED;;;;;;OAMG;IACH,mBAHW,mBAAmB,GACjB,aAAa,CAczB;IAED;;;;;OAKG;IACH,eAHW,cAAc,GACZ,aAAa,CAOzB;IAeD;;;;;OAKG;IACH,oBAFa,OAAO,CAAC,aAAa,CAAC,CAoClC;;CAqBF;;;;sBAtVY,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,KAAK,IAAI;;;;;;;;WAGjE,CAAC,OAAO,EAAE,aAAa,KAAK,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;YAQhC,mBAAmB,GAAC,IAAI;;;;WACxB,OAAO,GAAC,IAAI;;;;UACZ,MAAM,GAAC,MAAM;;;;QACb,cAAc,GAAC,OAAO,oBAAoB,EAAE,OAAO;;;;;;;;sBAEzC,OAAO,KAAK,OAAO,GAAC,OAAO,CAAC,OAAO,CAAC;;;;;6BAE/C,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,GAAC,OAAO,CAAC,OAAO,CAAC;wBA1BnC,kBAAkB;0BADhB,oBAAoB"}

package/src/types/browser/lib/ActionHooks.d.ts

@@ -1,15 +1,14 @@
 /**
  * @typedef {(message: string, level?: number, ...args: Array<unknown>) => void} DebugFn
  */
-/**
- * @typedef {object} ActionHooksConfig
- * @property {string} actionKind Action identifier shared between runner and hooks.
- * @property {unknown} hooks Already-instantiated hooks implementation.
- * @property {number} [hookTimeout] Timeout applied to hook execution in milliseconds.
- * @property {DebugFn} debug Logger to emit diagnostics.
- */
 /**
  * @typedef {Record<string, (context: unknown) => Promise<unknown>|unknown>} HookModule
+ *
+ * @typedef {object} ActionHooksConfig
+ * @property {string} actionKind - Action identifier shared between runner and hooks.
+ * @property {unknown} hooks - Already-instantiated hooks implementation.
+ * @property {number} [hookTimeout] - Timeout applied to hook execution in milliseconds.
+ * @property {DebugFn} debug - Logger to emit diagnostics.
  */
 /**
  * Generic base class for managing hooks with configurable event types.
@@ -23,15 +22,15 @@ export default class ActionHooks {
      * Static factory method to create and initialize a hook manager.
      * Browser version: Only works with pre-instantiated hooks passed via config.hooks.
      *
-     * @param {ActionHooksConfig} config Configuration object with hooks property
-     * @param {DebugFn} debug The debug function.
-     * @returns {Promise<ActionHooks|null>} Initialized hook manager or null if no hooks provided
+     * @param {ActionHooksConfig} config - Configuration object with hooks property
+     * @param {DebugFn} debug - The debug function.
+     * @returns {Promise<ActionHooks?>} Initialized hook manager or null if no hooks provided
      */
     static "new"(config: ActionHooksConfig, debug: DebugFn): Promise<ActionHooks | null>;
     /**
      * Creates a new ActionHook instance.
      *
-     * @param {ActionHooksConfig} config Configuration values describing how to load the hooks.
+     * @param {ActionHooksConfig} config - Configuration values describing how to load the hooks.
      */
     constructor({ actionKind, hooks, hookTimeout, debug }: ActionHooksConfig);
     /**
@@ -43,7 +42,7 @@ export default class ActionHooks {
     /**
      * Gets the loaded hooks object.
      *
-     * @returns {object|null} Hooks object or null if not loaded
+     * @returns {object?} Hooks object or null if not loaded
      */
     get hooks(): object | null;
     /**
@@ -55,44 +54,44 @@ export default class ActionHooks {
     /**
      * Gets the setup hook function if available.
      *
-     * @returns {(args: object) => unknown|null} Setup hook function or null
+     * @returns {(args: object) => unknown} Setup hook function or null
      */
-    get setup(): (args: object) => unknown | null;
+    get setup(): (args: object) => unknown;
     /**
      * Gets the cleanup hook function if available.
      *
-     * @returns {(args: object) => unknown|null} Cleanup hook function or null
+     * @returns {(args: object) => unknown} Cleanup hook function or null
      */
-    get cleanup(): (args: object) => unknown | null;
+    get cleanup(): (args: object) => unknown;
     /**
      * Invoke a dynamically-named hook such as `before$foo`.
      *
-     * @param {'before'|'after'|'setup'|'cleanup'|string} kind Hook namespace.
-     * @param {string|symbol} activityName Activity identifier.
-     * @param {unknown} context Pipeline context supplied to the hook.
+     * @param {string} kind - Hook namespace.
+     * @param {string|symbol} activityName - Activity identifier.
+     * @param {unknown} context - Pipeline context supplied to the hook.
      * @returns {Promise<void>}
      */
-    callHook(kind: "before" | "after" | "setup" | "cleanup" | string, activityName: string | symbol, context: unknown): Promise<void>;
+    callHook(kind: string, activityName: string | symbol, context: unknown): Promise<void>;
     #private;
 }
 export type DebugFn = (message: string, level?: number, ...args: Array<unknown>) => void;
+export type HookModule = Record<string, (context: unknown) => Promise<unknown> | unknown>;
 export type ActionHooksConfig = {
     /**
-     * Action identifier shared between runner and hooks.
+     * - Action identifier shared between runner and hooks.
      */
     actionKind: string;
     /**
-     * Already-instantiated hooks implementation.
+     * - Already-instantiated hooks implementation.
      */
     hooks: unknown;
     /**
-     * Timeout applied to hook execution in milliseconds.
+     * - Timeout applied to hook execution in milliseconds.
      */
     hookTimeout?: number | undefined;
     /**
-     * Logger to emit diagnostics.
+     * - Logger to emit diagnostics.
      */
     debug: DebugFn;
 };
-export type HookModule = Record<string, (context: unknown) => Promise<unknown> | unknown>;
 //# sourceMappingURL=ActionHooks.d.ts.map

package/src/types/browser/lib/ActionHooks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ActionHooks.d.ts","sourceRoot":"","sources":["../../../browser/lib/ActionHooks.js"],"names":[],"mappings":"AAEA;;GAEG;AAEH;;;;;;GAMG;AAEH;;GAEG;AAEH;;;;;;GAMG;AACH;IAmEE;;;;;;;OAOG;IACH,qBAJW,iBAAiB,SACjB,OAAO,GACL,OAAO,CAAC,WAAW,GAAC,IAAI,CAAC,CAgBrC;IA/ED;;;;OAIG;IACH,uDAFW,iBAAiB,EAO3B;IAED;;;;OAIG;IACH,kBAFa,MAAM,CAIlB;IAED;;;;OAIG;IACH,aAFa,MAAM,GAAC,IAAI,CAIvB;IAED;;;;OAIG;IACH,eAFa,MAAM,CAIlB;IAED;;;;OAIG;IACH,aAFa,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,GAAC,IAAI,CAI1C;IAED;;;;OAIG;IACH,eAFa,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,GAAC,IAAI,CAI1C;IA0BD;;;;;;;OAOG;IACH,eALW,QAAQ,GAAC,OAAO,GAAC,OAAO,GAAC,SAAS,GAAC,MAAM,gBACzC,MAAM,GAAC,MAAM,WACb,OAAO,GACL,OAAO,CAAC,IAAI,CAAC,CAwDzB;;CAmBF;sBAlMY,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,KAAK,IAAI;;;;;gBAKjE,MAAM;;;;WACN,OAAO;;;;;;;;WAEP,OAAO;;yBAIR,MAAM,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,GAAC,OAAO,CAAC"}
+{"version":3,"file":"ActionHooks.d.ts","sourceRoot":"","sources":["../../../browser/lib/ActionHooks.js"],"names":[],"mappings":"AAEA;;GAEG;AAEH;;;;;;;;GAQG;AAEH;;;;;;GAMG;AACH;IAmEE;;;;;;;OAOG;IACH,qBAJW,iBAAiB,SACjB,OAAO,GACL,OAAO,CAAC,WAAW,OAAC,CAAC,CAgBjC;IA/ED;;;;OAIG;IACH,uDAFW,iBAAiB,EAO3B;IAED;;;;OAIG;IACH,kBAFa,MAAM,CAIlB;IAED;;;;OAIG;IACH,aAFa,MAAM,OAAC,CAInB;IAED;;;;OAIG;IACH,eAFa,MAAM,CAIlB;IAED;;;;OAIG;IACH,aAFa,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAIrC;IAED;;;;OAIG;IACH,eAFa,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAIrC;IA0BD;;;;;;;OAOG;IACH,eALW,MAAM,gBACN,MAAM,GAAC,MAAM,WACb,OAAO,GACL,OAAO,CAAC,IAAI,CAAC,CAwDzB;;CAmBF;sBAhMY,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,KAAK,IAAI;yBAIlE,MAAM,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,GAAC,OAAO,CAAC;;;;;gBAG7D,MAAM;;;;WACN,OAAO;;;;;;;;WAEP,OAAO"}

package/src/types/browser/lib/ActionRunner.d.ts

@@ -1,10 +1,12 @@
 /**
- * @typedef {(message: string, level?: number, ...args: Array<unknown>) => void} DebugFn
- */
-/**
- * @typedef {import("./ActionBuilder.js").default} ActionBuilder
+ * Types
+ *
+ * @import {default as ActionBuilder} from "./ActionBuilder.js"
+ * @import {default as ActionWrapper} from "./ActionWrapper.js"
  */
 /**
+ * @typedef {(message: string, level?: number, ...args: Array<unknown>) => void} DebugFn
+ *
  * @typedef {object} ActionRunnerOptions
  * @property {DebugFn} [debug] Logger function.
  */
@@ -32,12 +34,12 @@ export default class ActionRunner extends Piper {
      * @param {import("./ActionWrapper.js").default|null} [parentWrapper] - Parent wrapper for BREAK/CONTINUE signaling.
      * @returns {Promise<unknown>} Final value produced by the pipeline.
      * @throws {Sass} When no activities are registered, conflicting activity kinds are used, or execution fails.
+     * @throws {Tantrum} When both an activity and the done callback fail.
      */
     run(context: unknown, parentWrapper?: import("./ActionWrapper.js").default | null): Promise<unknown>;
     #private;
 }
 export type DebugFn = (message: string, level?: number, ...args: Array<unknown>) => void;
-export type ActionBuilder = import("./ActionBuilder.js").default;
 export type ActionRunnerOptions = {
     /**
      * Logger function.

package/src/types/browser/lib/ActionRunner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ActionRunner.d.ts","sourceRoot":"","sources":["../../../browser/lib/ActionRunner.js"],"names":[],"mappings":"AAKA;;GAEG;AAEH;;GAEG;AAEH;;;GAGG;AAEH;;;;;;GAMG;AACH;IAoBE;;;;;OAKG;IACH,2BAHW,OAAO,oBAAoB,EAAE,OAAO,GAAC,IAAI,cACzC,mBAAmB,EAkB7B;IAED;;;;;;;;;OASG;IACH,aALW,OAAO,kBACP,OAAO,oBAAoB,EAAE,OAAO,GAAC,IAAI,GACvC,OAAO,CAAC,OAAO,CAAC,CA4I5B;;CAyFF;sBA3SY,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,KAAK,IAAI;4BAIlE,OAAO,oBAAoB,EAAE,OAAO;;;;;;;kBAP/B,YAAY"}
+{"version":3,"file":"ActionRunner.d.ts","sourceRoot":"","sources":["../../../browser/lib/ActionRunner.js"],"names":[],"mappings":"AAKA;;;;;GAKG;AACH;;;;;GAKG;AAEH;;;;;;GAMG;AACH;IAaE;;;;;OAKG;IACH,2BAHW,OAAO,oBAAoB,EAAE,OAAO,GAAC,IAAI,cACzC,mBAAmB,EAkB7B;IAED;;;;;;;;;;OAUG;IACH,aANW,OAAO,kBACP,OAAO,oBAAoB,EAAE,OAAO,GAAC,IAAI,GACvC,OAAO,CAAC,OAAO,CAAC,CAoJ5B;;CAiGF;sBA9SY,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,KAAK,IAAI;;;;;;;kBAT7D,YAAY"}

package/src/types/browser/lib/ActionWrapper.d.ts

@@ -1,3 +1,9 @@
+/**
+ * Type imports
+ *
+ * @import {default as ActionHooks} from "./ActionHooks.js"
+ * @import {default as ActionRunner} from "./ActionRunner.js"
+ */
 /**
  * @typedef {object} WrappedActivityConfig
  * @property {string|symbol} name Activity identifier used by hooks/logs.
@@ -7,9 +13,6 @@
  * @property {unknown} [action] Parent action instance supplied when invoking the op.
  * @property {(message: string, level?: number, ...args: Array<unknown>) => void} [debug] Optional logger reference.
  */
-/**
- * @typedef {import("@gesslar/toolkit").Generator<Activity, void, unknown>} ActivityIterator
- */
 /**
  * Thin wrapper that materialises {@link Activity} instances on demand.
  */
@@ -76,6 +79,5 @@ export type WrappedActivityConfig = {
      */
     debug?: ((message: string, level?: number, ...args: Array<unknown>) => void) | undefined;
 };
-export type ActivityIterator = import("@gesslar/toolkit").Generator<Activity, void, unknown>;
 import Activity from "./Activity.js";
 //# sourceMappingURL=ActionWrapper.d.ts.map

package/src/types/browser/lib/ActionWrapper.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ActionWrapper.d.ts","sourceRoot":"","sources":["../../../browser/lib/ActionWrapper.js"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AAEH;;GAEG;AAEH;;GAEG;AACH;IAwBE;;;;OAIG;IACH,sEAFW;QAAC,UAAU,EAAE,GAAG,CAAC,MAAM,GAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC;QAAC,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,KAAK,IAAI,CAAA;KAAC,EAwB5I;IAED;;;;;OAKG;IACH,UAFa,MAAM,CAIlB;IAED;;;;OAIG;IACH,kBAFa,QAAQ,CAAC,QAAQ,CAAC,CAI9B;IAED;;;;OAIG;IACH,YAFa,CAAC,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,GAAC,OAAO,CAAC,OAAO,CAAC,CAAC,GAAC,IAAI,CAIjE;IAED;;;;OAIG;IACH,cAFa,OAAO,GAAC,IAAI,CAIxB;;CACF;;;;;UAxGa,MAAM,GAAC,MAAM;;;;QACb,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,GAAC,OAAO,CAAC,OAAO,CAAC,GAAC,aAAa;;;;;;;;sBAElD,OAAO,KAAK,OAAO,GAAC,OAAO,CAAC,OAAO,CAAC;;;;aAC9C,OAAO;;;;uBACG,MAAM,UAAU,MAAM,WAAW,KAAK,CAAC,OAAO,CAAC,KAAK,IAAI;;+BAInE,OAAO,kBAAkB,EAAE,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,OAAO,CAAC;qBAbrD,eAAe"}
+{"version":3,"file":"ActionWrapper.d.ts","sourceRoot":"","sources":["../../../browser/lib/ActionWrapper.js"],"names":[],"mappings":"AAEA;;;;;GAKG;AAEH;;;;;;;;GAQG;AAEH;;GAEG;AACH;IA0BE;;;;OAIG;IACH,sEAFW;QAAC,UAAU,EAAE,GAAG,CAAC,MAAM,GAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC;QAAC,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,KAAK,IAAI,CAAA;KAAC,EAwB5I;IAED;;;;;OAKG;IACH,UAFa,MAAM,CAIlB;IAED;;;;OAIG;IACH,kBAFa,QAAQ,CAAC,QAAQ,CAAC,CAI9B;IAED;;;;OAIG;IACH,YAFa,CAAC,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,GAAC,OAAO,CAAC,OAAO,CAAC,CAAC,GAAC,IAAI,CAIjE;IAED;;;;OAIG;IACH,cAFa,OAAO,GAAC,IAAI,CAIxB;;CACF;;;;;UAtGa,MAAM,GAAC,MAAM;;;;QACb,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,GAAC,OAAO,CAAC,OAAO,CAAC,GAAC,aAAa;;;;;;;;sBAElD,OAAO,KAAK,OAAO,GAAC,OAAO,CAAC,OAAO,CAAC;;;;aAC9C,OAAO;;;;uBACG,MAAM,UAAU,MAAM,WAAW,KAAK,CAAC,OAAO,CAAC,KAAK,IAAI;;qBAhB3D,eAAe"}