@c9up/helix 0.1.8 → 0.1.10

package/dist/cli/suites.js

@@ -0,0 +1,226 @@
+/**
+ * Named test suites — helix's equivalent of the `tests` block AdonisJS puts in
+ * `adonisrc.ts`, so `helix test unit` runs a suite rather than a path. The
+ * SHAPE is Adonis's (`timeout`, `forceExit`, `suites[{ name, files, timeout }]`)
+ * and the glob syntax is portable verbatim, but the file read is
+ * `helix.config.*`: helix is framework-agnostic, and `adonisrc.ts` belongs to
+ * the framework that owns it — in Adonis it is `@adonisjs/core`, not Japa, that
+ * reads the file and hands the suites to the runner.
+ *
+ *     // helix.config.ts
+ *     export default {
+ *       timeout: 2_000,
+ *       suites: [
+ *         { name: "unit", files: ["tests/unit/**​/*.spec.(js|ts)"] },
+ *         { name: "functional", files: ["tests/functional"], timeout: 30_000 },
+ *       ],
+ *     }
+ *
+ * A suite's `files` are plain paths (a directory is walked with helix's suffix
+ * discovery) or globs — including AdonisJS's own defaults, verbatim:
+ * `tests/unit/**​/*.spec.(js|ts)`. See `glob.ts` for the compiled subset and the
+ * two forms it refuses rather than half-honours.
+ */
+import { existsSync, statSync } from "node:fs";
+import path from "node:path";
+import { fileURLToPath, pathToFileURL } from "node:url";
+import { discover } from "./discover.js";
+import { globBaseDir, globRejection, globToRegExp, isGlob, isNegated, withoutNegation, } from "./glob.js";
+/** Config file names probed at the project root, in order. */
+const CONFIG_FILENAMES = [
+    "helix.config.ts",
+    "helix.config.js",
+    "helix.config.mjs",
+];
+/** Narrow an imported module's default export to a {@link HelixConfig}. */
+function toConfig(imported) {
+    const source = imported !== null && typeof imported === "object"
+        ? (Reflect.get(imported, "default") ?? imported)
+        : imported;
+    if (source === null || typeof source !== "object")
+        return {};
+    const rawBootstrap = Reflect.get(source, "bootstrap");
+    const bootstrap = typeof rawBootstrap === "string" ? rawBootstrap : undefined;
+    const rawTimeout = Reflect.get(source, "timeout");
+    const timeout = typeof rawTimeout === "number" ? rawTimeout : undefined;
+    const forceExit = Reflect.get(source, "forceExit") === true ? true : undefined;
+    const japaPlugins = Reflect.get(source, "japaPlugins") === true ? true : undefined;
+    const runner = { bootstrap, timeout, forceExit, japaPlugins };
+    const suites = Reflect.get(source, "suites");
+    if (!Array.isArray(suites))
+        return runner;
+    const parsed = [];
+    for (const entry of suites) {
+        if (entry === null || typeof entry !== "object")
+            continue;
+        const name = Reflect.get(entry, "name");
+        const files = toSuiteFiles(Reflect.get(entry, "files"));
+        if (typeof name !== "string" || files === undefined)
+            continue;
+        const timeout = Reflect.get(entry, "timeout");
+        const retries = Reflect.get(entry, "retries");
+        const configure = Reflect.get(entry, "configure");
+        parsed.push({
+            name,
+            files,
+            timeout: typeof timeout === "number" ? timeout : undefined,
+            retries: typeof retries === "number" ? retries : undefined,
+            configure: typeof configure === "function"
+                ? (suite) => {
+                    configure(suite);
+                }
+                : undefined,
+        });
+    }
+    return { ...runner, suites: parsed };
+}
+/** Narrow a declared `files` value to one of Japa's three accepted forms. */
+function toSuiteFiles(value) {
+    if (typeof value === "string")
+        return value;
+    if (typeof value === "function") {
+        return () => {
+            const produced = value();
+            return normaliseUrls(produced);
+        };
+    }
+    if (Array.isArray(value)) {
+        return value.filter((entry) => typeof entry === "string");
+    }
+    return undefined;
+}
+/** A files-callback's return value, awaited and reduced to the URLs in it. */
+async function normaliseUrls(produced) {
+    const resolved = await produced;
+    if (!Array.isArray(resolved))
+        return [];
+    return resolved.filter((entry) => entry instanceof URL);
+}
+/**
+ * Load `helix.config.*` from `root`, or `{}` when there is none. A config that
+ * throws on import is a hard error — silently ignoring it would run the wrong
+ * set of tests.
+ */
+export async function loadHelixConfig(root) {
+    const file = resolveHelixConfig(root);
+    if (file === undefined)
+        return {};
+    const imported = await import(pathToFileURL(file).href);
+    return toConfig(imported);
+}
+/**
+ * The config file helix would load, or `undefined` when there is none. Exposed
+ * because a `suites[].configure` callback has to be re-imported in the worker —
+ * a function does not cross a process boundary.
+ */
+export function resolveHelixConfig(root) {
+    for (const name of CONFIG_FILENAMES) {
+        const candidate = path.join(root, name);
+        if (existsSync(candidate))
+            return candidate;
+    }
+    return undefined;
+}
+/**
+ * Extensions a pattern entry is allowed to select. The GLOB decides which files
+ * belong to the suite, so the walk only has to stop at things that could not be
+ * a module — `--include`, which constrains path-mode discovery, does not apply.
+ */
+const GLOB_EXTENSIONS = [".ts", ".tsx", ".js", ".mjs", ".cjs"];
+/** `path.relative` output, normalised to the `/` separators a glob speaks. */
+function toPosix(relative) {
+    return relative.split(path.sep).join("/");
+}
+/** Every file a pattern entry selects, walked from its wildcard-free prefix. */
+async function resolveGlobEntry(entry, suiteName, root, discovery) {
+    const rejection = globRejection(entry);
+    if (rejection !== undefined) {
+        process.stderr.write(`helix: suite "${suiteName}": ${entry}: ${rejection}\n`);
+        return [];
+    }
+    const base = globBaseDir(entry);
+    const absBase = path.isAbsolute(base) ? base : path.resolve(root, base);
+    if (!existsSync(absBase)) {
+        process.stderr.write(`helix: suite "${suiteName}": path not found: ${entry}\n`);
+        return [];
+    }
+    const pattern = globToRegExp(entry);
+    const candidates = await discover(absBase, {
+        ...discovery,
+        suffixes: GLOB_EXTENSIONS,
+    });
+    return candidates.filter((file) => pattern.test(toPosix(path.relative(root, file))));
+}
+/**
+ * Resolve a suite's `files` into absolute test file paths. A plain path is a
+ * directory to walk (helix's suffix discovery) or a file; anything with a
+ * pattern character goes through the glob matcher, so AdonisJS's own
+ * `tests/unit/**​/*.spec.(js|ts)` ports over verbatim. A `!pattern` entry
+ * subtracts from what the others selected.
+ */
+export async function resolveSuiteFiles(suite, root, discovery) {
+    // A callback picks the files itself (Japa `TestFiles`); there is no pattern
+    // to compile and nothing to exclude, so it short-circuits the whole loop.
+    if (typeof suite.files === "function") {
+        return [...new Set((await suite.files()).map((url) => fileURLToPath(url)))];
+    }
+    const entries = typeof suite.files === "string" ? [suite.files] : suite.files;
+    const out = [];
+    // `!pattern` entries subtract from whatever the selecting entries gathered,
+    // so they are applied once at the end regardless of where they were written.
+    const excluded = [];
+    for (const entry of entries) {
+        if (isNegated(entry)) {
+            const pattern = withoutNegation(entry);
+            const rejection = globRejection(pattern);
+            if (rejection !== undefined) {
+                process.stderr.write(`helix: suite "${suite.name}": ${entry}: ${rejection}\n`);
+                continue;
+            }
+            excluded.push(globToRegExp(pattern));
+            continue;
+        }
+        if (isGlob(entry)) {
+            out.push(...(await resolveGlobEntry(entry, suite.name, root, discovery)));
+            continue;
+        }
+        const abs = path.isAbsolute(entry) ? entry : path.resolve(root, entry);
+        if (!existsSync(abs)) {
+            process.stderr.write(`helix: suite "${suite.name}": path not found: ${entry}\n`);
+            continue;
+        }
+        if (statSync(abs).isDirectory()) {
+            out.push(...(await discover(abs, discovery)));
+            continue;
+        }
+        out.push(abs);
+    }
+    // A file listed by two entries runs once.
+    const selected = [...new Set(out)];
+    if (excluded.length === 0)
+        return selected;
+    return selected.filter((file) => {
+        const relative = toPosix(path.relative(root, file));
+        return !excluded.some((pattern) => pattern.test(relative));
+    });
+}
+/**
+ * Pick the suites named on the command line. Returns `undefined` when the
+ * positionals are NOT suite names — the caller then treats them as paths, which
+ * is what every helix project without a config file does.
+ */
+export function selectSuites(config, positionals) {
+    const suites = config.suites ?? [];
+    if (suites.length === 0)
+        return undefined;
+    // No positionals: Adonis runs every configured suite.
+    if (positionals.length === 0)
+        return suites;
+    const byName = new Map(suites.map((s) => [s.name, s]));
+    const selected = positionals.map((p) => byName.get(p));
+    // All-or-nothing: a mix of suite names and paths is a typo, not a feature.
+    if (selected.some((s) => s === undefined))
+        return undefined;
+    return selected.filter((s) => s !== undefined);
+}
+//# sourceMappingURL=suites.js.map

package/dist/cli/suites.js.map

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

package/dist/index.d.ts

@@ -5,16 +5,17 @@
  * spies/lifecycle), the container facade, and time-travel — none of which import
  * an ecosystem package. It is fully agnostic: usable in any project.
  *
- * Per-package test fakes/helpers live in EACH package's own `/testing` subpath
- * (a package owns its test surface, not helix): `@c9up/ream/testing`
- * (TestClient, FakeBus, assertEmitted), `@c9up/atlas/testing` (factory,
- * useTransaction), `@c9up/rover/testing` (FakeMail), `@c9up/bay/testing`
- * (FakeQueue), `@c9up/spectrum/testing` (FakeLogger), `@c9up/nova/testing`
- * (FakeNova), `@c9up/relay/testing` (FakeRelay), `@c9up/archive/testing`
- * (FakeStorage). Install a package → you get its testing surface.
+ * Capabilities ship as PLUGINS (the Japa/AdonisJS topology): each package's
+ * `/testing` subpath exports plugins that extend the injected test context via
+ * `configure({ plugins: [...] })` — `@c9up/ream/testing` (apiClient → `client`,
+ * FakeBus), `@c9up/atlas/testing` (factory, useTransaction, db), `@c9up/rover/
+ * testing` (FakeMail), `@c9up/bay/testing` (FakeQueue), `@c9up/spectrum/testing`
+ * (FakeLogger), `@c9up/nova/testing` (FakeNova), `@c9up/relay/testing`
+ * (FakeRelay), `@c9up/archive/testing` (FakeStorage). The plugins depend on
+ * helix, never the other way round — the core stays agnostic.
  */
 export * from "./container/index.js";
-export type { Assertion, AsymmetricMatcher, CleanupFn, ExpectStatic, FileResult, Hook, HookFn, HookType, MatcherName, MatcherResult, Spy, SuiteResult, TestHandle, TestOptions, TestResult, Vi, } from "./runtime/index.js";
-export { AssertionError, afterAll, afterEach, beforeAll, beforeEach, describe, expect, it, onTestFailed, onTestFinished, test, vi, } from "./runtime/index.js";
+export type { Assert, Assertion, AsymmetricMatcher, CLIArgs, CleanupFn, ConfigureOptions, DatasetHandle, DatasetSource, DoneFn, EmittedDataset, EmittedError, EmittedTitle, ErrorPhase, EventHandler, ExpectStatic, FileResult, Group, GroupEndNode, GroupInstance, GroupStartNode, Hook, HookFn, HookType, MatcherName, MatcherResult, Plugin, PluginApi, PluginContext, RunnerEndNode, RunnerEvents, RunnerHook, RunnerStartNode, RunnerSummary, Spy, SuiteEndNode, SuiteResult, SuiteStartNode, SummaryAggregates, TapHandle, TapOptions, TestEndNode, TestHandle, TestInstance, TestOptions, TestResult, TestStartNode, Vi, } from "./runtime/index.js";
+export { AssertionError, afterAll, afterEach, beforeAll, beforeEach, buildTestContext, configure, createAssert, describe, drainRunnerTeardowns, Emitter, emitter, expect, getActiveTest, getActiveTestOrFail, it, onTestFailed, onTestFinished, Runner, Test, TestContext, TestContextRegistry, test, vi, } from "./runtime/index.js";
 export * as time from "./time/index.js";
 //# 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":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,cAAc,sBAAsB,CAAC;AACrC,YAAY,EACX,SAAS,EACT,iBAAiB,EACjB,SAAS,EACT,YAAY,EACZ,UAAU,EACV,IAAI,EACJ,MAAM,EACN,QAAQ,EACR,WAAW,EACX,aAAa,EACb,GAAG,EACH,WAAW,EACX,UAAU,EACV,WAAW,EACX,UAAU,EACV,EAAE,GACF,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACN,cAAc,EACd,QAAQ,EACR,SAAS,EACT,SAAS,EACT,UAAU,EACV,QAAQ,EACR,MAAM,EACN,EAAE,EACF,YAAY,EACZ,cAAc,EACd,IAAI,EACJ,EAAE,GACF,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,IAAI,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,cAAc,sBAAsB,CAAC;AACrC,YAAY,EACX,MAAM,EACN,SAAS,EACT,iBAAiB,EACjB,OAAO,EACP,SAAS,EACT,gBAAgB,EAChB,aAAa,EACb,aAAa,EACb,MAAM,EACN,cAAc,EACd,YAAY,EACZ,YAAY,EACZ,UAAU,EACV,YAAY,EACZ,YAAY,EACZ,UAAU,EACV,KAAK,EACL,YAAY,EACZ,aAAa,EACb,cAAc,EACd,IAAI,EACJ,MAAM,EACN,QAAQ,EACR,WAAW,EACX,aAAa,EACb,MAAM,EACN,SAAS,EACT,aAAa,EACb,aAAa,EACb,YAAY,EACZ,UAAU,EACV,eAAe,EACf,aAAa,EACb,GAAG,EACH,YAAY,EACZ,WAAW,EACX,cAAc,EACd,iBAAiB,EACjB,SAAS,EACT,UAAU,EACV,WAAW,EACX,UAAU,EACV,YAAY,EACZ,WAAW,EACX,UAAU,EACV,aAAa,EACb,EAAE,GACF,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACN,cAAc,EACd,QAAQ,EACR,SAAS,EACT,SAAS,EACT,UAAU,EACV,gBAAgB,EAChB,SAAS,EACT,YAAY,EACZ,QAAQ,EACR,oBAAoB,EACpB,OAAO,EACP,OAAO,EACP,MAAM,EACN,aAAa,EACb,mBAAmB,EACnB,EAAE,EACF,YAAY,EACZ,cAAc,EACd,MAAM,EACN,IAAI,EACJ,WAAW,EACX,mBAAmB,EACnB,IAAI,EACJ,EAAE,GACF,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,IAAI,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -5,15 +5,16 @@
  * spies/lifecycle), the container facade, and time-travel — none of which import
  * an ecosystem package. It is fully agnostic: usable in any project.
  *
- * Per-package test fakes/helpers live in EACH package's own `/testing` subpath
- * (a package owns its test surface, not helix): `@c9up/ream/testing`
- * (TestClient, FakeBus, assertEmitted), `@c9up/atlas/testing` (factory,
- * useTransaction), `@c9up/rover/testing` (FakeMail), `@c9up/bay/testing`
- * (FakeQueue), `@c9up/spectrum/testing` (FakeLogger), `@c9up/nova/testing`
- * (FakeNova), `@c9up/relay/testing` (FakeRelay), `@c9up/archive/testing`
- * (FakeStorage). Install a package → you get its testing surface.
+ * Capabilities ship as PLUGINS (the Japa/AdonisJS topology): each package's
+ * `/testing` subpath exports plugins that extend the injected test context via
+ * `configure({ plugins: [...] })` — `@c9up/ream/testing` (apiClient → `client`,
+ * FakeBus), `@c9up/atlas/testing` (factory, useTransaction, db), `@c9up/rover/
+ * testing` (FakeMail), `@c9up/bay/testing` (FakeQueue), `@c9up/spectrum/testing`
+ * (FakeLogger), `@c9up/nova/testing` (FakeNova), `@c9up/relay/testing`
+ * (FakeRelay), `@c9up/archive/testing` (FakeStorage). The plugins depend on
+ * helix, never the other way round — the core stays agnostic.
  */
 export * from "./container/index.js";
-export { AssertionError, afterAll, afterEach, beforeAll, beforeEach, describe, expect, it, onTestFailed, onTestFinished, test, vi, } from "./runtime/index.js";
+export { AssertionError, afterAll, afterEach, beforeAll, beforeEach, buildTestContext, configure, createAssert, describe, drainRunnerTeardowns, Emitter, emitter, expect, getActiveTest, getActiveTestOrFail, it, onTestFailed, onTestFinished, Runner, Test, TestContext, TestContextRegistry, test, vi, } from "./runtime/index.js";
 export * as time from "./time/index.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,cAAc,sBAAsB,CAAC;AAmBrC,OAAO,EACN,cAAc,EACd,QAAQ,EACR,SAAS,EACT,SAAS,EACT,UAAU,EACV,QAAQ,EACR,MAAM,EACN,EAAE,EACF,YAAY,EACZ,cAAc,EACd,IAAI,EACJ,EAAE,GACF,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,IAAI,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,cAAc,sBAAsB,CAAC;AAkDrC,OAAO,EACN,cAAc,EACd,QAAQ,EACR,SAAS,EACT,SAAS,EACT,UAAU,EACV,gBAAgB,EAChB,SAAS,EACT,YAAY,EACZ,QAAQ,EACR,oBAAoB,EACpB,OAAO,EACP,OAAO,EACP,MAAM,EACN,aAAa,EACb,mBAAmB,EACnB,EAAE,EACF,YAAY,EACZ,cAAc,EACd,MAAM,EACN,IAAI,EACJ,WAAW,EACX,mBAAmB,EACnB,IAAI,EACJ,EAAE,GACF,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,IAAI,MAAM,iBAAiB,CAAC"}

package/dist/japa/core.d.ts

@@ -0,0 +1,106 @@
+/**
+ * `@japa/runner/core`, as much of it as a PLUGIN touches.
+ *
+ * An official Japa plugin does not talk to the runner through an interface — it
+ * imports the classes and instruments them:
+ *
+ *     import { Test, TestContext } from "@japa/runner/core"
+ *     TestContext.getter("assert", () => new Assert(), true)
+ *     Test.executed((test, hasError) => { … })
+ *
+ * Nothing helix does at runtime can change what that import resolves to, which
+ * is why "the API is the same shape" was never enough. What CAN change it is
+ * module resolution: `japa-alias.mjs` redirects the specifier to this file, and
+ * these two classes forward to helix's own registry. The plugin is then
+ * instrumenting helix without knowing it.
+ *
+ * Deliberately not a reimplementation of Japa's classes: only the STATIC
+ * surface a plugin uses is here. Anything else a plugin reached for would be
+ * absent rather than wrong, which is the failure mode to prefer.
+ */
+import { Emitter } from "../runtime/emitter.js";
+/**
+ * `Emitter` is helix's own — same event names, same node shapes, verified by
+ * the golden journals. A plugin subscribing through it subscribes to the run.
+ */
+export { Emitter };
+/**
+ * Japa's `Refiner` — a filter collector. Standalone until something reads it,
+ * which is why `configure({ refiner })` is where one becomes load-bearing; this
+ * class is what a plugin constructs to put there.
+ */
+export declare class Refiner {
+    readonly filters: {
+        tests: string[];
+        groups: string[];
+        tags: string[];
+        matchAll: boolean;
+    };
+    add(layer: "tests" | "groups" | "tags", values: string[]): this;
+    matchAllTags(toggle?: boolean): this;
+}
+/**
+ * Raised by the classes a plugin can IMPORT but not construct.
+ *
+ * They exist so an import resolves and `instanceof` answers — a helix group is
+ * not a Japa `Group`, and `false` is the right answer. Constructing one is what
+ * cannot work: helix builds its own tree and drives its own run, so a Japa
+ * `Suite` or `Runner` built here would be an object nothing ever looks at.
+ */
+export declare class JapaClassNotConstructibleError extends Error {
+    constructor(name: string);
+}
+/** Japa's `BaseReporter`. Reporters are the CLI's — see `runner.registerReporter`. */
+export declare class BaseReporter {
+    constructor();
+}
+/** Japa's `Group`. helix builds groups from the file's own `describe`/`test`. */
+export declare class Group {
+    constructor();
+}
+/** Japa's `Suite`. helix's suites come from the config, one per worker. */
+export declare class Suite {
+    constructor();
+}
+/** Japa's `Runner`. The CLI owns execution — see `RunnerNotDrivableError`. */
+export declare class Runner {
+    constructor();
+}
+/** What a plugin's `Test.executed` callback receives. */
+export type ExecutedCallback = (test: {
+    options: unknown;
+    context: unknown;
+}, hasError: boolean) => void | Promise<void>;
+/**
+ * Japa's `Test` — the static hooks a plugin registers on it. Instances come
+ * from helix's own runtime, so nothing here constructs a test.
+ */
+export declare class Test {
+    /**
+     * Tells the shim apart from the real `@japa/runner/core`. A plugin never
+     * needs it; it exists so "which one did this import resolve to?" has an
+     * answer, which is a question that costs an afternoon otherwise.
+     */
+    static readonly isHelixShim = true;
+    /** Run after every test of the run (Japa `Test.executed`). */
+    static executed(callback: ExecutedCallback): void;
+    /** Japa's `Test.macro`, mapped onto helix's context registry. */
+    static macro(name: string, value: unknown): void;
+}
+/**
+ * Japa's `TestContext` — the registrars a plugin uses to put something on every
+ * test's context.
+ */
+export declare class TestContext {
+    /** @see Test.isHelixShim */
+    static readonly isHelixShim = true;
+    /**
+     * Add a lazily-computed property (Japa `TestContext.getter`). Japa's third
+     * argument asks for the value to be cached per context; helix's getters are
+     * always cached per context, so it is accepted and has nothing to change.
+     */
+    static getter(name: string, accumulator: () => unknown, _singleton?: boolean): void;
+    /** Add a shared property (Japa `TestContext.macro`). */
+    static macro(name: string, value: unknown): void;
+}
+//# sourceMappingURL=core.d.ts.map

package/dist/japa/core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../src/japa/core.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAGH,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAGhD;;;GAGG;AACH,OAAO,EAAE,OAAO,EAAE,CAAC;AAEnB;;;;GAIG;AACH,qBAAa,OAAO;IACnB,QAAQ,CAAC,OAAO,EAAE;QACjB,KAAK,EAAE,MAAM,EAAE,CAAC;QAChB,MAAM,EAAE,MAAM,EAAE,CAAC;QACjB,IAAI,EAAE,MAAM,EAAE,CAAC;QACf,QAAQ,EAAE,OAAO,CAAC;KAClB,CAAwD;IAEzD,GAAG,CAAC,KAAK,EAAE,OAAO,GAAG,QAAQ,GAAG,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI;IAK/D,YAAY,CAAC,MAAM,UAAO,GAAG,IAAI;CAIjC;AAED;;;;;;;GAOG;AACH,qBAAa,8BAA+B,SAAQ,KAAK;gBAC5C,IAAI,EAAE,MAAM;CASxB;AAED,sFAAsF;AACtF,qBAAa,YAAY;;CAIxB;AAED,iFAAiF;AACjF,qBAAa,KAAK;;CAIjB;AAED,2EAA2E;AAC3E,qBAAa,KAAK;;CAIjB;AAED,8EAA8E;AAC9E,qBAAa,MAAM;;CAIlB;AAED,yDAAyD;AACzD,MAAM,MAAM,gBAAgB,GAAG,CAC9B,IAAI,EAAE;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,EAC5C,QAAQ,EAAE,OAAO,KACb,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAE1B;;;GAGG;AAEH,qBAAa,IAAI;IAChB;;;;OAIG;IACH,MAAM,CAAC,QAAQ,CAAC,WAAW,QAAQ;IAEnC,8DAA8D;IAC9D,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,GAAG,IAAI;IAIjD,iEAAiE;IACjE,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI;CAGhD;AAED;;;GAGG;AAEH,qBAAa,WAAW;IACvB,4BAA4B;IAC5B,MAAM,CAAC,QAAQ,CAAC,WAAW,QAAQ;IAEnC;;;;OAIG;IACH,MAAM,CAAC,MAAM,CACZ,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,OAAO,EAC1B,UAAU,CAAC,EAAE,OAAO,GAClB,IAAI;IAIP,wDAAwD;IACxD,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI;CAGhD"}

package/dist/japa/core.js

@@ -0,0 +1,128 @@
+/**
+ * `@japa/runner/core`, as much of it as a PLUGIN touches.
+ *
+ * An official Japa plugin does not talk to the runner through an interface — it
+ * imports the classes and instruments them:
+ *
+ *     import { Test, TestContext } from "@japa/runner/core"
+ *     TestContext.getter("assert", () => new Assert(), true)
+ *     Test.executed((test, hasError) => { … })
+ *
+ * Nothing helix does at runtime can change what that import resolves to, which
+ * is why "the API is the same shape" was never enough. What CAN change it is
+ * module resolution: `japa-alias.mjs` redirects the specifier to this file, and
+ * these two classes forward to helix's own registry. The plugin is then
+ * instrumenting helix without knowing it.
+ *
+ * Deliberately not a reimplementation of Japa's classes: only the STATIC
+ * surface a plugin uses is here. Anything else a plugin reached for would be
+ * absent rather than wrong, which is the failure mode to prefer.
+ */
+import { TestContextRegistry } from "../runtime/context.js";
+import { Emitter } from "../runtime/emitter.js";
+import { registerExecutedHook } from "../runtime/test-context.js";
+/**
+ * `Emitter` is helix's own — same event names, same node shapes, verified by
+ * the golden journals. A plugin subscribing through it subscribes to the run.
+ */
+export { Emitter };
+/**
+ * Japa's `Refiner` — a filter collector. Standalone until something reads it,
+ * which is why `configure({ refiner })` is where one becomes load-bearing; this
+ * class is what a plugin constructs to put there.
+ */
+export class Refiner {
+    filters = { tests: [], groups: [], tags: [], matchAll: false };
+    add(layer, values) {
+        this.filters[layer].push(...values);
+        return this;
+    }
+    matchAllTags(toggle = true) {
+        this.filters.matchAll = toggle;
+        return this;
+    }
+}
+/**
+ * Raised by the classes a plugin can IMPORT but not construct.
+ *
+ * They exist so an import resolves and `instanceof` answers — a helix group is
+ * not a Japa `Group`, and `false` is the right answer. Constructing one is what
+ * cannot work: helix builds its own tree and drives its own run, so a Japa
+ * `Suite` or `Runner` built here would be an object nothing ever looks at.
+ */
+export class JapaClassNotConstructibleError extends Error {
+    constructor(name) {
+        super(`new ${name}() is not available on helix: it builds its own test tree ` +
+            "and drives its own run, so an instance here would be one nothing " +
+            `reads. The class exists so \`import { ${name} }\` resolves and ` +
+            "`instanceof` answers.");
+        this.name = "JapaClassNotConstructibleError";
+    }
+}
+/** Japa's `BaseReporter`. Reporters are the CLI's — see `runner.registerReporter`. */
+export class BaseReporter {
+    constructor() {
+        throw new JapaClassNotConstructibleError("BaseReporter");
+    }
+}
+/** Japa's `Group`. helix builds groups from the file's own `describe`/`test`. */
+export class Group {
+    constructor() {
+        throw new JapaClassNotConstructibleError("Group");
+    }
+}
+/** Japa's `Suite`. helix's suites come from the config, one per worker. */
+export class Suite {
+    constructor() {
+        throw new JapaClassNotConstructibleError("Suite");
+    }
+}
+/** Japa's `Runner`. The CLI owns execution — see `RunnerNotDrivableError`. */
+export class Runner {
+    constructor() {
+        throw new JapaClassNotConstructibleError("Runner");
+    }
+}
+/**
+ * Japa's `Test` — the static hooks a plugin registers on it. Instances come
+ * from helix's own runtime, so nothing here constructs a test.
+ */
+// biome-ignore lint/complexity/noStaticOnlyClass: stands in for a class Japa exports — an object literal breaks the day a plugin writes `instanceof` or `extends`, which is the one place being a class is the point.
+export class Test {
+    /**
+     * Tells the shim apart from the real `@japa/runner/core`. A plugin never
+     * needs it; it exists so "which one did this import resolve to?" has an
+     * answer, which is a question that costs an afternoon otherwise.
+     */
+    static isHelixShim = true;
+    /** Run after every test of the run (Japa `Test.executed`). */
+    static executed(callback) {
+        registerExecutedHook(callback);
+    }
+    /** Japa's `Test.macro`, mapped onto helix's context registry. */
+    static macro(name, value) {
+        TestContextRegistry.macro(name, value);
+    }
+}
+/**
+ * Japa's `TestContext` — the registrars a plugin uses to put something on every
+ * test's context.
+ */
+// biome-ignore lint/complexity/noStaticOnlyClass: same as `Test` above — it replaces an exported class, not a namespace.
+export class TestContext {
+    /** @see Test.isHelixShim */
+    static isHelixShim = true;
+    /**
+     * Add a lazily-computed property (Japa `TestContext.getter`). Japa's third
+     * argument asks for the value to be cached per context; helix's getters are
+     * always cached per context, so it is accepted and has nothing to change.
+     */
+    static getter(name, accumulator, _singleton) {
+        TestContextRegistry.getter(name, () => accumulator());
+    }
+    /** Add a shared property (Japa `TestContext.macro`). */
+    static macro(name, value) {
+        TestContextRegistry.macro(name, value);
+    }
+}
+//# sourceMappingURL=core.js.map

package/dist/japa/core.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.js","sourceRoot":"","sources":["../../src/japa/core.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAChD,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAElE;;;GAGG;AACH,OAAO,EAAE,OAAO,EAAE,CAAC;AAEnB;;;;GAIG;AACH,MAAM,OAAO,OAAO;IACV,OAAO,GAKZ,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;IAEzD,GAAG,CAAC,KAAkC,EAAE,MAAgB;QACvD,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,CAAC;QACpC,OAAO,IAAI,CAAC;IACb,CAAC;IAED,YAAY,CAAC,MAAM,GAAG,IAAI;QACzB,IAAI,CAAC,OAAO,CAAC,QAAQ,GAAG,MAAM,CAAC;QAC/B,OAAO,IAAI,CAAC;IACb,CAAC;CACD;AAED;;;;;;;GAOG;AACH,MAAM,OAAO,8BAA+B,SAAQ,KAAK;IACxD,YAAY,IAAY;QACvB,KAAK,CACJ,OAAO,IAAI,4DAA4D;YACtE,mEAAmE;YACnE,yCAAyC,IAAI,oBAAoB;YACjE,uBAAuB,CACxB,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,gCAAgC,CAAC;IAC9C,CAAC;CACD;AAED,sFAAsF;AACtF,MAAM,OAAO,YAAY;IACxB;QACC,MAAM,IAAI,8BAA8B,CAAC,cAAc,CAAC,CAAC;IAC1D,CAAC;CACD;AAED,iFAAiF;AACjF,MAAM,OAAO,KAAK;IACjB;QACC,MAAM,IAAI,8BAA8B,CAAC,OAAO,CAAC,CAAC;IACnD,CAAC;CACD;AAED,2EAA2E;AAC3E,MAAM,OAAO,KAAK;IACjB;QACC,MAAM,IAAI,8BAA8B,CAAC,OAAO,CAAC,CAAC;IACnD,CAAC;CACD;AAED,8EAA8E;AAC9E,MAAM,OAAO,MAAM;IAClB;QACC,MAAM,IAAI,8BAA8B,CAAC,QAAQ,CAAC,CAAC;IACpD,CAAC;CACD;AAQD;;;GAGG;AACH,sNAAsN;AACtN,MAAM,OAAO,IAAI;IAChB;;;;OAIG;IACH,MAAM,CAAU,WAAW,GAAG,IAAI,CAAC;IAEnC,8DAA8D;IAC9D,MAAM,CAAC,QAAQ,CAAC,QAA0B;QACzC,oBAAoB,CAAC,QAAQ,CAAC,CAAC;IAChC,CAAC;IAED,iEAAiE;IACjE,MAAM,CAAC,KAAK,CAAC,IAAY,EAAE,KAAc;QACxC,mBAAmB,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACxC,CAAC;;AAGF;;;GAGG;AACH,yHAAyH;AACzH,MAAM,OAAO,WAAW;IACvB,4BAA4B;IAC5B,MAAM,CAAU,WAAW,GAAG,IAAI,CAAC;IAEnC;;;;OAIG;IACH,MAAM,CAAC,MAAM,CACZ,IAAY,EACZ,WAA0B,EAC1B,UAAoB;QAEpB,mBAAmB,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC;IACvD,CAAC;IAED,wDAAwD;IACxD,MAAM,CAAC,KAAK,CAAC,IAAY,EAAE,KAAc;QACxC,mBAAmB,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACxC,CAAC"}