@wpkernel/pipeline 0.12.2-beta.0 → 0.12.3-beta.2

package/dist/helper.js

@@ -1,7 +1,3 @@
-/**
- * @wpkernel/pipeline
- * @license EUPL-1.2
- */
 function a(e) {
   const {
     key: r,

package/dist/index.d.ts

@@ -6,12 +6,13 @@ export { executeHelpers } from './executor';
 export type { ErrorFactory } from './error-factory';
 export { createDefaultError, createErrorFactory } from './error-factory';
 export { registerHelper, registerExtensionHook, handleExtensionRegisterResult, } from './registration';
-export type { Pipeline, CreatePipelineOptions, PipelineReporter, PipelineExtension, PipelineExtensionHook, PipelineExtensionHookOptions, PipelineExtensionHookResult, PipelineExtensionLifecycle, PipelineExtensionHookRegistration, PipelineExtensionRegisterOutput, PipelineDiagnostic, ConflictDiagnostic, MissingDependencyDiagnostic, UnusedHelperDiagnostic, Helper, HelperApplyFn, HelperDescriptor, HelperKind, HelperMode, CreateHelperOptions, HelperApplyOptions, MaybePromise, PipelineStep, PipelineRunState, HelperExecutionSnapshot, PipelineExecutionMetadata, FragmentFinalizationMetadata, PipelineExtensionRollbackErrorMetadata, } from './types';
+export { createPipelineRollback, runRollbackStack } from './rollback';
+export type { PipelineRollback, PipelineRollbackErrorMetadata, RunRollbackStackOptions, } from './rollback';
+export type { Pipeline, CreatePipelineOptions, PipelineReporter, PipelineExtension, PipelineExtensionHook, PipelineExtensionHookOptions, PipelineExtensionHookResult, PipelineExtensionLifecycle, PipelineExtensionHookRegistration, PipelineExtensionRegisterOutput, PipelineDiagnostic, ConflictDiagnostic, MissingDependencyDiagnostic, UnusedHelperDiagnostic, Helper, HelperApplyFn, HelperApplyResult, HelperDescriptor, HelperKind, HelperMode, CreateHelperOptions, HelperApplyOptions, MaybePromise, PipelineStep, PipelineRunState, HelperExecutionSnapshot, PipelineExecutionMetadata, FragmentFinalizationMetadata, PipelineExtensionRollbackErrorMetadata, } from './types';
 export type { RegisteredHelper, MissingDependencyIssue, } from './dependency-graph';
 export { createHelperId, compareHelpers } from './dependency-graph';
 export { isPromiseLike, maybeThen, maybeTry, processSequentially, } from './async-utils';
 export type { ExtensionHookEntry, ExtensionHookExecution, RollbackErrorArgs, } from './extensions';
-export { createRollbackErrorMetadata } from './extensions';
 export { OFFICIAL_EXTENSION_BLUEPRINTS } from './extensions/official';
 export type { OfficialExtensionBlueprint } from './extensions/official';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxC,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAC5D,YAAY,EAAE,8BAA8B,EAAE,MAAM,mBAAmB,CAAC;AACxE,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,YAAY,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACzE,OAAO,EACN,cAAc,EACd,qBAAqB,EACrB,6BAA6B,GAC7B,MAAM,gBAAgB,CAAC;AAGxB,YAAY,EAEX,QAAQ,EACR,qBAAqB,EACrB,gBAAgB,EAChB,iBAAiB,EACjB,qBAAqB,EACrB,4BAA4B,EAC5B,2BAA2B,EAC3B,0BAA0B,EAC1B,iCAAiC,EACjC,+BAA+B,EAC/B,kBAAkB,EAClB,kBAAkB,EAClB,2BAA2B,EAC3B,sBAAsB,EAGtB,MAAM,EACN,aAAa,EACb,gBAAgB,EAChB,UAAU,EACV,UAAU,EACV,mBAAmB,EACnB,kBAAkB,EAGlB,YAAY,EACZ,YAAY,EACZ,gBAAgB,EAChB,uBAAuB,EACvB,yBAAyB,EACzB,4BAA4B,EAC5B,sCAAsC,GACtC,MAAM,SAAS,CAAC;AAGjB,YAAY,EACX,gBAAgB,EAChB,sBAAsB,GACtB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAGpE,OAAO,EACN,aAAa,EACb,SAAS,EACT,QAAQ,EACR,mBAAmB,GACnB,MAAM,eAAe,CAAC;AAGvB,YAAY,EACX,kBAAkB,EAClB,sBAAsB,EACtB,iBAAiB,GACjB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,2BAA2B,EAAE,MAAM,cAAc,CAAC;AAG3D,OAAO,EAAE,6BAA6B,EAAE,MAAM,uBAAuB,CAAC;AACtE,YAAY,EAAE,0BAA0B,EAAE,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxC,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAC5D,YAAY,EAAE,8BAA8B,EAAE,MAAM,mBAAmB,CAAC;AACxE,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,YAAY,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACzE,OAAO,EACN,cAAc,EACd,qBAAqB,EACrB,6BAA6B,GAC7B,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACtE,YAAY,EACX,gBAAgB,EAChB,6BAA6B,EAC7B,uBAAuB,GACvB,MAAM,YAAY,CAAC;AAGpB,YAAY,EAEX,QAAQ,EACR,qBAAqB,EACrB,gBAAgB,EAChB,iBAAiB,EACjB,qBAAqB,EACrB,4BAA4B,EAC5B,2BAA2B,EAC3B,0BAA0B,EAC1B,iCAAiC,EACjC,+BAA+B,EAC/B,kBAAkB,EAClB,kBAAkB,EAClB,2BAA2B,EAC3B,sBAAsB,EAGtB,MAAM,EACN,aAAa,EACb,iBAAiB,EACjB,gBAAgB,EAChB,UAAU,EACV,UAAU,EACV,mBAAmB,EACnB,kBAAkB,EAElB,YAAY,EACZ,YAAY,EACZ,gBAAgB,EAChB,uBAAuB,EACvB,yBAAyB,EACzB,4BAA4B,EAC5B,sCAAsC,GACtC,MAAM,SAAS,CAAC;AAGjB,YAAY,EACX,gBAAgB,EAChB,sBAAsB,GACtB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAGpE,OAAO,EACN,aAAa,EACb,SAAS,EACT,QAAQ,EACR,mBAAmB,GACnB,MAAM,eAAe,CAAC;AAGvB,YAAY,EACX,kBAAkB,EAClB,sBAAsB,EACtB,iBAAiB,GACjB,MAAM,cAAc,CAAC;AAGtB,OAAO,EAAE,6BAA6B,EAAE,MAAM,uBAAuB,CAAC;AACtE,YAAY,EAAE,0BAA0B,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/index.js

@@ -1,33 +1,30 @@
 import { createHelper as o } from "./helper.js";
 import { createPipeline as p } from "./createPipeline.js";
-import { createPipelineExtension as i } from "./createExtension.js";
-import { executeHelpers as m } from "./executor.js";
-import { createDefaultError as s, createErrorFactory as c } from "./error-factory.js";
-import { handleExtensionRegisterResult as n, registerExtensionHook as E, registerHelper as H } from "./registration.js";
-import { compareHelpers as I, createHelperId as u } from "./dependency-graph.js";
-import { isPromiseLike as R, maybeThen as T, maybeTry as b, processSequentially as d } from "./async-utils.js";
-import { createRollbackErrorMetadata as k } from "./extensions.js";
-import { OFFICIAL_EXTENSION_BLUEPRINTS as L } from "./extensions/official.js";
-/**
- * @wpkernel/pipeline
- * @license EUPL-1.2
- */
+import { createPipelineExtension as l } from "./createExtension.js";
+import { executeHelpers as c } from "./executor.js";
+import { createDefaultError as x, createErrorFactory as n } from "./error-factory.js";
+import { handleExtensionRegisterResult as f, registerExtensionHook as E, registerHelper as H } from "./registration.js";
+import { createPipelineRollback as u, runRollbackStack as y } from "./rollback.js";
+import { compareHelpers as P, createHelperId as R } from "./dependency-graph.js";
+import { isPromiseLike as S, maybeThen as T, maybeTry as g, processSequentially as F } from "./async-utils.js";
+import { OFFICIAL_EXTENSION_BLUEPRINTS as N } from "./extensions/official.js";
 export {
-  L as OFFICIAL_EXTENSION_BLUEPRINTS,
-  I as compareHelpers,
-  s as createDefaultError,
-  c as createErrorFactory,
+  N as OFFICIAL_EXTENSION_BLUEPRINTS,
+  P as compareHelpers,
+  x as createDefaultError,
+  n as createErrorFactory,
   o as createHelper,
-  u as createHelperId,
+  R as createHelperId,
   p as createPipeline,
-  i as createPipelineExtension,
-  k as createRollbackErrorMetadata,
-  m as executeHelpers,
-  n as handleExtensionRegisterResult,
-  R as isPromiseLike,
+  l as createPipelineExtension,
+  u as createPipelineRollback,
+  c as executeHelpers,
+  f as handleExtensionRegisterResult,
+  S as isPromiseLike,
   T as maybeThen,
-  b as maybeTry,
-  d as processSequentially,
+  g as maybeTry,
+  F as processSequentially,
   E as registerExtensionHook,
-  H as registerHelper
+  H as registerHelper,
+  y as runRollbackStack
 };

package/dist/internal/diagnostic-manager.js

@@ -1,7 +1,3 @@
-/**
- * @wpkernel/pipeline
- * @license EUPL-1.2
- */
 function w(i) {
   const g = [], a = /* @__PURE__ */ new WeakMap();
   let s;

package/dist/internal/extension-coordinator.js

@@ -1,9 +1,5 @@
 import { commitExtensionResults as m, rollbackExtensionResults as d, runExtensionHooks as f, createRollbackErrorMetadata as s } from "../extensions.js";
 import { maybeThen as i } from "../async-utils.js";
-/**
- * @wpkernel/pipeline
- * @license EUPL-1.2
- */
 function R(n) {
   return {
     runLifecycle: (t, { hooks: o, hookOptions: r }) => {

package/dist/internal/helper-execution.js

@@ -1,7 +1,3 @@
-/**
- * @wpkernel/pipeline
- * @license EUPL-1.2
- */
 function c(o, n, l) {
   const s = [], t = [], i = [];
   for (const r of o) {

package/dist/internal/pipeline-program-utils.d.ts

@@ -0,0 +1,127 @@
+import { Helper, HelperApplyOptions, HelperKind, MaybePromise, PipelineExtensionRollbackErrorMetadata, PipelineReporter } from '../types';
+import { RegisteredHelper } from '../dependency-graph';
+import { Program } from '../async-utils.js';
+import { HelperInvokeOptions, RollbackContext, Halt, RollbackEntry, HelperRollbackPlan, StageEnv } from './pipeline-runner.types.js';
+export declare function isHalt<TRunResult>(value: unknown): value is Halt<TRunResult>;
+/**
+ * Builds a rollback handler that first drains helper rollbacks (when present) and then defers to
+ * extension rollback handling.
+ *
+ * @param state
+ * @param state.context
+ * @param state.extensionCoordinator
+ * @param state.extensionState
+ * @param helperRollbacks
+ * @param onHelperRollbackError
+ * @internal
+ */
+export declare function makeRollbackHandler<TContext, TOptions, TArtifact, THelper extends {
+    key: string;
+}>(state: RollbackContext<TContext, TOptions, TArtifact>, helperRollbacks: RollbackEntry<THelper>[], onHelperRollbackError?: (options: {
+    readonly error: unknown;
+    readonly helper: THelper;
+    readonly errorMetadata: PipelineExtensionRollbackErrorMetadata;
+    readonly context: TContext;
+}) => void): (error: unknown) => MaybePromise<void>;
+/**
+ * Generic stage constructor that executes an ordered helper list with middleware-style `next()`.
+ * Optional rollback capture keeps fragment/builder programs declarative by passing in only the
+ * stage-specific arg factories and completion logic.
+ *
+ * @param options
+ * @param options.getOrder
+ * @param options.makeArgs
+ * @param options.invoke
+ * @param options.recordStep
+ * @param options.onVisited
+ * @param options.registerRollback
+ * @internal
+ */
+export declare function createHelpersProgram<TContext, TReporter extends PipelineReporter, TKind extends HelperKind, THelper extends Helper<TContext, TInput, TOutput, TReporter, TKind>, TInput, TOutput, TState>(options: {
+    getOrder: (state: TState) => RegisteredHelper<THelper>[];
+    makeArgs: (state: TState) => (entry: RegisteredHelper<THelper>) => HelperApplyOptions<TContext, TInput, TOutput, TReporter>;
+    invoke: (invokeOptions: HelperInvokeOptions<THelper, TInput, TOutput, TContext, TReporter>) => MaybePromise<void>;
+    recordStep: (entry: RegisteredHelper<unknown>) => void;
+    onVisited: (state: TState, visited: Set<string>) => TState;
+    registerRollback?: (helper: THelper, result: unknown) => void;
+}): (state: TState) => MaybePromise<TState>;
+/**
+ * Pure finalizer for fragment state that can be composed into a pipeline without knowing the
+ * concrete runner shape. Callers supply how to detect halts, how to snapshot fragment execution,
+ * and how to apply the finalized artifact back onto state.
+ * @param options
+ * @param options.isHalt
+ * @param options.snapshotFragments
+ * @param options.applyArtifact
+ */
+export declare function makeFinalizeFragmentsStage<TState, THalt extends Halt<unknown>, TFragments>(options: {
+    isHalt: (value: TState | THalt) => value is THalt;
+    snapshotFragments: (state: TState) => TFragments;
+    applyArtifact: (state: TState, fragments: TFragments) => TState;
+}): Program<TState | THalt>;
+/**
+ * Generic stage builder for "after fragments" style hooks. The runner provides the execution logic
+ * (e.g. extension coordinator runLifecycle) and a halt predicate; the program simply short-circuits
+ * on halts and applies the provided execution otherwise.
+ * @param options
+ * @param options.isHalt
+ * @param options.execute
+ */
+export declare function makeAfterFragmentsStage<TState, THalt extends Halt<unknown>>(options: {
+    isHalt: (value: TState | THalt) => value is THalt;
+    execute: (state: TState) => MaybePromise<TState>;
+}): Program<TState | THalt>;
+/**
+ * Commit stage builder that keeps the runner point-free: supply how to commit extensions and how to
+ * roll back with a halt sentinel, and the program handles sync/async errors uniformly.
+ * @param options
+ * @param options.isHalt
+ * @param options.commit
+ * @param options.rollbackToHalt
+ */
+export declare function makeCommitStage<TState, THalt extends Halt<unknown>>(options: {
+    isHalt: (value: TState | THalt) => value is THalt;
+    commit: (state: TState) => MaybePromise<void>;
+    rollbackToHalt: (state: TState, error: unknown) => MaybePromise<THalt>;
+}): Program<TState | THalt>;
+/**
+ * Simple finalizer that snapshots helpers/diagnostics into state unless a halt is present.
+ * @param options
+ * @param options.isHalt
+ * @param options.finalize
+ */
+export declare function makeFinalizeResultStage<TState, THalt extends Halt<unknown>>(options: {
+    isHalt: (value: TState | THalt) => value is THalt;
+    finalize: (state: TState) => TState;
+}): Program<TState | THalt>;
+export type HelperStageSpec<TState, TContext, TReporter extends PipelineReporter, TKind extends HelperKind, THelper extends Helper<TContext, TInput, TOutput, TReporter, TKind>, TInput, TOutput> = {
+    readonly getOrder: (state: TState) => RegisteredHelper<THelper>[];
+    readonly makeArgs: (state: TState) => (entry: RegisteredHelper<THelper>) => HelperApplyOptions<TContext, TInput, TOutput, TReporter>;
+    readonly onVisited: (state: TState, visited: Set<string>, rollbacks: RollbackEntry<THelper>[]) => TState;
+    readonly readRollbacks?: (state: TState) => RollbackEntry<THelper>[] | undefined;
+};
+export declare function runHelperRollbackPlan<TContext, TOptions, TArtifact, THelper extends {
+    key: string;
+}>(plan: HelperRollbackPlan<TContext, TOptions, TArtifact, THelper>, error: unknown): MaybePromise<void>;
+export type HelperStageRunPlan<TState, TRunResult, TContext, TOptions, TArtifact, THelper extends {
+    key: string;
+}> = {
+    readonly state: TState;
+    readonly program: Program<TState>;
+    readonly rollbackPlan: HelperRollbackPlan<TContext, TOptions, TArtifact, THelper>;
+    readonly halt: (error?: unknown) => Halt<TRunResult>;
+};
+export declare function runHelperStageWithRollback<TState, TRunResult, TContext, TOptions, TArtifact, THelper extends {
+    key: string;
+}>(plan: HelperStageRunPlan<TState, TRunResult, TContext, TOptions, TArtifact, THelper>): MaybePromise<TState | Halt<TRunResult>>;
+export type RollbackToHaltPlan<TRunResult, TContext, TOptions, TArtifact, THelper extends {
+    key: string;
+}> = {
+    readonly rollbackPlan: HelperRollbackPlan<TContext, TOptions, TArtifact, THelper>;
+    readonly halt: (error?: unknown) => Halt<TRunResult>;
+};
+export declare function runRollbackToHalt<TRunResult, TContext, TOptions, TArtifact, THelper extends {
+    key: string;
+}>(plan: RollbackToHaltPlan<TRunResult, TContext, TOptions, TArtifact, THelper>, error: unknown): MaybePromise<Halt<TRunResult>>;
+export declare function makeHelperStageFactory<TState, TRunResult, TContext, TOptions, TArtifact, TReporter extends PipelineReporter>(config: StageEnv<TState, TRunResult, TContext, TOptions, TArtifact, TReporter>): <TKind extends HelperKind, THelper extends Helper<TContext, TInput, TOutput, TReporter, TKind>, TInput, TOutput>(spec: HelperStageSpec<TState, TContext, TReporter, TKind, THelper, TInput, TOutput>) => Program<TState | Halt<TRunResult>>;
+//# sourceMappingURL=pipeline-program-utils.d.ts.map

package/dist/internal/pipeline-program-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline-program-utils.d.ts","sourceRoot":"","sources":["../../src/internal/pipeline-program-utils.ts"],"names":[],"mappings":"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"}

package/dist/internal/pipeline-program-utils.js

@@ -0,0 +1,161 @@
+import { maybeTry as g, maybeThen as H, isPromiseLike as S } from "../async-utils.js";
+import { executeHelpers as x } from "../executor.js";
+import { runRollbackStack as y } from "../rollback.js";
+function O(r) {
+  return !!(r && typeof r == "object" && "__halt" in r && r.__halt === !0);
+}
+function C(r) {
+  const {
+    getOrder: t,
+    makeArgs: n,
+    invoke: o,
+    recordStep: l,
+    onVisited: a,
+    registerRollback: k
+  } = r, b = (c, i, p) => {
+    const s = o({ helper: c, args: i, next: p });
+    return k ? S(s) ? s.then((e) => {
+      k(c, e);
+    }) : (k(c, s), s) : s;
+  };
+  return (c) => {
+    const i = t(c), p = x(i, n(c), b, l);
+    return H(
+      p,
+      (s) => a(c, s)
+    );
+  };
+}
+function T(r) {
+  const { isHalt: t, snapshotFragments: n, applyArtifact: o } = r;
+  return (l) => t(l) ? l : o(l, n(l));
+}
+function _(r) {
+  const { isHalt: t, execute: n } = r;
+  return (o) => t(o) ? o : n(o);
+}
+function z(r) {
+  const { isHalt: t, commit: n, rollbackToHalt: o } = r, l = (a) => {
+    const k = () => a;
+    return g(
+      () => H(n(a), k),
+      (c) => o(a, c)
+    );
+  };
+  return (a) => t(a) ? a : l(a);
+}
+function V(r) {
+  const { isHalt: t, finalize: n } = r;
+  return (o) => t(o) ? o : n(o);
+}
+function E(r, t) {
+  const { context: n, rollbackContext: o, helperRollbacks: l, onHelperRollbackError: a } = r, k = o.extensionCoordinator && o.extensionState ? o.extensionCoordinator.createRollbackHandler(
+    o.extensionState
+  ) : (i) => {
+    throw i;
+  };
+  return g(() => H(
+    y(
+      l.map((i) => ({
+        ...i.rollback,
+        key: i.helper.key
+      })),
+      {
+        source: "helper",
+        onError: ({
+          error: i,
+          metadata: p,
+          entry: s
+        }) => {
+          const e = l.find(
+            (u) => u.helper.key === (s.key ?? "")
+          );
+          e && a && a({
+            error: i,
+            helper: e.helper,
+            errorMetadata: p,
+            context: n
+          });
+        }
+      }
+    ),
+    () => k(t)
+  ), () => {
+  });
+}
+function P(r) {
+  const { state: t, program: n, rollbackPlan: o, halt: l } = r;
+  return g(() => n(t), (b) => F(
+    {
+      rollbackPlan: o,
+      halt: l
+    },
+    b
+  ));
+}
+function F(r, t) {
+  return H(
+    E(r.rollbackPlan, t),
+    () => r.halt(t)
+  );
+}
+function j(r) {
+  return function(n) {
+    const {
+      pushStep: o,
+      toRollbackContext: l,
+      halt: a,
+      isHalt: k,
+      onHelperRollbackError: b
+    } = r, c = ({
+      helper: e,
+      args: u,
+      next: m
+    }) => e.apply(u, m), i = (e) => o(e), p = (e) => (u, m) => {
+      if (!(!m || typeof m != "object") && "rollback" in m) {
+        const f = m.rollback;
+        f && e.push({ helper: u, rollback: f });
+      }
+    }, s = () => b ? (e) => b({
+      ...e,
+      helper: e.helper
+    }) : void 0;
+    return (e) => {
+      if (k(e))
+        return e;
+      const u = [
+        ...n.readRollbacks?.(e) ?? []
+      ], m = l(e), f = C({
+        getOrder: n.getOrder,
+        makeArgs: n.makeArgs,
+        invoke: c,
+        recordStep: i,
+        onVisited: (h, R) => n.onVisited(h, R, u),
+        registerRollback: p(u)
+      }), d = {
+        context: m.context,
+        rollbackContext: m,
+        helperRollbacks: u,
+        onHelperRollbackError: s()
+      };
+      return P({
+        state: e,
+        program: f,
+        rollbackPlan: d,
+        halt: a
+      });
+    };
+  };
+}
+export {
+  C as createHelpersProgram,
+  O as isHalt,
+  _ as makeAfterFragmentsStage,
+  z as makeCommitStage,
+  T as makeFinalizeFragmentsStage,
+  V as makeFinalizeResultStage,
+  j as makeHelperStageFactory,
+  E as runHelperRollbackPlan,
+  P as runHelperStageWithRollback,
+  F as runRollbackToHalt
+};

package/dist/internal/pipeline-runner.d.ts

@@ -8,7 +8,7 @@ import { PipelineRunner, PipelineRunnerDependencies } from './pipeline-runner.ty
  * public {@link createPipeline} entry point remains focused on registration while the runner keeps
  * lifecycle sequencing isolated and testable.
  *
- * @param    dependencies
+ * @param    dependencies - Bundled factory methods, diagnostics, and registered helpers
  * @category Pipeline
  * @internal
  */

package/dist/internal/pipeline-runner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pipeline-runner.d.ts","sourceRoot":"","sources":["../../src/internal/pipeline-runner.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAGX,MAAM,EACN,UAAU,EACV,gBAAgB,EAChB,kBAAkB,EAMlB,MAAM,UAAU,CAAC;AAMlB,OAAO,KAAK,EAEX,cAAc,EACd,0BAA0B,EAC1B,MAAM,yBAAyB,CAAC;AAEjC;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CACjC,WAAW,EACX,aAAa,EACb,QAAQ,SAAS;IAAE,QAAQ,EAAE,SAAS,CAAA;CAAE,EACxC,SAAS,SAAS,gBAAgB,EAClC,MAAM,EACN,SAAS,EACT,WAAW,SAAS,kBAAkB,EACtC,UAAU,EACV,cAAc,EACd,eAAe,EACf,aAAa,EACb,cAAc,EACd,aAAa,SAAS,UAAU,EAChC,YAAY,SAAS,UAAU,EAC/B,eAAe,SAAS,MAAM,CAC7B,QAAQ,EACR,cAAc,EACd,eAAe,EACf,SAAS,EACT,aAAa,CACb,EACD,cAAc,SAAS,MAAM,CAC5B,QAAQ,EACR,aAAa,EACb,cAAc,EACd,SAAS,EACT,YAAY,CACZ,EAED,YAAY,EAAE,0BAA0B,CACvC,WAAW,EACX,aAAa,EACb,QAAQ,EACR,SAAS,EACT,MAAM,EACN,SAAS,EACT,WAAW,EACX,UAAU,EACV,cAAc,EACd,eAAe,EACf,aAAa,EACb,cAAc,EACd,aAAa,EACb,YAAY,EACZ,eAAe,EACf,cAAc,CACd,GACC,cAAc,CAChB,WAAW,EACX,aAAa,EACb,QAAQ,EACR,SAAS,EACT,MAAM,EACN,SAAS,EACT,WAAW,EACX,UAAU,EACV,cAAc,EACd,eAAe,EACf,aAAa,EACb,cAAc,EACd,aAAa,EACb,YAAY,EACZ,eAAe,EACf,cAAc,CACd,CA8ZA"}
+{"version":3,"file":"pipeline-runner.d.ts","sourceRoot":"","sources":["../../src/internal/pipeline-runner.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAEX,MAAM,EACN,UAAU,EACV,gBAAgB,EAChB,kBAAkB,EAQlB,MAAM,UAAU,CAAC;AAMlB,OAAO,KAAK,EAEX,cAAc,EACd,0BAA0B,EAM1B,MAAM,yBAAyB,CAAC;AAejC;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CACjC,WAAW,EACX,aAAa,EACb,QAAQ,SAAS;IAAE,QAAQ,EAAE,SAAS,CAAA;CAAE,EACxC,SAAS,SAAS,gBAAgB,EAClC,MAAM,EACN,SAAS,EACT,WAAW,SAAS,kBAAkB,EACtC,UAAU,EACV,cAAc,EACd,eAAe,EACf,aAAa,EACb,cAAc,EACd,aAAa,SAAS,UAAU,EAChC,YAAY,SAAS,UAAU,EAC/B,eAAe,SAAS,MAAM,CAC7B,QAAQ,EACR,cAAc,EACd,eAAe,EACf,SAAS,EACT,aAAa,CACb,EACD,cAAc,SAAS,MAAM,CAC5B,QAAQ,EACR,aAAa,EACb,cAAc,EACd,SAAS,EACT,YAAY,CACZ,EAED,YAAY,EAAE,0BAA0B,CACvC,WAAW,EACX,aAAa,EACb,QAAQ,EACR,SAAS,EACT,MAAM,EACN,SAAS,EACT,WAAW,EACX,UAAU,EACV,cAAc,EACd,eAAe,EACf,aAAa,EACb,cAAc,EACd,aAAa,EACb,YAAY,EACZ,eAAe,EACf,cAAc,CACd,GACC,cAAc,CAChB,WAAW,EACX,aAAa,EACb,QAAQ,EACR,SAAS,EACT,MAAM,EACN,SAAS,EACT,WAAW,EACX,UAAU,EACV,cAAc,EACd,eAAe,EACf,aAAa,EACb,cAAc,EACd,aAAa,EACb,YAAY,EACZ,eAAe,EACf,cAAc,CACd,CA2pBA"}