@gesslar/actioneer 2.2.0 → 2.4.0

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,83 @@ 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.
+     * @param {ActionRunner} runner - The runner invoking the build.
+     * @returns {Promise<ActionWrapper>} Payload consumed by the {@link ActionRunner} constructor.
+     */
+    build(runner: ActionRunner): Promise<ActionWrapper>;
+    /**
+     * Returns the raw hooks value configured on this builder.
+     * Used by {@link ActionRunner} to access setup/cleanup lifecycle hooks.
+     *
+     * @returns {object|Function|null} Raw hooks value, or null if not configured.
      */
-    build(): Promise<import("./ActionWrapper.js").default>;
+    get hooks(): object | Function | null;
     #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 type { default as ActionRunner } from "./ActionRunner.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;;;;;;OAMG;IACH,cAHW,YAAY,GACV,OAAO,CAAC,aAAa,CAAC,CAoClC;IAsBD;;;;;OAKG;IACH,aAFa,MAAM,cAAU,IAAI,CAIhC;;CACF;;;;sBAjWY,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;6CAMA,mBAAmB;0BAPnC,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 {object|Function|null} hooks - Pre-instantiated hooks object, a constructor to instantiate, or null.
+ * @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);
     /**
@@ -42,8 +41,10 @@ export default class ActionHooks {
     get actionKind(): string;
     /**
      * Gets the loaded hooks object.
+     * If the stored value is a plain object it is returned as-is.
+     * If it is a constructor function a new instance is created and returned.
      *
-     * @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 +56,45 @@ 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} oldContext - Pipeline context supplied to the hook.
+     * @param {unknown} newContext - For after$ hooks, the result of the op
      * @returns {Promise<void>}
      */
-    callHook(kind: "before" | "after" | "setup" | "cleanup" | string, activityName: string | symbol, context: unknown): Promise<void>;
+    callHook(kind: string, activityName: string | symbol, oldContext: unknown, newContext: 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.
+     * - Pre-instantiated hooks object, a constructor to instantiate, or null.
      */
-    hooks: unknown;
+    hooks: object | Function | null;
     /**
-     * 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;IA2EE;;;;;;;OAOG;IACH,qBAJW,iBAAiB,SACjB,OAAO,GACL,OAAO,CAAC,WAAW,OAAC,CAAC,CAgBjC;IAvFD;;;;OAIG;IACH,uDAFW,iBAAiB,EAO3B;IAED;;;;OAIG;IACH,kBAFa,MAAM,CAIlB;IAED;;;;;;OAMG;IACH,aAFa,MAAM,OAAC,CAUnB;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;;;;;;;;OAQG;IACH,eANW,MAAM,gBACN,MAAM,GAAC,MAAM,cACb,OAAO,cACP,OAAO,GACL,OAAO,CAAC,IAAI,CAAC,CAyDzB;;CAmBF;sBA1MY,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,MAAM,cAAU,IAAI;;;;;;;;WAEpB,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,EAoB7B;IAoCD;;;;;;;;;;OAUG;IACH,aANW,OAAO,kBACP,OAAO,oBAAoB,EAAE,OAAO,GAAC,IAAI,GACvC,OAAO,CAAC,OAAO,CAAC,CAoJ5B;;CAiGF;sBAlVY,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,8 @@
+/**
+ * Type imports
+ *
+ * @import {default as ActionHooks} from "./ActionHooks.js"
+ */
 /**
  * @typedef {object} WrappedActivityConfig
  * @property {string|symbol} name Activity identifier used by hooks/logs.
@@ -7,9 +12,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.
  */
@@ -17,11 +19,19 @@ export default class ActionWrapper {
     /**
      * Create a wrapper from the builder payload.
      *
-     * @param {{activities: Map<string|symbol, WrappedActivityConfig>, debug: (message: string, level?: number, ...args: Array<unknown>) => void}} init Builder payload containing activities + logger.
+     * @param {object} init - Builder payload.
+     * @param {Map<string|symbol, WrappedActivityConfig>} init.activities - Registered activities.
+     * @param {(message: string, level?: number, ...args: Array<unknown>) => void} init.debug - Logger.
+     * @param {import("./ActionHooks.js").default?} init.hooks - Optional hooks instance.
+     * @param {((context: unknown) => unknown|Promise<unknown>)|null} [init.done] - Optional done callback.
+     * @param {unknown} [init.action] - Optional parent action instance.
      */
     constructor({ activities, hooks, debug, done: doneCallback, action }: {
         activities: Map<string | symbol, WrappedActivityConfig>;
         debug: (message: string, level?: number, ...args: Array<unknown>) => void;
+        hooks: import("./ActionHooks.js").default | null;
+        done?: ((context: unknown) => unknown | Promise<unknown>) | null | undefined;
+        action?: unknown;
     });
     /**
      * Unique identifier for this wrapper instance.
@@ -76,6 +86,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;;;;GAIG;AAEH;;;;;;;;GAQG;AAEH;;GAEG;AACH;IAwBE;;;;;;;;;OASG;IACH,sEANG;QAAwD,UAAU,EAA1D,GAAG,CAAC,MAAM,GAAC,MAAM,EAAE,qBAAqB,CAAC;QACgC,KAAK,EAA9E,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,KAAK,IAAI;QACxB,KAAK,EAA/C,OAAO,kBAAkB,EAAE,OAAO,OAAC;QAC0B,IAAI,cAAtD,OAAO,KAAK,OAAO,GAAC,OAAO,CAAC,OAAO,CAAC;QAChC,MAAM,GAArB,OAAO;KACjB,EAuBA;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;;;;;UAzGa,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;;qBAf3D,eAAe"}

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

@@ -2,7 +2,11 @@
  * *
  */
 export type ACTIVITY = number;
-/** @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
  * loop semantics for an activity.
@@ -31,24 +35,24 @@ 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 }: {
         action: unknown;
         name: string | symbol;
-        op: (context: unknown) => unknown | Promise<unknown> | import("./ActionBuilder.js").default;
+        op: (context: unknown) => unknown | Promise<unknown> | ActionBuilder;
         kind?: number | undefined;
         pred?: ((context: unknown) => boolean | Promise<boolean>) | undefined;
-        hooks?: import("./ActionHooks.js").default | undefined;
+        hooks?: ActionHooks | undefined;
         splitter?: ((context: unknown) => unknown) | undefined;
         rejoiner?: ((originalContext: unknown, splitResults: unknown) => unknown) | undefined;
-        wrapper?: import("./ActionWrapper.js").default | undefined;
+        wrapper?: ActionWrapper | undefined;
     });
     /**
      * Unique identifier for this activity instance.
@@ -89,19 +93,19 @@ 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(): (context: unknown) => unknown | Promise<unknown> | import("./ActionBuilder.js").default;
+    get op(): (context: unknown) => unknown | Promise<unknown> | ActionBuilder;
     /**
      * 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(): ((context: unknown) => unknown) | null;
     /**
      * 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(): ((originalContext: unknown, splitResults: unknown) => unknown) | null;
     /**
@@ -114,9 +118,9 @@ 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(): import("./ActionWrapper.js").default | null;
+    get wrapper(): ActionWrapper | null;
     /**
      * Execute the activity with before/after hooks.
      *
@@ -134,10 +138,12 @@ 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(): ActionHooks | null;
     #private;
 }
-export type ActionHooks = import("./ActionHooks.js").default;
+import type { default as ActionBuilder } from "./ActionBuilder.js";
+import type { default as ActionWrapper } from "./ActionWrapper.js";
+import type { default as ActionHooks } from "./ActionHooks.js";
 //# sourceMappingURL=Activity.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"Activity.d.ts","sourceRoot":"","sources":["../../../browser/lib/Activity.js"],"names":[],"mappings":";;;uBASU,MAAM;AAPhB,gEAAgE;AAEhE;;;;;;;;;;;;GAYG;AACH;;;;;;;GAOE;AAEF;IAwBE;;;;;;;;;;;;;OAaG;IACH,kFAVG;QAAsB,MAAM,EAApB,OAAO;QACa,IAAI,EAAxB,MAAM,GAAC,MAAM;QAC6E,EAAE,EAA5F,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,GAAC,OAAO,CAAC,OAAO,CAAC,GAAC,OAAO,oBAAoB,EAAE,OAAO;QACrE,IAAI;QACoC,IAAI,cAAhD,OAAO,KAAK,OAAO,GAAC,OAAO,CAAC,OAAO,CAAC;QAC3B,KAAK;QACa,QAAQ,cAAnC,OAAO,KAAK,OAAO;QACuC,QAAQ,sBAA1D,OAAO,gBAAgB,OAAO,KAAK,OAAO;QAChB,OAAO;KAC7D,EAWA;IAED;;;;OAIG;IACH,UAFa,MAAM,CAIlB;IAED;;;;OAIG;IACH,YAFa,MAAM,CAIlB;IAED;;;;OAIG;IACH,YAFa,MAAM,GAAC,IAAI,CAIvB;IAED;;;;OAIG;IACH,YAFa,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,GAAC,OAAO,CAAC,OAAO,CAAC,GAAC,SAAS,CAIpE;IAED;;;;OAIG;IACH,eAFa,OAAO,CAInB;IAED;;;;OAIG;IACH,cAFa,MAAM,CAIlB;IAED;;;;OAIG;IACH,UAFa,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,GAAC,OAAO,CAAC,OAAO,CAAC,GAAC,OAAO,oBAAoB,EAAE,OAAO,CAI/F;IAED;;;;OAIG;IACH,gBAFa,CAAC,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,GAAC,IAAI,CAIhD;IAED;;;;OAIG;IACH,gBAFa,CAAC,CAAC,eAAe,EAAE,OAAO,EAAE,YAAY,EAAE,OAAO,KAAK,OAAO,CAAC,GAAC,IAAI,CAI/E;IAED;;;;OAIG;IACH,cAFa,OAAO,CAInB;IAED;;;;;OAKG;IACH,eAFa,OAAO,oBAAoB,EAAE,OAAO,GAAC,IAAI,CAIrD;IAED;;;;;OAKG;IACH,aAHW,OAAO,GACL,OAAO,CAAC,OAAO,CAAC,CAa5B;IAED;;;;;OAKG;IACH,sBAHW,WAAW,GACT,IAAI,CAOhB;IAED;;;;OAIG;IACH,aAFa,WAAW,GAAC,IAAI,CAI5B;;CACF;0BAtNa,OAAO,kBAAkB,EAAE,OAAO"}
+{"version":3,"file":"Activity.d.ts","sourceRoot":"","sources":["../../../browser/lib/Activity.js"],"names":[],"mappings":";;;uBAaU,MAAM;AAXhB;;;;IAII;AAEJ;;;;;;;;;;;;GAYG;AACH;;;;;;;GAOE;AAEF;IAwBE;;;;;;;;;;;;;OAaG;IACH,kFAVG;QAAsB,MAAM,EAApB,OAAO;QACa,IAAI,EAAxB,MAAM,GAAC,MAAM;QACsD,EAAE,EAArE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,GAAC,OAAO,CAAC,OAAO,CAAC,GAAC,aAAa;QAC9C,IAAI;QACoC,IAAI,cAAhD,OAAO,KAAK,OAAO,GAAC,OAAO,CAAC,OAAO,CAAC;QAC3B,KAAK;QACa,QAAQ,cAAnC,OAAO,KAAK,OAAO;QACuC,QAAQ,sBAA1D,OAAO,gBAAgB,OAAO,KAAK,OAAO;QACvC,OAAO;KACtC,EAWA;IAED;;;;OAIG;IACH,UAFa,MAAM,CAIlB;IAED;;;;OAIG;IACH,YAFa,MAAM,CAIlB;IAED;;;;OAIG;IACH,YAFa,MAAM,GAAC,IAAI,CAIvB;IAED;;;;OAIG;IACH,YAFa,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,GAAC,OAAO,CAAC,OAAO,CAAC,GAAC,SAAS,CAIpE;IAED;;;;OAIG;IACH,eAFa,OAAO,CAInB;IAED;;;;OAIG;IACH,cAFa,MAAM,CAIlB;IAED;;;;OAIG;IACH,UAFa,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,GAAC,OAAO,CAAC,OAAO,CAAC,GAAC,aAAa,CAIxE;IAED;;;;OAIG;IACH,gBAFa,CAAC,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,OAAC,CAI5C;IAED;;;;OAIG;IACH,gBAFa,CAAC,CAAC,eAAe,EAAE,OAAO,EAAE,YAAY,EAAE,OAAO,KAAK,OAAO,CAAC,OAAC,CAI3E;IAED;;;;OAIG;IACH,cAFa,OAAO,CAInB;IAED;;;;;OAKG;IACH,eAFa,aAAa,OAAC,CAI1B;IAED;;;;;OAKG;IACH,aAHW,OAAO,GACL,OAAO,CAAC,OAAO,CAAC,CAa5B;IAED;;;;;OAKG;IACH,sBAHW,WAAW,GACT,IAAI,CAOhB;IAED;;;;OAIG;IACH,aAFa,WAAW,OAAC,CAIxB;;CACF;8CAzN0C,oBAAoB;8CAEpB,oBAAoB;4CADtB,kBAAkB"}

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

@@ -1,18 +1,22 @@
-export default class Piper {
+/**
+ * @import {Tantrum} from "@gesslar/toolkit"
+ */
+export default class Piper extends NotifyClass {
     /**
      * 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 }?: {
         debug?: (message: string, level?: number, ...args: Array<unknown>) => void;
     });
+    get reason(): any;
     /**
      * 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: (context: unknown) => Promise<unknown> | unknown, options?: {
@@ -22,19 +26,19 @@ export default class Piper {
     /**
      * Add setup hook that runs before processing starts.
      *
-     * @param {() => Promise<void>|void} fn - Setup function executed before processing
+     * @param {(items: Array<unknown>) => Promise<void>|void} fn - Setup function executed before processing; receives the full items array.
      * @param {unknown} [thisArg] - Optional this binding for the setup function
      * @returns {Piper} - The pipeline instance
      */
-    addSetup(fn: () => Promise<void> | void, thisArg?: unknown): Piper;
+    addSetup(fn: (items: Array<unknown>) => Promise<void> | void, thisArg?: unknown): Piper;
     /**
      * Add cleanup hook that runs after processing completes
      *
-     * @param {() => Promise<void>|void} fn - Cleanup function executed after processing
+     * @param {(items: Array<unknown>) => Promise<void>|void} fn - Cleanup function executed after processing; receives the full items array.
      * @param {unknown} [thisArg] - Optional this binding for the cleanup function
      * @returns {Piper} - The pipeline instance
      */
-    addCleanup(fn: () => Promise<void> | void, thisArg?: unknown): Piper;
+    addCleanup(fn: (items: Array<unknown>) => Promise<void> | void, thisArg?: unknown): Piper;
     /**
      * Process items through the pipeline with concurrency control
      *
@@ -49,4 +53,5 @@ export default class Piper {
     }>>;
     #private;
 }
+import { NotifyClass } from "@gesslar/toolkit";
 //# sourceMappingURL=Piper.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"Piper.d.ts","sourceRoot":"","sources":["../../../browser/lib/Piper.js"],"names":[],"mappings":"AAaA;IASE;;;;OAIG;IACH,wBAFW;QAAC,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,KAAK,IAAI,CAAA;KAAC,EAItF;IAED;;;;;;;OAOG;IACH,YALW,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,GAAC,OAAO,YAC9C;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAC,YACnC,OAAO,GACL,KAAK,CAWjB;IAED;;;;;;OAMG;IACH,aAJW,MAAM,OAAO,CAAC,IAAI,CAAC,GAAC,IAAI,YACxB,OAAO,GACL,KAAK,CAMjB;IAED;;;;;;OAMG;IACH,eAJW,MAAM,OAAO,CAAC,IAAI,CAAC,GAAC,IAAI,YACxB,OAAO,GACL,KAAK,CAMjB;IAED;;;;;;OAMG;IACH,YAJW,KAAK,CAAC,OAAO,CAAC,GAAC,OAAO,kBACtB,MAAM,GACJ,OAAO,CAAC,KAAK,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAA;KAAC,CAAC,CAAC,CAuD/E;;CAyCF"}
+{"version":3,"file":"Piper.d.ts","sourceRoot":"","sources":["../../../browser/lib/Piper.js"],"names":[],"mappings":"AAaA;;GAEG;AAEH;IAWE;;;;OAIG;IACH,wBAFW;QAAC,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,KAAK,IAAI,CAAA;KAAC,EAUtF;IAMD,kBAEC;IAED;;;;;;;OAOG;IACH,YALW,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,GAAC,OAAO,YAC9C;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAC,YACnC,OAAO,GACL,KAAK,CAWjB;IAED;;;;;;OAMG;IACH,aAJW,CAAC,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,GAAC,IAAI,YAC7C,OAAO,GACL,KAAK,CAMjB;IAED;;;;;;OAMG;IACH,eAJW,CAAC,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,GAAC,IAAI,YAC7C,OAAO,GACL,KAAK,CAMjB;IAED;;;;;;OAMG;IACH,YAJW,KAAK,CAAC,OAAO,CAAC,GAAC,OAAO,kBACtB,MAAM,GACJ,OAAO,CAAC,KAAK,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAA;KAAC,CAAC,CAAC,CA6D/E;;CAuCF;4BA9LyD,kBAAkB"}