@feasibleone/blong-chain 1.10.0 → 1.11.0

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## [1.11.0](https://github.com/feasibleone/blong/compare/blong-chain-v1.10.0...blong-chain-v1.11.0) (2026-09-26)
+
+
+### Features
+
+* progress points in test reports ([fb73036](https://github.com/feasibleone/blong/commit/fb730360877eb371ab3d1603ae7bf35976c170dc))
+
+
+### Bug Fixes
+
+* misc CI failures ([60689af](https://github.com/feasibleone/blong/commit/60689af66dc246ef8f88fef8edbd2b8a16a6c4d9))
+
 ## [1.10.0](https://github.com/feasibleone/blong/compare/blong-chain-v1.9.0...blong-chain-v1.10.0) (2026-09-24)
 
 

package/index.ts

@@ -13,10 +13,12 @@
 import assert from 'node:assert';
 import {EventEmitter} from 'node:events';
 import PQueue from 'p-queue';
+import {progressTree, reportProgress} from './progress.ts';
 import type {
     IDependencyEdge,
     IDependencyGraph,
     IMeta,
+    IProgressEntry,
     IPromiseEntry,
     ISourceLocation,
     IStepError,
@@ -651,6 +653,43 @@ export class TestExecutor extends EventEmitter {
         await Promise.all(stepPromises);
     }
 
+    /**
+     * The invocation's progress list as it stands, for a read at a step boundary (PRD R26/R27).
+     *
+     * The `$meta` object is the one every step of this run shares — the same object the steps
+     * destructure, and the one the handlers they call are handed.
+     */
+    private _progressList(): IProgressEntry[] | undefined {
+        const progress = (this.realContext.$meta as IMeta | undefined)?.progress;
+        return Array.isArray(progress) ? progress : undefined;
+    }
+
+    /**
+     * What was announced since `seen`, or `undefined` when nothing was (PRD R26/R27).
+     *
+     * Two shapes, and both are ordinary. A list that still holds what it held is *appended* to,
+     * and the difference between the two boundary reads is the step's own progress. A list that
+     * no longer begins with those entries was **replaced**: a step that resets it to scope its
+     * own assertions (`$meta.progress = []`, which is how a scenario keeps one step's
+     * checkpoints out of the next one's) then owns everything in the new list, including when it
+     * happens to end up as long as it started.
+     *
+     * Best-effort attribution, and deliberately so: steps that run in parallel share the one
+     * list, so a point announced while two of them were running is reported by whichever
+     * boundary read it. It is never lost, and a scenario whose steps are ordered by their
+     * dependencies — which is what a test that asserts on progress is — has one at a time.
+     */
+    private _announcedSince(seen: IProgressEntry[] | undefined): IProgressEntry[] | undefined {
+        const progress = this._progressList();
+        if (progress === undefined || progress.length === 0) {
+            return undefined;
+        }
+        if (!keeps(progress, seen)) {
+            return progress;
+        }
+        return progress.length > seen.length ? progress.slice(seen.length) : undefined;
+    }
+
     /**
      * Executes a single step function
      */
@@ -701,8 +740,6 @@ export class TestExecutor extends EventEmitter {
         // Wrap execution function for potential test context wrapping
         // When a TAP sub-test context is supplied, assert is augmented with:
         //   assert.snapshot(value, 'name', opts?)   — explicit snapshot
-        //   assert.snapshot({mask?: []})             — deferred: snapshot the
-        //                                              step's return value
         //   assert.snapshot()                        — deferred, no extra mask
         // Deferred snapshots are taken after fn() returns, under the step name.
         // eslint-disable-next-line @typescript-eslint/no-this-alias
@@ -760,6 +797,7 @@ export class TestExecutor extends EventEmitter {
             this.graph.nodes.get(stepName)!.status = 'running';
             this.graph.nodes.get(stepName)!.startTime = latency.startedAt;
 
+            const progressBefore = this._progressList();
             this.emit('step:start', stepName, stepProgress);
 
             try {
@@ -821,6 +859,11 @@ export class TestExecutor extends EventEmitter {
                 // Store result in real context
                 this.realContext[stepName] = result;
 
+                // What this step announced, read at the boundary before the event so a
+                // listener that writes the step's result file sees it (see `step:end`).
+                const announced = this._announcedSince(progressBefore);
+                if (announced !== undefined) stepProgress.progress = announced;
+
                 // Resolve all promises for this step
                 this.promiseManager.resolveStep(stepName, result);
 
@@ -845,6 +888,24 @@ export class TestExecutor extends EventEmitter {
 
                 this.progress.completedSteps++;
                 this.emit('step:end', stepName, stepProgress);
+
+                // A point becomes a sub-test of the step that announced it, and a branch the
+                // sub-test holding the points taken inside it — a checkpoint as a *step* in
+                // the report, which is what "checkpoints drive test reporting" claims
+                // (PRD R26/R27). Rendered from the same entries `blong-allure` maps into
+                // Allure steps, so the two reports cannot describe different shapes.
+                //
+                // The context is checked the way the snapshot handling checks it, because
+                // the queue hands the task its own options where there is no test context:
+                // only a context that can nest a test gets progress nested in it.
+                if (
+                    typeof stepTestContext?.test === 'function' &&
+                    stepProgress.progress !== undefined
+                ) {
+                    for (const node of progressTree(stepProgress.progress)) {
+                        await reportProgress(stepTestContext, node);
+                    }
+                }
             } catch (error) {
                 // Handle error
                 latency.completedAt = Date.now();
@@ -869,6 +930,12 @@ export class TestExecutor extends EventEmitter {
                 this.graph.nodes.get(stepName)!.endTime = latency.completedAt;
                 this.graph.nodes.get(stepName)!.error = error as Error;
 
+                // Kept even though the step failed, and especially then: what a failing step
+                // announced is the evidence a reader wants, and Allure renders it from here.
+                // The tap side leaves it out — sub-tests are not added to a step that threw.
+                const announcedOnFailure = this._announcedSince(progressBefore);
+                if (announcedOnFailure !== undefined) stepProgress.progress = announcedOnFailure;
+
                 this.progress.failedSteps++;
                 this.emit('step:error', stepName, error as Error, stepProgress);
                 this.log?.error?.({err: error}, `step ${stepName} failed`);
@@ -1117,3 +1184,21 @@ export class TestExecutor extends EventEmitter {
 
 // Export all types
 export type * from './test-types.js';
+export {progressTree, reportProgress} from './progress.ts';
+
+/**
+ * Whether a progress list still holds what it held, entry for entry and by identity.
+ *
+ * Identity rather than equality, because the entries are objects the recorder pushed: a list
+ * that kept them is one that was spread back with additions, and a list whose first entry is a
+ * different object is one that was reset and announced afresh — which is the difference between
+ * a step *adding* to the invocation's progress and *replacing* it.
+ */
+const keeps = (
+    progress: IProgressEntry[],
+    seen: IProgressEntry[] | undefined,
+): seen is IProgressEntry[] =>
+    progress === seen ||
+    (seen !== undefined &&
+        progress.length >= seen.length &&
+        seen.every((entry, at) => progress[at] === entry));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@feasibleone/blong-chain",
-  "version": "1.10.0",
+  "version": "1.11.0",
   "description": "Parallel testing with automatic dependencies",
   "keywords": [
     "blong",
@@ -24,7 +24,7 @@
     "@types/node": "^24",
     "tap": "^21.6.3",
     "typescript": "^6.0.3",
-    "@feasibleone/blong-dev": "1.6.0"
+    "@feasibleone/blong-dev": "1.7.0"
   },
   "scripts": {
     "build": "heft build --clean",
@@ -34,6 +34,6 @@
     "ci-publish": "node ../../common/scripts/install-run-rush-pnpm.js publish --access public --provenance",
     "ci-test": "blong-dev test '*.test.ts';./test-examples-ci.sh",
     "test": "blong-dev test '*.test.ts';./test-examples-ci.sh",
-    "test:examples": "node --test dist/examples/*.test.js"
+    "test:examples": "node --test examples/*.test.ts"
   }
 }

package/test-types.ts

@@ -78,6 +78,15 @@ export type StepArray = (StepFunction | StepArray | SnapshotMarker)[] & {name?:
 export interface IMeta {
     /** Optional concurrency limit for parallel step execution */
     concurrency?: number;
+    /**
+     * What the invocation has announced so far, in the order it announced it (PRD R26/R27).
+     *
+     * The same array a framework dispatch keeps on its own `$meta`: the handlers a step calls
+     * are handed this object, so whatever they announce while it runs appears here — which is
+     * the only place the executor can read a step's progress from, and why it reads it at the
+     * step's boundaries.
+     */
+    progress?: IProgressEntry[];
     /** Additional metadata properties */
     [key: string]: unknown;
 }
@@ -89,6 +98,14 @@ export interface IMeta {
 export interface ITestFrameworkContext {
     /** Creates a nested test scope for proper indentation */
     test: (name: string, fn: (t: unknown) => void | Promise<void>) => unknown;
+    /**
+     * Writes a comment into the run's output (`# …` in TAP).
+     *
+     * What a point is reported as: a moment a step passed through is not a test,
+     * so it does not deserve a sub-test of its own — but it is what a reader
+     * wants to see beside the step, which is what a comment is.
+     */
+    comment?: (text: string) => void;
     /** Captures a snapshot of a value under the given name */
     matchSnapshot?: (value: unknown, name: string) => void;
 }
@@ -201,6 +218,71 @@ export interface IDependencyEdge {
 // Progress Tracking Types
 // ============================================================================
 
+/**
+ * A branch as a progress entry names it (PRD R11/R26).
+ *
+ * Declared structurally here, matching the framework's own declaration in
+ * `core/blong/types.ts` the way {@link IMeta} does, because this package stands at the bottom
+ * of the dependency graph with `p-queue` as its only dependency. The names are what a report
+ * groups by; the position a log mints for itself is deliberately not here.
+ */
+export interface IRegionMark {
+    /** What the branch was about, stable across runs. */
+    discriminator: string;
+    /** Every candidate considered, in evaluation order. */
+    candidates: string[];
+    /** The branch taken, or `none` when none of them matched. */
+    chosen: string;
+}
+
+/** A milestone an invocation announced (PRD R26). */
+export interface IProgressPoint {
+    /** Which of the two shapes this entry is; one array holds both. */
+    kind: 'point';
+    /** Stable name of the moment, e.g. `total-calculated`. */
+    name: string;
+    /** What was true there; kept locally, exactly as a record keeps it. */
+    data?: unknown;
+    /** When it was announced, in epoch milliseconds. */
+    timestamp: number;
+    /** The branches it was announced *inside*, outermost first. */
+    regions?: IRegionMark[];
+}
+
+/** A branch the invocation took, in the same array as the points (PRD R11/R26). */
+export interface IProgressRegion extends IRegionMark {
+    /** Which of the two shapes this entry is; one array holds both. */
+    kind: 'region';
+    /** The values the decision was made from. */
+    values: Record<string, unknown>;
+    /** The branches this one was itself taken inside, outermost first. */
+    regions?: IRegionMark[];
+}
+
+/** One entry of an invocation's `progress` list. */
+export type IProgressEntry = IProgressPoint | IProgressRegion;
+
+/**
+ * One node of the progress tree a report is drawn from (PRD R26/R27).
+ *
+ * `name` is the display name rather than the raw entry, so both renderers label a branch the
+ * same way: `<discriminator> = <chosen>` for a region, the point's own name for a point.
+ */
+export interface IProgressNode {
+    /** What a report calls it: the point's name, or `<discriminator> = <chosen>`. */
+    name: string;
+    /** Which of the two shapes it is. */
+    kind: 'point' | 'region';
+    /**
+     * What the point announced, printed beside it when it is small enough to read.
+     *
+     * A branch carries none: what it has to say is its name.
+     */
+    data?: Record<string, unknown>;
+    /** The points and branches announced inside it, in the order they were announced. */
+    children: IProgressNode[];
+}
+
 /**
  * Overall test execution progress
  */
@@ -259,6 +341,17 @@ export interface IStepProgress {
     result?: unknown;
     /** Error information if step failed */
     error?: IStepError;
+    /**
+     * What this step announced while it ran (PRD R26/R27), or absent when it announced
+     * nothing.
+     *
+     * Read from the invocation's own list at the step's boundaries rather than reported by the
+     * step: the handlers it called announced into the `$meta` every step shares, so the window
+     * is the only thing that attributes a point to the step that made it. A report draws these
+     * as the step's nested steps — a point as a step, a branch as the group of the points
+     * taken inside it.
+     */
+    progress?: IProgressEntry[];
 }
 
 /**

package/dist/examples/demo.test.d.ts

@@ -1,6 +0,0 @@
-/**
- * Demonstration of nested test context with automatic indentation
- * Run with: node --test demo.test.js
- */
-export {};
-//# sourceMappingURL=demo.test.d.ts.map

package/dist/examples/demo.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"demo.test.d.ts","sourceRoot":"","sources":["../../examples/demo.test.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/examples/demo.test.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"demo.test.js","sourceRoot":"","sources":["../../examples/demo.test.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAC,MAAM,EAAC,MAAM,aAAa,CAAC;AACnC,OAAO,EAAC,QAAQ,EAAE,EAAE,EAAC,MAAM,WAAW,CAAC;AACvC,OAAO,EAAC,YAAY,EAAC,MAAM,aAAa,CAAC;AAGzC,QAAQ,CAAC,sDAAsD,EAAE,GAAG,EAAE;IAClE,EAAE,CAAC,oCAAoC,EAAE,KAAK,EAAC,CAAC,EAAC,EAAE;QAC/C,MAAM,QAAQ,GAAG,IAAI,YAAY,CAAC,EAAC,WAAW,EAAE,EAAE,EAAC,CAAC,CAAC;QAErD,4BAA4B;QAC5B,MAAM,kBAAkB,GAAc;YAClC,KAAK,UAAU,iBAAiB;gBAC5B,OAAO,CAAC,GAAG,CAAC,2BAA2B,CAAC,CAAC;gBACzC,OAAO,EAAC,UAAU,EAAE,mBAAmB,EAAE,MAAM,EAAE,WAAW,EAAC,CAAC;YAClE,CAAC;YACD,KAAK,UAAU,WAAW,CAAC,MAAM,EAAE,OAAO;gBACtC,MAAM,EAAE,GAAG,CAAC,MAAM,OAAO,CAAC,iBAAiB,CAG1C,CAAC;gBACF,OAAO,CAAC,GAAG,CAAC,wBAAwB,EAAE,CAAC,UAAU,EAAE,CAAC,CAAC;gBACrD,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;gBACrC,OAAO,EAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAC,CAAC;YAC3C,CAAC;SACJ,CAAC;QACF,kBAAkB,CAAC,IAAI,GAAG,gBAAgB,CAAC;QAE3C,MAAM,cAAc,GAAc;YAC9B,KAAK,UAAU,UAAU,CAAC,MAAM,EAAE,OAAO;gBACrC,MAAM,KAAK,GAAG,CAAC,MAAM,OAAO,CAAC,WAAW,CAAsC,CAAC;gBAC/E,OAAO,CAAC,GAAG,CAAC,oBAAoB,KAAK,CAAC,KAAK,QAAQ,CAAC,CAAC;gBACrD,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;gBAClC,OAAO,EAAC,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,OAAO,EAAC,CAAC;YACtC,CAAC;YACD,KAAK,UAAU,UAAU,CAAC,MAAM,EAAE,OAAO;gBACrC,MAAM,IAAI,GAAG,CAAC,MAAM,OAAO,CAAC,UAAU,CAAmC,CAAC;gBAC1E,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,CAAC,IAAI,SAAS,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;gBAC/D,OAAO,EAAC,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAC,CAAC;YACjE,CAAC;SACJ,CAAC;QACF,cAAc,CAAC,IAAI,GAAG,iBAAiB,CAAC;QAExC,kBAAkB;QAClB,MAAM,KAAK,GAAc;YACrB,KAAK,UAAU,gBAAgB;gBAC3B,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC;gBACtC,OAAO,EAAC,WAAW,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,EAAC,CAAC;YACtD,CAAC;YACD,kBAAkB,EAAE,iBAAiB;YACrC,cAAc,EAAE,iBAAiB;YACjC,KAAK,UAAU,YAAY,CAAC,MAAM,EAAE,OAAO;gBACvC,MAAM,MAAM,GAAG,CAAC,MAAM,OAAO,CAAC,gBAAgB,CAG7C,CAAC;gBACF,MAAM,IAAI,GAAG,CAAC,MAAM,OAAO,CAAC,UAAU,CAIrC,CAAC;gBACF,OAAO,CAAC,GAAG,CAAC,2BAA2B,CAAC,CAAC;gBACzC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;gBACvC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;gBACjC,OAAO,CAAC,GAAG,CAAC,+BAA+B,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;gBACxD,OAAO,EAAC,QAAQ,EAAE,IAAI,EAAC,CAAC;YAC5B,CAAC;SACJ,CAAC;QAEF,sDAAsD;QACtD,MAAM,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;QAErC,iBAAiB;QACjB,MAAM,QAAQ,GAAG,QAAQ,CAAC,WAAW,EAAE,CAAC;QACxC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC;QACzC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sCAAsC,EAAE,KAAK,EAAC,CAAC,EAAC,EAAE;QACjD,MAAM,QAAQ,GAAG,IAAI,YAAY,CAAC,EAAC,WAAW,EAAE,EAAE,EAAC,CAAC,CAAC;QAErD,MAAM,MAAM,GAAG;YACX,KAAK,UAAU,aAAa;gBACxB,OAAO,CAAC,GAAG,CAAC,qCAAqC,CAAC,CAAC;gBACnD,OAAO,EAAC,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,WAAW,EAAC,CAAC;YACzC,CAAC;SACS,CAAC;QACf,MAAM,CAAC,IAAI,GAAG,0BAA0B,CAAC;QAEzC,MAAM,MAAM,GAAG;YACX,KAAK,UAAU,YAAY;gBACvB,OAAO,CAAC,GAAG,CAAC,oCAAoC,CAAC,CAAC;gBAClD,OAAO,EAAC,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,UAAU,EAAC,CAAC;YACxC,CAAC;YACD,MAAM,EAAE,wBAAwB;SACtB,CAAC;QACf,MAAM,CAAC,IAAI,GAAG,qBAAqB,CAAC;QAEpC,MAAM,KAAK,GAAc;YACrB,KAAK,UAAU,YAAY;gBACvB,OAAO,CAAC,GAAG,CAAC,oCAAoC,CAAC,CAAC;gBAClD,OAAO,EAAC,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,UAAU,EAAC,CAAC;YACxC,CAAC;YACD,MAAM,EAAE,wBAAwB;YAChC,KAAK,UAAU,OAAO,CAAC,MAAM,EAAE,OAAO;gBAClC,MAAM,GAAG,GAAG,CAAC,MAAM,OAAO,CAAC,YAAY,CAAkC,CAAC;gBAC1E,MAAM,GAAG,GAAG,CAAC,MAAM,OAAO,CAAC,YAAY,CAAkC,CAAC;gBAC1E,MAAM,IAAI,GAAG,CAAC,MAAM,OAAO,CAAC,aAAa,CAAkC,CAAC;gBAC5E,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC;gBACtC,OAAO,CAAC,GAAG,CAAC,cAAc,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;gBACtC,OAAO,CAAC,GAAG,CAAC,cAAc,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;gBACtC,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;gBACvC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,GAAG,GAAG,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;gBACpD,OAAO,EAAC,QAAQ,EAAE,IAAI,EAAC,CAAC;YAC5B,CAAC;SACJ,CAAC;QAEF,MAAM,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;QAErC,MAAM,QAAQ,GAAG,QAAQ,CAAC,WAAW,EAAE,CAAC;QACxC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wCAAwC,EAAE,KAAK,EAAC,CAAC,EAAC,EAAE;QACnD,MAAM,QAAQ,GAAG,IAAI,YAAY,CAAC,EAAC,WAAW,EAAE,EAAE,EAAC,CAAC,CAAC;QAErD,MAAM,aAAa,GAAc;YAC7B,KAAK,UAAU,KAAK;gBAChB,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;gBAClC,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;gBACtD,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;gBAChC,OAAO,EAAC,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,EAAC,CAAC;YACrC,CAAC;YACD,KAAK,UAAU,KAAK;gBAChB,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;gBAClC,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;gBACtD,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;gBAChC,OAAO,EAAC,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,EAAC,CAAC;YACrC,CAAC;YACD,KAAK,UAAU,KAAK;gBAChB,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;gBAClC,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;gBACtD,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;gBAChC,OAAO,EAAC,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,EAAC,CAAC;YACrC,CAAC;SACJ,CAAC;QACF,aAAa,CAAC,IAAI,GAAG,yBAAyB,CAAC;QAE/C,MAAM,KAAK,GAAc;YACrB,KAAK,UAAU,KAAK;gBAChB,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;gBAC3B,OAAO,EAAC,KAAK,EAAE,IAAI,EAAC,CAAC;YACzB,CAAC;YACD,aAAa,EAAE,6BAA6B;YAC5C,KAAK,UAAU,MAAM,CAAC,MAAM,EAAE,OAAO;gBACjC,MAAM,EAAE,GAAG,CAAC,MAAM,OAAO,CAAC,KAAK,CAAmC,CAAC;gBACnE,MAAM,EAAE,GAAG,CAAC,MAAM,OAAO,CAAC,KAAK,CAAmC,CAAC;gBACnE,MAAM,EAAE,GAAG,CAAC,MAAM,OAAO,CAAC,KAAK,CAAmC,CAAC;gBACnE,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;gBAClC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;gBAChC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;gBAChC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;gBAChC,OAAO,EAAC,WAAW,EAAE,IAAI,EAAC,CAAC;YAC/B,CAAC;SACJ,CAAC;QAEF,MAAM,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;QAErC,MAAM,QAAQ,GAAG,QAAQ,CAAC,WAAW,EAAE,CAAC;QACxC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC"}

package/dist/examples/error-demo.test.d.ts

@@ -1,14 +0,0 @@
-/**
- * Demonstration of error reporting in nested test contexts
- *
- * This file shows how errors are properly reported with indentation and tracking.
- * Run with: node --test error-demo.test.js
- *
- * You'll see that:
- * 1. Errors appear in the nested test output with proper indentation
- * 2. Error details (message, stack trace) are captured
- * 3. Progress tracking records all error information
- * 4. Other independent steps continue executing
- */
-export {};
-//# sourceMappingURL=error-demo.test.d.ts.map

package/dist/examples/error-demo.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"error-demo.test.d.ts","sourceRoot":"","sources":["../../examples/error-demo.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG"}

package/dist/examples/error-demo.test.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"error-demo.test.js","sourceRoot":"","sources":["../../examples/error-demo.test.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -1,87 +0,0 @@
-/**
- * Parallel Test Executor
- *
- * Implements the new parallel test execution framework with:
- * - Thenable proxies for automatic dependency detection
- * - Parallel execution with configurable concurrency
- * - Dependency graph tracking
- * - Live progress tracking
- * - Enhanced error reporting
- * - Latency metrics
- */
-import { EventEmitter } from 'node:events';
-import type { IDependencyGraph, IMeta, ITestEvents, ITestExecutorConfig, ITestFrameworkContext, ITestLatency, ITestProgress, StepArray } from './test-types.js';
-/**
- * Main test executor class
- */
-export declare class TestExecutor extends EventEmitter {
-    private config;
-    private queue;
-    private dependencyTracker;
-    private log?;
-    private progress;
-    private graph;
-    private latencyMetrics;
-    private realContext;
-    private promiseManager;
-    private testContext?;
-    private stepNamesUsed;
-    constructor(config?: ITestExecutorConfig);
-    /**
-     * Executes an array of test steps
-     */
-    execute(steps: StepArray, $meta: IMeta, testContext?: ITestFrameworkContext): Promise<void>;
-    /**
-     * Recursively executes steps, handling both functions and nested arrays
-     */
-    private _executeSteps;
-    /**
-     * Executes a single step function
-     */
-    private _executeStep;
-    /**
-     * Counts total number of steps (including nested)
-     */
-    private _countSteps;
-    /**
-     * Collects all step names (including nested)
-     */
-    private _collectStepNames;
-    /**
-     * Checks for duplicate step names and throws an error if found
-     */
-    private _checkForDuplicateStepName;
-    /**
-     * Applies the chain-level `mask` (and optional per-call `extraPaths`) to
-     * `value`. Returns the original reference unchanged when no masking is
-     * configured. Falls back to the deprecated `maskFn` when supplied.
-     */
-    private _applyMask;
-    /**
-     * Gets the current progress snapshot
-     */
-    getProgress(): ITestProgress;
-    /**
-     * Gets the dependency graph
-     */
-    getDependencyGraph(): IDependencyGraph;
-    /**
-     * Gets latency metrics
-     */
-    getLatencyReport(): ITestLatency;
-    /**
-     * Calculates the critical path (longest dependency chain)
-     */
-    private _calculateCriticalPath;
-    /**
-     * Identifies bottleneck steps that blocked many other steps
-     */
-    private _identifyBottlenecks;
-    /**
-     * Type-safe event emitter
-     */
-    on<E extends keyof ITestEvents>(event: E, handler: ITestEvents[E]): this;
-    emit<E extends keyof ITestEvents>(event: E, ...args: Parameters<ITestEvents[E]>): boolean;
-}
-export type * from './test-types.js';
-//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EAAC,YAAY,EAAC,MAAM,aAAa,CAAC;AAEzC,OAAO,KAAK,EAER,gBAAgB,EAChB,KAAK,EAOL,WAAW,EACX,mBAAmB,EACnB,qBAAqB,EACrB,YAAY,EAEZ,aAAa,EAEb,SAAS,EAEZ,MAAM,iBAAiB,CAAC;AAsXzB;;GAEG;AACH,qBAAa,YAAa,SAAQ,YAAY;IAC1C,OAAO,CAAC,MAAM,CAAsB;IACpC,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,iBAAiB,CAA2B;IACpD,OAAO,CAAC,GAAG,CAAC,CAAc;IAG1B,OAAO,CAAC,QAAQ,CASd;IAGF,OAAO,CAAC,KAAK,CAGX;IAGF,OAAO,CAAC,cAAc,CAAmC;IAGzD,OAAO,CAAC,WAAW,CAA+B;IAGlD,OAAO,CAAC,cAAc,CAAiB;IAGvC,OAAO,CAAC,WAAW,CAAC,CAAwB;IAG5C,OAAO,CAAC,aAAa,CAAqB;gBAE9B,MAAM,GAAE,mBAAwB;IAqB5C;;OAEG;IACG,OAAO,CACT,KAAK,EAAE,SAAS,EAChB,KAAK,EAAE,KAAK,EACZ,WAAW,CAAC,EAAE,qBAAqB,GACpC,OAAO,CAAC,IAAI,CAAC;IAwDhB;;OAEG;YACW,aAAa;IAoH3B;;OAEG;YACW,YAAY;IAmQ1B;;OAEG;IACH,OAAO,CAAC,WAAW;IAcnB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAmBzB;;OAEG;IACH,OAAO,CAAC,0BAA0B;IAUlC;;;;OAIG;IACH,OAAO,CAAC,UAAU;IAOlB;;OAEG;IACH,WAAW,IAAI,aAAa;IAI5B;;OAEG;IACH,kBAAkB,IAAI,gBAAgB;IAItC;;OAEG;IACH,gBAAgB,IAAI,YAAY;IA4BhC;;OAEG;IACH,OAAO,CAAC,sBAAsB;IA+C9B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IA4B5B;;OAEG;IACH,EAAE,CAAC,CAAC,SAAS,MAAM,WAAW,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,IAAI;IAIxE,IAAI,CAAC,CAAC,SAAS,MAAM,WAAW,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,IAAI,EAAE,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO;CAG5F;AAGD,mBAAmB,iBAAiB,CAAC"}