gutterpress 0.11.17-alpha.1 → 0.11.17-alpha.3

package/dist/{cli-ew3gc4nt.js → cli-9nba5ve6.js}

@@ -13,17 +13,18 @@ import {
   stampCreator,
   stripAnnotations,
   warn
-} from "./cli-0754wskb.js";
+} from "./cli-3p1e95zc.js";
 import {
   DEBOUNCE,
   UsageError,
   resolvePort
-} from "./cli-zce1zcqc.js";
+} from "./cli-d57bsfpb.js";
 import {
   MARGIN_BOX_IGNORED_PROPERTIES,
   getAssetPath,
-  getAssetsDir
-} from "./cli-xx5bryh6.js";
+  getAssetsDir,
+  lastPageMode
+} from "./cli-jyy9pqf3.js";
 import {
   BuildError,
   EXIT_CODES
@@ -106,7 +107,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 +125,8 @@ var DTRPG_PRESET = {
   },
   lint: {
     enabled: true,
-    configPath: null
+    configPath: null,
+    rules: {}
   },
   validate: {
     enabled: true,
@@ -181,7 +183,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 +201,8 @@ var BOOK_PRESET = {
   },
   lint: {
     enabled: true,
-    configPath: null
+    configPath: null,
+    rules: {}
   },
   validate: {
     enabled: true,
@@ -566,6 +569,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 +589,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 +1088,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 +1145,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 +1423,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 +1435,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 +1715,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 +5015,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 +5544,62 @@ var check7 = {
 };
 registerCheck(check7);
 
-// src/checks/pdf/bookmarks.ts
+// src/checks/pdf/signature.ts
 var check8 = {
+  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(check8.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(check8.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(check8.id, "Could not read the last page.", { file: ctx.pdfPath })];
+    }
+    return [
+      finding(check8.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(check8);
+
+// src/checks/pdf/bookmarks.ts
+var check9 = {
   id: "pdf.nav.bookmarks",
   name: "Bookmarks",
   description: "Checks for PDF outline (bookmarks) tree",
@@ -5505,14 +5613,14 @@ var check8 = {
     const doc = await loadPdf(ctx.pdfPath);
     if (!doc) {
       return [
-        inspectionFailed(check8.id, "Could not inspect PDF for bookmarks.", {
+        inspectionFailed(check9.id, "Could not inspect PDF for bookmarks.", {
           file: ctx.pdfPath
         })
       ];
     }
     if (await getOutlineCount(doc) === 0) {
       return [
-        finding(check8.id, {
+        finding(check9.id, {
           severity: "warning",
           message: "PDF does not contain bookmarks (outline tree).",
           file: ctx.pdfPath
@@ -5522,10 +5630,10 @@ var check8 = {
     return [];
   }
 };
-registerCheck(check8);
+registerCheck(check9);
 
 // src/checks/pdf/toc-links.ts
-var check9 = {
+var check10 = {
   id: "pdf.nav.toc-links",
   name: "TOC Links",
   description: "Detects link annotations on TOC pages",
@@ -5540,7 +5648,7 @@ var check9 = {
     if (!doc) {
       return [
         {
-          checkId: check9.id,
+          checkId: check10.id,
           severity: "warning",
           message: "Could not inspect PDF for TOC links.",
           file: ctx.pdfPath
@@ -5551,7 +5659,7 @@ var check9 = {
     if (!hasLinks) {
       return [
         {
-          checkId: check9.id,
+          checkId: check10.id,
           severity: "warning",
           message: "No link annotations found in PDF (expected for TOC).",
           file: ctx.pdfPath
@@ -5561,10 +5669,10 @@ var check9 = {
     return [];
   }
 };
-registerCheck(check9);
+registerCheck(check10);
 
 // src/checks/pdf/cross-refs.ts
-var check10 = {
+var check11 = {
   id: "pdf.nav.cross-refs",
   name: "Cross References",
   description: "Counts and verifies internal link annotations",
@@ -5577,7 +5685,7 @@ var check10 = {
     if (!doc) {
       return [
         {
-          checkId: check10.id,
+          checkId: check11.id,
           severity: "info",
           message: "Could not inspect PDF for cross-references.",
           file: ctx.pdfPath
@@ -5587,7 +5695,7 @@ var check10 = {
     const linkCount = await countLinkAnnotations(doc);
     return [
       {
-        checkId: check10.id,
+        checkId: check11.id,
         severity: "info",
         message: `PDF contains ${linkCount} internal link annotation${linkCount !== 1 ? "s" : ""}.`,
         file: ctx.pdfPath
@@ -5595,10 +5703,10 @@ var check10 = {
     ];
   }
 };
-registerCheck(check10);
+registerCheck(check11);
 
 // src/checks/pdf/page-labels.ts
-var check11 = {
+var check12 = {
   id: "pdf.nav.page-labels",
   name: "Page Labels",
   description: "Verifies PDF page labels / folio numbering",
@@ -5613,7 +5721,7 @@ var check11 = {
     const labels = await getPageLabels(doc);
     return [
       {
-        checkId: check11.id,
+        checkId: check12.id,
         severity: "info",
         message: labels && labels.length > 0 ? "PDF contains page labels." : "PDF does not contain explicit page labels.",
         file: ctx.pdfPath
@@ -5621,10 +5729,10 @@ var check11 = {
     ];
   }
 };
-registerCheck(check11);
+registerCheck(check12);
 
 // src/checks/pdf/image-resolution.ts
-var check12 = {
+var check13 = {
   id: "pdf.print.image-resolution",
   name: "Image Resolution",
   description: "Checks DPI of images embedded in the PDF",
@@ -5651,7 +5759,7 @@ var check12 = {
       lowResPages.sort((a, b) => a - b);
       return [
         {
-          checkId: check12.id,
+          checkId: check13.id,
           severity: "warning",
           message: `Low-resolution images (below ${minDpi} DPI) found on pages: ${lowResPages.join(", ")}`,
           file: ctx.pdfPath
@@ -5661,10 +5769,10 @@ var check12 = {
     return [];
   }
 };
-registerCheck(check12);
+registerCheck(check13);
 
 // src/checks/pdf/transparency.ts
-var check13 = {
+var check14 = {
   id: "pdf.print.transparency",
   name: "Transparency",
   description: "Checks for transparency markers (/Transparency, /SMask, /BM) in the PDF",
@@ -5686,7 +5794,7 @@ var check13 = {
     if (found.length > 0) {
       return [
         {
-          checkId: check13.id,
+          checkId: check14.id,
           severity: "warning",
           message: `Transparency detected in PDF: ${found.join(", ")}. This may cause issues with some printers.`,
           file: ctx.pdfPath
@@ -5696,7 +5804,7 @@ var check13 = {
     return [];
   }
 };
-registerCheck(check13);
+registerCheck(check14);
 
 // src/checks/pdf/bleed.ts
 function findBox(bytes, box) {
@@ -5706,7 +5814,7 @@ function findBox(bytes, box) {
     return null;
   return [Number(m[1]), Number(m[2]), Number(m[3]), Number(m[4])];
 }
-var check14 = {
+var check15 = {
   id: "pdf.print.bleed",
   name: "Bleed Box",
   description: "Compares MediaBox vs TrimBox/BleedBox to verify bleed area",
@@ -5720,7 +5828,7 @@ var check14 = {
     const bytes = await readPdfBytes(ctx.pdfPath).catch(() => "");
     if (!bytes) {
       return [
-        inspectionFailed(check14.id, "Could not inspect PDF for bleed boxes.", {
+        inspectionFailed(check15.id, "Could not inspect PDF for bleed boxes.", {
           file: ctx.pdfPath
         })
       ];
@@ -5730,14 +5838,14 @@ var check14 = {
     const bleed = findBox(bytes, "BleedBox");
     if (!media) {
       return [
-        inspectionFailed(check14.id, "Could not parse MediaBox from PDF.", {
+        inspectionFailed(check15.id, "Could not parse MediaBox from PDF.", {
           file: ctx.pdfPath
         })
       ];
     }
     if (!trim && !bleed) {
       return [
-        finding(check14.id, {
+        finding(check15.id, {
           severity: "warning",
           message: "No TrimBox or BleedBox found. Bleed area cannot be verified.",
           file: ctx.pdfPath
@@ -5750,7 +5858,7 @@ var check14 = {
       const bleedSize = ctx.config.validate.pdf.bleedSize;
       if (mediaW - trimW < bleedSize * 2 * 0.9) {
         return [
-          finding(check14.id, {
+          finding(check15.id, {
             severity: "warning",
             message: `Bleed area appears insufficient. Expected at least ${bleedSize}pt on each side.`,
             file: ctx.pdfPath
@@ -5761,10 +5869,10 @@ var check14 = {
     return [];
   }
 };
-registerCheck(check14);
+registerCheck(check15);
 
 // src/checks/pdf/pdfx-metadata.ts
-var check15 = {
+var check16 = {
   id: "pdf.print.pdfx-metadata",
   name: "PDF/X Metadata",
   description: "Verifies PDF/X DOCINFO metadata via qpdf JSON",
@@ -5783,22 +5891,22 @@ 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(check16.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(check16.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(check16.id, "Failed to inspect PDF objects with qpdf for PDF/X metadata.", { file: ctx.pdfPath })
       ];
     }
   }
 };
-registerCheck(check15);
+registerCheck(check16);
 
 // src/checks/source/markdownlint.ts
 import { readFile as readFile9 } from "node:fs/promises";
@@ -5853,7 +5961,7 @@ async function loadConfig(configPath) {
   return {};
 }
 var MARKDOWNLINT_CHECK_ID = "source.markdownlint";
-var check16 = {
+var check17 = {
   id: MARKDOWNLINT_CHECK_ID,
   name: "Markdownlint",
   description: "Runs markdownlint with project config to validate Markdown files",
@@ -5878,7 +5986,7 @@ var check16 = {
         continue;
       for (const v of violations) {
         out.push({
-          checkId: check16.id,
+          checkId: check17.id,
           severity: "warning",
           message: `${v.ruleDescription} (${v.ruleNames.join("/")})`,
           file,
@@ -5891,7 +5999,7 @@ var check16 = {
     return out;
   }
 };
-registerCheck(check16);
+registerCheck(check17);
 
 // src/checks/source/htmlhint.ts
 import { existsSync as existsSync7 } from "node:fs";
@@ -5899,7 +6007,7 @@ import { readFile as readFile10 } from "node:fs/promises";
 import htmlhint from "htmlhint";
 var { HTMLHint } = htmlhint;
 var CONFIG_NAMES2 = [".htmlhintrc"];
-var check17 = {
+var check18 = {
   id: "source.htmlhint",
   name: "HTMLHint",
   description: "Runs htmlhint with project config to validate generated HTML",
@@ -5919,7 +6027,7 @@ var check17 = {
     const html = await readFile10(ctx.htmlPath, "utf8");
     const messages = HTMLHint.verify(html, ruleset);
     return messages.map((m) => ({
-      checkId: check17.id,
+      checkId: check18.id,
       severity: m.type === "error" ? "error" : "warning",
       message: `${m.rule.id}: ${m.message}`,
       file: ctx.htmlPath,
@@ -5928,13 +6036,35 @@ var check17 = {
     }));
   }
 };
-registerCheck(check17);
+registerCheck(check18);
 
 // src/checks/source/stylelint.ts
 import { readFile as readFile11 } 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 +6089,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 +6220,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 +6296,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 +6356,7 @@ function checkCss(css, from) {
 }
 
 // src/checks/source/stylelint.ts
-var check18 = {
+var check19 = {
   id: "source.stylelint",
   name: "Print-safety CSS",
   description: "Checks CSS for print-safety issues (remote URLs, rasterizing effects, and page-layer containment)",
@@ -6210,16 +6376,16 @@ var check18 = {
         css = await readFile11(file, "utf8");
       } catch (err) {
         results.push({
-          checkId: check18.id,
+          checkId: check19.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: check19.id,
           severity: w.severity,
           message: `${w.rule}: ${w.message}`,
           file,
@@ -6231,7 +6397,7 @@ var check18 = {
     return results;
   }
 };
-registerCheck(check18);
+registerCheck(check19);
 
 // src/checks/source/css-ownership.ts
 import { readFile as readFile12 } from "node:fs/promises";
@@ -6415,7 +6581,7 @@ function checkOwnership(root, file, maps) {
   });
   return out;
 }
-var check19 = {
+var check20 = {
   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 +6604,7 @@ var check19 = {
     } catch (err) {
       return [
         {
-          checkId: check19.id,
+          checkId: check20.id,
           severity: "error",
           message: `Failed to parse CSS ownership contract "${configPath}": ${err instanceof Error ? err.message : String(err)}`,
           file: configPath
@@ -6480,7 +6646,7 @@ var check19 = {
       }
       for (const v of violations) {
         results.push({
-          checkId: check19.id,
+          checkId: check20.id,
           severity: "warning",
           message: v.message,
           file: absFile,
@@ -6492,7 +6658,7 @@ var check19 = {
     return results;
   }
 };
-registerCheck(check19);
+registerCheck(check20);
 
 // src/checks/source/local-refs.ts
 import { existsSync as existsSync9 } from "node:fs";
@@ -6883,7 +7049,7 @@ async function* renderedLocalRefs(ctx, checkId, results) {
 }
 
 // src/checks/source/local-refs.ts
-var check20 = {
+var check21 = {
   id: "source.links.local-refs",
   name: "Local Markdown References",
   description: "Checks local markdown links and image refs resolve on disk",
@@ -6891,12 +7057,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, check21.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(check21.id, {
           severity: "error",
           message: escape,
           file,
@@ -6906,7 +7072,7 @@ var check20 = {
       }
       if (localRefExists(ref, kind, file, ctx.inputDir))
         continue;
-      results.push(finding(check20.id, {
+      results.push(finding(check21.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 +7097,7 @@ function localRefExists(ref, kind, sourceFile, projectRoot) {
       return existsSync9(fileRelative);
   }
 }
-registerCheck(check20);
+registerCheck(check21);
 
 // src/lib/build-staging.ts
 import path9 from "node:path";
@@ -7197,7 +7363,7 @@ async function createStageRoot() {
 }
 
 // src/checks/source/dangling-links.ts
-var check21 = {
+var check22 = {
   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 +7371,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, check22.id, results)) {
       if (kind !== "link" || isPrintResolvableHref(ref))
         continue;
-      results.push(finding(check21.id, {
+      results.push(finding(check22.id, {
         severity: "warning",
         code: "dangling-link",
         data: { ref },
@@ -7220,11 +7386,11 @@ var check21 = {
     return results;
   }
 };
-registerCheck(check21);
+registerCheck(check22);
 
 // src/checks/source/accessibility-alt-text.ts
 import { readFile as readFile15 } from "node:fs/promises";
-var check22 = {
+var check23 = {
   id: "source.accessibility.alt-text",
   name: "Image Alt Text",
   description: "Checks markdown images include non-empty alt text",
@@ -7253,7 +7419,7 @@ var check22 = {
             if (alt.trim())
               continue;
             results.push({
-              checkId: check22.id,
+              checkId: check23.id,
               severity: "warning",
               message: "Image is missing alt text",
               file,
@@ -7278,11 +7444,11 @@ function extractImageAlts(line) {
   }
   return alts;
 }
-registerCheck(check22);
+registerCheck(check23);
 
 // src/checks/source/accessibility-heading-order.ts
 import { readFile as readFile16 } from "node:fs/promises";
-var check23 = {
+var check24 = {
   id: "source.accessibility.heading-order",
   name: "Heading Order",
   description: "Checks markdown heading levels do not jump by more than one",
@@ -7300,6 +7466,7 @@ var check23 = {
 `);
         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 +7475,18 @@ var check23 = {
           }
           if (inFence)
             continue;
+          const comment = /^\s*<!--(.*)-->\s*$/.exec(line);
+          if (comment && parseDisableDirective(comment[1])?.includes(check24.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: check24.id,
               severity: "warning",
               message: `Heading level jump from h${prevLevel} to h${level}`,
               file,
@@ -7328,11 +7500,11 @@ var check23 = {
     return results;
   }
 };
-registerCheck(check23);
+registerCheck(check24);
 
 // src/checks/source/layout-markers.ts
 import { readFile as readFile17 } from "node:fs/promises";
-var check24 = {
+var check25 = {
   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,7 +7516,7 @@ 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(check25.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) {
@@ -7353,7 +7525,7 @@ var check24 = {
         const env = {};
         md.render(content, env);
         for (const w of env.layoutWarnings ?? []) {
-          results.push(finding(check24.id, {
+          results.push(finding(check25.id, {
             severity: w.severity ?? "warning",
             message: w.message,
             file,
@@ -7362,13 +7534,13 @@ 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(check25.id, `Could not check layout markers in ${file}: ${error2 instanceof Error ? error2.message : String(error2)}`, { file }));
       }
     }
     return results;
   }
 };
-registerCheck(check24);
+registerCheck(check25);
 
 // src/checks/source/merge-markers.ts
 import { readFile as readFile18 } from "node:fs/promises";
@@ -7401,7 +7573,7 @@ var CLOSE_SENTINEL = ">>>>>>> online version";
 function withoutOnlineTag(relPath) {
   return relPath.replace(/\.online(?=\.[^./]*$|$)/, "");
 }
-var check25 = {
+var check26 = {
   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",
@@ -7415,7 +7587,7 @@ var check25 = {
       try {
         content = await readFile18(file, "utf8");
       } catch {
-        results.push(inspectionFailed(check25.id, `Could not read source file: ${file}`, { file }));
+        results.push(inspectionFailed(check26.id, `Could not read source file: ${file}`, { file }));
         continue;
       }
       if (!content.includes(OPEN_SENTINEL) && !content.includes(CLOSE_SENTINEL))
@@ -7427,7 +7599,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(check26.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 +7608,7 @@ var check25 = {
           }));
         } else if (line === CLOSE_SENTINEL) {
           if (!inBlock) {
-            results.push(finding(check25.id, {
+            results.push(finding(check26.id, {
               severity: "error",
               code: "leftover-version-marker",
               message: "This marker line is left over from combining two versions — delete it.",
@@ -7457,7 +7629,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(check26.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,12 +7637,12 @@ 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(check26.id, `Could not scan for kept-both files: ${error2 instanceof Error ? error2.message : String(error2)}`));
     }
     return results;
   }
 };
-registerCheck(check25);
+registerCheck(check26);
 
 // src/checks/asset/image-file-size.ts
 import { stat as stat4 } from "node:fs/promises";
@@ -7696,7 +7868,7 @@ async function collectImageFiles(dirs, exts, ignore2 = ASSET_SCAN_IGNORE_GLOBS)
 }
 
 // src/checks/asset/image-file-size.ts
-var check26 = {
+var check27 = {
   id: "asset.image.file-size",
   name: "Image File Size",
   description: "Checks that image files do not exceed the maximum size limit",
@@ -7717,14 +7889,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(check27.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(check27.id, `Could not stat image file: ${file}`, {
           file
         }));
       }
@@ -7732,10 +7904,10 @@ var check26 = {
     return results;
   }
 };
-registerCheck(check26);
+registerCheck(check27);
 
 // src/checks/asset/image-resolution.ts
-var check27 = {
+var check28 = {
   id: "asset.image.resolution",
   name: "Image Resolution",
   description: "Checks source image DPI from embedded density metadata",
@@ -7757,7 +7929,7 @@ var check27 = {
       const { xDpi, yDpi } = info2;
       if (xDpi > 0 && yDpi > 0 && (xDpi < minDpi || yDpi < minDpi)) {
         results.push({
-          checkId: check27.id,
+          checkId: check28.id,
           severity: "warning",
           message: `Image resolution too low: ${xDpi}x${yDpi} DPI (minimum ${minDpi} DPI)`,
           file
@@ -7767,7 +7939,7 @@ var check27 = {
     return results;
   }
 };
-registerCheck(check27);
+registerCheck(check28);
 
 // src/checks/asset/image-color-space.ts
 var LABEL = {
@@ -7775,7 +7947,7 @@ var LABEL = {
   gray: "Gray",
   cmyk: "CMYK"
 };
-var check28 = {
+var check29 = {
   id: "asset.image.color-space",
   name: "Image Color Space",
   description: "Validates image color spaces against allowed list",
@@ -7796,7 +7968,7 @@ var check28 = {
       const cs = info2?.colorSpace;
       if (cs && !allowedLower.has(cs)) {
         results.push({
-          checkId: check28.id,
+          checkId: check29.id,
           severity: "warning",
           message: `Image uses ${LABEL[cs] ?? cs} color space (allowed: ${allowed.join(", ")})`,
           file
@@ -7806,10 +7978,10 @@ var check28 = {
     return results;
   }
 };
-registerCheck(check28);
+registerCheck(check29);
 
 // src/checks/asset/image-alpha.ts
-var check29 = {
+var check30 = {
   id: "asset.image.alpha-channel",
   name: "Image Alpha Channel",
   description: "Checks for alpha channels in PNG/TIFF images",
@@ -7827,7 +7999,7 @@ var check29 = {
       const info2 = await inspectImage(file);
       if (info2?.hasAlpha) {
         results.push({
-          checkId: check29.id,
+          checkId: check30.id,
           severity: "warning",
           message: "Image contains alpha channel, which may cause print issues",
           file
@@ -7837,10 +8009,10 @@ var check29 = {
     return results;
   }
 };
-registerCheck(check29);
+registerCheck(check30);
 
 // src/checks/asset/image-tac.ts
-var check30 = {
+var check31 = {
   id: "asset.image.tac-raster",
   name: "Image TAC (Raster)",
   description: "Rasterizes and checks TAC per image using Ghostscript",
@@ -7859,7 +8031,7 @@ var check30 = {
     const ghostscript = await resolveGhostscript();
     if (!ghostscript) {
       return [
-        inspectionFailed(check30.id, "Could not inspect image ink coverage: Ghostscript executable not found")
+        inspectionFailed(check31.id, "Could not inspect image ink coverage: Ghostscript executable not found")
       ];
     }
     for (const file of files) {
@@ -7877,7 +8049,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(check31.id, {
                 severity: "warning",
                 message: `Image TAC exceeds limit: ${tac.toFixed(1)}% (max ${maxTac}%)`,
                 file,
@@ -7889,16 +8061,16 @@ var check30 = {
           }
         }
       } catch {
-        results.push(inspectionFailed(check30.id, `Could not inspect image ink coverage: ${file}`, { file }));
+        results.push(inspectionFailed(check31.id, `Could not inspect image ink coverage: ${file}`, { file }));
       }
     }
     return results;
   }
 };
-registerCheck(check30);
+registerCheck(check31);
 
 // src/checks/asset/approved-fonts.ts
-var check31 = {
+var check32 = {
   id: "asset.font.approved-files",
   name: "Approved Font Files",
   description: "Checks font files against the approved file patterns",
@@ -7937,7 +8109,7 @@ var check31 = {
     for (const font of allFonts) {
       if (!approvedFonts.has(font)) {
         results.push({
-          checkId: check31.id,
+          checkId: check32.id,
           severity: "warning",
           message: "Font file not in approved list",
           file: font
@@ -7947,7 +8119,7 @@ var check31 = {
     return results;
   }
 };
-registerCheck(check31);
+registerCheck(check32);
 
 // src/checks/asset/font-license.ts
 import { existsSync as existsSync10 } from "node:fs";
@@ -7962,7 +8134,7 @@ var LICENSE_NAMES = [
   "OFL-1.1.txt",
   "COPYING"
 ];
-var check32 = {
+var check33 = {
   id: "asset.font.license",
   name: "Font License",
   description: "Checks for license files in font directories",
@@ -7989,7 +8161,7 @@ var check32 = {
       const hasLicense = LICENSE_NAMES.some((name) => existsSync10(resolve6(fontDir, name)));
       if (!hasLicense) {
         results.push({
-          checkId: check32.id,
+          checkId: check33.id,
           severity: "warning",
           message: `No font license file found in directory`,
           file: fontDir
@@ -7999,10 +8171,10 @@ var check32 = {
     return results;
   }
 };
-registerCheck(check32);
+registerCheck(check33);
 
 // src/checks/heuristic/text-density.ts
-var check33 = {
+var check34 = {
   id: "heuristic.whitespace.text-density",
   name: "Text Density",
   description: "Checks characters-per-page ratio",
@@ -8031,7 +8203,7 @@ var check33 = {
     });
     if (lowPages.length > 0) {
       results.push({
-        checkId: check33.id,
+        checkId: check34.id,
         severity: "info",
         message: `Low text density on pages: ${lowPages.join(", ")} (below ${range.min} chars)`,
         file: ctx.pdfPath
@@ -8039,7 +8211,7 @@ var check33 = {
     }
     if (highPages.length > 0) {
       results.push({
-        checkId: check33.id,
+        checkId: check34.id,
         severity: "info",
         message: `High text density on pages: ${highPages.join(", ")} (above ${range.max} chars)`,
         file: ctx.pdfPath
@@ -8048,11 +8220,11 @@ var check33 = {
     return results;
   }
 };
-registerCheck(check33);
+registerCheck(check34);
 
 // src/checks/heuristic/section-density.ts
 import { readFile as readFile20 } from "node:fs/promises";
-var check34 = {
+var check35 = {
   id: "heuristic.chunking.section-density",
   name: "Section Density",
   description: "Checks heading/paragraph/callout density from source Markdown",
@@ -8078,7 +8250,7 @@ var check34 = {
           const line = lines[i];
           if (/^#{1,6}\s/.test(line)) {
             if (paragraphCount > maxParas) {
-              results.push(finding(check34.id, {
+              results.push(finding(check35.id, {
                 severity: "info",
                 message: `Section has ${paragraphCount} paragraphs (max recommended: ${maxParas})`,
                 file,
@@ -8098,7 +8270,7 @@ var check34 = {
           }
         }
         if (paragraphCount > maxParas) {
-          results.push(finding(check34.id, {
+          results.push(finding(check35.id, {
             severity: "info",
             message: `Section has ${paragraphCount} paragraphs (max recommended: ${maxParas})`,
             file,
@@ -8106,7 +8278,7 @@ var check34 = {
           }));
         }
       } catch {
-        results.push(inspectionFailed(check34.id, `Could not read source file: ${file}`, {
+        results.push(inspectionFailed(check35.id, `Could not read source file: ${file}`, {
           file
         }));
       }
@@ -8114,10 +8286,10 @@ var check34 = {
     return results;
   }
 };
-registerCheck(check34);
+registerCheck(check35);
 
 // src/checks/heuristic/layer-count.ts
-var check35 = {
+var check36 = {
   id: "heuristic.decoration.layer-count",
   name: "Layer Count",
   description: "Counts image objects per page",
@@ -8142,7 +8314,7 @@ var check35 = {
       heavyPages.sort((a, b) => a - b);
       return [
         {
-          checkId: check35.id,
+          checkId: check36.id,
           severity: "info",
           message: `Pages with many image layers (>${maxLayers}): ${heavyPages.join(", ")}`,
           file: ctx.pdfPath
@@ -8152,10 +8324,10 @@ var check35 = {
     return [];
   }
 };
-registerCheck(check35);
+registerCheck(check36);
 
 // src/checks/heuristic/placement-variance.ts
-var check36 = {
+var check37 = {
   id: "heuristic.layout.placement-variance",
   name: "Placement Variance",
   description: "Analyzes text baseline coordinates for layout consistency",
@@ -8173,7 +8345,7 @@ var check36 = {
     const uniqueX = new Set(positions.map((p) => Math.round(p.x)));
     return [
       {
-        checkId: check36.id,
+        checkId: check37.id,
         severity: "info",
         message: `Layout analysis: ${uniqueX.size} unique horizontal text positions across ${positions.length} text blocks.`,
         file: ctx.pdfPath
@@ -8181,21 +8353,21 @@ var check36 = {
     ];
   }
 };
-registerCheck(check36);
+registerCheck(check37);
 
 // 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 check38 of checks2) {
+    if (!check38.requiredTools?.length)
       continue;
-    for (const tool of check37.requiredTools) {
+    for (const tool of check38.requiredTools) {
       const existing = toolToChecks.get(tool);
       if (existing) {
-        existing.push(check37.id);
+        existing.push(check38.id);
       } else {
-        toolToChecks.set(tool, [check37.id]);
+        toolToChecks.set(tool, [check38.id]);
       }
     }
   }
@@ -8211,11 +8383,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 check38 of checks2) {
+    if (!check38.requiredTools?.length)
       continue;
-    if (check37.requiredTools.some((t) => missingSet.has(t))) {
-      skippedChecks.push(check37.id);
+    if (check38.requiredTools.some((t) => missingSet.has(t))) {
+      skippedChecks.push(check38.id);
     }
   }
   return { available, missing, skippedChecks, toolToChecks };
@@ -8333,7 +8505,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>
@@ -8574,25 +8747,32 @@ async function runChecks(ctx, opts = {}) {
   }
   const release = retainPdfCache();
   try {
-    for (const check37 of checks2) {
+    for (const check38 of checks2) {
       try {
-        const results = await check37.run(ctx);
-        const severityOverride = getCheckSeverityOverride(check37.id, ctx.config);
+        let results = await check38.run(ctx);
+        const severityOverride = getCheckSeverityOverride(check38.id, ctx.config);
         if (severityOverride) {
           for (const r of results) {
             r.severity = severityOverride;
           }
         }
+        const lintLevel = ruleLevel(ctx.config.lint.rules, check38.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(check38.id);
         } else {
           allResults.push(...results);
         }
       } catch (err) {
         allResults.push({
-          checkId: check37.id,
+          checkId: check38.id,
           severity: "error",
-          message: `Check "${check37.id}" threw: ${err instanceof Error ? err.message : String(err)}`
+          message: `Check "${check38.id}" threw: ${err instanceof Error ? err.message : String(err)}`
         });
       }
     }
@@ -8884,7 +9064,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((check38) => check38.id === MARKDOWNLINT_CHECK_ID)) {
       await applyMarkdownlintFixes(context);
     } else {
       log.warn(`--fix: ${MARKDOWNLINT_CHECK_ID} is not part of this run — no files were fixed.`);
@@ -9121,7 +9301,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
     },
@@ -9208,13 +9389,64 @@ function* tokenize(s) {
     }
   }
 }
-function rewriteBlackText(src) {
+var LARGE_TEXT_PT = 24;
+var SIZE_EPS = 0.05;
+var area = (m) => Math.sqrt(Math.abs(m[0] * m[3] - m[1] * m[2]));
+
+class TextScale {
+  ctm;
+  font = 0;
+  tm = 1;
+  stack = [];
+  constructor(ctm) {
+    this.ctm = ctm;
+  }
+  get unit() {
+    return this.ctm;
+  }
+  get size() {
+    return this.font * this.tm * this.ctm;
+  }
+  op(op, nums) {
+    switch (op) {
+      case "q":
+        this.stack.push([this.ctm, this.font]);
+        return false;
+      case "Q": {
+        const p = this.stack.pop();
+        if (p)
+          [this.ctm, this.font] = p;
+        return true;
+      }
+      case "cm":
+        if (nums.length === 6)
+          this.ctm *= area(nums);
+        return true;
+      case "BT":
+        this.tm = 1;
+        return true;
+      case "Tm":
+        if (nums.length === 6)
+          this.tm = area(nums);
+        return true;
+      case "Tf":
+        this.font = Math.abs(nums[nums.length - 1] ?? 0) || 0;
+        return true;
+    }
+    return false;
+  }
+}
+function rewriteBlackText(src, ctx = {}) {
   let fill = null;
   let stroke = null;
   const stack = [];
+  const scale = new TextScale(ctx.baseScale ?? 1);
   let inText = false;
   let fillDirty = false;
   let strokeDirty = false;
+  const spans = [];
+  let lastOp = "";
+  let rect = null;
   const edits = [];
   let operands = [];
   const rgbOf = () => {
@@ -9223,12 +9455,46 @@ function rewriteBlackText(src) {
     const v = operands.map((t) => Number(t.text));
     return v.some((x) => Number.isNaN(x)) ? null : { rgb: v, raw: operands.map((t) => t.text).join(" ") };
   };
+  const isSmall = () => scale.size <= LARGE_TEXT_PT + SIZE_EPS;
+  let fillIns = null;
+  let strokeIns = null;
+  const syncOne = (colour, dirty, ins, at, gray, op) => {
+    if (!colour || !isNearBlack(colour.rgb))
+      return [dirty, ins];
+    const small = isSmall();
+    if (small && !dirty) {
+      const e = { start: at, end: at, text: ` ${gray}` };
+      edits.push(e);
+      return [true, e];
+    }
+    if (!small && dirty) {
+      if (ins)
+        ins.text = "";
+      else
+        edits.push({ start: at, end: at, text: ` ${colour.raw} ${op}` });
+      return [false, null];
+    }
+    return [dirty, ins];
+  };
+  const sync = (at) => {
+    [fillDirty, fillIns] = syncOne(fill, fillDirty, fillIns, at, "0 g", "rg");
+    [strokeDirty, strokeIns] = syncOne(stroke, strokeDirty, strokeIns, at, "0 G", "RG");
+  };
+  const flush = (s) => {
+    for (const r of s.rects) {
+      if (r.thickness > 0.2 * s.maxSmall)
+        continue;
+      edits.push({ start: r.start, end: r.start, text: "q 0 g " }, { start: r.end, end: r.end, text: " Q" });
+    }
+  };
   for (const t of tokenize(src)) {
     if (!t.op) {
       operands.push(t);
       continue;
     }
     const op = t.text;
+    const nums = operands.map((o) => Number(o.text));
+    const sizeMayHaveChanged = scale.op(op, nums);
     switch (op) {
       case "q":
         stack.push([fill, stroke]);
@@ -9242,19 +9508,13 @@ function rewriteBlackText(src) {
       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 });
-        }
+        fillIns = strokeIns = null;
+        sync(t.end);
+        break;
+      case "Tf":
+      case "Tm":
+        if (inText && sizeMayHaveChanged)
+          sync(t.end);
         break;
       case "ET":
         if (inText) {
@@ -9267,6 +9527,7 @@ function rewriteBlackText(src) {
             edits.push({ start: t.start, end: t.start, text: ins });
         }
         inText = false;
+        fillIns = strokeIns = null;
         break;
       case "rg":
       case "RG": {
@@ -9276,7 +9537,7 @@ function rewriteBlackText(src) {
           fill = c;
         else
           stroke = c;
-        if (inText && c && isNearBlack(c.rgb)) {
+        if (inText && c && isNearBlack(c.rgb) && isSmall()) {
           edits.push({ start: operands[0].start, end: t.end, text: isFill ? "0 g" : "0 G" });
           if (isFill)
             fillDirty = true;
@@ -9308,7 +9569,54 @@ function rewriteBlackText(src) {
         if (inText)
           strokeDirty = false;
         break;
+      case "Do": {
+        const name = operands[operands.length - 1]?.text;
+        if (name?.startsWith("/"))
+          ctx.onDo?.(name.slice(1), scale.unit);
+        break;
+      }
+      case "BDC":
+      case "BMC":
+        spans.push({ hasSmall: false, maxSmall: 0, rects: [] });
+        break;
+      case "EMC": {
+        const s = spans.pop();
+        if (!s)
+          break;
+        const parent = spans[spans.length - 1];
+        if (s.hasSmall)
+          flush(s);
+        else
+          parent?.rects.push(...s.rects);
+        if (parent && s.hasSmall) {
+          parent.hasSmall = true;
+          parent.maxSmall = Math.max(parent.maxSmall, s.maxSmall);
+        }
+        break;
+      }
+      case "Tj":
+      case "TJ":
+      case "'":
+      case '"': {
+        fillIns = strokeIns = null;
+        const span = spans[spans.length - 1];
+        if (span && inText && isSmall()) {
+          span.hasSmall = true;
+          span.maxSmall = Math.max(span.maxSmall, scale.size);
+        }
+        break;
+      }
+      case "re":
+        rect = !inText && fill && isNearBlack(fill.rgb) && operands.length === 4 && nums.every((x) => !Number.isNaN(x)) ? { start: operands[0].start, thickness: Math.min(Math.abs(nums[2]), Math.abs(nums[3])) * scale.unit } : null;
+        break;
+      case "f":
+      case "F":
+      case "f*":
+        if (rect && lastOp === "re")
+          spans[spans.length - 1]?.rects.push({ ...rect, end: t.end });
+        break;
     }
+    lastOp = op;
     operands = [];
   }
   return applyEdits(src, edits);
@@ -9316,6 +9624,7 @@ function rewriteBlackText(src) {
 function applyEdits(s, edits) {
   if (!edits.length)
     return s;
+  edits.sort((a, b) => a.start - b.start);
   let out = "";
   let pos = 0;
   for (const e of edits) {
@@ -9324,9 +9633,8 @@ function applyEdits(s, edits) {
   }
   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 });
+async function visitContent(doc, visit) {
+  const { PDFName, PDFRawStream, PDFArray, PDFRef, PDFDict, decodePDFRawStream } = await import("pdf-lib");
   const ctx = doc.context;
   const SKIP = ["Filter", "DecodeParms", "Length"].map((k) => PDFName.of(k));
   let changed = false;
@@ -9345,19 +9653,15 @@ async function blackTextToGray(pdf) {
     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 formScale = new Map;
+  const formMatrixScale = (form) => {
+    const m = form.dict.lookupMaybe(PDFName.of("Matrix"), PDFArray);
+    const nums = m?.asArray().map((n) => Number(n.toString()));
+    return nums?.length === 6 && !nums.some(Number.isNaN) ? area(nums) : 1;
+  };
+  const pages = doc.getPages();
+  for (let p = 0;p < pages.length; p++) {
+    const page = pages[p];
     const contents = page.node.Contents();
     const refs = [];
     if (contents instanceof PDFArray) {
@@ -9375,16 +9679,49 @@ async function blackTextToGray(pdf) {
     if (!refs.length || !streams.every((s) => s instanceof PDFRawStream))
       continue;
     const parts = streams.map((s) => decode(s));
-    if (parts.some((p) => p === null))
+    if (parts.some((q) => q === null))
       continue;
     const joined = parts.join(`
 `);
-    const next = rewriteBlackText(joined);
+    const xobjects = page.node.Resources()?.lookupMaybe(PDFName.of("XObject"), PDFDict);
+    const next = visit(joined, {
+      baseScale: 1,
+      onDo: (name, scale) => {
+        const ref = xobjects?.get(PDFName.of(name));
+        const form = ref instanceof PDFRef ? ctx.lookup(ref) : undefined;
+        if (!(ref instanceof PDFRef) || !(form instanceof PDFRawStream))
+          return;
+        if (form.dict.get(PDFName.of("Subtype")) !== PDFName.of("Form"))
+          return;
+        const at = scale * formMatrixScale(form);
+        formScale.set(ref.tag, Math.min(formScale.get(ref.tag) ?? Infinity, at));
+      }
+    });
     if (next === joined)
       continue;
     replace(refs[0], streams[0], next);
     page.node.set(PDFName.of("Contents"), refs[0]);
   }
+  for (const [ref, obj] of ctx.enumerateIndirectObjects()) {
+    if (!(obj instanceof PDFRawStream))
+      continue;
+    if (obj.dict.get(PDFName.of("Subtype")) !== PDFName.of("Form"))
+      continue;
+    const text = decode(obj);
+    if (text === null)
+      continue;
+    const next = visit(text, {
+      baseScale: formScale.get(ref.tag) ?? 0
+    });
+    if (next !== text)
+      replace(ref, obj, next);
+  }
+  return changed;
+}
+async function blackTextToGray(pdf) {
+  const { PDFDocument } = await import("pdf-lib");
+  const doc = await PDFDocument.load(pdf, { updateMetadata: false });
+  const changed = await visitContent(doc, (src, info2) => rewriteBlackText(src, info2));
   return changed ? doc.save({ updateFieldAppearances: false }) : pdf;
 }
 
@@ -9662,7 +9999,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 +10020,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-rhmwgk9k.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 +10084,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 {
@@ -10903,6 +11242,26 @@ async function startPreviewServer(options) {
 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 { 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 +11290,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 +11393,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);
@@ -13562,13 +13910,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,21 +14012,21 @@ 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 path26 from "node:path";