@descryy/runtime-test-runner 0.4.12 → 0.4.13

package/dist/quality/stream.js

@@ -0,0 +1,194 @@
+const OPEN_TO_CLOSE = { "(": ")", "[": "]", "{": "}" };
+const CLOSE_TO_OPEN = { ")": "(", "]": "[", "}": "{" };
+const TEXT_LIMIT = 240;
+export function buildStream(source, tokens) {
+    const toks = tokens.filter((token) => token.kind !== "comment");
+    const match = new Int32Array(toks.length).fill(-1);
+    const enclosingBrace = new Int32Array(toks.length).fill(-1);
+    const stack = [];
+    const braceStack = [];
+    const counts = { "(": 0, "[": 0, "{": 0 };
+    for (let index = 0; index < toks.length; index += 1) {
+        const token = toks[index];
+        enclosingBrace[index] = braceStack.length === 0 ? -1 : braceStack[braceStack.length - 1];
+        if (token.kind !== "punctuator")
+            continue;
+        const text = token.text;
+        if (OPEN_TO_CLOSE[text] !== undefined) {
+            stack.push(index);
+            counts[text] = counts[text] + 1;
+            if (text === "{")
+                braceStack.push(index);
+            continue;
+        }
+        const opener = CLOSE_TO_OPEN[text];
+        if (opener === undefined || counts[opener] === 0)
+            continue;
+        for (;;) {
+            const top = stack.pop();
+            const topText = toks[top].text;
+            counts[topText] = counts[topText] - 1;
+            if (topText === "{")
+                braceStack.pop();
+            if (topText === opener) {
+                match[top] = index;
+                match[index] = top;
+                break;
+            }
+        }
+        if (text === "}")
+            enclosingBrace[index] = braceStack.length === 0 ? -1 : braceStack[braceStack.length - 1];
+    }
+    return { source, toks, match, enclosingBrace };
+}
+export function isPunct(stream, index, text) {
+    const token = stream.toks[index];
+    return token !== undefined && token.kind === "punctuator" && token.text === text;
+}
+export function isIdent(stream, index, text) {
+    const token = stream.toks[index];
+    return token !== undefined && token.kind === "identifier" && (text === undefined || token.text === text);
+}
+export function textAt(stream, index) {
+    return stream.toks[index]?.text ?? "";
+}
+export function lineOf(stream, index) {
+    return stream.toks[index]?.line ?? 0;
+}
+export function endLineOf(token) {
+    if (token.kind !== "string" && token.kind !== "template")
+        return token.line;
+    let lines = 0;
+    for (let i = 0; i < token.text.length; i += 1)
+        if (token.text.charCodeAt(i) === 10)
+            lines += 1;
+    return token.line + lines;
+}
+export function textOf(stream, from, to, limit = TEXT_LIMIT) {
+    const first = stream.toks[from];
+    const last = stream.toks[to];
+    if (first === undefined || last === undefined || to < from)
+        return "";
+    const raw = stream.source.slice(first.start, last.end).replace(/\s+/g, " ").trim();
+    return raw.length <= limit ? raw : `${raw.slice(0, limit - 1)}…`;
+}
+export function splitTopLevel(stream, from, to, separator = ",") {
+    const parts = [];
+    let start = from;
+    let index = from;
+    while (index <= to) {
+        const token = stream.toks[index];
+        if (token.kind === "punctuator") {
+            if (OPEN_TO_CLOSE[token.text] !== undefined && stream.match[index] > index && stream.match[index] <= to) {
+                index = stream.match[index] + 1;
+                continue;
+            }
+            if (token.text === separator) {
+                if (index > start)
+                    parts.push([start, index - 1]);
+                start = index + 1;
+            }
+        }
+        index += 1;
+    }
+    if (start <= to)
+        parts.push([start, to]);
+    return parts;
+}
+export function argumentRanges(stream, open, close) {
+    if (open < 0 || close <= open + 1)
+        return [];
+    return splitTopLevel(stream, open + 1, close - 1);
+}
+export function stringValue(token) {
+    if (token === undefined)
+        return null;
+    if (token.kind === "template") {
+        const text = token.text;
+        if (text.length >= 2 && text.startsWith("`") && text.endsWith("`") && !text.includes("${"))
+            return text.slice(1, -1);
+        return null;
+    }
+    if (token.kind !== "string")
+        return null;
+    const text = token.text;
+    const open = text.search(/["'`]/);
+    if (open === -1)
+        return null;
+    const prefix = text.slice(0, open).toLowerCase();
+    const rest = text.slice(open);
+    const quote = rest[0];
+    const tripled = rest.length >= 6 && rest.startsWith(quote.repeat(3));
+    const width = tripled ? 3 : 1;
+    const closed = rest.length >= width * 2 && rest.endsWith(quote.repeat(width));
+    const inner = rest.slice(width, closed ? rest.length - width : rest.length);
+    if (prefix.includes("$") || prefix.includes("f")) {
+        if (inner.includes("{"))
+            return null;
+    }
+    if (quote === "`" || prefix.includes("r") || prefix.includes("@")) {
+        return prefix.includes("@") ? inner.replaceAll('""', '"') : inner;
+    }
+    return inner.replace(/\\(["'\\nrt])/g, (_whole, escaped) => (escaped === "n" ? "\n" : escaped === "r" ? "\r" : escaped === "t" ? "\t" : escaped));
+}
+export function numberValue(token) {
+    if (token === undefined || token.kind !== "number")
+        return null;
+    const cleaned = token.text.replace(/_/g, "");
+    const hex = /^0[xX]([0-9a-fA-F]+)[uUlL]*$/.exec(cleaned);
+    if (hex !== null)
+        return Number.parseInt(hex[1], 16);
+    const binary = /^0[bB]([01]+)[uUlL]*$/.exec(cleaned);
+    if (binary !== null)
+        return Number.parseInt(binary[1], 2);
+    const octal = /^0[oO]([0-7]+)$/.exec(cleaned);
+    if (octal !== null)
+        return Number.parseInt(octal[1], 8);
+    const decimal = /^(\d+\.?\d*(?:[eE][+-]?\d+)?|\.\d+(?:[eE][+-]?\d+)?)[fFdDmMlLuU]*$/.exec(cleaned);
+    if (decimal === null)
+        return null;
+    const value = Number(decimal[1]);
+    return Number.isFinite(value) ? value : null;
+}
+export function singleString(stream, range) {
+    if (range === undefined)
+        return null;
+    if (range[0] === range[1])
+        return stringValue(stream.toks[range[0]]);
+    return null;
+}
+export function firstStringIn(stream, range) {
+    if (range === undefined)
+        return null;
+    for (let index = range[0]; index <= range[1]; index += 1) {
+        const value = stringValue(stream.toks[index]);
+        if (value !== null)
+            return value;
+    }
+    return null;
+}
+export function findRangeStart(stream, startLine) {
+    let low = 0;
+    let high = stream.toks.length;
+    while (low < high) {
+        const middle = (low + high) >> 1;
+        if (stream.toks[middle].line < startLine)
+            low = middle + 1;
+        else
+            high = middle;
+    }
+    return low;
+}
+export function findRangeEnd(stream, endLine) {
+    let low = 0;
+    let high = stream.toks.length;
+    while (low < high) {
+        const middle = (low + high) >> 1;
+        if (stream.toks[middle].line <= endLine)
+            low = middle + 1;
+        else
+            high = middle;
+    }
+    return low - 1;
+}
+//# sourceMappingURL=stream.js.map

package/dist/quality/stream.js.map

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

package/dist/quality/types.d.ts

@@ -0,0 +1,88 @@
+export type AssertionStrength = "strong" | "weak" | "existence" | "snapshot";
+export type AssertionExpectation = {
+    readonly kind: "status";
+    readonly value: number;
+} | {
+    readonly kind: "throws";
+} | {
+    readonly kind: "value";
+} | {
+    readonly kind: "visible";
+} | {
+    readonly kind: "url";
+};
+export interface AssertionFact {
+    readonly line: number;
+    readonly strength: AssertionStrength;
+    readonly expects: AssertionExpectation | null;
+    readonly text: string;
+}
+export type MockKind = "module" | "function" | "timer" | "network";
+export interface MockFact {
+    readonly line: number;
+    readonly module: string | null;
+    readonly symbol: string | null;
+    readonly kind: MockKind;
+}
+export interface SleepFact {
+    readonly line: number;
+    readonly ms: number | null;
+}
+export interface SelectorFact {
+    readonly line: number;
+    readonly text: string;
+    readonly stability: "stable" | "unstable";
+}
+export interface SharedStateFact {
+    readonly line: number;
+    readonly name: string;
+}
+export interface HookFact {
+    readonly line: number;
+    readonly kind: "setup" | "teardown";
+    readonly scope: "each" | "all";
+}
+export interface HelperCallFact {
+    readonly line: number;
+    readonly name: string;
+}
+export interface TestSourceFacts {
+    readonly framework: string | null;
+    readonly assertions: readonly AssertionFact[];
+    readonly mocks: readonly MockFact[];
+    readonly sleeps: readonly SleepFact[];
+    readonly selectors: readonly SelectorFact[];
+    readonly sharedState: readonly SharedStateFact[];
+    readonly hooks: readonly HookFact[];
+    readonly helperCalls: readonly HelperCallFact[];
+    readonly skipped: boolean;
+    readonly focused: boolean;
+}
+export interface QualityRange {
+    readonly startLine: number;
+    readonly endLine: number;
+}
+export type FailureKind = "assertion" | "error" | "timeout" | "unknown";
+export interface FailureLocation {
+    readonly file: string;
+    readonly line: number;
+}
+export interface NormalisedFailure {
+    readonly kind: FailureKind;
+    readonly message: string;
+    readonly location: FailureLocation | null;
+}
+export interface Unsupported {
+    readonly unsupported: string;
+}
+export interface TestQualityCatalog {
+    readonly version: 1;
+    readonly frameworkNames: readonly string[];
+    frameworkOf(testFile: string, repoRoot: string): string | null;
+    isTestFile(path: string, repoRoot: string): boolean;
+    factsFor(source: string, range: QualityRange, framework: string | null): TestSourceFacts | Unsupported;
+    failureOf(error: unknown): NormalisedFailure;
+}
+export type QualityFramework = "node:test" | "jest" | "vitest" | "mocha" | "playwright" | "pytest" | "unittest" | "junit" | "go" | "xunit";
+export type QualityLanguage = "javascript" | "python" | "java" | "go" | "csharp";
+//# sourceMappingURL=types.d.ts.map

package/dist/quality/types.d.ts.map

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

package/dist/quality/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/quality/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/quality/types.ts"],"names":[],"mappings":""}

package/dist/run-timeout.d.ts

@@ -0,0 +1,25 @@
+import type { EmitFn } from "@descryy/runtime-contracts";
+import type { ManagedProcess } from "@descryy/runtime-controller";
+export declare const DEFAULT_TEST_RUN_TIMEOUT_MS: number;
+export declare const LARGEST_RUN_TIMEOUT_MS = 2147483647;
+export type RunTimeoutResolution = {
+    readonly ok: true;
+    readonly timeoutMs: number;
+} | {
+    readonly ok: false;
+    readonly reason: string;
+};
+export declare function resolveRunTimeout(timeoutMs: number | undefined): RunTimeoutResolution;
+export declare function runTimeoutReason(runner: string, timeoutMs: number): string;
+export interface RunTimeoutGuard {
+    readonly timedOut: () => boolean;
+    readonly cancel: () => void;
+}
+export declare function armRunTimeout(managed: ManagedProcess, details: {
+    readonly runner: string;
+    readonly timeoutMs: number;
+    readonly emit: EmitFn;
+    readonly service: string | null;
+    readonly processId: string;
+}): RunTimeoutGuard;
+//# sourceMappingURL=run-timeout.d.ts.map

package/dist/run-timeout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-timeout.d.ts","sourceRoot":"","sources":["../src/run-timeout.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAIlE,eAAO,MAAM,2BAA2B,QAAiB,CAAC;AAC1D,eAAO,MAAM,sBAAsB,aAAgB,CAAC;AAEpD,MAAM,MAAM,oBAAoB,GAAG;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAEvI,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,oBAAoB,CAcrF;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAK1E;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,QAAQ,EAAE,MAAM,OAAO,CAAC;IACjC,QAAQ,CAAC,MAAM,EAAE,MAAM,IAAI,CAAC;CAC7B;AAED,wBAAgB,aAAa,CAC3B,OAAO,EAAE,cAAc,EACvB,OAAO,EAAE;IAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GACnJ,eAAe,CA4BjB"}

package/dist/run-timeout.js

@@ -0,0 +1,52 @@
+import { COLLECTOR_VERSION } from "./collector-version.js";
+export const DEFAULT_TEST_RUN_TIMEOUT_MS = 30 * 60 * 1000;
+export const LARGEST_RUN_TIMEOUT_MS = 2_147_483_647;
+export function resolveRunTimeout(timeoutMs) {
+    if (timeoutMs === undefined)
+        return { ok: true, timeoutMs: DEFAULT_TEST_RUN_TIMEOUT_MS };
+    if (!Number.isSafeInteger(timeoutMs) || timeoutMs <= 0) {
+        return { ok: false, reason: `timeoutMs must be a positive whole number of milliseconds, got ${String(timeoutMs)}; nothing was run.` };
+    }
+    if (timeoutMs > LARGEST_RUN_TIMEOUT_MS) {
+        return {
+            ok: false,
+            reason: `timeoutMs must be at most ${String(LARGEST_RUN_TIMEOUT_MS)} ms (about 24.8 days; a larger delay makes the timer fire immediately), got ${String(timeoutMs)}; ` +
+                "nothing was run. Omit timeoutMs for the default, or pass the largest allowed value for the longest deadline.",
+        };
+    }
+    return { ok: true, timeoutMs };
+}
+export function runTimeoutReason(runner, timeoutMs) {
+    return (`the ${runner} run did not finish within ${String(timeoutMs)} ms and was stopped; ` +
+        "tests that had not reported a result by then were not observed, so the results reported for this run are incomplete.");
+}
+export function armRunTimeout(managed, details) {
+    let fired = false;
+    const timer = setTimeout(() => {
+        fired = true;
+        details.emit({
+            timestamp: new Date().toISOString(),
+            source: "test-runner",
+            service: details.service,
+            process: details.processId,
+            traceId: null,
+            requestId: null,
+            correlationId: null,
+            graphNodeId: null,
+            stackTrace: null,
+            confidence: 1,
+            redactionStatus: "pending-redaction",
+            collectorVersion: COLLECTOR_VERSION,
+            eventType: "COLLECTOR_ERROR",
+            payload: { collector: details.runner, reason: runTimeoutReason(details.runner, details.timeoutMs), timeoutMs: details.timeoutMs },
+            sourceLocation: null,
+        });
+        void managed.kill();
+    }, details.timeoutMs);
+    const cancel = () => {
+        clearTimeout(timer);
+    };
+    void managed.waitForExit().then(cancel);
+    return { timedOut: () => fired, cancel };
+}
+//# sourceMappingURL=run-timeout.js.map

package/dist/run-timeout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-timeout.js","sourceRoot":"","sources":["../src/run-timeout.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAE3D,MAAM,CAAC,MAAM,2BAA2B,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AAC1D,MAAM,CAAC,MAAM,sBAAsB,GAAG,aAAa,CAAC;AAIpD,MAAM,UAAU,iBAAiB,CAAC,SAA6B;IAC7D,IAAI,SAAS,KAAK,SAAS;QAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,2BAA2B,EAAE,CAAC;IACzF,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,SAAS,CAAC,IAAI,SAAS,IAAI,CAAC,EAAE,CAAC;QACvD,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,kEAAkE,MAAM,CAAC,SAAS,CAAC,oBAAoB,EAAE,CAAC;IACxI,CAAC;IACD,IAAI,SAAS,GAAG,sBAAsB,EAAE,CAAC;QACvC,OAAO;YACL,EAAE,EAAE,KAAK;YACT,MAAM,EACJ,6BAA6B,MAAM,CAAC,sBAAsB,CAAC,+EAA+E,MAAM,CAAC,SAAS,CAAC,IAAI;gBAC/J,8GAA8G;SACjH,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,MAAc,EAAE,SAAiB;IAChE,OAAO,CACL,OAAO,MAAM,8BAA8B,MAAM,CAAC,SAAS,CAAC,uBAAuB;QACnF,sHAAsH,CACvH,CAAC;AACJ,CAAC;AAOD,MAAM,UAAU,aAAa,CAC3B,OAAuB,EACvB,OAAoJ;IAEpJ,IAAI,KAAK,GAAG,KAAK,CAAC;IAClB,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;QAC5B,KAAK,GAAG,IAAI,CAAC;QACb,OAAO,CAAC,IAAI,CAAC;YACX,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,MAAM,EAAE,aAAa;YACrB,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,OAAO,EAAE,OAAO,CAAC,SAAS;YAC1B,OAAO,EAAE,IAAI;YACb,SAAS,EAAE,IAAI;YACf,aAAa,EAAE,IAAI;YACnB,WAAW,EAAE,IAAI;YACjB,UAAU,EAAE,IAAI;YAChB,UAAU,EAAE,CAAC;YACb,eAAe,EAAE,mBAAmB;YACpC,gBAAgB,EAAE,iBAAiB;YACnC,SAAS,EAAE,iBAAiB;YAC5B,OAAO,EAAE,EAAE,SAAS,EAAE,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,gBAAgB,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,SAAS,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE;YACjI,cAAc,EAAE,IAAI;SACrB,CAAC,CAAC;QACH,KAAK,OAAO,CAAC,IAAI,EAAE,CAAC;IACtB,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;IACtB,MAAM,MAAM,GAAG,GAAS,EAAE;QACxB,YAAY,CAAC,KAAK,CAAC,CAAC;IACtB,CAAC,CAAC;IACF,KAAK,OAAO,CAAC,WAAW,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACxC,OAAO,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC;AAC3C,CAAC"}

package/dist/runner-wrappers.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Runner wrappers -- the tools a project runs its tests through: `uv run pytest`,
+ * `poetry run pytest`, `npx vitest run`, `pnpm exec jest`.
+ *
+ * **Declared grammar, never a guess.** Each wrapper lists which of its own flags take a value,
+ * which take none, and which are refused (with why). The runner is the first token after the
+ * wrapper's own flags, so `uv run --with pytest python -m unittest` is not mistaken for pytest,
+ * and a flag the grammar does not know is refused by name rather than skipped past -- a wrong
+ * split would silently drop a flag the caller wrote.
+ *
+ * **Nothing is installed during a run.** A wrapper that would build, sync or download an
+ * environment is either run offline or refused with the command that prepares it. Where the
+ * environment lives outside the repository, `locateWrapperEnvironment` finds it (from files, or
+ * by the wrapper's own read-only query) so the sandbox can bind it read-only.
+ */
+export type WrapperEcosystem = "python" | "node";
+/** A wrapper as matched on one command: what to put in front of the runner when spawning it. */
+export interface WrapperMatch {
+    readonly name: string;
+    readonly ecosystem: WrapperEcosystem;
+    /** The wrapper binary exactly as the caller wrote it. */
+    readonly command: string;
+    /** The wrapper's own tokens, subcommand included, up to the runner. */
+    readonly args: readonly string[];
+    /** Written directly in front of the runner's own name when spawning (`test:` for `hatch run test:pytest`), else empty. */
+    readonly innerPrefix: string;
+    /** A project directory the caller passed to the wrapper (`poetry -C backend`, `uv run --project svc`), relative to cwd. */
+    readonly projectDir: string | null;
+    readonly downloads: boolean;
+}
+export type UnwrapResult = {
+    readonly kind: "none";
+} | {
+    readonly kind: "wrapped";
+    readonly wrapper: WrapperMatch;
+    readonly inner: {
+        readonly command: string;
+        readonly args: readonly string[];
+    };
+} | {
+    readonly kind: "refused";
+    readonly reason: string;
+};
+/**
+ * Splits a command into wrapper and runner, when it is a wrapper. Pure: reads nothing from disk.
+ * `none` for a command no wrapper grammar claims; `refused` for one it claims and cannot split.
+ */
+export declare function unwrapRunnerCommand(command: string, args: readonly string[]): UnwrapResult;
+/** The argv to spawn: the wrapper, its own tokens, then the runner with its (reporter-extended) args. */
+export declare function wrappedSpawnArgs(wrapper: WrapperMatch, runnerCommand: string, runnerArgs: readonly string[]): readonly string[];
+export type WrapperEnvironment = {
+    readonly ok: true;
+    /** Paths the run reads and must not change, outside the repository: bind them read-only. */
+    readonly readOnlyRoots: readonly string[];
+    /** Added to the child's environment: offline switches and a throwaway cache. */
+    readonly env: Readonly<Record<string, string>>;
+    /** What the run will not do that the wrapper normally would, said to the caller. */
+    readonly disclosures: readonly string[];
+    readonly cleanup?: () => void;
+} | {
+    readonly ok: false;
+    readonly reason: string;
+};
+/**
+ * Where a wrapper's environment lives, and how to run it without it changing: the read-only roots
+ * the sandbox binds, the offline switches, and what that means for the caller. Refuses -- with
+ * the command that fixes it -- when there is no environment yet, because creating one is an
+ * install, and a run never installs.
+ *
+ * `env` is what the child will run with; `runnerCommand` is the runner's own name, needed for the
+ * wrappers that would otherwise download it.
+ */
+export declare function locateWrapperEnvironment(wrapper: WrapperMatch, cwd: string, env: Readonly<Record<string, string | undefined>>, runnerCommand?: string): WrapperEnvironment;
+//# sourceMappingURL=runner-wrappers.d.ts.map

package/dist/runner-wrappers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner-wrappers.d.ts","sourceRoot":"","sources":["../src/runner-wrappers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAWH,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,MAAM,CAAC;AA0JjD,gGAAgG;AAChG,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,gBAAgB,CAAC;IACrC,yDAAyD;IACzD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,uEAAuE;IACvE,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,0HAA0H;IAC1H,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,2HAA2H;IAC3H,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;CAC7B;AAED,MAAM,MAAM,YAAY,GACpB;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACzB;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE;QAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAA;KAAE,CAAA;CAAE,GAC5I;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAqD1D;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,YAAY,CA2D1F;AAWD,yGAAyG;AACzG,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,MAAM,EAAE,CAE/H;AAID,MAAM,MAAM,kBAAkB,GAC1B;IACE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAClB,4FAA4F;IAC5F,QAAQ,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1C,gFAAgF;IAChF,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAC/C,oFAAoF;IACpF,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;CAC/B,GACD;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAwMpD;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,YAAY,EACrB,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,EACjD,aAAa,CAAC,EAAE,MAAM,GACrB,kBAAkB,CA6GpB"}