gutterpress 0.11.17-alpha.3 → 0.11.17-alpha.4

package/dist/{index-bscfmg5r.js → index-gp503ze9.js}

@@ -1,3 +1,6 @@
+import {
+  blackTextToGray
+} from "./index-ht1bcqdd.js";
 import {
   BuildError,
   EXIT_CODES,
@@ -5671,7 +5674,7 @@ import git from "isomorphic-git";
 // package.json
 var package_default = {
   name: "gutterpress",
-  version: "0.11.17-alpha.3",
+  version: "0.11.17-alpha.4",
   description: "Markdown-to-PDF converter for professional print layout using a native Chromium print engine and Ghostscript.",
   author: "itlackey",
   license: "MPL-2.0",
@@ -5938,417 +5941,6 @@ async function writeBuildFingerprint(input) {
   return outPath;
 }
 
-// src/lib/black-text-gray.ts
-var MAX_CHANNEL = 0.12;
-var MAX_SPREAD = 0.04;
-function isNearBlack([r, g, b]) {
-  const max = Math.max(r, g, b);
-  return max <= MAX_CHANNEL && max - Math.min(r, g, b) <= MAX_SPREAD;
-}
-var WS = new Set([0, 9, 10, 12, 13, 32]);
-var DELIM = new Set("()<>[]{}/%".split("").map((c) => c.charCodeAt(0)));
-function* tokenize(s) {
-  let i = 0;
-  const n = s.length;
-  while (i < n) {
-    const c = s.charCodeAt(i);
-    if (WS.has(c)) {
-      i++;
-      continue;
-    }
-    const start = i;
-    if (c === 37) {
-      while (i < n && s[i] !== `
-` && s[i] !== "\r")
-        i++;
-      continue;
-    }
-    if (c === 40) {
-      let depth = 0;
-      while (i < n) {
-        const d = s[i++];
-        if (d === "\\")
-          i++;
-        else if (d === "(")
-          depth++;
-        else if (d === ")" && --depth === 0)
-          break;
-      }
-      yield { text: s.slice(start, i), start, end: i, op: false };
-      continue;
-    }
-    if (c === 60 && s[i + 1] === "<") {
-      i += 2;
-      yield { text: "<<", start, end: i, op: false };
-      continue;
-    }
-    if (c === 62 && s[i + 1] === ">") {
-      i += 2;
-      yield { text: ">>", start, end: i, op: false };
-      continue;
-    }
-    if (c === 60) {
-      while (i < n && s[i] !== ">")
-        i++;
-      i++;
-      yield { text: s.slice(start, i), start, end: i, op: false };
-      continue;
-    }
-    if (c === 91 || c === 93 || c === 62 || c === 123 || c === 125 || c === 41) {
-      i++;
-      yield { text: s[start], start, end: i, op: false };
-      continue;
-    }
-    i++;
-    while (i < n && !WS.has(s.charCodeAt(i)) && !DELIM.has(s.charCodeAt(i)))
-      i++;
-    const text = s.slice(start, i);
-    const isOperand = c === 47 || /^[+-]?(\d+\.?\d*|\.\d+)$/.test(text);
-    yield { text, start, end: i, op: !isOperand };
-    if (text === "ID") {
-      const m = /\sEI(?=\s|$)/g;
-      m.lastIndex = i;
-      const hit = m.exec(s);
-      i = hit ? hit.index + hit[0].length : n;
-    }
-  }
-}
-var LARGE_TEXT_PT = 24;
-var SIZE_EPS = 0.05;
-var area = (m) => Math.sqrt(Math.abs(m[0] * m[3] - m[1] * m[2]));
-
-class TextScale {
-  ctm;
-  font = 0;
-  tm = 1;
-  stack = [];
-  constructor(ctm) {
-    this.ctm = ctm;
-  }
-  get unit() {
-    return this.ctm;
-  }
-  get size() {
-    return this.font * this.tm * this.ctm;
-  }
-  op(op, nums) {
-    switch (op) {
-      case "q":
-        this.stack.push([this.ctm, this.font]);
-        return false;
-      case "Q": {
-        const p = this.stack.pop();
-        if (p)
-          [this.ctm, this.font] = p;
-        return true;
-      }
-      case "cm":
-        if (nums.length === 6)
-          this.ctm *= area(nums);
-        return true;
-      case "BT":
-        this.tm = 1;
-        return true;
-      case "Tm":
-        if (nums.length === 6)
-          this.tm = area(nums);
-        return true;
-      case "Tf":
-        this.font = Math.abs(nums[nums.length - 1] ?? 0) || 0;
-        return true;
-    }
-    return false;
-  }
-}
-function rewriteBlackText(src, ctx = {}) {
-  let fill = null;
-  let stroke = null;
-  const stack = [];
-  const scale = new TextScale(ctx.baseScale ?? 1);
-  let inText = false;
-  let fillDirty = false;
-  let strokeDirty = false;
-  const spans = [];
-  let lastOp = "";
-  let rect = null;
-  const edits = [];
-  let operands = [];
-  const rgbOf = () => {
-    if (operands.length !== 3)
-      return null;
-    const v = operands.map((t) => Number(t.text));
-    return v.some((x) => Number.isNaN(x)) ? null : { rgb: v, raw: operands.map((t) => t.text).join(" ") };
-  };
-  const isSmall = () => scale.size <= LARGE_TEXT_PT + SIZE_EPS;
-  let fillIns = null;
-  let strokeIns = null;
-  const syncOne = (colour, dirty, ins, at, gray, op) => {
-    if (!colour || !isNearBlack(colour.rgb))
-      return [dirty, ins];
-    const small = isSmall();
-    if (small && !dirty) {
-      const e = { start: at, end: at, text: ` ${gray}` };
-      edits.push(e);
-      return [true, e];
-    }
-    if (!small && dirty) {
-      if (ins)
-        ins.text = "";
-      else
-        edits.push({ start: at, end: at, text: ` ${colour.raw} ${op}` });
-      return [false, null];
-    }
-    return [dirty, ins];
-  };
-  const sync = (at) => {
-    [fillDirty, fillIns] = syncOne(fill, fillDirty, fillIns, at, "0 g", "rg");
-    [strokeDirty, strokeIns] = syncOne(stroke, strokeDirty, strokeIns, at, "0 G", "RG");
-  };
-  const flush = (s) => {
-    for (const r of s.rects) {
-      if (r.thickness > 0.2 * s.maxSmall)
-        continue;
-      edits.push({ start: r.start, end: r.start, text: "q 0 g " }, { start: r.end, end: r.end, text: " Q" });
-    }
-  };
-  for (const t of tokenize(src)) {
-    if (!t.op) {
-      operands.push(t);
-      continue;
-    }
-    const op = t.text;
-    const nums = operands.map((o) => Number(o.text));
-    const sizeMayHaveChanged = scale.op(op, nums);
-    switch (op) {
-      case "q":
-        stack.push([fill, stroke]);
-        break;
-      case "Q": {
-        const p = stack.pop();
-        if (p)
-          [fill, stroke] = p;
-        break;
-      }
-      case "BT":
-        inText = true;
-        fillDirty = strokeDirty = false;
-        fillIns = strokeIns = null;
-        sync(t.end);
-        break;
-      case "Tf":
-      case "Tm":
-        if (inText && sizeMayHaveChanged)
-          sync(t.end);
-        break;
-      case "ET":
-        if (inText) {
-          let ins = "";
-          if (fillDirty && fill)
-            ins += `${fill.raw} rg `;
-          if (strokeDirty && stroke)
-            ins += `${stroke.raw} RG `;
-          if (ins)
-            edits.push({ start: t.start, end: t.start, text: ins });
-        }
-        inText = false;
-        fillIns = strokeIns = null;
-        break;
-      case "rg":
-      case "RG": {
-        const c = rgbOf();
-        const isFill = op === "rg";
-        if (isFill)
-          fill = c;
-        else
-          stroke = c;
-        if (inText && c && isNearBlack(c.rgb) && isSmall()) {
-          edits.push({ start: operands[0].start, end: t.end, text: isFill ? "0 g" : "0 G" });
-          if (isFill)
-            fillDirty = true;
-          else
-            strokeDirty = true;
-        } else if (inText) {
-          if (isFill)
-            fillDirty = false;
-          else
-            strokeDirty = false;
-        }
-        break;
-      }
-      case "g":
-      case "k":
-      case "sc":
-      case "scn":
-      case "cs":
-        fill = null;
-        if (inText)
-          fillDirty = false;
-        break;
-      case "G":
-      case "K":
-      case "SC":
-      case "SCN":
-      case "CS":
-        stroke = null;
-        if (inText)
-          strokeDirty = false;
-        break;
-      case "Do": {
-        const name = operands[operands.length - 1]?.text;
-        if (name?.startsWith("/"))
-          ctx.onDo?.(name.slice(1), scale.unit);
-        break;
-      }
-      case "BDC":
-      case "BMC":
-        spans.push({ hasSmall: false, maxSmall: 0, rects: [] });
-        break;
-      case "EMC": {
-        const s = spans.pop();
-        if (!s)
-          break;
-        const parent = spans[spans.length - 1];
-        if (s.hasSmall)
-          flush(s);
-        else
-          parent?.rects.push(...s.rects);
-        if (parent && s.hasSmall) {
-          parent.hasSmall = true;
-          parent.maxSmall = Math.max(parent.maxSmall, s.maxSmall);
-        }
-        break;
-      }
-      case "Tj":
-      case "TJ":
-      case "'":
-      case '"': {
-        fillIns = strokeIns = null;
-        const span = spans[spans.length - 1];
-        if (span && inText && isSmall()) {
-          span.hasSmall = true;
-          span.maxSmall = Math.max(span.maxSmall, scale.size);
-        }
-        break;
-      }
-      case "re":
-        rect = !inText && fill && isNearBlack(fill.rgb) && operands.length === 4 && nums.every((x) => !Number.isNaN(x)) ? { start: operands[0].start, thickness: Math.min(Math.abs(nums[2]), Math.abs(nums[3])) * scale.unit } : null;
-        break;
-      case "f":
-      case "F":
-      case "f*":
-        if (rect && lastOp === "re")
-          spans[spans.length - 1]?.rects.push({ ...rect, end: t.end });
-        break;
-    }
-    lastOp = op;
-    operands = [];
-  }
-  return applyEdits(src, edits);
-}
-function applyEdits(s, edits) {
-  if (!edits.length)
-    return s;
-  edits.sort((a, b) => a.start - b.start);
-  let out = "";
-  let pos = 0;
-  for (const e of edits) {
-    out += s.slice(pos, e.start) + e.text;
-    pos = e.end;
-  }
-  return out + s.slice(pos);
-}
-async function visitContent(doc, visit) {
-  const { PDFName, PDFRawStream, PDFArray, PDFRef, PDFDict, decodePDFRawStream } = await import("pdf-lib");
-  const ctx = doc.context;
-  const SKIP = ["Filter", "DecodeParms", "Length"].map((k) => PDFName.of(k));
-  let changed = false;
-  const decode = (s) => {
-    try {
-      return Buffer.from(decodePDFRawStream(s).decode()).toString("latin1");
-    } catch {
-      return null;
-    }
-  };
-  const replace = (ref, old, text) => {
-    const entries = {};
-    for (const [k, v] of old.dict.entries())
-      if (!SKIP.includes(k))
-        entries[k.decodeText()] = v;
-    ctx.assign(ref, ctx.flateStream(Buffer.from(text, "latin1"), entries));
-    changed = true;
-  };
-  const formScale = new Map;
-  const formMatrixScale = (form) => {
-    const m = form.dict.lookupMaybe(PDFName.of("Matrix"), PDFArray);
-    const nums = m?.asArray().map((n) => Number(n.toString()));
-    return nums?.length === 6 && !nums.some(Number.isNaN) ? area(nums) : 1;
-  };
-  const pages = doc.getPages();
-  for (let p = 0;p < pages.length; p++) {
-    const page = pages[p];
-    const contents = page.node.Contents();
-    const refs = [];
-    if (contents instanceof PDFArray) {
-      for (let i = 0;i < contents.size(); i++) {
-        const r = contents.get(i);
-        if (r instanceof PDFRef)
-          refs.push(r);
-      }
-    } else if (contents instanceof PDFRawStream) {
-      const r = page.node.get(PDFName.of("Contents"));
-      if (r instanceof PDFRef)
-        refs.push(r);
-    }
-    const streams = refs.map((r) => ctx.lookup(r));
-    if (!refs.length || !streams.every((s) => s instanceof PDFRawStream))
-      continue;
-    const parts = streams.map((s) => decode(s));
-    if (parts.some((q) => q === null))
-      continue;
-    const joined = parts.join(`
-`);
-    const xobjects = page.node.Resources()?.lookupMaybe(PDFName.of("XObject"), PDFDict);
-    const next = visit(joined, {
-      baseScale: 1,
-      onDo: (name, scale) => {
-        const ref = xobjects?.get(PDFName.of(name));
-        const form = ref instanceof PDFRef ? ctx.lookup(ref) : undefined;
-        if (!(ref instanceof PDFRef) || !(form instanceof PDFRawStream))
-          return;
-        if (form.dict.get(PDFName.of("Subtype")) !== PDFName.of("Form"))
-          return;
-        const at = scale * formMatrixScale(form);
-        formScale.set(ref.tag, Math.min(formScale.get(ref.tag) ?? Infinity, at));
-      }
-    });
-    if (next === joined)
-      continue;
-    replace(refs[0], streams[0], next);
-    page.node.set(PDFName.of("Contents"), refs[0]);
-  }
-  for (const [ref, obj] of ctx.enumerateIndirectObjects()) {
-    if (!(obj instanceof PDFRawStream))
-      continue;
-    if (obj.dict.get(PDFName.of("Subtype")) !== PDFName.of("Form"))
-      continue;
-    const text = decode(obj);
-    if (text === null)
-      continue;
-    const next = visit(text, {
-      baseScale: formScale.get(ref.tag) ?? 0
-    });
-    if (next !== text)
-      replace(ref, obj, next);
-  }
-  return changed;
-}
-async function blackTextToGray(pdf) {
-  const { PDFDocument } = await import("pdf-lib");
-  const doc = await PDFDocument.load(pdf, { updateMetadata: false });
-  const changed = await visitContent(doc, (src, info2) => rewriteBlackText(src, info2));
-  return changed ? doc.save({ updateFieldAppearances: false }) : pdf;
-}
-
 // src/lib/validation-exec.ts
 import { existsSync as existsSync12 } from "node:fs";
 import { dirname as dirname4, join as join4, resolve as resolve8 } from "node:path";
@@ -7482,8 +7074,46 @@ var check8 = {
 };
 registerCheck(check8);
 
-// src/checks/pdf/signature.ts
+// src/checks/pdf/black-text.ts
+import { readFile as readFile15 } from "node:fs/promises";
 var check9 = {
+  id: "pdf.print.black-text",
+  name: "Black Text",
+  description: "Warns when text at or below 24pt is painted in a dark four-colour mix (black, or a near-black colour such as a dark brown)",
+  category: "pdf",
+  phase: "post-build",
+  enabledWhen: (config) => config.pdfx.blackText === "k-only",
+  async run(ctx) {
+    if (!ctx.pdfPath)
+      return [];
+    try {
+      const { findRichBlackText, LARGE_TEXT_PT } = await import("./black-text-gray-7dz61456.js");
+      const found = await findRichBlackText(await readFile15(ctx.pdfPath));
+      if (found.runs === 0)
+        return [];
+      return [
+        finding(check9.id, {
+          severity: "warning",
+          message: `Dark four-colour text at ${LARGE_TEXT_PT}pt or smaller on page(s) ${found.pages.join(", ")}.`,
+          file: ctx.pdfPath,
+          detail: "Small text printed with all four inks can look fuzzy if the plates are slightly out of register, which is why print vendors such as DriveThruRPG want small black text on the black plate alone. `pdfx.blackText: k-only` already does that for near-black text; this text is either a dark colour (for example a dark brown, which keeps its colour) or painted in a way the build cannot rewrite (an image or a pattern). To print it on the black plate, make the text black (#000). If the colour is intended, set `lint.rules: { pdf.print.black-text: off }` in manifest.yaml.",
+          code: "rich-black-text",
+          data: { runs: found.runs, pages: found.pages }
+        })
+      ];
+    } catch {
+      return [
+        inspectionFailed(check9.id, "Could not inspect the PDF's text colours.", {
+          file: ctx.pdfPath
+        })
+      ];
+    }
+  }
+};
+registerCheck(check9);
+
+// src/checks/pdf/signature.ts
+var check10 = {
   id: "pdf.print.signature",
   name: "Signature",
   description: "Fails when the interior's page count does not fit the print signature (a multiple of it ending on a blank page, or one short of a multiple)",
@@ -7495,7 +7125,7 @@ var check9 = {
       return [];
     const doc = await loadPdf(ctx.pdfPath);
     if (!doc) {
-      return [inspectionFailed(check9.id, "Could not parse the PDF's page count.", { file: ctx.pdfPath })];
+      return [inspectionFailed(check10.id, "Could not parse the PDF's page count.", { file: ctx.pdfPath })];
     }
     const size = ctx.config.print.signature;
     const pages = doc.numPages;
@@ -7504,7 +7134,7 @@ var check9 = {
     const data = { pages, signature: size };
     if (pages % size !== 0) {
       return [
-        finding(check9.id, {
+        finding(check10.id, {
           severity: "error",
           message: `Page count ${pages} does not fit a signature of ${size}: it must be a multiple of ${size}, or one short of one.`,
           file: ctx.pdfPath,
@@ -7520,10 +7150,10 @@ var check9 = {
       if (!await pageHasMarks(doc, pages))
         return [];
     } catch {
-      return [inspectionFailed(check9.id, "Could not read the last page.", { file: ctx.pdfPath })];
+      return [inspectionFailed(check10.id, "Could not read the last page.", { file: ctx.pdfPath })];
     }
     return [
-      finding(check9.id, {
+      finding(check10.id, {
         severity: "error",
         message: `The last page (${pages}) has content, but the printer needs it blank for its own information.`,
         file: ctx.pdfPath,
@@ -7534,10 +7164,10 @@ var check9 = {
     ];
   }
 };
-registerCheck(check9);
+registerCheck(check10);
 
 // src/checks/pdf/bookmarks.ts
-var check10 = {
+var check11 = {
   id: "pdf.nav.bookmarks",
   name: "Bookmarks",
   description: "Checks for PDF outline (bookmarks) tree",
@@ -7551,14 +7181,14 @@ var check10 = {
     const doc = await loadPdf(ctx.pdfPath);
     if (!doc) {
       return [
-        inspectionFailed(check10.id, "Could not inspect PDF for bookmarks.", {
+        inspectionFailed(check11.id, "Could not inspect PDF for bookmarks.", {
           file: ctx.pdfPath
         })
       ];
     }
     if (await getOutlineCount(doc) === 0) {
       return [
-        finding(check10.id, {
+        finding(check11.id, {
           severity: "warning",
           message: "PDF does not contain bookmarks (outline tree).",
           file: ctx.pdfPath
@@ -7568,10 +7198,10 @@ var check10 = {
     return [];
   }
 };
-registerCheck(check10);
+registerCheck(check11);
 
 // src/checks/pdf/toc-links.ts
-var check11 = {
+var check12 = {
   id: "pdf.nav.toc-links",
   name: "TOC Links",
   description: "Detects link annotations on TOC pages",
@@ -7586,7 +7216,7 @@ var check11 = {
     if (!doc) {
       return [
         {
-          checkId: check11.id,
+          checkId: check12.id,
           severity: "warning",
           message: "Could not inspect PDF for TOC links.",
           file: ctx.pdfPath
@@ -7597,7 +7227,7 @@ var check11 = {
     if (!hasLinks) {
       return [
         {
-          checkId: check11.id,
+          checkId: check12.id,
           severity: "warning",
           message: "No link annotations found in PDF (expected for TOC).",
           file: ctx.pdfPath
@@ -7607,10 +7237,10 @@ var check11 = {
     return [];
   }
 };
-registerCheck(check11);
+registerCheck(check12);
 
 // src/checks/pdf/cross-refs.ts
-var check12 = {
+var check13 = {
   id: "pdf.nav.cross-refs",
   name: "Cross References",
   description: "Counts and verifies internal link annotations",
@@ -7623,7 +7253,7 @@ var check12 = {
     if (!doc) {
       return [
         {
-          checkId: check12.id,
+          checkId: check13.id,
           severity: "info",
           message: "Could not inspect PDF for cross-references.",
           file: ctx.pdfPath
@@ -7633,7 +7263,7 @@ var check12 = {
     const linkCount = await countLinkAnnotations(doc);
     return [
       {
-        checkId: check12.id,
+        checkId: check13.id,
         severity: "info",
         message: `PDF contains ${linkCount} internal link annotation${linkCount !== 1 ? "s" : ""}.`,
         file: ctx.pdfPath
@@ -7641,10 +7271,10 @@ var check12 = {
     ];
   }
 };
-registerCheck(check12);
+registerCheck(check13);
 
 // src/checks/pdf/page-labels.ts
-var check13 = {
+var check14 = {
   id: "pdf.nav.page-labels",
   name: "Page Labels",
   description: "Verifies PDF page labels / folio numbering",
@@ -7659,7 +7289,7 @@ var check13 = {
     const labels = await getPageLabels(doc);
     return [
       {
-        checkId: check13.id,
+        checkId: check14.id,
         severity: "info",
         message: labels && labels.length > 0 ? "PDF contains page labels." : "PDF does not contain explicit page labels.",
         file: ctx.pdfPath
@@ -7667,10 +7297,10 @@ var check13 = {
     ];
   }
 };
-registerCheck(check13);
+registerCheck(check14);
 
 // src/checks/pdf/image-resolution.ts
-var check14 = {
+var check15 = {
   id: "pdf.print.image-resolution",
   name: "Image Resolution",
   description: "Checks DPI of images embedded in the PDF",
@@ -7697,7 +7327,7 @@ var check14 = {
       lowResPages.sort((a, b) => a - b);
       return [
         {
-          checkId: check14.id,
+          checkId: check15.id,
           severity: "warning",
           message: `Low-resolution images (below ${minDpi} DPI) found on pages: ${lowResPages.join(", ")}`,
           file: ctx.pdfPath
@@ -7707,10 +7337,10 @@ var check14 = {
     return [];
   }
 };
-registerCheck(check14);
+registerCheck(check15);
 
 // src/checks/pdf/transparency.ts
-var check15 = {
+var check16 = {
   id: "pdf.print.transparency",
   name: "Transparency",
   description: "Checks for transparency markers (/Transparency, /SMask, /BM) in the PDF",
@@ -7732,7 +7362,7 @@ var check15 = {
     if (found.length > 0) {
       return [
         {
-          checkId: check15.id,
+          checkId: check16.id,
           severity: "warning",
           message: `Transparency detected in PDF: ${found.join(", ")}. This may cause issues with some printers.`,
           file: ctx.pdfPath
@@ -7742,7 +7372,7 @@ var check15 = {
     return [];
   }
 };
-registerCheck(check15);
+registerCheck(check16);
 
 // src/checks/pdf/bleed.ts
 function findBox(bytes, box) {
@@ -7752,7 +7382,7 @@ function findBox(bytes, box) {
     return null;
   return [Number(m[1]), Number(m[2]), Number(m[3]), Number(m[4])];
 }
-var check16 = {
+var check17 = {
   id: "pdf.print.bleed",
   name: "Bleed Box",
   description: "Compares MediaBox vs TrimBox/BleedBox to verify bleed area",
@@ -7766,7 +7396,7 @@ var check16 = {
     const bytes = await readPdfBytes(ctx.pdfPath).catch(() => "");
     if (!bytes) {
       return [
-        inspectionFailed(check16.id, "Could not inspect PDF for bleed boxes.", {
+        inspectionFailed(check17.id, "Could not inspect PDF for bleed boxes.", {
           file: ctx.pdfPath
         })
       ];
@@ -7776,14 +7406,14 @@ var check16 = {
     const bleed = findBox(bytes, "BleedBox");
     if (!media) {
       return [
-        inspectionFailed(check16.id, "Could not parse MediaBox from PDF.", {
+        inspectionFailed(check17.id, "Could not parse MediaBox from PDF.", {
           file: ctx.pdfPath
         })
       ];
     }
     if (!trim && !bleed) {
       return [
-        finding(check16.id, {
+        finding(check17.id, {
           severity: "warning",
           message: "No TrimBox or BleedBox found. Bleed area cannot be verified.",
           file: ctx.pdfPath
@@ -7796,7 +7426,7 @@ var check16 = {
       const bleedSize = ctx.config.validate.pdf.bleedSize;
       if (mediaW - trimW < bleedSize * 2 * 0.9) {
         return [
-          finding(check16.id, {
+          finding(check17.id, {
             severity: "warning",
             message: `Bleed area appears insufficient. Expected at least ${bleedSize}pt on each side.`,
             file: ctx.pdfPath
@@ -7807,10 +7437,10 @@ var check16 = {
     return [];
   }
 };
-registerCheck(check16);
+registerCheck(check17);
 
 // src/checks/pdf/pdfx-metadata.ts
-var check17 = {
+var check18 = {
   id: "pdf.print.pdfx-metadata",
   name: "PDF/X Metadata",
   description: "Verifies PDF/X DOCINFO metadata via qpdf JSON",
@@ -7829,30 +7459,30 @@ var check17 = {
       const objects = parseQpdfObjectsJson(stdout);
       if (!objects) {
         return [
-          inspectionFailed(check17.id, "Unable to parse qpdf JSON output for PDF/X metadata checks.", { file: ctx.pdfPath })
+          inspectionFailed(check18.id, "Unable to parse qpdf JSON output for PDF/X metadata checks.", { file: ctx.pdfPath })
         ];
       }
-      return getPdfxMetadataIssues(objects, ctx.config.pdfx.flavor).map((message) => finding(check17.id, {
+      return getPdfxMetadataIssues(objects, ctx.config.pdfx.flavor).map((message) => finding(check18.id, {
         severity: "error",
         message,
         file: ctx.pdfPath
       }));
     } catch {
       return [
-        inspectionFailed(check17.id, "Failed to inspect PDF objects with qpdf for PDF/X metadata.", { file: ctx.pdfPath })
+        inspectionFailed(check18.id, "Failed to inspect PDF objects with qpdf for PDF/X metadata.", { file: ctx.pdfPath })
       ];
     }
   }
 };
-registerCheck(check17);
+registerCheck(check18);
 
 // src/checks/source/htmlhint.ts
 import { existsSync as existsSync9 } from "node:fs";
-import { readFile as readFile15 } from "node:fs/promises";
+import { readFile as readFile16 } from "node:fs/promises";
 import htmlhint from "htmlhint";
 var { HTMLHint } = htmlhint;
 var CONFIG_NAMES2 = [".htmlhintrc"];
-var check18 = {
+var check19 = {
   id: "source.htmlhint",
   name: "HTMLHint",
   description: "Runs htmlhint with project config to validate generated HTML",
@@ -7868,11 +7498,11 @@ var check18 = {
     const resolvedConfig = findConfigFile(ctx.inputDir, CONFIG_NAMES2, configPath);
     if (!resolvedConfig && !configPath)
       return [];
-    const ruleset = resolvedConfig ? JSON.parse(await readFile15(resolvedConfig, "utf8")) : HTMLHint.defaultRuleset;
-    const html = await readFile15(ctx.htmlPath, "utf8");
+    const ruleset = resolvedConfig ? JSON.parse(await readFile16(resolvedConfig, "utf8")) : HTMLHint.defaultRuleset;
+    const html = await readFile16(ctx.htmlPath, "utf8");
     const messages = HTMLHint.verify(html, ruleset);
     return messages.map((m) => ({
-      checkId: check18.id,
+      checkId: check19.id,
       severity: m.type === "error" ? "error" : "warning",
       message: `${m.rule.id}: ${m.message}`,
       file: ctx.htmlPath,
@@ -7881,10 +7511,10 @@ var check18 = {
     }));
   }
 };
-registerCheck(check18);
+registerCheck(check19);
 
 // src/checks/source/stylelint.ts
-import { readFile as readFile16 } from "node:fs/promises";
+import { readFile as readFile17 } from "node:fs/promises";
 
 // src/lib/printsafe.ts
 import postcss2 from "postcss";
@@ -8201,7 +7831,7 @@ function checkCssRaw(css, from) {
 }
 
 // src/checks/source/stylelint.ts
-var check19 = {
+var check20 = {
   id: "source.stylelint",
   name: "Print-safety CSS",
   description: "Checks CSS for print-safety issues (remote URLs, rasterizing effects, and page-layer containment)",
@@ -8218,10 +7848,10 @@ var check19 = {
     for (const file of files) {
       let css;
       try {
-        css = await readFile16(file, "utf8");
+        css = await readFile17(file, "utf8");
       } catch (err) {
         results.push({
-          checkId: check19.id,
+          checkId: check20.id,
           severity: "error",
           message: `Cannot read stylesheet: ${err instanceof Error ? err.message : String(err)}`,
           file
@@ -8230,7 +7860,7 @@ var check19 = {
       }
       for (const w of checkCss(css, file, { rules: ctx.config.lint.rules })) {
         results.push({
-          checkId: check19.id,
+          checkId: check20.id,
           severity: w.severity,
           message: `${w.rule}: ${w.message}`,
           file,
@@ -8242,15 +7872,15 @@ var check19 = {
     return results;
   }
 };
-registerCheck(check19);
+registerCheck(check20);
 
 // src/checks/source/css-ownership.ts
-import { readFile as readFile17 } from "node:fs/promises";
+import { readFile as readFile18 } from "node:fs/promises";
 import postcss3 from "postcss";
 import { parse as parseYaml3 } from "yaml";
 var CONFIG_NAMES3 = [".gutterpress/css-contract.yaml", ".gutterpress/css-contract.yml"];
 async function loadContract(configPath) {
-  const raw = await readFile17(configPath, "utf8");
+  const raw = await readFile18(configPath, "utf8");
   const parsed = parseYaml3(raw);
   if (parsed && typeof parsed === "object")
     return parsed;
@@ -8363,7 +7993,7 @@ function checkOwnership(root, file, maps) {
   });
   return out;
 }
-var check20 = {
+var check21 = {
   id: "source.css-ownership",
   name: "CSS ownership contract",
   description: "Checks an optional per-project CSS ownership contract (.gutterpress/css-contract.yaml): which file may declare which properties/at-rules, and which selectors must never appear unscoped.",
@@ -8386,7 +8016,7 @@ var check20 = {
     } catch (err) {
       return [
         {
-          checkId: check20.id,
+          checkId: check21.id,
           severity: "error",
           message: `Failed to parse CSS ownership contract "${configPath}": ${err instanceof Error ? err.message : String(err)}`,
           file: configPath
@@ -8401,7 +8031,7 @@ var check20 = {
         continue;
       let css;
       try {
-        css = await readFile17(absFile, "utf8");
+        css = await readFile18(absFile, "utf8");
       } catch {
         continue;
       }
@@ -8428,7 +8058,7 @@ var check20 = {
       }
       for (const v of violations) {
         results.push({
-          checkId: check20.id,
+          checkId: check21.id,
           severity: "warning",
           message: v.message,
           file: absFile,
@@ -8440,14 +8070,14 @@ var check20 = {
     return results;
   }
 };
-registerCheck(check20);
+registerCheck(check21);
 
 // src/checks/source/local-refs.ts
 import { existsSync as existsSync10 } from "node:fs";
 import { dirname as dirname3, resolve as resolve6 } from "node:path";
 
 // src/checks/source/local-ref-parser.ts
-import { readFile as readFile18 } from "node:fs/promises";
+import { readFile as readFile19 } from "node:fs/promises";
 function newlineOffsets(content) {
   const offsets = [];
   for (let i = 0;i < content.length; i++)
@@ -8516,7 +8146,7 @@ async function* renderedLocalRefs(ctx, checkId, results) {
   for (const file of files) {
     let refs;
     try {
-      refs = collectRenderedLocalRefs(await readFile18(file, "utf8"));
+      refs = collectRenderedLocalRefs(await readFile19(file, "utf8"));
     } catch {
       results.push(inspectionFailed(checkId, `Could not read source file: ${file}`, { file }));
       continue;
@@ -8527,7 +8157,7 @@ async function* renderedLocalRefs(ctx, checkId, results) {
 }
 
 // src/checks/source/local-refs.ts
-var check21 = {
+var check22 = {
   id: "source.links.local-refs",
   name: "Local Markdown References",
   description: "Checks local markdown links and image refs resolve on disk",
@@ -8535,12 +8165,12 @@ var check21 = {
   phase: "pre-build",
   async run(ctx) {
     const results = [];
-    for await (const { ref, kind, line, file } of renderedLocalRefs(ctx, check21.id, results)) {
+    for await (const { ref, kind, line, file } of renderedLocalRefs(ctx, check22.id, results)) {
       if (isNonFilesystemRef(ref))
         continue;
       const escape = kind === "image" ? proseImageRefError(ref, ctx.inputDir) : null;
       if (escape) {
-        results.push(finding(check21.id, {
+        results.push(finding(check22.id, {
           severity: "error",
           message: escape,
           file,
@@ -8550,7 +8180,7 @@ var check21 = {
       }
       if (localRefExists(ref, kind, file, ctx.inputDir))
         continue;
-      results.push(finding(check21.id, {
+      results.push(finding(check22.id, {
         severity: kind === "image" ? "warning" : "error",
         code: kind === "image" ? "missing-image-placeholder" : undefined,
         message: kind === "image" ? `Local image not found; build will substitute a magenta placeholder: ${ref}` : `Local reference not found: ${ref}`,
@@ -8575,7 +8205,7 @@ function localRefExists(ref, kind, sourceFile, projectRoot) {
       return existsSync10(fileRelative);
   }
 }
-registerCheck(check21);
+registerCheck(check22);
 
 // src/lib/build-staging.ts
 import path11 from "node:path";
@@ -8841,7 +8471,7 @@ async function createStageRoot() {
 }
 
 // src/checks/source/dangling-links.ts
-var check22 = {
+var check23 = {
   id: "source.links.dangling",
   name: "Dangling Links",
   description: "Flags relative links the printed book cannot open (their href is dropped at print time)",
@@ -8849,10 +8479,10 @@ var check22 = {
   phase: "pre-build",
   async run(ctx) {
     const results = [];
-    for await (const { ref, kind, line, file } of renderedLocalRefs(ctx, check22.id, results)) {
+    for await (const { ref, kind, line, file } of renderedLocalRefs(ctx, check23.id, results)) {
       if (kind !== "link" || isPrintResolvableHref(ref))
         continue;
-      results.push(finding(check22.id, {
+      results.push(finding(check23.id, {
         severity: "warning",
         code: "dangling-link",
         data: { ref },
@@ -8864,11 +8494,11 @@ var check22 = {
     return results;
   }
 };
-registerCheck(check22);
+registerCheck(check23);
 
 // src/checks/source/accessibility-alt-text.ts
-import { readFile as readFile19 } from "node:fs/promises";
-var check23 = {
+import { readFile as readFile20 } from "node:fs/promises";
+var check24 = {
   id: "source.accessibility.alt-text",
   name: "Image Alt Text",
   description: "Checks markdown images include non-empty alt text",
@@ -8881,7 +8511,7 @@ var check23 = {
     const results = [];
     for (const file of files) {
       try {
-        const content = await readFile19(file, "utf8");
+        const content = await readFile20(file, "utf8");
         const lines = content.split(`
 `);
         let inFence = false;
@@ -8897,7 +8527,7 @@ var check23 = {
             if (alt.trim())
               continue;
             results.push({
-              checkId: check23.id,
+              checkId: check24.id,
               severity: "warning",
               message: "Image is missing alt text",
               file,
@@ -8922,11 +8552,11 @@ function extractImageAlts(line) {
   }
   return alts;
 }
-registerCheck(check23);
+registerCheck(check24);
 
 // src/checks/source/accessibility-heading-order.ts
-import { readFile as readFile20 } from "node:fs/promises";
-var check24 = {
+import { readFile as readFile21 } from "node:fs/promises";
+var check25 = {
   id: "source.accessibility.heading-order",
   name: "Heading Order",
   description: "Checks markdown heading levels do not jump by more than one",
@@ -8939,7 +8569,7 @@ var check24 = {
     const results = [];
     for (const file of files) {
       try {
-        const content = await readFile20(file, "utf8");
+        const content = await readFile21(file, "utf8");
         const lines = content.split(`
 `);
         let inFence = false;
@@ -8954,7 +8584,7 @@ var check24 = {
           if (inFence)
             continue;
           const comment = /^\s*<!--(.*)-->\s*$/.exec(line);
-          if (comment && parseDisableDirective(comment[1])?.includes(check24.id)) {
+          if (comment && parseDisableDirective(comment[1])?.includes(check25.id)) {
             silencedLine = i + 1;
             continue;
           }
@@ -8964,7 +8594,7 @@ var check24 = {
           const level = match[1].length;
           if (prevLevel != null && level > prevLevel + 1 && i !== silencedLine) {
             results.push({
-              checkId: check24.id,
+              checkId: check25.id,
               severity: "warning",
               message: `Heading level jump from h${prevLevel} to h${level}`,
               file,
@@ -8978,11 +8608,11 @@ var check24 = {
     return results;
   }
 };
-registerCheck(check24);
+registerCheck(check25);
 
 // src/checks/source/layout-markers.ts
-import { readFile as readFile21 } from "node:fs/promises";
-var check25 = {
+import { readFile as readFile22 } from "node:fs/promises";
+var check26 = {
   id: "source.markdown.layout-markers",
   name: "Layout Markers",
   description: "Reports @page/@section/@chapter marker arguments Gutterpress could not understand, plus any unknown gp-* class",
@@ -8994,16 +8624,16 @@ var check25 = {
       return [];
     const results = [];
     const plugins = await loadPlugins(ctx.config.extensions, ctx.inputDir, (ref, error2) => {
-      results.push(inspectionFailed(check25.id, `Plugin "${ref}" could not be loaded, so markers it defines were not checked: ${error2.message}`));
+      results.push(inspectionFailed(check26.id, `Plugin "${ref}" could not be loaded, so markers it defines were not checked: ${error2.message}`));
     });
     const md = createMarkdownRenderer(plugins);
     for (const file of files) {
       try {
-        const content = await readFile21(file, "utf8");
+        const content = await readFile22(file, "utf8");
         const env = {};
         md.render(content, env);
         for (const w of env.layoutWarnings ?? []) {
-          results.push(finding(check25.id, {
+          results.push(finding(check26.id, {
             severity: w.severity ?? "warning",
             message: w.message,
             file,
@@ -9012,16 +8642,16 @@ var check25 = {
           }));
         }
       } catch (error2) {
-        results.push(inspectionFailed(check25.id, `Could not check layout markers in ${file}: ${error2 instanceof Error ? error2.message : String(error2)}`, { file }));
+        results.push(inspectionFailed(check26.id, `Could not check layout markers in ${file}: ${error2 instanceof Error ? error2.message : String(error2)}`, { file }));
       }
     }
     return results;
   }
 };
-registerCheck(check25);
+registerCheck(check26);
 
 // src/checks/source/merge-markers.ts
-import { readFile as readFile22 } from "node:fs/promises";
+import { readFile as readFile23 } from "node:fs/promises";
 import path12 from "node:path";
 
 // src/checks/asset/extensions.ts
@@ -9051,7 +8681,7 @@ var CLOSE_SENTINEL = ">>>>>>> online version";
 function withoutOnlineTag(relPath) {
   return relPath.replace(/\.online(?=\.[^./]*$|$)/, "");
 }
-var check26 = {
+var check27 = {
   id: "source.sync.merge-markers",
   name: "Combined Versions",
   description: "Finds passages and files still holding two versions (yours and the online copy) after a sync",
@@ -9063,9 +8693,9 @@ var check26 = {
     for (const file of textFiles) {
       let content;
       try {
-        content = await readFile22(file, "utf8");
+        content = await readFile23(file, "utf8");
       } catch {
-        results.push(inspectionFailed(check26.id, `Could not read source file: ${file}`, { file }));
+        results.push(inspectionFailed(check27.id, `Could not read source file: ${file}`, { file }));
         continue;
       }
       if (!content.includes(OPEN_SENTINEL) && !content.includes(CLOSE_SENTINEL))
@@ -9077,7 +8707,7 @@ var check26 = {
         const line = lines[i].endsWith("\r") ? lines[i].slice(0, -1) : lines[i];
         if (line === OPEN_SENTINEL) {
           inBlock = true;
-          results.push(finding(check26.id, {
+          results.push(finding(check27.id, {
             severity: "error",
             code: "two-versions-passage",
             message: "This passage has two versions (yours and the online copy) — keep what you want, then delete the marker lines.",
@@ -9086,7 +8716,7 @@ var check26 = {
           }));
         } else if (line === CLOSE_SENTINEL) {
           if (!inBlock) {
-            results.push(finding(check26.id, {
+            results.push(finding(check27.id, {
               severity: "error",
               code: "leftover-version-marker",
               message: "This marker line is left over from combining two versions — delete it.",
@@ -9107,7 +8737,7 @@ var check26 = {
       });
       for (const sibling of siblings.sort()) {
         const rel = path12.relative(ctx.inputDir, sibling).split(path12.sep).join("/");
-        results.push(finding(check26.id, {
+        results.push(finding(check27.id, {
           severity: "warning",
           code: "kept-both-versions",
           message: `Two versions of ${withoutOnlineTag(rel)} are in your book — keep the one you want, then delete the other.`,
@@ -9115,18 +8745,18 @@ var check26 = {
         }));
       }
     } catch (error2) {
-      results.push(inspectionFailed(check26.id, `Could not scan for kept-both files: ${error2 instanceof Error ? error2.message : String(error2)}`));
+      results.push(inspectionFailed(check27.id, `Could not scan for kept-both files: ${error2 instanceof Error ? error2.message : String(error2)}`));
     }
     return results;
   }
 };
-registerCheck(check26);
+registerCheck(check27);
 
 // src/checks/asset/image-file-size.ts
 import { stat as stat4 } from "node:fs/promises";
 
 // src/lib/image-inspect.ts
-import { stat as stat3, readFile as readFile23 } from "node:fs/promises";
+import { stat as stat3, readFile as readFile24 } from "node:fs/promises";
 var DEFAULT_DPI = 72;
 var cache = new Map;
 async function inspectImage(path13) {
@@ -9141,7 +8771,7 @@ async function inspectImage(path13) {
     return hit.info;
   let info2 = null;
   try {
-    const buf = await readFile23(path13);
+    const buf = await readFile24(path13);
     info2 = parseImage(buf);
   } catch {
     info2 = null;
@@ -9346,7 +8976,7 @@ async function collectImageFiles(dirs, exts, ignore2 = ASSET_SCAN_IGNORE_GLOBS)
 }
 
 // src/checks/asset/image-file-size.ts
-var check27 = {
+var check28 = {
   id: "asset.image.file-size",
   name: "Image File Size",
   description: "Checks that image files do not exceed the maximum size limit",
@@ -9367,14 +8997,14 @@ var check27 = {
         if (info2.size > maxSize) {
           const sizeMb = (info2.size / 1e6).toFixed(1);
           const maxMb = (maxSize / 1e6).toFixed(1);
-          results.push(finding(check27.id, {
+          results.push(finding(check28.id, {
             severity: "warning",
             message: `Image file too large: ${sizeMb}MB (max ${maxMb}MB)`,
             file
           }));
         }
       } catch {
-        results.push(inspectionFailed(check27.id, `Could not stat image file: ${file}`, {
+        results.push(inspectionFailed(check28.id, `Could not stat image file: ${file}`, {
           file
         }));
       }
@@ -9382,10 +9012,10 @@ var check27 = {
     return results;
   }
 };
-registerCheck(check27);
+registerCheck(check28);
 
 // src/checks/asset/image-resolution.ts
-var check28 = {
+var check29 = {
   id: "asset.image.resolution",
   name: "Image Resolution",
   description: "Checks source image DPI from embedded density metadata",
@@ -9407,7 +9037,7 @@ var check28 = {
       const { xDpi, yDpi } = info2;
       if (xDpi > 0 && yDpi > 0 && (xDpi < minDpi || yDpi < minDpi)) {
         results.push({
-          checkId: check28.id,
+          checkId: check29.id,
           severity: "warning",
           message: `Image resolution too low: ${xDpi}x${yDpi} DPI (minimum ${minDpi} DPI)`,
           file
@@ -9417,7 +9047,7 @@ var check28 = {
     return results;
   }
 };
-registerCheck(check28);
+registerCheck(check29);
 
 // src/checks/asset/image-color-space.ts
 var LABEL = {
@@ -9425,7 +9055,7 @@ var LABEL = {
   gray: "Gray",
   cmyk: "CMYK"
 };
-var check29 = {
+var check30 = {
   id: "asset.image.color-space",
   name: "Image Color Space",
   description: "Validates image color spaces against allowed list",
@@ -9446,7 +9076,7 @@ var check29 = {
       const cs = info2?.colorSpace;
       if (cs && !allowedLower.has(cs)) {
         results.push({
-          checkId: check29.id,
+          checkId: check30.id,
           severity: "warning",
           message: `Image uses ${LABEL[cs] ?? cs} color space (allowed: ${allowed.join(", ")})`,
           file
@@ -9456,10 +9086,10 @@ var check29 = {
     return results;
   }
 };
-registerCheck(check29);
+registerCheck(check30);
 
 // src/checks/asset/image-alpha.ts
-var check30 = {
+var check31 = {
   id: "asset.image.alpha-channel",
   name: "Image Alpha Channel",
   description: "Checks for alpha channels in PNG/TIFF images",
@@ -9477,7 +9107,7 @@ var check30 = {
       const info2 = await inspectImage(file);
       if (info2?.hasAlpha) {
         results.push({
-          checkId: check30.id,
+          checkId: check31.id,
           severity: "warning",
           message: "Image contains alpha channel, which may cause print issues",
           file
@@ -9487,10 +9117,10 @@ var check30 = {
     return results;
   }
 };
-registerCheck(check30);
+registerCheck(check31);
 
 // src/checks/asset/image-tac.ts
-var check31 = {
+var check32 = {
   id: "asset.image.tac-raster",
   name: "Image TAC (Raster)",
   description: "Rasterizes and checks TAC per image using Ghostscript",
@@ -9509,7 +9139,7 @@ var check31 = {
     const ghostscript = await resolveGhostscript();
     if (!ghostscript) {
       return [
-        inspectionFailed(check31.id, "Could not inspect image ink coverage: Ghostscript executable not found")
+        inspectionFailed(check32.id, "Could not inspect image ink coverage: Ghostscript executable not found")
       ];
     }
     for (const file of files) {
@@ -9527,7 +9157,7 @@ var check31 = {
           if (nums.length === 4 && nums.every((n) => Number.isFinite(n))) {
             const tac = (nums[0] + nums[1] + nums[2] + nums[3]) * 100;
             if (tac > maxTac) {
-              results.push(finding(check31.id, {
+              results.push(finding(check32.id, {
                 severity: "warning",
                 message: `Image TAC exceeds limit: ${tac.toFixed(1)}% (max ${maxTac}%)`,
                 file,
@@ -9539,16 +9169,16 @@ var check31 = {
           }
         }
       } catch {
-        results.push(inspectionFailed(check31.id, `Could not inspect image ink coverage: ${file}`, { file }));
+        results.push(inspectionFailed(check32.id, `Could not inspect image ink coverage: ${file}`, { file }));
       }
     }
     return results;
   }
 };
-registerCheck(check31);
+registerCheck(check32);
 
 // src/checks/asset/approved-fonts.ts
-var check32 = {
+var check33 = {
   id: "asset.font.approved-files",
   name: "Approved Font Files",
   description: "Checks font files against the approved file patterns",
@@ -9587,7 +9217,7 @@ var check32 = {
     for (const font of allFonts) {
       if (!approvedFonts.has(font)) {
         results.push({
-          checkId: check32.id,
+          checkId: check33.id,
           severity: "warning",
           message: "Font file not in approved list",
           file: font
@@ -9597,7 +9227,7 @@ var check32 = {
     return results;
   }
 };
-registerCheck(check32);
+registerCheck(check33);
 
 // src/checks/asset/font-license.ts
 import { existsSync as existsSync11 } from "node:fs";
@@ -9612,7 +9242,7 @@ var LICENSE_NAMES = [
   "OFL-1.1.txt",
   "COPYING"
 ];
-var check33 = {
+var check34 = {
   id: "asset.font.license",
   name: "Font License",
   description: "Checks for license files in font directories",
@@ -9639,7 +9269,7 @@ var check33 = {
       const hasLicense = LICENSE_NAMES.some((name) => existsSync11(resolve7(fontDir, name)));
       if (!hasLicense) {
         results.push({
-          checkId: check33.id,
+          checkId: check34.id,
           severity: "warning",
           message: `No font license file found in directory`,
           file: fontDir
@@ -9649,10 +9279,10 @@ var check33 = {
     return results;
   }
 };
-registerCheck(check33);
+registerCheck(check34);
 
 // src/checks/heuristic/text-density.ts
-var check34 = {
+var check35 = {
   id: "heuristic.whitespace.text-density",
   name: "Text Density",
   description: "Checks characters-per-page ratio",
@@ -9681,7 +9311,7 @@ var check34 = {
     });
     if (lowPages.length > 0) {
       results.push({
-        checkId: check34.id,
+        checkId: check35.id,
         severity: "info",
         message: `Low text density on pages: ${lowPages.join(", ")} (below ${range.min} chars)`,
         file: ctx.pdfPath
@@ -9689,7 +9319,7 @@ var check34 = {
     }
     if (highPages.length > 0) {
       results.push({
-        checkId: check34.id,
+        checkId: check35.id,
         severity: "info",
         message: `High text density on pages: ${highPages.join(", ")} (above ${range.max} chars)`,
         file: ctx.pdfPath
@@ -9698,11 +9328,11 @@ var check34 = {
     return results;
   }
 };
-registerCheck(check34);
+registerCheck(check35);
 
 // src/checks/heuristic/section-density.ts
-import { readFile as readFile24 } from "node:fs/promises";
-var check35 = {
+import { readFile as readFile25 } from "node:fs/promises";
+var check36 = {
   id: "heuristic.chunking.section-density",
   name: "Section Density",
   description: "Checks heading/paragraph/callout density from source Markdown",
@@ -9718,7 +9348,7 @@ var check35 = {
     const results = [];
     for (const file of files) {
       try {
-        const content = await readFile24(file, "utf8");
+        const content = await readFile25(file, "utf8");
         const lines = content.split(`
 `);
         let currentSectionStart = 0;
@@ -9728,7 +9358,7 @@ var check35 = {
           const line = lines[i];
           if (/^#{1,6}\s/.test(line)) {
             if (paragraphCount > maxParas) {
-              results.push(finding(check35.id, {
+              results.push(finding(check36.id, {
                 severity: "info",
                 message: `Section has ${paragraphCount} paragraphs (max recommended: ${maxParas})`,
                 file,
@@ -9748,7 +9378,7 @@ var check35 = {
           }
         }
         if (paragraphCount > maxParas) {
-          results.push(finding(check35.id, {
+          results.push(finding(check36.id, {
             severity: "info",
             message: `Section has ${paragraphCount} paragraphs (max recommended: ${maxParas})`,
             file,
@@ -9756,7 +9386,7 @@ var check35 = {
           }));
         }
       } catch {
-        results.push(inspectionFailed(check35.id, `Could not read source file: ${file}`, {
+        results.push(inspectionFailed(check36.id, `Could not read source file: ${file}`, {
           file
         }));
       }
@@ -9764,10 +9394,10 @@ var check35 = {
     return results;
   }
 };
-registerCheck(check35);
+registerCheck(check36);
 
 // src/checks/heuristic/layer-count.ts
-var check36 = {
+var check37 = {
   id: "heuristic.decoration.layer-count",
   name: "Layer Count",
   description: "Counts image objects per page",
@@ -9792,7 +9422,7 @@ var check36 = {
       heavyPages.sort((a, b) => a - b);
       return [
         {
-          checkId: check36.id,
+          checkId: check37.id,
           severity: "info",
           message: `Pages with many image layers (>${maxLayers}): ${heavyPages.join(", ")}`,
           file: ctx.pdfPath
@@ -9802,10 +9432,10 @@ var check36 = {
     return [];
   }
 };
-registerCheck(check36);
+registerCheck(check37);
 
 // src/checks/heuristic/placement-variance.ts
-var check37 = {
+var check38 = {
   id: "heuristic.layout.placement-variance",
   name: "Placement Variance",
   description: "Analyzes text baseline coordinates for layout consistency",
@@ -9823,7 +9453,7 @@ var check37 = {
     const uniqueX = new Set(positions.map((p) => Math.round(p.x)));
     return [
       {
-        checkId: check37.id,
+        checkId: check38.id,
         severity: "info",
         message: `Layout analysis: ${uniqueX.size} unique horizontal text positions across ${positions.length} text blocks.`,
         file: ctx.pdfPath
@@ -9831,7 +9461,7 @@ var check37 = {
     ];
   }
 };
-registerCheck(check37);
+registerCheck(check38);
 
 // src/checks/runner.ts
 function getCheckSeverityOverride(checkId, config) {
@@ -9861,16 +9491,16 @@ async function runChecks(ctx, opts = {}) {
   }
   const release = retainPdfCache();
   try {
-    for (const check38 of checks2) {
+    for (const check39 of checks2) {
       try {
-        let results = await check38.run(ctx);
-        const severityOverride = getCheckSeverityOverride(check38.id, ctx.config);
+        let results = await check39.run(ctx);
+        const severityOverride = getCheckSeverityOverride(check39.id, ctx.config);
         if (severityOverride) {
           for (const r of results) {
             r.severity = severityOverride;
           }
         }
-        const lintLevel = ruleLevel(ctx.config.lint.rules, check38.id);
+        const lintLevel = ruleLevel(ctx.config.lint.rules, check39.id);
         if (lintLevel === "off")
           results = [];
         else if (lintLevel) {
@@ -9878,15 +9508,15 @@ async function runChecks(ctx, opts = {}) {
             r.severity = lintLevel === "warn" ? "warning" : "error";
         }
         if (results.length === 0) {
-          passed.push(check38.id);
+          passed.push(check39.id);
         } else {
           allResults.push(...results);
         }
       } catch (err) {
         allResults.push({
-          checkId: check38.id,
+          checkId: check39.id,
           severity: "error",
-          message: `Check "${check38.id}" threw: ${err instanceof Error ? err.message : String(err)}`
+          message: `Check "${check39.id}" threw: ${err instanceof Error ? err.message : String(err)}`
         });
       }
     }
@@ -9926,15 +9556,15 @@ function emptyReport() {
 async function checkToolAvailability(config, opts = {}) {
   const { checks: checks2 } = selectChecks(opts, config);
   const toolToChecks = new Map;
-  for (const check38 of checks2) {
-    if (!check38.requiredTools?.length)
+  for (const check39 of checks2) {
+    if (!check39.requiredTools?.length)
       continue;
-    for (const tool of check38.requiredTools) {
+    for (const tool of check39.requiredTools) {
       const existing = toolToChecks.get(tool);
       if (existing) {
-        existing.push(check38.id);
+        existing.push(check39.id);
       } else {
-        toolToChecks.set(tool, [check38.id]);
+        toolToChecks.set(tool, [check39.id]);
       }
     }
   }
@@ -9950,11 +9580,11 @@ async function checkToolAvailability(config, opts = {}) {
   const missing = results.filter((r) => !r.found).map((r) => r.tool);
   const missingSet = new Set(missing);
   const skippedChecks = [];
-  for (const check38 of checks2) {
-    if (!check38.requiredTools?.length)
+  for (const check39 of checks2) {
+    if (!check39.requiredTools?.length)
       continue;
-    if (check38.requiredTools.some((t) => missingSet.has(t))) {
-      skippedChecks.push(check38.id);
+    if (check39.requiredTools.some((t) => missingSet.has(t))) {
+      skippedChecks.push(check39.id);
     }
   }
   return { available, missing, skippedChecks, toolToChecks };
@@ -10227,7 +9857,7 @@ async function executeValidation(args) {
   };
   if (args.fix) {
     const selected = selectChecks(runnerOptions, config).checks;
-    if (selected.some((check38) => check38.id === MARKDOWNLINT_CHECK_ID)) {
+    if (selected.some((check39) => check39.id === MARKDOWNLINT_CHECK_ID)) {
       await applyMarkdownlintFixes(context);
     } else {
       log.warn(`--fix: ${MARKDOWNLINT_CHECK_ID} is not part of this run — no files were fixed.`);
@@ -10706,7 +10336,7 @@ async function runBuild(opts) {
 import path16 from "path";
 import { tmpdir } from "os";
 import { randomBytes as randomBytes2 } from "crypto";
-import { readdir as readdir5, readFile as readFile25, writeFile as writeFile6 } from "node:fs/promises";
+import { readdir as readdir5, readFile as readFile26, writeFile as writeFile6 } from "node:fs/promises";
 
 // src/utils/file-utils.ts
 import { promises as fs3 } from "fs";
@@ -11255,7 +10885,7 @@ async function cleanupOrphanTempDirs() {
     const dir = path16.join(TEMP_DIR_BASE, entry);
     const pidFile = path16.join(dir, PID_FILE_NAME);
     try {
-      const raw = await readFile25(pidFile, "utf8");
+      const raw = await readFile26(pidFile, "utf8");
       const pid = parseInt(raw.trim(), 10);
       if (!isProcessAlive(pid)) {
         debug(`Removing orphan temp dir ${dir} (pid ${pid} not alive)`);
@@ -11362,7 +10992,7 @@ function createServerState(inputPath, tempDir, config, options) {
 import http from "node:http";
 import net from "node:net";
 import { createHash as createHash5, randomUUID as randomUUID3 } from "node:crypto";
-import { readFile as readFile26, stat as stat5 } from "node:fs/promises";
+import { readFile as readFile27, stat as stat5 } from "node:fs/promises";
 import path17 from "path";
 import { WebSocket, WebSocketServer } from "ws";
 
@@ -11461,7 +11091,7 @@ async function serveStatic(absPath, res, cacheControl = "no-store", extraHeaders
   }
   let data;
   try {
-    data = await readFile26(filePath);
+    data = await readFile27(filePath);
   } catch {
     res.writeHead(404);
     res.end("Not Found");
@@ -11510,7 +11140,7 @@ async function serveRevalidatedStatic(req, absPath, res, validators) {
   let data;
   if (!validator || validator.stamp !== stamp) {
     try {
-      data = await readFile26(absPath);
+      data = await readFile27(absPath);
     } catch {
       await serveStatic(absPath, res);
       return;
@@ -11822,7 +11452,7 @@ async function startPreviewServer(options) {
 import { platform, arch, release } from "node:os";
 
 // src/lib/remote-auth/token-store.ts
-import { chmod, mkdir as mkdir7, readFile as readFile27, rename as rename4, writeFile as writeFile7 } from "node:fs/promises";
+import { chmod, mkdir as mkdir7, readFile as readFile28, rename as rename4, writeFile as writeFile7 } from "node:fs/promises";
 import os3 from "node:os";
 import path18 from "node:path";
 function credentialHostKey(hostOrUrl) {
@@ -11866,7 +11496,7 @@ class FileTokenStore {
   async read() {
     let raw;
     try {
-      raw = await readFile27(this.filePath, "utf8");
+      raw = await readFile28(this.filePath, "utf8");
     } catch (e) {
       if (e?.code === "ENOENT") {
         return { version: 1, credentials: {} };
@@ -12066,13 +11696,13 @@ async function getSystemDiagnostics() {
   };
 }
 // src/lib/project-scaffold.ts
-import { access, copyFile, cp as cp2, mkdir as mkdir9, readdir as readdir6, readFile as readFile29, stat as stat6, writeFile as writeFile9 } from "node:fs/promises";
+import { access, copyFile, cp as cp2, mkdir as mkdir9, readdir as readdir6, readFile as readFile30, stat as stat6, writeFile as writeFile9 } from "node:fs/promises";
 import { constants as FS, existsSync as existsSync14 } from "node:fs";
 import path20 from "node:path";
 
 // src/lib/page-size.ts
 import { existsSync as existsSync13 } from "node:fs";
-import { mkdir as mkdir8, readFile as readFile28, writeFile as writeFile8 } from "node:fs/promises";
+import { mkdir as mkdir8, readFile as readFile29, writeFile as writeFile8 } from "node:fs/promises";
 import path19 from "node:path";
 import postcss4 from "postcss";
 import { Scalar as Scalar2 } from "yaml";
@@ -12177,7 +11807,7 @@ var relDisplay2 = (projectDir, abs) => path19.relative(projectDir, abs).split(pa
 async function findCssSize(projectDir, sheets) {
   let found = null;
   for (const file of sheets) {
-    const size = readPageSizeFromCss(await readFile28(file, "utf8"));
+    const size = readPageSizeFromCss(await readFile29(file, "utf8"));
     if (size)
       found = { file, size };
   }
@@ -12204,7 +11834,7 @@ async function setPageSetup(projectDir, choice) {
   const found = await findCssSize(projectDir, sheets);
   const newSheet = path19.join(projectDir, "styles", "book.css");
   const target = found?.file ?? sheets[sheets.length - 1] ?? newSheet;
-  const before = existsSync13(target) ? await readFile28(target, "utf8") : "";
+  const before = existsSync13(target) ? await readFile29(target, "utf8") : "";
   let after;
   try {
     after = setPageSizeInCss(before, size);
@@ -12494,7 +12124,7 @@ styles:
 async function firstSourceFile(manifestPath) {
   let text;
   try {
-    text = await readFile29(manifestPath, "utf8");
+    text = await readFile30(manifestPath, "utf8");
   } catch {
     return;
   }
@@ -12506,14 +12136,14 @@ async function firstSourceFile(manifestPath) {
   return m ? m[1].trim() : undefined;
 }
 async function fillTemplateFile(filePath, substitutions) {
-  let text = await readFile29(filePath, "utf8");
+  let text = await readFile30(filePath, "utf8");
   for (const [token, value] of Object.entries(substitutions)) {
     text = text.split(token).join(value);
   }
   await writeFile9(filePath, text, "utf8");
 }
 // src/lib/extension-scaffold.ts
-import { access as access2, mkdir as mkdir10, readFile as readFile30, writeFile as writeFile10 } from "node:fs/promises";
+import { access as access2, mkdir as mkdir10, readFile as readFile31, writeFile as writeFile10 } from "node:fs/promises";
 import { constants as FS2 } from "node:fs";
 import path21 from "node:path";
 var EXTENSION_KINDS = ["plugin", "theme"];
@@ -12630,7 +12260,7 @@ async function scaffoldExtension(options) {
       const src = await getAssetPath(`extension-templates/${kind}/${assetName}`);
       const dest = path21.join(extensionDir, relDest);
       await mkdir10(path21.dirname(dest), { recursive: true });
-      const text = await readFile30(src, "utf8");
+      const text = await readFile31(src, "utf8");
       const table = relDest.endsWith(".json") ? jsonSafe : plain;
       await writeFile10(dest, substitute(text, table), "utf8");
       written.push(relDest);
@@ -12656,7 +12286,7 @@ function substitute(text, table) {
   return out;
 }
 // src/lib/project-templates.ts
-import { cp as cp3, mkdir as mkdir11, readFile as readFile31, readdir as readdir7, stat as stat7, writeFile as writeFile11 } from "node:fs/promises";
+import { cp as cp3, mkdir as mkdir11, readFile as readFile32, readdir as readdir7, stat as stat7, writeFile as writeFile11 } from "node:fs/promises";
 import { constants as FS3, existsSync as existsSync15 } from "node:fs";
 import { access as access3 } from "node:fs/promises";
 import path22 from "node:path";
@@ -12668,7 +12298,7 @@ var BUILT_IN_TEMPLATE_IDS = [
 ];
 async function readTemplateChoices(manifestPath) {
   try {
-    const text = await readFile31(manifestPath, "utf8");
+    const text = await readFile32(manifestPath, "utf8");
     const doc = parseDocument2(text);
     const out = {};
     const preset = doc.get("preset");
@@ -12850,7 +12480,7 @@ async function saveProjectAsTemplate(options) {
 async function retokeniseManifest(manifestPath) {
   let text;
   try {
-    text = await readFile31(manifestPath, "utf8");
+    text = await readFile32(manifestPath, "utf8");
   } catch {
     return;
   }
@@ -12871,7 +12501,7 @@ async function listCustomTemplates(templatesRoot) {
     const dir = path22.join(templatesRoot, entry.name);
     let label = prettify(entry.name);
     try {
-      const meta = JSON.parse(await readFile31(path22.join(dir, TEMPLATE_META_FILE), "utf8"));
+      const meta = JSON.parse(await readFile32(path22.join(dir, TEMPLATE_META_FILE), "utf8"));
       if (typeof meta.label === "string" && meta.label)
         label = meta.label;
     } catch {}
@@ -12897,7 +12527,7 @@ async function importTemplateFromFolder(options) {
   return saveProjectAsTemplate({ projectDir: sourceDir, name, templatesRoot });
 }
 // src/lib/snippets.ts
-import { readdir as readdir8, readFile as readFile32, writeFile as writeFile12, mkdir as mkdir12, rm as rm4 } from "node:fs/promises";
+import { readdir as readdir8, readFile as readFile33, writeFile as writeFile12, mkdir as mkdir12, rm as rm4 } from "node:fs/promises";
 import path23 from "node:path";
 var SNIPPETS_DIR = "snippets";
 var LEVEL_RANK = { project: 0, extension: 1, core: 2 };
@@ -12938,7 +12568,7 @@ async function scanSnippetFiles(dir) {
       continue;
     let body = "";
     try {
-      body = await readFile32(path23.join(dir, fileName), "utf8");
+      body = await readFile33(path23.join(dir, fileName), "utf8");
     } catch {
       continue;
     }
@@ -13024,7 +12654,7 @@ async function collectLibrary(projectDir) {
         listed.component = name;
         continue;
       }
-      const body = await readFile32(path23.join(entry.dir, rel), "utf8").catch(() => null);
+      const body = await readFile33(path23.join(entry.dir, rel), "utf8").catch(() => null);
       if (body === null)
         continue;
       snippets2.push({
@@ -13074,7 +12704,7 @@ async function listMarkerComponents(projectDir) {
 }
 // src/lib/extension-import.ts
 import { existsSync as existsSync16 } from "node:fs";
-import { cp as cp4, mkdir as mkdir13, mkdtemp as mkdtemp2, readFile as readFile33, rm as rm5, writeFile as writeFile13 } from "node:fs/promises";
+import { cp as cp4, mkdir as mkdir13, mkdtemp as mkdtemp2, readFile as readFile34, rm as rm5, writeFile as writeFile13 } from "node:fs/promises";
 import { tmpdir as tmpdir2 } from "node:os";
 import path24 from "node:path";
 import { unzipSync } from "fflate";
@@ -13147,7 +12777,7 @@ async function finalizeExtensionImport(projectDir, sourceDir, relPaths, fallback
   if (!existsSync16(cssPath)) {
     throw new Error("A theme must contain a theme.css file.");
   }
-  const css = await readFile33(cssPath, "utf8");
+  const css = await readFile34(cssPath, "utf8");
   const { reject, warnings: printFindings } = classifyThemeCssFindings(checkCss(css, "theme.css"));
   if (reject) {
     throw new Error(`theme.css could not be parsed — ${reject.message}`);
@@ -13175,7 +12805,7 @@ async function finalizeExtensionImport(projectDir, sourceDir, relPaths, fallback
   for (let i = 0;i < extraSheets.length; i++) {
     const rel = extraSheets[i];
     const sheetPath = extraSheetPaths[i];
-    const sheetCss = await readFile33(sheetPath, "utf8");
+    const sheetCss = await readFile34(sheetPath, "utf8");
     const { reject: sheetReject, warnings: sheetFindings } = classifyThemeCssFindings(checkCss(sheetCss, rel));
     if (sheetReject) {
       throw new Error(`${rel} could not be parsed — ${sheetReject.message}`);
@@ -13208,7 +12838,7 @@ async function completeLandedManifest(dest, id, meta, metaExists) {
   let pkg = {};
   if (metaExists) {
     try {
-      const parsed = JSON.parse(await readFile33(file, "utf8"));
+      const parsed = JSON.parse(await readFile34(file, "utf8"));
       if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {
         pkg = parsed;
       }
@@ -13310,11 +12940,11 @@ async function importExtensionFromCssText(projectDir, css, name) {
 async function importExtensionFromFile(projectDir, filePath) {
   const ext = path24.extname(filePath).toLowerCase();
   if (ext === ".zip") {
-    const buf = await readFile33(filePath);
+    const buf = await readFile34(filePath);
     return importExtensionFromZip(projectDir, new Uint8Array(buf.buffer, buf.byteOffset, buf.byteLength));
   }
   if (ext === ".css") {
-    const css = await readFile33(filePath, "utf8");
+    const css = await readFile34(filePath, "utf8");
     return importExtensionFromCssText(projectDir, css, prettify(path24.basename(filePath, ".css")));
   }
   throw new Error("Choose a .zip extension package or a .css stylesheet.");
@@ -15885,7 +15515,7 @@ var drivethrurpgProvider = {
 };
 
 // src/lib/publish/providers/gdrive.ts
-import { mkdtemp as mkdtemp3, readFile as readFile34, readdir as readdir11, rm as rm9, stat as stat9, writeFile as writeFile16 } from "node:fs/promises";
+import { mkdtemp as mkdtemp3, readFile as readFile35, readdir as readdir11, rm as rm9, stat as stat9, writeFile as writeFile16 } from "node:fs/promises";
 import { tmpdir as tmpdir3 } from "node:os";
 import path30 from "node:path";
 import { Zip, ZipDeflate } from "fflate";
@@ -16277,12 +15907,12 @@ async function collectZipEntries(root, dir, out, onWarn) {
       await collectZipEntries(root, full, out, onWarn);
     } else if (entry.isFile()) {
       const rel = path30.relative(root, full).split(path30.sep).join("/");
-      out[rel] = await readFile34(full);
+      out[rel] = await readFile35(full);
     } else if (entry.isSymbolicLink()) {
       const resolved = await stat9(full).catch(() => null);
       if (resolved?.isFile()) {
         const rel = path30.relative(root, full).split(path30.sep).join("/");
-        out[rel] = await readFile34(full);
+        out[rel] = await readFile35(full);
       } else if (resolved?.isDirectory()) {
         await collectZipEntries(root, full, out, onWarn);
       } else {
@@ -17148,7 +16778,7 @@ async function disconnectPublishCredential(key, deps, options = {}) {
   }
 }
 // src/lib/publish/selections.ts
-import { chmod as chmod3, mkdir as mkdir21, readFile as readFile35, writeFile as writeFile18 } from "node:fs/promises";
+import { chmod as chmod3, mkdir as mkdir21, readFile as readFile36, writeFile as writeFile18 } from "node:fs/promises";
 import path34 from "node:path";
 class PublishSelectionsStore {
   filePath;
@@ -17158,7 +16788,7 @@ class PublishSelectionsStore {
   }
   async read() {
     try {
-      const raw = await readFile35(this.filePath, "utf8");
+      const raw = await readFile36(this.filePath, "utf8");
       const parsed = JSON.parse(raw);
       if (parsed && typeof parsed === "object") {
         return {