paperlint 2.0.0

package/dist/adapters/memory/index.d.ts

@@ -0,0 +1,43 @@
+import type { Download } from "../../ports/download.ts";
+import type { Files } from "../../ports/files.ts";
+import type { Command, ProcessExit, RunProcess } from "../../ports/process.ts";
+import type { Workspace } from "../../ports/workspace.ts";
+export interface ScriptedProcess extends RunProcess {
+    readonly calls: Command[];
+}
+/** A `RunProcess` that answers every `Command` with `script(c)` and records it. */
+export declare function scriptedProcess(script: (c: Command) => ProcessExit): ScriptedProcess;
+/** A process that exits 0 and prints `stdout`. */
+export declare const exitedWith: (stdout: string, status?: number) => ProcessExit;
+export interface MemoryFiles extends Files {
+    readonly map: Map<string, Uint8Array>;
+}
+export declare function memoryFiles(initial?: Readonly<Record<string, string | Uint8Array>>): MemoryFiles;
+export interface MemoryWorkspace extends Workspace {
+    /** Every file written into a scratch directory, in order. */
+    readonly written: {
+        readonly name: string;
+        readonly content: string;
+        readonly mode: "read" | "exec";
+    }[];
+    /** How each `within` ended. */
+    readonly ended: ("returned" | "threw")[];
+}
+export declare function memoryWorkspace(dir?: string): MemoryWorkspace;
+export interface FixedDownload extends Download {
+    readonly urls: string[];
+}
+/** A `Download` that returns `body` for every URL, or fails with `detail` when `body` is a failure. */
+export declare function fixedDownload(body: string | Uint8Array | {
+    readonly detail: string;
+}): FixedDownload;
+/** Every generic port at once — what a test hands an adapter built over several of them. */
+export interface MemoryPorts {
+    readonly run: RunProcess;
+    readonly files: Files;
+    readonly workspace: Workspace;
+    readonly download: Download;
+}
+/** All four ports from in-memory parts; any part can be replaced. */
+export declare function memoryPorts(over?: Partial<MemoryPorts>): MemoryPorts;
+//# sourceMappingURL=index.d.ts.map

package/dist/adapters/memory/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/adapters/memory/index.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAC/E,OAAO,KAAK,EAAwB,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAGhF,MAAM,WAAW,eAAgB,SAAQ,UAAU;IACjD,QAAQ,CAAC,KAAK,EAAE,OAAO,EAAE,CAAC;CAC3B;AAED,mFAAmF;AACnF,wBAAgB,eAAe,CAC7B,MAAM,EAAE,CAAC,CAAC,EAAE,OAAO,KAAK,WAAW,GAClC,eAAe,CASjB;AAED,kDAAkD;AAClD,eAAO,MAAM,UAAU,GAAI,QAAQ,MAAM,EAAE,eAAU,KAAG,WAKtD,CAAC;AAEH,MAAM,WAAW,WAAY,SAAQ,KAAK;IACxC,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;CACvC;AAED,wBAAgB,WAAW,CACzB,OAAO,GAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,CAAC,CAAM,GAC1D,WAAW,CAYb;AAED,MAAM,WAAW,eAAgB,SAAQ,SAAS;IAChD,6DAA6D;IAC7D,QAAQ,CAAC,OAAO,EAAE;QAChB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;KAChC,EAAE,CAAC;IACJ,+BAA+B;IAC/B,QAAQ,CAAC,KAAK,EAAE,CAAC,UAAU,GAAG,OAAO,CAAC,EAAE,CAAC;CAC1C;AAED,wBAAgB,eAAe,CAAC,GAAG,SAAa,GAAG,eAAe,CAwBjE;AAED,MAAM,WAAW,aAAc,SAAQ,QAAQ;IAC7C,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,uGAAuG;AACvG,wBAAgB,aAAa,CAC3B,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG;IAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACtD,aAAa,CAUf;AAED,4FAA4F;AAC5F,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,GAAG,EAAE,UAAU,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;CAC7B;AAED,qEAAqE;AACrE,wBAAgB,WAAW,CAAC,IAAI,GAAE,OAAO,CAAC,WAAW,CAAM,GAAG,WAAW,CAQxE"}

package/dist/adapters/memory/index.js

@@ -0,0 +1,79 @@
+import { err, ok } from "../../domain/result.js";
+/** A `RunProcess` that answers every `Command` with `script(c)` and records it. */
+export function scriptedProcess(script) {
+    const calls = [];
+    return {
+        calls,
+        run(c) {
+            calls.push(c);
+            return script(c);
+        },
+    };
+}
+/** A process that exits 0 and prints `stdout`. */
+export const exitedWith = (stdout, status = 0) => ({
+    kind: "exited",
+    status,
+    stdout,
+    stderr: "",
+});
+export function memoryFiles(initial = {}) {
+    const bytes = (v) => typeof v === "string" ? new TextEncoder().encode(v) : v;
+    const map = new Map(Object.entries(initial).map(([k, v]) => [k, bytes(v)]));
+    return {
+        map,
+        isFile: (p) => map.has(p),
+        readBytes: (p) => map.get(p) ?? null,
+        writeAtomic: (p, b) => void map.set(p, b),
+    };
+}
+export function memoryWorkspace(dir = "/scratch") {
+    const written = [];
+    const ended = [];
+    const scratch = {
+        dir: dir,
+        write(name, content, mode) {
+            written.push({ name, content, mode });
+            return `${dir}/${name}`;
+        },
+    };
+    return {
+        written,
+        ended,
+        within(_prefix, use) {
+            try {
+                const r = use(scratch);
+                ended.push("returned");
+                return r;
+            }
+            catch (e) {
+                ended.push("threw");
+                throw e;
+            }
+        },
+    };
+}
+/** A `Download` that returns `body` for every URL, or fails with `detail` when `body` is a failure. */
+export function fixedDownload(body) {
+    const urls = [];
+    return {
+        urls,
+        fetch(url) {
+            urls.push(url);
+            if (typeof body === "string")
+                return ok(new TextEncoder().encode(body));
+            return body instanceof Uint8Array ? ok(body) : err(body);
+        },
+    };
+}
+/** All four ports from in-memory parts; any part can be replaced. */
+export function memoryPorts(over = {}) {
+    return {
+        run: scriptedProcess(() => exitedWith("")),
+        files: memoryFiles(),
+        workspace: memoryWorkspace(),
+        download: fixedDownload({ detail: "no network in memory" }),
+        ...over,
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/adapters/memory/index.js.map

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

package/dist/adapters/node/files.io.d.ts

@@ -0,0 +1,3 @@
+import type { Files } from "../../ports/files.ts";
+export declare const nodeFiles: Files;
+//# sourceMappingURL=files.io.d.ts.map

package/dist/adapters/node/files.io.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.io.d.ts","sourceRoot":"","sources":["../../../src/adapters/node/files.io.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAKlD,eAAO,MAAM,SAAS,EAAE,KAsBvB,CAAC"}

package/dist/adapters/node/files.io.js

@@ -0,0 +1,31 @@
+/** `Files` over `node:fs`. */
+import { mkdirSync, readFileSync, renameSync, rmSync, statSync, writeFileSync, } from "node:fs";
+import { dirname } from "node:path";
+const code = (e) => e instanceof Error ? e.code : undefined;
+export const nodeFiles = {
+    isFile(p) {
+        return statSync(p, { throwIfNoEntry: false })?.isFile() ?? false;
+    },
+    readBytes(p) {
+        try {
+            return readFileSync(p);
+        }
+        catch (e) {
+            if (code(e) === "ENOENT")
+                return null;
+            throw e;
+        }
+    },
+    writeAtomic(p, bytes) {
+        const part = `${p}.part`;
+        mkdirSync(dirname(p), { recursive: true });
+        try {
+            writeFileSync(part, bytes);
+            renameSync(part, p);
+        }
+        finally {
+            rmSync(part, { force: true });
+        }
+    },
+};
+//# sourceMappingURL=files.io.js.map

package/dist/adapters/node/files.io.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.io.js","sourceRoot":"","sources":["../../../src/adapters/node/files.io.ts"],"names":[],"mappings":"AAAA,8BAA8B;AAC9B,OAAO,EACL,SAAS,EACT,YAAY,EACZ,UAAU,EACV,MAAM,EACN,QAAQ,EACR,aAAa,GACd,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,MAAM,IAAI,GAAG,CAAC,CAAU,EAAW,EAAE,CACnC,CAAC,YAAY,KAAK,CAAC,CAAC,CAAE,CAA2B,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;AAErE,MAAM,CAAC,MAAM,SAAS,GAAU;IAC9B,MAAM,CAAC,CAAe;QACpB,OAAO,QAAQ,CAAC,CAAC,EAAE,EAAE,cAAc,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,KAAK,CAAC;IACnE,CAAC;IACD,SAAS,CAAC,CAAe;QACvB,IAAI,CAAC;YACH,OAAO,YAAY,CAAC,CAAC,CAAC,CAAC;QACzB,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,QAAQ;gBAAE,OAAO,IAAI,CAAC;YACtC,MAAM,CAAC,CAAC;QACV,CAAC;IACH,CAAC;IACD,WAAW,CAAC,CAAe,EAAE,KAAiB;QAC5C,MAAM,IAAI,GAAG,GAAG,CAAC,OAAO,CAAC;QACzB,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC3C,IAAI,CAAC;YACH,aAAa,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;YAC3B,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;QACtB,CAAC;gBAAS,CAAC;YACT,MAAM,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAChC,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/adapters/node/host.io.d.ts

@@ -0,0 +1,3 @@
+import type { HostDirs } from "../../domain/host.ts";
+export declare const hostDirs: (over?: Partial<HostDirs>) => HostDirs;
+//# sourceMappingURL=host.io.d.ts.map

package/dist/adapters/node/host.io.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host.io.d.ts","sourceRoot":"","sources":["../../../src/adapters/node/host.io.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAErD,eAAO,MAAM,QAAQ,GAAI,OAAM,OAAO,CAAC,QAAQ,CAAM,KAAG,QAKtD,CAAC"}

package/dist/adapters/node/host.io.js

@@ -0,0 +1,14 @@
+/**
+ * What the host knows and the environment does not say — the home, the temp directory, the cwd —
+ * read once. A composition root calls this and passes the value in; nothing below it reads the host
+ * again. Which of these a tool cares about, and what it derives from them, is that tool's adapter's
+ * business (banal's: `adapters/banal/settings.ts`).
+ */
+import { homedir, tmpdir } from "node:os";
+export const hostDirs = (over = {}) => ({
+    home: homedir(),
+    tmp: tmpdir(),
+    cwd: process.cwd(),
+    ...over,
+});
+//# sourceMappingURL=host.io.js.map

package/dist/adapters/node/host.io.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"host.io.js","sourceRoot":"","sources":["../../../src/adapters/node/host.io.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAG1C,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,OAA0B,EAAE,EAAY,EAAE,CAAC,CAAC;IACnE,IAAI,EAAE,OAAO,EAAE;IACf,GAAG,EAAE,MAAM,EAAE;IACb,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE;IAClB,GAAG,IAAI;CACR,CAAC,CAAC"}

package/dist/adapters/node/index.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Node's implementations of the generic ports: processes, files, scratch directories. What a
+ * composition root builds and hands to the adapters that need them (banal's, for one).
+ */
+import type { Files } from "../../ports/files.ts";
+import type { RunProcess } from "../../ports/process.ts";
+import type { Workspace } from "../../ports/workspace.ts";
+import { type SpawnSync } from "./process.io.ts";
+export interface NodeAdapterOptions {
+    /** Scratch directories go here. */
+    readonly tmpDir: string;
+    /** `spawnSync` or a stand-in with its shape. */
+    readonly spawn?: SpawnSync;
+}
+/** The node ports, built once at the root. */
+export interface NodePorts {
+    readonly run: RunProcess;
+    readonly files: Files;
+    readonly workspace: Workspace;
+}
+export declare function nodeAdapters(o: NodeAdapterOptions): NodePorts;
+export { nodeFiles } from "./files.io.ts";
+export { spawnProcess, type SpawnSync } from "./process.io.ts";
+export { hostDirs } from "./host.io.ts";
+//# sourceMappingURL=index.d.ts.map

package/dist/adapters/node/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/adapters/node/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAE1D,OAAO,EAAgB,KAAK,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAG/D,MAAM,WAAW,kBAAkB;IACjC,mCAAmC;IACnC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,gDAAgD;IAChD,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,CAAC;CAC5B;AAED,8CAA8C;AAC9C,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,GAAG,EAAE,UAAU,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;CAC/B;AAED,wBAAgB,YAAY,CAAC,CAAC,EAAE,kBAAkB,GAAG,SAAS,CAM7D;AAED,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,KAAK,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC/D,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC"}

package/dist/adapters/node/index.js

@@ -0,0 +1,14 @@
+import { nodeFiles } from "./files.io.js";
+import { spawnProcess } from "./process.io.js";
+import { tmpWorkspace } from "./workspace.io.js";
+export function nodeAdapters(o) {
+    return {
+        run: spawnProcess(o.spawn),
+        files: nodeFiles,
+        workspace: tmpWorkspace(o.tmpDir),
+    };
+}
+export { nodeFiles } from "./files.io.js";
+export { spawnProcess } from "./process.io.js";
+export { hostDirs } from "./host.io.js";
+//# sourceMappingURL=index.js.map

package/dist/adapters/node/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/adapters/node/index.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAkB,MAAM,iBAAiB,CAAC;AAC/D,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAgBjD,MAAM,UAAU,YAAY,CAAC,CAAqB;IAChD,OAAO;QACL,GAAG,EAAE,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC;QAC1B,KAAK,EAAE,SAAS;QAChB,SAAS,EAAE,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC;KAClC,CAAC;AACJ,CAAC;AAED,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAkB,MAAM,iBAAiB,CAAC;AAC/D,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC"}

package/dist/adapters/node/process.io.d.ts

@@ -0,0 +1,14 @@
+/**
+ * `RunProcess` over Node's `spawnSync`. The one place that reads a child's result as Node reports
+ * it — `error`, `status`, `signal`, all nullable — and turns it into a `ProcessExit`, so no caller
+ * re-derives "what happened" from three fields.
+ */
+import { spawnSync, type SpawnSyncReturns } from "node:child_process";
+import type { Command, ProcessExit, RunProcess } from "../../ports/process.ts";
+/** Node's `spawnSync`, or a stand-in with its shape (a harness records the calls through one). */
+export type SpawnSync = typeof spawnSync;
+/** What a finished `spawnSync` came to. ENOENT is the executable itself: `c.file` was not found. */
+export declare function exitOf(r: SpawnSyncReturns<string>, c: Command): ProcessExit;
+/** A `RunProcess` that runs every `Command` with `spawn` (Node's `spawnSync` by default). */
+export declare function spawnProcess(spawn?: SpawnSync): RunProcess;
+//# sourceMappingURL=process.io.d.ts.map

package/dist/adapters/node/process.io.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process.io.d.ts","sourceRoot":"","sources":["../../../src/adapters/node/process.io.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EACL,SAAS,EAET,KAAK,gBAAgB,EACtB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAE/E,kGAAkG;AAClG,MAAM,MAAM,SAAS,GAAG,OAAO,SAAS,CAAC;AAKzC,oGAAoG;AACpG,wBAAgB,MAAM,CAAC,CAAC,EAAE,gBAAgB,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,OAAO,GAAG,WAAW,CAY3E;AAED,6FAA6F;AAC7F,wBAAgB,YAAY,CAAC,KAAK,GAAE,SAAqB,GAAG,UAAU,CAcrE"}

package/dist/adapters/node/process.io.js

@@ -0,0 +1,41 @@
+/**
+ * `RunProcess` over Node's `spawnSync`. The one place that reads a child's result as Node reports
+ * it — `error`, `status`, `signal`, all nullable — and turns it into a `ProcessExit`, so no caller
+ * re-derives "what happened" from three fields.
+ */
+import { spawnSync, } from "node:child_process";
+const errno = (r) => r.error?.code;
+/** What a finished `spawnSync` came to. ENOENT is the executable itself: `c.file` was not found. */
+export function exitOf(r, c) {
+    const out = {
+        stdout: String(r.stdout ?? ""),
+        stderr: String(r.stderr ?? ""),
+    };
+    const code = errno(r);
+    if (code === "ENOENT")
+        return { kind: "not-found", file: c.file };
+    if (code === "ETIMEDOUT")
+        return { kind: "timed-out", afterMs: c.timeoutMs, ...out };
+    if (r.error)
+        return { kind: "spawn-failed", message: r.error.message };
+    if (r.signal)
+        return { kind: "signalled", signal: r.signal, ...out };
+    return { kind: "exited", status: r.status ?? 1, ...out };
+}
+/** A `RunProcess` that runs every `Command` with `spawn` (Node's `spawnSync` by default). */
+export function spawnProcess(spawn = spawnSync) {
+    return {
+        run(c) {
+            const opts = {
+                encoding: "utf8",
+                env: { ...c.env },
+                stdio: ["ignore", "pipe", "pipe"],
+                timeout: c.timeoutMs,
+                ...(c.maxOutputBytes ? { maxBuffer: c.maxOutputBytes } : {}),
+                ...(c.cwd ? { cwd: c.cwd } : {}),
+            };
+            return exitOf(spawn(c.file, [...c.args], opts), c);
+        },
+    };
+}
+//# sourceMappingURL=process.io.js.map

package/dist/adapters/node/process.io.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"process.io.js","sourceRoot":"","sources":["../../../src/adapters/node/process.io.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EACL,SAAS,GAGV,MAAM,oBAAoB,CAAC;AAM5B,MAAM,KAAK,GAAG,CAAC,CAA2B,EAAsB,EAAE,CAC/D,CAAC,CAAC,KAA2C,EAAE,IAAI,CAAC;AAEvD,oGAAoG;AACpG,MAAM,UAAU,MAAM,CAAC,CAA2B,EAAE,CAAU;IAC5D,MAAM,GAAG,GAAG;QACV,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,MAAM,IAAI,EAAE,CAAC;QAC9B,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,MAAM,IAAI,EAAE,CAAC;KAC/B,CAAC;IACF,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IACtB,IAAI,IAAI,KAAK,QAAQ;QAAE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAClE,IAAI,IAAI,KAAK,WAAW;QACtB,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC,CAAC,SAAS,EAAE,GAAG,GAAG,EAAE,CAAC;IAC7D,IAAI,CAAC,CAAC,KAAK;QAAE,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;IACvE,IAAI,CAAC,CAAC,MAAM;QAAE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,GAAG,GAAG,EAAE,CAAC;IACrE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,IAAI,CAAC,EAAE,GAAG,GAAG,EAAE,CAAC;AAC3D,CAAC;AAED,6FAA6F;AAC7F,MAAM,UAAU,YAAY,CAAC,QAAmB,SAAS;IACvD,OAAO;QACL,GAAG,CAAC,CAAU;YACZ,MAAM,IAAI,GAAuC;gBAC/C,QAAQ,EAAE,MAAM;gBAChB,GAAG,EAAE,EAAE,GAAG,CAAC,CAAC,GAAG,EAAE;gBACjB,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC;gBACjC,OAAO,EAAE,CAAC,CAAC,SAAS;gBACpB,GAAG,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC5D,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACjC,CAAC;YACF,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;QACrD,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/adapters/node/workspace.io.d.ts

@@ -0,0 +1,4 @@
+import type { Workspace } from "../../ports/workspace.ts";
+/** Scratch directories under `tmpDir`. */
+export declare function tmpWorkspace(tmpDir: string): Workspace;
+//# sourceMappingURL=workspace.io.d.ts.map

package/dist/adapters/node/workspace.io.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace.io.d.ts","sourceRoot":"","sources":["../../../src/adapters/node/workspace.io.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAwB,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAchF,0CAA0C;AAC1C,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAWtD"}

package/dist/adapters/node/workspace.io.js

@@ -0,0 +1,33 @@
+/**
+ * `Workspace` over a temporary directory: `mkdtemp` + `realpath` (macOS's `/var` is a symlink to
+ * `/private/var`, and a path through it is not the one a child process reports) + `rm` in `finally`.
+ */
+import { chmodSync, mkdtempSync, realpathSync, rmSync, writeFileSync, } from "node:fs";
+import { join } from "node:path";
+function scratchIn(dir) {
+    return {
+        dir,
+        write(name, content, mode) {
+            const at = join(dir, name);
+            writeFileSync(at, content);
+            if (mode === "exec")
+                chmodSync(at, 0o755);
+            return at;
+        },
+    };
+}
+/** Scratch directories under `tmpDir`. */
+export function tmpWorkspace(tmpDir) {
+    return {
+        within(prefix, use) {
+            const dir = realpathSync(mkdtempSync(join(tmpDir, prefix)));
+            try {
+                return use(scratchIn(dir));
+            }
+            finally {
+                rmSync(dir, { recursive: true, force: true });
+            }
+        },
+    };
+}
+//# sourceMappingURL=workspace.io.js.map

package/dist/adapters/node/workspace.io.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace.io.js","sourceRoot":"","sources":["../../../src/adapters/node/workspace.io.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EACL,SAAS,EACT,WAAW,EACX,YAAY,EACZ,MAAM,EACN,aAAa,GACd,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAIjC,SAAS,SAAS,CAAC,GAAiB;IAClC,OAAO;QACL,GAAG;QACH,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI;YACvB,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,IAAI,CAAiB,CAAC;YAC3C,aAAa,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;YAC3B,IAAI,IAAI,KAAK,MAAM;gBAAE,SAAS,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;YAC1C,OAAO,EAAE,CAAC;QACZ,CAAC;KACF,CAAC;AACJ,CAAC;AAED,0CAA0C;AAC1C,MAAM,UAAU,YAAY,CAAC,MAAc;IACzC,OAAO;QACL,MAAM,CAAI,MAAc,EAAE,GAAmC;YAC3D,MAAM,GAAG,GAAG,YAAY,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;YAC5D,IAAI,CAAC;gBACH,OAAO,GAAG,CAAC,SAAS,CAAC,GAAmB,CAAC,CAAC,CAAC;YAC7C,CAAC;oBAAS,CAAC;gBACT,MAAM,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;YAChD,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/adapters/pdfjs/fill.d.ts

@@ -0,0 +1,42 @@
+/**
+ * pdf.js's half of the page layout — PURE. pdf.js's text content carries no colour and no
+ * orientation flag, so two facts about each text item are recovered from what pdf.js exports:
+ * whether its transform draws it upright, and which fill its characters were drawn with (walked
+ * from the operator list). `pdf-facts.ts` reads the PDF and calls these; the result is the domain's
+ * `PageLayout` (`domain/page-layout.ts`). Split out of the banal XML writer (#75): this is what
+ * would change if pdf.js did — not banal.
+ */
+import type { Fill } from "../../domain/page-layout.ts";
+/** A transform `[a, b, c, d, e, f]` that draws text upright: no rotation and no skew. */
+export declare function isUpright(m: readonly number[]): boolean;
+/** The operator codes the colour walk reads — pdf.js's `OPS`, reduced to what is used. */
+export interface ColourOps {
+    readonly save: number;
+    readonly restore: number;
+    readonly setFillRGBColor: number;
+    readonly setTextRenderingMode: number;
+    readonly showText: number;
+    readonly showSpacedText: number;
+}
+/** pdf.js's operator list: parallel arrays of operator codes and their arguments. */
+export interface OperatorList {
+    readonly fnArray: readonly number[];
+    readonly argsArray: readonly unknown[];
+}
+/** `setFillRGBColor`'s argument: a `#rrggbb` string in current pdf.js, three 0-255 numbers in older ones. */
+export declare function hexOf(args: unknown): string;
+/** Every drawn character, in content order, with the fill it was drawn in. */
+export declare function drawnCharacters(ops: ColourOps, list: OperatorList): {
+    chars: string[];
+    fills: Fill[];
+};
+/** How far ahead the walk looks for an item it cannot find where it expects it. */
+export declare const LOOKAHEAD = 4000;
+/**
+ * The fill of each text item. pdf.js's text content carries no colour, so the operator list is
+ * walked for the characters each show-text operator draws, and the items — in the same content
+ * order — are matched against them. An item that cannot be matched gets `unknown` (drawn as black):
+ * a missed match can keep light text, never drop dark text.
+ */
+export declare function fillsOf(ops: ColourOps, list: OperatorList, items: readonly string[]): Fill[];
+//# sourceMappingURL=fill.d.ts.map

package/dist/adapters/pdfjs/fill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fill.d.ts","sourceRoot":"","sources":["../../../src/adapters/pdfjs/fill.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,6BAA6B,CAAC;AAExD,yFAAyF;AACzF,wBAAgB,SAAS,CAAC,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAGvD;AAED,0FAA0F;AAC1F,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAC;IACtC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AAED,qFAAqF;AACrF,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,SAAS,EAAE,SAAS,OAAO,EAAE,CAAC;CACxC;AAKD,6GAA6G;AAC7G,wBAAgB,KAAK,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAQ3C;AAuCD,8EAA8E;AAC9E,wBAAgB,eAAe,CAC7B,GAAG,EAAE,SAAS,EACd,IAAI,EAAE,YAAY,GACjB;IAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IAAC,KAAK,EAAE,IAAI,EAAE,CAAA;CAAE,CAepC;AAED,mFAAmF;AACnF,eAAO,MAAM,SAAS,OAAO,CAAC;AAc9B;;;;;GAKG;AACH,wBAAgB,OAAO,CACrB,GAAG,EAAE,SAAS,EACd,IAAI,EAAE,YAAY,EAClB,KAAK,EAAE,SAAS,MAAM,EAAE,GACvB,IAAI,EAAE,CAWR"}

package/dist/adapters/pdfjs/fill.js

@@ -0,0 +1,91 @@
+/** A transform `[a, b, c, d, e, f]` that draws text upright: no rotation and no skew. */
+export function isUpright(m) {
+    const eps = 1e-6;
+    return Math.abs(m[1] ?? 0) < eps && Math.abs(m[2] ?? 0) < eps;
+}
+/** Text as the walk compares it: normalised, with no whitespace (items and glyphs split spaces differently). */
+const squeeze = (s) => s.normalize("NFKC").replace(/\s+/g, "");
+/** `setFillRGBColor`'s argument: a `#rrggbb` string in current pdf.js, three 0-255 numbers in older ones. */
+export function hexOf(args) {
+    const a = Array.isArray(args) ? args : [];
+    if (typeof a[0] === "string")
+        return a[0].toLowerCase();
+    const byte = (v) => Math.round(typeof v === "number" ? v : 0)
+        .toString(16)
+        .padStart(2, "0");
+    return `#${byte(a[0])}${byte(a[1])}${byte(a[2])}`;
+}
+/** The characters a show-text operator draws, from its glyph objects. */
+function glyphText(args) {
+    const a = Array.isArray(args) ? args : [];
+    const glyphs = Array.isArray(a[0]) ? a[0] : [];
+    return glyphs
+        .map((g) => typeof g === "object" && g !== null && "unicode" in g
+        ? String(g.unicode ?? "")
+        : "")
+        .join("");
+}
+/** Apply one state operator; false when `fn` is not one. */
+function applyState(ops, fn, args, s) {
+    if (fn === ops.save)
+        s.stack.push({ ...s.cur });
+    else if (fn === ops.restore)
+        s.cur = s.stack.pop() ?? { fill: { kind: "unknown" }, mode: 0 };
+    else if (fn === ops.setFillRGBColor)
+        s.cur.fill = { kind: "rgb", hex: hexOf(args) };
+    else if (fn === ops.setTextRenderingMode)
+        s.cur.mode = Number(args?.[0] ?? 0);
+    else
+        return false;
+    return true;
+}
+/** Every drawn character, in content order, with the fill it was drawn in. */
+export function drawnCharacters(ops, list) {
+    const s = { cur: { fill: { kind: "unknown" }, mode: 0 }, stack: [] };
+    const chars = [];
+    const fills = [];
+    list.fnArray.forEach((fn, i) => {
+        const args = list.argsArray[i];
+        if (applyState(ops, fn, args, s))
+            return;
+        if (fn !== ops.showText && fn !== ops.showSpacedText)
+            return;
+        const fill = s.cur.mode === 3 ? { kind: "invisible" } : s.cur.fill;
+        for (const ch of squeeze(glyphText(args))) {
+            chars.push(ch);
+            fills.push(fill);
+        }
+    });
+    return { chars, fills };
+}
+/** How far ahead the walk looks for an item it cannot find where it expects it. */
+export const LOOKAHEAD = 4000;
+/** The position at or after `from` where `want` starts in `chars`, or -1 within the look-ahead. */
+function findRun(chars, want, from) {
+    const limit = Math.min(chars.length, from + LOOKAHEAD);
+    for (let q = from; q < limit; q++)
+        if (want.every((ch, k) => chars[q + k] === ch))
+            return q;
+    return -1;
+}
+/**
+ * The fill of each text item. pdf.js's text content carries no colour, so the operator list is
+ * walked for the characters each show-text operator draws, and the items — in the same content
+ * order — are matched against them. An item that cannot be matched gets `unknown` (drawn as black):
+ * a missed match can keep light text, never drop dark text.
+ */
+export function fillsOf(ops, list, items) {
+    const { chars, fills } = drawnCharacters(ops, list);
+    let at = 0;
+    return items.map((text) => {
+        const want = [...squeeze(text)];
+        if (want.length === 0)
+            return { kind: "unknown" };
+        const q = findRun(chars, want, at);
+        if (q < 0)
+            return { kind: "unknown" };
+        at = q + want.length;
+        return fills[q] ?? { kind: "unknown" };
+    });
+}
+//# sourceMappingURL=fill.js.map

package/dist/adapters/pdfjs/fill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fill.js","sourceRoot":"","sources":["../../../src/adapters/pdfjs/fill.ts"],"names":[],"mappings":"AAUA,yFAAyF;AACzF,MAAM,UAAU,SAAS,CAAC,CAAoB;IAC5C,MAAM,GAAG,GAAG,IAAI,CAAC;IACjB,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,GAAG,CAAC;AAChE,CAAC;AAkBD,gHAAgH;AAChH,MAAM,OAAO,GAAG,CAAC,CAAS,EAAU,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AAE/E,6GAA6G;AAC7G,MAAM,UAAU,KAAK,CAAC,IAAa;IACjC,MAAM,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAE,IAAkB,CAAC,CAAC,CAAC,EAAE,CAAC;IACzD,IAAI,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,QAAQ;QAAE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;IACxD,MAAM,IAAI,GAAG,CAAC,CAAU,EAAU,EAAE,CAClC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;SACtC,QAAQ,CAAC,EAAE,CAAC;SACZ,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACtB,OAAO,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AACpD,CAAC;AAED,yEAAyE;AACzE,SAAS,SAAS,CAAC,IAAa;IAC9B,MAAM,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAE,IAAkB,CAAC,CAAC,CAAC,EAAE,CAAC;IACzD,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,CAAe,CAAC,CAAC,CAAC,EAAE,CAAC;IAC9D,OAAO,MAAM;SACV,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CACT,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI,IAAI,SAAS,IAAI,CAAC;QACnD,CAAC,CAAC,MAAM,CAAE,CAA0B,CAAC,OAAO,IAAI,EAAE,CAAC;QACnD,CAAC,CAAC,EAAE,CACP;SACA,IAAI,CAAC,EAAE,CAAC,CAAC;AACd,CAAC;AAQD,4DAA4D;AAC5D,SAAS,UAAU,CACjB,GAAc,EACd,EAAU,EACV,IAAa,EACb,CAAiC;IAEjC,IAAI,EAAE,KAAK,GAAG,CAAC,IAAI;QAAE,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;SAC3C,IAAI,EAAE,KAAK,GAAG,CAAC,OAAO;QACzB,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;SAC7D,IAAI,EAAE,KAAK,GAAG,CAAC,eAAe;QACjC,CAAC,CAAC,GAAG,CAAC,IAAI,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;SAC5C,IAAI,EAAE,KAAK,GAAG,CAAC,oBAAoB;QACtC,CAAC,CAAC,GAAG,CAAC,IAAI,GAAG,MAAM,CAAE,IAA8B,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;;QAC5D,OAAO,KAAK,CAAC;IAClB,OAAO,IAAI,CAAC;AACd,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,eAAe,CAC7B,GAAc,EACd,IAAkB;IAElB,MAAM,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,SAAS,EAAU,EAAE,IAAI,EAAE,CAAC,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;IAC7E,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,KAAK,GAAW,EAAE,CAAC;IACzB,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE;QAC7B,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;QAC/B,IAAI,UAAU,CAAC,GAAG,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;YAAE,OAAO;QACzC,IAAI,EAAE,KAAK,GAAG,CAAC,QAAQ,IAAI,EAAE,KAAK,GAAG,CAAC,cAAc;YAAE,OAAO;QAC7D,MAAM,IAAI,GAAS,CAAC,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC;QACzE,KAAK,MAAM,EAAE,IAAI,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;YAC1C,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACf,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACnB,CAAC;IACH,CAAC,CAAC,CAAC;IACH,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;AAC1B,CAAC;AAED,mFAAmF;AACnF,MAAM,CAAC,MAAM,SAAS,GAAG,IAAI,CAAC;AAE9B,mGAAmG;AACnG,SAAS,OAAO,CACd,KAAwB,EACxB,IAAuB,EACvB,IAAY;IAEZ,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,GAAG,SAAS,CAAC,CAAC;IACvD,KAAK,IAAI,CAAC,GAAG,IAAI,EAAE,CAAC,GAAG,KAAK,EAAE,CAAC,EAAE;QAC/B,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC;YAAE,OAAO,CAAC,CAAC;IAC3D,OAAO,CAAC,CAAC,CAAC;AACZ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,OAAO,CACrB,GAAc,EACd,IAAkB,EAClB,KAAwB;IAExB,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,eAAe,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IACpD,IAAI,EAAE,GAAG,CAAC,CAAC;IACX,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAQ,EAAE;QAC9B,MAAM,IAAI,GAAG,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;QAChC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;QAClD,MAAM,CAAC,GAAG,OAAO,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;QACnC,IAAI,CAAC,GAAG,CAAC;YAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;QACtC,EAAE,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC;QACrB,OAAO,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;IACzC,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/build-engine.d.ts

@@ -0,0 +1,48 @@
+import { type EngineDecision, type EngineFacts, type Runner } from "./engine.ts";
+import { type InstallResult } from "./toolchain.ts";
+import { type TexRequirements } from "./tex-requirements.ts";
+export interface EngineOptions {
+    /** What the targeted papers need: the base set plus each paper's venue. */
+    readonly tex: TexRequirements;
+    readonly dryRun?: boolean;
+    readonly interactive?: boolean;
+    readonly ask?: (question: string) => Promise<string>;
+    readonly log?: (line: string) => void;
+    readonly err?: (line: string) => void;
+    readonly env?: NodeJS.ProcessEnv;
+    readonly run?: Runner;
+    readonly platform?: NodeJS.Platform;
+    readonly home?: string;
+    readonly now?: () => number;
+    /** The install a "yes" runs — `ensureTexLive` over every declared package by default. */
+    readonly install?: () => InstallResult;
+}
+export type EngineOutcome = {
+    readonly ok: true;
+    readonly env: NodeJS.ProcessEnv;
+} | {
+    readonly ok: false;
+    readonly code: number;
+};
+type Resolved = Required<Omit<EngineOptions, "install">> & {
+    install: () => InstallResult;
+};
+/**
+ * The facts `resolveEngine` decides on: rpp's cache and the PATH's TeX Live, each probed. The cache
+ * may hold one tree per TeX Live year; the one reported is the newest COMPLETE one, else the newest
+ * (so a new year whose install was interrupted never wins over a complete older year).
+ */
+export declare function gatherFacts(o: Resolved): EngineFacts;
+/** The one line a run without a human gets. It names the command and what is missing. */
+export declare function refusal(d: EngineDecision, facts: EngineFacts): string;
+/** The question a terminal gets — once per run. */
+export declare function question(facts: EngineFacts, root: string): string;
+/** "", "y", "yes" (any case) is yes — the default is to install. An unanswerable question is no. */
+export declare const isYes: (answer: string | null) => boolean;
+/**
+ * Decide which TeX Live builds these papers. `--dry-run` decides and prints, and never asks or
+ * installs: a plan must not have side effects.
+ */
+export declare function prepareEngine(options: EngineOptions): Promise<EngineOutcome>;
+export {};
+//# sourceMappingURL=build-engine.d.ts.map

package/dist/build-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-engine.d.ts","sourceRoot":"","sources":["../src/build-engine.ts"],"names":[],"mappings":"AAaA,OAAO,EAKL,KAAK,cAAc,EACnB,KAAK,WAAW,EAChB,KAAK,MAAM,EAEZ,MAAM,aAAa,CAAC;AACrB,OAAO,EAML,KAAK,aAAa,EACnB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAiB,KAAK,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE5E,MAAM,WAAW,aAAa;IAC5B,2EAA2E;IAC3E,QAAQ,CAAC,GAAG,EAAE,eAAe,CAAC;IAC9B,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACrD,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACtC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACtC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACjC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC;IACpC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IAC5B,yFAAyF;IACzF,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,aAAa,CAAC;CACxC;AAED,MAAM,MAAM,aAAa,GACrB;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,CAAA;CAAE,GACtD;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAElD,KAAK,QAAQ,GAAG,QAAQ,CAAC,IAAI,CAAC,aAAa,EAAE,SAAS,CAAC,CAAC,GAAG;IACzD,OAAO,EAAE,MAAM,aAAa,CAAC;CAC9B,CAAC;AA+BF;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,QAAQ,GAAG,WAAW,CAwBpD;AAKD,yFAAyF;AACzF,wBAAgB,OAAO,CAAC,CAAC,EAAE,cAAc,EAAE,KAAK,EAAE,WAAW,GAAG,MAAM,CASrE;AAED,mDAAmD;AACnD,wBAAgB,QAAQ,CAAC,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAIjE;AAED,oGAAoG;AACpG,eAAO,MAAM,KAAK,GAAI,QAAQ,MAAM,GAAG,IAAI,KAAG,OAC6B,CAAC;AAkD5E;;;GAGG;AACH,wBAAsB,aAAa,CACjC,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,aAAa,CAAC,CAoBxB"}