gutterpress 0.11.19 → 0.11.20-alpha.2

package/dist/{cli-aw614ztv.js → cli-zacevwcy.js}

@@ -14,12 +14,12 @@ import {
   stampCreator,
   stripAnnotations,
   warn
-} from "./cli-dzw28t3s.js";
+} from "./cli-gh0ym80r.js";
 import {
   DEBOUNCE,
   UsageError,
   resolvePort
-} from "./cli-cgbzdrwz.js";
+} from "./cli-7z29z4wz.js";
 import {
   blackTextToGray
 } from "./cli-ht1bcqdd.js";
@@ -28,7 +28,7 @@ import {
   getAssetPath,
   getAssetsDir,
   lastPageMode
-} from "./cli-xx94a1k6.js";
+} from "./cli-j802s31j.js";
 import {
   BuildError,
   EXIT_CODES
@@ -106,6 +106,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: {
@@ -116,13 +121,16 @@ var DTRPG_PRESET = {
     flavor: "x1a",
     icc: "profiles/CGATS21_CRPC1.icc",
     stripAnnotations: true,
-    blackText: "k-only"
+    blackText: "k-only",
+    rasterDpi: undefined
   },
   page: {
     width: 621,
     height: 810,
     tolerance: 0.5,
-    bleed: 9
+    bleed: 9,
+    safe: 36,
+    artSafe: 18
   },
   ink: {
     maxTac: 240,
@@ -151,6 +159,10 @@ var DTRPG_PRESET = {
       "pdf.print.embedded-fonts": {
         enabled: true,
         severity: "error"
+      },
+      "pdf.print.safe-margins": {
+        enabled: true,
+        severity: "error"
       }
     },
     source: {
@@ -183,6 +195,7 @@ var DTRPG_PRESET = {
   }
 };
 var BOOK_PRESET = {
+  id: "book",
   defaultTargets: [],
   extensions: [],
   source: {
@@ -193,13 +206,16 @@ var BOOK_PRESET = {
     flavor: "x1a",
     icc: "profiles/CGATS21_CRPC1.icc",
     stripAnnotations: true,
-    blackText: "icc"
+    blackText: "icc",
+    rasterDpi: undefined
   },
   page: {
     width: 432,
     height: 648,
     tolerance: 0.5,
-    bleed: undefined
+    bleed: undefined,
+    safe: 18,
+    artSafe: undefined
   },
   ink: {
     maxTac: 400,
@@ -221,6 +237,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
     },
@@ -255,6 +275,7 @@ var BOOK_PRESET = {
 };
 var CUSTOM_PRESET = {
   ...BOOK_PRESET,
+  id: "custom",
   page: null,
   defaultTargets: []
 };
@@ -300,7 +321,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]
@@ -315,7 +337,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"]
 };
@@ -330,6 +353,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: {
@@ -547,7 +571,9 @@ function resolveCustomPage(c, m) {
     width,
     height,
     tolerance: c.page?.tolerance ?? m.page?.tolerance ?? 0.5,
-    bleed: c.page?.bleed ?? m.page?.bleed
+    bleed: c.page?.bleed ?? m.page?.bleed,
+    safe: c.page?.safe ?? m.page?.safe,
+    artSafe: c.page?.artSafe ?? m.page?.artSafe
   };
 }
 function resolveWithPreset(cliOverrides, manifest, preset) {
@@ -580,6 +606,10 @@ 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 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)}.`);
+  }
   const rawExtensions = c.extensions ?? m.extensions ?? [];
   if (!Array.isArray(rawExtensions)) {
     throw new UsageError("Manifest field `extensions` must be a list of specifiers.");
@@ -588,6 +618,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),
@@ -5263,6 +5295,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);
@@ -5371,7 +5476,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",
@@ -5390,22 +5495,22 @@ 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";
@@ -5458,7 +5563,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)",
@@ -5471,7 +5576,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
@@ -5479,7 +5584,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
@@ -5487,7 +5592,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
@@ -5495,7 +5600,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
@@ -5504,10 +5609,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",
@@ -5523,7 +5628,7 @@ var check5 = {
     if (fonts.length === 0) {
       return [
         {
-          checkId: check5.id,
+          checkId: check6.id,
           severity: "warning",
           message: "No fonts detected (unexpected).",
           file: ctx.pdfPath,
@@ -5536,7 +5641,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,
@@ -5548,10 +5653,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",
@@ -5565,7 +5670,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,
@@ -5590,7 +5695,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,
@@ -5614,10 +5719,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)",
@@ -5657,7 +5762,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,
@@ -5668,11 +5773,11 @@ var check7 = {
     ];
   }
 };
-registerCheck(check7);
+registerCheck(check8);
 
 // src/checks/pdf/black-text.ts
 import { readFile as readFile9 } from "node:fs/promises";
-var check8 = {
+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)",
@@ -5688,7 +5793,7 @@ var check8 = {
       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,
@@ -5699,17 +5804,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)",
@@ -5721,7 +5826,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;
@@ -5730,7 +5835,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,
@@ -5746,10 +5851,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,
@@ -5760,10 +5865,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",
@@ -5777,14 +5882,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
@@ -5794,10 +5899,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",
@@ -5812,7 +5917,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
@@ -5823,7 +5928,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
@@ -5833,10 +5938,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",
@@ -5849,7 +5954,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
@@ -5859,7 +5964,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
@@ -5867,10 +5972,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",
@@ -5885,7 +5990,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
@@ -5893,10 +5998,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",
@@ -5923,7 +6028,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
@@ -5933,10 +6038,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",
@@ -5958,7 +6063,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
@@ -5968,7 +6073,7 @@ var check15 = {
     return [];
   }
 };
-registerCheck(check15);
+registerCheck(check16);
 
 // src/checks/pdf/bleed.ts
 function findBox(bytes, box) {
@@ -5978,7 +6083,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",
@@ -5992,7 +6097,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
         })
       ];
@@ -6002,14 +6107,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
@@ -6022,7 +6127,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
@@ -6033,10 +6138,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",
@@ -6055,22 +6160,22 @@ 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";
@@ -6125,7 +6230,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",
@@ -6150,7 +6255,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,
@@ -6163,7 +6268,7 @@ var check18 = {
     return out;
   }
 };
-registerCheck(check18);
+registerCheck(check19);
 
 // src/checks/source/htmlhint.ts
 import { existsSync as existsSync7 } from "node:fs";
@@ -6171,7 +6276,7 @@ import { readFile as readFile11 } 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",
@@ -6191,7 +6296,7 @@ var check19 = {
     const html = await readFile11(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,
@@ -6200,7 +6305,7 @@ var check19 = {
     }));
   }
 };
-registerCheck(check19);
+registerCheck(check20);
 
 // src/checks/source/stylelint.ts
 import { readFile as readFile12 } from "node:fs/promises";
@@ -6593,7 +6698,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)",
@@ -6613,7 +6718,7 @@ var check20 = {
         css = await readFile12(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
@@ -6622,7 +6727,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,
@@ -6634,7 +6739,7 @@ var check20 = {
     return results;
   }
 };
-registerCheck(check20);
+registerCheck(check21);
 
 // src/checks/source/css-ownership.ts
 import { readFile as readFile13 } from "node:fs/promises";
@@ -6818,7 +6923,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.",
@@ -6841,7 +6946,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
@@ -6883,7 +6988,7 @@ var check21 = {
       }
       for (const v of violations) {
         results.push({
-          checkId: check21.id,
+          checkId: check22.id,
           severity: "warning",
           message: v.message,
           file: absFile,
@@ -6895,7 +7000,7 @@ var check21 = {
     return results;
   }
 };
-registerCheck(check21);
+registerCheck(check22);
 
 // src/checks/source/local-refs.ts
 import { existsSync as existsSync9 } from "node:fs";
@@ -7286,7 +7391,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",
@@ -7294,12 +7399,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,
@@ -7309,7 +7414,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}`,
@@ -7334,7 +7439,7 @@ function localRefExists(ref, kind, sourceFile, projectRoot) {
       return existsSync9(fileRelative);
   }
 }
-registerCheck(check22);
+registerCheck(check23);
 
 // src/lib/build-staging.ts
 import path8 from "node:path";
@@ -7600,7 +7705,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)",
@@ -7608,10 +7713,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 },
@@ -7623,11 +7728,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 = {
+var check25 = {
   id: "source.accessibility.alt-text",
   name: "Image Alt Text",
   description: "Checks markdown images include non-empty alt text",
@@ -7656,7 +7761,7 @@ var check24 = {
             if (alt.trim())
               continue;
             results.push({
-              checkId: check24.id,
+              checkId: check25.id,
               severity: "warning",
               message: "Image is missing alt text",
               file,
@@ -7681,11 +7786,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 = {
+var check26 = {
   id: "source.accessibility.heading-order",
   name: "Heading Order",
   description: "Checks markdown heading levels do not jump by more than one",
@@ -7713,7 +7818,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;
           }
@@ -7723,7 +7828,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,
@@ -7737,7 +7842,7 @@ var check25 = {
     return results;
   }
 };
-registerCheck(check25);
+registerCheck(check26);
 
 // src/checks/source/layout-markers.ts
 import { readFile as readFile18 } from "node:fs/promises";
@@ -7848,7 +7953,7 @@ async function collectKnownClasses(ctx, plugins) {
   }
   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",
@@ -7860,7 +7965,7 @@ 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;
@@ -7879,7 +7984,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,
@@ -7889,7 +7994,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,
@@ -7898,13 +8003,13 @@ 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";
@@ -7937,7 +8042,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",
@@ -7951,7 +8056,7 @@ var check27 = {
       try {
         content = await readFile19(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))
@@ -7963,7 +8068,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.",
@@ -7972,7 +8077,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.",
@@ -7993,7 +8098,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.`,
@@ -8001,12 +8106,12 @@ 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";
@@ -8121,7 +8226,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",
@@ -8134,7 +8239,7 @@ var check28 = {
       try {
         content = await readFile20(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))
@@ -8145,7 +8250,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;
         }
@@ -8154,7 +8259,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}`,
@@ -8169,7 +8274,7 @@ var check28 = {
     return results;
   }
 };
-registerCheck(check28);
+registerCheck(check29);
 
 // src/checks/asset/image-file-size.ts
 import { stat as stat4 } from "node:fs/promises";
@@ -8395,7 +8500,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",
@@ -8416,14 +8521,14 @@ var check29 = {
         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
         }));
       }
@@ -8431,10 +8536,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",
@@ -8456,7 +8561,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
@@ -8466,7 +8571,7 @@ var check30 = {
     return results;
   }
 };
-registerCheck(check30);
+registerCheck(check31);
 
 // src/checks/asset/image-color-space.ts
 var LABEL = {
@@ -8474,7 +8579,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",
@@ -8495,7 +8600,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
@@ -8505,10 +8610,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",
@@ -8526,7 +8631,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
@@ -8536,10 +8641,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",
@@ -8558,7 +8663,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) {
@@ -8576,7 +8681,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,
@@ -8588,16 +8693,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",
@@ -8636,7 +8741,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
@@ -8646,7 +8751,7 @@ var check34 = {
     return results;
   }
 };
-registerCheck(check34);
+registerCheck(check35);
 
 // src/checks/asset/font-license.ts
 import { existsSync as existsSync10 } from "node:fs";
@@ -8661,7 +8766,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",
@@ -8688,7 +8793,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
@@ -8698,10 +8803,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",
@@ -8730,7 +8835,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
@@ -8738,7 +8843,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
@@ -8747,11 +8852,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 = {
+var check38 = {
   id: "heuristic.chunking.section-density",
   name: "Section Density",
   description: "Checks heading/paragraph/callout density from source Markdown",
@@ -8777,7 +8882,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,
@@ -8797,7 +8902,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,
@@ -8805,7 +8910,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
         }));
       }
@@ -8813,10 +8918,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",
@@ -8841,7 +8946,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
@@ -8851,10 +8956,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",
@@ -8872,7 +8977,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
@@ -8880,21 +8985,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]);
       }
     }
   }
@@ -8910,11 +9015,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 };
@@ -9394,16 +9499,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) {
@@ -9411,15 +9516,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)}`
         });
       }
     }
@@ -9711,7 +9816,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.`);
@@ -10256,7 +10361,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-fe0n7v9p.js");
+      const { buildNativePdf } = await import("./engine-9xb1ky8d.js");
       const engineDiagnostics = await buildNativePdf(htmlFile, rawPdf, {
         title: config.title,
         author: config.authors.length > 0 ? config.authors.join(", ") : undefined,
@@ -10279,7 +10384,7 @@ class PdfOutput {
         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.");
+          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 blankGradientPages = await findPostScriptShadingPages(await fsp2.readFile(rawPdf));
         if (blankGradientPages.length > 0) {
@@ -10301,7 +10406,8 @@ class PdfOutput {
           pdfx: pdfxMode,
           title: config.title,
           maxTac: config.ink.maxTac,
-          stagingDir: stage
+          stagingDir: stage,
+          rasterDpi: config.pdfx.rasterDpi
         });
       }
       if (gates.postValidate) {
@@ -10512,8 +10618,17 @@ async function renderPreviewBook(inputPath, config, opts) {
     }
   });
 }
-function injectPreviewScripts(html, insetBleedPt = 0) {
-  const meta = insetBleedPt > 0 ? `  <meta name="gp-inset-bleed" content="${insetBleedPt}">
+function injectPreviewScripts(html, page) {
+  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>
@@ -10549,7 +10664,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?.bleed), "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(/\/+$/, "");