@alisio/plugin-thesis 0.1.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../src/render/build.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAIzD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEtD,MAAM,WAAW,YAAY;IAC3B,0DAA0D;IAC1D,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,UAAU,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,mEAAmE;IACnE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gEAAgE;IAChE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACxC,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;IACjB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACnC;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,OAAO,CAAC;IACZ,KAAK,EAAE,UAAU,CAAC;IAClB,qDAAqD;IACrD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,aAAa,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CACtE;AAID;;;GAGG;AACH,wBAAsB,WAAW,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC,CAgN9E"}

package/dist/render/build.js

@@ -0,0 +1,187 @@
+import { mkdir } from "node:fs/promises";
+import { join } from "node:path";
+import { modelFindings } from "../checks/document.js";
+import { loadProject } from "../checks/project.js";
+import { styleFindings } from "../checks/styles.js";
+import { atomicWrite, canonicalJson } from "../storage.js";
+import { styleFixtureFindings } from "../styles/golden.js";
+import { assembleDocument } from "./assemble.js";
+import { resolveAssets } from "./assets.js";
+import { createDefaultRegistry } from "./default-registry.js";
+const blocking = (finding) => finding.severity === "error";
+/**
+ * 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 async function buildThesis(request) {
+    const started = Date.now();
+    const registry = request.registry ?? createDefaultRegistry();
+    const format = request.format ?? "pdf";
+    const finish = async (partial) => {
+        const outcome = {
+            scope: request.scope,
+            ms: Date.now() - started,
+            unrepresented: [],
+            warnings: [],
+            ...partial,
+        };
+        outcome.warnings = outcome.findings
+            .filter((f) => f.severity !== "error")
+            .map((f) => `${f.code} ${f.message}`);
+        const errors = outcome.findings.filter(blocking).length;
+        try {
+            await atomicWrite(join(request.root, "build", "build-report.json"), canonicalJson({
+                at: (request.now ?? (() => new Date()))().toISOString(),
+                scope: request.scope,
+                ...(request.section ? { section: request.section } : {}),
+                ok: outcome.ok,
+                errors,
+                warnings: outcome.warnings.length,
+                engine: outcome.engine,
+                ...(outcome.pages === undefined ? {} : { pages: outcome.pages }),
+                findings: outcome.findings.slice(0, 50),
+            }));
+        }
+        catch {
+            // The report is advisory; a read-only workspace must not hide the build result.
+        }
+        return outcome;
+    };
+    const failure = (message, hint, code = "BLD-001") => finish({
+        ok: false,
+        engine: "none",
+        findings: [{ code, gate: "G8", severity: "error", message, ...(hint ? { hint } : {}) }],
+    });
+    if (request.scope === "section" && !request.section) {
+        return failure("Section scope needs a section id such as SEC-03");
+    }
+    const formatRenderers = registry.byFormat(format);
+    if (formatRenderers.length === 0) {
+        return failure(`No renderer is available for the "${format}" format in this release`);
+    }
+    // PDF/A is an archival profile only some engines can write.
+    const candidates = formatRenderers.filter((candidate) => !request.pdfa || candidate.capabilities().pdfa);
+    if (candidates.length === 0) {
+        return failure(`No ${format} renderer can write PDF/A`, "Run /thesis:setup to install the pinned Typst.");
+    }
+    request.progress?.("loading the thesis");
+    const project = await loadProject(request.root, {
+        ...(request.packsRoot ? { packsRoot: request.packsRoot } : {}),
+        ...(request.sections ? { sections: request.sections } : {}),
+        ...(request.now ? { now: request.now() } : {}),
+    });
+    const assembled = assembleDocument(project, {
+        scope: request.scope,
+        ...(request.section ? { section: request.section } : {}),
+        ...(request.sections ? { sections: request.sections } : {}),
+    });
+    if (!assembled) {
+        return failure("thesis.yaml has errors; run /thesis:check and fix them first", undefined, "BRF-001");
+    }
+    const { document } = assembled;
+    const findings = [...assembled.findings];
+    if (request.scope === "section" && document.body.length === 0) {
+        return failure(`No chapter file declares section ${request.section}`, "Add `section: SEC-xx` to the chapter's front matter.");
+    }
+    // Notes about the selected citation style; CSL-001 and PRF-001 errors came from the assembly.
+    findings.push(...styleFindings(project, "selected").filter((finding) => finding.code === "CSL-020" || finding.code === "CSL-021"));
+    // Cross-references and math are checked on the model; a partial scope degrades references first.
+    findings.push(...modelFindings(document).filter((finding) => finding.code !== "XRF-002"));
+    if (findings.some(blocking)) {
+        return finish({ ok: false, engine: "none", findings });
+    }
+    // Engine order (spec 10.6): the first available renderer of the format wins; a later one is a
+    // fallback and its differences are reported.
+    const environment = { env: request.env, cacheRoot: request.cacheRoot, root: request.root };
+    const skipped = [];
+    let renderer;
+    for (const candidate of candidates) {
+        const availability = await candidate.available(environment);
+        if (availability.available) {
+            renderer = candidate;
+            break;
+        }
+        skipped.push({
+            renderer: candidate,
+            reason: availability.reason,
+            ...(availability.hint ? { hint: availability.hint } : {}),
+        });
+    }
+    if (!renderer) {
+        const first = skipped[0];
+        const message = skipped.length === 1
+            ? first.reason
+            : `No ${format.toUpperCase()} engine is available. ${skipped
+                .map((entry) => `${entry.renderer.id}: ${entry.reason}`)
+                .join(". ")}`;
+        const hint = skipped.length === 1
+            ? first.hint
+            : "Run /thesis:setup to install the pinned Typst, or install Google Chrome or Chromium for the fallback.";
+        return finish({
+            ok: false,
+            engine: "none",
+            findings: [
+                ...findings,
+                {
+                    code: "BLD-001",
+                    gate: "G8",
+                    severity: "error",
+                    message,
+                    ...(hint ? { hint } : {}),
+                },
+            ],
+        });
+    }
+    if (skipped.length > 0) {
+        findings.push({
+            code: "BLD-004",
+            gate: "G8",
+            severity: "warning",
+            message: `Using the ${renderer.id} fallback because ${skipped[0].renderer.id} is unavailable (${skipped[0].reason}); the page layout differs from the Typst output`,
+            hint: "Run /thesis:setup to install the pinned Typst for the reference layout.",
+        });
+    }
+    // CSL-010: a selected workspace style must still render its approved fixtures.
+    if (document.bibliography.csl.source === "workspace") {
+        findings.push(...(await styleFixtureFindings(project, {
+            env: request.env,
+            cacheRoot: request.cacheRoot,
+            only: document.bibliography.csl.id,
+        })).filter((finding) => finding.severity === "error"));
+        if (findings.some(blocking))
+            return finish({ ok: false, engine: "none", findings });
+    }
+    const buildDir = join(request.root, "build");
+    await mkdir(join(buildDir, "cache"), { recursive: true, mode: 0o700 });
+    request.progress?.("preparing figures");
+    findings.push(...(await resolveAssets(document, {
+        root: request.root,
+        buildDir,
+        cacheDir: join(buildDir, "cache"),
+        meta: document.meta,
+    })));
+    if (findings.some(blocking))
+        return finish({ ok: false, engine: "none", findings });
+    request.progress?.(`rendering with ${renderer.id}`);
+    const result = await renderer.render(document, {
+        scope: request.scope,
+        ...(request.section ? { section: request.section } : {}),
+        ...(request.pdfa ? { pdfa: true } : {}),
+    }, {
+        env: request.env,
+        cacheRoot: request.cacheRoot,
+        root: request.root,
+        buildDir,
+        ...(request.signal ? { signal: request.signal } : {}),
+        ...(request.progress ? { progress: request.progress } : {}),
+    });
+    return finish({
+        ok: result.ok,
+        engine: result.engine,
+        ...(result.output ? { path: join(buildDir, result.output) } : {}),
+        ...(result.pages === undefined ? {} : { pages: result.pages }),
+        findings: [...findings, ...result.findings],
+        unrepresented: result.unrepresented,
+    });
+}
+//# sourceMappingURL=build.js.map

package/dist/render/build.js.map

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

package/dist/render/charts.d.ts

@@ -0,0 +1,83 @@
+import type { ResolvedMeta } from "./model.js";
+import { type Palette } from "./palettes.js";
+/**
+ * Vega-Lite to SVG (spec 10.5, 12 and 16.1 P0.4). The service is format neutral: it produces an SVG
+ * from a `.vl.json` spec, the data files under `data/` and the palette/font profile. Safety rules:
+ *
+ * - the plugin reads the data itself (realpath containment, no schemes, no `..`) and inlines it as
+ *   `data.values`; Vega never loads anything (its loader refuses every request);
+ * - CSV is parsed with `csvParseRows` (no code generation); Vega runs with `ast: true` and the
+ *   `vega-interpreter` expression evaluator, so no `Function`/`eval` is ever needed;
+ * - any warning or error logged by Vega-Lite or Vega fails the render;
+ * - specs with `image` marks, `href`/`url` fields or non-plain `data.url` are rejected, and a spec
+ *   that sets colors or fonts is rejected: the plugin injects the styling.
+ */
+export declare const chartEngineTag = "vega@6.4.0+vega-lite@6.4.3+vega-interpreter@2.3.2";
+export type ChartCode = "FIG-001" | "FIG-002" | "FIG-003";
+export interface ChartIssue {
+    code: ChartCode;
+    message: string;
+    hint?: string;
+}
+export interface ChartCheck {
+    issues: ChartIssue[];
+    /** The parsed spec when it is JSON. */
+    spec?: Record<string, unknown>;
+    /** Data file relative to `data/`, when the spec declares a valid `data.url`. */
+    dataFile?: string;
+}
+export declare const defaultChartSize: {
+    width: number;
+    height: number;
+};
+/** Normalize a declared `data.url` to a path relative to `data/`; undefined when it is not plain. */
+export declare function normalizeDataUrl(url: unknown): string | undefined;
+/**
+ * Validate a chart spec against the supported Vega-Lite subset (FIG-001), the forbidden fields
+ * (FIG-002) and the styling ban (FIG-003). Pure: pass the files found under `data/` to also check
+ * that the declared data file exists.
+ */
+export declare function checkChartSpec(text: string, options?: {
+    dataFiles?: ReadonlySet<string>;
+}): ChartCheck;
+export interface ChartStyle {
+    palette: Palette;
+    /** CSS font-family list used inside the SVG. */
+    fontFamily: string;
+}
+export declare function chartStyleFor(meta: Pick<ResolvedMeta, "palette" | "fontProfile" | "bodyFont">): ChartStyle;
+/** The Vega-Lite `config` injected into every chart (spec 10.5). */
+export declare function chartConfig(style: ChartStyle): Record<string, unknown>;
+/** Resolve `data.url` under the data directory, following symlinks and refusing escapes. */
+export declare function resolveDataFile(dataDir: string, relative: string): Promise<string>;
+/** CSV to records. Columns whose every value is a plain number become numbers. */
+export declare function csvToValues(text: string): Record<string, unknown>[];
+export declare class ChartError extends Error {
+    readonly code: ChartCode;
+    readonly hint?: string | undefined;
+    constructor(code: ChartCode, message: string, hint?: string | undefined);
+}
+export interface ChartInput {
+    /** Raw text of the `.vl.json` file. */
+    specText: string;
+    /** Absolute `data/` directory of the thesis. */
+    dataDir: string;
+    style: ChartStyle;
+}
+export interface ChartResult {
+    svg: string;
+    /** SHA-256 over spec, data and config: the cache key. */
+    key: string;
+}
+/** The inputs of a chart in canonical form, and the cache key derived from them. */
+export declare function prepareChart(input: ChartInput): Promise<{
+    spec: Record<string, unknown>;
+    key: string;
+}>;
+/** Render a prepared spec to SVG with the interpreter, the deny-all loader and a fatal logger. */
+export declare function renderPreparedChart(spec: Record<string, unknown>): Promise<string>;
+/** Cache directory for rendered chart SVGs. */
+export declare const chartCacheDir: (cacheDir: string) => string;
+/** Render a chart, reading and writing the SHA-256 keyed cache when a cache directory is given. */
+export declare function renderChart(input: ChartInput, cacheDir?: string): Promise<ChartResult>;
+//# sourceMappingURL=charts.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"charts.d.ts","sourceRoot":"","sources":["../../src/render/charts.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAe,KAAK,OAAO,EAAE,MAAM,eAAe,CAAC;AAE1D;;;;;;;;;;;GAWG;AAEH,eAAO,MAAM,cAAc,sDAAsD,CAAC;AAElF,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;AAE1D,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,SAAS,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,uCAAuC;IACvC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,gFAAgF;IAChF,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAwCD,eAAO,MAAM,gBAAgB;IAAK,KAAK;IAAO,MAAM;CAAO,CAAC;AAa5D,qGAAqG;AACrG,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CASjE;AAmFD;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE;IAAE,SAAS,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;CAAO,GAChD,UAAU,CAgMZ;AAMD,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,gDAAgD;IAChD,UAAU,EAAE,MAAM,CAAC;CACpB;AAQD,wBAAgB,aAAa,CAC3B,IAAI,EAAE,IAAI,CAAC,YAAY,EAAE,SAAS,GAAG,aAAa,GAAG,UAAU,CAAC,GAC/D,UAAU,CAMZ;AAKD,oEAAoE;AACpE,wBAAgB,WAAW,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAiDtE;AAMD,4FAA4F;AAC5F,wBAAsB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAmBxF;AAID,kFAAkF;AAClF,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CA6BnE;AAED,qBAAa,UAAW,SAAQ,KAAK;IAEjC,QAAQ,CAAC,IAAI,EAAE,SAAS;IAExB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM;IAHxB,YACW,IAAI,EAAE,SAAS,EACxB,OAAO,EAAE,MAAM,EACN,IAAI,CAAC,EAAE,MAAM,YAAA,EAGvB;CACF;AAiDD,MAAM,WAAW,UAAU;IACzB,uCAAuC;IACvC,QAAQ,EAAE,MAAM,CAAC;IACjB,gDAAgD;IAChD,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,UAAU,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,yDAAyD;IACzD,GAAG,EAAE,MAAM,CAAC;CACb;AAED,oFAAoF;AACpF,wBAAsB,YAAY,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC;IAC7D,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,GAAG,EAAE,MAAM,CAAC;CACb,CAAC,CAuDD;AAED,kGAAkG;AAClG,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAuCxF;AAED,+CAA+C;AAC/C,eAAO,MAAM,aAAa,aAAc,MAAM,KAAG,MAAkC,CAAC;AAEpF,mGAAmG;AACnG,wBAAsB,WAAW,CAAC,KAAK,EAAE,UAAU,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAgB5F"}