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

package/dist/internal/runner/context.js

@@ -0,0 +1,169 @@
+import { createDependencyGraph as b } from "../../dependency-graph.js";
+const H = (e, i) => {
+  const c = e.options.createBuildOptions(i), l = e.options.createContext(i);
+  e.diagnosticManager.setReporter(l.reporter);
+  const p = e.options.createFragmentState({
+    options: i,
+    context: l,
+    buildOptions: c
+  }), d = /* @__PURE__ */ new Map();
+  for (const [r, o] of e.helperRegistries.entries()) {
+    let n;
+    r === e.fragmentKind ? n = {
+      providedKeys: e.options.fragmentProvidedKeys,
+      onMissingDependency: ({ dependant: a, dependencyKey: s }) => {
+        const t = a.helper;
+        e.diagnosticManager.flagMissingDependency(
+          t,
+          s,
+          r
+        ), e.diagnosticManager.flagUnusedHelper(
+          t,
+          r,
+          `could not execute because dependency "${s}" was not found`,
+          t.dependsOn
+        );
+      },
+      onUnresolvedHelpers: ({ unresolved: a }) => {
+        for (const s of a) {
+          const t = s.helper;
+          e.diagnosticManager.flagUnusedHelper(
+            t,
+            r,
+            "could not execute because its dependencies never resolved",
+            t.dependsOn
+          );
+        }
+      }
+    } : r === e.builderKind ? n = {
+      providedKeys: e.options.builderProvidedKeys,
+      onMissingDependency: ({ dependant: a, dependencyKey: s }) => {
+        const t = a.helper;
+        e.diagnosticManager.flagMissingDependency(
+          t,
+          s,
+          e.builderKind
+        ), e.diagnosticManager.flagUnusedHelper(
+          t,
+          e.builderKind,
+          `could not execute because dependency "${s}" was not found`,
+          t.dependsOn
+        );
+      },
+      onUnresolvedHelpers: ({ unresolved: a }) => {
+        for (const s of a) {
+          const t = s.helper;
+          e.diagnosticManager.flagUnusedHelper(
+            t,
+            e.builderKind,
+            "could not execute because its dependencies never resolved",
+            t.dependsOn
+          );
+        }
+      }
+    } : n = {
+      onMissingDependency: ({ dependant: a, dependencyKey: s }) => {
+        const t = a.helper;
+        e.diagnosticManager.flagMissingDependency(
+          t,
+          s,
+          r
+        );
+      },
+      onUnresolvedHelpers: ({ unresolved: a }) => {
+        for (const s of a) {
+          const t = s.helper;
+          e.diagnosticManager.flagUnusedHelper(
+            t,
+            r,
+            "could not execute because its dependencies never resolved",
+            t.dependsOn
+          );
+        }
+      }
+    };
+    const { order: v } = b(
+      o,
+      n,
+      e.createError
+    );
+    d.set(r, v);
+  }
+  const u = d.get(e.fragmentKind) ?? [], g = [], f = (r) => {
+    const o = r.helper;
+    g.push({
+      id: r.id,
+      index: g.length,
+      key: o.key,
+      kind: o.kind,
+      mode: o.mode,
+      priority: o.priority,
+      dependsOn: o.dependsOn,
+      origin: o.origin
+    });
+  }, h = {
+    providedKeys: e.options.builderProvidedKeys,
+    onMissingDependency: ({ dependant: r, dependencyKey: o }) => {
+      const n = r.helper;
+      e.diagnosticManager.flagMissingDependency(
+        n,
+        o,
+        e.builderKind
+      ), e.diagnosticManager.flagUnusedHelper(
+        n,
+        e.builderKind,
+        `could not execute because dependency "${o}" was not found`,
+        n.dependsOn
+      );
+    },
+    onUnresolvedHelpers: ({ unresolved: r }) => {
+      for (const o of r) {
+        const n = o.helper;
+        e.diagnosticManager.flagUnusedHelper(
+          n,
+          e.builderKind,
+          "could not execute because its dependencies never resolved",
+          n.dependsOn
+        );
+      }
+    }
+  }, M = e.options.createExtensionHookOptions ?? ((r) => ({
+    context: r.context,
+    options: r.options,
+    artifact: r.artifact,
+    lifecycle: r.lifecycle
+  })), y = (r, o) => M({
+    context: l,
+    options: i,
+    buildOptions: c,
+    artifact: r,
+    lifecycle: o
+  }), x = e.options.onExtensionRollbackError ?? ((r) => {
+    const { reporter: o } = r.context, n = o.warn;
+    typeof n == "function" && n.call(o, "Pipeline extension rollback failed.", {
+      error: r.error,
+      errorName: r.errorMetadata.name,
+      errorMessage: r.errorMetadata.message,
+      errorStack: r.errorMetadata.stack,
+      errorCause: r.errorMetadata.cause,
+      extensions: r.extensionKeys,
+      hookKeys: r.hookSequence
+    });
+  });
+  return {
+    runOptions: i,
+    buildOptions: c,
+    context: l,
+    draft: p,
+    fragmentOrder: u,
+    steps: g,
+    pushStep: f,
+    helperOrders: d,
+    builderGraphOptions: h,
+    buildHookOptions: y,
+    handleRollbackError: x
+  };
+};
+export {
+  H as prepareContext
+};

package/dist/internal/runner/execution.d.ts

@@ -0,0 +1,6 @@
+import { Helper, HelperKind, PipelineDiagnostic, PipelineReporter, MaybePromise } from '../../types';
+import { PipelineRunContext, PipelineRunnerDependencies } from '../pipeline-runner.types';
+export declare const executeRun: <TRunOptions, TBuildOptions, TContext extends {
+    reporter: TReporter;
+}, TReporter extends PipelineReporter, TDraft, TArtifact, TDiagnostic extends PipelineDiagnostic, TRunResult, TFragmentInput, TFragmentOutput, TBuilderInput, TBuilderOutput, TFragmentKind extends HelperKind, TBuilderKind extends HelperKind, TFragmentHelper extends Helper<TContext, TFragmentInput, TFragmentOutput, TReporter, TFragmentKind>, TBuilderHelper extends Helper<TContext, TBuilderInput, TBuilderOutput, TReporter, TBuilderKind>>(dependencies: PipelineRunnerDependencies<TRunOptions, TBuildOptions, TContext, TReporter, TDraft, TArtifact, TDiagnostic, TRunResult, TFragmentInput, TFragmentOutput, TBuilderInput, TBuilderOutput, TFragmentKind, TBuilderKind, TFragmentHelper, TBuilderHelper>, runContext: PipelineRunContext<TRunOptions, TBuildOptions, TContext, TDraft, TArtifact, TFragmentHelper, TBuilderHelper>) => MaybePromise<TRunResult>;
+//# sourceMappingURL=execution.d.ts.map

package/dist/internal/runner/execution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution.d.ts","sourceRoot":"","sources":["../../../src/internal/runner/execution.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACX,MAAM,EACN,UAAU,EACV,kBAAkB,EAElB,gBAAgB,EAChB,YAAY,EACZ,MAAM,aAAa,CAAC;AAErB,OAAO,KAAK,EACX,kBAAkB,EAClB,0BAA0B,EAG1B,MAAM,0BAA0B,CAAC;AAGlC,eAAO,MAAM,UAAU,GACtB,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,cAAc,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,EACD,YAAY,kBAAkB,CAC7B,WAAW,EACX,aAAa,EACb,QAAQ,EACR,MAAM,EACN,SAAS,EACT,eAAe,EACf,cAAc,CACd,KACC,YAAY,CAAC,UAAU,CAkEzB,CAAC"}

package/dist/internal/runner/execution.js

@@ -0,0 +1,40 @@
+import { maybeThen as n } from "../../async-utils.js";
+import { isHalt as p } from "../pipeline-program-utils.js";
+import { createCoreProgram as a } from "./program.js";
+const m = (e, r) => {
+  const t = r.helperOrders.get(e.builderKind) ?? [], o = {
+    context: r.context,
+    reporter: r.context.reporter,
+    runOptions: r.runOptions,
+    buildOptions: r.buildOptions,
+    fragmentEntries: e.fragmentEntries,
+    builderEntries: e.builderEntries,
+    fragmentOrder: r.fragmentOrder,
+    builderOrder: t,
+    fragmentVisited: /* @__PURE__ */ new Set(),
+    builderVisited: /* @__PURE__ */ new Set(),
+    draft: r.draft,
+    artifact: null,
+    steps: r.steps,
+    diagnostics: [],
+    fragmentRollbacks: [],
+    builderRollbacks: [],
+    helperOrders: r.helperOrders
+  }, s = a(e, r), l = (i) => {
+    if (p(i))
+      throw i.error ?? new Error("Pipeline halted");
+    return e.resolveRunResult({
+      artifact: i.artifact,
+      diagnostics: i.diagnostics,
+      steps: i.steps,
+      context: i.context,
+      buildOptions: i.buildOptions,
+      options: i.runOptions,
+      helpers: i.helpers
+    });
+  };
+  return n(s(o), l);
+};
+export {
+  m as executeRun
+};

package/dist/internal/{pipeline-runner.d.ts → runner/index.d.ts}

@@ -1,18 +1,13 @@
-import { Helper, HelperKind, PipelineReporter, PipelineDiagnostic } from '../types';
-import { PipelineRunner, PipelineRunnerDependencies } from './pipeline-runner.types';
+import { Helper, HelperKind, PipelineDiagnostic, PipelineReporter } from '../../types';
+import { PipelineRunner, PipelineRunnerDependencies } from '../pipeline-runner.types';
 /**
  * Creates the orchestrator responsible for executing pipeline runs.
  *
- * The runner wires together dependency graph resolution, helper execution, and the official
- * extension framework via the {@link initExtensionCoordinator}. By extracting this logic, the
- * public {@link createPipeline} entry point remains focused on registration while the runner keeps
- * lifecycle sequencing isolated and testable.
- *
- * @param    dependencies - Bundled factory methods, diagnostics, and registered helpers
+ * @param    dependencies
  * @category Pipeline
  * @internal
  */
 export declare function initPipelineRunner<TRunOptions, TBuildOptions, TContext extends {
     reporter: TReporter;
 }, TReporter extends PipelineReporter, TDraft, TArtifact, TDiagnostic extends PipelineDiagnostic, TRunResult, TFragmentInput, TFragmentOutput, TBuilderInput, TBuilderOutput, TFragmentKind extends HelperKind, TBuilderKind extends HelperKind, TFragmentHelper extends Helper<TContext, TFragmentInput, TFragmentOutput, TReporter, TFragmentKind>, TBuilderHelper extends Helper<TContext, TBuilderInput, TBuilderOutput, TReporter, TBuilderKind>>(dependencies: PipelineRunnerDependencies<TRunOptions, TBuildOptions, TContext, TReporter, TDraft, TArtifact, TDiagnostic, TRunResult, TFragmentInput, TFragmentOutput, TBuilderInput, TBuilderOutput, TFragmentKind, TBuilderKind, TFragmentHelper, TBuilderHelper>): PipelineRunner<TRunOptions, TBuildOptions, TContext, TReporter, TDraft, TArtifact, TDiagnostic, TRunResult, TFragmentInput, TFragmentOutput, TBuilderInput, TBuilderOutput, TFragmentKind, TBuilderKind, TFragmentHelper, TBuilderHelper>;
-//# sourceMappingURL=pipeline-runner.d.ts.map
+//# sourceMappingURL=index.d.ts.map

package/dist/internal/runner/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/internal/runner/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,MAAM,EACN,UAAU,EACV,kBAAkB,EAClB,gBAAgB,EAChB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EACX,cAAc,EACd,0BAA0B,EAC1B,MAAM,0BAA0B,CAAC;AAIlC;;;;;;GAMG;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,CAMA"}

package/dist/internal/runner/index.js

@@ -0,0 +1,11 @@
+import { prepareContext as t } from "./context.js";
+import { executeRun as n } from "./execution.js";
+function u(r) {
+  return {
+    prepareContext: (e) => t(r, e),
+    executeRun: (e) => n(r, e)
+  };
+}
+export {
+  u as initPipelineRunner
+};

package/dist/internal/runner/program.d.ts

@@ -0,0 +1,8 @@
+import { Program } from '../../async-utils';
+import { Helper, HelperKind, PipelineReporter, PipelineDiagnostic } from '../../types';
+import { PipelineRunContext, PipelineRunnerDependencies, PipelineState, Halt, DefaultStageDeps, PipelineStage } from '../pipeline-runner.types';
+export declare function defaultStages<TState, TResult, TContext, TRunOptions, TArtifact, TReporter extends PipelineReporter>(deps: DefaultStageDeps<TState, TResult, TContext, TRunOptions, TArtifact, TReporter>): PipelineStage<TState, Halt<TResult>>[];
+export declare const createCoreProgram: <TRunOptions, TBuildOptions, TContext extends {
+    reporter: TReporter;
+}, TReporter extends PipelineReporter, TDraft, TArtifact, TDiagnostic extends PipelineDiagnostic, TRunResult, TFragmentInput, TFragmentOutput, TBuilderInput, TBuilderOutput, TFragmentKind extends HelperKind, TBuilderKind extends HelperKind, TFragmentHelper extends Helper<TContext, TFragmentInput, TFragmentOutput, TReporter, TFragmentKind>, TBuilderHelper extends Helper<TContext, TBuilderInput, TBuilderOutput, TReporter, TBuilderKind>>(dependencies: PipelineRunnerDependencies<TRunOptions, TBuildOptions, TContext, TReporter, TDraft, TArtifact, TDiagnostic, TRunResult, TFragmentInput, TFragmentOutput, TBuilderInput, TBuilderOutput, TFragmentKind, TBuilderKind, TFragmentHelper, TBuilderHelper>, runContext: PipelineRunContext<TRunOptions, TBuildOptions, TContext, TDraft, TArtifact, TFragmentHelper, TBuilderHelper>) => Program<PipelineState<TRunOptions, TBuildOptions, TContext, TReporter, TDraft, TArtifact, TDiagnostic, TFragmentInput, TFragmentOutput, TBuilderInput, TBuilderOutput, TFragmentKind, TBuilderKind, TFragmentHelper, TBuilderHelper> | Halt<TRunResult>>;
+//# sourceMappingURL=program.d.ts.map

package/dist/internal/runner/program.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"program.d.ts","sourceRoot":"","sources":["../../../src/internal/runner/program.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,KAAK,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAkBtE,OAAO,KAAK,EACX,MAAM,EACN,UAAU,EACV,gBAAgB,EAChB,kBAAkB,EAOlB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EACX,kBAAkB,EAClB,0BAA0B,EAC1B,aAAa,EACb,IAAI,EAIJ,gBAAgB,EAChB,aAAa,EAEb,MAAM,0BAA0B,CAAC;AAIlC,wBAAgB,aAAa,CAC5B,MAAM,EACN,OAAO,EACP,QAAQ,EACR,WAAW,EACX,SAAS,EACT,SAAS,SAAS,gBAAgB,EAElC,IAAI,EAAE,gBAAgB,CACrB,MAAM,EACN,OAAO,EACP,QAAQ,EACR,WAAW,EACX,SAAS,EACT,SAAS,CACT,GACC,aAAa,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,EAAE,CAuBxC;AAED,eAAO,MAAM,iBAAiB,GAC7B,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,cAAc,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,EACD,YAAY,kBAAkB,CAC7B,WAAW,EACX,aAAa,EACb,QAAQ,EACR,MAAM,EACN,SAAS,EACT,eAAe,EACf,cAAc,CACd,KACC,OAAO,CACP,aAAa,CACb,WAAW,EACX,aAAa,EACb,QAAQ,EACR,SAAS,EACT,MAAM,EACN,SAAS,EACT,WAAW,EACX,cAAc,EACd,eAAe,EACf,aAAa,EACb,cAAc,EACd,aAAa,EACb,YAAY,EACZ,eAAe,EACf,cAAc,CACb,GACD,IAAI,CAAC,UAAU,CAAC,CAwkBlB,CAAC"}

package/dist/internal/runner/program.js

@@ -0,0 +1,294 @@
+import { composeK as G, maybeThen as $ } from "../../async-utils.js";
+import { buildExecutionSnapshot as s, assertAllHelpersExecuted as S } from "../helper-execution.js";
+import { initExtensionCoordinator as j } from "../extension-coordinator.js";
+import { makeAfterFragmentsStage as q, makeFinalizeResultStage as I, makeCommitStage as J, makeFinalizeFragmentsStage as Q, makeHelperStageFactory as W, isHalt as c, runRollbackToHalt as X } from "../pipeline-program-utils.js";
+const Y = "after-fragments";
+function Z(o) {
+  const {
+    fragmentStage: l,
+    finalizeFragments: g,
+    builderStage: u,
+    commitStage: f,
+    finalizeResult: h,
+    makeLifecycleStage: x,
+    extensions: b
+  } = o, p = (b?.lifecycles ?? []).map(
+    x
+  );
+  return [
+    l,
+    g,
+    ...p,
+    u,
+    f,
+    h
+  ];
+}
+const ar = (o, l) => {
+  const g = (r) => ({
+    __halt: !0,
+    error: r
+  }), u = (r, t, n) => {
+    o.diagnosticManager.reviewUnusedHelpers(
+      r.fragmentEntries,
+      t,
+      o.fragmentKind
+    );
+    const e = s(
+      r.fragmentEntries,
+      t,
+      o.fragmentKind
+    );
+    return S(
+      r.fragmentEntries,
+      e,
+      o.fragmentKind,
+      o.diagnosticManager.describeHelper,
+      o.createError
+    ), {
+      ...r,
+      fragmentVisited: t,
+      fragmentExecution: e,
+      fragmentRollbacks: n
+    };
+  }, f = (r, t, n) => {
+    o.diagnosticManager.reviewUnusedHelpers(
+      r.builderEntries,
+      t,
+      o.builderKind
+    );
+    const e = s(
+      r.builderEntries,
+      t,
+      o.builderKind
+    );
+    return S(
+      r.builderEntries,
+      e,
+      o.builderKind,
+      o.diagnosticManager.describeHelper,
+      o.createError
+    ), {
+      ...r,
+      builderVisited: t,
+      builderExecution: e,
+      builderRollbacks: n
+    };
+  }, h = (r, t) => o.options.createFragmentArgs({
+    helper: t.helper,
+    options: r.runOptions,
+    context: r.context,
+    buildOptions: r.buildOptions,
+    draft: r.draft
+  }), x = (r, t) => o.options.createBuilderArgs({
+    helper: t.helper,
+    options: r.runOptions,
+    context: r.context,
+    buildOptions: r.buildOptions,
+    artifact: r.artifact
+  }), b = (r) => (t) => h(r, t), p = (r) => (t) => x(r, t), H = (r) => r.fragmentRollbacks, F = (r) => r.builderRollbacks ?? [], k = (r) => ({
+    context: r.context,
+    extensionCoordinator: r.extensionCoordinator,
+    extensionState: r.extensionState
+  }), y = (r) => r.fragmentExecution ?? s(
+    r.fragmentEntries,
+    r.fragmentVisited,
+    o.fragmentKind
+  ), z = (r) => {
+    const { extensionCoordinator: t, extensionState: n } = r;
+    if (!(!t || !n))
+      return t.commit(n);
+  }, M = (r) => ({
+    context: r.context,
+    rollbackContext: k(r),
+    helperRollbacks: r.builderRollbacks ?? [],
+    onHelperRollbackError: o.options.onHelperRollbackError
+  }), w = (r, t) => X(
+    {
+      rollbackPlan: M(r),
+      halt: g
+    },
+    t
+  ), P = (r) => (t) => {
+    const n = j(
+      ({ error: a, extensionKeys: i, hookSequence: m, errorMetadata: E }) => l.handleRollbackError({
+        error: a,
+        extensionKeys: i,
+        hookSequence: m,
+        errorMetadata: E,
+        context: t.context
+      })
+    ), e = n.runLifecycle(
+      r,
+      {
+        hooks: o.extensionHooks,
+        hookOptions: l.buildHookOptions(
+          t.artifact,
+          r
+        )
+      }
+    );
+    return $(
+      e,
+      (a) => ({
+        ...t,
+        artifact: a.artifact,
+        extensionCoordinator: n,
+        extensionState: a
+      })
+    );
+  }, d = (r) => r.helpers ?? {
+    fragments: r.fragmentExecution ?? s(
+      r.fragmentEntries,
+      r.fragmentVisited,
+      o.fragmentKind
+    ),
+    builders: r.builderExecution ?? s(
+      r.builderEntries,
+      r.builderVisited,
+      o.builderKind
+    )
+  }, B = (r) => ({
+    ...r,
+    helpers: d(r),
+    diagnostics: [
+      ...o.diagnosticManager.readDiagnostics()
+    ]
+  }), C = Q({
+    isHalt: c,
+    snapshotFragments: y,
+    applyArtifact: (r, t) => ({
+      ...r,
+      artifact: o.options.finalizeFragmentState({
+        draft: r.draft,
+        options: r.runOptions,
+        context: r.context,
+        buildOptions: r.buildOptions,
+        helpers: {
+          fragments: t
+        }
+      }),
+      fragmentExecution: t
+    })
+  }), L = (r) => q({
+    isHalt: c,
+    execute: P(r)
+  }), T = J({
+    isHalt: c,
+    commit: z,
+    rollbackToHalt: w
+  }), V = I({
+    isHalt: c,
+    finalize: B
+  }), v = {
+    getOrder: (r) => r.fragmentOrder,
+    makeArgs: b,
+    onVisited: (r, t, n) => u(r, t, n),
+    readRollbacks: H
+  }, U = {
+    getOrder: (r) => r.builderOrder,
+    makeArgs: p,
+    onVisited: (r, t, n) => f(r, t, n),
+    readRollbacks: F
+  }, R = W({
+    pushStep: l.pushStep,
+    toRollbackContext: k,
+    halt: g,
+    isHalt: c,
+    onHelperRollbackError: o.options.onHelperRollbackError
+  }), _ = R(v), N = R(U), O = {
+    runnerEnv: {
+      pushStep: l.pushStep,
+      toRollbackContext: k,
+      halt: g,
+      isHalt: c,
+      onHelperRollbackError: o.options.onHelperRollbackError
+    },
+    fragmentStage: _,
+    builderStage: N,
+    finalizeFragments: C,
+    commitStage: T,
+    finalizeResult: V,
+    makeLifecycleStage: L,
+    extensions: {
+      lifecycles: o.extensionHooks.length > 0 ? o.extensionLifecycles ?? [Y] : []
+    },
+    makeHelperStage: (r, t) => R(
+      {
+        getOrder: (e) => e.helperOrders?.get(r) ?? [],
+        makeArgs: (e) => {
+          if (t?.makeArgs)
+            return t.makeArgs(e);
+          if (r === o.fragmentKind)
+            return b(e);
+          if (r === o.builderKind)
+            return p(e);
+          throw new Error(`No args factory for kind "${r}"`);
+        },
+        onVisited: (e, a, i) => {
+          if (t?.onVisited)
+            return t.onVisited(
+              e,
+              a,
+              i
+            );
+          if (r === o.fragmentKind)
+            return u(
+              e,
+              a,
+              i
+            );
+          if (r === o.builderKind)
+            return f(
+              e,
+              a,
+              i
+            );
+          const m = e.helperOrders?.get(r) ?? [];
+          o.diagnosticManager.reviewUnusedHelpers(
+            m,
+            a,
+            r
+          );
+          const E = s(
+            m,
+            a,
+            r
+          );
+          S(
+            m,
+            E,
+            r,
+            o.diagnosticManager.describeHelper,
+            o.createError
+          );
+          const A = new Map(
+            e.helperExecution ?? []
+          );
+          A.set(r, E);
+          const K = new Map(
+            e.helperRollbacks ?? []
+          );
+          return K.set(
+            r,
+            i
+          ), {
+            ...e,
+            helperExecution: A,
+            helperRollbacks: K
+          };
+        },
+        readRollbacks: (e) => r === o.fragmentKind ? H(
+          e
+        ) : r === o.builderKind ? F(
+          e
+        ) : e.helperRollbacks?.get(r)
+      }
+    )
+  }, D = o.stages ? o.stages(O) : Z(O);
+  return G(...[...D].reverse());
+};
+export {
+  ar as createCoreProgram,
+  Z as defaultStages
+};

package/dist/makePipeline.d.ts

@@ -0,0 +1,20 @@
+import { CreatePipelineOptions, Helper, HelperKind, Pipeline, PipelineDiagnostic, PipelineReporter, PipelineRunState } from './types';
+import { DefaultStageDeps, PipelineStage, PipelineState, Halt } from './internal/pipeline-runner.types';
+export { DefaultStageDeps, PipelineStage, } from "./internal/pipeline-runner.types";
+export { defaultStages } from './internal/runner/program';
+export type MakePipelineArgs<TRunOptions, TReporter extends PipelineReporter = PipelineReporter, TContext extends {
+    reporter: TReporter;
+} = {
+    reporter: TReporter;
+}, TArtifact = unknown, TDiagnostic extends PipelineDiagnostic = PipelineDiagnostic, TRunResult = PipelineRunState<TArtifact, TDiagnostic>, TBuildOptions = unknown, TDraft = unknown, TFragmentInput = unknown, TFragmentOutput = unknown, TBuilderInput = unknown, TBuilderOutput = unknown, TFragmentKind extends HelperKind = 'fragment', TBuilderKind extends HelperKind = 'builder', TFragmentHelper extends Helper<TContext, TFragmentInput, TFragmentOutput, TReporter, TFragmentKind> = Helper<TContext, TFragmentInput, TFragmentOutput, TReporter, TFragmentKind>, TBuilderHelper extends Helper<TContext, TBuilderInput, TBuilderOutput, TReporter, TBuilderKind> = Helper<TContext, TBuilderInput, TBuilderOutput, TReporter, TBuilderKind>> = CreatePipelineOptions<TRunOptions, TBuildOptions, TContext, TReporter, TDraft, TArtifact, TDiagnostic, TRunResult, TFragmentInput, TFragmentOutput, TBuilderInput, TBuilderOutput, TFragmentKind, TBuilderKind, TFragmentHelper, TBuilderHelper> & {
+    extensions?: {
+        lifecycles?: string[];
+    };
+    stages?: (deps: DefaultStageDeps<PipelineState<TRunOptions, TBuildOptions, TContext, TReporter, TDraft, TArtifact, TDiagnostic, TFragmentInput, TFragmentOutput, TBuilderInput, TBuilderOutput, TFragmentKind, TBuilderKind, TFragmentHelper, TBuilderHelper>, TRunResult, TContext, TRunOptions, TArtifact, TReporter>) => PipelineStage<PipelineState<TRunOptions, TBuildOptions, TContext, TReporter, TDraft, TArtifact, TDiagnostic, TFragmentInput, TFragmentOutput, TBuilderInput, TBuilderOutput, TFragmentKind, TBuilderKind, TFragmentHelper, TBuilderHelper>, Halt<TRunResult>>[];
+};
+export declare function makePipeline<TRunOptions, TReporter extends PipelineReporter = PipelineReporter, TContext extends {
+    reporter: TReporter;
+} = {
+    reporter: TReporter;
+}, TArtifact = unknown, TDiagnostic extends PipelineDiagnostic = PipelineDiagnostic, TRunResult = PipelineRunState<TArtifact, TDiagnostic>, TBuildOptions = unknown, TDraft = unknown, TFragmentInput = unknown, TFragmentOutput = unknown, TBuilderInput = unknown, TBuilderOutput = unknown, TFragmentKind extends HelperKind = 'fragment', TBuilderKind extends HelperKind = 'builder', TFragmentHelper extends Helper<TContext, TFragmentInput, TFragmentOutput, TReporter, TFragmentKind> = Helper<TContext, TFragmentInput, TFragmentOutput, TReporter, TFragmentKind>, TBuilderHelper extends Helper<TContext, TBuilderInput, TBuilderOutput, TReporter, TBuilderKind> = Helper<TContext, TBuilderInput, TBuilderOutput, TReporter, TBuilderKind>>(options: MakePipelineArgs<TRunOptions, TReporter, TContext, TArtifact, TDiagnostic, TRunResult, TBuildOptions, TDraft, TFragmentInput, TFragmentOutput, TBuilderInput, TBuilderOutput, TFragmentKind, TBuilderKind, TFragmentHelper, TBuilderHelper>): Pipeline<TRunOptions, TRunResult, TContext, TReporter, TBuildOptions, TArtifact, TFragmentInput, TFragmentOutput, TBuilderInput, TBuilderOutput, TDiagnostic, TFragmentKind, TBuilderKind, TFragmentHelper, TBuilderHelper>;
+//# sourceMappingURL=makePipeline.d.ts.map

package/dist/makePipeline.d.ts.map

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