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

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

@@ -1,6 +1,9 @@
 import { CreateDependencyGraphOptions, RegisteredHelper } from '../dependency-graph';
+import { Program } from '../async-utils';
 import { ErrorFactory } from '../error-factory';
-import { CreatePipelineOptions, Helper, HelperApplyOptions, HelperKind, MaybePromise, PipelineDiagnostic, PipelineExecutionMetadata, PipelineExtensionHookOptions, PipelineExtensionLifecycle, PipelineExtensionRollbackErrorMetadata, PipelineReporter, PipelineStep } from '../types';
+import { CreatePipelineOptions, Helper, HelperApplyOptions, HelperExecutionSnapshot, HelperKind, MaybePromise, PipelineDiagnostic, PipelineExecutionMetadata, PipelineExtensionHookOptions, PipelineExtensionLifecycle, PipelineExtensionRollbackErrorMetadata, PipelineReporter, PipelineStep } from '../types';
+import { PipelineRollback } from '../rollback';
+import { ExtensionCoordinator, ExtensionLifecycleState } from './extension-coordinator.types';
 import { DiagnosticManager } from './diagnostic-manager.types';
 import { ExtensionHookEntry } from '../extensions';
 /**
@@ -18,6 +21,7 @@ export interface PipelineRunContext<TRunOptions, TBuildOptions, TContext, TDraft
     readonly fragmentOrder: RegisteredHelper<TFragmentHelper>[];
     readonly steps: PipelineStep[];
     readonly pushStep: (entry: RegisteredHelper<unknown>) => void;
+    readonly helperOrders: Map<string, RegisteredHelper<unknown>[]>;
     readonly builderGraphOptions: CreateDependencyGraphOptions<TBuilderHelper>;
     readonly buildHookOptions: (artifact: TArtifact, lifecycle: PipelineExtensionLifecycle) => PipelineExtensionHookOptions<TContext, TRunOptions, TArtifact>;
     readonly handleRollbackError: (options: {
@@ -45,6 +49,7 @@ export interface PipelineRunnerDependencies<TRunOptions, TBuildOptions, TContext
     readonly fragmentKind: TFragmentKind;
     readonly builderKind: TBuilderKind;
     readonly diagnosticManager: DiagnosticManager<TRunOptions, TBuildOptions, TContext, TReporter, TDraft, TArtifact, TDiagnostic, TRunResult, TFragmentInput, TFragmentOutput, TBuilderInput, TBuilderOutput, TFragmentKind, TBuilderKind, TFragmentHelper, TBuilderHelper>;
+    readonly helperRegistries: Map<string, RegisteredHelper<unknown>[]>;
     readonly createError: ErrorFactory;
     readonly resolveRunResult: (state: {
         readonly artifact: TArtifact;
@@ -56,7 +61,26 @@ export interface PipelineRunnerDependencies<TRunOptions, TBuildOptions, TContext
         readonly helpers: PipelineExecutionMetadata<TFragmentKind, TBuilderKind>;
     }) => TRunResult;
     readonly extensionHooks: ExtensionHookEntry<TContext, TRunOptions, TArtifact>[];
+    readonly extensionLifecycles?: string[];
+    readonly 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 type PipelineStage<TState, TResult> = Program<TState | TResult>;
+export type DefaultStageDeps<TState, TResult, TContext, TRunOptions, TArtifact, TReporter extends PipelineReporter> = {
+    readonly runnerEnv: StageEnv<TState, TResult, TContext, TRunOptions, TArtifact, TReporter>;
+    readonly fragmentStage: PipelineStage<TState, Halt<TResult>>;
+    readonly builderStage: PipelineStage<TState, Halt<TResult>>;
+    readonly finalizeFragments: PipelineStage<TState, Halt<TResult>>;
+    readonly commitStage: PipelineStage<TState, Halt<TResult>>;
+    readonly finalizeResult: PipelineStage<TState, Halt<TResult>>;
+    readonly makeLifecycleStage: (lifecycle: string) => PipelineStage<TState, Halt<TResult>>;
+    readonly makeHelperStage: (kind: string, spec?: {
+        makeArgs?: (state: TState) => (entry: RegisteredHelper<unknown>) => unknown;
+        onVisited?: (state: TState, visited: Set<string>, rollbacks: unknown[]) => TState;
+    }) => PipelineStage<TState, Halt<TResult>>;
+    readonly extensions?: {
+        readonly lifecycles?: string[];
+    };
+};
 /**
  * Public surface returned by {@link initPipelineRunner}. Downstream consumers receive a helper to
  * prepare the context (building dependency graphs, instantiating drafts) and an executor that runs
@@ -75,5 +99,97 @@ export interface PipelineRunner<TRunOptions, TBuildOptions, TContext extends {
         helperArgs: HelperApplyOptions<unknown, unknown, unknown>;
     };
 }
+/**
+ * Closed-world state threaded through composed pipeline programs. While the implementation still
+ * mutates some nested values (e.g. `steps`), every program returns a new state value to keep the
+ * orchestrator closed under composition.
+ *
+ * @category Pipeline
+ * @internal
+ */
+export interface PipelineState<TRunOptions, TBuildOptions, TContext extends {
+    reporter: TReporter;
+}, TReporter extends PipelineReporter, TDraft, TArtifact, TDiagnostic extends PipelineDiagnostic, 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>> {
+    readonly context: TContext;
+    readonly reporter: TReporter;
+    readonly runOptions: TRunOptions;
+    readonly buildOptions: TBuildOptions;
+    readonly fragmentEntries: RegisteredHelper<TFragmentHelper>[];
+    readonly builderEntries: RegisteredHelper<TBuilderHelper>[];
+    readonly fragmentOrder: RegisteredHelper<TFragmentHelper>[];
+    readonly builderOrder: RegisteredHelper<TBuilderHelper>[];
+    readonly fragmentVisited: Set<string>;
+    readonly builderVisited: Set<string>;
+    readonly helperOrders?: Map<string, RegisteredHelper<unknown>[]>;
+    readonly draft: TDraft;
+    readonly artifact: TArtifact | null;
+    readonly steps: PipelineStep[];
+    readonly diagnostics: TDiagnostic[];
+    readonly fragmentExecution?: HelperExecutionSnapshot<TFragmentKind>;
+    readonly builderExecution?: HelperExecutionSnapshot<TBuilderKind>;
+    readonly helperExecution?: Map<string, HelperExecutionSnapshot>;
+    readonly helpers?: PipelineExecutionMetadata<TFragmentKind, TBuilderKind>;
+    readonly fragmentRollbacks?: Array<{
+        readonly helper: TFragmentHelper;
+        readonly rollback: PipelineRollback;
+    }>;
+    readonly builderRollbacks?: Array<{
+        readonly helper: TBuilderHelper;
+        readonly rollback: PipelineRollback;
+    }>;
+    readonly helperRollbacks?: Map<string, Array<{
+        readonly helper: unknown;
+        readonly rollback: PipelineRollback;
+    }>>;
+    readonly extensionCoordinator?: ExtensionCoordinator<TContext, TRunOptions, TArtifact>;
+    readonly extensionState?: ExtensionLifecycleState<TContext, TRunOptions, TArtifact>;
+}
 export type { ExtensionHookEntry };
+export type RollbackCapableCoordinator<TContext, TOptions, TArtifact> = {
+    createRollbackHandler: <TResult>(state: ExtensionLifecycleState<TContext, TOptions, TArtifact>) => (error: unknown) => MaybePromise<TResult>;
+};
+export type RollbackEntry<THelper> = {
+    readonly helper: THelper;
+    readonly rollback: PipelineRollback;
+};
+export type Halt<TRunResult> = {
+    readonly __halt: true;
+    readonly error?: unknown;
+    readonly result?: TRunResult;
+};
+export type RollbackContext<TContext, TOptions, TArtifact> = {
+    readonly context: TContext;
+    readonly extensionCoordinator?: RollbackCapableCoordinator<TContext, TOptions, TArtifact>;
+    readonly extensionState?: ExtensionLifecycleState<TContext, TOptions, TArtifact>;
+};
+export type HelperInvokeOptions<THelper, TInput, TOutput, TContext, TReporter extends PipelineReporter> = {
+    readonly helper: THelper;
+    readonly args: HelperApplyOptions<TContext, TInput, TOutput, TReporter>;
+    readonly next: () => MaybePromise<void>;
+};
+export type StageEnv<TState, TRunResult, TContext, TOptions, TArtifact, TReporter extends PipelineReporter> = {
+    pushStep: (entry: RegisteredHelper<unknown>) => void;
+    toRollbackContext: (state: TState) => RollbackContext<TContext, TOptions, TArtifact>;
+    halt: (error?: unknown) => Halt<TRunResult>;
+    isHalt: (value: unknown) => value is Halt<TRunResult>;
+    onHelperRollbackError?: (options: {
+        readonly error: unknown;
+        readonly helper: Helper<TContext, unknown, unknown, TReporter, HelperKind>;
+        readonly errorMetadata: PipelineExtensionRollbackErrorMetadata;
+        readonly context: TContext;
+    }) => void;
+};
+export type HelperRollbackPlan<TContext, TOptions, TArtifact, THelper extends {
+    key: string;
+}> = {
+    readonly context: TContext;
+    readonly rollbackContext: RollbackContext<TContext, TOptions, TArtifact>;
+    readonly helperRollbacks: readonly RollbackEntry<THelper>[];
+    readonly onHelperRollbackError?: (options: {
+        readonly error: unknown;
+        readonly helper: THelper;
+        readonly errorMetadata: PipelineExtensionRollbackErrorMetadata;
+        readonly context: TContext;
+    }) => void;
+};
 //# sourceMappingURL=pipeline-runner.types.d.ts.map

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

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

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

@@ -0,0 +1,6 @@
+import { PipelineReporter, HelperKind, Helper, PipelineDiagnostic } from '../../types';
+import { PipelineRunContext, PipelineRunnerDependencies } from '../pipeline-runner.types';
+export declare const prepareContext: <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>, runOptions: TRunOptions) => PipelineRunContext<TRunOptions, TBuildOptions, TContext, TDraft, TArtifact, TFragmentHelper, TBuilderHelper>;
+//# sourceMappingURL=context.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../src/internal/runner/context.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAIX,gBAAgB,EAEhB,UAAU,EACV,MAAM,EACN,kBAAkB,EAElB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EACX,kBAAkB,EAClB,0BAA0B,EAC1B,MAAM,0BAA0B,CAAC;AAElC,eAAO,MAAM,cAAc,GAC1B,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,WAAW,KACrB,kBAAkB,CACpB,WAAW,EACX,aAAa,EACb,QAAQ,EACR,MAAM,EACN,SAAS,EACT,eAAe,EACf,cAAc,CA6Od,CAAC"}

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,13 +1,8 @@
-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
  * @category Pipeline
  * @internal
@@ -15,4 +10,4 @@ import { PipelineRunner, PipelineRunnerDependencies } from './pipeline-runner.ty
 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"}