@c9up/helix 0.1.8 → 0.1.9

package/dist/runtime/global-hooks.d.ts

@@ -0,0 +1,31 @@
+/**
+ * `runnerHooks` — run ONCE for the whole run, where Japa runs them.
+ *
+ * These were running per worker process, which meant a migration in
+ * `runnerHooks.setup` ran once per FILE. The reason given was that a resource
+ * opened in the CLI process would not exist in the workers — true of an
+ * in-memory one, and false of everything these hooks actually do: migrate a
+ * database, seed it, start a server on a port, create a directory. Those cross
+ * processes, and running them N times is wrong, not merely wasteful.
+ *
+ * So they run here, in the process that spawns the workers, and the workers are
+ * told to skip them. What genuinely has to exist INSIDE a worker — a context
+ * macro, anything held in memory — is what `plugins` are for, and those still
+ * run per worker because they have to.
+ */
+/** Set for the workers, so they do not run what the parent already ran. */
+export declare const GLOBAL_HOOKS_ENV = "HELIX_GLOBAL_HOOKS";
+/** Whether this process should skip `runnerHooks` because a parent ran them. */
+export declare function globalHooksHandledByParent(): boolean;
+/**
+ * Run the bootstrap's `runnerHooks.setup` once and return the teardown for the
+ * end of the run. Undos a setup hook resolved to unwind first, then the
+ * declared teardowns — both in reverse order, as everywhere else.
+ *
+ * A no-op returning a no-op when the project has no bootstrap: there is then
+ * nothing to run once, and the workers have nothing to skip.
+ */
+export declare function runGlobalHooks(bootstrap: string | undefined, options?: {
+    japaPlugins?: boolean;
+}): Promise<() => Promise<void>>;
+//# sourceMappingURL=global-hooks.d.ts.map

package/dist/runtime/global-hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"global-hooks.d.ts","sourceRoot":"","sources":["../../src/runtime/global-hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAOH,2EAA2E;AAC3E,eAAO,MAAM,gBAAgB,uBAAuB,CAAC;AAErD,gFAAgF;AAChF,wBAAgB,0BAA0B,IAAI,OAAO,CAEpD;AASD;;;;;;;GAOG;AACH,wBAAsB,cAAc,CACnC,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,OAAO,GAAE;IAAE,WAAW,CAAC,EAAE,OAAO,CAAA;CAAO,GACrC,OAAO,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,CAyD9B"}

package/dist/runtime/global-hooks.js

@@ -0,0 +1,126 @@
+/**
+ * `runnerHooks` — run ONCE for the whole run, where Japa runs them.
+ *
+ * These were running per worker process, which meant a migration in
+ * `runnerHooks.setup` ran once per FILE. The reason given was that a resource
+ * opened in the CLI process would not exist in the workers — true of an
+ * in-memory one, and false of everything these hooks actually do: migrate a
+ * database, seed it, start a server on a port, create a directory. Those cross
+ * processes, and running them N times is wrong, not merely wasteful.
+ *
+ * So they run here, in the process that spawns the workers, and the workers are
+ * told to skip them. What genuinely has to exist INSIDE a worker — a context
+ * macro, anything held in memory — is what `plugins` are for, and those still
+ * run per worker because they have to.
+ */
+import { pathToFileURL } from "node:url";
+import { emitter } from "./emitter.js";
+import { Runner } from "./runner.js";
+/** Set for the workers, so they do not run what the parent already ran. */
+export const GLOBAL_HOOKS_ENV = "HELIX_GLOBAL_HOOKS";
+/** Whether this process should skip `runnerHooks` because a parent ran them. */
+export function globalHooksHandledByParent() {
+    return process.env[GLOBAL_HOOKS_ENV] === "1";
+}
+function hookList(source, key) {
+    if (source === null || typeof source !== "object")
+        return [];
+    const value = Reflect.get(source, key);
+    if (!Array.isArray(value))
+        return [];
+    return value.filter((fn) => typeof fn === "function");
+}
+/**
+ * Run the bootstrap's `runnerHooks.setup` once and return the teardown for the
+ * end of the run. Undos a setup hook resolved to unwind first, then the
+ * declared teardowns — both in reverse order, as everywhere else.
+ *
+ * A no-op returning a no-op when the project has no bootstrap: there is then
+ * nothing to run once, and the workers have nothing to skip.
+ */
+export async function runGlobalHooks(bootstrap, options = {}) {
+    if (bootstrap === undefined || bootstrap === "") {
+        return async () => { };
+    }
+    // The parent imports the bootstrap too, so it needs the same alias the
+    // workers get. Without it the two processes resolve `@japa/runner/core`
+    // differently — the parent to the real Japa, the workers to the shim — and a
+    // bootstrap that registers at the top level registers on a class nothing
+    // reads. When `@japa/runner` is not installed at all, the parent simply
+    // cannot import the file.
+    let dropAlias;
+    if (options.japaPlugins === true) {
+        const { setJapaAlias } = await import("../japa/japa-alias.mjs");
+        setJapaAlias(true);
+        // Turned off with the teardown: `register()` cannot be undone, so a host
+        // running twice in one process would otherwise keep resolving
+        // `@japa/runner/core` to the shim after asking for the real one.
+        dropAlias = () => setJapaAlias(false);
+    }
+    // Everything past the alias needs unwinding if it throws: the import can
+    // fail, and so can a setup hook — half-way through, with earlier hooks
+    // already having opened something. Leaving the alias on and the undos
+    // pending is the failure mode this whole file exists to avoid.
+    const previous = process.env[GLOBAL_HOOKS_ENV];
+    const runner = new Runner(emitter);
+    const undos = [];
+    let teardown = [];
+    try {
+        const module = await import(pathToFileURL(bootstrap).href);
+        const hooks = Reflect.get(Object(module), "runnerHooks");
+        const setup = hookList(hooks, "setup");
+        teardown = hookList(hooks, "teardown");
+        for (const fn of setup) {
+            const undo = await fn(runner);
+            if (typeof undo === "function")
+                undos.push(undo);
+        }
+        if (setup.length > 0 || teardown.length > 0) {
+            process.env[GLOBAL_HOOKS_ENV] = "1";
+        }
+    }
+    catch (err) {
+        // Unwind what did run, then hand the failure on: a run that could not set
+        // itself up must not start, and must not leave the process changed.
+        await unwind(undos, [], runner);
+        dropAlias?.();
+        restoreEnv(previous);
+        throw err;
+    }
+    return async () => {
+        dropAlias?.();
+        restoreEnv(previous);
+        await unwind(undos, teardown, runner);
+    };
+}
+/** Put `HELIX_GLOBAL_HOOKS` back the way it was found. */
+function restoreEnv(previous) {
+    if (previous === undefined)
+        delete process.env[GLOBAL_HOOKS_ENV];
+    else
+        process.env[GLOBAL_HOOKS_ENV] = previous;
+}
+/**
+ * Unwind what a setup opened: the undos it resolved to, then the declared
+ * teardowns, both in reverse. Failures are reported rather than thrown — one
+ * broken teardown must not hide the rest, nor turn a finished run red.
+ */
+async function unwind(undos, teardown, runner) {
+    for (let i = undos.length - 1; i >= 0; i -= 1) {
+        try {
+            await undos[i](null, runner);
+        }
+        catch (err) {
+            console.error("[helix] global cleanup failed:", err);
+        }
+    }
+    for (let i = teardown.length - 1; i >= 0; i -= 1) {
+        try {
+            await teardown[i](runner);
+        }
+        catch (err) {
+            console.error("[helix] global teardown failed:", err);
+        }
+    }
+}
+//# sourceMappingURL=global-hooks.js.map

package/dist/runtime/global-hooks.js.map

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

package/dist/runtime/index.d.ts

@@ -5,9 +5,18 @@
  * get the full DSL. The runtime is orchestrator-agnostic: a Node child
  * process, a Bun worker, or a Rust-spawned worker all load the same module.
  */
+export type { Assert } from "./assert.js";
+export { createAssert } from "./assert.js";
 export type { AssertionErrorInit } from "./assertion-error.js";
 export { AssertionError, isAssertionError } from "./assertion-error.js";
 export type { AsymmetricMatcher, Constructor } from "./asymmetric.js";
+export type { CLIArgs } from "./cli-args.js";
+export type { ConfigureOptions, Plugin, PluginApi, PluginContext, RunnerHook, } from "./configure.js";
+export { configure, drainRunnerTeardowns } from "./configure.js";
+export type { Getter } from "./context.js";
+export { buildTestContext, TestContext, TestContextRegistry, } from "./context.js";
+export type { EmittedDataset, EmittedError, EmittedTitle, ErrorPhase, EventHandler, GroupEndNode, GroupStartNode, RunnerEndNode, RunnerEvents, RunnerStartNode, SuiteEndNode, SuiteStartNode, TestEndNode, TestStartNode, } from "./emitter.js";
+export { Emitter, emitter } from "./emitter.js";
 export type { EqualsOptions } from "./equals.js";
 export { equals, partialEquals } from "./equals.js";
 export type { Assertion, ExpectStatic } from "./expect.js";
@@ -18,9 +27,11 @@ export type { MatcherName, MatcherResult, SpyLike } from "./matchers.js";
 export { matchers } from "./matchers.js";
 export type { FileResult, SerializedError, SuiteResult, TestResult, } from "./run.js";
 export { executeRoot } from "./run.js";
-export type { CleanupFn, HookFn, RunMode, SuiteNode, TestFn, TestHandle, TestNode, TestOptions, } from "./suite.js";
-export { describe, getRoot, it, resetRoot, test, } from "./suite.js";
-export { onTestFailed, onTestFinished } from "./test-context.js";
+export type { RunnerSummary, SummaryAggregates } from "./runner.js";
+export { Runner } from "./runner.js";
+export type { CleanupFn, DatasetHandle, DatasetSource, DoneFn, Group, GroupInstance, HookFn, RunMode, SuiteNode, TapHandle, TapOptions, TestFn, TestHandle, TestInstance, TestNode, TestOptions, } from "./suite.js";
+export { describe, getRoot, it, resetRoot, Test, test, } from "./suite.js";
+export { getActiveTest, getActiveTestOrFail, onTestFailed, onTestFinished, } from "./test-context.js";
 export type { Vi } from "./vi/index.js";
 export { vi, withViContext } from "./vi/index.js";
 export type { CreateSpyOptions, MockCallResult, MockInternals, Spy, } from "./vi/spy.js";

package/dist/runtime/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/runtime/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,YAAY,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxE,YAAY,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACtE,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACpD,YAAY,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3D,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,YAAY,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EACN,OAAO,EACP,QAAQ,EACR,SAAS,EACT,SAAS,EACT,UAAU,GACV,MAAM,gBAAgB,CAAC;AACxB,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACzE,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,YAAY,EACX,UAAU,EACV,eAAe,EACf,WAAW,EACX,UAAU,GACV,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACvC,YAAY,EACX,SAAS,EACT,MAAM,EACN,OAAO,EACP,SAAS,EACT,MAAM,EACN,UAAU,EACV,QAAQ,EACR,WAAW,GACX,MAAM,YAAY,CAAC;AACpB,OAAO,EACN,QAAQ,EACR,OAAO,EACP,EAAE,EACF,SAAS,EACT,IAAI,GACJ,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACjE,YAAY,EAAE,EAAE,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,EAAE,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAClD,YAAY,EACX,gBAAgB,EAChB,cAAc,EACd,aAAa,EACb,GAAG,GACH,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAClD,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/runtime/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,YAAY,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,YAAY,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxE,YAAY,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACtE,YAAY,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAC7C,YAAY,EACX,gBAAgB,EAChB,MAAM,EACN,SAAS,EACT,aAAa,EACb,UAAU,GACV,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,SAAS,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AACjE,YAAY,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EACN,gBAAgB,EAChB,WAAW,EACX,mBAAmB,GACnB,MAAM,cAAc,CAAC;AACtB,YAAY,EACX,cAAc,EACd,YAAY,EACZ,YAAY,EACZ,UAAU,EACV,YAAY,EACZ,YAAY,EACZ,cAAc,EACd,aAAa,EACb,YAAY,EACZ,eAAe,EACf,YAAY,EACZ,cAAc,EACd,WAAW,EACX,aAAa,GACb,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAChD,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACpD,YAAY,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3D,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,YAAY,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EACN,OAAO,EACP,QAAQ,EACR,SAAS,EACT,SAAS,EACT,UAAU,GACV,MAAM,gBAAgB,CAAC;AACxB,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACzE,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,YAAY,EACX,UAAU,EACV,eAAe,EACf,WAAW,EACX,UAAU,GACV,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACvC,YAAY,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACpE,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,YAAY,EACX,SAAS,EACT,aAAa,EACb,aAAa,EACb,MAAM,EACN,KAAK,EACL,aAAa,EACb,MAAM,EACN,OAAO,EACP,SAAS,EACT,SAAS,EACT,UAAU,EACV,MAAM,EACN,UAAU,EACV,YAAY,EACZ,QAAQ,EACR,WAAW,GACX,MAAM,YAAY,CAAC;AACpB,OAAO,EACN,QAAQ,EACR,OAAO,EACP,EAAE,EACF,SAAS,EACT,IAAI,EACJ,IAAI,GACJ,MAAM,YAAY,CAAC;AACpB,OAAO,EACN,aAAa,EACb,mBAAmB,EACnB,YAAY,EACZ,cAAc,GACd,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EAAE,EAAE,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,EAAE,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAClD,YAAY,EACX,gBAAgB,EAChB,cAAc,EACd,aAAa,EACb,GAAG,GACH,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAClD,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC"}

package/dist/runtime/index.js

@@ -5,14 +5,19 @@
  * get the full DSL. The runtime is orchestrator-agnostic: a Node child
  * process, a Bun worker, or a Rust-spawned worker all load the same module.
  */
+export { createAssert } from "./assert.js";
 export { AssertionError, isAssertionError } from "./assertion-error.js";
+export { configure, drainRunnerTeardowns } from "./configure.js";
+export { buildTestContext, TestContext, TestContextRegistry, } from "./context.js";
+export { Emitter, emitter } from "./emitter.js";
 export { equals, partialEquals } from "./equals.js";
 export { expect } from "./expect.js";
 export { addHook, afterAll, afterEach, beforeAll, beforeEach, } from "./lifecycle.js";
 export { matchers } from "./matchers.js";
 export { executeRoot } from "./run.js";
-export { describe, getRoot, it, resetRoot, test, } from "./suite.js";
-export { onTestFailed, onTestFinished } from "./test-context.js";
+export { Runner } from "./runner.js";
+export { describe, getRoot, it, resetRoot, Test, test, } from "./suite.js";
+export { getActiveTest, getActiveTestOrFail, onTestFailed, onTestFinished, } from "./test-context.js";
 export { vi, withViContext } from "./vi/index.js";
 export { runTestFile } from "./worker.js";
 //# sourceMappingURL=index.js.map

package/dist/runtime/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/runtime/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAGxE,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEpD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,OAAO,EACN,OAAO,EACP,QAAQ,EACR,SAAS,EACT,SAAS,EACT,UAAU,GACV,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAOzC,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAWvC,OAAO,EACN,QAAQ,EACR,OAAO,EACP,EAAE,EACF,SAAS,EACT,IAAI,GACJ,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEjE,OAAO,EAAE,EAAE,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AASlD,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/runtime/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAUxE,OAAO,EAAE,SAAS,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAEjE,OAAO,EACN,gBAAgB,EAChB,WAAW,EACX,mBAAmB,GACnB,MAAM,cAAc,CAAC;AAiBtB,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEhD,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEpD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,OAAO,EACN,OAAO,EACP,QAAQ,EACR,SAAS,EACT,SAAS,EACT,UAAU,GACV,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAOzC,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAEvC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAmBrC,OAAO,EACN,QAAQ,EACR,OAAO,EACP,EAAE,EACF,SAAS,EACT,IAAI,EACJ,IAAI,GACJ,MAAM,YAAY,CAAC;AACpB,OAAO,EACN,aAAa,EACb,mBAAmB,EACnB,YAAY,EACZ,cAAc,GACd,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,EAAE,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AASlD,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC"}

package/dist/runtime/run.d.ts

@@ -6,6 +6,7 @@
  * `.only` handling: if any test or suite is marked `only` anywhere in the
  * tree, non-`only` paths are downgraded to `skip` before execution.
  */
+import { type ErrorPhase } from "./emitter.js";
 import type { SuiteNode } from "./suite.js";
 export interface TestResult {
     name: string;
@@ -13,6 +14,8 @@ export interface TestResult {
     status: "pass" | "fail" | "skip" | "todo";
     durationMs: number;
     error?: SerializedError;
+    /** Lifecycle phase `error` was raised in (Japa `test:end` parity). */
+    errorPhase?: ErrorPhase;
 }
 export interface SuiteResult {
     name: string;
@@ -42,6 +45,12 @@ export interface FileResult {
         todo: number;
     };
     durationMs: number;
+    /**
+     * Full names of the tests marked `.pin()` — only populated under
+     * `--list-pinned`, where Japa collects the files, prints what is pinned, and
+     * runs nothing.
+     */
+    pinned?: string[];
 }
 export interface ExecuteOptions {
     /**
@@ -61,10 +70,48 @@ export interface ExecuteOptions {
      */
     grep?: string;
     /**
-     * Tag filter expressions (`@fast`, `!@slow`). A test runs when it carries
-     * every required tag and none of the excluded ones. Mirrors `--tags`.
+     * Tag filter expressions (Japa `--tags`). A `~`-prefixed tag EXCLUDES (`!` is
+     * also accepted). Required tags are OR-ed by default — a test runs when it
+     * carries ANY of them — unless {@link ExecuteOptions.matchAll} is set, and
+     * never when it carries an excluded tag.
      */
     tags?: string[];
+    /** Require ALL required tags instead of any (Japa `--match-all`). */
+    matchAll?: boolean;
+    /** Exact test titles to run (Japa `--tests`). A test runs only if its leaf title is listed. */
+    tests?: string[];
+    /** Exact group titles to run (Japa `--groups`). A test runs only if its enclosing group is listed. */
+    groups?: string[];
+    /**
+     * The suite these tests belong to — `ctx.test.options.meta.suite.name` and the
+     * `suite:*` event payloads. Defaults to `"default"`, Japa's implicit suite.
+     */
+    suite?: string;
+    /**
+     * Stop running once a test fails (Japa `--bail`). Everything after the
+     * failure is reported as SKIPPED, not dropped — same as Japa, so the counts
+     * still add up.
+     */
+    bail?: boolean;
+    /**
+     * How far a bail reaches (Japa `--bail-layer`): `"group"` stops the enclosing
+     * group only, `"suite"` the rest of the file, `"runner"` (Japa's default,
+     * spelled `""` on its CLI) the rest of the run — the remaining FILES are
+     * dropped by the pool, since helix runs one process per file and cannot skip
+     * tests it never collected.
+     */
+    bailLayer?: "group" | "suite" | "runner" | "";
+}
+/** The value a {@link SerializedError} was built from, when it is still around. */
+export declare function thrownValue(error: SerializedError): unknown;
+/**
+ * The suite a run belongs to (Japa `meta.suite`). Helix runs one process per
+ * FILE, so the suite is a name the run carries — `"default"` unless
+ * `configure({ suite })` or `--suite` says otherwise, exactly like Japa's
+ * implicit suite.
+ */
+export interface SuiteIdentity {
+    name: string;
 }
 export declare function executeRoot(root: SuiteNode, file: string, options?: ExecuteOptions): Promise<FileResult>;
 //# sourceMappingURL=run.d.ts.map

package/dist/runtime/run.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../src/runtime/run.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAQ,SAAS,EAAY,MAAM,YAAY,CAAC;AAQ5D,MAAM,WAAW,UAAU;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IAC1C,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,eAAe,CAAC;CACxB;AAED,MAAM,WAAW,WAAW;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,KAAK,CAAC,WAAW,GAAG,UAAU,CAAC,CAAC;IAC1C,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,iEAAiE;IACjE,UAAU,EAAE,eAAe,EAAE,CAAC;CAC9B;AAED,MAAM,WAAW,eAAe;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,UAAU;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,MAAM,EAAE;QACP,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;KACb,CAAC;IACF,UAAU,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC9B;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CAChB;AAohBD,wBAAsB,WAAW,CAChC,IAAI,EAAE,SAAS,EACf,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,cAAmB,GAC1B,OAAO,CAAC,UAAU,CAAC,CAyFrB"}
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../src/runtime/run.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,EAGN,KAAK,UAAU,EAGf,MAAM,cAAc,CAAC;AACtB,OAAO,KAAK,EAMX,SAAS,EAGT,MAAM,YAAY,CAAC;AAYpB,MAAM,WAAW,UAAU;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IAC1C,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,eAAe,CAAC;IACxB,sEAAsE;IACtE,UAAU,CAAC,EAAE,UAAU,CAAC;CACxB;AAED,MAAM,WAAW,WAAW;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,KAAK,CAAC,WAAW,GAAG,UAAU,CAAC,CAAC;IAC1C,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,iEAAiE;IACjE,UAAU,EAAE,eAAe,EAAE,CAAC;CAC9B;AAED,MAAM,WAAW,eAAe;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,UAAU;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,MAAM,EAAE;QACP,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;KACb,CAAC;IACF,UAAU,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC9B;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;;OAKG;IACH,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,qEAAqE;IACrE,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,+FAA+F;IAC/F,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,sGAAsG;IACtG,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;IACf;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,OAAO,GAAG,OAAO,GAAG,QAAQ,GAAG,EAAE,CAAC;CAC9C;AAmFD,mFAAmF;AACnF,wBAAgB,WAAW,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAE3D;AA+ND;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC7B,IAAI,EAAE,MAAM,CAAC;CACb;AA+0BD,wBAAsB,WAAW,CAChC,IAAI,EAAE,SAAS,EACf,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,cAAmB,GAC1B,OAAO,CAAC,UAAU,CAAC,CA2HrB"}