@alisio/plugin-thesis 0.1.0

package/dist/render/assemble.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assemble.d.ts","sourceRoot":"","sources":["../../src/render/assemble.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAE1D,OAAO,EAAkB,KAAK,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAIxE,OAAO,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhE,OAAO,KAAK,EACV,UAAU,EAEV,WAAW,EACX,YAAY,EAEZ,cAAc,EACf,MAAM,YAAY,CAAC;AAIpB,eAAO,MAAM,kBAAkB,YAAI,IAAI,EAAE,IAAI,EAAE,IAAI,CAAU,CAAC;AAI9D,oEAAoE;AACpE,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAYpE;AAsDD,2EAA2E;AAC3E,wBAAgB,UAAU,CAAC,OAAO,EAAE,WAAW,GAAG,UAAU,CAS3D;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,aAAa,EAAE,KAAK,EAAE,KAAK,GAAG,YAAY,CAkC9E;AAkCD,MAAM,WAAW,eAAe;IAC9B,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,iGAAiG;IACjG,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mEAAmE;IACnE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;CACzC;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,cAAc,CAAC;IACzB,mEAAmE;IACnE,QAAQ,EAAE,OAAO,EAAE,CAAC;CACrB;AA2BD;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,aAAa,EACtB,OAAO,GAAE,eAAoB,GAC5B,SAAS,GAAG,SAAS,CAkJvB"}

package/dist/render/assemble.js

@@ -0,0 +1,309 @@
+import { readFileSync } from "node:fs";
+import { parse as parseYaml } from "yaml";
+import { packagePath } from "../package-paths.js";
+import { generateBibtex } from "../research/bibtex.js";
+import { parseLibraryText } from "../research/library.js";
+import { resolveCitationStyle, resolvePresentationProfile } from "../styles/discovery.js";
+import { loadShippedProfile } from "../styles/profile.js";
+import { diagramThemeFor } from "./diagram-theme.js";
+import { parseChapter } from "./parse.js";
+import { allBlockLists, walkBlocks, walkInlines } from "./walk.js";
+export const supportedLanguages = ["en", "es", "pt"];
+const stringCache = new Map();
+/** Label strings shipped with the package for one language code. */
+export function shippedStrings(code) {
+    if (!supportedLanguages.includes(code))
+        return undefined;
+    const cached = stringCache.get(code);
+    if (cached)
+        return cached;
+    const parsed = parseYaml(readFileSync(packagePath("templates", "typst", "i18n", `${code}.yaml`), "utf8"));
+    const strings = {};
+    for (const [key, value] of Object.entries(parsed))
+        if (typeof value === "string")
+            strings[key] = value;
+    stringCache.set(code, strings);
+    return strings;
+}
+const hasControl = (value) => [...value].some((char) => char.codePointAt(0) < 0x20 || char === "\u007f");
+/** Merge `thesis/i18n.yaml` over a base label set; unknown keys and bad values become findings. */
+function overrideStrings(base, text, findings) {
+    if (text === undefined)
+        return base;
+    const fail = (message) => findings.push({ code: "LNG-002", gate: "G7", severity: "warning", file: "i18n.yaml", message });
+    let data;
+    try {
+        data = parseYaml(text);
+    }
+    catch {
+        fail("i18n.yaml is not valid YAML and was ignored");
+        return base;
+    }
+    if (data === null || typeof data !== "object" || Array.isArray(data)) {
+        fail("i18n.yaml must be a mapping of label keys to text and was ignored");
+        return base;
+    }
+    const merged = { ...base };
+    for (const [key, value] of Object.entries(data)) {
+        if (!(key in base))
+            fail(`i18n.yaml: unknown label key "${key}"`);
+        else if (typeof value !== "string" ||
+            value.length === 0 ||
+            value.length > 200 ||
+            hasControl(value))
+            fail(`i18n.yaml: "${key}" must be a text of 1 to 200 characters`);
+        else
+            merged[key] = value;
+    }
+    return merged;
+}
+/** Institution rules may fix the body font or line spacing; they win over the interview answers. */
+function ruleValue(project, kind, pick) {
+    const rules = (project.profile?.rules ?? []).filter((rule) => rule.kind === kind);
+    for (const rule of [...rules].sort((a, b) => a.rank - b.rank)) {
+        const value = pick(rule.values);
+        if (value !== undefined)
+            return value;
+    }
+    return undefined;
+}
+/** Genre labels printed by the citation styles, in the thesis language. */
+export function typeLabels(strings) {
+    const pick = (key) => strings[`evidence_${key}`];
+    const labels = {};
+    if (pick("law"))
+        labels.law = pick("law");
+    if (pick("standard"))
+        labels.standard = pick("standard");
+    if (pick("dataset"))
+        labels.dataset = pick("dataset");
+    if (pick("thesis"))
+        labels.thesis = pick("thesis");
+    if (pick("preprint"))
+        labels.preprint = pick("preprint");
+    return labels;
+}
+export function resolveMeta(project, brief) {
+    const profile = project.profile;
+    const [languageCode = "en", ...rest] = brief.language.split("-");
+    const region = rest.find((part) => /^[A-Za-z]{2}$/.test(part));
+    const family = ruleValue(project, "font", (values) => typeof values.family === "string" ? values.family : undefined);
+    const spacing = ruleValue(project, "line_spacing", (values) => {
+        const candidate = values.body ?? values.multiple;
+        return typeof candidate === "number" ? candidate : undefined;
+    });
+    return {
+        language: brief.language,
+        languageCode: languageCode.toLowerCase(),
+        ...(region ? { region: region.toLowerCase() } : {}),
+        title: brief.title ?? "Untitled thesis",
+        subtitle: brief.subtitle,
+        authors: brief.authors.map((author) => author.name),
+        advisors: brief.advisors,
+        institution: brief.institution,
+        year: brief.year,
+        workType: brief.workType,
+        secondaryAbstractLanguage: brief.secondaryAbstractLanguage,
+        paper: brief.presentation.paper,
+        fontProfile: brief.presentation.fontProfile,
+        bodyFont: typeof family === "string" ? family : (brief.presentation.bodyFont ?? null),
+        palette: brief.presentation.palette,
+        diagramTheme: brief.presentation.diagramTheme,
+        lineSpacing: typeof spacing === "number" ? spacing : (brief.presentation.lineSpacing ?? null),
+        presentationStandard: profile?.presentationStandard.value ?? "generic",
+        citationStyle: profile?.citationStyle.value ?? "apa-7",
+        aiDeclarationRequired: profile?.aiDeclaration.required ?? false,
+        ruleIds: profile?.presentationStandard.ruleIds ?? [],
+    };
+}
+const document0 = (frontMatter, body, annexes, footnotes) => ({ frontMatter, body, annexes, footnotes });
+/** In a partial build, references to labels that are not included become plain text. */
+function degradeRefs(pieces) {
+    const lists = allBlockLists(pieces);
+    const labels = new Set();
+    for (const { blocks } of lists) {
+        walkBlocks(blocks, (block) => {
+            if ("label" in block && block.label)
+                labels.add(block.label);
+        });
+    }
+    let degraded = 0;
+    for (const { blocks } of lists) {
+        walkInlines(blocks, (inline) => {
+            if (inline.kind === "crossref" && !labels.has(inline.label)) {
+                const text = inline;
+                text.text = `\u00ab${inline.label}\u00bb`;
+                text.kind = "text";
+                delete text.label;
+                degraded += 1;
+            }
+        });
+    }
+    return degraded;
+}
+const frontRoles = new Set([
+    "abstract",
+    "abstract-secondary",
+    "dedication",
+    "acknowledgments",
+    "ai-declaration",
+]);
+const matchesSection = (declared, wanted) => declared !== undefined && (declared === wanted || declared.startsWith(`${wanted}.`));
+/** Does a chapter file take part in a scope? Files that declare no section are always included. */
+function inScope(section, options) {
+    const scope = options.scope ?? "full";
+    if (scope === "full")
+        return true;
+    if (scope === "section") {
+        return section.role === "body" && matchesSection(section.section, options.section ?? "");
+    }
+    if (frontRoles.has(section.role) || section.section === undefined)
+        return true;
+    const states = options.sections ?? {};
+    return Object.entries(states).some(([id, state]) => state.status === "approved" && matchesSection(section.section, id));
+}
+/**
+ * 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 function assembleDocument(project, options = {}) {
+    const brief = project.brief?.brief;
+    if (!brief)
+        return undefined;
+    const findings = [];
+    const meta = resolveMeta(project, brief);
+    const frontMatter = [];
+    const body = [];
+    const annexes = [];
+    const footnotes = {};
+    for (const chapter of project.chapters) {
+        const parsed = parseChapter(chapter.path, chapter.content);
+        findings.push(...parsed.findings);
+        if (!inScope(parsed.section, options))
+            continue;
+        Object.assign(footnotes, parsed.footnotes);
+        if (frontRoles.has(parsed.section.role))
+            frontMatter.push(parsed.section);
+        else if (parsed.section.role === "annex")
+            annexes.push(parsed.section);
+        else
+            body.push(parsed.section);
+    }
+    const figures = new Map();
+    const collect = (sections) => {
+        for (const section of sections) {
+            walkBlocks(section.blocks, (block) => {
+                if (block.kind === "figure" && block.label && !figures.has(block.label)) {
+                    figures.set(block.label, block.asset);
+                }
+            });
+        }
+    };
+    collect(body);
+    collect(annexes);
+    if ((options.scope ?? "full") !== "full") {
+        const count = degradeRefs(document0(frontMatter, body, annexes, footnotes));
+        if (count > 0) {
+            findings.push({
+                code: "BLD-003",
+                gate: "G8",
+                severity: "warning",
+                message: `${count} cross-reference(s) point outside this partial build and were left as plain text`,
+            });
+        }
+    }
+    const base = shippedStrings(meta.languageCode);
+    if (!base) {
+        findings.push({
+            code: "LNG-002",
+            gate: "G7",
+            severity: "warning",
+            file: "thesis.yaml",
+            message: `No built-in labels for language "${meta.languageCode}"; English labels are used`,
+            hint: "Supply thesis/i18n.yaml with translated labels (see templates/typst/i18n/en.yaml for the keys).",
+        });
+    }
+    const english = shippedStrings("en");
+    const strings = { ...overrideStrings(base ?? english, project.i18nText, findings) };
+    // Abstract labels for every other abstract language, as `abstract@en` and `keywords@en`.
+    const abstractLanguages = new Set();
+    if (meta.secondaryAbstractLanguage)
+        abstractLanguages.add(meta.secondaryAbstractLanguage);
+    for (const section of frontMatter)
+        if (section.lang)
+            abstractLanguages.add(section.lang);
+    for (const language of abstractLanguages) {
+        const code = language.split("-")[0]?.toLowerCase() ?? "en";
+        const localized = shippedStrings(code) ?? english;
+        strings[`abstract@${language}`] = localized.abstract;
+        strings[`keywords@${language}`] = localized.keywords;
+    }
+    const library = parseLibraryText(project.libraryText).records.filter((record) => record.status !== "REJECTED");
+    // Presentation profile and citation style: shipped or workspace; problems block the build.
+    const resolvedProfile = resolvePresentationProfile(meta.presentationStandard, project.profileFiles);
+    for (const issue of resolvedProfile.issues) {
+        findings.push({
+            code: "PRF-001",
+            gate: "G0",
+            severity: "error",
+            file: `styles/${meta.presentationStandard}.profile.yaml`,
+            message: `${issue.path ? `${issue.path}: ` : ""}${issue.message}`,
+        });
+    }
+    let presentation = resolvedProfile.profile;
+    if (!presentation) {
+        if (resolvedProfile.issues.length === 0) {
+            findings.push({
+                code: "BLD-004",
+                gate: "G8",
+                severity: "warning",
+                message: `Presentation profile "${meta.presentationStandard}" is not available; the generic layout is used`,
+            });
+        }
+        presentation = loadShippedProfile("generic");
+    }
+    if (presentation.paper)
+        meta.paper = presentation.paper;
+    if (meta.presentationStandard === "icontec-ntc1486-2022" &&
+        (meta.bodyFont === null || meta.lineSpacing === null)) {
+        findings.push({
+            code: "BLD-004",
+            gate: "G8",
+            severity: "warning",
+            message: "ICONTEC: body font and line spacing are disputed between the 2022 guides and were not chosen yet; provisional defaults are used",
+            hint: "Answer them with /thesis:init --presentation or set presentation.bodyFont and presentation.lineSpacing.",
+        });
+    }
+    const resolvedStyle = resolveCitationStyle(meta.citationStyle, project.styleFiles);
+    for (const issue of resolvedStyle.issues) {
+        findings.push({
+            code: issue.code,
+            gate: "G0",
+            severity: "error",
+            file: `styles/${meta.citationStyle}.csl`,
+            message: issue.message,
+            ...(issue.hint ? { hint: issue.hint } : {}),
+        });
+    }
+    const style = resolvedStyle.style ??
+        resolveCitationStyle("apa-7", []).style;
+    const document = {
+        meta,
+        presentation,
+        diagramTheme: diagramThemeFor(meta),
+        frontMatter,
+        body,
+        annexes,
+        footnotes,
+        figures,
+        bibliography: {
+            entries: library,
+            styleId: meta.citationStyle,
+            csl: style,
+            bibtex: generateBibtex(library, typeLabels(strings)),
+        },
+        strings,
+    };
+    return { document, findings };
+}
+//# sourceMappingURL=assemble.js.map

package/dist/render/assemble.js.map

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

package/dist/render/assets.d.ts

@@ -0,0 +1,27 @@
+import type { Finding } from "../types.js";
+import type { FigureAsset, FigureAssetKind, ResolvedAsset, ResolvedMeta, ThesisDocument } from "./model.js";
+/**
+ * Format-neutral asset services (spec 10.0): every figure source is read through the thesis-root
+ * path guard, validated, and materialized into the build directory under a content-addressed name.
+ * Adapters then reference `asset.resolved.file`; none of them touches the workspace.
+ */
+export interface AssetContext {
+    /** Absolute thesis root. */
+    root: string;
+    /** Absolute build directory. */
+    buildDir: string;
+    /** Absolute cache directory for expensive derived assets (charts). */
+    cacheDir: string;
+    /** Presentation inputs for derived assets (chart palette and fonts). */
+    meta?: Pick<ResolvedMeta, "palette" | "fontProfile" | "bodyFont">;
+}
+export type AssetFailure = {
+    error: string;
+    hint?: string;
+    code?: string;
+};
+export type AssetResolver = (asset: FigureAsset, context: AssetContext) => Promise<ResolvedAsset | AssetFailure>;
+export declare const defaultAssetResolvers: Record<FigureAssetKind, AssetResolver>;
+/** Resolve every figure asset of a document in place; returns BLD-002 findings for failures. */
+export declare function resolveAssets(doc: ThesisDocument, context: AssetContext, resolvers?: Record<FigureAssetKind, AssetResolver>): Promise<Finding[]>;
+//# sourceMappingURL=assets.d.ts.map

package/dist/render/assets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assets.d.ts","sourceRoot":"","sources":["../../src/render/assets.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,KAAK,EACV,WAAW,EACX,eAAe,EACf,aAAa,EACb,YAAY,EACZ,cAAc,EACf,MAAM,YAAY,CAAC;AAGpB;;;;GAIG;AAEH,MAAM,WAAW,YAAY;IAC3B,4BAA4B;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,gCAAgC;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,sEAAsE;IACtE,QAAQ,EAAE,MAAM,CAAC;IACjB,wEAAwE;IACxE,IAAI,CAAC,EAAE,IAAI,CAAC,YAAY,EAAE,SAAS,GAAG,aAAa,GAAG,UAAU,CAAC,CAAC;CACnE;AAED,MAAM,MAAM,YAAY,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAC3E,MAAM,MAAM,aAAa,GAAG,CAC1B,KAAK,EAAE,WAAW,EAClB,OAAO,EAAE,YAAY,KAClB,OAAO,CAAC,aAAa,GAAG,YAAY,CAAC,CAAC;AAgM3C,eAAO,MAAM,qBAAqB,EAAE,MAAM,CAAC,eAAe,EAAE,aAAa,CAKxE,CAAC;AAEF,gGAAgG;AAChG,wBAAsB,aAAa,CACjC,GAAG,EAAE,cAAc,EACnB,OAAO,EAAE,YAAY,EACrB,SAAS,GAAE,MAAM,CAAC,eAAe,EAAE,aAAa,CAAyB,GACxE,OAAO,CAAC,OAAO,EAAE,CAAC,CA6BpB"}

package/dist/render/assets.js

@@ -0,0 +1,232 @@
+import { createHash } from "node:crypto";
+import { mkdir, readFile, stat, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+import { ensureInside, resolveInside } from "../storage.js";
+import { ChartError, chartStyleFor, prepareChart, renderPreparedChart } from "./charts.js";
+import { allSections, walkBlocks } from "./walk.js";
+const limits = {
+    mermaid: 100 * 1024,
+    svg: 5 * 1024 * 1024,
+    raster: 20 * 1024 * 1024,
+    chart: 1024 * 1024,
+};
+const sha256 = (data) => createHash("sha256").update(data).digest("hex");
+async function readGuarded(asset, context) {
+    let absolute;
+    try {
+        absolute = resolveInside(context.root, asset.path);
+        await ensureInside(context.root, absolute);
+    }
+    catch {
+        return { error: `Figure path ${asset.path} is outside the thesis folder` };
+    }
+    try {
+        const info = await stat(absolute);
+        if (!info.isFile())
+            return { error: `Figure ${asset.path} is not a file` };
+        if (info.size > limits[asset.kind]) {
+            return {
+                error: `Figure ${asset.path} is larger than ${Math.round(limits[asset.kind] / 1024)} KB`,
+            };
+        }
+        return { bytes: await readFile(absolute) };
+    }
+    catch (error) {
+        if (error.code === "ENOENT") {
+            return { error: `Figure file ${asset.path} does not exist` };
+        }
+        throw error;
+    }
+}
+async function materialize(context, name, data) {
+    const relative = `figures/${name}`;
+    const target = join(context.buildDir, relative);
+    await mkdir(join(context.buildDir, "figures"), { recursive: true, mode: 0o700 });
+    // Content-addressed names make an existing file already correct: this is the asset cache.
+    try {
+        await stat(target);
+        return relative;
+    }
+    catch (error) {
+        if (error.code !== "ENOENT")
+            throw error;
+    }
+    await writeFile(target, data, { mode: 0o600 });
+    return relative;
+}
+const isFailure = (value) => typeof value === "object" && value !== null && "error" in value;
+const mermaid = async (asset, context) => {
+    const read = await readGuarded(asset, context);
+    if (isFailure(read))
+        return read;
+    const text = read.bytes.toString("utf8");
+    if (text.trim() === "" || text.includes("\0"))
+        return { error: `Diagram ${asset.path} is empty or binary` };
+    const hash = sha256(read.bytes);
+    const file = await materialize(context, `${hash.slice(0, 16)}.mmd`, read.bytes);
+    return { file, sha256: hash, bytes: read.bytes.length, format: "mmd", text };
+};
+/** Natural size of an SVG in points (96 user units per inch), when its root declares plain numbers. */
+function svgSize(text) {
+    const root = /<svg\b[^>]*>/i.exec(text)?.[0];
+    if (!root)
+        return undefined;
+    const read = (name) => {
+        const match = new RegExp(`\\s${name}\\s*=\\s*["']([0-9.]+)(?:px)?["']`, "i").exec(root);
+        return match ? Number(match[1]) : undefined;
+    };
+    const width = read("width");
+    const height = read("height");
+    if (!width || !height || !Number.isFinite(width) || !Number.isFinite(height))
+        return undefined;
+    return { widthPt: Math.round(width * 75) / 100, heightPt: Math.round(height * 75) / 100 };
+}
+/** Why an SVG text is unsafe for embedding, or undefined when it is fine. */
+function svgProblem(text) {
+    if (!/<svg[\s>]/.test(text))
+        return "not an SVG document";
+    if (/<!DOCTYPE|<!ENTITY/i.test(text))
+        return "declares a DOCTYPE or entity";
+    if (/<script|<foreignObject|javascript:/i.test(text))
+        return "contains scripts or foreign content";
+    for (const match of text.matchAll(/(?:xlink:)?href\s*=\s*["']([^"']*)["']/gi)) {
+        const target = match[1] ?? "";
+        if (!target.startsWith("#") && !/^data:image\/(?:png|jpe?g|svg\+xml);/i.test(target)) {
+            return "references an external resource";
+        }
+    }
+    return undefined;
+}
+const svg = async (asset, context) => {
+    const read = await readGuarded(asset, context);
+    if (isFailure(read))
+        return read;
+    const text = read.bytes.toString("utf8");
+    const problem = svgProblem(text);
+    if (problem === "not an SVG document")
+        return { error: `${asset.path} is not an SVG document` };
+    if (problem === "declares a DOCTYPE or entity")
+        return {
+            error: `${asset.path} declares a DOCTYPE or entity`,
+            hint: "Remove the DTD from the SVG.",
+        };
+    if (problem === "contains scripts or foreign content")
+        return { error: `${asset.path} contains scripts or foreign content` };
+    if (problem)
+        return {
+            error: `${asset.path} references an external resource`,
+            hint: "Embed images as data URIs.",
+        };
+    const hash = sha256(read.bytes);
+    const file = await materialize(context, `${hash.slice(0, 16)}.svg`, read.bytes);
+    const size = svgSize(text);
+    return { file, sha256: hash, bytes: read.bytes.length, format: "svg", ...(size ? { size } : {}) };
+};
+const raster = async (asset, context) => {
+    const read = await readGuarded(asset, context);
+    if (isFailure(read))
+        return read;
+    const { bytes } = read;
+    const png = bytes.length > 8 &&
+        bytes.subarray(0, 8).equals(Buffer.from([0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a]));
+    const jpg = bytes.length > 3 && bytes[0] === 0xff && bytes[1] === 0xd8 && bytes[2] === 0xff;
+    if (!png && !jpg)
+        return { error: `${asset.path} is not a PNG or JPEG image` };
+    const format = png ? "png" : "jpg";
+    const hash = sha256(bytes);
+    const file = await materialize(context, `${hash.slice(0, 16)}.${format}`, bytes);
+    return { file, sha256: hash, bytes: bytes.length, format };
+};
+/** Vega-Lite chart: validated, rendered to SVG with the palette/font profile and cached by hash. */
+const chart = async (asset, context) => {
+    const read = await readGuarded(asset, context);
+    if (isFailure(read))
+        return { ...read, code: "FIG-001" };
+    const style = chartStyleFor(context.meta ?? { palette: "okabe-ito", fontProfile: "serif", bodyFont: null });
+    try {
+        const input = {
+            specText: read.bytes.toString("utf8"),
+            dataDir: join(context.root, "data"),
+            style,
+        };
+        const { spec, key } = await prepareChart(input);
+        const cached = join(context.cacheDir, "charts", `${key}.svg`);
+        let svg;
+        try {
+            svg = await readFile(cached, "utf8");
+        }
+        catch (error) {
+            if (error.code !== "ENOENT")
+                throw error;
+        }
+        if (svg === undefined) {
+            svg = await renderPreparedChart(spec);
+            await mkdir(join(context.cacheDir, "charts"), { recursive: true, mode: 0o700 });
+            await writeFile(cached, svg, { mode: 0o600 });
+        }
+        const unsafe = svgProblem(svg);
+        if (unsafe)
+            return { error: `Chart ${asset.path} produced an unsafe SVG: ${unsafe}`, code: "FIG-002" };
+        const hash = sha256(svg);
+        const file = await materialize(context, `${hash.slice(0, 16)}.svg`, svg);
+        const size = svgSize(svg);
+        return {
+            file,
+            sha256: hash,
+            bytes: Buffer.byteLength(svg),
+            format: "svg",
+            ...(size ? { size } : {}),
+        };
+    }
+    catch (error) {
+        if (error instanceof ChartError) {
+            return {
+                error: `${asset.path}: ${error.message}`,
+                ...(error.hint ? { hint: error.hint } : {}),
+                code: error.code,
+            };
+        }
+        throw error;
+    }
+};
+export const defaultAssetResolvers = {
+    mermaid,
+    svg,
+    raster,
+    chart,
+};
+/** Resolve every figure asset of a document in place; returns BLD-002 findings for failures. */
+export async function resolveAssets(doc, context, resolvers = defaultAssetResolvers) {
+    const findings = [];
+    const done = new Map();
+    for (const section of allSections(doc)) {
+        const figures = [];
+        walkBlocks(section.blocks, (block) => {
+            if (block.kind === "figure")
+                figures.push({ asset: block.asset, line: block.line });
+        });
+        for (const { asset, line } of figures) {
+            const key = `${asset.kind}:${asset.path}`;
+            let result = done.get(key);
+            if (!result) {
+                result = await resolvers[asset.kind](asset, context);
+                done.set(key, result);
+            }
+            if (isFailure(result)) {
+                findings.push({
+                    code: result.code ?? "BLD-002",
+                    gate: "G8",
+                    severity: "error",
+                    file: section.path,
+                    ...(line === undefined ? {} : { line }),
+                    message: result.error,
+                    ...(result.hint ? { hint: result.hint } : {}),
+                });
+            }
+            else
+                asset.resolved = result;
+        }
+    }
+    return findings;
+}
+//# sourceMappingURL=assets.js.map

package/dist/render/assets.js.map

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

package/dist/render/build.d.ts

@@ -0,0 +1,43 @@
+import type { Finding, SectionState } from "../types.js";
+import type { BuildScope } from "./model.js";
+import type { RendererRegistry } from "./registry.js";
+export interface BuildRequest {
+    /** Absolute thesis root (the folder with thesis.yaml). */
+    root: string;
+    scope: BuildScope;
+    section?: string;
+    pdfa?: boolean;
+    /** Output format; `pdf` is the only one with a shipped adapter. */
+    format?: string;
+    /** Section states from state.json, for the `approved` scope. */
+    sections?: Record<string, SectionState>;
+    env: NodeJS.ProcessEnv;
+    cacheRoot: string;
+    registry?: RendererRegistry;
+    packsRoot?: string;
+    now?: () => Date;
+    signal?: AbortSignal;
+    progress?: (note: string) => void;
+}
+export interface BuildOutcome {
+    ok: boolean;
+    scope: BuildScope;
+    /** Absolute output path when a file was produced. */
+    path?: string;
+    engine: string;
+    pages?: number;
+    ms: number;
+    findings: Finding[];
+    warnings: string[];
+    unrepresented: {
+        construct: string;
+        count: number;
+        note?: string;
+    }[];
+}
+/**
+ * Assemble the neutral document, materialize its assets and hand it to a renderer. Everything
+ * before the renderer call is format-neutral. Writes `build/build-report.json` for BLD-001.
+ */
+export declare function buildThesis(request: BuildRequest): Promise<BuildOutcome>;
+//# sourceMappingURL=build.d.ts.map