@c9up/helix 0.1.8 → 0.1.10

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"}