gutterpress 0.11.20-alpha.1 → 0.11.20-alpha.3

package/dist/{cli-x1nfhaf1.js → cli-9k2tb493.js}

@@ -6,20 +6,22 @@ import {
   defaultConfigDir,
   error,
   findPostScriptShadingPages,
-  hasLiveTransparency,
+  flattenTransparentPages,
   info,
   log,
+  planTransparentPages,
   resolveGhostscript,
   setLogLevel,
   stampCreator,
   stripAnnotations,
+  transparentPages,
   warn
-} from "./cli-mmm22cza.js";
+} from "./cli-y9bcya7r.js";
 import {
   DEBOUNCE,
   UsageError,
   resolvePort
-} from "./cli-7shp2kmj.js";
+} from "./cli-hn9pk0hp.js";
 import {
   blackTextToGray
 } from "./cli-ht1bcqdd.js";
@@ -28,11 +30,24 @@ import {
   getAssetPath,
   getAssetsDir,
   lastPageMode
-} from "./cli-rtpm04dv.js";
+} from "./cli-x4p99w8d.js";
 import {
   BuildError,
   EXIT_CODES
 } from "./cli-46ycxe6r.js";
+import {
+  countLinkAnnotations,
+  getImageResolutions,
+  getOpPass,
+  getOutlineCount,
+  getPageLabels,
+  getPageSize,
+  getTextPass,
+  isLoadable,
+  loadPdf,
+  pageHasMarks,
+  retainPdfCache
+} from "./cli-sth219v1.js";
 import {
   INSTALL_HINTS,
   execCapture,
@@ -106,6 +121,11 @@ function pinnedNpmSpecifier(name, version) {
 // src/lib/presets.ts
 var PRESET_IDS = ["dtrpg", "book", "custom"];
 var DTRPG_PRESET = {
+  id: "dtrpg",
+  spec: {
+    label: "DriveThruRPG — Quick Specifications for Print Books",
+    url: "https://help.drivethrupartners.com/hc/en-us/articles/12780800178583-Quick-Specifications-for-Print-Books"
+  },
   defaultTargets: ["dtrpg"],
   extensions: [],
   source: {
@@ -117,6 +137,8 @@ var DTRPG_PRESET = {
     icc: "profiles/CGATS21_CRPC1.icc",
     stripAnnotations: true,
     blackText: "k-only",
+    transparency: "flatten-page",
+    flattenPages: [],
     rasterDpi: undefined
   },
   page: {
@@ -124,7 +146,8 @@ var DTRPG_PRESET = {
     height: 810,
     tolerance: 0.5,
     bleed: 9,
-    safe: 18
+    safe: 36,
+    artSafe: 18
   },
   ink: {
     maxTac: 240,
@@ -153,6 +176,10 @@ var DTRPG_PRESET = {
       "pdf.print.embedded-fonts": {
         enabled: true,
         severity: "error"
+      },
+      "pdf.print.safe-margins": {
+        enabled: true,
+        severity: "error"
       }
     },
     source: {
@@ -185,6 +212,7 @@ var DTRPG_PRESET = {
   }
 };
 var BOOK_PRESET = {
+  id: "book",
   defaultTargets: [],
   extensions: [],
   source: {
@@ -196,6 +224,8 @@ var BOOK_PRESET = {
     icc: "profiles/CGATS21_CRPC1.icc",
     stripAnnotations: true,
     blackText: "icc",
+    transparency: "flatten-page",
+    flattenPages: [],
     rasterDpi: undefined
   },
   page: {
@@ -203,7 +233,8 @@ var BOOK_PRESET = {
     height: 648,
     tolerance: 0.5,
     bleed: undefined,
-    safe: 18
+    safe: 18,
+    artSafe: undefined
   },
   ink: {
     maxTac: 400,
@@ -225,6 +256,10 @@ var BOOK_PRESET = {
         enabled: true,
         severity: "error"
       },
+      "pdf.print.safe-margins": {
+        enabled: true,
+        severity: "warning"
+      },
       "pdf.print.pdfx-markers": false,
       "pdf.print.pdfx-metadata": false
     },
@@ -259,6 +294,7 @@ var BOOK_PRESET = {
 };
 var CUSTOM_PRESET = {
   ...BOOK_PRESET,
+  id: "custom",
   page: null,
   defaultTargets: []
 };
@@ -304,7 +340,8 @@ var DTRPG_TARGET = {
         "pdf.structure.qpdf": { enabled: true, severity: "error" },
         "pdf.print.pdfx-markers": { enabled: true, severity: "error" },
         "pdf.print.pdfx-metadata": { enabled: true, severity: "error" },
-        "pdf.print.embedded-fonts": { enabled: true, severity: "error" }
+        "pdf.print.embedded-fonts": { enabled: true, severity: "error" },
+        "pdf.print.safe-margins": { enabled: true, severity: "error" }
       },
       assets: {
         allowedColorSpaces: [...DTRPG_PRESET.validate.assets.allowedColorSpaces]
@@ -319,7 +356,8 @@ var DTRPG_TARGET = {
     "pdf.structure.qpdf",
     "pdf.print.pdfx-markers",
     "pdf.print.pdfx-metadata",
-    "pdf.print.embedded-fonts"
+    "pdf.print.embedded-fonts",
+    "pdf.print.safe-margins"
   ],
   requiredTools: ["qpdf", "gs"]
 };
@@ -334,6 +372,7 @@ var ITCH_TARGET = {
         "pdf.print.pdfx-markers": false,
         "pdf.print.pdfx-metadata": false,
         "pdf.print.ink-coverage": false,
+        "pdf.print.safe-margins": false,
         "asset.image.tac-raster": false
       },
       assets: {
@@ -552,7 +591,8 @@ function resolveCustomPage(c, m) {
     height,
     tolerance: c.page?.tolerance ?? m.page?.tolerance ?? 0.5,
     bleed: c.page?.bleed ?? m.page?.bleed,
-    safe: c.page?.safe ?? m.page?.safe
+    safe: c.page?.safe ?? m.page?.safe,
+    artSafe: c.page?.artSafe ?? m.page?.artSafe
   };
 }
 function resolveWithPreset(cliOverrides, manifest, preset) {
@@ -585,6 +625,14 @@ function resolveWithPreset(cliOverrides, manifest, preset) {
   if (lastPage !== undefined && lastPage !== "blank" && lastPage !== "short-by-one") {
     throw new UsageError(`Manifest field \`print.lastPage\` must be "blank" or "short-by-one", got ${JSON.stringify(lastPage)}.`);
   }
+  const transparency = c.pdfx?.transparency ?? m.pdfx?.transparency;
+  if (transparency !== undefined && transparency !== "flatten-page" && transparency !== "preserve-text") {
+    throw new UsageError(`Manifest field \`pdfx.transparency\` must be "flatten-page" or "preserve-text", got ${JSON.stringify(transparency)}.`);
+  }
+  const flattenPages = c.pdfx?.flattenPages ?? m.pdfx?.flattenPages;
+  if (flattenPages !== undefined && !(Array.isArray(flattenPages) && flattenPages.every((n) => Number.isInteger(n) && n >= 1))) {
+    throw new UsageError(`Manifest field \`pdfx.flattenPages\` must be a list of page numbers (1, 2, …), got ${JSON.stringify(flattenPages)}.`);
+  }
   const rasterDpi = c.pdfx?.rasterDpi ?? m.pdfx?.rasterDpi;
   if (rasterDpi !== undefined && !(Number.isInteger(rasterDpi) && rasterDpi >= 72 && rasterDpi <= 1200)) {
     throw new UsageError(`Manifest field \`pdfx.rasterDpi\` must be a whole number from 72 to 1200, got ${JSON.stringify(rasterDpi)}.`);
@@ -597,6 +645,8 @@ function resolveWithPreset(cliOverrides, manifest, preset) {
   return {
     title: c.title ?? m.title ?? "Document",
     authors: c.authors ?? m.authors ?? [],
+    preset: preset.id,
+    spec: preset.spec,
     styles: c.styles ?? m.styles,
     extensions,
     targets: resolveTargets(c.targets ?? m.targets, preset.defaultTargets),
@@ -4876,346 +4926,6 @@ function inspectionFailed(checkId, message, extra = {}) {
   };
 }
 
-// src/lib/pdf-inspect.ts
-import { stat as stat2, readFile as readFile7 } from "node:fs/promises";
-import { getDocumentProxy } from "unpdf";
-import * as pdfjs from "unpdf/pdfjs";
-function getOps(mod) {
-  if ("OPS" in mod && mod.OPS && typeof mod.OPS === "object") {
-    return mod.OPS;
-  }
-  throw new Error("unpdf/pdfjs missing OPS export");
-}
-var OPS = getOps(pdfjs);
-var docCache = new Map;
-var DOC_CACHE_MAX = 8;
-function destroyEntry(entry) {
-  entry.doc.then((d) => d.destroy()).catch(() => {});
-}
-var EVICT_DESTROY_GRACE_MS = 60000;
-var gracePending = new Map;
-function destroyEntryAfterGrace(entry) {
-  const t = setTimeout(() => {
-    gracePending.delete(t);
-    destroyEntry(entry);
-  }, EVICT_DESTROY_GRACE_MS);
-  t.unref?.();
-  gracePending.set(t, entry);
-}
-function evictLru() {
-  while (docCache.size > DOC_CACHE_MAX) {
-    const oldestKey = docCache.keys().next().value;
-    if (oldestKey === undefined)
-      break;
-    const evicted = docCache.get(oldestKey);
-    docCache.delete(oldestKey);
-    if (evicted)
-      destroyEntryAfterGrace(evicted);
-  }
-}
-async function loadPdf(path6) {
-  let st;
-  try {
-    st = await stat2(path6);
-  } catch {
-    return null;
-  }
-  const hit = docCache.get(path6);
-  if (hit && hit.mtimeMs === st.mtimeMs && hit.size === st.size) {
-    docCache.delete(path6);
-    docCache.set(path6, hit);
-    try {
-      return await hit.doc;
-    } catch {
-      return null;
-    }
-  }
-  if (hit)
-    destroyEntry(hit);
-  const docPromise = readFile7(path6).then((buf) => getDocumentProxy(new Uint8Array(buf)));
-  docCache.delete(path6);
-  docCache.set(path6, { mtimeMs: st.mtimeMs, size: st.size, doc: docPromise });
-  evictLru();
-  try {
-    return await docPromise;
-  } catch {
-    if (docCache.get(path6)?.doc === docPromise)
-      docCache.delete(path6);
-    return null;
-  }
-}
-var activeRetains = 0;
-function retainPdfCache() {
-  activeRetains++;
-  let released = false;
-  return () => {
-    if (released)
-      return;
-    released = true;
-    activeRetains--;
-    if (activeRetains === 0)
-      clearPdfCache();
-  };
-}
-function clearPdfCache() {
-  for (const [t, entry] of gracePending) {
-    clearTimeout(t);
-    destroyEntry(entry);
-  }
-  gracePending.clear();
-  for (const entry of docCache.values())
-    destroyEntry(entry);
-  docCache.clear();
-}
-function getPageSize(page) {
-  const vp = page.getViewport({ scale: 1 });
-  return { w: vp.width, h: vp.height };
-}
-async function getOutlineCount(doc) {
-  try {
-    const outline = await doc.getOutline();
-    return outline ? outline.length : 0;
-  } catch {
-    return 0;
-  }
-}
-async function getPageLabels(doc) {
-  try {
-    return await doc.getPageLabels();
-  } catch {
-    return null;
-  }
-}
-async function countLinkAnnotations(doc, stopAtFirst = false) {
-  let count = 0;
-  for (let i = 1;i <= doc.numPages; i++) {
-    try {
-      const page = await doc.getPage(i);
-      const annots = await page.getAnnotations();
-      for (const a of annots) {
-        if (a.subtype === "Link") {
-          count++;
-          if (stopAtFirst)
-            return count;
-        }
-      }
-    } catch {}
-  }
-  return count;
-}
-var textCache = new WeakMap;
-function getTextPass(doc) {
-  let p = textCache.get(doc);
-  if (!p) {
-    p = (async () => {
-      const textByPage = [];
-      const positions = [];
-      const runsByPage = [];
-      for (let i = 1;i <= doc.numPages; i++) {
-        try {
-          const page = await doc.getPage(i);
-          const tc = await page.getTextContent();
-          let pageText = "";
-          const runs = [];
-          for (const item of tc.items) {
-            const it = item;
-            if (typeof it.str !== "string")
-              continue;
-            pageText += it.str;
-            if (it.transform && it.str.trim().length > 0) {
-              const x = it.transform[4];
-              const y = it.transform[5];
-              positions.push({ x, y });
-              runs.push({ s: it.str, x, y, w: it.width ?? 0, h: it.height ?? 0 });
-            }
-          }
-          textByPage.push(pageText);
-          runsByPage.push(runs);
-        } catch {
-          textByPage.push("");
-          runsByPage.push([]);
-        }
-      }
-      return { textByPage, positions, runsByPage };
-    })();
-    textCache.set(doc, p);
-  }
-  return p;
-}
-var opCache = new WeakMap;
-function multiply(m1, m2) {
-  return [
-    m1[0] * m2[0] + m1[2] * m2[1],
-    m1[1] * m2[0] + m1[3] * m2[1],
-    m1[0] * m2[2] + m1[2] * m2[3],
-    m1[1] * m2[2] + m1[3] * m2[3],
-    m1[0] * m2[4] + m1[2] * m2[5] + m1[4],
-    m1[1] * m2[4] + m1[3] * m2[5] + m1[5]
-  ];
-}
-function fontIsEmbedded(f) {
-  if (f.isType3Font)
-    return true;
-  if (f.missingFile === true)
-    return false;
-  if (f.isStandardFont === true)
-    return false;
-  return true;
-}
-function getOpPass(doc) {
-  let p = opCache.get(doc);
-  if (!p) {
-    p = (async () => {
-      const imagesByPage = new Map;
-      const fonts = [];
-      const seenFonts = new Set;
-      for (let i = 1;i <= doc.numPages; i++) {
-        let page;
-        try {
-          page = await doc.getPage(i);
-        } catch {
-          continue;
-        }
-        let ops;
-        try {
-          ops = await page.getOperatorList();
-        } catch {
-          continue;
-        }
-        let ctm = [1, 0, 0, 1, 0, 0];
-        const stack = [];
-        const pageImages = [];
-        for (let j = 0;j < ops.fnArray.length; j++) {
-          const fn = ops.fnArray[j];
-          const args = ops.argsArray[j];
-          if (fn === OPS.save) {
-            stack.push(ctm.slice());
-          } else if (fn === OPS.restore) {
-            ctm = stack.pop() ?? ctm;
-          } else if (fn === OPS.transform) {
-            ctm = multiply(ctm, args);
-          } else if (fn === OPS.paintImageXObject || fn === OPS.paintImageXObjectRepeat || fn === OPS.paintInlineImageXObject) {
-            const name = typeof args[0] === "string" ? args[0] : "(inline)";
-            pageImages.push({
-              name,
-              placedW: Math.hypot(ctm[0], ctm[1]),
-              placedH: Math.hypot(ctm[2], ctm[3]),
-              x: ctm[4],
-              y: ctm[5],
-              page: i
-            });
-          } else if (fn === OPS.setFont) {
-            const ref = args[0];
-            if (typeof ref === "string" && !seenFonts.has(ref)) {
-              seenFonts.add(ref);
-              try {
-                if (page.commonObjs.has(ref)) {
-                  const f = page.commonObjs.get(ref);
-                  fonts.push({
-                    name: f?.name ?? ref,
-                    embedded: fontIsEmbedded(f ?? {})
-                  });
-                }
-              } catch {}
-            }
-          }
-        }
-        if (pageImages.length > 0)
-          imagesByPage.set(i, pageImages);
-      }
-      return { imagesByPage, fonts };
-    })();
-    opCache.set(doc, p);
-  }
-  return p;
-}
-function getImagePixelSize(page, name, timeoutMs = 2000) {
-  return new Promise((resolve4) => {
-    let done = false;
-    const finish = (v) => {
-      if (!done) {
-        done = true;
-        resolve4(v);
-      }
-    };
-    const t = setTimeout(() => finish(null), timeoutMs);
-    try {
-      page.objs.get(name, (obj) => {
-        clearTimeout(t);
-        finish(obj && obj.width && obj.height ? { width: obj.width, height: obj.height } : null);
-      });
-    } catch {
-      clearTimeout(t);
-      finish(null);
-    }
-  });
-}
-var PAINT_OPS = new Set([
-  "stroke",
-  "closeStroke",
-  "fill",
-  "eoFill",
-  "fillStroke",
-  "eoFillStroke",
-  "closeFillStroke",
-  "closeEOFillStroke",
-  "shadingFill",
-  "paintImageXObject",
-  "paintInlineImageXObject",
-  "paintImageXObjectRepeat",
-  "paintImageMaskXObject",
-  "paintImageMaskXObjectGroup",
-  "paintImageMaskXObjectRepeat",
-  "paintSolidColorImageMask",
-  "showText",
-  "showSpacedText",
-  "nextLineShowText",
-  "nextLineSetSpacingShowText"
-].map((name) => OPS[name]).filter((op) => op !== undefined));
-async function pageHasMarks(doc, pageNum) {
-  const ops = await (await doc.getPage(pageNum)).getOperatorList();
-  return ops.fnArray.some((fn, i) => fn === OPS.constructPath ? PAINT_OPS.has(ops.argsArray[i][0]) : PAINT_OPS.has(fn));
-}
-async function getImageResolutions(doc) {
-  const { imagesByPage } = await getOpPass(doc);
-  const out = [];
-  for (const [pageNum, imgs] of imagesByPage) {
-    let page;
-    try {
-      page = await doc.getPage(pageNum);
-    } catch {
-      continue;
-    }
-    for (const img of imgs) {
-      if (img.name === "(inline)")
-        continue;
-      const px = await getImagePixelSize(page, img.name);
-      if (!px)
-        continue;
-      const placedWin = img.placedW / 72;
-      const placedHin = img.placedH / 72;
-      if (placedWin <= 0 || placedHin <= 0)
-        continue;
-      out.push({
-        page: pageNum,
-        xDpi: px.width / placedWin,
-        yDpi: px.height / placedHin
-      });
-    }
-  }
-  return out;
-}
-async function isLoadable(doc) {
-  try {
-    for (let i = 1;i <= doc.numPages; i++) {
-      await doc.getPage(i);
-    }
-    return true;
-  } catch {
-    return false;
-  }
-}
-
 // src/checks/pdf/qpdf-structure.ts
 var check = {
   id: "pdf.structure.qpdf",
@@ -5272,6 +4982,79 @@ var check2 = {
 };
 registerCheck(check2);
 
+// src/checks/pdf/safe-margins.ts
+var TOLERANCE_PT = 0.5;
+var ABOVE_BASELINE = 0.8;
+var BELOW_BASELINE = 0.2;
+var inches = (pt) => `${+(pt / 72).toFixed(2)}in`;
+var check3 = {
+  id: "pdf.print.safe-margins",
+  name: "Safe margins",
+  description: "Fails when text sits closer to the trim than `page.safe` (DriveThruRPG: 0.5in on every edge). Text only: art is judged in the preview's safe-area overlay, not here. Skipped when `page.safe` is not set",
+  category: "pdf",
+  phase: "post-build",
+  async run(ctx) {
+    const { width, height, bleed = 0, safe = 0 } = ctx.config.page;
+    if (!ctx.pdfPath || !safe)
+      return [];
+    const doc = await loadPdf(ctx.pdfPath);
+    if (!doc) {
+      return [inspectionFailed(check3.id, "Could not parse the PDF's text positions.", { file: ctx.pdfPath })];
+    }
+    const rule = ctx.config.spec?.label ?? "page.safe";
+    const results = [];
+    try {
+      for (let pageNum = 1;pageNum <= doc.numPages; pageNum++) {
+        const recto = pageNum % 2 === 1;
+        const trim = {
+          left: recto ? 0 : bleed,
+          right: width - (recto ? bleed : 0),
+          bottom: bleed,
+          top: height - bleed
+        };
+        const { items } = await (await doc.getPage(pageNum)).getTextContent();
+        for (const item of items) {
+          if (!("str" in item) || !item.str.trim())
+            continue;
+          const [a, b, c, d, e, f] = item.transform;
+          const along = item.width / Math.hypot(a, b);
+          const xs = [];
+          const ys = [];
+          for (const s of [0, 1]) {
+            for (const u of [-BELOW_BASELINE, ABOVE_BASELINE]) {
+              xs.push(e + s * along * a + u * c);
+              ys.push(f + s * along * b + u * d);
+            }
+          }
+          const gaps = [
+            [recto ? "binding" : "outside", Math.min(...xs) - trim.left],
+            [recto ? "outside" : "binding", trim.right - Math.max(...xs)],
+            ["bottom", Math.min(...ys) - trim.bottom],
+            ["top", trim.top - Math.max(...ys)]
+          ];
+          const [edge, gap] = gaps.reduce((worst, g) => g[1] < worst[1] ? g : worst);
+          const shortfall = safe - gap;
+          if (shortfall <= TOLERANCE_PT)
+            continue;
+          const text = item.str.trim();
+          results.push(finding(check3.id, {
+            severity: "error",
+            message: `Page ${pageNum}: "${text.slice(0, 40)}${text.length > 40 ? "…" : ""}" is ${inches(shortfall)} too close to the ${edge} edge.`,
+            file: ctx.pdfPath,
+            detail: `${rule}: text must stay at least ${inches(safe)} inside the trim on every edge.`,
+            code: "text-outside-safe-margin",
+            data: { page: pageNum, edge, shortfallPt: +shortfall.toFixed(2) }
+          }));
+        }
+      }
+    } catch {
+      return [inspectionFailed(check3.id, "Could not read the PDF's text positions.", { file: ctx.pdfPath })];
+    }
+    return results;
+  }
+};
+registerCheck(check3);
+
 // src/checks/pdf/pdfx-structure.ts
 function isObject(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
@@ -5380,7 +5163,7 @@ function getPdfxMetadataIssues(objects, flavor) {
 }
 
 // src/checks/pdf/pdfx-markers.ts
-var check3 = {
+var check4 = {
   id: "pdf.print.pdfx-markers",
   name: "PDF/X Markers",
   description: "Checks PDF/X OutputIntent structure via qpdf JSON",
@@ -5399,27 +5182,27 @@ var check3 = {
       const objects = parseQpdfObjectsJson(stdout);
       if (!objects) {
         return [
-          inspectionFailed(check3.id, "Unable to parse qpdf JSON output for PDF/X checks.", { file: ctx.pdfPath })
+          inspectionFailed(check4.id, "Unable to parse qpdf JSON output for PDF/X checks.", { file: ctx.pdfPath })
         ];
       }
-      return getPdfxOutputIntentIssues(objects).map((message) => finding(check3.id, {
+      return getPdfxOutputIntentIssues(objects).map((message) => finding(check4.id, {
         severity: "error",
         message,
         file: ctx.pdfPath
       }));
     } catch {
       return [
-        inspectionFailed(check3.id, "Failed to inspect PDF objects with qpdf for PDF/X markers.", { file: ctx.pdfPath })
+        inspectionFailed(check4.id, "Failed to inspect PDF objects with qpdf for PDF/X markers.", { file: ctx.pdfPath })
       ];
     }
   }
 };
-registerCheck(check3);
+registerCheck(check4);
 
 // src/lib/pdf-parse.ts
-import { readFile as readFile8 } from "node:fs/promises";
+import { readFile as readFile7 } from "node:fs/promises";
 async function readPdfBytes(pdfPath) {
-  return readFile8(pdfPath, "latin1");
+  return readFile7(pdfPath, "latin1");
 }
 function parseInkCov(out) {
   const lines = out.split(/\r?\n/).filter((l) => l.includes("CMYK"));
@@ -5467,7 +5250,7 @@ async function getPerPageInkCoverage(pdfPath) {
 }
 
 // src/checks/pdf/color-spaces.ts
-var check4 = {
+var check5 = {
   id: "pdf.print.color-spaces",
   name: "Color Spaces",
   description: "Checks for forbidden color spaces (DeviceRGB, Lab, Separation, DeviceN)",
@@ -5480,7 +5263,7 @@ var check4 = {
     const results = [];
     if (/\/DeviceRGB/.test(bytes)) {
       results.push({
-        checkId: check4.id,
+        checkId: check5.id,
         severity: "error",
         message: "DeviceRGB found (interior must be CMYK or grayscale only).",
         file: ctx.pdfPath
@@ -5488,7 +5271,7 @@ var check4 = {
     }
     if (/\/Lab\b/.test(bytes)) {
       results.push({
-        checkId: check4.id,
+        checkId: check5.id,
         severity: "error",
         message: "Lab color space found (not allowed).",
         file: ctx.pdfPath
@@ -5496,7 +5279,7 @@ var check4 = {
     }
     if (/\/Separation/.test(bytes)) {
       results.push({
-        checkId: check4.id,
+        checkId: check5.id,
         severity: "error",
         message: "Spot color (Separation) found (not allowed).",
         file: ctx.pdfPath
@@ -5504,7 +5287,7 @@ var check4 = {
     }
     if (/\/DeviceN/.test(bytes)) {
       results.push({
-        checkId: check4.id,
+        checkId: check5.id,
         severity: "error",
         message: "Spot color (DeviceN) found (not allowed).",
         file: ctx.pdfPath
@@ -5513,10 +5296,10 @@ var check4 = {
     return results;
   }
 };
-registerCheck(check4);
+registerCheck(check5);
 
 // src/checks/pdf/embedded-fonts.ts
-var check5 = {
+var check6 = {
   id: "pdf.print.embedded-fonts",
   name: "Embedded Fonts",
   description: "Verifies all fonts in the PDF are embedded",
@@ -5532,7 +5315,7 @@ var check5 = {
     if (fonts.length === 0) {
       return [
         {
-          checkId: check5.id,
+          checkId: check6.id,
           severity: "warning",
           message: "No fonts detected (unexpected).",
           file: ctx.pdfPath,
@@ -5545,7 +5328,7 @@ var check5 = {
       const names = notEmbedded.map((f) => f.name);
       return [
         {
-          checkId: check5.id,
+          checkId: check6.id,
           severity: "error",
           message: `Not all fonts are embedded (${names.join(", ")}). Check @font-face and Chromium output.`,
           file: ctx.pdfPath,
@@ -5557,10 +5340,10 @@ var check5 = {
     return [];
   }
 };
-registerCheck(check5);
+registerCheck(check6);
 
 // src/checks/pdf/ink-coverage.ts
-var check6 = {
+var check7 = {
   id: "pdf.print.ink-coverage",
   name: "Ink Coverage (TAC)",
   description: "Checks total area coverage (TAC) against maximum ink limits",
@@ -5574,7 +5357,7 @@ var check6 = {
     if (!inkResult.ok) {
       return [
         {
-          checkId: check6.id,
+          checkId: check7.id,
           severity: "warning",
           message: "Ink coverage could not be measured",
           file: ctx.pdfPath,
@@ -5599,7 +5382,7 @@ var check6 = {
     }
     return [
       {
-        checkId: check6.id,
+        checkId: check7.id,
         severity: "warning",
         message: `Total ink coverage too high on ${offending.length} page(s) (max ${maxTac.toFixed(1)}%, recommended <=${ctx.config.ink.maxTac}%)`,
         file: ctx.pdfPath,
@@ -5623,10 +5406,10 @@ var check6 = {
     ];
   }
 };
-registerCheck(check6);
+registerCheck(check7);
 
 // src/checks/pdf/rasterized-pages.ts
-var check7 = {
+var check8 = {
   id: "pdf.print.rasterized-pages",
   name: "Rasterized Pages",
   description: "Detects pages that appear to be fully rasterized (CSS filters, blend modes, transparency)",
@@ -5666,7 +5449,7 @@ var check7 = {
     rasterizedPages.sort((a, b) => a - b);
     return [
       {
-        checkId: check7.id,
+        checkId: check8.id,
         severity: "warning",
         message: `Possible rasterized pages detected: ${rasterizedPages.join(", ")}`,
         file: ctx.pdfPath,
@@ -5677,11 +5460,11 @@ var check7 = {
     ];
   }
 };
-registerCheck(check7);
+registerCheck(check8);
 
 // src/checks/pdf/black-text.ts
-import { readFile as readFile9 } from "node:fs/promises";
-var check8 = {
+import { readFile as readFile8 } 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)",
@@ -5693,11 +5476,11 @@ var check8 = {
       return [];
     try {
       const { findRichBlackText, LARGE_TEXT_PT } = await import("./black-text-gray-7dz61456.js");
-      const found = await findRichBlackText(await readFile9(ctx.pdfPath));
+      const found = await findRichBlackText(await readFile8(ctx.pdfPath));
       if (found.runs === 0)
         return [];
       return [
-        finding(check8.id, {
+        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,
@@ -5708,17 +5491,17 @@ var check8 = {
       ];
     } catch {
       return [
-        inspectionFailed(check8.id, "Could not inspect the PDF's text colours.", {
+        inspectionFailed(check9.id, "Could not inspect the PDF's text colours.", {
           file: ctx.pdfPath
         })
       ];
     }
   }
 };
-registerCheck(check8);
+registerCheck(check9);
 
 // src/checks/pdf/signature.ts
-var check9 = {
+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)",
@@ -5730,7 +5513,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;
@@ -5739,7 +5522,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,
@@ -5755,10 +5538,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,
@@ -5769,10 +5552,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",
@@ -5786,14 +5569,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
@@ -5803,10 +5586,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",
@@ -5821,7 +5604,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
@@ -5832,7 +5615,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
@@ -5842,10 +5625,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",
@@ -5858,7 +5641,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
@@ -5868,7 +5651,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
@@ -5876,10 +5659,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",
@@ -5894,7 +5677,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
@@ -5902,10 +5685,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",
@@ -5932,7 +5715,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
@@ -5942,10 +5725,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",
@@ -5967,7 +5750,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
@@ -5977,7 +5760,7 @@ var check15 = {
     return [];
   }
 };
-registerCheck(check15);
+registerCheck(check16);
 
 // src/checks/pdf/bleed.ts
 function findBox(bytes, box) {
@@ -5987,7 +5770,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",
@@ -6001,7 +5784,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
         })
       ];
@@ -6011,14 +5794,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
@@ -6031,7 +5814,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
@@ -6042,10 +5825,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",
@@ -6064,25 +5847,25 @@ 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/markdownlint.ts
-import { readFile as readFile10 } from "node:fs/promises";
+import { readFile as readFile9 } from "node:fs/promises";
 import { lint } from "markdownlint/sync";
 import { parse as parseYaml2 } from "yaml";
 
@@ -6115,7 +5898,7 @@ function stripJsonComments(s) {
   return s.replace(/\/\*[\s\S]*?\*\//g, "").replace(/(^|[^:])\/\/.*$/gm, "$1");
 }
 async function loadConfig(configPath) {
-  const raw = await readFile10(configPath, "utf8");
+  const raw = await readFile9(configPath, "utf8");
   let parsed;
   if (configPath.endsWith(".json")) {
     parsed = JSON.parse(raw);
@@ -6134,7 +5917,7 @@ async function loadConfig(configPath) {
   return {};
 }
 var MARKDOWNLINT_CHECK_ID = "source.markdownlint";
-var check18 = {
+var check19 = {
   id: MARKDOWNLINT_CHECK_ID,
   name: "Markdownlint",
   description: "Runs markdownlint with project config to validate Markdown files",
@@ -6159,7 +5942,7 @@ var check18 = {
         continue;
       for (const v of violations) {
         out.push({
-          checkId: check18.id,
+          checkId: check19.id,
           severity: "warning",
           message: `${v.ruleDescription} (${v.ruleNames.join("/")})`,
           file,
@@ -6172,15 +5955,15 @@ var check18 = {
     return out;
   }
 };
-registerCheck(check18);
+registerCheck(check19);
 
 // src/checks/source/htmlhint.ts
 import { existsSync as existsSync7 } from "node:fs";
-import { readFile as readFile11 } from "node:fs/promises";
+import { readFile as readFile10 } from "node:fs/promises";
 import htmlhint from "htmlhint";
 var { HTMLHint } = htmlhint;
 var CONFIG_NAMES2 = [".htmlhintrc"];
-var check19 = {
+var check20 = {
   id: "source.htmlhint",
   name: "HTMLHint",
   description: "Runs htmlhint with project config to validate generated HTML",
@@ -6196,11 +5979,11 @@ var check19 = {
     const resolvedConfig = findConfigFile(ctx.inputDir, CONFIG_NAMES2, configPath);
     if (!resolvedConfig && !configPath)
       return [];
-    const ruleset = resolvedConfig ? JSON.parse(await readFile11(resolvedConfig, "utf8")) : HTMLHint.defaultRuleset;
-    const html = await readFile11(ctx.htmlPath, "utf8");
+    const ruleset = resolvedConfig ? JSON.parse(await readFile10(resolvedConfig, "utf8")) : HTMLHint.defaultRuleset;
+    const html = await readFile10(ctx.htmlPath, "utf8");
     const messages = HTMLHint.verify(html, ruleset);
     return messages.map((m) => ({
-      checkId: check19.id,
+      checkId: check20.id,
       severity: m.type === "error" ? "error" : "warning",
       message: `${m.rule.id}: ${m.message}`,
       file: ctx.htmlPath,
@@ -6209,10 +5992,10 @@ var check19 = {
     }));
   }
 };
-registerCheck(check19);
+registerCheck(check20);
 
 // src/checks/source/stylelint.ts
-import { readFile as readFile12 } from "node:fs/promises";
+import { readFile as readFile11 } from "node:fs/promises";
 
 // src/lib/printsafe.ts
 import postcss from "postcss";
@@ -6554,7 +6337,7 @@ function checkCssRaw(css, from) {
       warnings.push({
         rule: ruleRiskyProps,
         severity: "warning",
-        message: `"${decl.prop}: ${decl.value}" prints blank in PDF/X exports (--format pdfx): Chromium emits repeating-*-gradient() and conic-gradient() in a form Ghostscript cannot convert. Plain PDF output is unaffected. Use linear-gradient() or radial-gradient() instead; for 0deg/90deg stripes write "linear-gradient(90deg, #b33 0 6px, #c8c5bf 6px 10px)" with "background-size: 10px 100%", and for anything else a small tiled image.`,
+        message: `"${decl.prop}: ${decl.value}" is at risk in PDF/X exports (--format pdfx): Chromium emits repeating-*-gradient() and conic-gradient() in a form Ghostscript has been seen to paint as nothing or as irregular stripes, so it can print blank or distorted, unless the page also uses transparency and Ghostscript flattens the whole page to an image, which keeps the gradient but loses that page's live text. Plain PDF output is unaffected. Use linear-gradient() or radial-gradient() instead; for 0deg/90deg stripes write "linear-gradient(90deg, #b33 0 6px, #c8c5bf 6px 10px)" with "background-size: 10px 100%", and for anything else a small tiled image.`,
         ...nodeLoc(decl)
       });
     } else if (isUnpairedFitContentWidth(decl)) {
@@ -6602,7 +6385,7 @@ function checkCssRaw(css, from) {
 }
 
 // src/checks/source/stylelint.ts
-var check20 = {
+var check21 = {
   id: "source.stylelint",
   name: "Print-safety CSS",
   description: "Checks CSS for print-safety issues (remote URLs, rasterizing effects, and page-layer containment)",
@@ -6619,10 +6402,10 @@ var check20 = {
     for (const file of files) {
       let css;
       try {
-        css = await readFile12(file, "utf8");
+        css = await readFile11(file, "utf8");
       } catch (err) {
         results.push({
-          checkId: check20.id,
+          checkId: check21.id,
           severity: "error",
           message: `Cannot read stylesheet: ${err instanceof Error ? err.message : String(err)}`,
           file
@@ -6631,7 +6414,7 @@ var check20 = {
       }
       for (const w of checkCss(css, file, { rules: ctx.config.lint.rules })) {
         results.push({
-          checkId: check20.id,
+          checkId: check21.id,
           severity: w.severity,
           message: `${w.rule}: ${w.message}`,
           file,
@@ -6643,10 +6426,10 @@ var check20 = {
     return results;
   }
 };
-registerCheck(check20);
+registerCheck(check21);
 
 // src/checks/source/css-ownership.ts
-import { readFile as readFile13 } from "node:fs/promises";
+import { readFile as readFile12 } from "node:fs/promises";
 
 // src/lib/style-resolver.ts
 import { existsSync as existsSync8 } from "node:fs";
@@ -6714,7 +6497,7 @@ import postcss2 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 readFile13(configPath, "utf8");
+  const raw = await readFile12(configPath, "utf8");
   const parsed = parseYaml3(raw);
   if (parsed && typeof parsed === "object")
     return parsed;
@@ -6827,7 +6610,7 @@ function checkOwnership(root, file, maps) {
   });
   return out;
 }
-var check21 = {
+var check22 = {
   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.",
@@ -6850,7 +6633,7 @@ var check21 = {
     } catch (err) {
       return [
         {
-          checkId: check21.id,
+          checkId: check22.id,
           severity: "error",
           message: `Failed to parse CSS ownership contract "${configPath}": ${err instanceof Error ? err.message : String(err)}`,
           file: configPath
@@ -6865,7 +6648,7 @@ var check21 = {
         continue;
       let css;
       try {
-        css = await readFile13(absFile, "utf8");
+        css = await readFile12(absFile, "utf8");
       } catch {
         continue;
       }
@@ -6892,7 +6675,7 @@ var check21 = {
       }
       for (const v of violations) {
         results.push({
-          checkId: check21.id,
+          checkId: check22.id,
           severity: "warning",
           message: v.message,
           file: absFile,
@@ -6904,7 +6687,7 @@ var check21 = {
     return results;
   }
 };
-registerCheck(check21);
+registerCheck(check22);
 
 // src/checks/source/local-refs.ts
 import { existsSync as existsSync9 } from "node:fs";
@@ -6912,7 +6695,7 @@ import { dirname as dirname3, resolve as resolve5 } from "node:path";
 
 // src/lib/asset-inline.ts
 import { createHash as createHash2 } from "node:crypto";
-import { readFile as readFile14 } from "node:fs/promises";
+import { readFile as readFile13 } from "node:fs/promises";
 import path7 from "node:path";
 import postcss3 from "postcss";
 var FONT_EXTS = new Set([".woff2", ".woff", ".ttf", ".otf"]);
@@ -6977,7 +6760,7 @@ function mimeFor(ext) {
 }
 async function readOrThrow(absPath, kind, referencedFrom) {
   try {
-    return await readFile14(absPath);
+    return await readFile13(absPath);
   } catch {
     throw new BuildError(`Missing ${kind}: ${absPath}
   referenced from ${referencedFrom}
@@ -7120,7 +6903,7 @@ async function collectStyleDependencies(projectDir, stylePaths) {
     found.add(abs);
     let source;
     try {
-      source = await readFile14(abs, "utf-8");
+      source = await readFile13(abs, "utf-8");
     } catch {
       return;
     }
@@ -7197,7 +6980,7 @@ async function inlineShapeUrls(html, baseDir) {
       continue;
     let bytes;
     try {
-      bytes = await readFile14(abs);
+      bytes = await readFile13(abs);
     } catch {
       continue;
     }
@@ -7215,7 +6998,7 @@ async function inlineShapeUrls(html, baseDir) {
 }
 
 // src/checks/source/local-ref-parser.ts
-import { readFile as readFile15 } from "node:fs/promises";
+import { readFile as readFile14 } from "node:fs/promises";
 function newlineOffsets(content) {
   const offsets = [];
   for (let i = 0;i < content.length; i++)
@@ -7284,7 +7067,7 @@ async function* renderedLocalRefs(ctx, checkId, results) {
   for (const file of files) {
     let refs;
     try {
-      refs = collectRenderedLocalRefs(await readFile15(file, "utf8"));
+      refs = collectRenderedLocalRefs(await readFile14(file, "utf8"));
     } catch {
       results.push(inspectionFailed(checkId, `Could not read source file: ${file}`, { file }));
       continue;
@@ -7295,7 +7078,7 @@ async function* renderedLocalRefs(ctx, checkId, results) {
 }
 
 // src/checks/source/local-refs.ts
-var check22 = {
+var check23 = {
   id: "source.links.local-refs",
   name: "Local Markdown References",
   description: "Checks local markdown links and image refs resolve on disk",
@@ -7303,12 +7086,12 @@ 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 (isNonFilesystemRef(ref))
         continue;
       const escape = kind === "image" ? proseImageRefError(ref, ctx.inputDir) : null;
       if (escape) {
-        results.push(finding(check22.id, {
+        results.push(finding(check23.id, {
           severity: "error",
           message: escape,
           file,
@@ -7318,7 +7101,7 @@ var check22 = {
       }
       if (localRefExists(ref, kind, file, ctx.inputDir))
         continue;
-      results.push(finding(check22.id, {
+      results.push(finding(check23.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}`,
@@ -7343,7 +7126,7 @@ function localRefExists(ref, kind, sourceFile, projectRoot) {
       return existsSync9(fileRelative);
   }
 }
-registerCheck(check22);
+registerCheck(check23);
 
 // src/lib/build-staging.ts
 import path8 from "node:path";
@@ -7609,7 +7392,7 @@ async function createStageRoot() {
 }
 
 // src/checks/source/dangling-links.ts
-var check23 = {
+var check24 = {
   id: "source.links.dangling",
   name: "Dangling Links",
   description: "Flags relative links the printed book cannot open (their href is dropped at print time)",
@@ -7617,10 +7400,10 @@ var check23 = {
   phase: "pre-build",
   async run(ctx) {
     const results = [];
-    for await (const { ref, kind, line, file } of renderedLocalRefs(ctx, check23.id, results)) {
+    for await (const { ref, kind, line, file } of renderedLocalRefs(ctx, check24.id, results)) {
       if (kind !== "link" || isPrintResolvableHref(ref))
         continue;
-      results.push(finding(check23.id, {
+      results.push(finding(check24.id, {
         severity: "warning",
         code: "dangling-link",
         data: { ref },
@@ -7632,11 +7415,11 @@ var check23 = {
     return results;
   }
 };
-registerCheck(check23);
+registerCheck(check24);
 
 // src/checks/source/accessibility-alt-text.ts
-import { readFile as readFile16 } from "node:fs/promises";
-var check24 = {
+import { readFile as readFile15 } from "node:fs/promises";
+var check25 = {
   id: "source.accessibility.alt-text",
   name: "Image Alt Text",
   description: "Checks markdown images include non-empty alt text",
@@ -7649,7 +7432,7 @@ var check24 = {
     const results = [];
     for (const file of files) {
       try {
-        const content = await readFile16(file, "utf8");
+        const content = await readFile15(file, "utf8");
         const lines = content.split(`
 `);
         let inFence = false;
@@ -7665,7 +7448,7 @@ var check24 = {
             if (alt.trim())
               continue;
             results.push({
-              checkId: check24.id,
+              checkId: check25.id,
               severity: "warning",
               message: "Image is missing alt text",
               file,
@@ -7690,11 +7473,11 @@ function extractImageAlts(line) {
   }
   return alts;
 }
-registerCheck(check24);
+registerCheck(check25);
 
 // src/checks/source/accessibility-heading-order.ts
-import { readFile as readFile17 } from "node:fs/promises";
-var check25 = {
+import { readFile as readFile16 } from "node:fs/promises";
+var check26 = {
   id: "source.accessibility.heading-order",
   name: "Heading Order",
   description: "Checks markdown heading levels do not jump by more than one",
@@ -7707,7 +7490,7 @@ var check25 = {
     const results = [];
     for (const file of files) {
       try {
-        const content = await readFile17(file, "utf8");
+        const content = await readFile16(file, "utf8");
         const lines = content.split(`
 `);
         let inFence = false;
@@ -7722,7 +7505,7 @@ var check25 = {
           if (inFence)
             continue;
           const comment = /^\s*<!--(.*)-->\s*$/.exec(line);
-          if (comment && parseDisableDirective(comment[1])?.includes(check25.id)) {
+          if (comment && parseDisableDirective(comment[1])?.includes(check26.id)) {
             silencedLine = i + 1;
             continue;
           }
@@ -7732,7 +7515,7 @@ var check25 = {
           const level = match[1].length;
           if (prevLevel != null && level > prevLevel + 1 && i !== silencedLine) {
             results.push({
-              checkId: check25.id,
+              checkId: check26.id,
               severity: "warning",
               message: `Heading level jump from h${prevLevel} to h${level}`,
               file,
@@ -7746,10 +7529,10 @@ var check25 = {
     return results;
   }
 };
-registerCheck(check25);
+registerCheck(check26);
 
 // src/checks/source/layout-markers.ts
-import { readFile as readFile18 } from "node:fs/promises";
+import { readFile as readFile17 } from "node:fs/promises";
 
 // src/lib/unknown-classes.ts
 import postcss4 from "postcss";
@@ -7852,12 +7635,12 @@ async function collectKnownClasses(ctx, plugins) {
   const sheets = (await collectStyleDependencies(ctx.inputDir, roots)).filter((f) => /\.css$/i.test(f));
   for (const sheet of sheets) {
     try {
-      addCssClasses(await readFile18(sheet, "utf8"), names);
+      addCssClasses(await readFile17(sheet, "utf8"), names);
     } catch {}
   }
   return names;
 }
-var check26 = {
+var check27 = {
   id: "source.markdown.layout-markers",
   name: "Layout Markers",
   description: "Reports @page/@section/@chapter marker arguments Gutterpress could not understand, plus any unknown gp-* class and any other class no stylesheet mentions",
@@ -7869,14 +7652,14 @@ var check26 = {
       return [];
     const results = [];
     const plugins = await loadPlugins(ctx.config.extensions, ctx.inputDir, (ref, error2) => {
-      results.push(inspectionFailed(check26.id, `Plugin "${ref}" could not be loaded, so markers it defines were not checked: ${error2.message}`));
+      results.push(inspectionFailed(check27.id, `Plugin "${ref}" could not be loaded, so markers it defines were not checked: ${error2.message}`));
     });
     const md = createMarkdownRenderer(plugins);
     let known;
     const knownClasses = () => known ??= collectKnownClasses(ctx, plugins);
     for (const file of files) {
       try {
-        const content = await readFile18(file, "utf8");
+        const content = await readFile17(file, "utf8");
         const env = {};
         const tokens = md.parse(content, env);
         md.renderer.render(tokens, md.options, env);
@@ -7888,7 +7671,7 @@ var check26 = {
             if (names.has(cls) || warnedLines.has(use.line))
               continue;
             const guess = nearestKnownClass(cls, names);
-            results.push(finding(check26.id, {
+            results.push(finding(check27.id, {
               severity: "warning",
               message: `Class ".${cls}" is not in any stylesheet (Gutterpress's own, the plugins', or this book's), so it styles nothing.` + (guess ? ` Did you mean ".${guess}"?` : "") + (use.count > 1 ? ` Used ${use.count} times in this file; the first is reported.` : ""),
               file,
@@ -7898,7 +7681,7 @@ var check26 = {
           }
         }
         for (const w of env.layoutWarnings ?? []) {
-          results.push(finding(check26.id, {
+          results.push(finding(check27.id, {
             severity: w.severity ?? "warning",
             message: w.message,
             file,
@@ -7907,16 +7690,16 @@ var check26 = {
           }));
         }
       } catch (error2) {
-        results.push(inspectionFailed(check26.id, `Could not check layout markers in ${file}: ${error2 instanceof Error ? error2.message : String(error2)}`, { file }));
+        results.push(inspectionFailed(check27.id, `Could not check layout markers in ${file}: ${error2 instanceof Error ? error2.message : String(error2)}`, { file }));
       }
     }
     return results;
   }
 };
-registerCheck(check26);
+registerCheck(check27);
 
 // src/checks/source/merge-markers.ts
-import { readFile as readFile19 } from "node:fs/promises";
+import { readFile as readFile18 } from "node:fs/promises";
 import path9 from "node:path";
 
 // src/checks/asset/extensions.ts
@@ -7946,7 +7729,7 @@ var CLOSE_SENTINEL = ">>>>>>> online version";
 function withoutOnlineTag(relPath) {
   return relPath.replace(/\.online(?=\.[^./]*$|$)/, "");
 }
-var check27 = {
+var check28 = {
   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",
@@ -7958,9 +7741,9 @@ var check27 = {
     for (const file of textFiles) {
       let content;
       try {
-        content = await readFile19(file, "utf8");
+        content = await readFile18(file, "utf8");
       } catch {
-        results.push(inspectionFailed(check27.id, `Could not read source file: ${file}`, { file }));
+        results.push(inspectionFailed(check28.id, `Could not read source file: ${file}`, { file }));
         continue;
       }
       if (!content.includes(OPEN_SENTINEL) && !content.includes(CLOSE_SENTINEL))
@@ -7972,7 +7755,7 @@ var check27 = {
         const line = lines[i].endsWith("\r") ? lines[i].slice(0, -1) : lines[i];
         if (line === OPEN_SENTINEL) {
           inBlock = true;
-          results.push(finding(check27.id, {
+          results.push(finding(check28.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.",
@@ -7981,7 +7764,7 @@ var check27 = {
           }));
         } else if (line === CLOSE_SENTINEL) {
           if (!inBlock) {
-            results.push(finding(check27.id, {
+            results.push(finding(check28.id, {
               severity: "error",
               code: "leftover-version-marker",
               message: "This marker line is left over from combining two versions — delete it.",
@@ -8002,7 +7785,7 @@ var check27 = {
       });
       for (const sibling of siblings.sort()) {
         const rel = path9.relative(ctx.inputDir, sibling).split(path9.sep).join("/");
-        results.push(finding(check27.id, {
+        results.push(finding(check28.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.`,
@@ -8010,15 +7793,15 @@ var check27 = {
         }));
       }
     } catch (error2) {
-      results.push(inspectionFailed(check27.id, `Could not scan for kept-both files: ${error2 instanceof Error ? error2.message : String(error2)}`));
+      results.push(inspectionFailed(check28.id, `Could not scan for kept-both files: ${error2 instanceof Error ? error2.message : String(error2)}`));
     }
     return results;
   }
 };
-registerCheck(check27);
+registerCheck(check28);
 
 // src/checks/source/characters.ts
-import { readFile as readFile20 } from "node:fs/promises";
+import { readFile as readFile19 } from "node:fs/promises";
 
 // src/checks/source/character-table.ts
 var CHARACTER_PATTERN = new RegExp("[\\u0000-\\u0008\\u000B\\u000C\\u000E-\\u001F\\u007F-\\u00A0\\u00AD\\u00B4\\u02BC" + "\\u061C\\u2000-\\u2015\\u2018\\u2019\\u201B-\\u201D\\u201F\\u2022\\u2026" + "\\u2028-\\u202F\\u2032\\u2033\\u205F\\u2060\\u2066-\\u2069\\u2190\\u2192" + "\\u2194\\u21D2\\u2212\\u25AA\\u25E6\\u2605\\u2713\\u2714\\u2717\\u3000" + "\\uE000-\\uF8FF\\uFEFF\\uFF02\\uFF07\\uFFFD]" + "|\\p{Emoji_Presentation}|\\p{Extended_Pictographic}(?=\\uFE0F)", "gu");
@@ -8130,7 +7913,7 @@ function codePointLabel(char) {
 
 // src/checks/source/characters.ts
 var PROBE = new RegExp(CHARACTER_PATTERN.source, "u");
-var check28 = {
+var check29 = {
   id: "source.characters",
   name: "Unusual Characters",
   description: "Finds invisible and control characters, odd spaces, and pasted typography (em dashes, curly quotes, emoji) in markdown",
@@ -8141,9 +7924,9 @@ var check28 = {
     for (const file of (ctx.markdownFiles ?? []).slice().sort()) {
       let content;
       try {
-        content = await readFile20(file, "utf8");
+        content = await readFile19(file, "utf8");
       } catch {
-        results.push(inspectionFailed(check28.id, `Could not read source file: ${file}`, { file }));
+        results.push(inspectionFailed(check29.id, `Could not read source file: ${file}`, { file }));
         continue;
       }
       if (!PROBE.test(content))
@@ -8154,7 +7937,7 @@ var check28 = {
       for (let i = 0;i < lines.length; i++) {
         const line = lines[i];
         const comment = /^\s*<!--(.*)-->\s*$/.exec(line);
-        if (comment && parseDisableDirective(comment[1])?.includes(check28.id)) {
+        if (comment && parseDisableDirective(comment[1])?.includes(check29.id)) {
           silencedLine = i + 1;
           continue;
         }
@@ -8163,7 +7946,7 @@ var check28 = {
         for (const match of line.matchAll(CHARACTER_PATTERN)) {
           const char = match[0];
           const { name, code, fix } = describeCharacter(char);
-          results.push(finding(check28.id, {
+          results.push(finding(check29.id, {
             severity: code === "typographer" ? "info" : "warning",
             code,
             message: `${name} (${codePointLabel(char)}). ${fix}`,
@@ -8178,19 +7961,19 @@ var check28 = {
     return results;
   }
 };
-registerCheck(check28);
+registerCheck(check29);
 
 // src/checks/asset/image-file-size.ts
-import { stat as stat4 } from "node:fs/promises";
+import { stat as stat3 } from "node:fs/promises";
 
 // src/lib/image-inspect.ts
-import { stat as stat3, readFile as readFile21 } from "node:fs/promises";
+import { stat as stat2, readFile as readFile20 } from "node:fs/promises";
 var DEFAULT_DPI = 72;
 var cache = new Map;
 async function inspectImage(path10) {
   let st;
   try {
-    st = await stat3(path10);
+    st = await stat2(path10);
   } catch {
     return null;
   }
@@ -8199,7 +7982,7 @@ async function inspectImage(path10) {
     return hit.info;
   let info3 = null;
   try {
-    const buf = await readFile21(path10);
+    const buf = await readFile20(path10);
     info3 = parseImage(buf);
   } catch {
     info3 = null;
@@ -8404,7 +8187,7 @@ async function collectImageFiles(dirs, exts, ignore2 = ASSET_SCAN_IGNORE_GLOBS)
 }
 
 // src/checks/asset/image-file-size.ts
-var check29 = {
+var check30 = {
   id: "asset.image.file-size",
   name: "Image File Size",
   description: "Checks that image files do not exceed the maximum size limit",
@@ -8421,18 +8204,18 @@ var check29 = {
     const results = [];
     for (const file of files) {
       try {
-        const info3 = await stat4(file);
+        const info3 = await stat3(file);
         if (info3.size > maxSize) {
           const sizeMb = (info3.size / 1e6).toFixed(1);
           const maxMb = (maxSize / 1e6).toFixed(1);
-          results.push(finding(check29.id, {
+          results.push(finding(check30.id, {
             severity: "warning",
             message: `Image file too large: ${sizeMb}MB (max ${maxMb}MB)`,
             file
           }));
         }
       } catch {
-        results.push(inspectionFailed(check29.id, `Could not stat image file: ${file}`, {
+        results.push(inspectionFailed(check30.id, `Could not stat image file: ${file}`, {
           file
         }));
       }
@@ -8440,10 +8223,10 @@ var check29 = {
     return results;
   }
 };
-registerCheck(check29);
+registerCheck(check30);
 
 // src/checks/asset/image-resolution.ts
-var check30 = {
+var check31 = {
   id: "asset.image.resolution",
   name: "Image Resolution",
   description: "Checks source image DPI from embedded density metadata",
@@ -8465,7 +8248,7 @@ var check30 = {
       const { xDpi, yDpi } = info3;
       if (xDpi > 0 && yDpi > 0 && (xDpi < minDpi || yDpi < minDpi)) {
         results.push({
-          checkId: check30.id,
+          checkId: check31.id,
           severity: "warning",
           message: `Image resolution too low: ${xDpi}x${yDpi} DPI (minimum ${minDpi} DPI)`,
           file
@@ -8475,7 +8258,7 @@ var check30 = {
     return results;
   }
 };
-registerCheck(check30);
+registerCheck(check31);
 
 // src/checks/asset/image-color-space.ts
 var LABEL = {
@@ -8483,7 +8266,7 @@ var LABEL = {
   gray: "Gray",
   cmyk: "CMYK"
 };
-var check31 = {
+var check32 = {
   id: "asset.image.color-space",
   name: "Image Color Space",
   description: "Validates image color spaces against allowed list",
@@ -8504,7 +8287,7 @@ var check31 = {
       const cs = info3?.colorSpace;
       if (cs && !allowedLower.has(cs)) {
         results.push({
-          checkId: check31.id,
+          checkId: check32.id,
           severity: "warning",
           message: `Image uses ${LABEL[cs] ?? cs} color space (allowed: ${allowed.join(", ")})`,
           file
@@ -8514,10 +8297,10 @@ var check31 = {
     return results;
   }
 };
-registerCheck(check31);
+registerCheck(check32);
 
 // src/checks/asset/image-alpha.ts
-var check32 = {
+var check33 = {
   id: "asset.image.alpha-channel",
   name: "Image Alpha Channel",
   description: "Checks for alpha channels in PNG/TIFF images",
@@ -8535,7 +8318,7 @@ var check32 = {
       const info3 = await inspectImage(file);
       if (info3?.hasAlpha) {
         results.push({
-          checkId: check32.id,
+          checkId: check33.id,
           severity: "warning",
           message: "Image contains alpha channel, which may cause print issues",
           file
@@ -8545,10 +8328,10 @@ var check32 = {
     return results;
   }
 };
-registerCheck(check32);
+registerCheck(check33);
 
 // src/checks/asset/image-tac.ts
-var check33 = {
+var check34 = {
   id: "asset.image.tac-raster",
   name: "Image TAC (Raster)",
   description: "Rasterizes and checks TAC per image using Ghostscript",
@@ -8567,7 +8350,7 @@ var check33 = {
     const ghostscript = await resolveGhostscript();
     if (!ghostscript) {
       return [
-        inspectionFailed(check33.id, "Could not inspect image ink coverage: Ghostscript executable not found")
+        inspectionFailed(check34.id, "Could not inspect image ink coverage: Ghostscript executable not found")
       ];
     }
     for (const file of files) {
@@ -8585,7 +8368,7 @@ var check33 = {
           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(check33.id, {
+              results.push(finding(check34.id, {
                 severity: "warning",
                 message: `Image TAC exceeds limit: ${tac.toFixed(1)}% (max ${maxTac}%)`,
                 file,
@@ -8597,16 +8380,16 @@ var check33 = {
           }
         }
       } catch {
-        results.push(inspectionFailed(check33.id, `Could not inspect image ink coverage: ${file}`, { file }));
+        results.push(inspectionFailed(check34.id, `Could not inspect image ink coverage: ${file}`, { file }));
       }
     }
     return results;
   }
 };
-registerCheck(check33);
+registerCheck(check34);
 
 // src/checks/asset/approved-fonts.ts
-var check34 = {
+var check35 = {
   id: "asset.font.approved-files",
   name: "Approved Font Files",
   description: "Checks font files against the approved file patterns",
@@ -8645,7 +8428,7 @@ var check34 = {
     for (const font of allFonts) {
       if (!approvedFonts.has(font)) {
         results.push({
-          checkId: check34.id,
+          checkId: check35.id,
           severity: "warning",
           message: "Font file not in approved list",
           file: font
@@ -8655,7 +8438,7 @@ var check34 = {
     return results;
   }
 };
-registerCheck(check34);
+registerCheck(check35);
 
 // src/checks/asset/font-license.ts
 import { existsSync as existsSync10 } from "node:fs";
@@ -8670,7 +8453,7 @@ var LICENSE_NAMES = [
   "OFL-1.1.txt",
   "COPYING"
 ];
-var check35 = {
+var check36 = {
   id: "asset.font.license",
   name: "Font License",
   description: "Checks for license files in font directories",
@@ -8697,7 +8480,7 @@ var check35 = {
       const hasLicense = LICENSE_NAMES.some((name) => existsSync10(resolve6(fontDir, name)));
       if (!hasLicense) {
         results.push({
-          checkId: check35.id,
+          checkId: check36.id,
           severity: "warning",
           message: `No font license file found in directory`,
           file: fontDir
@@ -8707,10 +8490,10 @@ var check35 = {
     return results;
   }
 };
-registerCheck(check35);
+registerCheck(check36);
 
 // src/checks/heuristic/text-density.ts
-var check36 = {
+var check37 = {
   id: "heuristic.whitespace.text-density",
   name: "Text Density",
   description: "Checks characters-per-page ratio",
@@ -8739,7 +8522,7 @@ var check36 = {
     });
     if (lowPages.length > 0) {
       results.push({
-        checkId: check36.id,
+        checkId: check37.id,
         severity: "info",
         message: `Low text density on pages: ${lowPages.join(", ")} (below ${range.min} chars)`,
         file: ctx.pdfPath
@@ -8747,7 +8530,7 @@ var check36 = {
     }
     if (highPages.length > 0) {
       results.push({
-        checkId: check36.id,
+        checkId: check37.id,
         severity: "info",
         message: `High text density on pages: ${highPages.join(", ")} (above ${range.max} chars)`,
         file: ctx.pdfPath
@@ -8756,11 +8539,11 @@ var check36 = {
     return results;
   }
 };
-registerCheck(check36);
+registerCheck(check37);
 
 // src/checks/heuristic/section-density.ts
-import { readFile as readFile22 } from "node:fs/promises";
-var check37 = {
+import { readFile as readFile21 } from "node:fs/promises";
+var check38 = {
   id: "heuristic.chunking.section-density",
   name: "Section Density",
   description: "Checks heading/paragraph/callout density from source Markdown",
@@ -8776,7 +8559,7 @@ var check37 = {
     const results = [];
     for (const file of files) {
       try {
-        const content = await readFile22(file, "utf8");
+        const content = await readFile21(file, "utf8");
         const lines = content.split(`
 `);
         let currentSectionStart = 0;
@@ -8786,7 +8569,7 @@ var check37 = {
           const line = lines[i];
           if (/^#{1,6}\s/.test(line)) {
             if (paragraphCount > maxParas) {
-              results.push(finding(check37.id, {
+              results.push(finding(check38.id, {
                 severity: "info",
                 message: `Section has ${paragraphCount} paragraphs (max recommended: ${maxParas})`,
                 file,
@@ -8806,7 +8589,7 @@ var check37 = {
           }
         }
         if (paragraphCount > maxParas) {
-          results.push(finding(check37.id, {
+          results.push(finding(check38.id, {
             severity: "info",
             message: `Section has ${paragraphCount} paragraphs (max recommended: ${maxParas})`,
             file,
@@ -8814,7 +8597,7 @@ var check37 = {
           }));
         }
       } catch {
-        results.push(inspectionFailed(check37.id, `Could not read source file: ${file}`, {
+        results.push(inspectionFailed(check38.id, `Could not read source file: ${file}`, {
           file
         }));
       }
@@ -8822,10 +8605,10 @@ var check37 = {
     return results;
   }
 };
-registerCheck(check37);
+registerCheck(check38);
 
 // src/checks/heuristic/layer-count.ts
-var check38 = {
+var check39 = {
   id: "heuristic.decoration.layer-count",
   name: "Layer Count",
   description: "Counts image objects per page",
@@ -8850,7 +8633,7 @@ var check38 = {
       heavyPages.sort((a, b) => a - b);
       return [
         {
-          checkId: check38.id,
+          checkId: check39.id,
           severity: "info",
           message: `Pages with many image layers (>${maxLayers}): ${heavyPages.join(", ")}`,
           file: ctx.pdfPath
@@ -8860,10 +8643,10 @@ var check38 = {
     return [];
   }
 };
-registerCheck(check38);
+registerCheck(check39);
 
 // src/checks/heuristic/placement-variance.ts
-var check39 = {
+var check40 = {
   id: "heuristic.layout.placement-variance",
   name: "Placement Variance",
   description: "Analyzes text baseline coordinates for layout consistency",
@@ -8881,7 +8664,7 @@ var check39 = {
     const uniqueX = new Set(positions.map((p) => Math.round(p.x)));
     return [
       {
-        checkId: check39.id,
+        checkId: check40.id,
         severity: "info",
         message: `Layout analysis: ${uniqueX.size} unique horizontal text positions across ${positions.length} text blocks.`,
         file: ctx.pdfPath
@@ -8889,21 +8672,21 @@ var check39 = {
     ];
   }
 };
-registerCheck(check39);
+registerCheck(check40);
 
 // src/checks/tool-check.ts
 async function checkToolAvailability(config, opts = {}) {
   const { checks: checks2 } = selectChecks(opts, config);
   const toolToChecks = new Map;
-  for (const check40 of checks2) {
-    if (!check40.requiredTools?.length)
+  for (const check41 of checks2) {
+    if (!check41.requiredTools?.length)
       continue;
-    for (const tool of check40.requiredTools) {
+    for (const tool of check41.requiredTools) {
       const existing = toolToChecks.get(tool);
       if (existing) {
-        existing.push(check40.id);
+        existing.push(check41.id);
       } else {
-        toolToChecks.set(tool, [check40.id]);
+        toolToChecks.set(tool, [check41.id]);
       }
     }
   }
@@ -8919,11 +8702,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 check40 of checks2) {
-    if (!check40.requiredTools?.length)
+  for (const check41 of checks2) {
+    if (!check41.requiredTools?.length)
       continue;
-    if (check40.requiredTools.some((t) => missingSet.has(t))) {
-      skippedChecks.push(check40.id);
+    if (check41.requiredTools.some((t) => missingSet.has(t))) {
+      skippedChecks.push(check41.id);
     }
   }
   return { available, missing, skippedChecks, toolToChecks };
@@ -9080,7 +8863,7 @@ async function restoreForCommand(dir, options) {
 }
 
 // src/lib/markdown/index.ts
-import { readdir as readdir3, readFile as readFile23, writeFile as writeFile2, mkdir as mkdir4 } from "node:fs/promises";
+import { readdir as readdir3, readFile as readFile22, writeFile as writeFile2, mkdir as mkdir4 } from "node:fs/promises";
 
 // src/lib/remote-auth/sync-messages.ts
 function isOnlineSibling(filepath) {
@@ -9222,7 +9005,7 @@ ${css.trim()}
   }
   return assembleBookHtml({
     files,
-    readText: (relPath) => readFile23(join2(inputDir, canonicalChapterId(relPath)), "utf-8"),
+    readText: (relPath) => readFile22(join2(inputDir, canonicalChapterId(relPath)), "utf-8"),
     projectCss: inlined.css,
     preloadImages: cssAssetCopies.map((c) => c.to),
     title: opts.title,
@@ -9254,7 +9037,7 @@ async function renderChaptersToFile(inputDir, outDir, opts = {}) {
 }
 
 // src/lib/markdownlint-fix.ts
-import { readFile as readFile24, writeFile as writeFile3 } from "node:fs/promises";
+import { readFile as readFile23, writeFile as writeFile3 } from "node:fs/promises";
 import { applyFixes } from "markdownlint";
 import { lint as lint2 } from "markdownlint/sync";
 async function uncommittedAmong(inputDir, files) {
@@ -9294,7 +9077,7 @@ async function applyMarkdownlintFixes(ctx) {
   for (const [file, violations] of Object.entries(results)) {
     if (!Array.isArray(violations) || violations.length === 0)
       continue;
-    const before = await readFile24(file, "utf8");
+    const before = await readFile23(file, "utf8");
     const after = applyFixes(before, violations);
     if (after !== before)
       pending.push({ file, content: after });
@@ -9403,16 +9186,16 @@ async function runChecks(ctx, opts = {}) {
   }
   const release = retainPdfCache();
   try {
-    for (const check40 of checks2) {
+    for (const check41 of checks2) {
       try {
-        let results = await check40.run(ctx);
-        const severityOverride = getCheckSeverityOverride(check40.id, ctx.config);
+        let results = await check41.run(ctx);
+        const severityOverride = getCheckSeverityOverride(check41.id, ctx.config);
         if (severityOverride) {
           for (const r of results) {
             r.severity = severityOverride;
           }
         }
-        const lintLevel = ruleLevel(ctx.config.lint.rules, check40.id);
+        const lintLevel = ruleLevel(ctx.config.lint.rules, check41.id);
         if (lintLevel === "off")
           results = [];
         else if (lintLevel) {
@@ -9420,15 +9203,15 @@ async function runChecks(ctx, opts = {}) {
             r.severity = lintLevel === "warn" ? "warning" : "error";
         }
         if (results.length === 0) {
-          passed.push(check40.id);
+          passed.push(check41.id);
         } else {
           allResults.push(...results);
         }
       } catch (err) {
         allResults.push({
-          checkId: check40.id,
+          checkId: check41.id,
           severity: "error",
-          message: `Check "${check40.id}" threw: ${err instanceof Error ? err.message : String(err)}`
+          message: `Check "${check41.id}" threw: ${err instanceof Error ? err.message : String(err)}`
         });
       }
     }
@@ -9720,7 +9503,7 @@ async function executeValidation(args) {
   };
   if (args.fix) {
     const selected = selectChecks(runnerOptions, config).checks;
-    if (selected.some((check40) => check40.id === MARKDOWNLINT_CHECK_ID)) {
+    if (selected.some((check41) => check41.id === MARKDOWNLINT_CHECK_ID)) {
       await applyMarkdownlintFixes(context);
     } else {
       log.warn(`--fix: ${MARKDOWNLINT_CHECK_ID} is not part of this run — no files were fixed.`);
@@ -9807,7 +9590,7 @@ import { randomBytes } from "node:crypto";
 
 // src/lib/build-fingerprint.ts
 import * as fs from "node:fs";
-import { mkdir as mkdir5, readFile as readFile25, writeFile as writeFile4 } from "node:fs/promises";
+import { mkdir as mkdir5, readFile as readFile24, writeFile as writeFile4 } from "node:fs/promises";
 import { createHash as createHash4 } from "node:crypto";
 import path12 from "node:path";
 import git from "isomorphic-git";
@@ -9894,8 +9677,8 @@ async function getEngineBundleHash() {
       getAssetPath("engine/gutterpress-agent.js")
     ]);
     const [viewerBytes, agentBytes] = await Promise.all([
-      readFile25(viewerPath),
-      readFile25(agentPath)
+      readFile24(viewerPath),
+      readFile24(agentPath)
     ]);
     const hash = createHash4("sha256");
     hash.update(viewerBytes);
@@ -9958,7 +9741,10 @@ async function writeBuildFingerprint(input) {
         resolvedFlavor: input.pdfx.resolvedFlavor,
         iccPath: input.pdfx.iccPath,
         stripAnnotations: input.pdfx.stripAnnotations,
-        blackText: input.pdfx.blackText ?? null
+        blackText: input.pdfx.blackText ?? null,
+        transparency: input.pdfx.transparency ?? null,
+        flattenPages: input.pdfx.flattenPages ?? null,
+        rasterDpi: input.pdfx.rasterDpi ?? null
       },
       outputDir: input.recordedOutputDir ? path12.resolve(input.recordedOutputDir) : outputDir
     },
@@ -10265,7 +10051,7 @@ class PdfOutput {
       const rawPdf = pdfxMode ? path13.join(stage, "raw.pdf") : path13.resolve(pdfFile);
       await fsp2.mkdir(path13.dirname(path13.resolve(pdfFile)), { recursive: true });
       log.info("Rendering HTML to PDF via the Gutterpress engine (native Chromium pagination)");
-      const { buildNativePdf } = await import("./engine-1v8kmv3a.js");
+      const { buildNativePdf } = await import("./engine-yxnnp3hx.js");
       const engineDiagnostics = await buildNativePdf(htmlFile, rawPdf, {
         title: config.title,
         author: config.authors.length > 0 ? config.authors.join(", ") : undefined,
@@ -10287,12 +10073,40 @@ class PdfOutput {
       if (pdfxMode) {
         const icc = opts.iccPath ?? config.pdfx.icc;
         effectiveIccPath = await resolveIccProfile(icc, manifestDir, opts.iccPath);
-        if (await hasLiveTransparency(await fsp2.readFile(rawPdf))) {
-          log.warn("This book uses transparency — an image with an alpha channel, or a CSS " + `rule like \`opacity\` or \`mix-blend-mode\`. PDF/${pdfxMode === "x1a" ? "X-1a" : "X-3"} has no way to represent that (both are based on PDF 1.3, which predates PDF transparency), so Ghostscript will flatten every page that uses it into a single raster ` + "image — that page loses its embedded fonts and searchable text in the " + "PDF/X output. To keep vector text, remove the `opacity`/blend rule and flatten any alpha-channel image against its intended background before including it (export it with no alpha channel), or build --format pdf instead of pdfx if this book doesn't need print-ready CMYK. `pdfx.rasterDpi` sets the resolution of those page images (default 720).");
+        const rawBytes = await fsp2.readFile(rawPdf);
+        const transparent = await transparentPages(rawBytes);
+        const blankGradientPages = await findPostScriptShadingPages(rawBytes);
+        const flattenedGradientPages = blankGradientPages.filter((n) => transparent.includes(n));
+        const vectorGradientPages = blankGradientPages.filter((n) => !transparent.includes(n));
+        const GRADIENT_FIX = "Replace it with a plain linear-gradient() or radial-gradient(), or a small tiled image. For 0deg/90deg stripes, `linear-gradient(90deg, #b33 0 6px, #c8c5bf 6px 10px)` with `background-size: 10px 100%` converts correctly.";
+        const pageList = (pages) => `Page${pages.length === 1 ? "" : "s"} ${pages.join(", ")}`;
+        if (vectorGradientPages.length > 0) {
+          log.warn(`${pageList(vectorGradientPages)}: a repeating-*-gradient() or conic-gradient() ` + "can print blank or distorted — " + `Ghostscript has been seen to paint nothing, or irregular stripes, for it when converting to PDF/X; check the page visually. ${GRADIENT_FIX}`);
         }
-        const blankGradientPages = await findPostScriptShadingPages(await fsp2.readFile(rawPdf));
-        if (blankGradientPages.length > 0) {
-          log.warn(`Page${blankGradientPages.length === 1 ? "" : "s"} ${blankGradientPages.join(", ")}: ` + "a repeating-*-gradient() or conic-gradient() will print blank — " + "Ghostscript cannot convert it to PDF/X. Replace it with a plain linear-gradient() or radial-gradient(), or a small tiled image. For 0deg/90deg stripes, `linear-gradient(90deg, #b33 0 6px, #c8c5bf 6px 10px)` with `background-size: 10px 100%` converts correctly.");
+        if (flattenedGradientPages.length > 0 && config.pdfx.transparency !== "preserve-text") {
+          log.warn(`${pageList(flattenedGradientPages)}: a repeating-*-gradient() or conic-gradient() is painted only as part of the one raster image Ghostscript makes of the whole page, so the page loses its embedded fonts and searchable text. Check the page visually. ${GRADIENT_FIX}`);
+        }
+        const flattenPages = config.pdfx.flattenPages;
+        if (transparent.length > 0 && config.pdfx.transparency === "preserve-text") {
+          const { unsplittableTextReasons } = await import("./pdf-inspect-zdmy7qca.js");
+          const reasons = await unsplittableTextReasons(rawBytes, transparent).catch((err) => {
+            log.warn(`pdfx.transparency: preserve-text could not inspect this PDF's text (${err instanceof Error ? err.message : String(err)}), so every page that uses transparency is flattened whole, as with flatten-page.`);
+            return null;
+          });
+          if (reasons) {
+            const plan = planTransparentPages(transparent, reasons, flattenPages, blankGradientPages);
+            await flattenTransparentPages(rawPdf, plan.split, stage, config.pdfx.rasterDpi);
+            reportTransparentPlan(plan, pdfxMode, config.pdfx.rasterDpi ?? 300, pageList);
+          }
+        }
+        const unused = flattenPages.filter((n) => !transparent.includes(n));
+        if (flattenPages.length > 0 && config.pdfx.transparency !== "preserve-text") {
+          log.warn("pdfx.flattenPages has no effect without pdfx.transparency: preserve-text.");
+        } else if (unused.length > 0) {
+          log.warn(`pdfx.flattenPages lists ${pageList(unused).toLowerCase()}, which ${unused.length === 1 ? "has" : "have"} no transparency (or do not exist): nothing to flatten there.`);
+        }
+        if (transparent.length > 0 && config.pdfx.transparency !== "preserve-text") {
+          log.warn("This book uses transparency — an image with an alpha channel, or a CSS " + `rule like \`opacity\` or \`mix-blend-mode\`. PDF/${pdfxMode === "x1a" ? "X-1a" : "X-3"} has no way to represent that (both are based on PDF 1.3, which predates PDF transparency), so Ghostscript will flatten every page that uses it into a single raster ` + "image — that page loses its embedded fonts and searchable text in the " + "PDF/X output. To keep vector text, remove the `opacity`/blend rule and flatten any alpha-channel image against its intended background before including it (export it with no alpha channel), or build --format pdf instead of pdfx if this book doesn't need print-ready CMYK. Or set `pdfx.transparency: preserve-text` to keep the text live on the pages where that is possible. `pdfx.rasterDpi` sets the resolution of those page images (default 720).");
         }
         const shouldStrip = opts.stripAnnotations ?? config.pdfx.stripAnnotations;
         shouldStripAnnotations = shouldStrip;
@@ -10335,7 +10149,10 @@ class PdfOutput {
           resolvedFlavor: config.pdfx.flavor,
           iccPath: effectiveIccPath,
           stripAnnotations: shouldStripAnnotations,
-          blackText: pdfxMode ? config.pdfx.blackText : null
+          blackText: pdfxMode ? config.pdfx.blackText : null,
+          transparency: pdfxMode ? config.pdfx.transparency : null,
+          flattenPages: pdfxMode ? config.pdfx.flattenPages : null,
+          rasterDpi: pdfxMode ? config.pdfx.rasterDpi ?? null : null
         }
       }, `Wrote: ${reportedPdf}`, { htmlPath: htmlFile, pdfPath: reportedPdf }, pdfName, engineDiagnostics);
     } finally {
@@ -10372,6 +10189,35 @@ async function runBuild(opts) {
     await fsp2.rm(ctx.workDir, { recursive: true, force: true });
   }
 }
+var FALLBACK_CAUSE = {
+  listed: "listed in pdfx.flattenPages",
+  "text-transparency": "text drawn with transparency or blending (opacity, mix-blend-mode, a soft mask, a translucent text-shadow); keep that text opaque",
+  "type3-font": "text in a Type 3 font: for a synthetic bold (a weight the font has no face for), use a face with that weight or set the font's own weight; for -webkit-text-stroke, remove the stroke or accept this fallback",
+  "text-pattern-or-clip": 'text filled with a pattern or used as a clip (SVG fill="url(#…)", gradient text, background-clip: text)',
+  gradient: "a repeating or conic gradient; use a linear or radial gradient, or a small tiled image"
+};
+function reportTransparentPlan({ split, artOnly, kept }, pdfxMode, dpi, pageList) {
+  const one = (pages, singular, plural) => pages.length === 1 ? singular : plural;
+  if (split.length > 0) {
+    log.warn(`${pageList(split)} ${one(split, "uses", "use")} transparency, which PDF/${pdfxMode === "x1a" ? "X-1a" : "X-3"} (PDF 1.3) cannot represent. Each was flattened to a ${dpi} DPI picture with its text kept live on top (pdfx.transparency: preserve-text), so fonts and searchable text survive. On those pages, rules, backgrounds and shapes are raster, and text always sits above the artwork: text another element covers shows through. List a page in pdfx.flattenPages to flatten it whole instead.`);
+  }
+  if (artOnly.length > 0) {
+    log.info(`${pageList(artOnly)} ${one(artOnly, "uses", "use")} transparency but ${one(artOnly, "shows", "show")} no text, so there is no text to keep: Ghostscript flattens ${one(artOnly, "it", "each")} whole (resolution: pdfx.rasterDpi).`);
+  }
+  if (kept.size > 0) {
+    const pages = [...kept.keys()];
+    const byCause = new Map;
+    for (const [n, cause] of kept)
+      byCause.set(cause, [...byCause.get(cause) ?? [], n]);
+    const lines = [...byCause].map(([cause, ns]) => `  - ${one(ns, "page", "pages")} ${ns.join(", ")}: ${FALLBACK_CAUSE[cause]}`);
+    log.warn(`${pageList(pages)} could not keep ${one(pages, "its", "their")} text live; Ghostscript will flatten ${one(pages, "that page", "each of those pages")} into one raster image, losing its embedded fonts and searchable text. Each page lists the first cause found; fixing it can reveal another:
+` + lines.join(`
+`));
+  }
+  if (split.length === 0 && [...kept.values()].some((cause) => cause !== "listed")) {
+    log.warn("pdfx.transparency: preserve-text kept no page's text live in this book: every page with transparency and text falls back (see above).");
+  }
+}
 
 // src/lib/open-path.ts
 import { spawn } from "node:child_process";
@@ -10405,7 +10251,7 @@ function openPath(filePath) {
 import path16 from "path";
 import { tmpdir } from "os";
 import { randomBytes as randomBytes2 } from "crypto";
-import { readdir as readdir4, readFile as readFile26, writeFile as writeFile5 } from "node:fs/promises";
+import { readdir as readdir4, readFile as readFile25, writeFile as writeFile5 } from "node:fs/promises";
 
 // src/utils/file-utils.ts
 import { promises as fs3 } from "fs";
@@ -10523,8 +10369,16 @@ async function renderPreviewBook(inputPath, config, opts) {
   });
 }
 function injectPreviewScripts(html, page) {
-  const area = page ? JSON.stringify({ width: page.width, height: page.height, bleed: page.bleed ?? 0, safe: page.safe ?? 0 }) : "";
-  const meta = area ? `  <meta name="gp-print-area" content='${area}'>
+  const area = page ? JSON.stringify({
+    width: page.width,
+    height: page.height,
+    bleed: page.bleed ?? 0,
+    safe: page.safe ?? 0,
+    artSafe: page.artSafe,
+    preset: page.preset,
+    spec: page.spec
+  }) : "";
+  const meta = area ? `  <meta name="gp-print-area" content='${area.replace(/&/g, "&amp;").replace(/'/g, "&#39;")}'>
 ` : "";
   const scripts = meta + `  <script src="/engine/gutterpress-viewer.js"></script>
   ` + `<script src="/preview/scripts/preview-interface.js"></script>
@@ -10560,7 +10414,7 @@ async function generateAndWriteHtml(inputPath, tempDir, config, cssAssets, image
     for (const ref of nextImageRefs)
       imageRefs.add(ref);
   }
-  await fsp3.writeFile(path15.join(tempDir, BOOK_HTML_FILENAME), injectPreviewScripts(html, config.page), "utf-8");
+  await fsp3.writeFile(path15.join(tempDir, BOOK_HTML_FILENAME), injectPreviewScripts(html, config.page && { ...config.page, preset: config.preset, spec: config.spec }), "utf-8");
 }
 function isDotPathUnderRoot(candidatePath, root) {
   const normalizedRoot = root.replace(/\\/g, "/").replace(/\/+$/, "");
@@ -10958,7 +10812,7 @@ async function cleanupOrphanTempDirs() {
     const dir = path16.join(TEMP_DIR_BASE, entry);
     const pidFile = path16.join(dir, PID_FILE_NAME);
     try {
-      const raw = await readFile26(pidFile, "utf8");
+      const raw = await readFile25(pidFile, "utf8");
       const pid = parseInt(raw.trim(), 10);
       if (!isProcessAlive(pid)) {
         debug(`Removing orphan temp dir ${dir} (pid ${pid} not alive)`);
@@ -11065,7 +10919,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 readFile27, stat as stat5 } from "node:fs/promises";
+import { readFile as readFile26, stat as stat4 } from "node:fs/promises";
 import path17 from "path";
 import { WebSocket, WebSocketServer } from "ws";
 var HMR_PATH = "/__gutterpress-hmr";
@@ -11124,7 +10978,7 @@ async function findAvailablePort(startPort, host = "127.0.0.1") {
 async function serveStatic(absPath, res, cacheControl = "no-store", extraHeaders = {}) {
   let filePath = absPath;
   try {
-    const s = await stat5(filePath);
+    const s = await stat4(filePath);
     if (s.isDirectory())
       filePath = path17.join(filePath, "index.html");
   } catch {
@@ -11134,7 +10988,7 @@ async function serveStatic(absPath, res, cacheControl = "no-store", extraHeaders
   }
   let data;
   try {
-    data = await readFile27(filePath);
+    data = await readFile26(filePath);
   } catch {
     res.writeHead(404);
     res.end("Not Found");
@@ -11163,7 +11017,7 @@ async function serveRevalidatedStatic(req, absPath, res, validators) {
   }
   let fileStat;
   try {
-    fileStat = await stat5(absPath, { bigint: true });
+    fileStat = await stat4(absPath, { bigint: true });
   } catch {
     await serveStatic(absPath, res);
     return;
@@ -11183,7 +11037,7 @@ async function serveRevalidatedStatic(req, absPath, res, validators) {
   let data;
   if (!validator || validator.stamp !== stamp) {
     try {
-      data = await readFile27(absPath);
+      data = await readFile26(absPath);
     } catch {
       await serveStatic(absPath, res);
       return;
@@ -11211,7 +11065,7 @@ async function isMissingReferencedImage(pathname, absPath, refs) {
   if (!refs.has(imageRefKey(pathname)))
     return false;
   try {
-    await stat5(absPath);
+    await stat4(absPath);
     return false;
   } catch (err) {
     return err?.code === "ENOENT";
@@ -11493,7 +11347,7 @@ async function startPreviewServer(options) {
 }
 
 // src/lib/project-scaffold.ts
-import { access, copyFile, cp as cp2, mkdir as mkdir7, readdir as readdir5, readFile as readFile28, stat as stat6, writeFile as writeFile6 } from "node:fs/promises";
+import { access, copyFile, cp as cp2, mkdir as mkdir7, readdir as readdir5, readFile as readFile27, stat as stat5, writeFile as writeFile6 } from "node:fs/promises";
 import { constants as FS, existsSync as existsSync12 } from "node:fs";
 import path18 from "node:path";
 
@@ -11692,7 +11546,7 @@ async function scaffoldProject(options) {
 async function firstSourceFile(manifestPath) {
   let text;
   try {
-    text = await readFile28(manifestPath, "utf8");
+    text = await readFile27(manifestPath, "utf8");
   } catch {
     return;
   }
@@ -11704,7 +11558,7 @@ async function firstSourceFile(manifestPath) {
   return m ? m[1].trim() : undefined;
 }
 async function fillTemplateFile(filePath, substitutions) {
-  let text = await readFile28(filePath, "utf8");
+  let text = await readFile27(filePath, "utf8");
   for (const [token, value] of Object.entries(substitutions)) {
     text = text.split(token).join(value);
   }
@@ -11712,7 +11566,7 @@ async function fillTemplateFile(filePath, substitutions) {
 }
 
 // src/lib/extension-scaffold.ts
-import { access as access2, mkdir as mkdir8, readFile as readFile29, writeFile as writeFile7 } from "node:fs/promises";
+import { access as access2, mkdir as mkdir8, readFile as readFile28, writeFile as writeFile7 } from "node:fs/promises";
 import { constants as FS2 } from "node:fs";
 import path19 from "node:path";
 var EXTENSION_KINDS = ["plugin", "theme"];
@@ -11829,7 +11683,7 @@ async function scaffoldExtension(options) {
       const src = await getAssetPath(`extension-templates/${kind}/${assetName}`);
       const dest = path19.join(extensionDir, relDest);
       await mkdir8(path19.dirname(dest), { recursive: true });
-      const text = await readFile29(src, "utf8");
+      const text = await readFile28(src, "utf8");
       const table = relDest.endsWith(".json") ? jsonSafe : plain;
       await writeFile7(dest, substitute(text, table), "utf8");
       written.push(relDest);
@@ -11874,7 +11728,7 @@ var SKIP_ENTRIES = new Set([
 
 // src/lib/extension-import.ts
 import { existsSync as existsSync13 } from "node:fs";
-import { cp as cp3, mkdir as mkdir9, mkdtemp as mkdtemp2, readFile as readFile30, rm as rm4, writeFile as writeFile8 } from "node:fs/promises";
+import { cp as cp3, mkdir as mkdir9, mkdtemp as mkdtemp2, readFile as readFile29, rm as rm4, writeFile as writeFile8 } from "node:fs/promises";
 import { tmpdir as tmpdir2 } from "node:os";
 import path20 from "node:path";
 import { unzipSync } from "fflate";
@@ -11947,7 +11801,7 @@ async function finalizeExtensionImport(projectDir, sourceDir, relPaths, fallback
   if (!existsSync13(cssPath)) {
     throw new Error("A theme must contain a theme.css file.");
   }
-  const css = await readFile30(cssPath, "utf8");
+  const css = await readFile29(cssPath, "utf8");
   const { reject, warnings: printFindings } = classifyThemeCssFindings(checkCss(css, "theme.css"));
   if (reject) {
     throw new Error(`theme.css could not be parsed — ${reject.message}`);
@@ -11975,7 +11829,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 readFile30(sheetPath, "utf8");
+    const sheetCss = await readFile29(sheetPath, "utf8");
     const { reject: sheetReject, warnings: sheetFindings } = classifyThemeCssFindings(checkCss(sheetCss, rel));
     if (sheetReject) {
       throw new Error(`${rel} could not be parsed — ${sheetReject.message}`);
@@ -12008,7 +11862,7 @@ async function completeLandedManifest(dest, id, meta, metaExists) {
   let pkg = {};
   if (metaExists) {
     try {
-      const parsed = JSON.parse(await readFile30(file, "utf8"));
+      const parsed = JSON.parse(await readFile29(file, "utf8"));
       if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {
         pkg = parsed;
       }
@@ -12110,11 +11964,11 @@ async function importExtensionFromCssText(projectDir, css, name) {
 async function importExtensionFromFile(projectDir, filePath) {
   const ext = path20.extname(filePath).toLowerCase();
   if (ext === ".zip") {
-    const buf = await readFile30(filePath);
+    const buf = await readFile29(filePath);
     return importExtensionFromZip(projectDir, new Uint8Array(buf.buffer, buf.byteOffset, buf.byteLength));
   }
   if (ext === ".css") {
-    const css = await readFile30(filePath, "utf8");
+    const css = await readFile29(filePath, "utf8");
     return importExtensionFromCssText(projectDir, css, prettify(path20.basename(filePath, ".css")));
   }
   throw new Error("Choose a .zip extension package or a .css stylesheet.");
@@ -12898,7 +12752,7 @@ var drivethrurpgProvider = {
 };
 
 // src/lib/publish/providers/gdrive.ts
-import { mkdtemp as mkdtemp3, readFile as readFile31, readdir as readdir6, rm as rm5, stat as stat7, writeFile as writeFile10 } from "node:fs/promises";
+import { mkdtemp as mkdtemp3, readFile as readFile30, readdir as readdir6, rm as rm5, stat as stat6, writeFile as writeFile10 } from "node:fs/promises";
 import { tmpdir as tmpdir3 } from "node:os";
 import path22 from "node:path";
 import { Zip, ZipDeflate } from "fflate";
@@ -13290,12 +13144,12 @@ async function collectZipEntries(root, dir, out, onWarn) {
       await collectZipEntries(root, full, out, onWarn);
     } else if (entry.isFile()) {
       const rel = path22.relative(root, full).split(path22.sep).join("/");
-      out[rel] = await readFile31(full);
+      out[rel] = await readFile30(full);
     } else if (entry.isSymbolicLink()) {
-      const resolved = await stat7(full).catch(() => null);
+      const resolved = await stat6(full).catch(() => null);
       if (resolved?.isFile()) {
         const rel = path22.relative(root, full).split(path22.sep).join("/");
-        out[rel] = await readFile31(full);
+        out[rel] = await readFile30(full);
       } else if (resolved?.isDirectory()) {
         await collectZipEntries(root, full, out, onWarn);
       } else {
@@ -13365,7 +13219,7 @@ var gdriveProvider = {
       cleanup: async () => {}
     };
     try {
-      const artifactStat = await stat7(source.filePath);
+      const artifactStat = await stat6(source.filePath);
       const about = await driveAbout(fetchImpl, accessToken);
       if (about.quota.limitBytes != null && about.quota.freeBytes != null) {
         if (artifactStat.size > about.quota.freeBytes) {
@@ -13410,7 +13264,7 @@ var gdriveProvider = {
 };
 
 // src/lib/publish/butler.ts
-import { chmod, mkdir as mkdir11, stat as stat8, writeFile as writeFile11 } from "node:fs/promises";
+import { chmod, mkdir as mkdir11, stat as stat7, writeFile as writeFile11 } from "node:fs/promises";
 import path23 from "node:path";
 import { unzipSync as unzipSync2 } from "fflate";
 var BUTLER_DOWNLOAD_TIMEOUT_MS = 300000;
@@ -13431,7 +13285,7 @@ function butlerBinaryName(platform = process.platform) {
 }
 async function fileExists2(p) {
   try {
-    return (await stat8(p)).isFile();
+    return (await stat7(p)).isFile();
   } catch {
     return false;
   }
@@ -13674,7 +13528,7 @@ var kdpProvider = {
 };
 
 // src/lib/publish/providers/local-folder.ts
-import { cp as cp4, mkdir as mkdir12, stat as stat9 } from "node:fs/promises";
+import { cp as cp4, mkdir as mkdir12, stat as stat8 } from "node:fs/promises";
 import path24 from "node:path";
 var LOCAL_PUBLISH_DEFAULT_DIR = "dist";
 var info8 = {
@@ -13701,7 +13555,7 @@ var localFolderProvider = {
   async preflight(req) {
     const dir = localPublishDir(req);
     try {
-      const s = await stat9(dir);
+      const s = await stat8(dir);
       if (!s.isDirectory()) {
         return [
           { severity: "error", id: "local/not-a-folder", message: `${dir} exists but is not a folder.` }
@@ -13956,7 +13810,7 @@ function publishProviderFor(id) {
 }
 
 // src/lib/publish/run-publish.ts
-import { readdir as readdir7, stat as stat10 } from "node:fs/promises";
+import { readdir as readdir7, stat as stat9 } from "node:fs/promises";
 import path25 from "node:path";
 function resolvePublishFormat(info10, providerConfig) {
   if (info10.formats && info10.formats.length > 0) {
@@ -13998,7 +13852,7 @@ var PDF_HINT = "Build the PDF first (gutterpress build, or export it from the ap
 var HTML_HINT = "Build the website export first (gutterpress build --format html).";
 async function artifactIssues(artifact) {
   try {
-    const s = await stat10(artifact.path);
+    const s = await stat9(artifact.path);
     if (artifact.format === "pdf" && !s.isFile()) {
       return [
         {
@@ -14044,7 +13898,7 @@ async function artifactIssues(artifact) {
 var BUILD_FINGERPRINT_FILENAME = "build-fingerprint.json";
 async function htmlDirIssues(dir) {
   const issues = [];
-  const isThere = async (rel) => stat10(path25.join(dir, rel)).then(() => true, () => false);
+  const isThere = async (rel) => stat9(path25.join(dir, rel)).then(() => true, () => false);
   if (!await isThere(BOOK_HTML)) {
     issues.push({
       severity: "error",
@@ -14282,7 +14136,7 @@ import git8 from "isomorphic-git";
 // src/lib/remote-auth/scorched-earth.ts
 import git9 from "isomorphic-git";
 // src/lib/publish/selections.ts
-import { chmod as chmod2, mkdir as mkdir13, readFile as readFile32, writeFile as writeFile12 } from "node:fs/promises";
+import { chmod as chmod2, mkdir as mkdir13, readFile as readFile31, writeFile as writeFile12 } from "node:fs/promises";
 import path26 from "node:path";
 class PublishSelectionsStore {
   filePath;
@@ -14292,7 +14146,7 @@ class PublishSelectionsStore {
   }
   async read() {
     try {
-      const raw = await readFile32(this.filePath, "utf8");
+      const raw = await readFile31(this.filePath, "utf8");
       const parsed = JSON.parse(raw);
       if (parsed && typeof parsed === "object") {
         return {