gutterpress 0.11.17-alpha.2 → 0.11.17-alpha.4

package/dist/{cli-6z5zthzt.js → cli-2kc34kme.js}

@@ -13,17 +13,21 @@ import {
   stampCreator,
   stripAnnotations,
   warn
-} from "./cli-70xgehq2.js";
+} from "./cli-8apk8571.js";
 import {
   DEBOUNCE,
   UsageError,
   resolvePort
-} from "./cli-ppc0vz4b.js";
+} from "./cli-pqcb2nnb.js";
+import {
+  blackTextToGray
+} from "./cli-ht1bcqdd.js";
 import {
   MARGIN_BOX_IGNORED_PROPERTIES,
   getAssetPath,
-  getAssetsDir
-} from "./cli-gymfg04q.js";
+  getAssetsDir,
+  lastPageMode
+} from "./cli-jyy9pqf3.js";
 import {
   BuildError,
   EXIT_CODES
@@ -106,7 +110,7 @@ var DTRPG_PRESET = {
   source: {
     files: null
   },
-  print: { signature: 4, reserveLastPage: true },
+  print: { signature: 4, reserveLastPage: true, lastPage: undefined },
   pdfx: {
     flavor: "x1a",
     icc: "profiles/CGATS21_CRPC1.icc",
@@ -124,7 +128,8 @@ var DTRPG_PRESET = {
   },
   lint: {
     enabled: true,
-    configPath: null
+    configPath: null,
+    rules: {}
   },
   validate: {
     enabled: true,
@@ -181,7 +186,7 @@ var BOOK_PRESET = {
   source: {
     files: null
   },
-  print: { signature: 1, reserveLastPage: false },
+  print: { signature: 1, reserveLastPage: false, lastPage: undefined },
   pdfx: {
     flavor: "x1a",
     icc: "profiles/CGATS21_CRPC1.icc",
@@ -199,7 +204,8 @@ var BOOK_PRESET = {
   },
   lint: {
     enabled: true,
-    configPath: null
+    configPath: null,
+    rules: {}
   },
   validate: {
     enabled: true,
@@ -566,6 +572,10 @@ function resolveWithPreset(cliOverrides, manifest, preset) {
   if (legacyPlugins !== undefined) {
     throw new UsageError(pluginsRemovedMessage(legacyPlugins));
   }
+  const lastPage = c.print?.lastPage ?? m.print?.lastPage;
+  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 rawExtensions = c.extensions ?? m.extensions ?? [];
   if (!Array.isArray(rawExtensions)) {
     throw new UsageError("Manifest field `extensions` must be a list of specifiers.");
@@ -582,7 +592,10 @@ function resolveWithPreset(cliOverrides, manifest, preset) {
     print: mergeShape(c.print, m.print, preset.print),
     page: preset.page ? mergeShape(c.page, m.page, preset.page) : resolveCustomPage(c, m),
     ink: mergeShape(c.ink, m.ink, preset.ink),
-    lint: mergeShape(c.lint, m.lint, preset.lint),
+    lint: {
+      ...mergeShape(c.lint, m.lint, preset.lint),
+      rules: { ...preset.lint.rules, ...m.lint?.rules, ...c.lint?.rules }
+    },
     validate: {
       enabled: c.validate?.enabled ?? m.validate?.enabled ?? preset.validate.enabled,
       checks: { ...preset.validate.checks, ...m.validate?.checks, ...c.validate?.checks },
@@ -1078,7 +1091,7 @@ function resolveContainerShape(name, pluginName, decl) {
     throw new Error(`Plugin "${pluginName}"'s marker "@${name}" has a \`section\` that is not a boolean.`);
   }
   if (decl.section) {
-    for (const field of ["tag", "label", "autoCloseAt"]) {
+    for (const field of ["tag", "label", "autoCloseAt", "selfClosing"]) {
       if (decl[field] !== undefined) {
         throw new Error(`Plugin "${pluginName}"'s marker "@${name}" sets \`section: true\` and \`${field}\` — a section ` + `marker is a core @section, so \`${field}\` does not apply. Remove one of them.`);
       }
@@ -1135,11 +1148,26 @@ function resolveContainerShape(name, pluginName, decl) {
     }
     autoCloseAtEof = decl.autoCloseAt.includes("eof");
   }
+  if (decl.selfClosing !== undefined && typeof decl.selfClosing !== "boolean") {
+    throw new Error(`Plugin "${pluginName}"'s marker "@${name}" has a \`selfClosing\` that is not a boolean.`);
+  }
+  if (decl.selfClosing && decl.autoCloseAt !== undefined) {
+    throw new Error(`Plugin "${pluginName}"'s marker "@${name}" sets \`selfClosing: true\` and \`autoCloseAt\` — a ` + `self-closing marker has no open container to auto-close. Remove one of them.`);
+  }
   if (decl.validate !== undefined && typeof decl.validate !== "function") {
     throw new Error(`Plugin "${pluginName}"'s marker "@${name}" has a \`validate\` that is not a function.`);
   }
   const check = decl.validate ? { validate: decl.validate, validateOwner: pluginName } : {};
-  return { tag, classBase, variants, label, autoCloseAtEof, ...decl.section ? { section: true } : {}, ...check };
+  return {
+    tag,
+    classBase,
+    variants,
+    label,
+    autoCloseAtEof,
+    ...decl.section ? { section: true } : {},
+    ...decl.selfClosing ? { selfClosing: true } : {},
+    ...check
+  };
 }
 function resolveMarkerDeclaration(name, rawDecl, rawRegistry, originOf) {
   const pluginName = originOf.get(name);
@@ -1398,7 +1426,8 @@ function plugin(md, pluginOptions = {}) {
       addClasses(t, baseClass, meta.attrs && meta.attrs.class ? meta.attrs.class : "");
       attachDataAttrs(t, decl.baseKind, variant, meta.attrs || {});
       out.push(t);
-      declaredFrames.push({ kind: decl.baseKind, tag: decl.tag, decl, line: meta.__line });
+      if (!decl.selfClosing)
+        declaredFrames.push({ kind: decl.baseKind, tag: decl.tag, decl, line: meta.__line });
       if (decl.label) {
         const value = meta.attrs && meta.attrs[decl.label.attr];
         if (value) {
@@ -1409,6 +1438,8 @@ function plugin(md, pluginOptions = {}) {
           t.meta.labelled = true;
         }
       }
+      if (decl.selfClosing)
+        out.push(new state.Token("layout_component_close", decl.tag, -1));
     }
     const stack = {
       frames: [],
@@ -1687,7 +1718,7 @@ function plugin(md, pluginOptions = {}) {
               continue;
             }
             if (!closeDeclaredFrame(closeDecl.baseKind)) {
-              warn2(state.env, line, "declared_marker_close_without_open", `@${kind} used without an open @${closeDecl.baseKind}; ignoring marker.`, meta);
+              warn2(state.env, line, "declared_marker_close_without_open", closeDecl.selfClosing ? `@${kind} is not a marker: @${closeDecl.baseKind} is self-closing and has nothing to close; ignoring marker.` : `@${kind} used without an open @${closeDecl.baseKind}; ignoring marker.`, meta);
             }
             continue;
           }
@@ -4987,6 +5018,32 @@ function getImagePixelSize(page, name, timeoutMs = 2000) {
     }
   });
 }
+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 = [];
@@ -5490,8 +5547,100 @@ var check7 = {
 };
 registerCheck(check7);
 
-// src/checks/pdf/bookmarks.ts
+// src/checks/pdf/black-text.ts
+import { readFile as readFile9 } from "node:fs/promises";
 var check8 = {
+  id: "pdf.print.black-text",
+  name: "Black Text",
+  description: "Warns when text at or below 24pt is painted in a dark four-colour mix (black, or a near-black colour such as a dark brown)",
+  category: "pdf",
+  phase: "post-build",
+  enabledWhen: (config) => config.pdfx.blackText === "k-only",
+  async run(ctx) {
+    if (!ctx.pdfPath)
+      return [];
+    try {
+      const { findRichBlackText, LARGE_TEXT_PT } = await import("./black-text-gray-7dz61456.js");
+      const found = await findRichBlackText(await readFile9(ctx.pdfPath));
+      if (found.runs === 0)
+        return [];
+      return [
+        finding(check8.id, {
+          severity: "warning",
+          message: `Dark four-colour text at ${LARGE_TEXT_PT}pt or smaller on page(s) ${found.pages.join(", ")}.`,
+          file: ctx.pdfPath,
+          detail: "Small text printed with all four inks can look fuzzy if the plates are slightly out of register, which is why print vendors such as DriveThruRPG want small black text on the black plate alone. `pdfx.blackText: k-only` already does that for near-black text; this text is either a dark colour (for example a dark brown, which keeps its colour) or painted in a way the build cannot rewrite (an image or a pattern). To print it on the black plate, make the text black (#000). If the colour is intended, set `lint.rules: { pdf.print.black-text: off }` in manifest.yaml.",
+          code: "rich-black-text",
+          data: { runs: found.runs, pages: found.pages }
+        })
+      ];
+    } catch {
+      return [
+        inspectionFailed(check8.id, "Could not inspect the PDF's text colours.", {
+          file: ctx.pdfPath
+        })
+      ];
+    }
+  }
+};
+registerCheck(check8);
+
+// src/checks/pdf/signature.ts
+var check9 = {
+  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)",
+  category: "pdf",
+  phase: "post-build",
+  enabledWhen: (config) => config.print.signature > 1,
+  async run(ctx) {
+    if (!ctx.pdfPath)
+      return [];
+    const doc = await loadPdf(ctx.pdfPath);
+    if (!doc) {
+      return [inspectionFailed(check9.id, "Could not parse the PDF's page count.", { file: ctx.pdfPath })];
+    }
+    const size = ctx.config.print.signature;
+    const pages = doc.numPages;
+    if ((pages + 1) % size === 0)
+      return [];
+    const data = { pages, signature: size };
+    if (pages % size !== 0) {
+      return [
+        finding(check9.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,
+          detail: "Set `print.signature` in the manifest and rebuild; the build pads the interior for you.",
+          code: "signature-page-count",
+          data
+        })
+      ];
+    }
+    if (!lastPageMode(ctx.config.print))
+      return [];
+    try {
+      if (!await pageHasMarks(doc, pages))
+        return [];
+    } catch {
+      return [inspectionFailed(check9.id, "Could not read the last page.", { file: ctx.pdfPath })];
+    }
+    return [
+      finding(check9.id, {
+        severity: "error",
+        message: `The last page (${pages}) has content, but the printer needs it blank for its own information.`,
+        file: ctx.pdfPath,
+        detail: "The build adds that page for you (`print.lastPage: blank`, or `short-by-one` to stop a page short of a multiple " + `of ${size} and let the printer add it). Check that the interior was built with this manifest, and that nothing in it ` + "forces content onto the final page.",
+        code: "signature-last-page",
+        data
+      })
+    ];
+  }
+};
+registerCheck(check9);
+
+// src/checks/pdf/bookmarks.ts
+var check10 = {
   id: "pdf.nav.bookmarks",
   name: "Bookmarks",
   description: "Checks for PDF outline (bookmarks) tree",
@@ -5505,14 +5654,14 @@ var check8 = {
     const doc = await loadPdf(ctx.pdfPath);
     if (!doc) {
       return [
-        inspectionFailed(check8.id, "Could not inspect PDF for bookmarks.", {
+        inspectionFailed(check10.id, "Could not inspect PDF for bookmarks.", {
           file: ctx.pdfPath
         })
       ];
     }
     if (await getOutlineCount(doc) === 0) {
       return [
-        finding(check8.id, {
+        finding(check10.id, {
           severity: "warning",
           message: "PDF does not contain bookmarks (outline tree).",
           file: ctx.pdfPath
@@ -5522,10 +5671,10 @@ var check8 = {
     return [];
   }
 };
-registerCheck(check8);
+registerCheck(check10);
 
 // src/checks/pdf/toc-links.ts
-var check9 = {
+var check11 = {
   id: "pdf.nav.toc-links",
   name: "TOC Links",
   description: "Detects link annotations on TOC pages",
@@ -5540,7 +5689,7 @@ var check9 = {
     if (!doc) {
       return [
         {
-          checkId: check9.id,
+          checkId: check11.id,
           severity: "warning",
           message: "Could not inspect PDF for TOC links.",
           file: ctx.pdfPath
@@ -5551,7 +5700,7 @@ var check9 = {
     if (!hasLinks) {
       return [
         {
-          checkId: check9.id,
+          checkId: check11.id,
           severity: "warning",
           message: "No link annotations found in PDF (expected for TOC).",
           file: ctx.pdfPath
@@ -5561,10 +5710,10 @@ var check9 = {
     return [];
   }
 };
-registerCheck(check9);
+registerCheck(check11);
 
 // src/checks/pdf/cross-refs.ts
-var check10 = {
+var check12 = {
   id: "pdf.nav.cross-refs",
   name: "Cross References",
   description: "Counts and verifies internal link annotations",
@@ -5577,7 +5726,7 @@ var check10 = {
     if (!doc) {
       return [
         {
-          checkId: check10.id,
+          checkId: check12.id,
           severity: "info",
           message: "Could not inspect PDF for cross-references.",
           file: ctx.pdfPath
@@ -5587,7 +5736,7 @@ var check10 = {
     const linkCount = await countLinkAnnotations(doc);
     return [
       {
-        checkId: check10.id,
+        checkId: check12.id,
         severity: "info",
         message: `PDF contains ${linkCount} internal link annotation${linkCount !== 1 ? "s" : ""}.`,
         file: ctx.pdfPath
@@ -5595,10 +5744,10 @@ var check10 = {
     ];
   }
 };
-registerCheck(check10);
+registerCheck(check12);
 
 // src/checks/pdf/page-labels.ts
-var check11 = {
+var check13 = {
   id: "pdf.nav.page-labels",
   name: "Page Labels",
   description: "Verifies PDF page labels / folio numbering",
@@ -5613,7 +5762,7 @@ var check11 = {
     const labels = await getPageLabels(doc);
     return [
       {
-        checkId: check11.id,
+        checkId: check13.id,
         severity: "info",
         message: labels && labels.length > 0 ? "PDF contains page labels." : "PDF does not contain explicit page labels.",
         file: ctx.pdfPath
@@ -5621,10 +5770,10 @@ var check11 = {
     ];
   }
 };
-registerCheck(check11);
+registerCheck(check13);
 
 // src/checks/pdf/image-resolution.ts
-var check12 = {
+var check14 = {
   id: "pdf.print.image-resolution",
   name: "Image Resolution",
   description: "Checks DPI of images embedded in the PDF",
@@ -5651,7 +5800,7 @@ var check12 = {
       lowResPages.sort((a, b) => a - b);
       return [
         {
-          checkId: check12.id,
+          checkId: check14.id,
           severity: "warning",
           message: `Low-resolution images (below ${minDpi} DPI) found on pages: ${lowResPages.join(", ")}`,
           file: ctx.pdfPath
@@ -5661,10 +5810,10 @@ var check12 = {
     return [];
   }
 };
-registerCheck(check12);
+registerCheck(check14);
 
 // src/checks/pdf/transparency.ts
-var check13 = {
+var check15 = {
   id: "pdf.print.transparency",
   name: "Transparency",
   description: "Checks for transparency markers (/Transparency, /SMask, /BM) in the PDF",
@@ -5686,7 +5835,7 @@ var check13 = {
     if (found.length > 0) {
       return [
         {
-          checkId: check13.id,
+          checkId: check15.id,
           severity: "warning",
           message: `Transparency detected in PDF: ${found.join(", ")}. This may cause issues with some printers.`,
           file: ctx.pdfPath
@@ -5696,7 +5845,7 @@ var check13 = {
     return [];
   }
 };
-registerCheck(check13);
+registerCheck(check15);
 
 // src/checks/pdf/bleed.ts
 function findBox(bytes, box) {
@@ -5706,7 +5855,7 @@ function findBox(bytes, box) {
     return null;
   return [Number(m[1]), Number(m[2]), Number(m[3]), Number(m[4])];
 }
-var check14 = {
+var check16 = {
   id: "pdf.print.bleed",
   name: "Bleed Box",
   description: "Compares MediaBox vs TrimBox/BleedBox to verify bleed area",
@@ -5720,7 +5869,7 @@ var check14 = {
     const bytes = await readPdfBytes(ctx.pdfPath).catch(() => "");
     if (!bytes) {
       return [
-        inspectionFailed(check14.id, "Could not inspect PDF for bleed boxes.", {
+        inspectionFailed(check16.id, "Could not inspect PDF for bleed boxes.", {
           file: ctx.pdfPath
         })
       ];
@@ -5730,14 +5879,14 @@ var check14 = {
     const bleed = findBox(bytes, "BleedBox");
     if (!media) {
       return [
-        inspectionFailed(check14.id, "Could not parse MediaBox from PDF.", {
+        inspectionFailed(check16.id, "Could not parse MediaBox from PDF.", {
           file: ctx.pdfPath
         })
       ];
     }
     if (!trim && !bleed) {
       return [
-        finding(check14.id, {
+        finding(check16.id, {
           severity: "warning",
           message: "No TrimBox or BleedBox found. Bleed area cannot be verified.",
           file: ctx.pdfPath
@@ -5750,7 +5899,7 @@ var check14 = {
       const bleedSize = ctx.config.validate.pdf.bleedSize;
       if (mediaW - trimW < bleedSize * 2 * 0.9) {
         return [
-          finding(check14.id, {
+          finding(check16.id, {
             severity: "warning",
             message: `Bleed area appears insufficient. Expected at least ${bleedSize}pt on each side.`,
             file: ctx.pdfPath
@@ -5761,10 +5910,10 @@ var check14 = {
     return [];
   }
 };
-registerCheck(check14);
+registerCheck(check16);
 
 // src/checks/pdf/pdfx-metadata.ts
-var check15 = {
+var check17 = {
   id: "pdf.print.pdfx-metadata",
   name: "PDF/X Metadata",
   description: "Verifies PDF/X DOCINFO metadata via qpdf JSON",
@@ -5783,25 +5932,25 @@ var check15 = {
       const objects = parseQpdfObjectsJson(stdout);
       if (!objects) {
         return [
-          inspectionFailed(check15.id, "Unable to parse qpdf JSON output for PDF/X metadata checks.", { file: ctx.pdfPath })
+          inspectionFailed(check17.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(check15.id, {
+      return getPdfxMetadataIssues(objects, ctx.config.pdfx.flavor).map((message) => finding(check17.id, {
         severity: "error",
         message,
         file: ctx.pdfPath
       }));
     } catch {
       return [
-        inspectionFailed(check15.id, "Failed to inspect PDF objects with qpdf for PDF/X metadata.", { file: ctx.pdfPath })
+        inspectionFailed(check17.id, "Failed to inspect PDF objects with qpdf for PDF/X metadata.", { file: ctx.pdfPath })
       ];
     }
   }
 };
-registerCheck(check15);
+registerCheck(check17);
 
 // src/checks/source/markdownlint.ts
-import { readFile as readFile9 } from "node:fs/promises";
+import { readFile as readFile10 } from "node:fs/promises";
 import { lint } from "markdownlint/sync";
 import { parse as parseYaml2 } from "yaml";
 
@@ -5834,7 +5983,7 @@ function stripJsonComments(s) {
   return s.replace(/\/\*[\s\S]*?\*\//g, "").replace(/(^|[^:])\/\/.*$/gm, "$1");
 }
 async function loadConfig(configPath) {
-  const raw = await readFile9(configPath, "utf8");
+  const raw = await readFile10(configPath, "utf8");
   let parsed;
   if (configPath.endsWith(".json")) {
     parsed = JSON.parse(raw);
@@ -5853,7 +6002,7 @@ async function loadConfig(configPath) {
   return {};
 }
 var MARKDOWNLINT_CHECK_ID = "source.markdownlint";
-var check16 = {
+var check18 = {
   id: MARKDOWNLINT_CHECK_ID,
   name: "Markdownlint",
   description: "Runs markdownlint with project config to validate Markdown files",
@@ -5878,7 +6027,7 @@ var check16 = {
         continue;
       for (const v of violations) {
         out.push({
-          checkId: check16.id,
+          checkId: check18.id,
           severity: "warning",
           message: `${v.ruleDescription} (${v.ruleNames.join("/")})`,
           file,
@@ -5891,15 +6040,15 @@ var check16 = {
     return out;
   }
 };
-registerCheck(check16);
+registerCheck(check18);
 
 // src/checks/source/htmlhint.ts
 import { existsSync as existsSync7 } from "node:fs";
-import { readFile as readFile10 } from "node:fs/promises";
+import { readFile as readFile11 } from "node:fs/promises";
 import htmlhint from "htmlhint";
 var { HTMLHint } = htmlhint;
 var CONFIG_NAMES2 = [".htmlhintrc"];
-var check17 = {
+var check19 = {
   id: "source.htmlhint",
   name: "HTMLHint",
   description: "Runs htmlhint with project config to validate generated HTML",
@@ -5915,11 +6064,11 @@ var check17 = {
     const resolvedConfig = findConfigFile(ctx.inputDir, CONFIG_NAMES2, configPath);
     if (!resolvedConfig && !configPath)
       return [];
-    const ruleset = resolvedConfig ? JSON.parse(await readFile10(resolvedConfig, "utf8")) : HTMLHint.defaultRuleset;
-    const html = await readFile10(ctx.htmlPath, "utf8");
+    const ruleset = resolvedConfig ? JSON.parse(await readFile11(resolvedConfig, "utf8")) : HTMLHint.defaultRuleset;
+    const html = await readFile11(ctx.htmlPath, "utf8");
     const messages = HTMLHint.verify(html, ruleset);
     return messages.map((m) => ({
-      checkId: check17.id,
+      checkId: check19.id,
       severity: m.type === "error" ? "error" : "warning",
       message: `${m.rule.id}: ${m.message}`,
       file: ctx.htmlPath,
@@ -5928,13 +6077,35 @@ var check17 = {
     }));
   }
 };
-registerCheck(check17);
+registerCheck(check19);
 
 // src/checks/source/stylelint.ts
-import { readFile as readFile11 } from "node:fs/promises";
+import { readFile as readFile12 } from "node:fs/promises";
 
 // src/lib/printsafe.ts
 import postcss from "postcss";
+
+// src/lib/lint-rules.ts
+function ruleLevel(rules, id) {
+  const v = rules?.[id];
+  if (v === "off" || v === false)
+    return "off";
+  if (v === "warn" || v === "warning")
+    return "warn";
+  if (v === "error")
+    return "error";
+  return;
+}
+var DIRECTIVE = /^\s*gutterpress-disable-next-line\s+(.*?)\s*$/;
+function parseDisableDirective(commentText) {
+  const m = DIRECTIVE.exec(commentText);
+  if (!m)
+    return null;
+  const ids = m[1].split(/\s--(?:\s|$)/)[0].split(/[\s,]+/).filter(Boolean);
+  return ids.length > 0 ? ids : null;
+}
+
+// src/lib/printsafe.ts
 var ruleRemoteUrls = "printsafe/no-remote-urls";
 var ruleRiskyProps = "printsafe/no-risky-print-effects";
 var ruleSyntax = "printsafe/syntax-error";
@@ -5959,9 +6130,11 @@ var riskyProperties = new Set([
   "animation",
   "animation-name",
   "transition",
-  "will-change",
-  "clip-path"
+  "will-change"
 ]);
+function isRasterizingClipPath(decl) {
+  return decl.prop.toLowerCase() === "clip-path" && /\burl\(/i.test(decl.value);
+}
 var marginBoxAtRuleNames = new Set([
   "top-left-corner",
   "top-left",
@@ -6088,7 +6261,34 @@ function nodeLoc(node) {
     column: node.source?.start?.column ?? 1
   };
 }
-function checkCss(css, from) {
+function checkCss(css, from, options = {}) {
+  return filterFindings(checkCssRaw(css, from), css, options.rules);
+}
+function filterFindings(findings, css, rules) {
+  const silenced = new Map;
+  for (const m of css.matchAll(/\/\*([\s\S]*?)\*\//g)) {
+    const ids = parseDisableDirective(m[1]);
+    if (!ids)
+      continue;
+    const endLine = css.slice(0, m.index + m[0].length).split(`
+`).length;
+    const set = silenced.get(endLine + 1) ?? new Set;
+    for (const id of ids)
+      set.add(id);
+    silenced.set(endLine + 1, set);
+  }
+  const out = [];
+  for (const f of findings) {
+    if (silenced.get(f.line)?.has(f.rule))
+      continue;
+    const level = ruleLevel(rules, f.rule);
+    if (level === "off")
+      continue;
+    out.push(level === "warn" ? { ...f, severity: "warning" } : level === "error" ? { ...f, severity: "error" } : f);
+  }
+  return out;
+}
+function checkCssRaw(css, from) {
   let root;
   try {
     root = postcss.parse(css, from ? { from } : undefined);
@@ -6137,6 +6337,13 @@ function checkCss(css, from) {
         message: `Property is high-risk for print/PDF: 'filter' rasterizes its subtree to a 300 DPI bitmap in the printed PDF (text becomes unselectable, unsearchable, and inaccessible), and it dominates build time (~90% measured; 57.0s -> 6.2s over 60pp when scoped — see ENGINE.md §10). Scope it to the smallest possible selector. It also means the render-parity gate cannot see a text-only change inside it (docs/render-parity-gate.md, "Known blind spot").`,
         ...nodeLoc(decl)
       });
+    } else if (isRasterizingClipPath(decl)) {
+      warnings.push({
+        rule: ruleRiskyProps,
+        severity: "warning",
+        message: `Property is high-risk for print/PDF (can force rasterization): ${decl.prop} with url(...) references an SVG mask. Use a basic shape (polygon(), inset(), circle(), ellipse(), path()) instead — those print as vector clips.`,
+        ...nodeLoc(decl)
+      });
     } else if (riskyProperties.has(prop)) {
       warnings.push({
         rule: ruleRiskyProps,
@@ -6190,7 +6397,7 @@ function checkCss(css, from) {
 }
 
 // src/checks/source/stylelint.ts
-var check18 = {
+var check20 = {
   id: "source.stylelint",
   name: "Print-safety CSS",
   description: "Checks CSS for print-safety issues (remote URLs, rasterizing effects, and page-layer containment)",
@@ -6207,19 +6414,19 @@ var check18 = {
     for (const file of files) {
       let css;
       try {
-        css = await readFile11(file, "utf8");
+        css = await readFile12(file, "utf8");
       } catch (err) {
         results.push({
-          checkId: check18.id,
+          checkId: check20.id,
           severity: "error",
           message: `Cannot read stylesheet: ${err instanceof Error ? err.message : String(err)}`,
           file
         });
         continue;
       }
-      for (const w of checkCss(css, file)) {
+      for (const w of checkCss(css, file, { rules: ctx.config.lint.rules })) {
         results.push({
-          checkId: check18.id,
+          checkId: check20.id,
           severity: w.severity,
           message: `${w.rule}: ${w.message}`,
           file,
@@ -6231,10 +6438,10 @@ var check18 = {
     return results;
   }
 };
-registerCheck(check18);
+registerCheck(check20);
 
 // src/checks/source/css-ownership.ts
-import { readFile as readFile12 } from "node:fs/promises";
+import { readFile as readFile13 } from "node:fs/promises";
 
 // src/lib/style-resolver.ts
 import { existsSync as existsSync8 } from "node:fs";
@@ -6302,7 +6509,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 readFile12(configPath, "utf8");
+  const raw = await readFile13(configPath, "utf8");
   const parsed = parseYaml3(raw);
   if (parsed && typeof parsed === "object")
     return parsed;
@@ -6415,7 +6622,7 @@ function checkOwnership(root, file, maps) {
   });
   return out;
 }
-var check19 = {
+var check21 = {
   id: "source.css-ownership",
   name: "CSS ownership contract",
   description: "Checks an optional per-project CSS ownership contract (.gutterpress/css-contract.yaml): which file may declare which properties/at-rules, and which selectors must never appear unscoped.",
@@ -6438,7 +6645,7 @@ var check19 = {
     } catch (err) {
       return [
         {
-          checkId: check19.id,
+          checkId: check21.id,
           severity: "error",
           message: `Failed to parse CSS ownership contract "${configPath}": ${err instanceof Error ? err.message : String(err)}`,
           file: configPath
@@ -6453,7 +6660,7 @@ var check19 = {
         continue;
       let css;
       try {
-        css = await readFile12(absFile, "utf8");
+        css = await readFile13(absFile, "utf8");
       } catch {
         continue;
       }
@@ -6480,7 +6687,7 @@ var check19 = {
       }
       for (const v of violations) {
         results.push({
-          checkId: check19.id,
+          checkId: check21.id,
           severity: "warning",
           message: v.message,
           file: absFile,
@@ -6492,7 +6699,7 @@ var check19 = {
     return results;
   }
 };
-registerCheck(check19);
+registerCheck(check21);
 
 // src/checks/source/local-refs.ts
 import { existsSync as existsSync9 } from "node:fs";
@@ -6500,7 +6707,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 readFile13 } from "node:fs/promises";
+import { readFile as readFile14 } from "node:fs/promises";
 import path8 from "node:path";
 import postcss3 from "postcss";
 var FONT_EXTS = new Set([".woff2", ".woff", ".ttf", ".otf"]);
@@ -6565,7 +6772,7 @@ function mimeFor(ext) {
 }
 async function readOrThrow(absPath, kind, referencedFrom) {
   try {
-    return await readFile13(absPath);
+    return await readFile14(absPath);
   } catch {
     throw new BuildError(`Missing ${kind}: ${absPath}
   referenced from ${referencedFrom}
@@ -6708,7 +6915,7 @@ async function collectStyleDependencies(projectDir, stylePaths) {
     found.add(abs);
     let source;
     try {
-      source = await readFile13(abs, "utf-8");
+      source = await readFile14(abs, "utf-8");
     } catch {
       return;
     }
@@ -6785,7 +6992,7 @@ async function inlineShapeUrls(html, baseDir) {
       continue;
     let bytes;
     try {
-      bytes = await readFile13(abs);
+      bytes = await readFile14(abs);
     } catch {
       continue;
     }
@@ -6803,7 +7010,7 @@ async function inlineShapeUrls(html, baseDir) {
 }
 
 // src/checks/source/local-ref-parser.ts
-import { readFile as readFile14 } from "node:fs/promises";
+import { readFile as readFile15 } from "node:fs/promises";
 function newlineOffsets(content) {
   const offsets = [];
   for (let i = 0;i < content.length; i++)
@@ -6872,7 +7079,7 @@ async function* renderedLocalRefs(ctx, checkId, results) {
   for (const file of files) {
     let refs;
     try {
-      refs = collectRenderedLocalRefs(await readFile14(file, "utf8"));
+      refs = collectRenderedLocalRefs(await readFile15(file, "utf8"));
     } catch {
       results.push(inspectionFailed(checkId, `Could not read source file: ${file}`, { file }));
       continue;
@@ -6883,7 +7090,7 @@ async function* renderedLocalRefs(ctx, checkId, results) {
 }
 
 // src/checks/source/local-refs.ts
-var check20 = {
+var check22 = {
   id: "source.links.local-refs",
   name: "Local Markdown References",
   description: "Checks local markdown links and image refs resolve on disk",
@@ -6891,12 +7098,12 @@ var check20 = {
   phase: "pre-build",
   async run(ctx) {
     const results = [];
-    for await (const { ref, kind, line, file } of renderedLocalRefs(ctx, check20.id, results)) {
+    for await (const { ref, kind, line, file } of renderedLocalRefs(ctx, check22.id, results)) {
       if (isNonFilesystemRef(ref))
         continue;
       const escape = kind === "image" ? proseImageRefError(ref, ctx.inputDir) : null;
       if (escape) {
-        results.push(finding(check20.id, {
+        results.push(finding(check22.id, {
           severity: "error",
           message: escape,
           file,
@@ -6906,7 +7113,7 @@ var check20 = {
       }
       if (localRefExists(ref, kind, file, ctx.inputDir))
         continue;
-      results.push(finding(check20.id, {
+      results.push(finding(check22.id, {
         severity: kind === "image" ? "warning" : "error",
         code: kind === "image" ? "missing-image-placeholder" : undefined,
         message: kind === "image" ? `Local image not found; build will substitute a magenta placeholder: ${ref}` : `Local reference not found: ${ref}`,
@@ -6931,7 +7138,7 @@ function localRefExists(ref, kind, sourceFile, projectRoot) {
       return existsSync9(fileRelative);
   }
 }
-registerCheck(check20);
+registerCheck(check22);
 
 // src/lib/build-staging.ts
 import path9 from "node:path";
@@ -7197,7 +7404,7 @@ async function createStageRoot() {
 }
 
 // src/checks/source/dangling-links.ts
-var check21 = {
+var check23 = {
   id: "source.links.dangling",
   name: "Dangling Links",
   description: "Flags relative links the printed book cannot open (their href is dropped at print time)",
@@ -7205,10 +7412,10 @@ var check21 = {
   phase: "pre-build",
   async run(ctx) {
     const results = [];
-    for await (const { ref, kind, line, file } of renderedLocalRefs(ctx, check21.id, results)) {
+    for await (const { ref, kind, line, file } of renderedLocalRefs(ctx, check23.id, results)) {
       if (kind !== "link" || isPrintResolvableHref(ref))
         continue;
-      results.push(finding(check21.id, {
+      results.push(finding(check23.id, {
         severity: "warning",
         code: "dangling-link",
         data: { ref },
@@ -7220,11 +7427,11 @@ var check21 = {
     return results;
   }
 };
-registerCheck(check21);
+registerCheck(check23);
 
 // src/checks/source/accessibility-alt-text.ts
-import { readFile as readFile15 } from "node:fs/promises";
-var check22 = {
+import { readFile as readFile16 } from "node:fs/promises";
+var check24 = {
   id: "source.accessibility.alt-text",
   name: "Image Alt Text",
   description: "Checks markdown images include non-empty alt text",
@@ -7237,7 +7444,7 @@ var check22 = {
     const results = [];
     for (const file of files) {
       try {
-        const content = await readFile15(file, "utf8");
+        const content = await readFile16(file, "utf8");
         const lines = content.split(`
 `);
         let inFence = false;
@@ -7253,7 +7460,7 @@ var check22 = {
             if (alt.trim())
               continue;
             results.push({
-              checkId: check22.id,
+              checkId: check24.id,
               severity: "warning",
               message: "Image is missing alt text",
               file,
@@ -7278,11 +7485,11 @@ function extractImageAlts(line) {
   }
   return alts;
 }
-registerCheck(check22);
+registerCheck(check24);
 
 // src/checks/source/accessibility-heading-order.ts
-import { readFile as readFile16 } from "node:fs/promises";
-var check23 = {
+import { readFile as readFile17 } from "node:fs/promises";
+var check25 = {
   id: "source.accessibility.heading-order",
   name: "Heading Order",
   description: "Checks markdown heading levels do not jump by more than one",
@@ -7295,11 +7502,12 @@ var check23 = {
     const results = [];
     for (const file of files) {
       try {
-        const content = await readFile16(file, "utf8");
+        const content = await readFile17(file, "utf8");
         const lines = content.split(`
 `);
         let inFence = false;
         let prevLevel;
+        let silencedLine = -1;
         for (let i = 0;i < lines.length; i++) {
           const line = lines[i] ?? "";
           if (/^\s*(```|~~~)/.test(line)) {
@@ -7308,13 +7516,18 @@ var check23 = {
           }
           if (inFence)
             continue;
+          const comment = /^\s*<!--(.*)-->\s*$/.exec(line);
+          if (comment && parseDisableDirective(comment[1])?.includes(check25.id)) {
+            silencedLine = i + 1;
+            continue;
+          }
           const match = line.match(/^(#{1,6})\s+\S/);
           if (!match)
             continue;
           const level = match[1].length;
-          if (prevLevel != null && level > prevLevel + 1) {
+          if (prevLevel != null && level > prevLevel + 1 && i !== silencedLine) {
             results.push({
-              checkId: check23.id,
+              checkId: check25.id,
               severity: "warning",
               message: `Heading level jump from h${prevLevel} to h${level}`,
               file,
@@ -7328,11 +7541,11 @@ var check23 = {
     return results;
   }
 };
-registerCheck(check23);
+registerCheck(check25);
 
 // src/checks/source/layout-markers.ts
-import { readFile as readFile17 } from "node:fs/promises";
-var check24 = {
+import { readFile as readFile18 } from "node:fs/promises";
+var check26 = {
   id: "source.markdown.layout-markers",
   name: "Layout Markers",
   description: "Reports @page/@section/@chapter marker arguments Gutterpress could not understand, plus any unknown gp-* class",
@@ -7344,16 +7557,16 @@ var check24 = {
       return [];
     const results = [];
     const plugins = await loadPlugins(ctx.config.extensions, ctx.inputDir, (ref, error2) => {
-      results.push(inspectionFailed(check24.id, `Plugin "${ref}" could not be loaded, so markers it defines were not checked: ${error2.message}`));
+      results.push(inspectionFailed(check26.id, `Plugin "${ref}" could not be loaded, so markers it defines were not checked: ${error2.message}`));
     });
     const md = createMarkdownRenderer(plugins);
     for (const file of files) {
       try {
-        const content = await readFile17(file, "utf8");
+        const content = await readFile18(file, "utf8");
         const env = {};
         md.render(content, env);
         for (const w of env.layoutWarnings ?? []) {
-          results.push(finding(check24.id, {
+          results.push(finding(check26.id, {
             severity: w.severity ?? "warning",
             message: w.message,
             file,
@@ -7362,16 +7575,16 @@ var check24 = {
           }));
         }
       } catch (error2) {
-        results.push(inspectionFailed(check24.id, `Could not check layout markers in ${file}: ${error2 instanceof Error ? error2.message : String(error2)}`, { file }));
+        results.push(inspectionFailed(check26.id, `Could not check layout markers in ${file}: ${error2 instanceof Error ? error2.message : String(error2)}`, { file }));
       }
     }
     return results;
   }
 };
-registerCheck(check24);
+registerCheck(check26);
 
 // src/checks/source/merge-markers.ts
-import { readFile as readFile18 } from "node:fs/promises";
+import { readFile as readFile19 } from "node:fs/promises";
 import path10 from "node:path";
 
 // src/checks/asset/extensions.ts
@@ -7401,7 +7614,7 @@ var CLOSE_SENTINEL = ">>>>>>> online version";
 function withoutOnlineTag(relPath) {
   return relPath.replace(/\.online(?=\.[^./]*$|$)/, "");
 }
-var check25 = {
+var check27 = {
   id: "source.sync.merge-markers",
   name: "Combined Versions",
   description: "Finds passages and files still holding two versions (yours and the online copy) after a sync",
@@ -7413,9 +7626,9 @@ var check25 = {
     for (const file of textFiles) {
       let content;
       try {
-        content = await readFile18(file, "utf8");
+        content = await readFile19(file, "utf8");
       } catch {
-        results.push(inspectionFailed(check25.id, `Could not read source file: ${file}`, { file }));
+        results.push(inspectionFailed(check27.id, `Could not read source file: ${file}`, { file }));
         continue;
       }
       if (!content.includes(OPEN_SENTINEL) && !content.includes(CLOSE_SENTINEL))
@@ -7427,7 +7640,7 @@ var check25 = {
         const line = lines[i].endsWith("\r") ? lines[i].slice(0, -1) : lines[i];
         if (line === OPEN_SENTINEL) {
           inBlock = true;
-          results.push(finding(check25.id, {
+          results.push(finding(check27.id, {
             severity: "error",
             code: "two-versions-passage",
             message: "This passage has two versions (yours and the online copy) — keep what you want, then delete the marker lines.",
@@ -7436,7 +7649,7 @@ var check25 = {
           }));
         } else if (line === CLOSE_SENTINEL) {
           if (!inBlock) {
-            results.push(finding(check25.id, {
+            results.push(finding(check27.id, {
               severity: "error",
               code: "leftover-version-marker",
               message: "This marker line is left over from combining two versions — delete it.",
@@ -7457,7 +7670,7 @@ var check25 = {
       });
       for (const sibling of siblings.sort()) {
         const rel = path10.relative(ctx.inputDir, sibling).split(path10.sep).join("/");
-        results.push(finding(check25.id, {
+        results.push(finding(check27.id, {
           severity: "warning",
           code: "kept-both-versions",
           message: `Two versions of ${withoutOnlineTag(rel)} are in your book — keep the one you want, then delete the other.`,
@@ -7465,18 +7678,18 @@ var check25 = {
         }));
       }
     } catch (error2) {
-      results.push(inspectionFailed(check25.id, `Could not scan for kept-both files: ${error2 instanceof Error ? error2.message : String(error2)}`));
+      results.push(inspectionFailed(check27.id, `Could not scan for kept-both files: ${error2 instanceof Error ? error2.message : String(error2)}`));
     }
     return results;
   }
 };
-registerCheck(check25);
+registerCheck(check27);
 
 // src/checks/asset/image-file-size.ts
 import { stat as stat4 } from "node:fs/promises";
 
 // src/lib/image-inspect.ts
-import { stat as stat3, readFile as readFile19 } from "node:fs/promises";
+import { stat as stat3, readFile as readFile20 } from "node:fs/promises";
 var DEFAULT_DPI = 72;
 var cache = new Map;
 async function inspectImage(path11) {
@@ -7491,7 +7704,7 @@ async function inspectImage(path11) {
     return hit.info;
   let info2 = null;
   try {
-    const buf = await readFile19(path11);
+    const buf = await readFile20(path11);
     info2 = parseImage(buf);
   } catch {
     info2 = null;
@@ -7696,7 +7909,7 @@ async function collectImageFiles(dirs, exts, ignore2 = ASSET_SCAN_IGNORE_GLOBS)
 }
 
 // src/checks/asset/image-file-size.ts
-var check26 = {
+var check28 = {
   id: "asset.image.file-size",
   name: "Image File Size",
   description: "Checks that image files do not exceed the maximum size limit",
@@ -7717,14 +7930,14 @@ var check26 = {
         if (info2.size > maxSize) {
           const sizeMb = (info2.size / 1e6).toFixed(1);
           const maxMb = (maxSize / 1e6).toFixed(1);
-          results.push(finding(check26.id, {
+          results.push(finding(check28.id, {
             severity: "warning",
             message: `Image file too large: ${sizeMb}MB (max ${maxMb}MB)`,
             file
           }));
         }
       } catch {
-        results.push(inspectionFailed(check26.id, `Could not stat image file: ${file}`, {
+        results.push(inspectionFailed(check28.id, `Could not stat image file: ${file}`, {
           file
         }));
       }
@@ -7732,10 +7945,10 @@ var check26 = {
     return results;
   }
 };
-registerCheck(check26);
+registerCheck(check28);
 
 // src/checks/asset/image-resolution.ts
-var check27 = {
+var check29 = {
   id: "asset.image.resolution",
   name: "Image Resolution",
   description: "Checks source image DPI from embedded density metadata",
@@ -7757,7 +7970,7 @@ var check27 = {
       const { xDpi, yDpi } = info2;
       if (xDpi > 0 && yDpi > 0 && (xDpi < minDpi || yDpi < minDpi)) {
         results.push({
-          checkId: check27.id,
+          checkId: check29.id,
           severity: "warning",
           message: `Image resolution too low: ${xDpi}x${yDpi} DPI (minimum ${minDpi} DPI)`,
           file
@@ -7767,7 +7980,7 @@ var check27 = {
     return results;
   }
 };
-registerCheck(check27);
+registerCheck(check29);
 
 // src/checks/asset/image-color-space.ts
 var LABEL = {
@@ -7775,7 +7988,7 @@ var LABEL = {
   gray: "Gray",
   cmyk: "CMYK"
 };
-var check28 = {
+var check30 = {
   id: "asset.image.color-space",
   name: "Image Color Space",
   description: "Validates image color spaces against allowed list",
@@ -7796,7 +8009,7 @@ var check28 = {
       const cs = info2?.colorSpace;
       if (cs && !allowedLower.has(cs)) {
         results.push({
-          checkId: check28.id,
+          checkId: check30.id,
           severity: "warning",
           message: `Image uses ${LABEL[cs] ?? cs} color space (allowed: ${allowed.join(", ")})`,
           file
@@ -7806,10 +8019,10 @@ var check28 = {
     return results;
   }
 };
-registerCheck(check28);
+registerCheck(check30);
 
 // src/checks/asset/image-alpha.ts
-var check29 = {
+var check31 = {
   id: "asset.image.alpha-channel",
   name: "Image Alpha Channel",
   description: "Checks for alpha channels in PNG/TIFF images",
@@ -7827,7 +8040,7 @@ var check29 = {
       const info2 = await inspectImage(file);
       if (info2?.hasAlpha) {
         results.push({
-          checkId: check29.id,
+          checkId: check31.id,
           severity: "warning",
           message: "Image contains alpha channel, which may cause print issues",
           file
@@ -7837,10 +8050,10 @@ var check29 = {
     return results;
   }
 };
-registerCheck(check29);
+registerCheck(check31);
 
 // src/checks/asset/image-tac.ts
-var check30 = {
+var check32 = {
   id: "asset.image.tac-raster",
   name: "Image TAC (Raster)",
   description: "Rasterizes and checks TAC per image using Ghostscript",
@@ -7859,7 +8072,7 @@ var check30 = {
     const ghostscript = await resolveGhostscript();
     if (!ghostscript) {
       return [
-        inspectionFailed(check30.id, "Could not inspect image ink coverage: Ghostscript executable not found")
+        inspectionFailed(check32.id, "Could not inspect image ink coverage: Ghostscript executable not found")
       ];
     }
     for (const file of files) {
@@ -7877,7 +8090,7 @@ var check30 = {
           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(check30.id, {
+              results.push(finding(check32.id, {
                 severity: "warning",
                 message: `Image TAC exceeds limit: ${tac.toFixed(1)}% (max ${maxTac}%)`,
                 file,
@@ -7889,16 +8102,16 @@ var check30 = {
           }
         }
       } catch {
-        results.push(inspectionFailed(check30.id, `Could not inspect image ink coverage: ${file}`, { file }));
+        results.push(inspectionFailed(check32.id, `Could not inspect image ink coverage: ${file}`, { file }));
       }
     }
     return results;
   }
 };
-registerCheck(check30);
+registerCheck(check32);
 
 // src/checks/asset/approved-fonts.ts
-var check31 = {
+var check33 = {
   id: "asset.font.approved-files",
   name: "Approved Font Files",
   description: "Checks font files against the approved file patterns",
@@ -7937,7 +8150,7 @@ var check31 = {
     for (const font of allFonts) {
       if (!approvedFonts.has(font)) {
         results.push({
-          checkId: check31.id,
+          checkId: check33.id,
           severity: "warning",
           message: "Font file not in approved list",
           file: font
@@ -7947,7 +8160,7 @@ var check31 = {
     return results;
   }
 };
-registerCheck(check31);
+registerCheck(check33);
 
 // src/checks/asset/font-license.ts
 import { existsSync as existsSync10 } from "node:fs";
@@ -7962,7 +8175,7 @@ var LICENSE_NAMES = [
   "OFL-1.1.txt",
   "COPYING"
 ];
-var check32 = {
+var check34 = {
   id: "asset.font.license",
   name: "Font License",
   description: "Checks for license files in font directories",
@@ -7989,7 +8202,7 @@ var check32 = {
       const hasLicense = LICENSE_NAMES.some((name) => existsSync10(resolve6(fontDir, name)));
       if (!hasLicense) {
         results.push({
-          checkId: check32.id,
+          checkId: check34.id,
           severity: "warning",
           message: `No font license file found in directory`,
           file: fontDir
@@ -7999,10 +8212,10 @@ var check32 = {
     return results;
   }
 };
-registerCheck(check32);
+registerCheck(check34);
 
 // src/checks/heuristic/text-density.ts
-var check33 = {
+var check35 = {
   id: "heuristic.whitespace.text-density",
   name: "Text Density",
   description: "Checks characters-per-page ratio",
@@ -8031,7 +8244,7 @@ var check33 = {
     });
     if (lowPages.length > 0) {
       results.push({
-        checkId: check33.id,
+        checkId: check35.id,
         severity: "info",
         message: `Low text density on pages: ${lowPages.join(", ")} (below ${range.min} chars)`,
         file: ctx.pdfPath
@@ -8039,7 +8252,7 @@ var check33 = {
     }
     if (highPages.length > 0) {
       results.push({
-        checkId: check33.id,
+        checkId: check35.id,
         severity: "info",
         message: `High text density on pages: ${highPages.join(", ")} (above ${range.max} chars)`,
         file: ctx.pdfPath
@@ -8048,11 +8261,11 @@ var check33 = {
     return results;
   }
 };
-registerCheck(check33);
+registerCheck(check35);
 
 // src/checks/heuristic/section-density.ts
-import { readFile as readFile20 } from "node:fs/promises";
-var check34 = {
+import { readFile as readFile21 } from "node:fs/promises";
+var check36 = {
   id: "heuristic.chunking.section-density",
   name: "Section Density",
   description: "Checks heading/paragraph/callout density from source Markdown",
@@ -8068,7 +8281,7 @@ var check34 = {
     const results = [];
     for (const file of files) {
       try {
-        const content = await readFile20(file, "utf8");
+        const content = await readFile21(file, "utf8");
         const lines = content.split(`
 `);
         let currentSectionStart = 0;
@@ -8078,7 +8291,7 @@ var check34 = {
           const line = lines[i];
           if (/^#{1,6}\s/.test(line)) {
             if (paragraphCount > maxParas) {
-              results.push(finding(check34.id, {
+              results.push(finding(check36.id, {
                 severity: "info",
                 message: `Section has ${paragraphCount} paragraphs (max recommended: ${maxParas})`,
                 file,
@@ -8098,7 +8311,7 @@ var check34 = {
           }
         }
         if (paragraphCount > maxParas) {
-          results.push(finding(check34.id, {
+          results.push(finding(check36.id, {
             severity: "info",
             message: `Section has ${paragraphCount} paragraphs (max recommended: ${maxParas})`,
             file,
@@ -8106,7 +8319,7 @@ var check34 = {
           }));
         }
       } catch {
-        results.push(inspectionFailed(check34.id, `Could not read source file: ${file}`, {
+        results.push(inspectionFailed(check36.id, `Could not read source file: ${file}`, {
           file
         }));
       }
@@ -8114,10 +8327,10 @@ var check34 = {
     return results;
   }
 };
-registerCheck(check34);
+registerCheck(check36);
 
 // src/checks/heuristic/layer-count.ts
-var check35 = {
+var check37 = {
   id: "heuristic.decoration.layer-count",
   name: "Layer Count",
   description: "Counts image objects per page",
@@ -8142,7 +8355,7 @@ var check35 = {
       heavyPages.sort((a, b) => a - b);
       return [
         {
-          checkId: check35.id,
+          checkId: check37.id,
           severity: "info",
           message: `Pages with many image layers (>${maxLayers}): ${heavyPages.join(", ")}`,
           file: ctx.pdfPath
@@ -8152,10 +8365,10 @@ var check35 = {
     return [];
   }
 };
-registerCheck(check35);
+registerCheck(check37);
 
 // src/checks/heuristic/placement-variance.ts
-var check36 = {
+var check38 = {
   id: "heuristic.layout.placement-variance",
   name: "Placement Variance",
   description: "Analyzes text baseline coordinates for layout consistency",
@@ -8173,7 +8386,7 @@ var check36 = {
     const uniqueX = new Set(positions.map((p) => Math.round(p.x)));
     return [
       {
-        checkId: check36.id,
+        checkId: check38.id,
         severity: "info",
         message: `Layout analysis: ${uniqueX.size} unique horizontal text positions across ${positions.length} text blocks.`,
         file: ctx.pdfPath
@@ -8181,21 +8394,21 @@ var check36 = {
     ];
   }
 };
-registerCheck(check36);
+registerCheck(check38);
 
 // src/checks/tool-check.ts
 async function checkToolAvailability(config, opts = {}) {
   const { checks: checks2 } = selectChecks(opts, config);
   const toolToChecks = new Map;
-  for (const check37 of checks2) {
-    if (!check37.requiredTools?.length)
+  for (const check39 of checks2) {
+    if (!check39.requiredTools?.length)
       continue;
-    for (const tool of check37.requiredTools) {
+    for (const tool of check39.requiredTools) {
       const existing = toolToChecks.get(tool);
       if (existing) {
-        existing.push(check37.id);
+        existing.push(check39.id);
       } else {
-        toolToChecks.set(tool, [check37.id]);
+        toolToChecks.set(tool, [check39.id]);
       }
     }
   }
@@ -8211,11 +8424,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 check37 of checks2) {
-    if (!check37.requiredTools?.length)
+  for (const check39 of checks2) {
+    if (!check39.requiredTools?.length)
       continue;
-    if (check37.requiredTools.some((t) => missingSet.has(t))) {
-      skippedChecks.push(check37.id);
+    if (check39.requiredTools.some((t) => missingSet.has(t))) {
+      skippedChecks.push(check39.id);
     }
   }
   return { available, missing, skippedChecks, toolToChecks };
@@ -8254,7 +8467,7 @@ function artifactName(title, format) {
 var BOOK_HTML_FILENAME = "book.html";
 
 // src/lib/markdown/index.ts
-import { readdir as readdir3, readFile as readFile21, 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) {
@@ -8333,7 +8546,8 @@ ${projectCss.trim()}` : null
 `);
   const preloadTags = (opts.preloadImages ?? []).map((href) => `
   <link rel="preload" as="image" href="${href}">`).join("");
-  const printAttrs = (opts.print?.signature && opts.print.signature > 1 ? ` data-gp-signature="${opts.print.signature}"` : "") + (opts.print?.reserveLastPage ? " data-gp-reserve-last-page" : "");
+  const lastPage = opts.print && lastPageMode(opts.print);
+  const printAttrs = (opts.print?.signature && opts.print.signature > 1 ? ` data-gp-signature="${opts.print.signature}"` : "") + (lastPage ? ` data-gp-last-page="${lastPage}"` : "");
   return `<!DOCTYPE html>
 <html lang="en"${printAttrs}>
 <head>
@@ -8393,7 +8607,7 @@ ${css.trim()}
   }
   return assembleBookHtml({
     files,
-    readText: (relPath) => readFile21(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,
@@ -8425,7 +8639,7 @@ async function renderChaptersToFile(inputDir, outDir, opts = {}) {
 }
 
 // src/lib/markdownlint-fix.ts
-import { readFile as readFile22, 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) {
@@ -8465,7 +8679,7 @@ async function applyMarkdownlintFixes(ctx) {
   for (const [file, violations] of Object.entries(results)) {
     if (!Array.isArray(violations) || violations.length === 0)
       continue;
-    const before = await readFile22(file, "utf8");
+    const before = await readFile23(file, "utf8");
     const after = applyFixes(before, violations);
     if (after !== before)
       pending.push({ file, content: after });
@@ -8574,25 +8788,32 @@ async function runChecks(ctx, opts = {}) {
   }
   const release = retainPdfCache();
   try {
-    for (const check37 of checks2) {
+    for (const check39 of checks2) {
       try {
-        const results = await check37.run(ctx);
-        const severityOverride = getCheckSeverityOverride(check37.id, ctx.config);
+        let results = await check39.run(ctx);
+        const severityOverride = getCheckSeverityOverride(check39.id, ctx.config);
         if (severityOverride) {
           for (const r of results) {
             r.severity = severityOverride;
           }
         }
+        const lintLevel = ruleLevel(ctx.config.lint.rules, check39.id);
+        if (lintLevel === "off")
+          results = [];
+        else if (lintLevel) {
+          for (const r of results)
+            r.severity = lintLevel === "warn" ? "warning" : "error";
+        }
         if (results.length === 0) {
-          passed.push(check37.id);
+          passed.push(check39.id);
         } else {
           allResults.push(...results);
         }
       } catch (err) {
         allResults.push({
-          checkId: check37.id,
+          checkId: check39.id,
           severity: "error",
-          message: `Check "${check37.id}" threw: ${err instanceof Error ? err.message : String(err)}`
+          message: `Check "${check39.id}" threw: ${err instanceof Error ? err.message : String(err)}`
         });
       }
     }
@@ -8884,7 +9105,7 @@ async function executeValidation(args) {
   };
   if (args.fix) {
     const selected = selectChecks(runnerOptions, config).checks;
-    if (selected.some((check37) => check37.id === MARKDOWNLINT_CHECK_ID)) {
+    if (selected.some((check39) => check39.id === MARKDOWNLINT_CHECK_ID)) {
       await applyMarkdownlintFixes(context);
     } else {
       log.warn(`--fix: ${MARKDOWNLINT_CHECK_ID} is not part of this run — no files were fixed.`);
@@ -8971,7 +9192,7 @@ import { randomBytes } from "node:crypto";
 
 // src/lib/build-fingerprint.ts
 import * as fs from "node:fs";
-import { mkdir as mkdir5, readFile as readFile23, 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";
@@ -9058,8 +9279,8 @@ async function getEngineBundleHash() {
       getAssetPath("engine/gutterpress-agent.js")
     ]);
     const [viewerBytes, agentBytes] = await Promise.all([
-      readFile23(viewerPath),
-      readFile23(agentPath)
+      readFile24(viewerPath),
+      readFile24(agentPath)
     ]);
     const hash = createHash4("sha256");
     hash.update(viewerBytes);
@@ -9121,7 +9342,8 @@ async function writeBuildFingerprint(input) {
         requestedFlavor: input.pdfx.requestedFlavor,
         resolvedFlavor: input.pdfx.resolvedFlavor,
         iccPath: input.pdfx.iccPath,
-        stripAnnotations: input.pdfx.stripAnnotations
+        stripAnnotations: input.pdfx.stripAnnotations,
+        blackText: input.pdfx.blackText ?? null
       },
       outputDir: input.recordedOutputDir ? path12.resolve(input.recordedOutputDir) : outputDir
     },
@@ -9133,261 +9355,6 @@ async function writeBuildFingerprint(input) {
   return outPath;
 }
 
-// src/lib/black-text-gray.ts
-var MAX_CHANNEL = 0.12;
-var MAX_SPREAD = 0.04;
-function isNearBlack([r, g, b]) {
-  const max = Math.max(r, g, b);
-  return max <= MAX_CHANNEL && max - Math.min(r, g, b) <= MAX_SPREAD;
-}
-var WS = new Set([0, 9, 10, 12, 13, 32]);
-var DELIM = new Set("()<>[]{}/%".split("").map((c) => c.charCodeAt(0)));
-function* tokenize(s) {
-  let i = 0;
-  const n = s.length;
-  while (i < n) {
-    const c = s.charCodeAt(i);
-    if (WS.has(c)) {
-      i++;
-      continue;
-    }
-    const start = i;
-    if (c === 37) {
-      while (i < n && s[i] !== `
-` && s[i] !== "\r")
-        i++;
-      continue;
-    }
-    if (c === 40) {
-      let depth = 0;
-      while (i < n) {
-        const d = s[i++];
-        if (d === "\\")
-          i++;
-        else if (d === "(")
-          depth++;
-        else if (d === ")" && --depth === 0)
-          break;
-      }
-      yield { text: s.slice(start, i), start, end: i, op: false };
-      continue;
-    }
-    if (c === 60 && s[i + 1] === "<") {
-      i += 2;
-      yield { text: "<<", start, end: i, op: false };
-      continue;
-    }
-    if (c === 62 && s[i + 1] === ">") {
-      i += 2;
-      yield { text: ">>", start, end: i, op: false };
-      continue;
-    }
-    if (c === 60) {
-      while (i < n && s[i] !== ">")
-        i++;
-      i++;
-      yield { text: s.slice(start, i), start, end: i, op: false };
-      continue;
-    }
-    if (c === 91 || c === 93 || c === 62 || c === 123 || c === 125 || c === 41) {
-      i++;
-      yield { text: s[start], start, end: i, op: false };
-      continue;
-    }
-    i++;
-    while (i < n && !WS.has(s.charCodeAt(i)) && !DELIM.has(s.charCodeAt(i)))
-      i++;
-    const text = s.slice(start, i);
-    const isOperand = c === 47 || /^[+-]?(\d+\.?\d*|\.\d+)$/.test(text);
-    yield { text, start, end: i, op: !isOperand };
-    if (text === "ID") {
-      const m = /\sEI(?=\s|$)/g;
-      m.lastIndex = i;
-      const hit = m.exec(s);
-      i = hit ? hit.index + hit[0].length : n;
-    }
-  }
-}
-function rewriteBlackText(src) {
-  let fill = null;
-  let stroke = null;
-  const stack = [];
-  let inText = false;
-  let fillDirty = false;
-  let strokeDirty = false;
-  const edits = [];
-  let operands = [];
-  const rgbOf = () => {
-    if (operands.length !== 3)
-      return null;
-    const v = operands.map((t) => Number(t.text));
-    return v.some((x) => Number.isNaN(x)) ? null : { rgb: v, raw: operands.map((t) => t.text).join(" ") };
-  };
-  for (const t of tokenize(src)) {
-    if (!t.op) {
-      operands.push(t);
-      continue;
-    }
-    const op = t.text;
-    switch (op) {
-      case "q":
-        stack.push([fill, stroke]);
-        break;
-      case "Q": {
-        const p = stack.pop();
-        if (p)
-          [fill, stroke] = p;
-        break;
-      }
-      case "BT":
-        inText = true;
-        fillDirty = strokeDirty = false;
-        {
-          let ins = "";
-          if (fill && isNearBlack(fill.rgb)) {
-            ins += " 0 g";
-            fillDirty = true;
-          }
-          if (stroke && isNearBlack(stroke.rgb)) {
-            ins += " 0 G";
-            strokeDirty = true;
-          }
-          if (ins)
-            edits.push({ start: t.end, end: t.end, text: ins });
-        }
-        break;
-      case "ET":
-        if (inText) {
-          let ins = "";
-          if (fillDirty && fill)
-            ins += `${fill.raw} rg `;
-          if (strokeDirty && stroke)
-            ins += `${stroke.raw} RG `;
-          if (ins)
-            edits.push({ start: t.start, end: t.start, text: ins });
-        }
-        inText = false;
-        break;
-      case "rg":
-      case "RG": {
-        const c = rgbOf();
-        const isFill = op === "rg";
-        if (isFill)
-          fill = c;
-        else
-          stroke = c;
-        if (inText && c && isNearBlack(c.rgb)) {
-          edits.push({ start: operands[0].start, end: t.end, text: isFill ? "0 g" : "0 G" });
-          if (isFill)
-            fillDirty = true;
-          else
-            strokeDirty = true;
-        } else if (inText) {
-          if (isFill)
-            fillDirty = false;
-          else
-            strokeDirty = false;
-        }
-        break;
-      }
-      case "g":
-      case "k":
-      case "sc":
-      case "scn":
-      case "cs":
-        fill = null;
-        if (inText)
-          fillDirty = false;
-        break;
-      case "G":
-      case "K":
-      case "SC":
-      case "SCN":
-      case "CS":
-        stroke = null;
-        if (inText)
-          strokeDirty = false;
-        break;
-    }
-    operands = [];
-  }
-  return applyEdits(src, edits);
-}
-function applyEdits(s, edits) {
-  if (!edits.length)
-    return s;
-  let out = "";
-  let pos = 0;
-  for (const e of edits) {
-    out += s.slice(pos, e.start) + e.text;
-    pos = e.end;
-  }
-  return out + s.slice(pos);
-}
-async function blackTextToGray(pdf) {
-  const { PDFDocument, PDFName, PDFRawStream, PDFArray, PDFRef, decodePDFRawStream } = await import("pdf-lib");
-  const doc = await PDFDocument.load(pdf, { updateMetadata: false });
-  const ctx = doc.context;
-  const SKIP = ["Filter", "DecodeParms", "Length"].map((k) => PDFName.of(k));
-  let changed = false;
-  const decode = (s) => {
-    try {
-      return Buffer.from(decodePDFRawStream(s).decode()).toString("latin1");
-    } catch {
-      return null;
-    }
-  };
-  const replace = (ref, old, text) => {
-    const entries = {};
-    for (const [k, v] of old.dict.entries())
-      if (!SKIP.includes(k))
-        entries[k.decodeText()] = v;
-    ctx.assign(ref, ctx.flateStream(Buffer.from(text, "latin1"), entries));
-    changed = true;
-  };
-  for (const [ref, obj] of ctx.enumerateIndirectObjects()) {
-    if (!(obj instanceof PDFRawStream))
-      continue;
-    if (obj.dict.get(PDFName.of("Subtype")) !== PDFName.of("Form"))
-      continue;
-    const text = decode(obj);
-    if (text === null)
-      continue;
-    const next = rewriteBlackText(text);
-    if (next !== text)
-      replace(ref, obj, next);
-  }
-  for (const page of doc.getPages()) {
-    const contents = page.node.Contents();
-    const refs = [];
-    if (contents instanceof PDFArray) {
-      for (let i = 0;i < contents.size(); i++) {
-        const r = contents.get(i);
-        if (r instanceof PDFRef)
-          refs.push(r);
-      }
-    } else if (contents instanceof PDFRawStream) {
-      const r = page.node.get(PDFName.of("Contents"));
-      if (r instanceof PDFRef)
-        refs.push(r);
-    }
-    const streams = refs.map((r) => ctx.lookup(r));
-    if (!refs.length || !streams.every((s) => s instanceof PDFRawStream))
-      continue;
-    const parts = streams.map((s) => decode(s));
-    if (parts.some((p) => p === null))
-      continue;
-    const joined = parts.join(`
-`);
-    const next = rewriteBlackText(joined);
-    if (next === joined)
-      continue;
-    replace(refs[0], streams[0], next);
-    page.node.set(PDFName.of("Contents"), refs[0]);
-  }
-  return changed ? doc.save({ updateFieldAppearances: false }) : pdf;
-}
-
 // src/lib/build-preflight.ts
 var INSTALL_HINTS2 = {
   gs: INSTALL_HINTS.gs.body,
@@ -9662,7 +9629,8 @@ class HtmlOutput {
         requestedFlavor: null,
         resolvedFlavor: config.pdfx.flavor,
         iccPath: null,
-        stripAnnotations: null
+        stripAnnotations: null,
+        blackText: null
       }
     }, `Wrote: ${path13.join(outDir, BOOK_HTML)}`, { htmlPath: htmlFile, pdfPath: null });
   }
@@ -9682,12 +9650,12 @@ 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-078ggczp.js");
+      const { buildNativePdf } = await import("./engine-zdb41ay1.js");
       const engineDiagnostics = await buildNativePdf(htmlFile, rawPdf, {
         title: config.title,
         author: config.authors.length > 0 ? config.authors.join(", ") : undefined,
         signature: config.print.signature,
-        reserveLastPage: config.print.reserveLastPage,
+        lastPage: lastPageMode(config.print),
         allowShrink: opts.allowShrink
       }, browser);
       for (const d of engineDiagnostics)
@@ -9746,7 +9714,8 @@ class PdfOutput {
           requestedFlavor: pdfxMode ?? null,
           resolvedFlavor: config.pdfx.flavor,
           iccPath: effectiveIccPath,
-          stripAnnotations: shouldStripAnnotations
+          stripAnnotations: shouldStripAnnotations,
+          blackText: pdfxMode ? config.pdfx.blackText : null
         }
       }, `Wrote: ${reportedPdf}`, { htmlPath: htmlFile, pdfPath: reportedPdf }, pdfName, engineDiagnostics);
     } finally {
@@ -9816,7 +9785,7 @@ function openPath(filePath) {
 import path16 from "path";
 import { tmpdir } from "os";
 import { randomBytes as randomBytes2 } from "crypto";
-import { readdir as readdir4, readFile as readFile24, 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";
@@ -10365,7 +10334,7 @@ async function cleanupOrphanTempDirs() {
     const dir = path16.join(TEMP_DIR_BASE, entry);
     const pidFile = path16.join(dir, PID_FILE_NAME);
     try {
-      const raw = await readFile24(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)`);
@@ -10472,7 +10441,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 readFile25, stat as stat5 } from "node:fs/promises";
+import { readFile as readFile26, stat as stat5 } from "node:fs/promises";
 import path17 from "path";
 import { WebSocket, WebSocketServer } from "ws";
 var HMR_PATH = "/__gutterpress-hmr";
@@ -10541,7 +10510,7 @@ async function serveStatic(absPath, res, cacheControl = "no-store", extraHeaders
   }
   let data;
   try {
-    data = await readFile25(filePath);
+    data = await readFile26(filePath);
   } catch {
     res.writeHead(404);
     res.end("Not Found");
@@ -10590,7 +10559,7 @@ async function serveRevalidatedStatic(req, absPath, res, validators) {
   let data;
   if (!validator || validator.stamp !== stamp) {
     try {
-      data = await readFile25(absPath);
+      data = await readFile26(absPath);
     } catch {
       await serveStatic(absPath, res);
       return;
@@ -10900,9 +10869,29 @@ async function startPreviewServer(options) {
 }
 
 // src/lib/project-scaffold.ts
-import { access, copyFile, cp as cp2, mkdir as mkdir7, readdir as readdir5, readFile as readFile26, 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 stat6, writeFile as writeFile6 } from "node:fs/promises";
 import { constants as FS, existsSync as existsSync12 } from "node:fs";
 import path18 from "node:path";
+
+// src/lib/page-size.ts
+import postcss4 from "postcss";
+import { Scalar as Scalar2 } from "yaml";
+function isPositivePoints(value) {
+  return typeof value === "number" && Number.isFinite(value) && value > 0;
+}
+function writePageBounds(doc, page) {
+  const out = { width: page.width, height: page.height };
+  const tolerance = page.tolerance ?? numberAt(doc, ["page", "tolerance"]);
+  if (tolerance !== undefined)
+    out.tolerance = tolerance;
+  doc.set("page", doc.createNode(out));
+}
+function numberAt(doc, keyPath) {
+  const v = doc.getIn(keyPath);
+  return isPositivePoints(v) ? v : undefined;
+}
+
+// src/lib/project-scaffold.ts
 function starterOverridesCss() {
   return `/**
  * Your book's own styles.
@@ -10931,9 +10920,6 @@ function escapeYamlScalar(value) {
   return value.replace(/\\/g, "\\\\").replace(/"/g, "\\\"");
 }
 var DEFAULT_AUTHOR = "Anonymous";
-function isPositivePoints(value) {
-  return typeof value === "number" && Number.isFinite(value) && value > 0;
-}
 function requirePreset(preset, customPage) {
   if (!preset || !PRESET_IDS.includes(preset)) {
     const got = preset ? ` (got "${preset}")` : "";
@@ -11037,16 +11023,8 @@ async function scaffoldProject(options) {
       const { doc, file } = await loadManifestDoc(projectDir);
       doc.set("preset", preset);
       doc.set("targets", doc.createNode(targets ?? []));
-      if (options.customPage) {
-        const page = {
-          width: options.customPage.width,
-          height: options.customPage.height
-        };
-        if (options.customPage.tolerance !== undefined) {
-          page.tolerance = options.customPage.tolerance;
-        }
-        doc.set("page", doc.createNode(page));
-      }
+      if (options.customPage)
+        writePageBounds(doc, options.customPage);
       await writeManifestDoc(file, doc);
     }
     const firstSource = await firstSourceFile(manifestPath);
@@ -11090,7 +11068,7 @@ async function scaffoldProject(options) {
 async function firstSourceFile(manifestPath) {
   let text;
   try {
-    text = await readFile26(manifestPath, "utf8");
+    text = await readFile27(manifestPath, "utf8");
   } catch {
     return;
   }
@@ -11102,7 +11080,7 @@ async function firstSourceFile(manifestPath) {
   return m ? m[1].trim() : undefined;
 }
 async function fillTemplateFile(filePath, substitutions) {
-  let text = await readFile26(filePath, "utf8");
+  let text = await readFile27(filePath, "utf8");
   for (const [token, value] of Object.entries(substitutions)) {
     text = text.split(token).join(value);
   }
@@ -11110,7 +11088,7 @@ async function fillTemplateFile(filePath, substitutions) {
 }
 
 // src/lib/extension-scaffold.ts
-import { access as access2, mkdir as mkdir8, readFile as readFile27, 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"];
@@ -11227,7 +11205,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 readFile27(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);
@@ -11272,7 +11250,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 readFile28, 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";
@@ -11345,7 +11323,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 readFile28(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}`);
@@ -11373,7 +11351,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 readFile28(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}`);
@@ -11406,7 +11384,7 @@ async function completeLandedManifest(dest, id, meta, metaExists) {
   let pkg = {};
   if (metaExists) {
     try {
-      const parsed = JSON.parse(await readFile28(file, "utf8"));
+      const parsed = JSON.parse(await readFile29(file, "utf8"));
       if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {
         pkg = parsed;
       }
@@ -11508,11 +11486,11 @@ async function importExtensionFromCssText(projectDir, css, name) {
 async function importExtensionFromFile(projectDir, filePath) {
   const ext = path20.extname(filePath).toLowerCase();
   if (ext === ".zip") {
-    const buf = await readFile28(filePath);
+    const buf = await readFile29(filePath);
     return importExtensionFromZip(projectDir, new Uint8Array(buf.buffer, buf.byteOffset, buf.byteLength));
   }
   if (ext === ".css") {
-    const css = await readFile28(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.");
@@ -12296,7 +12274,7 @@ var drivethrurpgProvider = {
 };
 
 // src/lib/publish/providers/gdrive.ts
-import { mkdtemp as mkdtemp3, readFile as readFile29, 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 stat7, writeFile as writeFile10 } from "node:fs/promises";
 import { tmpdir as tmpdir3 } from "node:os";
 import path22 from "node:path";
 import { Zip, ZipDeflate } from "fflate";
@@ -12688,12 +12666,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 readFile29(full);
+      out[rel] = await readFile30(full);
     } else if (entry.isSymbolicLink()) {
       const resolved = await stat7(full).catch(() => null);
       if (resolved?.isFile()) {
         const rel = path22.relative(root, full).split(path22.sep).join("/");
-        out[rel] = await readFile29(full);
+        out[rel] = await readFile30(full);
       } else if (resolved?.isDirectory()) {
         await collectZipEntries(root, full, out, onWarn);
       } else {
@@ -13562,13 +13540,16 @@ async function disconnectPublishCredential(key, deps, options = {}) {
   }
 }
 // src/lib/manifest-config.ts
-import { isSeq as isSeq4, isMap as isMap3, YAMLSeq as YAMLSeq3, Scalar as Scalar2 } from "yaml";
+import { isSeq as isSeq4, isMap as isMap3, YAMLSeq as YAMLSeq3, Scalar as Scalar3 } from "yaml";
 // src/lib/host-policy.ts
 var AUTO_SYNC_MAX_MINUTES = 24 * 60;
 // src/lib/remote-auth/github-repos.ts
 var MANIFEST_NAMES = new Set(MANIFEST_FILENAMES);
-// src/lib/remote-auth/clone.ts
-import git3 from "isomorphic-git";
+// src/lib/remote-auth/online-backup.ts
+import git5 from "isomorphic-git";
+
+// src/lib/remote-auth/sync.ts
+import git4 from "isomorphic-git";
 
 // src/lib/remote-auth/git-http.ts
 import httpNode from "isomorphic-git/http/node";
@@ -13661,23 +13642,23 @@ function withIdleTimeout(http3, idleMs = GIT_HTTP_IDLE_TIMEOUT_MS, uploadMs = GI
 }
 var defaultGitHttp = withIdleTimeout(httpNode);
 
-// src/lib/remote-auth/transport.ts
+// src/lib/remote-auth/converge-merge.ts
 import git2 from "isomorphic-git";
+import diff3Merge from "diff3";
+
+// src/lib/remote-auth/transport.ts
+import git3 from "isomorphic-git";
+// src/lib/remote-auth/clone.ts
+import git6 from "isomorphic-git";
 // src/lib/remote-auth/test-access.ts
-import git4 from "isomorphic-git";
+import git7 from "isomorphic-git";
 import httpNode2 from "isomorphic-git/http/node";
-// src/lib/remote-auth/sync.ts
-import git6 from "isomorphic-git";
-
-// src/lib/remote-auth/converge-merge.ts
-import git5 from "isomorphic-git";
-import diff3Merge from "diff3";
 // src/lib/remote-auth/repair.ts
-import git7 from "isomorphic-git";
-// src/lib/remote-auth/scorched-earth.ts
 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 readFile30, 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;
@@ -13687,7 +13668,7 @@ class PublishSelectionsStore {
   }
   async read() {
     try {
-      const raw = await readFile30(this.filePath, "utf8");
+      const raw = await readFile31(this.filePath, "utf8");
       const parsed = JSON.parse(raw);
       if (parsed && typeof parsed === "object") {
         return {