gutterpress 0.11.14 → 0.11.15-alpha.2

package/dist/api/index.js

@@ -129,10 +129,10 @@ import {
   testRemoteAccess,
   updateExtensions,
   validateProjectExtensions
-} from "../index-nm81wpfb.js";
+} from "../index-j77039xr.js";
 import {
   BuildError
-} from "../index-mw8b25yx.js";
+} from "../index-w6tqhafk.js";
 import {
   DEFAULT_PRINT_OPTS,
   assertMilestone,

package/dist/{build-czwbmbsb.js → build-4522yqmm.js}

@@ -1,18 +1,18 @@
 import {
   runBuild,
   splitOutPath
-} from "./cli-vgjtz2e6.js";
+} from "./cli-7pw53gnm.js";
 import {
   log
-} from "./cli-7z0j8sqj.js";
+} from "./cli-b496rxy0.js";
 import {
   UsageError,
   parseFormat,
   parsePdfxFlavor,
   rejectExtraPositionals,
   rejectUnknownFlags
-} from "./cli-1723rkd1.js";
-import"./cli-tjhn2mdn.js";
+} from "./cli-vdpnctkq.js";
+import"./cli-mc3waxaw.js";
 import {
   BuildError
 } from "./cli-46ycxe6r.js";

package/dist/{cli-vgjtz2e6.js → cli-7pw53gnm.js}

@@ -13,17 +13,17 @@ import {
   stampCreator,
   stripAnnotations,
   warn
-} from "./cli-7z0j8sqj.js";
+} from "./cli-b496rxy0.js";
 import {
   DEBOUNCE,
   UsageError,
   resolvePort
-} from "./cli-1723rkd1.js";
+} from "./cli-vdpnctkq.js";
 import {
   MARGIN_BOX_IGNORED_PROPERTIES,
   getAssetPath,
   getAssetsDir
-} from "./cli-tjhn2mdn.js";
+} from "./cli-mc3waxaw.js";
 import {
   BuildError
 } from "./cli-46ycxe6r.js";
@@ -105,11 +105,12 @@ var DTRPG_PRESET = {
   source: {
     files: null
   },
-  print: { signature: 1 },
+  print: { signature: 4, reserveLastPage: true },
   pdfx: {
     flavor: "x1a",
     icc: "profiles/CGATS21_CRPC1.icc",
-    stripAnnotations: true
+    stripAnnotations: true,
+    blackText: "k-only"
   },
   page: {
     width: 621,
@@ -179,11 +180,12 @@ var BOOK_PRESET = {
   source: {
     files: null
   },
-  print: { signature: 1 },
+  print: { signature: 1, reserveLastPage: false },
   pdfx: {
     flavor: "x1a",
     icc: "profiles/CGATS21_CRPC1.icc",
-    stripAnnotations: true
+    stripAnnotations: true,
+    blackText: "icc"
   },
   page: {
     width: 432,
@@ -7436,6 +7438,261 @@ 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,
@@ -7728,11 +7985,12 @@ class PdfOutput {
       const rawPdf = pdfxMode ? path8.join(stage, "raw.pdf") : path8.resolve(pdfFile);
       await fsp2.mkdir(path8.dirname(path8.resolve(pdfFile)), { recursive: true });
       log.info("Rendering HTML to PDF via the Gutterpress engine (native Chromium pagination)");
-      const { buildNativePdf } = await import("./engine-132czsq9.js");
+      const { buildNativePdf } = await import("./engine-h8zdtxhp.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,
         allowShrink: opts.allowShrink
       }, browser);
       for (const d of engineDiagnostics)
@@ -7758,6 +8016,10 @@ class PdfOutput {
           log.info("Stripping annotations for PDF/X compliance");
           await stripAnnotations(rawPdf, stage);
         }
+        if (config.pdfx.blackText === "k-only") {
+          log.info("Rewriting near-black text to K-only gray");
+          await fsp2.writeFile(rawPdf, await blackTextToGray(await fsp2.readFile(rawPdf)));
+        }
         log.info(`Converting to CMYK PDF/X (${pdfxMode})`);
         await convertToPdfxCmyk(rawPdf, path8.resolve(pdfFile), {
           iccPath: effectiveIccPath,

package/dist/{cli-7z0j8sqj.js → cli-b496rxy0.js}

@@ -1,6 +1,6 @@
 import {
   package_default
-} from "./cli-1723rkd1.js";
+} from "./cli-vdpnctkq.js";
 import {
   execCapture,
   findTool,

package/dist/{cli-tjhn2mdn.js → cli-mc3waxaw.js}

@@ -1106,7 +1106,7 @@ import { fileURLToPath } from "node:url";
 var favicon_default = "./favicon-wkbm9cjn.ico";
 
 // src/assets/manifest.schema.json
-var manifest_schema_default = "./manifest.schema-61bsspsb.json";
+var manifest_schema_default = "./manifest.schema-40sfq49z.json";
 
 // src/assets/preview/scripts/preview-interface.js
 var preview_interface_default = "./preview-interface-twd6nsf5.js";
@@ -1450,15 +1450,12 @@ async function postprocess(input, opts) {
     g.media.width - inset,
     g.media.height - inset
   ];
-  let padded = 0;
-  if (opts.signature && opts.signature > 1) {
-    const remainder = doc.getPageCount() % opts.signature;
-    if (remainder !== 0) {
-      padded = opts.signature - remainder;
-      for (let i = 0;i < padded; i++)
-        doc.addPage([g.media.width, g.media.height]);
-    }
-  }
+  const signature = opts.signature && opts.signature > 1 ? opts.signature : 1;
+  let padded = (signature - doc.getPageCount() % signature) % signature;
+  if (padded === 0 && opts.reserveLastPage)
+    padded = signature;
+  for (let i = 0;i < padded; i++)
+    doc.addPage([g.media.width, g.media.height]);
   const wantMarks = opts.marks || g.marks.includes("crop") || g.marks.includes("cross");
   for (const page of doc.getPages()) {
     const node = page.node;
@@ -2233,11 +2230,12 @@ ${mapCss}`;
     const post = await postprocess(bytes, {
       geometry: tier2.geometry,
       signature: opts.signature,
+      reserveLastPage: opts.reserveLastPage,
       marks: opts.marks,
       title: opts.title,
       author: opts.author
     });
-    log(`postprocess: ${post.pageCount} pages` + (post.padded ? ` (+${post.padded} signature pad)` : ""));
+    log(`postprocess: ${post.pageCount} pages` + (post.padded ? ` (+${post.padded} blank${opts.reserveLastPage ? "; last page reserved blank" : ""})` : ""));
     return {
       bytes: post.bytes,
       tier,

package/dist/{cli-1723rkd1.js → cli-vdpnctkq.js}

@@ -4,7 +4,7 @@ import {
 // package.json
 var package_default = {
   name: "gutterpress",
-  version: "0.11.14",
+  version: "0.11.15-alpha.2",
   description: "Markdown-to-PDF converter for professional print layout using a native Chromium print engine and Ghostscript.",
   author: "itlackey",
   license: "MPL-2.0",

package/dist/cli.js

@@ -6,7 +6,7 @@ import {
   UsageError,
   package_default,
   rejectUnknownFlags
-} from "./cli-1723rkd1.js";
+} from "./cli-vdpnctkq.js";
 import {
   EXIT_CODES
 } from "./cli-46ycxe6r.js";
@@ -18,14 +18,14 @@ import {
 import { defineCommand, parseArgs, runMain } from "citty";
 import { statSync } from "node:fs";
 var SUBCOMMANDS = {
-  new: () => import("./new-y5kn67a5.js").then((m) => m.default),
-  preview: () => import("./preview-mk98eva0.js").then((m) => m.default),
-  build: () => import("./build-czwbmbsb.js").then((m) => m.default),
-  publish: () => import("./publish-q7zpx8yq.js").then((m) => m.default),
-  validate: () => import("./validate-scqwwwx5.js").then((m) => m.default),
-  preflight: () => import("./preflight-aj2cps9w.js").then((m) => m.default),
-  doctor: () => import("./doctor-ej9e88dc.js").then((m) => m.default),
-  ext: () => import("./ext-47cs7bp8.js").then((m) => m.default)
+  new: () => import("./new-7npm260n.js").then((m) => m.default),
+  preview: () => import("./preview-xkp190pd.js").then((m) => m.default),
+  build: () => import("./build-4522yqmm.js").then((m) => m.default),
+  publish: () => import("./publish-czx47htf.js").then((m) => m.default),
+  validate: () => import("./validate-x89z3zrq.js").then((m) => m.default),
+  preflight: () => import("./preflight-y0jhsz8p.js").then((m) => m.default),
+  doctor: () => import("./doctor-fgvwe9j2.js").then((m) => m.default),
+  ext: () => import("./ext-v44phkxz.js").then((m) => m.default)
 };
 var VERSION = package_default.version;
 var main = defineCommand({
@@ -50,7 +50,7 @@ async function preflightRequiredInvocations(rawArgs) {
   const [command, ...commandArgs] = rawArgs;
   try {
     if (command === "new") {
-      const { newArgs } = await import("./new-y5kn67a5.js");
+      const { newArgs } = await import("./new-7npm260n.js");
       rejectUnknownFlags(commandArgs, newArgs, "new");
       const parsed = parseArgs(commandArgs, {
         ...newArgs,
@@ -62,7 +62,7 @@ async function preflightRequiredInvocations(rawArgs) {
       return;
     }
     if (command === "preflight") {
-      const { preflightArgs } = await import("./preflight-aj2cps9w.js");
+      const { preflightArgs } = await import("./preflight-y0jhsz8p.js");
       rejectUnknownFlags(commandArgs, preflightArgs, "preflight");
       const parsed = parseArgs(commandArgs, {
         ...preflightArgs,
@@ -82,7 +82,7 @@ async function preflightRequiredInvocations(rawArgs) {
       }
       if (subcommand.startsWith("-"))
         return;
-      const { EXT_SUBCOMMANDS, extAddArgs, extRemoveArgs, extEnableArgs, extDisableArgs } = await import("./ext-47cs7bp8.js");
+      const { EXT_SUBCOMMANDS, extAddArgs, extRemoveArgs, extEnableArgs, extDisableArgs } = await import("./ext-v44phkxz.js");
       if (!EXT_SUBCOMMANDS.includes(subcommand)) {
         throw new UsageError(`gutterpress ext: unknown command "${subcommand}"`);
       }

package/dist/{doctor-ej9e88dc.js → doctor-fgvwe9j2.js}

@@ -1,12 +1,12 @@
 import {
   getSystemDiagnostics,
   log
-} from "./cli-7z0j8sqj.js";
+} from "./cli-b496rxy0.js";
 import {
   UsageError,
   rejectExtraPositionals,
   rejectUnknownFlags
-} from "./cli-1723rkd1.js";
+} from "./cli-vdpnctkq.js";
 import"./cli-46ycxe6r.js";
 import"./cli-7fkhgtfn.js";
 import"./cli-37x76zdn.js";

package/dist/engine/compiler/build.d.ts

@@ -19,6 +19,8 @@ export interface BuildOptions {
     input: string;
     output?: string;
     signature?: number;
+    /** guarantee the final page is a blank page added by postprocess */
+    reserveLastPage?: boolean;
     marks?: boolean;
     slugPt?: number;
     bleedPt?: number;

package/dist/engine/compiler/postprocess.d.ts

@@ -3,6 +3,12 @@ export interface PostprocessOptions {
     geometry: PageTrim;
     /** append blank pages until pageCount % signature === 0 */
     signature?: number;
+    /**
+     * Guarantee the last page is a blank page added here. If signature padding
+     * would add nothing, append one full signature of blank pages (one page when
+     * signature <= 1).
+     */
+    reserveLastPage?: boolean;
     title?: string;
     author?: string;
     subject?: string;

package/dist/{engine-132czsq9.js → engine-h8zdtxhp.js}

@@ -1,6 +1,6 @@
 import {
   build
-} from "./cli-tjhn2mdn.js";
+} from "./cli-mc3waxaw.js";
 import {
   BuildError
 } from "./cli-46ycxe6r.js";

package/dist/{engine-bgd4aa99.js → engine-s18wy689.js}

@@ -1,9 +1,9 @@
 import {
   build
-} from "./index-b6p1fh61.js";
+} from "./index-ypxhxvwv.js";
 import {
   BuildError
-} from "./index-mw8b25yx.js";
+} from "./index-w6tqhafk.js";
 import"./index-rzm1phg0.js";
 import"./index-37x76zdn.js";
 

package/dist/{ext-47cs7bp8.js → ext-v44phkxz.js}

@@ -12,16 +12,16 @@ import {
   searchNpmExtensions,
   setExtensionEnabled,
   updateExtensions
-} from "./cli-vgjtz2e6.js";
-import"./cli-7z0j8sqj.js";
+} from "./cli-7pw53gnm.js";
+import"./cli-b496rxy0.js";
 import {
   UsageError,
   exitForUsage,
   rejectExtraPositionals,
   rejectUnknownFlags,
   resolveProjectDir
-} from "./cli-1723rkd1.js";
-import"./cli-tjhn2mdn.js";
+} from "./cli-vdpnctkq.js";
+import"./cli-mc3waxaw.js";
 import {
   EXIT_CODES
 } from "./cli-46ycxe6r.js";

package/dist/{index-nm81wpfb.js → index-j77039xr.js}

@@ -4,7 +4,7 @@ import {
   MARGIN_BOX_IGNORED_PROPERTIES,
   getAssetPath,
   getAssetsDir
-} from "./index-mw8b25yx.js";
+} from "./index-w6tqhafk.js";
 import {
   INSTALL_HINTS,
   execCapture,
@@ -140,11 +140,12 @@ var DTRPG_PRESET = {
   source: {
     files: null
   },
-  print: { signature: 1 },
+  print: { signature: 4, reserveLastPage: true },
   pdfx: {
     flavor: "x1a",
     icc: "profiles/CGATS21_CRPC1.icc",
-    stripAnnotations: true
+    stripAnnotations: true,
+    blackText: "k-only"
   },
   page: {
     width: 621,
@@ -214,11 +215,12 @@ var BOOK_PRESET = {
   source: {
     files: null
   },
-  print: { signature: 1 },
+  print: { signature: 1, reserveLastPage: false },
   pdfx: {
     flavor: "x1a",
     icc: "profiles/CGATS21_CRPC1.icc",
-    stripAnnotations: true
+    stripAnnotations: true,
+    blackText: "icc"
   },
   page: {
     width: 432,
@@ -3858,7 +3860,7 @@ import git from "isomorphic-git";
 // package.json
 var package_default = {
   name: "gutterpress",
-  version: "0.11.14",
+  version: "0.11.15-alpha.2",
   description: "Markdown-to-PDF converter for professional print layout using a native Chromium print engine and Ghostscript.",
   author: "itlackey",
   license: "MPL-2.0",
@@ -4123,6 +4125,261 @@ 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/validation-exec.ts
 import { existsSync as existsSync10 } from "node:fs";
 import { dirname as dirname4, join as join4, resolve as resolve8 } from "node:path";
@@ -8218,11 +8475,12 @@ class PdfOutput {
       const rawPdf = pdfxMode ? path8.join(stage, "raw.pdf") : path8.resolve(pdfFile);
       await fsp2.mkdir(path8.dirname(path8.resolve(pdfFile)), { recursive: true });
       log.info("Rendering HTML to PDF via the Gutterpress engine (native Chromium pagination)");
-      const { buildNativePdf } = await import("./engine-bgd4aa99.js");
+      const { buildNativePdf } = await import("./engine-s18wy689.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,
         allowShrink: opts.allowShrink
       }, browser);
       for (const d of engineDiagnostics)
@@ -8248,6 +8506,10 @@ class PdfOutput {
           log.info("Stripping annotations for PDF/X compliance");
           await stripAnnotations(rawPdf, stage);
         }
+        if (config.pdfx.blackText === "k-only") {
+          log.info("Rewriting near-black text to K-only gray");
+          await fsp2.writeFile(rawPdf, await blackTextToGray(await fsp2.readFile(rawPdf)));
+        }
         log.info(`Converting to CMYK PDF/X (${pdfxMode})`);
         await convertToPdfxCmyk(rawPdf, path8.resolve(pdfFile), {
           iccPath: effectiveIccPath,

package/dist/{index-mw8b25yx.js → index-w6tqhafk.js}

@@ -26,7 +26,7 @@ import { fileURLToPath } from "node:url";
 var favicon_default = "./favicon-wkbm9cjn.ico";
 
 // src/assets/manifest.schema.json
-var manifest_schema_default = "./manifest.schema-61bsspsb.json";
+var manifest_schema_default = "./manifest.schema-40sfq49z.json";
 
 // src/assets/preview/scripts/preview-interface.js
 var preview_interface_default = "./preview-interface-twd6nsf5.js";

package/dist/{index-b6p1fh61.js → index-ypxhxvwv.js}

@@ -3,7 +3,7 @@ import {
   isIgnoredMarginBoxProperty,
   marginBoxAlign,
   marginBoxRectPt
-} from "./index-mw8b25yx.js";
+} from "./index-w6tqhafk.js";
 import {
   launchChromium
 } from "./index-rzm1phg0.js";
@@ -1207,15 +1207,12 @@ async function postprocess(input, opts) {
     g.media.width - inset,
     g.media.height - inset
   ];
-  let padded = 0;
-  if (opts.signature && opts.signature > 1) {
-    const remainder = doc.getPageCount() % opts.signature;
-    if (remainder !== 0) {
-      padded = opts.signature - remainder;
-      for (let i = 0;i < padded; i++)
-        doc.addPage([g.media.width, g.media.height]);
-    }
-  }
+  const signature = opts.signature && opts.signature > 1 ? opts.signature : 1;
+  let padded = (signature - doc.getPageCount() % signature) % signature;
+  if (padded === 0 && opts.reserveLastPage)
+    padded = signature;
+  for (let i = 0;i < padded; i++)
+    doc.addPage([g.media.width, g.media.height]);
   const wantMarks = opts.marks || g.marks.includes("crop") || g.marks.includes("cross");
   for (const page of doc.getPages()) {
     const node = page.node;
@@ -2002,11 +1999,12 @@ ${mapCss}`;
     const post = await postprocess(bytes, {
       geometry: tier2.geometry,
       signature: opts.signature,
+      reserveLastPage: opts.reserveLastPage,
       marks: opts.marks,
       title: opts.title,
       author: opts.author
     });
-    log(`postprocess: ${post.pageCount} pages` + (post.padded ? ` (+${post.padded} signature pad)` : ""));
+    log(`postprocess: ${post.pageCount} pages` + (post.padded ? ` (+${post.padded} blank${opts.reserveLastPage ? "; last page reserved blank" : ""})` : ""));
     return {
       bytes: post.bytes,
       tier,

package/dist/index.js

@@ -146,13 +146,13 @@ import {
   testRemoteAccess,
   updateExtensions,
   validateProjectExtensions
-} from "./index-nm81wpfb.js";
+} from "./index-j77039xr.js";
 import {
   BUILD_DIAGNOSTIC_CODES
-} from "./index-b6p1fh61.js";
+} from "./index-ypxhxvwv.js";
 import {
   BuildError
-} from "./index-mw8b25yx.js";
+} from "./index-w6tqhafk.js";
 import {
   DEFAULT_PRINT_OPTS,
   assertMilestone,

package/dist/lib/black-text-gray.d.ts

@@ -0,0 +1,40 @@
+/**
+ * K-only black text for PDF/X (#331).
+ *
+ * PRINT-SPEC GAP: print vendors (DriveThruRPG) require body text to print on
+ * the black plate alone (100% K). Chromium writes every text fill as
+ * DeviceRGB (`r g b rg`), and the Ghostscript pass in `convertToPdfxCmyk`
+ * sends all RGB through the output ICC, so `#000` text lands as four-colour
+ * rich black (~47/42/40/100). Ghostscript keeps DeviceGray as gray, which
+ * maps to K only — so before that pass, near-black RGB that paints TEXT is
+ * rewritten to DeviceGray black. Standard PDF operators in, standard PDF
+ * operators out; nothing here is engine-private.
+ *
+ * REMOVAL TRIGGER: Chromium emitting DeviceGray/DeviceCMYK for black text, or
+ * Ghostscript gaining a text-only RGB-black → K mapping (`-dBlackText` and
+ * `Text_RGB None` do not do this, measured).
+ *
+ * What Chromium emits (measured): colour is set with one `r g b RG r g b rg`
+ * line directly BEFORE a `BT` block and simply stays in effect afterwards, so
+ * the same colour also paints whatever follows `ET` (rules, text-decoration
+ * rectangles). Those non-text fills must keep their colour. So the rewrite is
+ * scoped to `BT`…`ET`: on entering a text object whose inherited fill/stroke
+ * is near-black RGB we emit `0 g`/`0 G`, and at `ET` we put the original RGB
+ * back. A near-black `rg`/`RG` set inside the block is rewritten the same way.
+ * Page content streams and Form XObjects are both processed; a Form's
+ * inherited (pre-`Do`) colour is unknowable from its own stream, so only
+ * colours set inside the form are considered.
+ *
+ * Known limit: text-decoration rectangles (underline/strike) are `re f` after
+ * `ET`, i.e. non-text painting, and stay rich black.
+ */
+/**
+ * Rewrite near-black RGB fill/stroke to DeviceGray black inside BT…ET of one
+ * content stream. Pure string → string; returns the input when nothing changed.
+ */
+export declare function rewriteBlackText(src: string): string;
+/**
+ * Apply {@link rewriteBlackText} to every page content stream and Form XObject
+ * of a PDF. Returns the input bytes untouched when nothing needed rewriting.
+ */
+export declare function blackTextToGray(pdf: Uint8Array): Promise<Uint8Array>;

package/dist/lib/engine.d.ts

@@ -6,6 +6,7 @@ export interface NativePdfOptions {
     title?: string;
     author?: string;
     signature?: number;
+    reserveLastPage?: boolean;
     /**
      * Downgrade the engine's over-wide-content hard error to a warning +
      * diagnostic. The engine's message tells the author to "pass allowShrink to

package/dist/{manifest.schema-61bsspsb.json → manifest.schema-40sfq49z.json}

@@ -148,6 +148,28 @@
           "type": "boolean",
           "description": "Strip annotations (links, comments) during PDF/X conversion — PDF/X-1a does not permit them.",
           "default": true
+        },
+        "blackText": {
+          "type": "string",
+          "description": "How near-black text is separated. `icc` converts it through the ICC profile (rich, four-colour black). `k-only` prints it on the black plate alone (100% K), which print vendors such as DriveThruRPG require for small text. Non-text black (rules, panels) is unaffected. Preset defaults: dtrpg `k-only`, book `icc`.",
+          "enum": ["icc", "k-only"],
+          "default": "icc"
+        }
+      }
+    },
+    "print": {
+      "type": "object",
+      "description": "Page-count rules applied when the PDF is built.",
+      "properties": {
+        "signature": {
+          "type": "integer",
+          "description": "Pad the PDF with blank pages until the page count is a multiple of this. `1` means no padding. Preset defaults: dtrpg 4, book 1.",
+          "minimum": 1,
+          "examples": [1, 4, 6]
+        },
+        "reserveLastPage": {
+          "type": "boolean",
+          "description": "Guarantee the final page is a blank page added by the build (no background, no page number). When the content already fills a signature exactly, a full signature of blank pages is added. DriveThruRPG reserves the last page for printer information. Preset defaults: dtrpg true, book false."
         }
       }
     },

package/dist/{new-y5kn67a5.js → new-7npm260n.js}

@@ -7,16 +7,16 @@ import {
   TARGET_IDS,
   scaffoldExtension,
   scaffoldProject
-} from "./cli-vgjtz2e6.js";
+} from "./cli-7pw53gnm.js";
 import {
   resolveGhostscript
-} from "./cli-7z0j8sqj.js";
+} from "./cli-b496rxy0.js";
 import {
   UsageError,
   rejectExtraPositionals,
   rejectUnknownFlags
-} from "./cli-1723rkd1.js";
-import"./cli-tjhn2mdn.js";
+} from "./cli-vdpnctkq.js";
+import"./cli-mc3waxaw.js";
 import {
   EXIT_CODES
 } from "./cli-46ycxe6r.js";

package/dist/{preflight-aj2cps9w.js → preflight-y0jhsz8p.js}

@@ -2,16 +2,16 @@ import {
   executeValidation,
   publishTargetFor,
   reportMissingTools
-} from "./cli-vgjtz2e6.js";
+} from "./cli-7pw53gnm.js";
 import {
   log
-} from "./cli-7z0j8sqj.js";
+} from "./cli-b496rxy0.js";
 import {
   UsageError,
   rejectExtraPositionals,
   rejectUnknownFlags
-} from "./cli-1723rkd1.js";
-import"./cli-tjhn2mdn.js";
+} from "./cli-vdpnctkq.js";
+import"./cli-mc3waxaw.js";
 import {
   EXIT_CODES
 } from "./cli-46ycxe6r.js";

package/dist/{preview-mk98eva0.js → preview-xkp190pd.js}

@@ -6,10 +6,10 @@ import {
   runBuild,
   splitOutPath,
   startPreviewServer
-} from "./cli-vgjtz2e6.js";
+} from "./cli-7pw53gnm.js";
 import {
   log
-} from "./cli-7z0j8sqj.js";
+} from "./cli-b496rxy0.js";
 import {
   UsageError,
   parseFormat,
@@ -17,8 +17,8 @@ import {
   rejectExtraPositionals,
   rejectUnknownFlags,
   resolvePort
-} from "./cli-1723rkd1.js";
-import"./cli-tjhn2mdn.js";
+} from "./cli-vdpnctkq.js";
+import"./cli-mc3waxaw.js";
 import {
   BuildError
 } from "./cli-46ycxe6r.js";

package/dist/{publish-q7zpx8yq.js → publish-czx47htf.js}

@@ -11,17 +11,17 @@ import {
   publishProviderFor,
   resolvePublishFormat,
   runPublish
-} from "./cli-vgjtz2e6.js";
+} from "./cli-7pw53gnm.js";
 import {
   FileTokenStore,
   log
-} from "./cli-7z0j8sqj.js";
+} from "./cli-b496rxy0.js";
 import {
   UsageError,
   rejectExtraPositionals,
   rejectUnknownFlags
-} from "./cli-1723rkd1.js";
-import"./cli-tjhn2mdn.js";
+} from "./cli-vdpnctkq.js";
+import"./cli-mc3waxaw.js";
 import {
   EXIT_CODES
 } from "./cli-46ycxe6r.js";

package/dist/schema/manifest.types.d.ts

@@ -115,6 +115,8 @@ export interface GutterpressManifest {
         flavor?: "x1a" | "x3";
         icc?: string;
         stripAnnotations?: boolean;
+        /** `k-only` prints near-black text on the black plate alone (#331). */
+        blackText?: "icc" | "k-only";
     };
     /**
      * Native-engine print-production options with no other manifest home
@@ -124,6 +126,12 @@ export interface GutterpressManifest {
     print?: {
         /** Pad the PDF with blank pages until pageCount is a multiple of this. */
         signature?: number;
+        /**
+         * Guarantee the interior's final page is a blank page appended by the
+         * build (no content, no folio). Print-on-demand services such as
+         * DriveThruRPG reserve the last page for printer info.
+         */
+        reserveLastPage?: boolean;
     };
     page?: {
         width?: number;
@@ -227,9 +235,11 @@ export interface ResolvedConfig {
         flavor: "x1a" | "x3";
         icc: string;
         stripAnnotations: boolean;
+        blackText: "icc" | "k-only";
     };
     print: {
         signature: number;
+        reserveLastPage: boolean;
     };
     page: {
         width: number;

package/dist/{validate-scqwwwx5.js → validate-x89z3zrq.js}

@@ -1,15 +1,15 @@
 import {
   executeAndReport
-} from "./cli-vgjtz2e6.js";
+} from "./cli-7pw53gnm.js";
 import {
   log
-} from "./cli-7z0j8sqj.js";
+} from "./cli-b496rxy0.js";
 import {
   UsageError,
   rejectExtraPositionals,
   rejectUnknownFlags
-} from "./cli-1723rkd1.js";
-import"./cli-tjhn2mdn.js";
+} from "./cli-vdpnctkq.js";
+import"./cli-mc3waxaw.js";
 import {
   EXIT_CODES
 } from "./cli-46ycxe6r.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gutterpress",
-  "version": "0.11.14",
+  "version": "0.11.15-alpha.2",
   "description": "Markdown-to-PDF converter for professional print layout using a native Chromium print engine and Ghostscript.",
   "author": "itlackey",
   "license": "MPL-2.0",