@c9up/helix 0.1.9 → 0.2.0

package/dist/japa/core.d.ts

@@ -1,106 +0,0 @@
-/**
- * `@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

@@ -1 +0,0 @@
-{"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

@@ -1,128 +0,0 @@
-/**
- * `@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

@@ -1 +0,0 @@
-{"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"}