@c9up/helix 0.1.3 → 0.1.4

package/dist/cli/reporter.js

@@ -0,0 +1,124 @@
+/**
+ * Reporters — receive lifecycle callbacks as each file completes, write
+ * incremental output to the given sink. Three built-ins matching the
+ * Rust-side reporter trait:
+ *   - Dot: one char per test
+ *   - Spec: nested tree with colours + diff lines on failure
+ *   - Json: NDJSON to stdout, machine-readable
+ */
+export function stdoutSink() {
+    return {
+        write(chunk) {
+            process.stdout.write(chunk);
+        },
+        writeLine(chunk) {
+            process.stdout.write(`${chunk}\n`);
+        },
+    };
+}
+const ANSI = {
+    dim: (s, on) => (on ? `\x1b[90m${s}\x1b[0m` : s),
+    red: (s, on) => (on ? `\x1b[31m${s}\x1b[0m` : s),
+    green: (s, on) => (on ? `\x1b[32m${s}\x1b[0m` : s),
+    yellow: (s, on) => (on ? `\x1b[33m${s}\x1b[0m` : s),
+};
+export class DotReporter {
+    sink;
+    constructor(sink = stdoutSink()) {
+        this.sink = sink;
+    }
+    onFileStart(_file) { }
+    onFileResult(result) {
+        for (const t of result.tests) {
+            const c = t.status === "pass"
+                ? "."
+                : t.status === "fail"
+                    ? "F"
+                    : t.status === "skip"
+                        ? "-"
+                        : "*";
+            this.sink.write(c);
+        }
+    }
+    onFileError(_error) {
+        this.sink.write("E");
+    }
+    onSummary(summary) {
+        this.sink.writeLine("");
+        printSummary(this.sink, summary);
+    }
+}
+export class SpecReporter {
+    sink;
+    useColors;
+    constructor(sink = stdoutSink(), useColors = true) {
+        this.sink = sink;
+        this.useColors = useColors;
+    }
+    onFileStart(file) {
+        this.sink.writeLine(`${ANSI.dim("▶", this.useColors)} ${ANSI.dim(file, this.useColors)}`);
+    }
+    onFileResult(result) {
+        for (const t of result.tests) {
+            const marker = t.status === "pass"
+                ? ANSI.green("✔", this.useColors)
+                : t.status === "fail"
+                    ? ANSI.red("✘", this.useColors)
+                    : t.status === "skip"
+                        ? ANSI.yellow("○", this.useColors)
+                        : ANSI.dim("☐", this.useColors);
+            this.sink.writeLine(`  ${marker} ${t.fullName}`);
+            if (t.error) {
+                this.sink.writeLine(`      ${ANSI.red(t.error.message, this.useColors)}`);
+                if (t.error.actual !== undefined && t.error.expected !== undefined) {
+                    this.sink.writeLine(`      ${ANSI.dim("actual:  ", this.useColors)} ${JSON.stringify(t.error.actual)}`);
+                    this.sink.writeLine(`      ${ANSI.dim("expected:", this.useColors)} ${JSON.stringify(t.error.expected)}`);
+                }
+            }
+        }
+    }
+    onFileError(error) {
+        const file = error.file ?? "<unknown>";
+        this.sink.writeLine(`${ANSI.red("✘", this.useColors)} ${file}: ${error.message}`);
+    }
+    onSummary(summary) {
+        this.sink.writeLine("");
+        printSummary(this.sink, summary);
+    }
+}
+export class JsonReporter {
+    sink;
+    constructor(sink = stdoutSink()) {
+        this.sink = sink;
+    }
+    onFileStart(file) {
+        this.sink.writeLine(JSON.stringify({ event: "file:start", file }));
+    }
+    onFileResult(result) {
+        this.sink.writeLine(JSON.stringify({ event: "file:end", result }));
+    }
+    onFileError(error) {
+        this.sink.writeLine(JSON.stringify({ event: "file:error", error }));
+    }
+    onSummary(summary) {
+        this.sink.writeLine(JSON.stringify({ event: "summary", summary }));
+    }
+}
+function printSummary(sink, summary) {
+    const t = summary.totals;
+    sink.writeLine("──────────────────────────────────────");
+    sink.writeLine(`  ${t.pass} passed | ${t.fail} failed | ${t.skip} skipped | ${t.todo} todo | ${t.fileErrors} file errors`);
+    sink.writeLine(`  ${summary.durationMs} ms`);
+}
+/** Factory from a CLI-style name. */
+export function makeReporter(name, useColors) {
+    switch ((name ?? "spec").toLowerCase()) {
+        case "dot":
+            return new DotReporter();
+        case "json":
+            return new JsonReporter();
+        default:
+            return new SpecReporter(stdoutSink(), useColors);
+    }
+}
+//# sourceMappingURL=reporter.js.map

package/dist/cli/reporter.js.map

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

package/dist/cli/run.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Orchestrator entry point — the TS equivalent of `ream-test-napi::run`.
+ *
+ * Discovers test files (or uses the explicit list), spawns the worker
+ * pool, collects framed results, aggregates into a `Summary`, and invokes
+ * the reporter at each milestone. When coverage is enabled, also threads
+ * the V8 coverage lifecycle (open session → forward `NODE_V8_COVERAGE`
+ * env to workers → aggregate after pool drain → write reports → enforce
+ * thresholds).
+ *
+ * Designed so the future NAPI binding can be plugged in as a drop-in
+ * replacement: both sides accept the same `RunConfig` shape and return
+ * the same `Summary`.
+ */
+import { type DiffOptions, type DiffSummary } from "./coverage/diff/index.js";
+import { type CoverageOptions, type CoverageSummary, type ThresholdViolation } from "./coverage/index.js";
+import { type DiscoveryOptions } from "./discover.js";
+import { type Reporter } from "./reporter.js";
+import { type Summary } from "./summary.js";
+import type { WatchOptions } from "./watch/types.js";
+export type { WatchOptions } from "./watch/types.js";
+export interface RunConfig {
+    /** Absolute root directory to discover from. */
+    root: string;
+    /** Explicit files to run. When non-empty, discovery is skipped. */
+    files?: string[];
+    /** Discovery options (suffixes, excludes). */
+    discovery?: DiscoveryOptions;
+    /** Number of concurrent workers. Default: os.cpus().length. */
+    threads?: number;
+    /** Per-file timeout (ms). Default 60 000. */
+    timeoutMs?: number;
+    /** Reporter name: `"dot" | "spec" | "json"`. Default `"spec"`. */
+    reporter?: string;
+    /** Enable ANSI colours. Default: stdout is TTY. */
+    useColors?: boolean;
+    /** Pluggable reporter instance (overrides `reporter` when provided). */
+    reporterInstance?: Reporter;
+    /** Override the node binary. Default: `process.execPath`. */
+    nodeBin?: string;
+    /** Extra args for node (before the worker entry). */
+    nodeArgs?: string[];
+    /** Override the worker entry path (defaults to bundled `cli-worker.ts`). */
+    workerEntry?: string;
+    /** Coverage collection + reporting. Defaults to `{ enabled: false }`. */
+    coverage?: CoverageOptions;
+    /** Diff coverage vs a base ref. Requires `coverage.enabled === true`. */
+    diffCoverage?: DiffOptions;
+    /** Watch mode: re-run on file changes. */
+    watch?: WatchOptions;
+}
+export interface RunOutcome {
+    summary: Summary;
+    coverage?: CoverageSummary;
+    coverageViolations?: ThresholdViolation[];
+    diffCoverage?: DiffSummary;
+    diffCoverageViolations?: ThresholdViolation[];
+    exitCode: number;
+}
+export declare function run(config: RunConfig): Promise<RunOutcome>;
+//# sourceMappingURL=run.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../src/cli/run.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAOH,OAAO,EACN,KAAK,WAAW,EAChB,KAAK,WAAW,EAGhB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACN,KAAK,eAAe,EAEpB,KAAK,eAAe,EAGpB,KAAK,kBAAkB,EAEvB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,KAAK,gBAAgB,EAAY,MAAM,eAAe,CAAC;AAGhE,OAAO,EAAgB,KAAK,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC5D,OAAO,EAGN,KAAK,OAAO,EAEZ,MAAM,cAAc,CAAC;AAEtB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAErD,YAAY,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAoBrD,MAAM,WAAW,SAAS;IACzB,gDAAgD;IAChD,IAAI,EAAE,MAAM,CAAC;IACb,mEAAmE;IACnE,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,8CAA8C;IAC9C,SAAS,CAAC,EAAE,gBAAgB,CAAC;IAC7B,+DAA+D;IAC/D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,6CAA6C;IAC7C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kEAAkE;IAClE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,mDAAmD;IACnD,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,wEAAwE;IACxE,gBAAgB,CAAC,EAAE,QAAQ,CAAC;IAC5B,6DAA6D;IAC7D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qDAAqD;IACrD,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,4EAA4E;IAC5E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yEAAyE;IACzE,QAAQ,CAAC,EAAE,eAAe,CAAC;IAC3B,yEAAyE;IACzE,YAAY,CAAC,EAAE,WAAW,CAAC;IAC3B,0CAA0C;IAC1C,KAAK,CAAC,EAAE,YAAY,CAAC;CACrB;AAED,MAAM,WAAW,UAAU;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,eAAe,CAAC;IAC3B,kBAAkB,CAAC,EAAE,kBAAkB,EAAE,CAAC;IAC1C,YAAY,CAAC,EAAE,WAAW,CAAC;IAC3B,sBAAsB,CAAC,EAAE,kBAAkB,EAAE,CAAC;IAC9C,QAAQ,EAAE,MAAM,CAAC;CACjB;AAwDD,wBAAsB,GAAG,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CA4BhE"}

package/dist/cli/run.js

@@ -0,0 +1,302 @@
+/**
+ * Orchestrator entry point — the TS equivalent of `ream-test-napi::run`.
+ *
+ * Discovers test files (or uses the explicit list), spawns the worker
+ * pool, collects framed results, aggregates into a `Summary`, and invokes
+ * the reporter at each milestone. When coverage is enabled, also threads
+ * the V8 coverage lifecycle (open session → forward `NODE_V8_COVERAGE`
+ * env to workers → aggregate after pool drain → write reports → enforce
+ * thresholds).
+ *
+ * Designed so the future NAPI binding can be plugged in as a drop-in
+ * replacement: both sides accept the same `RunConfig` shape and return
+ * the same `Summary`.
+ */
+import { existsSync } from "node:fs";
+import { rm } from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { diffViolationSummary, finaliseDiff, } from "./coverage/diff/index.js";
+import { finalise as finaliseCoverage, openSession, violationSummary, } from "./coverage/index.js";
+import { discover } from "./discover.js";
+import { getNative } from "./native.js";
+import { runPool } from "./pool.js";
+import { makeReporter } from "./reporter.js";
+import { buildSummary, exitCode, } from "./summary.js";
+import { runWatch } from "./watch/loop.js";
+const DEFAULT_WATCH_DEBOUNCE_MS = 200;
+const DEFAULT_WATCH_INCLUDE = [
+    "src/**/*.{ts,tsx,js,mjs,cjs}",
+    "tests/**/*.{ts,tsx,js,mjs,cjs}",
+    "test/**/*.{ts,tsx,js,mjs,cjs}",
+];
+const DEFAULT_WATCH_EXCLUDE = [
+    "node_modules/**",
+    "dist/**",
+    "build/**",
+    "coverage/**",
+    ".helix-coverage/**",
+    ".git/**",
+    ".wolf/**",
+    "target/**",
+    ".next/**",
+];
+function defaultWorkerEntry() {
+    // Resolve relative to THIS module's directory so it works whether we run
+    // from `src/cli/run.ts` (dev: src sibling is `.ts`) or from the compiled
+    // `dist/cli/run.js` (publish: sibling is `.js`). Hardcoding `.ts` made
+    // the spawned worker open a non-existent `dist/runtime/cli-worker.ts`
+    // when consumed via the dist tarball, dying silently before the pool's
+    // frame handler could observe anything.
+    const here = path.dirname(fileURLToPath(import.meta.url));
+    const compiled = path.resolve(here, "../runtime/cli-worker.js");
+    if (existsSync(compiled))
+        return compiled;
+    return path.resolve(here, "../runtime/cli-worker.ts");
+}
+/**
+ * Plain-path execution via the native `ream-test-napi` engine: it discovers
+ * (skipped here — we pass the resolved `files`), spawns the worker pool, drives
+ * the reporter, and returns aggregated totals. Per-file detail is carried in
+ * `payload.json` (same shape as `Summary`) for callers that need it; the CLI
+ * only consumes `exitCode`, and the Rust reporter already streamed per-file
+ * output, so the reconstructed `Summary` keeps the detail arrays empty.
+ */
+async function runNative(config, root, files) {
+    const { run: nativeRun } = getNative();
+    const payload = await nativeRun({
+        root,
+        files,
+        threads: config.threads,
+        timeoutMs: config.timeoutMs,
+        reporter: config.reporter,
+        workerEntry: config.workerEntry ?? defaultWorkerEntry(),
+        nodeBin: config.nodeBin ?? process.execPath,
+        nodeArgs: config.nodeArgs,
+        useColors: config.useColors ?? process.stdout.isTTY === true,
+    });
+    const totals = {
+        pass: payload.pass,
+        fail: payload.fail,
+        skip: payload.skip,
+        todo: payload.todo,
+        fileErrors: payload.fileErrors,
+    };
+    const summary = {
+        totals,
+        files: [],
+        fileErrors: [],
+        durationMs: payload.durationMs,
+    };
+    return { summary, exitCode: payload.exitCode };
+}
+export async function run(config) {
+    if (!config.watch?.enabled)
+        return runOnce(config);
+    const root = path.isAbsolute(config.root)
+        ? config.root
+        : path.resolve(config.root);
+    const debounceMs = config.watch.debounceMs ?? DEFAULT_WATCH_DEBOUNCE_MS;
+    // When the user has configured custom coverage globs, mirror them in
+    // the watcher so the two surfaces agree on "files I care about".
+    // Otherwise fall back to the watch defaults (which intentionally
+    // include `tests/**` even though coverage doesn't, so editing a test
+    // triggers a re-run).
+    const include = config.watch.include ?? config.coverage?.include ?? DEFAULT_WATCH_INCLUDE;
+    const exclude = [
+        ...(config.watch.exclude ??
+            config.coverage?.exclude ??
+            DEFAULT_WATCH_EXCLUDE),
+    ];
+    return runWatch({
+        root,
+        include,
+        exclude,
+        debounceMs,
+        signal: config.watch.signal,
+    }, () => runOnce(config));
+}
+/** Resolve the explicit file list, or discover, warning when nothing matches. */
+async function resolveRunFiles(config, root) {
+    const files = config.files && config.files.length > 0
+        ? config.files.map((f) => (path.isAbsolute(f) ? f : path.resolve(f)))
+        : await discover(root, config.discovery);
+    if (files.length === 0) {
+        process.stderr.write(`helix: no test files found under ${root} — check your include/exclude patterns.\n`);
+    }
+    return files;
+}
+/**
+ * Refuse mis-configured diff coverage up front (before spawning workers) so the
+ * user fixes the config rather than getting a silent no-op or 0% diff coverage.
+ */
+function assertDiffCoverageConfig(config, root) {
+    if (!config.diffCoverage?.enabled)
+        return;
+    // Diff-cov requires the full-tree coverage to be enabled — it has nothing
+    // to overlay otherwise.
+    if (config.coverage?.enabled !== true) {
+        throw new Error("diffCoverage.enabled requires coverage.enabled — diff-cov has nothing to overlay otherwise.");
+    }
+    // Diff-cov spawns git in `diffCoverage.cwd` (defaulting to `coverage.root`).
+    // The two paths must share a common ancestry — either coverage.root is
+    // under diffCoverage.cwd (common monorepo case: `cwd` = git root,
+    // `root` = a sub-package), or diffCoverage.cwd is under coverage.root
+    // (legacy single-repo case). When they're fully disjoint, every diff
+    // entry resolves to a path the coverage summary never indexes →
+    // silent 0% diff coverage. Refuse only that case.
+    if (!config.diffCoverage.cwd)
+        return;
+    const covRoot = path.resolve(config.coverage?.root ?? root);
+    const diffCwd = path.resolve(config.diffCoverage.cwd);
+    const covUnderDiff = path.relative(diffCwd, covRoot);
+    const diffUnderCov = path.relative(covRoot, diffCwd);
+    const covDescendantOfDiff = covUnderDiff !== "" &&
+        !covUnderDiff.startsWith("..") &&
+        !path.isAbsolute(covUnderDiff);
+    const diffDescendantOfCov = diffUnderCov !== "" &&
+        !diffUnderCov.startsWith("..") &&
+        !path.isAbsolute(diffUnderCov);
+    const equal = covUnderDiff === "";
+    if (!equal && !covDescendantOfDiff && !diffDescendantOfCov) {
+        throw new Error(`diffCoverage.cwd (${diffCwd}) and coverage.root (${covRoot}) are disjoint paths; diff entries would never overlay coverage.`);
+    }
+}
+/**
+ * Finalise full-tree coverage, then overlay diff coverage on top. Each stage is
+ * isolated: a failed coverage finalise (disk full, permissions) or a thrown
+ * diff-cov is surfaced to stderr without crashing the run, but a diff-cov
+ * failure still flips `diffCoverageFailed` so the CI gate stays red.
+ */
+async function finaliseCoverageOutcome(config, root, session) {
+    const out = { diffCoverageFailed: false };
+    try {
+        const finalised = await finaliseCoverage({
+            root: config.coverage.root ?? root,
+            session,
+            enabled: true,
+            include: config.coverage.include,
+            exclude: config.coverage.exclude,
+            reporters: config.coverage.reporters,
+            outputDir: config.coverage.outputDir,
+            thresholds: config.coverage.thresholds,
+        });
+        out.coverage = finalised.summary;
+        out.coverageViolations = finalised.violations;
+        if (finalised.textReport)
+            process.stdout.write(finalised.textReport);
+        if (finalised.violations.length > 0) {
+            process.stderr.write(`${violationSummary(finalised.violations)}\n`);
+        }
+        // Diff coverage runs AFTER full-tree finalise, using its summary.
+        if (config.diffCoverage?.enabled && out.coverage) {
+            await overlayDiffCoverage(config, root, out.coverage, out);
+        }
+    }
+    catch (err) {
+        // Coverage finalisation failed (disk full, permission, etc.) — the test
+        // summary already printed; surface the failure but don't crash the whole
+        // run with a stack trace.
+        process.stderr.write(`helix-coverage: ${err instanceof Error ? err.message : String(err)}\n`);
+        out.coverageViolations = [];
+    }
+    return out;
+}
+/** Overlay diff coverage onto an already-finalised full-tree summary. */
+async function overlayDiffCoverage(config, root, coverage, out) {
+    if (!config.diffCoverage?.enabled)
+        return;
+    try {
+        const diff = await finaliseDiff({
+            enabled: true,
+            root: config.coverage.root ?? root,
+            coverage,
+            base: config.diffCoverage.base,
+            thresholds: config.diffCoverage.thresholds,
+            outputDir: config.diffCoverage.outputDir ?? config.coverage.outputDir,
+            cwd: config.diffCoverage.cwd,
+        });
+        if (diff.warning) {
+            process.stderr.write(`${diff.warning}\n`);
+            return;
+        }
+        out.diffCoverage = diff.summary;
+        out.diffCoverageViolations = diff.violations;
+        if (diff.textReport)
+            process.stdout.write(diff.textReport);
+        if (diff.violations.length > 0) {
+            process.stderr.write(`${diffViolationSummary(diff.violations)}\n`);
+        }
+    }
+    catch (err) {
+        process.stderr.write(`helix-diff-cov: ${err instanceof Error ? err.message : String(err)}\n`);
+        // Don't let a thrown finaliseDiff masquerade as a clean run — the user
+        // explicitly opted into diff-cov and a CI gate around it must still fail.
+        out.diffCoverageFailed = true;
+    }
+}
+async function runOnce(config) {
+    const started = Date.now();
+    const root = path.isAbsolute(config.root)
+        ? config.root
+        : path.resolve(config.root);
+    const files = await resolveRunFiles(config, root);
+    // Cutover: the Rust NAPI engine owns the plain discovery + worker-pool +
+    // reporter + summary path (42-N-orchestrator). Delegate unless a TS-only
+    // layer is active — a pluggable reporter instance, coverage, or diff-cov,
+    // none of which the Rust `run` exposes yet. Watch is already unwrapped by
+    // `run()` above, so it never reaches here.
+    if (!config.reporterInstance &&
+        config.coverage?.enabled !== true &&
+        config.diffCoverage?.enabled !== true) {
+        return runNative(config, root, files);
+    }
+    const reporter = config.reporterInstance ??
+        makeReporter(config.reporter, config.useColors ?? process.stdout.isTTY === true);
+    const threads = config.threads ?? os.cpus().length;
+    assertDiffCoverageConfig(config, root);
+    // Open a coverage session BEFORE spawning workers so `NODE_V8_COVERAGE`
+    // is set in their env. The pool forwards `extraEnv` to every spawn.
+    const coverageEnabled = config.coverage?.enabled === true;
+    const session = coverageEnabled ? await openSession() : undefined;
+    try {
+        const { results, errors } = await runPool(files, {
+            workerEntry: config.workerEntry ?? defaultWorkerEntry(),
+            nodeBin: config.nodeBin,
+            nodeArgs: config.nodeArgs,
+            threads,
+            timeoutMs: config.timeoutMs,
+            extraEnv: session?.env,
+        }, reporter);
+        const summary = buildSummary(results, errors, Date.now() - started);
+        reporter.onSummary(summary);
+        const cov = session && config.coverage
+            ? await finaliseCoverageOutcome({ ...config, coverage: config.coverage }, root, session)
+            : { diffCoverageFailed: false };
+        const baseExit = exitCode(summary);
+        const coverageExit = cov.coverageViolations && cov.coverageViolations.length > 0 ? 1 : 0;
+        const diffCoverageExit = (cov.diffCoverageViolations && cov.diffCoverageViolations.length > 0) ||
+            cov.diffCoverageFailed
+            ? 1
+            : 0;
+        return {
+            summary,
+            coverage: cov.coverage,
+            coverageViolations: cov.coverageViolations,
+            diffCoverage: cov.diffCoverage,
+            diffCoverageViolations: cov.diffCoverageViolations,
+            exitCode: Math.max(baseExit, coverageExit, diffCoverageExit),
+        };
+    }
+    finally {
+        // Belt-and-braces: if `runPool` itself rejected before
+        // `finaliseCoverage` ran (which normally cleans the temp dir), we
+        // still remove the session dir here so failed runs don't leak under
+        // `.helix-coverage/`.
+        if (session) {
+            await rm(session.envDir, { recursive: true, force: true }).catch(() => { });
+        }
+    }
+}
+//# sourceMappingURL=run.js.map

package/dist/cli/run.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.js","sourceRoot":"","sources":["../../src/cli/run.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,EAAE,EAAE,MAAM,kBAAkB,CAAC;AACtC,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAGN,oBAAoB,EACpB,YAAY,GACZ,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAIN,QAAQ,IAAI,gBAAgB,EAC5B,WAAW,EAEX,gBAAgB,GAChB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAyB,QAAQ,EAAE,MAAM,eAAe,CAAC;AAChE,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,YAAY,EAAiB,MAAM,eAAe,CAAC;AAC5D,OAAO,EACN,YAAY,EACZ,QAAQ,GAGR,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAK3C,MAAM,yBAAyB,GAAG,GAAG,CAAC;AACtC,MAAM,qBAAqB,GAAG;IAC7B,8BAA8B;IAC9B,gCAAgC;IAChC,+BAA+B;CAC/B,CAAC;AACF,MAAM,qBAAqB,GAAG;IAC7B,iBAAiB;IACjB,SAAS;IACT,UAAU;IACV,aAAa;IACb,oBAAoB;IACpB,SAAS;IACT,UAAU;IACV,WAAW;IACX,UAAU;CACV,CAAC;AA0CF,SAAS,kBAAkB;IAC1B,yEAAyE;IACzE,yEAAyE;IACzE,uEAAuE;IACvE,sEAAsE;IACtE,uEAAuE;IACvE,wCAAwC;IACxC,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1D,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,0BAA0B,CAAC,CAAC;IAChE,IAAI,UAAU,CAAC,QAAQ,CAAC;QAAE,OAAO,QAAQ,CAAC;IAC1C,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,0BAA0B,CAAC,CAAC;AACvD,CAAC;AAED;;;;;;;GAOG;AACH,KAAK,UAAU,SAAS,CACvB,MAAiB,EACjB,IAAY,EACZ,KAAe;IAEf,MAAM,EAAE,GAAG,EAAE,SAAS,EAAE,GAAG,SAAS,EAAE,CAAC;IACvC,MAAM,OAAO,GAAG,MAAM,SAAS,CAAC;QAC/B,IAAI;QACJ,KAAK;QACL,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,WAAW,EAAE,MAAM,CAAC,WAAW,IAAI,kBAAkB,EAAE;QACvD,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,OAAO,CAAC,QAAQ;QAC3C,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,SAAS,EAAE,MAAM,CAAC,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,KAAK,IAAI;KAC5D,CAAC,CAAC;IACH,MAAM,MAAM,GAAW;QACtB,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,UAAU,EAAE,OAAO,CAAC,UAAU;KAC9B,CAAC;IACF,MAAM,OAAO,GAAY;QACxB,MAAM;QACN,KAAK,EAAE,EAAE;QACT,UAAU,EAAE,EAAE;QACd,UAAU,EAAE,OAAO,CAAC,UAAU;KAC9B,CAAC;IACF,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC;AAChD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,GAAG,CAAC,MAAiB;IAC1C,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO;QAAE,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC;IACnD,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC;QACxC,CAAC,CAAC,MAAM,CAAC,IAAI;QACb,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC7B,MAAM,UAAU,GAAG,MAAM,CAAC,KAAK,CAAC,UAAU,IAAI,yBAAyB,CAAC;IACxE,qEAAqE;IACrE,iEAAiE;IACjE,iEAAiE;IACjE,qEAAqE;IACrE,sBAAsB;IACtB,MAAM,OAAO,GACZ,MAAM,CAAC,KAAK,CAAC,OAAO,IAAI,MAAM,CAAC,QAAQ,EAAE,OAAO,IAAI,qBAAqB,CAAC;IAC3E,MAAM,OAAO,GAAG;QACf,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO;YACvB,MAAM,CAAC,QAAQ,EAAE,OAAO;YACxB,qBAAqB,CAAC;KACvB,CAAC;IACF,OAAO,QAAQ,CACd;QACC,IAAI;QACJ,OAAO;QACP,OAAO;QACP,UAAU;QACV,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM;KAC3B,EACD,GAAG,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,CACrB,CAAC;AACH,CAAC;AAcD,iFAAiF;AACjF,KAAK,UAAU,eAAe,CAC7B,MAAiB,EACjB,IAAY;IAEZ,MAAM,KAAK,GACV,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC;QACtC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;QACrE,CAAC,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;IAE3C,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO,CAAC,MAAM,CAAC,KAAK,CACnB,oCAAoC,IAAI,2CAA2C,CACnF,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACd,CAAC;AAED;;;GAGG;AACH,SAAS,wBAAwB,CAAC,MAAiB,EAAE,IAAY;IAChE,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE,OAAO;QAAE,OAAO;IAE1C,0EAA0E;IAC1E,wBAAwB;IACxB,IAAI,MAAM,CAAC,QAAQ,EAAE,OAAO,KAAK,IAAI,EAAE,CAAC;QACvC,MAAM,IAAI,KAAK,CACd,6FAA6F,CAC7F,CAAC;IACH,CAAC;IAED,6EAA6E;IAC7E,uEAAuE;IACvE,kEAAkE;IAClE,sEAAsE;IACtE,qEAAqE;IACrE,gEAAgE;IAChE,kDAAkD;IAClD,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,GAAG;QAAE,OAAO;IACrC,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,IAAI,IAAI,IAAI,CAAC,CAAC;IAC5D,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;IACtD,MAAM,YAAY,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IACrD,MAAM,YAAY,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IACrD,MAAM,mBAAmB,GACxB,YAAY,KAAK,EAAE;QACnB,CAAC,YAAY,CAAC,UAAU,CAAC,IAAI,CAAC;QAC9B,CAAC,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;IAChC,MAAM,mBAAmB,GACxB,YAAY,KAAK,EAAE;QACnB,CAAC,YAAY,CAAC,UAAU,CAAC,IAAI,CAAC;QAC9B,CAAC,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;IAChC,MAAM,KAAK,GAAG,YAAY,KAAK,EAAE,CAAC;IAClC,IAAI,CAAC,KAAK,IAAI,CAAC,mBAAmB,IAAI,CAAC,mBAAmB,EAAE,CAAC;QAC5D,MAAM,IAAI,KAAK,CACd,qBAAqB,OAAO,wBAAwB,OAAO,kEAAkE,CAC7H,CAAC;IACH,CAAC;AACF,CAAC;AAED;;;;;GAKG;AACH,KAAK,UAAU,uBAAuB,CACrC,MAAiD,EACjD,IAAY,EACZ,OAAwB;IAExB,MAAM,GAAG,GAAoB,EAAE,kBAAkB,EAAE,KAAK,EAAE,CAAC;IAC3D,IAAI,CAAC;QACJ,MAAM,SAAS,GAAG,MAAM,gBAAgB,CAAC;YACxC,IAAI,EAAE,MAAM,CAAC,QAAQ,CAAC,IAAI,IAAI,IAAI;YAClC,OAAO;YACP,OAAO,EAAE,IAAI;YACb,OAAO,EAAE,MAAM,CAAC,QAAQ,CAAC,OAAO;YAChC,OAAO,EAAE,MAAM,CAAC,QAAQ,CAAC,OAAO;YAChC,SAAS,EAAE,MAAM,CAAC,QAAQ,CAAC,SAAS;YACpC,SAAS,EAAE,MAAM,CAAC,QAAQ,CAAC,SAAS;YACpC,UAAU,EAAE,MAAM,CAAC,QAAQ,CAAC,UAAU;SACtC,CAAC,CAAC;QACH,GAAG,CAAC,QAAQ,GAAG,SAAS,CAAC,OAAO,CAAC;QACjC,GAAG,CAAC,kBAAkB,GAAG,SAAS,CAAC,UAAU,CAAC;QAC9C,IAAI,SAAS,CAAC,UAAU;YAAE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;QACrE,IAAI,SAAS,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACrC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,gBAAgB,CAAC,SAAS,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;QACrE,CAAC;QAED,kEAAkE;QAClE,IAAI,MAAM,CAAC,YAAY,EAAE,OAAO,IAAI,GAAG,CAAC,QAAQ,EAAE,CAAC;YAClD,MAAM,mBAAmB,CAAC,MAAM,EAAE,IAAI,EAAE,GAAG,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;QAC5D,CAAC;IACF,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACd,wEAAwE;QACxE,yEAAyE;QACzE,0BAA0B;QAC1B,OAAO,CAAC,MAAM,CAAC,KAAK,CACnB,mBAAmB,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CACvE,CAAC;QACF,GAAG,CAAC,kBAAkB,GAAG,EAAE,CAAC;IAC7B,CAAC;IACD,OAAO,GAAG,CAAC;AACZ,CAAC;AAED,yEAAyE;AACzE,KAAK,UAAU,mBAAmB,CACjC,MAAiD,EACjD,IAAY,EACZ,QAAyB,EACzB,GAAoB;IAEpB,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE,OAAO;QAAE,OAAO;IAC1C,IAAI,CAAC;QACJ,MAAM,IAAI,GAAG,MAAM,YAAY,CAAC;YAC/B,OAAO,EAAE,IAAI;YACb,IAAI,EAAE,MAAM,CAAC,QAAQ,CAAC,IAAI,IAAI,IAAI;YAClC,QAAQ;YACR,IAAI,EAAE,MAAM,CAAC,YAAY,CAAC,IAAI;YAC9B,UAAU,EAAE,MAAM,CAAC,YAAY,CAAC,UAAU;YAC1C,SAAS,EAAE,MAAM,CAAC,YAAY,CAAC,SAAS,IAAI,MAAM,CAAC,QAAQ,CAAC,SAAS;YACrE,GAAG,EAAE,MAAM,CAAC,YAAY,CAAC,GAAG;SAC5B,CAAC,CAAC;QACH,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YAClB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,OAAO,IAAI,CAAC,CAAC;YAC1C,OAAO;QACR,CAAC;QACD,GAAG,CAAC,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC;QAChC,GAAG,CAAC,sBAAsB,GAAG,IAAI,CAAC,UAAU,CAAC;QAC7C,IAAI,IAAI,CAAC,UAAU;YAAE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC3D,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAChC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,oBAAoB,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;QACpE,CAAC;IACF,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACd,OAAO,CAAC,MAAM,CAAC,KAAK,CACnB,mBAAmB,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CACvE,CAAC;QACF,uEAAuE;QACvE,0EAA0E;QAC1E,GAAG,CAAC,kBAAkB,GAAG,IAAI,CAAC;IAC/B,CAAC;AACF,CAAC;AAED,KAAK,UAAU,OAAO,CAAC,MAAiB;IACvC,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC3B,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC;QACxC,CAAC,CAAC,MAAM,CAAC,IAAI;QACb,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAE7B,MAAM,KAAK,GAAG,MAAM,eAAe,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAElD,yEAAyE;IACzE,yEAAyE;IACzE,0EAA0E;IAC1E,0EAA0E;IAC1E,2CAA2C;IAC3C,IACC,CAAC,MAAM,CAAC,gBAAgB;QACxB,MAAM,CAAC,QAAQ,EAAE,OAAO,KAAK,IAAI;QACjC,MAAM,CAAC,YAAY,EAAE,OAAO,KAAK,IAAI,EACpC,CAAC;QACF,OAAO,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;IACvC,CAAC;IAED,MAAM,QAAQ,GACb,MAAM,CAAC,gBAAgB;QACvB,YAAY,CACX,MAAM,CAAC,QAAQ,EACf,MAAM,CAAC,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,KAAK,IAAI,CACjD,CAAC;IAEH,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,MAAM,CAAC;IAEnD,wBAAwB,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAEvC,wEAAwE;IACxE,oEAAoE;IACpE,MAAM,eAAe,GAAG,MAAM,CAAC,QAAQ,EAAE,OAAO,KAAK,IAAI,CAAC;IAC1D,MAAM,OAAO,GAAG,eAAe,CAAC,CAAC,CAAC,MAAM,WAAW,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IAElE,IAAI,CAAC;QACJ,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,OAAO,CACxC,KAAK,EACL;YACC,WAAW,EAAE,MAAM,CAAC,WAAW,IAAI,kBAAkB,EAAE;YACvD,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,OAAO;YACP,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,QAAQ,EAAE,OAAO,EAAE,GAAG;SACtB,EACD,QAAQ,CACR,CAAC;QAEF,MAAM,OAAO,GAAG,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC,CAAC;QACpE,QAAQ,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QAE5B,MAAM,GAAG,GACR,OAAO,IAAI,MAAM,CAAC,QAAQ;YACzB,CAAC,CAAC,MAAM,uBAAuB,CAC7B,EAAE,GAAG,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,EACxC,IAAI,EACJ,OAAO,CACP;YACF,CAAC,CAAC,EAAE,kBAAkB,EAAE,KAAK,EAAE,CAAC;QAElC,MAAM,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC;QACnC,MAAM,YAAY,GACjB,GAAG,CAAC,kBAAkB,IAAI,GAAG,CAAC,kBAAkB,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACrE,MAAM,gBAAgB,GACrB,CAAC,GAAG,CAAC,sBAAsB,IAAI,GAAG,CAAC,sBAAsB,CAAC,MAAM,GAAG,CAAC,CAAC;YACrE,GAAG,CAAC,kBAAkB;YACrB,CAAC,CAAC,CAAC;YACH,CAAC,CAAC,CAAC,CAAC;QACN,OAAO;YACN,OAAO;YACP,QAAQ,EAAE,GAAG,CAAC,QAAQ;YACtB,kBAAkB,EAAE,GAAG,CAAC,kBAAkB;YAC1C,YAAY,EAAE,GAAG,CAAC,YAAY;YAC9B,sBAAsB,EAAE,GAAG,CAAC,sBAAsB;YAClD,QAAQ,EAAE,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,YAAY,EAAE,gBAAgB,CAAC;SAC5D,CAAC;IACH,CAAC;YAAS,CAAC;QACV,uDAAuD;QACvD,kEAAkE;QAClE,oEAAoE;QACpE,sBAAsB;QACtB,IAAI,OAAO,EAAE,CAAC;YACb,MAAM,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,CAC/D,GAAG,EAAE,GAAE,CAAC,CACR,CAAC;QACH,CAAC;IACF,CAAC;AACF,CAAC"}

package/dist/cli/summary.d.ts

@@ -0,0 +1,18 @@
+import type { FileResult } from "../runtime/run.js";
+import type { WorkerErrorMessage } from "./pool.js";
+export interface Totals {
+    pass: number;
+    fail: number;
+    skip: number;
+    todo: number;
+    fileErrors: number;
+}
+export interface Summary {
+    totals: Totals;
+    files: FileResult[];
+    fileErrors: WorkerErrorMessage[];
+    durationMs: number;
+}
+export declare function buildSummary(files: FileResult[], fileErrors: WorkerErrorMessage[], durationMs: number): Summary;
+export declare function exitCode(summary: Summary): number;
+//# sourceMappingURL=summary.d.ts.map

package/dist/cli/summary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"summary.d.ts","sourceRoot":"","sources":["../../src/cli/summary.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAEpD,MAAM,WAAW,MAAM;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,OAAO;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,UAAU,EAAE,kBAAkB,EAAE,CAAC;IACjC,UAAU,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,YAAY,CAC3B,KAAK,EAAE,UAAU,EAAE,EACnB,UAAU,EAAE,kBAAkB,EAAE,EAChC,UAAU,EAAE,MAAM,GAChB,OAAO,CAeT;AAED,wBAAgB,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAEjD"}

package/dist/cli/summary.js

@@ -0,0 +1,20 @@
+export function buildSummary(files, fileErrors, durationMs) {
+    const totals = {
+        pass: 0,
+        fail: 0,
+        skip: 0,
+        todo: 0,
+        fileErrors: fileErrors.length,
+    };
+    for (const f of files) {
+        totals.pass += f.totals.pass;
+        totals.fail += f.totals.fail;
+        totals.skip += f.totals.skip;
+        totals.todo += f.totals.todo;
+    }
+    return { totals, files, fileErrors, durationMs };
+}
+export function exitCode(summary) {
+    return summary.totals.fail > 0 || summary.totals.fileErrors > 0 ? 1 : 0;
+}
+//# sourceMappingURL=summary.js.map

package/dist/cli/summary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"summary.js","sourceRoot":"","sources":["../../src/cli/summary.ts"],"names":[],"mappings":"AAkBA,MAAM,UAAU,YAAY,CAC3B,KAAmB,EACnB,UAAgC,EAChC,UAAkB;IAElB,MAAM,MAAM,GAAW;QACtB,IAAI,EAAE,CAAC;QACP,IAAI,EAAE,CAAC;QACP,IAAI,EAAE,CAAC;QACP,IAAI,EAAE,CAAC;QACP,UAAU,EAAE,UAAU,CAAC,MAAM;KAC7B,CAAC;IACF,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACvB,MAAM,CAAC,IAAI,IAAI,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC;QAC7B,MAAM,CAAC,IAAI,IAAI,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC;QAC7B,MAAM,CAAC,IAAI,IAAI,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC;QAC7B,MAAM,CAAC,IAAI,IAAI,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC;IAC9B,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,CAAC;AAClD,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,OAAgB;IACxC,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,GAAG,CAAC,IAAI,OAAO,CAAC,MAAM,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACzE,CAAC"}

package/dist/cli/watch/loop.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Watch-mode run loop: runs `runOnce` once on startup, installs the
+ * watcher, and re-invokes `runOnce` whenever a coalesced change burst
+ * fires. Re-runs are serialised — at most one queued follow-up while a
+ * run is in flight; further bursts during that window are dropped (the
+ * queued run will pick up the latest disk state).
+ *
+ * On SIGINT (or an aborted external `AbortSignal`), the loop closes
+ * the watcher, waits for any in-flight run, and resolves with the
+ * LAST `RunOutcome` (with `exitCode: 0`, since a failing run during
+ * interactive watch should not poison the exit status — failures
+ * already surface as test output).
+ */
+import type { RunOutcome } from "../run.js";
+export interface RunWatchOptions {
+    root: string;
+    include: string[];
+    exclude: string[];
+    debounceMs: number;
+    /** Optional external abort. When triggered, behaves like SIGINT.
+     *  Lets tests drive shutdown without `process.emit("SIGINT")` (which
+     *  collides with vitest's own signal handlers). */
+    signal?: AbortSignal;
+}
+export declare function runWatch(opts: RunWatchOptions, runOnce: () => Promise<RunOutcome>): Promise<RunOutcome>;
+//# sourceMappingURL=loop.d.ts.map

package/dist/cli/watch/loop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loop.d.ts","sourceRoot":"","sources":["../../../src/cli/watch/loop.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAG5C,MAAM,WAAW,eAAe;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB;;uDAEmD;IACnD,MAAM,CAAC,EAAE,WAAW,CAAC;CACrB;AAiBD,wBAAsB,QAAQ,CAC7B,IAAI,EAAE,eAAe,EACrB,OAAO,EAAE,MAAM,OAAO,CAAC,UAAU,CAAC,GAChC,OAAO,CAAC,UAAU,CAAC,CAgHrB"}