@wpkernel/pipeline 0.12.1-beta.0 → 0.12.2-beta.0

package/dist/extensions/official.js

@@ -0,0 +1,111 @@
+/**
+ * @wpkernel/pipeline
+ * @license EUPL-1.2
+ */
+const e = [
+  {
+    id: "live-runner",
+    status: "in-development",
+    summary: "Provides live progress, retry orchestration, and interactive prompts powered by reporter events.",
+    factory: {
+      name: "createLivePipelineRunExtension",
+      slug: "live-runner",
+      options: {
+        renderer: "PipelineReporterRenderer",
+        retries: "{ default: number; helpers?: Record<string, number>; }",
+        prompts: "PromptAdapter"
+      }
+    },
+    behaviours: [
+      {
+        name: "Live progress renderer",
+        description: "Stream helper lifecycle events to a renderer so users can observe DAG execution in real time.",
+        reporterEvents: [
+          "pipeline:run:started",
+          "pipeline:helper:started",
+          "pipeline:helper:succeeded",
+          "pipeline:helper:failed"
+        ],
+        integrations: [
+          "Terminal renderers that consume structured pipeline reporter events.",
+          "Remote observability tools that aggregate helper lifecycle data."
+        ]
+      },
+      {
+        name: "Retry and recovery prompts",
+        description: "Allow helpers to declare retry policies and surface interactive prompts when failures occur.",
+        helperAnnotations: [
+          "helper.meta.retryPolicy",
+          "helper.meta.prompt"
+        ],
+        integrations: [
+          "Prompt adapters that negotiate stdin/stdout access for interactive CLIs."
+        ]
+      },
+      {
+        name: "Reporter-driven telemetry",
+        description: "Emit structured progress payloads so headless environments can capture telemetry without a TTY renderer.",
+        reporterEvents: [
+          "pipeline:progress:update",
+          "pipeline:retry:scheduled",
+          "pipeline:retry:completed"
+        ]
+      }
+    ],
+    pipelineTouchPoints: [
+      "Consumes helper-provided metadata via createHelper() options.",
+      "Subscribes to reporter hooks exposed on the pipeline context.",
+      "Registers a single extension hook through createPipelineExtension."
+    ],
+    rolloutNotes: [
+      "Full extension keys are constructed with the pipeline namespace constant from @wpkernel/core/contracts.",
+      "Initial milestone focuses on read-only telemetry to validate event semantics.",
+      "Interactive prompts ship once reporter transport supports stdin multiplexing.",
+      "Retries remain deterministic by respecting helper dependency ordering."
+    ]
+  },
+  {
+    id: "concurrency",
+    status: "planned",
+    summary: "Adds a scheduler that can run independent helper branches in parallel without violating dependency constraints.",
+    factory: {
+      name: "createDeterministicConcurrencyExtension",
+      slug: "concurrency",
+      options: {
+        maxConcurrency: 'number | "auto"',
+        groups: "Record<string, number>"
+      }
+    },
+    behaviours: [
+      {
+        name: "Deterministic worker pool",
+        description: "Implements a ready-queue executor that only schedules helpers whose dependencies have settled.",
+        helperAnnotations: ["helper.meta.concurrencyGroup"],
+        integrations: [
+          "Workload schedulers that expose capacity metrics or enforce rate limits."
+        ]
+      },
+      {
+        name: "Reporter integration",
+        description: "Propagates worker state (idle, busy, saturated) via reporter events so renderers can show resource usage.",
+        reporterEvents: [
+          "pipeline:concurrency:queue",
+          "pipeline:concurrency:worker-state"
+        ]
+      }
+    ],
+    pipelineTouchPoints: [
+      "Wraps executeHelpers() with a concurrency-aware scheduler.",
+      "Requires dependency graph snapshots for ready-queue calculation.",
+      "Extends helper registration validation to guard conflicting group caps."
+    ],
+    rolloutNotes: [
+      "Full extension keys are constructed with the pipeline namespace constant from @wpkernel/core/contracts.",
+      "Prototype with read-only metrics before enabling true parallel execution.",
+      "Guarantee stable helper ordering for equal-priority tasks to aid reproducibility."
+    ]
+  }
+];
+export {
+  e as OFFICIAL_EXTENSION_BLUEPRINTS
+};

package/dist/extensions.d.ts

@@ -1,4 +1,4 @@
-import { MaybePromise, PipelineExtensionHook, PipelineExtensionHookOptions, PipelineExtensionHookResult, PipelineExtensionRollbackErrorMetadata } from './types';
+import { MaybePromise, PipelineExtensionHook, PipelineExtensionHookOptions, PipelineExtensionHookResult, PipelineExtensionRollbackErrorMetadata, PipelineExtensionLifecycle } from './types';
 /**
  * An extension hook entry with its unique key.
  *
@@ -6,6 +6,7 @@ import { MaybePromise, PipelineExtensionHook, PipelineExtensionHookOptions, Pipe
  */
 export interface ExtensionHookEntry<TContext, TOptions, TArtifact> {
     readonly key: string;
+    readonly lifecycle: PipelineExtensionLifecycle;
     readonly hook: PipelineExtensionHook<TContext, TOptions, TArtifact>;
 }
 /**
@@ -46,13 +47,14 @@ export declare function createRollbackErrorMetadata(error: unknown): PipelineExt
  * If any hook throws, automatically rolls back all previously executed hooks in reverse order.
  *
  * @param hooks           - The extension hooks to run
+ * @param lifecycle
  * @param options         - Context, options, and initial artifact
  * @param onRollbackError - Callback invoked if a rollback itself fails
  * @returns The final artifact and all hook execution results
  *
  * @internal
  */
-export declare function runExtensionHooks<TContext, TOptions, TArtifact>(hooks: readonly ExtensionHookEntry<TContext, TOptions, TArtifact>[], options: PipelineExtensionHookOptions<TContext, TOptions, TArtifact>, onRollbackError: (args: RollbackErrorArgs) => void): MaybePromise<{
+export declare function runExtensionHooks<TContext, TOptions, TArtifact>(hooks: readonly ExtensionHookEntry<TContext, TOptions, TArtifact>[], lifecycle: PipelineExtensionLifecycle, options: PipelineExtensionHookOptions<TContext, TOptions, TArtifact>, onRollbackError: (args: RollbackErrorArgs) => void): MaybePromise<{
     artifact: TArtifact;
     results: ExtensionHookExecution<TContext, TOptions, TArtifact>[];
 }>;
@@ -80,4 +82,6 @@ export declare function commitExtensionResults<TContext, TOptions, TArtifact>(re
  * @internal
  */
 export declare function rollbackExtensionResults<TContext, TOptions, TArtifact>(results: readonly ExtensionHookExecution<TContext, TOptions, TArtifact>[], hooks: readonly ExtensionHookEntry<TContext, TOptions, TArtifact>[], onRollbackError: (args: RollbackErrorArgs) => void): MaybePromise<void>;
+export { OFFICIAL_EXTENSION_BLUEPRINTS } from './extensions/official.js';
+export type { OfficialExtensionBlueprint, ExtensionBlueprint, ExtensionBehaviour, ExtensionFactorySignature, } from './extensions/official.js';
 //# sourceMappingURL=extensions.d.ts.map

package/dist/extensions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"extensions.d.ts","sourceRoot":"","sources":["../src/extensions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,YAAY,EACZ,qBAAqB,EACrB,4BAA4B,EAC5B,2BAA2B,EAC3B,sCAAsC,EACtC,MAAM,SAAS,CAAC;AAQjB;;;;GAIG;AACH,MAAM,WAAW,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,EAAE,SAAS;IAChE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,qBAAqB,CAAC,QAAQ,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;CACpE;AAED;;;;GAIG;AACH,MAAM,WAAW,sBAAsB,CAAC,QAAQ,EAAE,QAAQ,EAAE,SAAS;IACpE,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;IACjE,QAAQ,CAAC,MAAM,EAAE,2BAA2B,CAAC,SAAS,CAAC,CAAC;CACxD;AAED;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IACjC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1C,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;CACzC;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,2BAA2B,CAC1C,KAAK,EAAE,OAAO,GACZ,sCAAsC,CAoBxC;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAC9D,KAAK,EAAE,SAAS,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,EAAE,SAAS,CAAC,EAAE,EACnE,OAAO,EAAE,4BAA4B,CAAC,QAAQ,EAAE,QAAQ,EAAE,SAAS,CAAC,EACpE,eAAe,EAAE,CAAC,IAAI,EAAE,iBAAiB,KAAK,IAAI,GAChD,YAAY,CAAC;IACf,QAAQ,EAAE,SAAS,CAAC;IACpB,OAAO,EAAE,sBAAsB,CAAC,QAAQ,EAAE,QAAQ,EAAE,SAAS,CAAC,EAAE,CAAC;CACjE,CAAC,CAuDD;AAED;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,QAAQ,EAAE,SAAS,EACnE,OAAO,EAAE,SAAS,sBAAsB,CAAC,QAAQ,EAAE,QAAQ,EAAE,SAAS,CAAC,EAAE,GACvE,YAAY,CAAC,IAAI,CAAC,CAcpB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,QAAQ,EAAE,SAAS,EACrE,OAAO,EAAE,SAAS,sBAAsB,CAAC,QAAQ,EAAE,QAAQ,EAAE,SAAS,CAAC,EAAE,EACzE,KAAK,EAAE,SAAS,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,EAAE,SAAS,CAAC,EAAE,EACnE,eAAe,EAAE,CAAC,IAAI,EAAE,iBAAiB,KAAK,IAAI,GAChD,YAAY,CAAC,IAAI,CAAC,CA2BpB"}
+{"version":3,"file":"extensions.d.ts","sourceRoot":"","sources":["../src/extensions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,YAAY,EACZ,qBAAqB,EACrB,4BAA4B,EAC5B,2BAA2B,EAC3B,sCAAsC,EACtC,0BAA0B,EAC1B,MAAM,SAAS,CAAC;AAQjB;;;;GAIG;AACH,MAAM,WAAW,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,EAAE,SAAS;IAChE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,SAAS,EAAE,0BAA0B,CAAC;IAC/C,QAAQ,CAAC,IAAI,EAAE,qBAAqB,CAAC,QAAQ,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;CACpE;AAED;;;;GAIG;AACH,MAAM,WAAW,sBAAsB,CAAC,QAAQ,EAAE,QAAQ,EAAE,SAAS;IACpE,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;IACjE,QAAQ,CAAC,MAAM,EAAE,2BAA2B,CAAC,SAAS,CAAC,CAAC;CACxD;AAED;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IACjC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1C,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;CACzC;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,2BAA2B,CAC1C,KAAK,EAAE,OAAO,GACZ,sCAAsC,CAoBxC;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAC9D,KAAK,EAAE,SAAS,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,EAAE,SAAS,CAAC,EAAE,EACnE,SAAS,EAAE,0BAA0B,EACrC,OAAO,EAAE,4BAA4B,CAAC,QAAQ,EAAE,QAAQ,EAAE,SAAS,CAAC,EACpE,eAAe,EAAE,CAAC,IAAI,EAAE,iBAAiB,KAAK,IAAI,GAChD,YAAY,CAAC;IACf,QAAQ,EAAE,SAAS,CAAC;IACpB,OAAO,EAAE,sBAAsB,CAAC,QAAQ,EAAE,QAAQ,EAAE,SAAS,CAAC,EAAE,CAAC;CACjE,CAAC,CA8DD;AAED;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,QAAQ,EAAE,SAAS,EACnE,OAAO,EAAE,SAAS,sBAAsB,CAAC,QAAQ,EAAE,QAAQ,EAAE,SAAS,CAAC,EAAE,GACvE,YAAY,CAAC,IAAI,CAAC,CAcpB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,QAAQ,EAAE,SAAS,EACrE,OAAO,EAAE,SAAS,sBAAsB,CAAC,QAAQ,EAAE,QAAQ,EAAE,SAAS,CAAC,EAAE,EACzE,KAAK,EAAE,SAAS,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,EAAE,SAAS,CAAC,EAAE,EACnE,eAAe,EAAE,CAAC,IAAI,EAAE,iBAAiB,KAAK,IAAI,GAChD,YAAY,CAAC,IAAI,CAAC,CA2BpB;AAED,OAAO,EAAE,6BAA6B,EAAE,MAAM,0BAA0B,CAAC;AACzE,YAAY,EACX,0BAA0B,EAC1B,kBAAkB,EAClB,kBAAkB,EAClB,yBAAyB,GACzB,MAAM,0BAA0B,CAAC"}

package/dist/extensions.js

@@ -1,78 +1,83 @@
-import { maybeTry as m, maybeThen as l, processSequentially as f, isPromiseLike as k } from "./async-utils.js";
+import { processSequentially as l, isPromiseLike as k, maybeTry as h, maybeThen as m } from "./async-utils.js";
 /**
  * @wpkernel/pipeline
  * @license EUPL-1.2
  */
-function p(t) {
+function x(t) {
   if (t instanceof Error) {
-    const { name: o, message: r, stack: e } = t, n = t.cause;
+    const { name: n, message: o, stack: e } = t, r = t.cause;
     return {
-      name: o,
-      message: r,
+      name: n,
+      message: o,
       stack: e,
-      cause: n
+      cause: r
     };
   }
   return typeof t == "string" ? {
     message: t
   } : {};
 }
-function v(t, o, r) {
-  let e = o.artifact;
-  const n = [], u = m(
-    () => f(t, (s) => {
-      const i = s.hook({
-        context: o.context,
-        options: o.options,
-        artifact: e
+function y(t, n, o, e) {
+  let r = o.artifact;
+  const s = [], u = t.filter(
+    (i) => i.lifecycle === n
+  ), f = {
+    context: o.context,
+    options: o.options,
+    lifecycle: n
+  }, p = h(
+    () => l(u, (i) => {
+      const c = i.hook({
+        ...f,
+        artifact: r
       });
-      if (k(i))
-        return Promise.resolve(i).then((a) => {
-          a && (a.artifact !== void 0 && (e = a.artifact), n.push({
-            hook: s,
+      if (k(c))
+        return Promise.resolve(c).then((a) => {
+          a && (a.artifact !== void 0 && (r = a.artifact), s.push({
+            hook: i,
             result: a
           }));
         });
-      if (i)
-        return i.artifact !== void 0 && (e = i.artifact), void n.push({
-          hook: s,
-          result: i
+      if (c)
+        return c.artifact !== void 0 && (r = c.artifact), void s.push({
+          hook: i,
+          result: c
         });
     }),
-    (s) => l(
-      h(n, t, r),
+    (i) => m(
+      d(s, u, e),
       () => {
-        throw s;
+        throw i;
       }
     )
   );
-  return l(u, () => ({ artifact: e, results: n }));
+  return m(p, () => ({ artifact: r, results: s }));
 }
-function x(t) {
-  return f(t, (o) => {
-    const r = o.result.commit;
-    if (!r)
+function E(t) {
+  return l(t, (n) => {
+    const o = n.result.commit;
+    if (!o)
       return;
-    const e = r();
+    const e = o();
     if (k(e))
       return e.then(() => {
       });
   });
 }
-function h(t, o, r) {
-  const e = o.map((c) => c.key), n = e;
-  return f(
+function d(t, n, o) {
+  const e = n.map((s) => s.key), r = e;
+  return l(
     [...t].reverse(),
-    (c) => {
-      const u = c.result.rollback;
+    (s) => {
+      const u = s.result.rollback;
       if (u)
-        return m(
+        return h(
           () => u(),
-          (s) => {
-            r({
-              error: s,
+          (f) => {
+            o({
+              error: f,
               extensionKeys: e,
-              hookSequence: n
+              hookSequence: r
             });
           }
         );
@@ -81,8 +86,8 @@ function h(t, o, r) {
   );
 }
 export {
-  x as commitExtensionResults,
-  p as createRollbackErrorMetadata,
-  h as rollbackExtensionResults,
-  v as runExtensionHooks
+  E as commitExtensionResults,
+  x as createRollbackErrorMetadata,
+  d as rollbackExtensionResults,
+  y as runExtensionHooks
 };

package/dist/index.d.ts

@@ -6,10 +6,12 @@ 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, PipelineDiagnostic, ConflictDiagnostic, MissingDependencyDiagnostic, UnusedHelperDiagnostic, Helper, HelperApplyFn, HelperDescriptor, HelperKind, HelperMode, CreateHelperOptions, HelperApplyOptions, MaybePromise, PipelineStep, PipelineRunState, HelperExecutionSnapshot, PipelineExecutionMetadata, FragmentFinalizationMetadata, PipelineExtensionRollbackErrorMetadata, } from './types';
+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 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,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"}
+{"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"}

package/dist/index.js

@@ -1,31 +1,33 @@
 import { createHelper as o } from "./helper.js";
-import { createPipeline as a } from "./createPipeline.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 x, createErrorFactory as c } from "./error-factory.js";
-import { handleExtensionRegisterResult as f, registerExtensionHook as E, registerHelper as H } from "./registration.js";
-import { compareHelpers as u, createHelperId as b } from "./dependency-graph.js";
-import { isPromiseLike as g, maybeThen as k, maybeTry as P, processSequentially as R } from "./async-utils.js";
-import { createRollbackErrorMetadata as T } from "./extensions.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
  */
 export {
-  u as compareHelpers,
-  x as createDefaultError,
+  L as OFFICIAL_EXTENSION_BLUEPRINTS,
+  I as compareHelpers,
+  s as createDefaultError,
   c as createErrorFactory,
   o as createHelper,
-  b as createHelperId,
-  a as createPipeline,
+  u as createHelperId,
+  p as createPipeline,
   i as createPipelineExtension,
-  T as createRollbackErrorMetadata,
+  k as createRollbackErrorMetadata,
   m as executeHelpers,
-  f as handleExtensionRegisterResult,
-  g as isPromiseLike,
-  k as maybeThen,
-  P as maybeTry,
-  R as processSequentially,
+  n as handleExtensionRegisterResult,
+  R as isPromiseLike,
+  T as maybeThen,
+  b as maybeTry,
+  d as processSequentially,
   E as registerExtensionHook,
   H as registerHelper
 };

package/dist/internal/diagnostic-manager.d.ts

@@ -0,0 +1,29 @@
+import { DiagnosticManager, DiagnosticManagerInitConfig } from './diagnostic-manager.types';
+import { Helper, HelperKind, PipelineDiagnostic, PipelineReporter } from '../types';
+/**
+ * Creates a diagnostic manager instance scoped to a pipeline.
+ *
+ * The manager collects helper registration conflicts, missing dependencies, unused helper
+ * notifications, and runtime diagnostics. It stores them until the reporter becomes available and
+ * replays the backlog immediately when one is provided. This keeps `createPipeline` focused on the
+ * high-level orchestration while the manager owns stateful bookkeeping concerns.
+ *
+ * @param    params
+ * @example
+ * ```ts
+ * const manager = initDiagnosticManager({
+ *   options,
+ *   fragmentKind: 'fragment',
+ *   builderKind: 'builder',
+ * });
+ * manager.flagUnusedHelper(helper, 'fragment', 'not executed', []);
+ * manager.record({ type: 'conflict', key: 'demo', mode: 'extend', helpers: [], message: '' });
+ * ```
+ *
+ * @category Pipeline
+ * @internal
+ */
+export declare function initDiagnosticManager<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>>(params: DiagnosticManagerInitConfig<TRunOptions, TBuildOptions, TContext, TReporter, TDraft, TArtifact, TDiagnostic, TRunResult, TFragmentInput, TFragmentOutput, TBuilderInput, TBuilderOutput, TFragmentKind, TBuilderKind, TFragmentHelper, TBuilderHelper>): DiagnosticManager<TRunOptions, TBuildOptions, TContext, TReporter, TDraft, TArtifact, TDiagnostic, TRunResult, TFragmentInput, TFragmentOutput, TBuilderInput, TBuilderOutput, TFragmentKind, TBuilderKind, TFragmentHelper, TBuilderHelper>;
+//# sourceMappingURL=diagnostic-manager.d.ts.map

package/dist/internal/diagnostic-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostic-manager.d.ts","sourceRoot":"","sources":["../../src/internal/diagnostic-manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,iBAAiB,EACjB,2BAA2B,EAC3B,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EACX,MAAM,EAEN,UAAU,EACV,kBAAkB,EAClB,gBAAgB,EAChB,MAAM,UAAU,CAAC;AAGlB;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,qBAAqB,CACpC,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,MAAM,EAAE,2BAA2B,CAClC,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,iBAAiB,CACnB,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,CA6LA"}

package/dist/internal/diagnostic-manager.js

@@ -0,0 +1,94 @@
+/**
+ * @wpkernel/pipeline
+ * @license EUPL-1.2
+ */
+function w(i) {
+  const g = [], a = /* @__PURE__ */ new WeakMap();
+  let s;
+  const d = (e, n) => e === i.fragmentKind ? `Fragment helper "${n.key}"` : e === i.builderKind ? `Builder helper "${n.key}"` : `Helper "${n.key}"`, u = (e) => {
+    if (!s || !i.options.onDiagnostic)
+      return;
+    const n = a.get(s);
+    if (n?.has(e))
+      return;
+    const t = n ?? /* @__PURE__ */ new Set();
+    i.options.onDiagnostic({
+      reporter: s,
+      diagnostic: e
+    }), t.add(e), n || a.set(s, t);
+  }, c = (e) => {
+    g.push(e), u(e);
+  }, y = (e, n, t, o) => {
+    const r = i.options.createConflictDiagnostic?.({
+      helper: e,
+      existing: n,
+      message: o
+    }) ?? {
+      type: "conflict",
+      key: e.key,
+      mode: e.mode,
+      helpers: [
+        n.origin ?? n.key,
+        e.origin ?? e.key
+      ],
+      message: o,
+      kind: t
+    };
+    c(r);
+  }, p = (e, n, t) => {
+    const o = `${d(
+      t,
+      e
+    )} depends on unknown helper "${n}".`, r = i.options.createMissingDependencyDiagnostic?.({
+      helper: e,
+      dependency: n,
+      message: o
+    }) ?? {
+      type: "missing-dependency",
+      key: e.key,
+      dependency: n,
+      message: o,
+      kind: t,
+      helper: e.origin ?? e.key
+    };
+    c(r);
+  }, f = (e, n, t, o) => {
+    const r = `${d(n, e)} ${t}.`, k = i.options.createUnusedHelperDiagnostic?.({
+      helper: e,
+      message: r
+    }) ?? {
+      type: "unused-helper",
+      key: e.key,
+      message: r,
+      kind: n,
+      helper: e.origin ?? e.key,
+      dependsOn: o
+    };
+    c(k);
+  };
+  return {
+    describeHelper: d,
+    flagConflict: y,
+    flagMissingDependency: p,
+    flagUnusedHelper: f,
+    reviewUnusedHelpers: (e, n, t) => {
+      for (const o of e)
+        n.has(o.id) || f(
+          o.helper,
+          t,
+          "was registered but never executed",
+          o.helper.dependsOn
+        );
+    },
+    setReporter: (e) => {
+      if (s = e, !!s)
+        for (const n of g)
+          u(n);
+    },
+    record: c,
+    readDiagnostics: () => g
+  };
+}
+export {
+  w as initDiagnosticManager
+};

package/dist/internal/diagnostic-manager.types.d.ts

@@ -0,0 +1,70 @@
+import { RegisteredHelper } from '../dependency-graph';
+import { CreatePipelineOptions, Helper, HelperDescriptor, HelperKind, PipelineDiagnostic, PipelineReporter } from '../types';
+/**
+ * Shared structural contract for the diagnostic subsystem used by {@link createPipeline}.
+ *
+ * The `DiagnosticManager` is intentionally generic so that downstream pipelines can customise
+ * context, helper kinds, artifact shapes, and reporter implementations without leaking internal
+ * types. All implementations produced by {@link initDiagnosticManager} honour this interface.
+ *
+ * @template TRunOptions   - Options accepted by `pipeline.run()`
+ * @template TBuildOptions - Options produced by `createBuildOptions`
+ * @template TContext      - Pipeline execution context, including the reporter instance
+ * @template TReporter     - Reporter type used to publish diagnostics
+ * @template TDraft        - Fragment draft produced before builders execute
+ * @template TArtifact     - Final artifact emitted by the pipeline
+ * @template TDiagnostic   - Diagnostic entry recorded during execution
+ * @template TRunResult    - Result returned by `pipeline.run()`
+ * @template TFragmentInput  - Input passed to fragment helpers
+ * @template TFragmentOutput - Output produced by fragment helpers
+ * @template TBuilderInput   - Input passed to builder helpers
+ * @template TBuilderOutput  - Output produced by builder helpers
+ * @template TFragmentKind   - Helper kind identifier for fragment helpers
+ * @template TBuilderKind    - Helper kind identifier for builder helpers
+ * @template TFragmentHelper - Helper implementation registered in the fragment stage
+ * @template TBuilderHelper  - Helper implementation registered in the builder stage
+ *
+ * @category Pipeline
+ * @internal
+ */
+export interface DiagnosticManager<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>> {
+    readonly describeHelper: (kind: HelperKind, helper: HelperDescriptor) => string;
+    readonly flagConflict: (helper: HelperDescriptor, existing: HelperDescriptor, kind: HelperKind, message: string) => void;
+    readonly flagMissingDependency: (helper: HelperDescriptor, dependency: string, kind: HelperKind) => void;
+    readonly flagUnusedHelper: (helper: HelperDescriptor, kind: HelperKind, reason: string, dependsOn: readonly string[]) => void;
+    readonly reviewUnusedHelpers: <THelper extends HelperDescriptor>(entries: RegisteredHelper<THelper>[], visited: Set<string>, kind: HelperKind) => void;
+    readonly setReporter: (reporter: TReporter | undefined) => void;
+    readonly record: (diagnostic: TDiagnostic) => void;
+    readonly readDiagnostics: () => readonly TDiagnostic[];
+    readonly __types?: {
+        readonly runOptions: TRunOptions;
+        readonly buildOptions: TBuildOptions;
+        readonly draft: TDraft;
+        readonly artifact: TArtifact;
+        readonly runResult: TRunResult;
+        readonly fragmentInput: TFragmentInput;
+        readonly fragmentOutput: TFragmentOutput;
+        readonly builderInput: TBuilderInput;
+        readonly builderOutput: TBuilderOutput;
+        readonly fragmentHelper: TFragmentHelper;
+        readonly builderHelper: TBuilderHelper;
+    };
+}
+/**
+ * Configuration object consumed by {@link initDiagnosticManager}. Splitting the type from the
+ * implementation keeps the orchestration module lightweight while enabling re-use in tests.
+ *
+ * @category Pipeline
+ * @internal
+ */
+export interface DiagnosticManagerInitConfig<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>> {
+    readonly options: CreatePipelineOptions<TRunOptions, TBuildOptions, TContext, TReporter, TDraft, TArtifact, TDiagnostic, TRunResult, TFragmentInput, TFragmentOutput, TBuilderInput, TBuilderOutput, TFragmentKind, TBuilderKind, TFragmentHelper, TBuilderHelper>;
+    readonly fragmentKind: TFragmentKind;
+    readonly builderKind: TBuilderKind;
+}
+export type { ErrorFactory } from '../error-factory';
+//# sourceMappingURL=diagnostic-manager.types.d.ts.map

package/dist/internal/diagnostic-manager.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostic-manager.types.d.ts","sourceRoot":"","sources":["../../src/internal/diagnostic-manager.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,KAAK,EACX,qBAAqB,EACrB,MAAM,EACN,gBAAgB,EAChB,UAAU,EACV,kBAAkB,EAClB,gBAAgB,EAChB,MAAM,UAAU,CAAC;AAElB;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,WAAW,iBAAiB,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;IAED,QAAQ,CAAC,cAAc,EAAE,CACxB,IAAI,EAAE,UAAU,EAChB,MAAM,EAAE,gBAAgB,KACpB,MAAM,CAAC;IACZ,QAAQ,CAAC,YAAY,EAAE,CACtB,MAAM,EAAE,gBAAgB,EACxB,QAAQ,EAAE,gBAAgB,EAC1B,IAAI,EAAE,UAAU,EAChB,OAAO,EAAE,MAAM,KACX,IAAI,CAAC;IACV,QAAQ,CAAC,qBAAqB,EAAE,CAC/B,MAAM,EAAE,gBAAgB,EACxB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,UAAU,KACZ,IAAI,CAAC;IACV,QAAQ,CAAC,gBAAgB,EAAE,CAC1B,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,UAAU,EAChB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,SAAS,MAAM,EAAE,KACxB,IAAI,CAAC;IACV,QAAQ,CAAC,mBAAmB,EAAE,CAAC,OAAO,SAAS,gBAAgB,EAC9D,OAAO,EAAE,gBAAgB,CAAC,OAAO,CAAC,EAAE,EACpC,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC,EACpB,IAAI,EAAE,UAAU,KACZ,IAAI,CAAC;IACV,QAAQ,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE,SAAS,GAAG,SAAS,KAAK,IAAI,CAAC;IAChE,QAAQ,CAAC,MAAM,EAAE,CAAC,UAAU,EAAE,WAAW,KAAK,IAAI,CAAC;IACnD,QAAQ,CAAC,eAAe,EAAE,MAAM,SAAS,WAAW,EAAE,CAAC;IACvD,QAAQ,CAAC,OAAO,CAAC,EAAE;QAClB,QAAQ,CAAC,UAAU,EAAE,WAAW,CAAC;QACjC,QAAQ,CAAC,YAAY,EAAE,aAAa,CAAC;QACrC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC;QAC7B,QAAQ,CAAC,SAAS,EAAE,UAAU,CAAC;QAC/B,QAAQ,CAAC,aAAa,EAAE,cAAc,CAAC;QACvC,QAAQ,CAAC,cAAc,EAAE,eAAe,CAAC;QACzC,QAAQ,CAAC,YAAY,EAAE,aAAa,CAAC;QACrC,QAAQ,CAAC,aAAa,EAAE,cAAc,CAAC;QACvC,QAAQ,CAAC,cAAc,EAAE,eAAe,CAAC;QACzC,QAAQ,CAAC,aAAa,EAAE,cAAc,CAAC;KACvC,CAAC;CACF;AAED;;;;;;GAMG;AACH,MAAM,WAAW,2BAA2B,CAC3C,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;IAED,QAAQ,CAAC,OAAO,EAAE,qBAAqB,CACtC,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,CAAC;IACF,QAAQ,CAAC,YAAY,EAAE,aAAa,CAAC;IACrC,QAAQ,CAAC,WAAW,EAAE,YAAY,CAAC;CACnC;AAED,YAAY,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/internal/extension-coordinator.d.ts

@@ -0,0 +1,21 @@
+import { ExtensionCoordinator, ExtensionRollbackEvent } from './extension-coordinator.types';
+/**
+ * Builds an {@link ExtensionCoordinator} tailored to the provided rollback handler.
+ *
+ * @param    onRollbackError
+ * @example
+ * ```ts
+ * const coordinator = initExtensionCoordinator(({ error }) => console.warn(error));
+ * const state = await coordinator.runLifecycle('after-fragments', {
+ *   hooks,
+ *   options: hookOptions,
+ * });
+ * await coordinator.commit(state);
+ * ```
+ *
+ * @category Pipeline
+ * @internal
+ */
+export declare function initExtensionCoordinator<TContext, TOptions, TArtifact>(onRollbackError: (event: ExtensionRollbackEvent<TContext, TOptions, TArtifact>) => void): ExtensionCoordinator<TContext, TOptions, TArtifact>;
+export type { ExtensionLifecycleState, ExtensionHookEntry, } from './extension-coordinator.types';
+//# sourceMappingURL=extension-coordinator.d.ts.map

package/dist/internal/extension-coordinator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension-coordinator.d.ts","sourceRoot":"","sources":["../../src/internal/extension-coordinator.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EACX,oBAAoB,EAEpB,sBAAsB,EACtB,MAAM,+BAA+B,CAAC;AAGvC;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,QAAQ,EAAE,SAAS,EACrE,eAAe,EAAE,CAChB,KAAK,EAAE,sBAAsB,CAAC,QAAQ,EAAE,QAAQ,EAAE,SAAS,CAAC,KACxD,IAAI,GACP,oBAAoB,CAAC,QAAQ,EAAE,QAAQ,EAAE,SAAS,CAAC,CA+ErD;AAED,YAAY,EACX,uBAAuB,EACvB,kBAAkB,GAClB,MAAM,+BAA+B,CAAC"}