@alisio/plugin-thesis 0.1.0

package/dist/render/adapters/typst-pdf/profile.d.ts

@@ -0,0 +1,3 @@
+import type { PresentationProfile } from "../../../styles/profile.js";
+export declare function typstProfile(profile: PresentationProfile): string;
+//# sourceMappingURL=profile.d.ts.map

package/dist/render/adapters/typst-pdf/profile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile.d.ts","sourceRoot":"","sources":["../../../../src/render/adapters/typst-pdf/profile.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAqBtE,wBAAgB,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,MAAM,CAyCjE"}

package/dist/render/adapters/typst-pdf/profile.js

@@ -0,0 +1,55 @@
+import { typstString } from "./escape.js";
+/**
+ * The only place where a format-neutral presentation profile becomes Typst settings (spec 10.4.1).
+ * Profile data never contains Typst; this module emits a fixed-shape dictionary whose values are
+ * validated lengths, numbers, booleans, alignments or escaped strings.
+ */
+const str = (value) => (value === null ? "none" : typstString(value));
+const list = (items) => items.length === 0 ? "()" : `(${items.map(typstString).join(", ")},)`;
+const pt = (value) => `${value}pt`;
+const flag = (value) => (value ? "true" : "false");
+const alignments = new Set(["left", "center", "right", "top", "bottom"]);
+const align = (value) => {
+    if (!alignments.has(value))
+        throw new Error(`Unsupported alignment ${value}`);
+    return value;
+};
+export function typstProfile(profile) {
+    const margins = profile.binding === "mirrored"
+        ? `(top: ${profile.margins.top}, bottom: ${profile.margins.bottom}, inside: ${profile.margins.inside}, outside: ${profile.margins.outside})`
+        : `(top: ${profile.margins.top}, bottom: ${profile.margins.bottom}, left: ${profile.margins.inside}, right: ${profile.margins.outside})`;
+    const headings = profile.headings
+        .map((heading) => `    (size: ${pt(heading.size)}, weight: ${typstString(heading.weight)}, case: ${typstString(heading.case)}, numbering: ${typstString(heading.numbering)}, align: ${align(heading.align)}, above: ${heading.spaceBefore}, below: ${heading.spaceAfter}, new-page: ${flag(heading.newPage)}, run-in: ${flag(heading.runIn)}, ends-with: ${typstString(heading.endsWith)}),`)
+        .join("\n");
+    const pages = profile.pageNumbers;
+    const front = pages.front === "none" ? "none" : pages.front === "roman" ? '"i"' : '"1"';
+    const body = pages.body === "none" ? "none" : '"1"';
+    const restart = !pages.continuous;
+    const lines = [
+        `// Generated from the presentation profile "${profile.id}". Do not edit.`,
+        ...(profile.ruleIds.length > 0 ? [`// Rules: ${profile.ruleIds.join(", ")}`] : []),
+        "#let profile = (",
+        `  id: ${typstString(profile.id)},`,
+        `  margins: ${margins},`,
+        `  font: (body: ${str(profile.font.body)}, headings: ${str(profile.font.headings)}, mono: ${str(profile.font.mono)}),`,
+        `  font-size: ${pt(profile.font.size)},`,
+        `  line-spacing: ${profile.lineSpacing},`,
+        `  paragraph: (indent: ${profile.paragraph.indent}, spacing: ${profile.paragraph.spacing}, justify: ${flag(profile.paragraph.justify)}),`,
+        "  headings: (",
+        headings,
+        "  ),",
+        `  annex-numbering: ${typstString(profile.annexNumbering)},`,
+        `  toc-depth: ${profile.toc.depth},`,
+        `  toc-page-label: ${flag(profile.toc.pageLabel)},`,
+        `  captions: (figure: ${align(profile.captions.figurePosition)}, table: ${align(profile.captions.tablePosition)}, separator: ${typstString(profile.captions.separator)}, source-below: ${flag(profile.captions.sourceBelow)}, per-chapter: ${flag(profile.captions.numbering === "chapter")}, label-style: ${typstString(profile.captions.labelStyle)}),`,
+        `  page-numbers: (front: ${front}, body: ${body}, position: ${align(pages.position)}, restart-front: ${flag(restart && pages.front !== "none")}, restart-body: ${flag(restart && pages.body !== "none")}),`,
+        `  header: ${profile.header === "none" ? "none" : typstString(profile.header)},`,
+        `  front-order: ${list(profile.frontMatter)},`,
+        `  cover: (fields: ${list(profile.cover.fields)}, layout: ${typstString(profile.cover.layout)}),`,
+        `  footnote-size: ${profile.footnotes.size},`,
+        ")",
+        "",
+    ];
+    return lines.join("\n");
+}
+//# sourceMappingURL=profile.js.map

package/dist/render/adapters/typst-pdf/profile.js.map

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

package/dist/render/adapters/typst-pdf/runner.d.ts

@@ -0,0 +1,52 @@
+import type { Finding } from "../../../types.js";
+import type { Availability } from "../../port.js";
+export declare const compileTimeoutMs = 120000;
+/** Any network access from Typst must fail: nothing outside the vendored packages is allowed. */
+export declare const proxyGuard = "http://127.0.0.1:9";
+export interface EngineDeps {
+    /** Run `<binary> --version` and return its stdout; rejects when the binary cannot run. */
+    version(binary: string): Promise<string>;
+    isExecutable(path: string): Promise<boolean>;
+    platform: string;
+    arch: string;
+}
+/**
+ * Engine resolution order (spec 10.6): `ALISIO_THESIS_TYPST`, then `typst` on PATH, then the
+ * binary installed by `/thesis:setup`. An explicit override that does not work is reported as is:
+ * it never silently falls through to another engine.
+ */
+export declare function resolveTypst(env: NodeJS.ProcessEnv, cacheRootPath: string, overrides?: Partial<EngineDeps>): Promise<Availability>;
+export interface TypstRun {
+    binary: string;
+    /** Directory holding main.typ; also the `--root`. */
+    buildDir: string;
+    /** Per-build empty package cache directory. */
+    packageCache: string;
+    /** Vendored packages root (contains `preview/`). */
+    packagePath: string;
+    input: string;
+    output: string;
+    fontPaths?: string[];
+    ignoreSystemFonts?: boolean;
+    pdfa?: boolean;
+    /** Export HTML (experimental feature of Typst) instead of PDF; used to read rendered citations. */
+    html?: boolean;
+    signal?: AbortSignal;
+    env?: NodeJS.ProcessEnv;
+}
+/** The argv for one compile. Exported for tests: the process is always spawned without a shell. */
+export declare function compileArgs(run: TypstRun): string[];
+/** Environment for the child: proxies point at a closed port; Typst's own overrides are dropped. */
+export declare function typstEnv(base: NodeJS.ProcessEnv): NodeJS.ProcessEnv;
+export interface TypstOutcome {
+    code: number | null;
+    stdout: string;
+    stderr: string;
+    timedOut: boolean;
+}
+export declare function runTypst(run: TypstRun): Promise<TypstOutcome>;
+/** Turn `--diagnostic-format short` output into findings (BLD-001 errors, BLD-003 warnings). */
+export declare function parseDiagnostics(text: string): Finding[];
+/** Page count from the PDF page tree (Typst writes `/Type/Pages/Count N` unencrypted). */
+export declare function pdfPageCount(pdf: Buffer): number | undefined;
+//# sourceMappingURL=runner.d.ts.map

package/dist/render/adapters/typst-pdf/runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../../../src/render/adapters/typst-pdf/runner.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAEjD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAKlD,eAAO,MAAM,gBAAgB,SAAU,CAAC;AACxC,iGAAiG;AACjG,eAAO,MAAM,UAAU,uBAAuB,CAAC;AAE/C,MAAM,WAAW,UAAU;IACzB,0FAA0F;IAC1F,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACzC,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7C,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CACd;AAuDD;;;;GAIG;AACH,wBAAsB,YAAY,CAChC,GAAG,EAAE,MAAM,CAAC,UAAU,EACtB,aAAa,EAAE,MAAM,EACrB,SAAS,GAAE,OAAO,CAAC,UAAU,CAAM,GAClC,OAAO,CAAC,YAAY,CAAC,CAqBvB;AAED,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,qDAAqD;IACrD,QAAQ,EAAE,MAAM,CAAC;IACjB,+CAA+C;IAC/C,YAAY,EAAE,MAAM,CAAC;IACrB,oDAAoD;IACpD,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,mGAAmG;IACnG,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CACzB;AAED,mGAAmG;AACnG,wBAAgB,WAAW,CAAC,GAAG,EAAE,QAAQ,GAAG,MAAM,EAAE,CAkBnD;AAED,oGAAoG;AACpG,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU,CAcnE;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,wBAAsB,QAAQ,CAAC,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,YAAY,CAAC,CA2BnE;AAKD,gGAAgG;AAChG,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,EAAE,CAmCxD;AAED,0FAA0F;AAC1F,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAQ5D"}

package/dist/render/adapters/typst-pdf/runner.js

@@ -0,0 +1,209 @@
+import { execFile } from "node:child_process";
+import { constants } from "node:fs";
+import { access } from "node:fs/promises";
+import { delimiter, join } from "node:path";
+import { promisify } from "node:util";
+import { typstInstallDir } from "../../../cache.js";
+import { typstPins, typstVersion } from "../../../typst-pins.js";
+import { parseTypstVersion, typstVersionOk } from "./version.js";
+const execFileAsync = promisify(execFile);
+export const compileTimeoutMs = 120_000;
+/** Any network access from Typst must fail: nothing outside the vendored packages is allowed. */
+export const proxyGuard = "http://127.0.0.1:9";
+const defaultDeps = () => ({
+    async version(binary) {
+        const { stdout } = await execFileAsync(binary, ["--version"], {
+            encoding: "utf8",
+            timeout: 10_000,
+            windowsHide: true,
+        });
+        return stdout;
+    },
+    async isExecutable(path) {
+        try {
+            await access(path, process.platform === "win32" ? constants.F_OK : constants.X_OK);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    },
+    platform: process.platform,
+    arch: process.arch,
+});
+async function findOnPath(env, deps) {
+    const names = deps.platform === "win32" ? ["typst.exe", "typst.cmd"] : ["typst"];
+    for (const directory of (env.PATH ?? env.Path ?? "").split(delimiter)) {
+        if (!directory)
+            continue;
+        for (const name of names) {
+            const candidate = join(directory, name);
+            if (await deps.isExecutable(candidate))
+                return candidate;
+        }
+    }
+    return undefined;
+}
+async function check(binary, source, deps) {
+    let output;
+    try {
+        output = await deps.version(binary);
+    }
+    catch {
+        return { available: false, reason: `${source}: the Typst binary could not be run` };
+    }
+    const version = parseTypstVersion(output);
+    if (!version)
+        return { available: false, reason: `${source}: the Typst version could not be read` };
+    const text = version.join(".");
+    if (!typstVersionOk(version)) {
+        return {
+            available: false,
+            reason: `${source}: Typst ${text} is older than the required 0.15.0`,
+        };
+    }
+    return { available: true, engine: `typst ${text}`, version: text, source, path: binary };
+}
+/**
+ * Engine resolution order (spec 10.6): `ALISIO_THESIS_TYPST`, then `typst` on PATH, then the
+ * binary installed by `/thesis:setup`. An explicit override that does not work is reported as is:
+ * it never silently falls through to another engine.
+ */
+export async function resolveTypst(env, cacheRootPath, overrides = {}) {
+    const deps = { ...defaultDeps(), ...overrides };
+    if (env.ALISIO_THESIS_TYPST)
+        return check(env.ALISIO_THESIS_TYPST, "ALISIO_THESIS_TYPST", deps);
+    const onPath = await findOnPath(env, deps);
+    if (onPath) {
+        const found = await check(onPath, "PATH", deps);
+        if (found.available)
+            return found;
+    }
+    const pin = typstPins[`${deps.platform}-${deps.arch}`];
+    if (pin) {
+        const cached = join(typstInstallDir(cacheRootPath, typstVersion), pin.executable);
+        if (await deps.isExecutable(cached)) {
+            const found = await check(cached, "setup cache", deps);
+            if (found.available)
+                return found;
+        }
+    }
+    return {
+        available: false,
+        reason: "No Typst 0.15 engine was found (ALISIO_THESIS_TYPST, PATH, setup cache)",
+        hint: "Run /thesis:setup to install the pinned Typst, or set ALISIO_THESIS_TYPST to a Typst 0.15 binary.",
+    };
+}
+/** The argv for one compile. Exported for tests: the process is always spawned without a shell. */
+export function compileArgs(run) {
+    const args = [
+        "compile",
+        "--root",
+        run.buildDir,
+        "--package-path",
+        run.packagePath,
+        "--package-cache-path",
+        run.packageCache,
+        "--diagnostic-format",
+        "short",
+    ];
+    for (const path of run.fontPaths ?? [])
+        args.push("--font-path", path);
+    if (run.ignoreSystemFonts)
+        args.push("--ignore-system-fonts");
+    if (run.pdfa)
+        args.push("--pdf-standard", "a-2b");
+    if (run.html)
+        args.push("--features", "html", "--format", "html");
+    args.push(run.input, run.output);
+    return args;
+}
+/** Environment for the child: proxies point at a closed port; Typst's own overrides are dropped. */
+export function typstEnv(base) {
+    const env = {};
+    for (const [key, value] of Object.entries(base)) {
+        if (value === undefined)
+            continue;
+        if (/^typst_/i.test(key) || /^(?:https?|all|no)_proxy$/i.test(key))
+            continue;
+        env[key] = value;
+    }
+    env.HTTPS_PROXY = proxyGuard;
+    env.https_proxy = proxyGuard;
+    env.ALL_PROXY = proxyGuard;
+    env.all_proxy = proxyGuard;
+    env.HTTP_PROXY = proxyGuard;
+    env.http_proxy = proxyGuard;
+    return env;
+}
+export async function runTypst(run) {
+    try {
+        const { stdout, stderr } = await execFileAsync(run.binary, compileArgs(run), {
+            cwd: run.buildDir,
+            env: typstEnv(run.env ?? process.env),
+            encoding: "utf8",
+            timeout: compileTimeoutMs,
+            killSignal: "SIGKILL",
+            maxBuffer: 10 * 1024 * 1024,
+            windowsHide: true,
+            ...(run.signal ? { signal: run.signal } : {}),
+        });
+        return { code: 0, stdout, stderr, timedOut: false };
+    }
+    catch (error) {
+        const failure = error;
+        return {
+            code: typeof failure.code === "number" ? failure.code : null,
+            stdout: failure.stdout ?? "",
+            stderr: failure.stderr ?? failure.message,
+            timedOut: failure.killed === true,
+        };
+    }
+}
+const located = /^(.+?):(\d+):(\d+): (error|warning): (.*)$/;
+const bare = /^(error|warning): (.*)$/;
+/** Turn `--diagnostic-format short` output into findings (BLD-001 errors, BLD-003 warnings). */
+export function parseDiagnostics(text) {
+    const findings = [];
+    const add = (severity, message, file, line) => {
+        findings.push({
+            code: severity === "error" ? "BLD-001" : "BLD-003",
+            gate: "G8",
+            severity,
+            ...(file ? { file } : {}),
+            ...(line ? { line } : {}),
+            message: message.trim().slice(0, 500),
+        });
+    };
+    for (const raw of text.split(/\r?\n/)) {
+        const line = raw.trimEnd();
+        if (line === "")
+            continue;
+        const match = located.exec(line);
+        if (match) {
+            add(match[4], match[5], `build/${match[1]}`, Number(match[2]));
+            continue;
+        }
+        const plain = bare.exec(line);
+        if (plain) {
+            add(plain[1], plain[2]);
+            continue;
+        }
+        const last = findings[findings.length - 1];
+        if (last && /^\s*(?:hint|help):/i.test(line))
+            last.hint = line.replace(/^\s*(?:hint|help):\s*/i, "");
+    }
+    return findings;
+}
+/** Page count from the PDF page tree (Typst writes `/Type/Pages/Count N` unencrypted). */
+export function pdfPageCount(pdf) {
+    const text = pdf.toString("latin1");
+    let best;
+    for (const dictionary of text.matchAll(/<<[^<>]*\/Type\s*\/Pages\b[^<>]*>>/g)) {
+        const count = /\/Count\s+(\d+)/.exec(dictionary[0]);
+        if (count && (best === undefined || Number(count[1]) > best))
+            best = Number(count[1]);
+    }
+    return best;
+}
+//# sourceMappingURL=runner.js.map

package/dist/render/adapters/typst-pdf/runner.js.map

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

package/dist/render/adapters/typst-pdf/setup.d.ts

@@ -0,0 +1,30 @@
+import { type TypstPin } from "../../../typst-pins.js";
+/** Release downloads redirect from github.com to GitHub's own object storage hosts, nowhere else. */
+export declare const allowedHosts: readonly string[];
+export interface SetupDeps {
+    fetch: typeof fetch;
+    run(file: string, args: string[]): Promise<string>;
+    platform: string;
+    arch: string;
+    pins: Record<string, TypstPin>;
+    releaseBase: string;
+    version: string;
+}
+export interface SetupResult {
+    ok: boolean;
+    message: string;
+    path?: string;
+    version?: string;
+    alreadyInstalled?: boolean;
+}
+/**
+ * `/thesis:setup`: install the pinned Typst into the cache. The only place the plugin downloads an
+ * engine; the SHA-256 is verified before anything is extracted, and extraction uses the system
+ * `tar` with an argv array (no shell).
+ */
+export declare function setupTypst(options: {
+    cacheRoot: string;
+    deps?: Partial<SetupDeps>;
+    signal?: AbortSignal;
+}): Promise<SetupResult>;
+//# sourceMappingURL=setup.d.ts.map

package/dist/render/adapters/typst-pdf/setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../../../src/render/adapters/typst-pdf/setup.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,KAAK,QAAQ,EAA6C,MAAM,wBAAwB,CAAC;AAKlG,qGAAqG;AACrG,eAAO,MAAM,YAAY,EAAE,SAAS,MAAM,EAIzC,CAAC;AAKF,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,OAAO,KAAK,CAAC;IACpB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACnD,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CACjB;AAmBD,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,OAAO,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAkED;;;;GAIG;AACH,wBAAsB,UAAU,CAAC,OAAO,EAAE;IACxC,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;IAC1B,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,GAAG,OAAO,CAAC,WAAW,CAAC,CA2EvB"}

package/dist/render/adapters/typst-pdf/setup.js

@@ -0,0 +1,183 @@
+import { execFile } from "node:child_process";
+import { createHash, randomUUID } from "node:crypto";
+import { createWriteStream } from "node:fs";
+import { chmod, mkdir, rename, rm, stat } from "node:fs/promises";
+import { join } from "node:path";
+import { promisify } from "node:util";
+import { typstInstallDir } from "../../../cache.js";
+import { typstPins, typstReleaseBase, typstVersion } from "../../../typst-pins.js";
+import { parseTypstVersion } from "./version.js";
+const execFileAsync = promisify(execFile);
+/** Release downloads redirect from github.com to GitHub's own object storage hosts, nowhere else. */
+export const allowedHosts = [
+    "github.com",
+    "objects.githubusercontent.com",
+    "release-assets.githubusercontent.com",
+];
+const maxBytes = 120 * 1024 * 1024;
+const maxRedirects = 5;
+const downloadTimeoutMs = 120_000;
+const defaultDeps = () => ({
+    fetch: globalThis.fetch,
+    async run(file, args) {
+        const { stdout } = await execFileAsync(file, args, {
+            encoding: "utf8",
+            timeout: 120_000,
+            windowsHide: true,
+        });
+        return stdout;
+    },
+    platform: process.platform,
+    arch: process.arch,
+    pins: typstPins,
+    releaseBase: typstReleaseBase,
+    version: typstVersion,
+});
+function checkRedirect(location, from) {
+    let target;
+    try {
+        target = new URL(location, from);
+    }
+    catch {
+        throw new Error("The download redirected to an invalid address");
+    }
+    if (target.protocol !== "https:" || !allowedHosts.includes(target.hostname)) {
+        throw new Error(`The download redirected to a host that is not allowed (${target.hostname})`);
+    }
+    return target;
+}
+async function download(url, destination, deps, signal) {
+    let current = checkRedirect(url, url);
+    for (let hop = 0; hop <= maxRedirects; hop += 1) {
+        const response = await deps.fetch(current, {
+            redirect: "manual",
+            signal: AbortSignal.any([
+                AbortSignal.timeout(downloadTimeoutMs),
+                ...(signal ? [signal] : []),
+            ]),
+        });
+        if ([301, 302, 303, 307, 308].includes(response.status)) {
+            const location = response.headers.get("location");
+            if (!location)
+                throw new Error("The download redirected without a location");
+            current = checkRedirect(location, current.href);
+            continue;
+        }
+        if (response.status !== 200 || !response.body) {
+            throw new Error(`The download failed with HTTP ${response.status}`);
+        }
+        const hash = createHash("sha256");
+        const file = createWriteStream(destination, { flags: "wx", mode: 0o600 });
+        let size = 0;
+        try {
+            for await (const chunk of response.body) {
+                size += chunk.length;
+                if (size > maxBytes)
+                    throw new Error("The download is larger than the allowed size");
+                hash.update(chunk);
+                if (!file.write(chunk))
+                    await new Promise((resolve) => file.once("drain", resolve));
+            }
+        }
+        finally {
+            await new Promise((resolve) => file.end(resolve));
+        }
+        return hash.digest("hex");
+    }
+    throw new Error("The download redirected too many times");
+}
+async function installedVersion(binary, deps) {
+    try {
+        const parsed = parseTypstVersion(await deps.run(binary, ["--version"]));
+        return parsed?.join(".");
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * `/thesis:setup`: install the pinned Typst into the cache. The only place the plugin downloads an
+ * engine; the SHA-256 is verified before anything is extracted, and extraction uses the system
+ * `tar` with an argv array (no shell).
+ */
+export async function setupTypst(options) {
+    const deps = { ...defaultDeps(), ...options.deps };
+    const key = `${deps.platform}-${deps.arch}`;
+    const pin = deps.pins[key];
+    if (!pin) {
+        return {
+            ok: false,
+            message: `No pinned Typst build exists for ${key}. Install Typst ${deps.version} yourself and set ALISIO_THESIS_TYPST.`,
+        };
+    }
+    const installDir = typstInstallDir(options.cacheRoot, deps.version);
+    const binary = join(installDir, pin.executable);
+    const existing = await installedVersion(binary, deps);
+    if (existing === deps.version) {
+        return {
+            ok: true,
+            alreadyInstalled: true,
+            path: binary,
+            version: existing,
+            message: `Typst ${existing} is already installed in the cache.`,
+        };
+    }
+    const parent = join(options.cacheRoot, "thesis", "typst");
+    await mkdir(parent, { recursive: true, mode: 0o700 });
+    const work = join(parent, `.setup-${randomUUID()}`);
+    await mkdir(work, { mode: 0o700 });
+    const archive = join(work, pin.asset);
+    try {
+        let digest;
+        try {
+            digest = await download(`${deps.releaseBase}${pin.asset}`, archive, deps, options.signal);
+        }
+        catch (error) {
+            return { ok: false, message: `Typst download failed: ${error.message}` };
+        }
+        if (digest !== pin.sha256) {
+            return {
+                ok: false,
+                message: `Typst download rejected: its SHA-256 does not match the pinned value (${digest.slice(0, 12)}...). Nothing was extracted.`,
+            };
+        }
+        const staging = join(work, "extract");
+        await mkdir(staging, { mode: 0o700 });
+        try {
+            await deps.run("tar", ["-xf", archive, "-C", staging, "--strip-components=1"]);
+        }
+        catch (error) {
+            return {
+                ok: false,
+                message: `Could not extract the Typst archive: ${error.message}`,
+            };
+        }
+        try {
+            await stat(join(staging, pin.executable));
+        }
+        catch {
+            return { ok: false, message: "The Typst archive did not contain the expected executable." };
+        }
+        if (deps.platform !== "win32")
+            await chmod(join(staging, pin.executable), 0o755);
+        const version = await installedVersion(join(staging, pin.executable), deps);
+        if (version !== deps.version) {
+            return {
+                ok: false,
+                message: `The extracted Typst reports ${version ?? "no version"} instead of ${deps.version}.`,
+            };
+        }
+        await rm(installDir, { recursive: true, force: true });
+        await rename(staging, installDir);
+        return {
+            ok: true,
+            path: binary,
+            version,
+            message: `Installed Typst ${version} into the cache (${pin.asset}, checksum verified).`,
+        };
+    }
+    finally {
+        await rm(work, { recursive: true, force: true });
+    }
+}
+//# sourceMappingURL=setup.js.map

package/dist/render/adapters/typst-pdf/setup.js.map

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

package/dist/render/adapters/typst-pdf/version.d.ts

@@ -0,0 +1,8 @@
+export declare const requiredTypst: {
+    readonly major: 0;
+    readonly minor: 15;
+    readonly patch: 0;
+};
+export declare function parseTypstVersion(output: string): [number, number, number] | undefined;
+export declare function typstVersionOk(version: [number, number, number]): boolean;
+//# sourceMappingURL=version.d.ts.map

package/dist/render/adapters/typst-pdf/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../../../src/render/adapters/typst-pdf/version.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,aAAa;aAAK,KAAK,EAAE,CAAC;aAAE,KAAK,EAAE,EAAE;aAAE,KAAK,EAAE,CAAC;CAAW,CAAC;AAExE,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAGtF;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAKzE"}

package/dist/render/adapters/typst-pdf/version.js

@@ -0,0 +1,14 @@
+export const requiredTypst = { major: 0, minor: 15, patch: 0 };
+export function parseTypstVersion(output) {
+    const match = /typst\s+(\d+)\.(\d+)\.(\d+)/i.exec(output);
+    return match ? [Number(match[1]), Number(match[2]), Number(match[3])] : undefined;
+}
+export function typstVersionOk(version) {
+    const [major, minor, patch] = version;
+    if (major !== requiredTypst.major)
+        return major > requiredTypst.major;
+    if (minor !== requiredTypst.minor)
+        return minor > requiredTypst.minor;
+    return patch >= requiredTypst.patch;
+}
+//# sourceMappingURL=version.js.map

package/dist/render/adapters/typst-pdf/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../../../src/render/adapters/typst-pdf/version.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,aAAa,GAAG,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,EAAW,CAAC;AAExE,MAAM,UAAU,iBAAiB,CAAC,MAAc;IAC9C,MAAM,KAAK,GAAG,8BAA8B,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC1D,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AACpF,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,OAAiC;IAC9D,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,GAAG,OAAO,CAAC;IACtC,IAAI,KAAK,KAAK,aAAa,CAAC,KAAK;QAAE,OAAO,KAAK,GAAG,aAAa,CAAC,KAAK,CAAC;IACtE,IAAI,KAAK,KAAK,aAAa,CAAC,KAAK;QAAE,OAAO,KAAK,GAAG,aAAa,CAAC,KAAK,CAAC;IACtE,OAAO,KAAK,IAAI,aAAa,CAAC,KAAK,CAAC;AACtC,CAAC"}

package/dist/render/assemble.d.ts

@@ -0,0 +1,28 @@
+import type { LoadedProject } from "../checks/project.js";
+import { type TypeLabels } from "../research/bibtex.js";
+import type { Brief, Finding, SectionState } from "../types.js";
+import type { BuildScope, I18nStrings, ResolvedMeta, ThesisDocument } from "./model.js";
+export declare const supportedLanguages: readonly ["en", "es", "pt"];
+/** Label strings shipped with the package for one language code. */
+export declare function shippedStrings(code: string): I18nStrings | undefined;
+/** Genre labels printed by the citation styles, in the thesis language. */
+export declare function typeLabels(strings: I18nStrings): TypeLabels;
+export declare function resolveMeta(project: LoadedProject, brief: Brief): ResolvedMeta;
+export interface AssembleOptions {
+    scope?: BuildScope;
+    /** Required for `section` scope: an outline id such as SEC-03 (matches its sub-sections too). */
+    section?: string;
+    /** Section states from state.json; `approved` scope needs them. */
+    sections?: Record<string, SectionState>;
+}
+export interface Assembled {
+    document: ThesisDocument;
+    /** HYG-001 findings from the dialect plus label/language notes. */
+    findings: Finding[];
+}
+/**
+ * Parse every chapter into the neutral document. Pure and synchronous so the deterministic checks
+ * can run it; assets are resolved later by the build.
+ */
+export declare function assembleDocument(project: LoadedProject, options?: AssembleOptions): Assembled | undefined;
+//# sourceMappingURL=assemble.d.ts.map