gutterpress 0.11.20-alpha.2 → 0.11.20-alpha.3

package/dist/{index-razpty47.js → index-tjvrchxj.js}

@@ -9,7 +9,20 @@ import {
   getAssetsDir,
   lastPageMode,
   parseSize
-} from "./index-3nr5rzzp.js";
+} from "./index-zagagnwq.js";
+import {
+  countLinkAnnotations,
+  getImageResolutions,
+  getOpPass,
+  getOutlineCount,
+  getPageLabels,
+  getPageSize,
+  getTextPass,
+  isLoadable,
+  loadPdf,
+  pageHasMarks,
+  retainPdfCache
+} from "./index-sth219v1.js";
 import {
   INSTALL_HINTS,
   enhancedPath,
@@ -157,6 +170,8 @@ var DTRPG_PRESET = {
     icc: "profiles/CGATS21_CRPC1.icc",
     stripAnnotations: true,
     blackText: "k-only",
+    transparency: "flatten-page",
+    flattenPages: [],
     rasterDpi: undefined
   },
   page: {
@@ -242,6 +257,8 @@ var BOOK_PRESET = {
     icc: "profiles/CGATS21_CRPC1.icc",
     stripAnnotations: true,
     blackText: "icc",
+    transparency: "flatten-page",
+    flattenPages: [],
     rasterDpi: undefined
   },
   page: {
@@ -647,6 +664,14 @@ function resolveWithPreset(cliOverrides, manifest, preset) {
   if (lastPage !== undefined && lastPage !== "blank" && lastPage !== "short-by-one") {
     throw new UsageError(`Manifest field \`print.lastPage\` must be "blank" or "short-by-one", got ${JSON.stringify(lastPage)}.`);
   }
+  const transparency = c.pdfx?.transparency ?? m.pdfx?.transparency;
+  if (transparency !== undefined && transparency !== "flatten-page" && transparency !== "preserve-text") {
+    throw new UsageError(`Manifest field \`pdfx.transparency\` must be "flatten-page" or "preserve-text", got ${JSON.stringify(transparency)}.`);
+  }
+  const flattenPages = c.pdfx?.flattenPages ?? m.pdfx?.flattenPages;
+  if (flattenPages !== undefined && !(Array.isArray(flattenPages) && flattenPages.every((n) => Number.isInteger(n) && n >= 1))) {
+    throw new UsageError(`Manifest field \`pdfx.flattenPages\` must be a list of page numbers (1, 2, …), got ${JSON.stringify(flattenPages)}.`);
+  }
   const rasterDpi = c.pdfx?.rasterDpi ?? m.pdfx?.rasterDpi;
   if (rasterDpi !== undefined && !(Number.isInteger(rasterDpi) && rasterDpi >= 72 && rasterDpi <= 1200)) {
     throw new UsageError(`Manifest field \`pdfx.rasterDpi\` must be a whole number from 72 to 1200, got ${JSON.stringify(rasterDpi)}.`);
@@ -5767,8 +5792,8 @@ async function resolveGhostscript(targetPlatform = process.platform, env = proce
   }
   return targetPlatform === "win32" ? findWindowsGhostscriptInstall(env) : undefined;
 }
-async function hasLiveTransparency(pdfBytes) {
-  const { PDFDocument, PDFDict, PDFName, PDFNumber, PDFRawStream, PDFRef } = await import("pdf-lib");
+async function transparentPages(pdfBytes) {
+  const { PDFDocument, PDFDict, PDFName, PDFNumber, PDFRawStream, PDFArray, PDFRef } = await import("pdf-lib");
   let doc;
   try {
     doc = await PDFDocument.load(pdfBytes, {
@@ -5776,36 +5801,64 @@ async function hasLiveTransparency(pdfBytes) {
       throwOnInvalidObject: false
     });
   } catch {
-    return false;
+    return [];
   }
   const ctx = doc.context;
-  const NONE = "/None";
-  for (const [, obj] of ctx.enumerateIndirectObjects()) {
-    const dict = obj instanceof PDFRawStream ? obj.dict : obj instanceof PDFDict ? obj : undefined;
-    if (!dict)
-      continue;
+  const SKIP = new Set(["Parent", "Font", "Annots"]);
+  const isSet = (v) => v !== undefined && String(v) !== "/None";
+  const dictHasTransparency = (dict) => {
     const smask = dict.get(PDFName.of("SMask"));
     const subtype = String(dict.get(PDFName.of("Subtype")) ?? "");
     const type = String(dict.get(PDFName.of("Type")) ?? "");
-    if (subtype === "/Image" && smask && String(smask) !== NONE)
+    if (subtype === "/Image" && isSet(smask))
       return true;
-    if (type === "/ExtGState") {
-      if (smask && String(smask) !== NONE)
+    if (type === "/ExtGState" || dict.has(PDFName.of("ca")) || dict.has(PDFName.of("BM"))) {
+      if (isSet(smask))
         return true;
       for (const key of ["ca", "CA"]) {
-        const alpha = dict.get(PDFName.of(key));
+        const alpha = ctx.lookup(dict.get(PDFName.of(key)));
         if (alpha instanceof PDFNumber && alpha.asNumber() < 1)
           return true;
       }
+      const bm = ctx.lookup(dict.get(PDFName.of("BM")));
+      const mode = bm instanceof PDFArray ? bm.get(0) : bm;
+      if (mode && !["/Normal", "/Compatible"].includes(String(mode)))
+        return true;
     }
-    const group = dict.get(PDFName.of("Group"));
-    if (group) {
-      const resolved = group instanceof PDFRef ? ctx.lookup(group) : group;
-      if (resolved instanceof PDFDict && String(resolved.get(PDFName.of("S"))) === "/Transparency")
+    const group = ctx.lookup(dict.get(PDFName.of("Group")));
+    return group instanceof PDFDict && String(group.get(PDFName.of("S"))) === "/Transparency";
+  };
+  const reaches = (root) => {
+    const seen = new Set;
+    const stack = [root];
+    while (stack.length) {
+      const node = stack.pop();
+      const obj = node instanceof PDFRef ? ctx.lookup(node) : node;
+      if (!obj || seen.has(obj))
+        continue;
+      seen.add(obj);
+      if (obj instanceof PDFArray) {
+        stack.push(...obj.asArray());
+        continue;
+      }
+      const dict = obj instanceof PDFRawStream ? obj.dict : obj instanceof PDFDict ? obj : undefined;
+      if (!dict)
+        continue;
+      if (dictHasTransparency(dict))
         return true;
+      for (const [key, value] of dict.entries()) {
+        if (!SKIP.has(key.asString().slice(1)))
+          stack.push(value);
+      }
     }
-  }
-  return false;
+    return false;
+  };
+  const pages = [];
+  doc.getPages().forEach((page, i) => {
+    if (reaches(page.node))
+      pages.push(i + 1);
+  });
+  return pages;
 }
 async function findPostScriptShadingPages(pdfBytes) {
   const { PDFDocument, PDFDict, PDFName, PDFNumber, PDFRawStream, PDFRef } = await import("pdf-lib");
@@ -5876,6 +5929,75 @@ async function stripAnnotations(pdfPath, stagingDir) {
   const out = await doc.save();
   await writeFile3(pdfPath, out);
 }
+function planTransparentPages(transparent, reasons, flattenPages, gradientPages) {
+  const split = [];
+  const artOnly = [];
+  const kept = new Map;
+  for (const n of transparent) {
+    const reason = reasons.get(n);
+    if (reason === "no-text")
+      artOnly.push(n);
+    else if (flattenPages.includes(n))
+      kept.set(n, "listed");
+    else if (reason)
+      kept.set(n, reason);
+    else if (gradientPages.includes(n))
+      kept.set(n, "gradient");
+    else
+      split.push(n);
+  }
+  return { split, artOnly, kept };
+}
+async function flattenTransparentPages(pdfPath, pageNumbers, stagingDir, dpi = 300) {
+  const pages = [...new Set(pageNumbers)].sort((a, b) => a - b);
+  if (pages.length === 0)
+    return;
+  const ghostscript = await resolveGhostscript();
+  if (!ghostscript) {
+    throw new Error("Ghostscript executable not found. Install Ghostscript or set GHOSTSCRIPT_PATH to its command-line executable.");
+  }
+  const art = join3(stagingDir, "flatten-art.pdf");
+  const text = join3(stagingDir, "flatten-text.pdf");
+  const pageList = `-sPageList=${pages.join(",")}`;
+  const gs = (...args) => run(ghostscript, [
+    "-q",
+    "-dBATCH",
+    "-dNOPAUSE",
+    "-dSAFER",
+    "-dPreserveAnnots=false",
+    "-dNO_PDFMARK_OUTLINES",
+    ...args
+  ]);
+  try {
+    await gs(pageList, "-sDEVICE=pdfimage24", "-dFILTERTEXT", `-r${dpi}`, `-sOutputFile=${art}`, pdfPath);
+    await gs(pageList, "-sDEVICE=pdfwrite", "-dNOTRANSPARENCY", "-dFILTERIMAGE", "-dFILTERVECTOR", "-dCompatibilityLevel=1.3", `-sOutputFile=${text}`, pdfPath);
+    const { PDFDocument, PDFName } = await import("pdf-lib");
+    const doc = await PDFDocument.load(await readFile9(pdfPath), { updateMetadata: false });
+    const artDoc = await PDFDocument.load(await readFile9(art));
+    const textDoc = await PDFDocument.load(await readFile9(text));
+    if (artDoc.getPageCount() !== pages.length || textDoc.getPageCount() !== pages.length) {
+      throw new Error(`Ghostscript returned ${artDoc.getPageCount()} artwork and ${textDoc.getPageCount()} text pages for ${pages.length} transparent pages.`);
+    }
+    const artPages = await doc.embedPages(artDoc.getPages());
+    const withText = textDoc.getPages().filter((p) => p.node.Contents());
+    const embeddedText = await doc.embedPages(withText);
+    const textPages = textDoc.getPages().map((p) => embeddedText[withText.indexOf(p)]);
+    pages.forEach((pageNumber, i) => {
+      const page = doc.getPage(pageNumber - 1);
+      const { x, y, width, height } = page.getMediaBox();
+      page.node.set(PDFName.of("Contents"), doc.context.obj([]));
+      page.node.set(PDFName.of("Resources"), doc.context.obj({}));
+      page.node.delete(PDFName.of("Group"));
+      page.drawPage(artPages[i], { x, y, width, height });
+      const textPage = textPages[i];
+      if (textPage)
+        page.drawPage(textPage, { x, y, width, height });
+    });
+    await writeFile3(pdfPath, await doc.save());
+  } finally {
+    await Promise.all([art, text].map((f) => unlink2(f).catch(() => {})));
+  }
+}
 function makePdfxDefPs(params) {
   const pdfxVersion = params.pdfx === "x3" ? "PDF/X-3:2002" : "PDF/X-1:2001";
   const pdfxConformance = params.pdfx === "x1a" ? "PDF/X-1a:2001" : null;
@@ -5967,6 +6089,10 @@ async function convertToPdfxCmyk(inputPdf, outPdf, config) {
     "-dDownsampleColorImages=false",
     "-dDownsampleGrayImages=false",
     "-dDownsampleMonoImages=false",
+    "-dAutoFilterColorImages=false",
+    "-dColorImageFilter=/FlateEncode",
+    "-dAutoFilterGrayImages=false",
+    "-dGrayImageFilter=/FlateEncode",
     ...config.rasterDpi ? [`-r${config.rasterDpi}`] : [],
     "-sProcessColorModel=DeviceCMYK",
     "-sColorConversionStrategy=CMYK",
@@ -6017,7 +6143,7 @@ import git from "isomorphic-git";
 // package.json
 var package_default = {
   name: "gutterpress",
-  version: "0.11.20-alpha.2",
+  version: "0.11.20-alpha.3",
   description: "Markdown-to-PDF converter for professional print layout using a native Chromium print engine and Ghostscript.",
   author: "itlackey",
   license: "MPL-2.0",
@@ -6272,7 +6398,10 @@ async function writeBuildFingerprint(input) {
         resolvedFlavor: input.pdfx.resolvedFlavor,
         iccPath: input.pdfx.iccPath,
         stripAnnotations: input.pdfx.stripAnnotations,
-        blackText: input.pdfx.blackText ?? null
+        blackText: input.pdfx.blackText ?? null,
+        transparency: input.pdfx.transparency ?? null,
+        flattenPages: input.pdfx.flattenPages ?? null,
+        rasterDpi: input.pdfx.rasterDpi ?? null
       },
       outputDir: input.recordedOutputDir ? path10.resolve(input.recordedOutputDir) : outputDir
     },
@@ -6614,346 +6743,6 @@ function inspectionFailed(checkId, message, extra = {}) {
   };
 }
 
-// src/lib/pdf-inspect.ts
-import { stat as stat2, readFile as readFile13 } from "node:fs/promises";
-import { getDocumentProxy } from "unpdf";
-import * as pdfjs from "unpdf/pdfjs";
-function getOps(mod) {
-  if ("OPS" in mod && mod.OPS && typeof mod.OPS === "object") {
-    return mod.OPS;
-  }
-  throw new Error("unpdf/pdfjs missing OPS export");
-}
-var OPS = getOps(pdfjs);
-var docCache = new Map;
-var DOC_CACHE_MAX = 8;
-function destroyEntry(entry) {
-  entry.doc.then((d) => d.destroy()).catch(() => {});
-}
-var EVICT_DESTROY_GRACE_MS = 60000;
-var gracePending = new Map;
-function destroyEntryAfterGrace(entry) {
-  const t = setTimeout(() => {
-    gracePending.delete(t);
-    destroyEntry(entry);
-  }, EVICT_DESTROY_GRACE_MS);
-  t.unref?.();
-  gracePending.set(t, entry);
-}
-function evictLru() {
-  while (docCache.size > DOC_CACHE_MAX) {
-    const oldestKey = docCache.keys().next().value;
-    if (oldestKey === undefined)
-      break;
-    const evicted = docCache.get(oldestKey);
-    docCache.delete(oldestKey);
-    if (evicted)
-      destroyEntryAfterGrace(evicted);
-  }
-}
-async function loadPdf(path11) {
-  let st;
-  try {
-    st = await stat2(path11);
-  } catch {
-    return null;
-  }
-  const hit = docCache.get(path11);
-  if (hit && hit.mtimeMs === st.mtimeMs && hit.size === st.size) {
-    docCache.delete(path11);
-    docCache.set(path11, hit);
-    try {
-      return await hit.doc;
-    } catch {
-      return null;
-    }
-  }
-  if (hit)
-    destroyEntry(hit);
-  const docPromise = readFile13(path11).then((buf) => getDocumentProxy(new Uint8Array(buf)));
-  docCache.delete(path11);
-  docCache.set(path11, { mtimeMs: st.mtimeMs, size: st.size, doc: docPromise });
-  evictLru();
-  try {
-    return await docPromise;
-  } catch {
-    if (docCache.get(path11)?.doc === docPromise)
-      docCache.delete(path11);
-    return null;
-  }
-}
-var activeRetains = 0;
-function retainPdfCache() {
-  activeRetains++;
-  let released = false;
-  return () => {
-    if (released)
-      return;
-    released = true;
-    activeRetains--;
-    if (activeRetains === 0)
-      clearPdfCache();
-  };
-}
-function clearPdfCache() {
-  for (const [t, entry] of gracePending) {
-    clearTimeout(t);
-    destroyEntry(entry);
-  }
-  gracePending.clear();
-  for (const entry of docCache.values())
-    destroyEntry(entry);
-  docCache.clear();
-}
-function getPageSize(page) {
-  const vp = page.getViewport({ scale: 1 });
-  return { w: vp.width, h: vp.height };
-}
-async function getOutlineCount(doc) {
-  try {
-    const outline = await doc.getOutline();
-    return outline ? outline.length : 0;
-  } catch {
-    return 0;
-  }
-}
-async function getPageLabels(doc) {
-  try {
-    return await doc.getPageLabels();
-  } catch {
-    return null;
-  }
-}
-async function countLinkAnnotations(doc, stopAtFirst = false) {
-  let count = 0;
-  for (let i = 1;i <= doc.numPages; i++) {
-    try {
-      const page = await doc.getPage(i);
-      const annots = await page.getAnnotations();
-      for (const a of annots) {
-        if (a.subtype === "Link") {
-          count++;
-          if (stopAtFirst)
-            return count;
-        }
-      }
-    } catch {}
-  }
-  return count;
-}
-var textCache = new WeakMap;
-function getTextPass(doc) {
-  let p = textCache.get(doc);
-  if (!p) {
-    p = (async () => {
-      const textByPage = [];
-      const positions = [];
-      const runsByPage = [];
-      for (let i = 1;i <= doc.numPages; i++) {
-        try {
-          const page = await doc.getPage(i);
-          const tc = await page.getTextContent();
-          let pageText = "";
-          const runs = [];
-          for (const item of tc.items) {
-            const it = item;
-            if (typeof it.str !== "string")
-              continue;
-            pageText += it.str;
-            if (it.transform && it.str.trim().length > 0) {
-              const x = it.transform[4];
-              const y = it.transform[5];
-              positions.push({ x, y });
-              runs.push({ s: it.str, x, y, w: it.width ?? 0, h: it.height ?? 0 });
-            }
-          }
-          textByPage.push(pageText);
-          runsByPage.push(runs);
-        } catch {
-          textByPage.push("");
-          runsByPage.push([]);
-        }
-      }
-      return { textByPage, positions, runsByPage };
-    })();
-    textCache.set(doc, p);
-  }
-  return p;
-}
-var opCache = new WeakMap;
-function multiply(m1, m2) {
-  return [
-    m1[0] * m2[0] + m1[2] * m2[1],
-    m1[1] * m2[0] + m1[3] * m2[1],
-    m1[0] * m2[2] + m1[2] * m2[3],
-    m1[1] * m2[2] + m1[3] * m2[3],
-    m1[0] * m2[4] + m1[2] * m2[5] + m1[4],
-    m1[1] * m2[4] + m1[3] * m2[5] + m1[5]
-  ];
-}
-function fontIsEmbedded(f) {
-  if (f.isType3Font)
-    return true;
-  if (f.missingFile === true)
-    return false;
-  if (f.isStandardFont === true)
-    return false;
-  return true;
-}
-function getOpPass(doc) {
-  let p = opCache.get(doc);
-  if (!p) {
-    p = (async () => {
-      const imagesByPage = new Map;
-      const fonts = [];
-      const seenFonts = new Set;
-      for (let i = 1;i <= doc.numPages; i++) {
-        let page;
-        try {
-          page = await doc.getPage(i);
-        } catch {
-          continue;
-        }
-        let ops;
-        try {
-          ops = await page.getOperatorList();
-        } catch {
-          continue;
-        }
-        let ctm = [1, 0, 0, 1, 0, 0];
-        const stack = [];
-        const pageImages = [];
-        for (let j = 0;j < ops.fnArray.length; j++) {
-          const fn = ops.fnArray[j];
-          const args = ops.argsArray[j];
-          if (fn === OPS.save) {
-            stack.push(ctm.slice());
-          } else if (fn === OPS.restore) {
-            ctm = stack.pop() ?? ctm;
-          } else if (fn === OPS.transform) {
-            ctm = multiply(ctm, args);
-          } else if (fn === OPS.paintImageXObject || fn === OPS.paintImageXObjectRepeat || fn === OPS.paintInlineImageXObject) {
-            const name = typeof args[0] === "string" ? args[0] : "(inline)";
-            pageImages.push({
-              name,
-              placedW: Math.hypot(ctm[0], ctm[1]),
-              placedH: Math.hypot(ctm[2], ctm[3]),
-              x: ctm[4],
-              y: ctm[5],
-              page: i
-            });
-          } else if (fn === OPS.setFont) {
-            const ref = args[0];
-            if (typeof ref === "string" && !seenFonts.has(ref)) {
-              seenFonts.add(ref);
-              try {
-                if (page.commonObjs.has(ref)) {
-                  const f = page.commonObjs.get(ref);
-                  fonts.push({
-                    name: f?.name ?? ref,
-                    embedded: fontIsEmbedded(f ?? {})
-                  });
-                }
-              } catch {}
-            }
-          }
-        }
-        if (pageImages.length > 0)
-          imagesByPage.set(i, pageImages);
-      }
-      return { imagesByPage, fonts };
-    })();
-    opCache.set(doc, p);
-  }
-  return p;
-}
-function getImagePixelSize(page, name, timeoutMs = 2000) {
-  return new Promise((resolve6) => {
-    let done = false;
-    const finish = (v) => {
-      if (!done) {
-        done = true;
-        resolve6(v);
-      }
-    };
-    const t = setTimeout(() => finish(null), timeoutMs);
-    try {
-      page.objs.get(name, (obj) => {
-        clearTimeout(t);
-        finish(obj && obj.width && obj.height ? { width: obj.width, height: obj.height } : null);
-      });
-    } catch {
-      clearTimeout(t);
-      finish(null);
-    }
-  });
-}
-var PAINT_OPS = new Set([
-  "stroke",
-  "closeStroke",
-  "fill",
-  "eoFill",
-  "fillStroke",
-  "eoFillStroke",
-  "closeFillStroke",
-  "closeEOFillStroke",
-  "shadingFill",
-  "paintImageXObject",
-  "paintInlineImageXObject",
-  "paintImageXObjectRepeat",
-  "paintImageMaskXObject",
-  "paintImageMaskXObjectGroup",
-  "paintImageMaskXObjectRepeat",
-  "paintSolidColorImageMask",
-  "showText",
-  "showSpacedText",
-  "nextLineShowText",
-  "nextLineSetSpacingShowText"
-].map((name) => OPS[name]).filter((op) => op !== undefined));
-async function pageHasMarks(doc, pageNum) {
-  const ops = await (await doc.getPage(pageNum)).getOperatorList();
-  return ops.fnArray.some((fn, i) => fn === OPS.constructPath ? PAINT_OPS.has(ops.argsArray[i][0]) : PAINT_OPS.has(fn));
-}
-async function getImageResolutions(doc) {
-  const { imagesByPage } = await getOpPass(doc);
-  const out = [];
-  for (const [pageNum, imgs] of imagesByPage) {
-    let page;
-    try {
-      page = await doc.getPage(pageNum);
-    } catch {
-      continue;
-    }
-    for (const img of imgs) {
-      if (img.name === "(inline)")
-        continue;
-      const px = await getImagePixelSize(page, img.name);
-      if (!px)
-        continue;
-      const placedWin = img.placedW / 72;
-      const placedHin = img.placedH / 72;
-      if (placedWin <= 0 || placedHin <= 0)
-        continue;
-      out.push({
-        page: pageNum,
-        xDpi: px.width / placedWin,
-        yDpi: px.height / placedHin
-      });
-    }
-  }
-  return out;
-}
-async function isLoadable(doc) {
-  try {
-    for (let i = 1;i <= doc.numPages; i++) {
-      await doc.getPage(i);
-    }
-    return true;
-  } catch {
-    return false;
-  }
-}
-
 // src/checks/pdf/qpdf-structure.ts
 var check2 = {
   id: "pdf.structure.qpdf",
@@ -7228,9 +7017,9 @@ var check5 = {
 registerCheck(check5);
 
 // src/lib/pdf-parse.ts
-import { readFile as readFile14 } from "node:fs/promises";
+import { readFile as readFile13 } from "node:fs/promises";
 async function readPdfBytes(pdfPath) {
-  return readFile14(pdfPath, "latin1");
+  return readFile13(pdfPath, "latin1");
 }
 function parseInkCov(out) {
   const lines = out.split(/\r?\n/).filter((l) => l.includes("CMYK"));
@@ -7491,7 +7280,7 @@ var check9 = {
 registerCheck(check9);
 
 // src/checks/pdf/black-text.ts
-import { readFile as readFile15 } from "node:fs/promises";
+import { readFile as readFile14 } from "node:fs/promises";
 var check10 = {
   id: "pdf.print.black-text",
   name: "Black Text",
@@ -7504,7 +7293,7 @@ var check10 = {
       return [];
     try {
       const { findRichBlackText, LARGE_TEXT_PT } = await import("./black-text-gray-7dz61456.js");
-      const found = await findRichBlackText(await readFile15(ctx.pdfPath));
+      const found = await findRichBlackText(await readFile14(ctx.pdfPath));
       if (found.runs === 0)
         return [];
       return [
@@ -7894,7 +7683,7 @@ registerCheck(check19);
 
 // src/checks/source/htmlhint.ts
 import { existsSync as existsSync9 } from "node:fs";
-import { readFile as readFile16 } from "node:fs/promises";
+import { readFile as readFile15 } from "node:fs/promises";
 import htmlhint from "htmlhint";
 var { HTMLHint } = htmlhint;
 var CONFIG_NAMES2 = [".htmlhintrc"];
@@ -7914,8 +7703,8 @@ var check20 = {
     const resolvedConfig = findConfigFile(ctx.inputDir, CONFIG_NAMES2, configPath);
     if (!resolvedConfig && !configPath)
       return [];
-    const ruleset = resolvedConfig ? JSON.parse(await readFile16(resolvedConfig, "utf8")) : HTMLHint.defaultRuleset;
-    const html = await readFile16(ctx.htmlPath, "utf8");
+    const ruleset = resolvedConfig ? JSON.parse(await readFile15(resolvedConfig, "utf8")) : HTMLHint.defaultRuleset;
+    const html = await readFile15(ctx.htmlPath, "utf8");
     const messages = HTMLHint.verify(html, ruleset);
     return messages.map((m) => ({
       checkId: check20.id,
@@ -7930,7 +7719,7 @@ var check20 = {
 registerCheck(check20);
 
 // src/checks/source/stylelint.ts
-import { readFile as readFile17 } from "node:fs/promises";
+import { readFile as readFile16 } from "node:fs/promises";
 
 // src/lib/printsafe.ts
 import postcss2 from "postcss";
@@ -8272,7 +8061,7 @@ function checkCssRaw(css, from) {
       warnings.push({
         rule: ruleRiskyProps,
         severity: "warning",
-        message: `"${decl.prop}: ${decl.value}" prints blank in PDF/X exports (--format pdfx): Chromium emits repeating-*-gradient() and conic-gradient() in a form Ghostscript cannot convert. Plain PDF output is unaffected. Use linear-gradient() or radial-gradient() instead; for 0deg/90deg stripes write "linear-gradient(90deg, #b33 0 6px, #c8c5bf 6px 10px)" with "background-size: 10px 100%", and for anything else a small tiled image.`,
+        message: `"${decl.prop}: ${decl.value}" is at risk in PDF/X exports (--format pdfx): Chromium emits repeating-*-gradient() and conic-gradient() in a form Ghostscript has been seen to paint as nothing or as irregular stripes, so it can print blank or distorted, unless the page also uses transparency and Ghostscript flattens the whole page to an image, which keeps the gradient but loses that page's live text. Plain PDF output is unaffected. Use linear-gradient() or radial-gradient() instead; for 0deg/90deg stripes write "linear-gradient(90deg, #b33 0 6px, #c8c5bf 6px 10px)" with "background-size: 10px 100%", and for anything else a small tiled image.`,
         ...nodeLoc(decl)
       });
     } else if (isUnpairedFitContentWidth(decl)) {
@@ -8337,7 +8126,7 @@ var check21 = {
     for (const file of files) {
       let css;
       try {
-        css = await readFile17(file, "utf8");
+        css = await readFile16(file, "utf8");
       } catch (err) {
         results.push({
           checkId: check21.id,
@@ -8364,12 +8153,12 @@ var check21 = {
 registerCheck(check21);
 
 // src/checks/source/css-ownership.ts
-import { readFile as readFile18 } from "node:fs/promises";
+import { readFile as readFile17 } from "node:fs/promises";
 import postcss3 from "postcss";
 import { parse as parseYaml3 } from "yaml";
 var CONFIG_NAMES3 = [".gutterpress/css-contract.yaml", ".gutterpress/css-contract.yml"];
 async function loadContract(configPath) {
-  const raw = await readFile18(configPath, "utf8");
+  const raw = await readFile17(configPath, "utf8");
   const parsed = parseYaml3(raw);
   if (parsed && typeof parsed === "object")
     return parsed;
@@ -8520,7 +8309,7 @@ var check22 = {
         continue;
       let css;
       try {
-        css = await readFile18(absFile, "utf8");
+        css = await readFile17(absFile, "utf8");
       } catch {
         continue;
       }
@@ -8566,7 +8355,7 @@ import { existsSync as existsSync10 } from "node:fs";
 import { dirname as dirname3, resolve as resolve6 } from "node:path";
 
 // src/checks/source/local-ref-parser.ts
-import { readFile as readFile19 } from "node:fs/promises";
+import { readFile as readFile18 } from "node:fs/promises";
 function newlineOffsets(content) {
   const offsets = [];
   for (let i = 0;i < content.length; i++)
@@ -8635,7 +8424,7 @@ async function* renderedLocalRefs(ctx, checkId, results) {
   for (const file of files) {
     let refs;
     try {
-      refs = collectRenderedLocalRefs(await readFile19(file, "utf8"));
+      refs = collectRenderedLocalRefs(await readFile18(file, "utf8"));
     } catch {
       results.push(inspectionFailed(checkId, `Could not read source file: ${file}`, { file }));
       continue;
@@ -8986,7 +8775,7 @@ var check24 = {
 registerCheck(check24);
 
 // src/checks/source/accessibility-alt-text.ts
-import { readFile as readFile20 } from "node:fs/promises";
+import { readFile as readFile19 } from "node:fs/promises";
 var check25 = {
   id: "source.accessibility.alt-text",
   name: "Image Alt Text",
@@ -9000,7 +8789,7 @@ var check25 = {
     const results = [];
     for (const file of files) {
       try {
-        const content = await readFile20(file, "utf8");
+        const content = await readFile19(file, "utf8");
         const lines = content.split(`
 `);
         let inFence = false;
@@ -9044,7 +8833,7 @@ function extractImageAlts(line) {
 registerCheck(check25);
 
 // src/checks/source/accessibility-heading-order.ts
-import { readFile as readFile21 } from "node:fs/promises";
+import { readFile as readFile20 } from "node:fs/promises";
 var check26 = {
   id: "source.accessibility.heading-order",
   name: "Heading Order",
@@ -9058,7 +8847,7 @@ var check26 = {
     const results = [];
     for (const file of files) {
       try {
-        const content = await readFile21(file, "utf8");
+        const content = await readFile20(file, "utf8");
         const lines = content.split(`
 `);
         let inFence = false;
@@ -9100,7 +8889,7 @@ var check26 = {
 registerCheck(check26);
 
 // src/checks/source/layout-markers.ts
-import { readFile as readFile22 } from "node:fs/promises";
+import { readFile as readFile21 } from "node:fs/promises";
 
 // src/lib/unknown-classes.ts
 import postcss4 from "postcss";
@@ -9203,7 +8992,7 @@ async function collectKnownClasses(ctx, plugins) {
   const sheets = (await collectStyleDependencies(ctx.inputDir, roots)).filter((f) => /\.css$/i.test(f));
   for (const sheet of sheets) {
     try {
-      addCssClasses(await readFile22(sheet, "utf8"), names);
+      addCssClasses(await readFile21(sheet, "utf8"), names);
     } catch {}
   }
   return names;
@@ -9227,7 +9016,7 @@ var check27 = {
     const knownClasses = () => known ??= collectKnownClasses(ctx, plugins);
     for (const file of files) {
       try {
-        const content = await readFile22(file, "utf8");
+        const content = await readFile21(file, "utf8");
         const env = {};
         const tokens = md.parse(content, env);
         md.renderer.render(tokens, md.options, env);
@@ -9267,7 +9056,7 @@ var check27 = {
 registerCheck(check27);
 
 // src/checks/source/merge-markers.ts
-import { readFile as readFile23 } from "node:fs/promises";
+import { readFile as readFile22 } from "node:fs/promises";
 import path12 from "node:path";
 
 // src/checks/asset/extensions.ts
@@ -9309,7 +9098,7 @@ var check28 = {
     for (const file of textFiles) {
       let content;
       try {
-        content = await readFile23(file, "utf8");
+        content = await readFile22(file, "utf8");
       } catch {
         results.push(inspectionFailed(check28.id, `Could not read source file: ${file}`, { file }));
         continue;
@@ -9369,7 +9158,7 @@ var check28 = {
 registerCheck(check28);
 
 // src/checks/source/characters.ts
-import { readFile as readFile24 } from "node:fs/promises";
+import { readFile as readFile23 } from "node:fs/promises";
 
 // src/checks/source/character-table.ts
 var CHARACTER_PATTERN = new RegExp("[\\u0000-\\u0008\\u000B\\u000C\\u000E-\\u001F\\u007F-\\u00A0\\u00AD\\u00B4\\u02BC" + "\\u061C\\u2000-\\u2015\\u2018\\u2019\\u201B-\\u201D\\u201F\\u2022\\u2026" + "\\u2028-\\u202F\\u2032\\u2033\\u205F\\u2060\\u2066-\\u2069\\u2190\\u2192" + "\\u2194\\u21D2\\u2212\\u25AA\\u25E6\\u2605\\u2713\\u2714\\u2717\\u3000" + "\\uE000-\\uF8FF\\uFEFF\\uFF02\\uFF07\\uFFFD]" + "|\\p{Emoji_Presentation}|\\p{Extended_Pictographic}(?=\\uFE0F)", "gu");
@@ -9492,7 +9281,7 @@ var check29 = {
     for (const file of (ctx.markdownFiles ?? []).slice().sort()) {
       let content;
       try {
-        content = await readFile24(file, "utf8");
+        content = await readFile23(file, "utf8");
       } catch {
         results.push(inspectionFailed(check29.id, `Could not read source file: ${file}`, { file }));
         continue;
@@ -9532,16 +9321,16 @@ var check29 = {
 registerCheck(check29);
 
 // src/checks/asset/image-file-size.ts
-import { stat as stat4 } from "node:fs/promises";
+import { stat as stat3 } from "node:fs/promises";
 
 // src/lib/image-inspect.ts
-import { stat as stat3, readFile as readFile25 } from "node:fs/promises";
+import { stat as stat2, readFile as readFile24 } from "node:fs/promises";
 var DEFAULT_DPI = 72;
 var cache = new Map;
 async function inspectImage(path13) {
   let st;
   try {
-    st = await stat3(path13);
+    st = await stat2(path13);
   } catch {
     return null;
   }
@@ -9550,7 +9339,7 @@ async function inspectImage(path13) {
     return hit.info;
   let info3 = null;
   try {
-    const buf = await readFile25(path13);
+    const buf = await readFile24(path13);
     info3 = parseImage(buf);
   } catch {
     info3 = null;
@@ -9772,7 +9561,7 @@ var check30 = {
     const results = [];
     for (const file of files) {
       try {
-        const info3 = await stat4(file);
+        const info3 = await stat3(file);
         if (info3.size > maxSize) {
           const sizeMb = (info3.size / 1e6).toFixed(1);
           const maxMb = (maxSize / 1e6).toFixed(1);
@@ -10110,7 +9899,7 @@ var check37 = {
 registerCheck(check37);
 
 // src/checks/heuristic/section-density.ts
-import { readFile as readFile26 } from "node:fs/promises";
+import { readFile as readFile25 } from "node:fs/promises";
 var check38 = {
   id: "heuristic.chunking.section-density",
   name: "Section Density",
@@ -10127,7 +9916,7 @@ var check38 = {
     const results = [];
     for (const file of files) {
       try {
-        const content = await readFile26(file, "utf8");
+        const content = await readFile25(file, "utf8");
         const lines = content.split(`
 `);
         let currentSectionStart = 0;
@@ -11009,7 +10798,7 @@ class PdfOutput {
       const rawPdf = pdfxMode ? path13.join(stage, "raw.pdf") : path13.resolve(pdfFile);
       await fsp2.mkdir(path13.dirname(path13.resolve(pdfFile)), { recursive: true });
       log.info("Rendering HTML to PDF via the Gutterpress engine (native Chromium pagination)");
-      const { buildNativePdf } = await import("./engine-yax79k9m.js");
+      const { buildNativePdf } = await import("./engine-fdtv01a2.js");
       const engineDiagnostics = await buildNativePdf(htmlFile, rawPdf, {
         title: config.title,
         author: config.authors.length > 0 ? config.authors.join(", ") : undefined,
@@ -11031,12 +10820,40 @@ class PdfOutput {
       if (pdfxMode) {
         const icc = opts.iccPath ?? config.pdfx.icc;
         effectiveIccPath = await resolveIccProfile(icc, manifestDir, opts.iccPath);
-        if (await hasLiveTransparency(await fsp2.readFile(rawPdf))) {
-          log.warn("This book uses transparency — an image with an alpha channel, or a CSS " + `rule like \`opacity\` or \`mix-blend-mode\`. PDF/${pdfxMode === "x1a" ? "X-1a" : "X-3"} has no way to represent that (both are based on PDF 1.3, which predates PDF transparency), so Ghostscript will flatten every page that uses it into a single raster ` + "image — that page loses its embedded fonts and searchable text in the " + "PDF/X output. To keep vector text, remove the `opacity`/blend rule and flatten any alpha-channel image against its intended background before including it (export it with no alpha channel), or build --format pdf instead of pdfx if this book doesn't need print-ready CMYK. `pdfx.rasterDpi` sets the resolution of those page images (default 720).");
+        const rawBytes = await fsp2.readFile(rawPdf);
+        const transparent = await transparentPages(rawBytes);
+        const blankGradientPages = await findPostScriptShadingPages(rawBytes);
+        const flattenedGradientPages = blankGradientPages.filter((n) => transparent.includes(n));
+        const vectorGradientPages = blankGradientPages.filter((n) => !transparent.includes(n));
+        const GRADIENT_FIX = "Replace it with a plain linear-gradient() or radial-gradient(), or a small tiled image. For 0deg/90deg stripes, `linear-gradient(90deg, #b33 0 6px, #c8c5bf 6px 10px)` with `background-size: 10px 100%` converts correctly.";
+        const pageList = (pages) => `Page${pages.length === 1 ? "" : "s"} ${pages.join(", ")}`;
+        if (vectorGradientPages.length > 0) {
+          log.warn(`${pageList(vectorGradientPages)}: a repeating-*-gradient() or conic-gradient() ` + "can print blank or distorted — " + `Ghostscript has been seen to paint nothing, or irregular stripes, for it when converting to PDF/X; check the page visually. ${GRADIENT_FIX}`);
         }
-        const blankGradientPages = await findPostScriptShadingPages(await fsp2.readFile(rawPdf));
-        if (blankGradientPages.length > 0) {
-          log.warn(`Page${blankGradientPages.length === 1 ? "" : "s"} ${blankGradientPages.join(", ")}: ` + "a repeating-*-gradient() or conic-gradient() will print blank — " + "Ghostscript cannot convert it to PDF/X. Replace it with a plain linear-gradient() or radial-gradient(), or a small tiled image. For 0deg/90deg stripes, `linear-gradient(90deg, #b33 0 6px, #c8c5bf 6px 10px)` with `background-size: 10px 100%` converts correctly.");
+        if (flattenedGradientPages.length > 0 && config.pdfx.transparency !== "preserve-text") {
+          log.warn(`${pageList(flattenedGradientPages)}: a repeating-*-gradient() or conic-gradient() is painted only as part of the one raster image Ghostscript makes of the whole page, so the page loses its embedded fonts and searchable text. Check the page visually. ${GRADIENT_FIX}`);
+        }
+        const flattenPages = config.pdfx.flattenPages;
+        if (transparent.length > 0 && config.pdfx.transparency === "preserve-text") {
+          const { unsplittableTextReasons } = await import("./pdf-inspect-zdmy7qca.js");
+          const reasons = await unsplittableTextReasons(rawBytes, transparent).catch((err) => {
+            log.warn(`pdfx.transparency: preserve-text could not inspect this PDF's text (${err instanceof Error ? err.message : String(err)}), so every page that uses transparency is flattened whole, as with flatten-page.`);
+            return null;
+          });
+          if (reasons) {
+            const plan = planTransparentPages(transparent, reasons, flattenPages, blankGradientPages);
+            await flattenTransparentPages(rawPdf, plan.split, stage, config.pdfx.rasterDpi);
+            reportTransparentPlan(plan, pdfxMode, config.pdfx.rasterDpi ?? 300, pageList);
+          }
+        }
+        const unused = flattenPages.filter((n) => !transparent.includes(n));
+        if (flattenPages.length > 0 && config.pdfx.transparency !== "preserve-text") {
+          log.warn("pdfx.flattenPages has no effect without pdfx.transparency: preserve-text.");
+        } else if (unused.length > 0) {
+          log.warn(`pdfx.flattenPages lists ${pageList(unused).toLowerCase()}, which ${unused.length === 1 ? "has" : "have"} no transparency (or do not exist): nothing to flatten there.`);
+        }
+        if (transparent.length > 0 && config.pdfx.transparency !== "preserve-text") {
+          log.warn("This book uses transparency — an image with an alpha channel, or a CSS " + `rule like \`opacity\` or \`mix-blend-mode\`. PDF/${pdfxMode === "x1a" ? "X-1a" : "X-3"} has no way to represent that (both are based on PDF 1.3, which predates PDF transparency), so Ghostscript will flatten every page that uses it into a single raster ` + "image — that page loses its embedded fonts and searchable text in the " + "PDF/X output. To keep vector text, remove the `opacity`/blend rule and flatten any alpha-channel image against its intended background before including it (export it with no alpha channel), or build --format pdf instead of pdfx if this book doesn't need print-ready CMYK. Or set `pdfx.transparency: preserve-text` to keep the text live on the pages where that is possible. `pdfx.rasterDpi` sets the resolution of those page images (default 720).");
         }
         const shouldStrip = opts.stripAnnotations ?? config.pdfx.stripAnnotations;
         shouldStripAnnotations = shouldStrip;
@@ -11079,7 +10896,10 @@ class PdfOutput {
           resolvedFlavor: config.pdfx.flavor,
           iccPath: effectiveIccPath,
           stripAnnotations: shouldStripAnnotations,
-          blackText: pdfxMode ? config.pdfx.blackText : null
+          blackText: pdfxMode ? config.pdfx.blackText : null,
+          transparency: pdfxMode ? config.pdfx.transparency : null,
+          flattenPages: pdfxMode ? config.pdfx.flattenPages : null,
+          rasterDpi: pdfxMode ? config.pdfx.rasterDpi ?? null : null
         }
       }, `Wrote: ${reportedPdf}`, { htmlPath: htmlFile, pdfPath: reportedPdf }, pdfName, engineDiagnostics);
     } finally {
@@ -11116,11 +10936,40 @@ async function runBuild(opts) {
     await fsp2.rm(ctx.workDir, { recursive: true, force: true });
   }
 }
+var FALLBACK_CAUSE = {
+  listed: "listed in pdfx.flattenPages",
+  "text-transparency": "text drawn with transparency or blending (opacity, mix-blend-mode, a soft mask, a translucent text-shadow); keep that text opaque",
+  "type3-font": "text in a Type 3 font: for a synthetic bold (a weight the font has no face for), use a face with that weight or set the font's own weight; for -webkit-text-stroke, remove the stroke or accept this fallback",
+  "text-pattern-or-clip": 'text filled with a pattern or used as a clip (SVG fill="url(#…)", gradient text, background-clip: text)',
+  gradient: "a repeating or conic gradient; use a linear or radial gradient, or a small tiled image"
+};
+function reportTransparentPlan({ split, artOnly, kept }, pdfxMode, dpi, pageList) {
+  const one = (pages, singular, plural) => pages.length === 1 ? singular : plural;
+  if (split.length > 0) {
+    log.warn(`${pageList(split)} ${one(split, "uses", "use")} transparency, which PDF/${pdfxMode === "x1a" ? "X-1a" : "X-3"} (PDF 1.3) cannot represent. Each was flattened to a ${dpi} DPI picture with its text kept live on top (pdfx.transparency: preserve-text), so fonts and searchable text survive. On those pages, rules, backgrounds and shapes are raster, and text always sits above the artwork: text another element covers shows through. List a page in pdfx.flattenPages to flatten it whole instead.`);
+  }
+  if (artOnly.length > 0) {
+    log.info(`${pageList(artOnly)} ${one(artOnly, "uses", "use")} transparency but ${one(artOnly, "shows", "show")} no text, so there is no text to keep: Ghostscript flattens ${one(artOnly, "it", "each")} whole (resolution: pdfx.rasterDpi).`);
+  }
+  if (kept.size > 0) {
+    const pages = [...kept.keys()];
+    const byCause = new Map;
+    for (const [n, cause] of kept)
+      byCause.set(cause, [...byCause.get(cause) ?? [], n]);
+    const lines = [...byCause].map(([cause, ns]) => `  - ${one(ns, "page", "pages")} ${ns.join(", ")}: ${FALLBACK_CAUSE[cause]}`);
+    log.warn(`${pageList(pages)} could not keep ${one(pages, "its", "their")} text live; Ghostscript will flatten ${one(pages, "that page", "each of those pages")} into one raster image, losing its embedded fonts and searchable text. Each page lists the first cause found; fixing it can reveal another:
+` + lines.join(`
+`));
+  }
+  if (split.length === 0 && [...kept.values()].some((cause) => cause !== "listed")) {
+    log.warn("pdfx.transparency: preserve-text kept no page's text live in this book: every page with transparency and text falls back (see above).");
+  }
+}
 // src/preview/lifecycle.ts
 import path16 from "path";
 import { tmpdir } from "os";
 import { randomBytes as randomBytes2 } from "crypto";
-import { readdir as readdir5, readFile as readFile27, writeFile as writeFile6 } from "node:fs/promises";
+import { readdir as readdir5, readFile as readFile26, writeFile as writeFile6 } from "node:fs/promises";
 
 // src/utils/file-utils.ts
 import { promises as fs3 } from "fs";
@@ -11681,7 +11530,7 @@ async function cleanupOrphanTempDirs() {
     const dir = path16.join(TEMP_DIR_BASE, entry);
     const pidFile = path16.join(dir, PID_FILE_NAME);
     try {
-      const raw = await readFile27(pidFile, "utf8");
+      const raw = await readFile26(pidFile, "utf8");
       const pid = parseInt(raw.trim(), 10);
       if (!isProcessAlive(pid)) {
         debug(`Removing orphan temp dir ${dir} (pid ${pid} not alive)`);
@@ -11788,7 +11637,7 @@ function createServerState(inputPath, tempDir, config, options) {
 import http from "node:http";
 import net from "node:net";
 import { createHash as createHash5, randomUUID as randomUUID3 } from "node:crypto";
-import { readFile as readFile28, stat as stat5 } from "node:fs/promises";
+import { readFile as readFile27, stat as stat4 } from "node:fs/promises";
 import path17 from "path";
 import { WebSocket, WebSocketServer } from "ws";
 
@@ -11877,7 +11726,7 @@ async function findAvailablePort(startPort, host = "127.0.0.1") {
 async function serveStatic(absPath, res, cacheControl = "no-store", extraHeaders = {}) {
   let filePath = absPath;
   try {
-    const s = await stat5(filePath);
+    const s = await stat4(filePath);
     if (s.isDirectory())
       filePath = path17.join(filePath, "index.html");
   } catch {
@@ -11887,7 +11736,7 @@ async function serveStatic(absPath, res, cacheControl = "no-store", extraHeaders
   }
   let data;
   try {
-    data = await readFile28(filePath);
+    data = await readFile27(filePath);
   } catch {
     res.writeHead(404);
     res.end("Not Found");
@@ -11916,7 +11765,7 @@ async function serveRevalidatedStatic(req, absPath, res, validators) {
   }
   let fileStat;
   try {
-    fileStat = await stat5(absPath, { bigint: true });
+    fileStat = await stat4(absPath, { bigint: true });
   } catch {
     await serveStatic(absPath, res);
     return;
@@ -11936,7 +11785,7 @@ async function serveRevalidatedStatic(req, absPath, res, validators) {
   let data;
   if (!validator || validator.stamp !== stamp) {
     try {
-      data = await readFile28(absPath);
+      data = await readFile27(absPath);
     } catch {
       await serveStatic(absPath, res);
       return;
@@ -11964,7 +11813,7 @@ async function isMissingReferencedImage(pathname, absPath, refs) {
   if (!refs.has(imageRefKey(pathname)))
     return false;
   try {
-    await stat5(absPath);
+    await stat4(absPath);
     return false;
   } catch (err) {
     return err?.code === "ENOENT";
@@ -12248,7 +12097,7 @@ async function startPreviewServer(options) {
 import { platform, arch, release } from "node:os";
 
 // src/lib/remote-auth/token-store.ts
-import { chmod, mkdir as mkdir7, readFile as readFile29, rename as rename4, writeFile as writeFile7 } from "node:fs/promises";
+import { chmod, mkdir as mkdir7, readFile as readFile28, rename as rename4, writeFile as writeFile7 } from "node:fs/promises";
 import os3 from "node:os";
 import path18 from "node:path";
 function credentialHostKey(hostOrUrl) {
@@ -12292,7 +12141,7 @@ class FileTokenStore {
   async read() {
     let raw;
     try {
-      raw = await readFile29(this.filePath, "utf8");
+      raw = await readFile28(this.filePath, "utf8");
     } catch (e) {
       if (e?.code === "ENOENT") {
         return { version: 1, credentials: {} };
@@ -12492,13 +12341,13 @@ async function getSystemDiagnostics() {
   };
 }
 // src/lib/project-scaffold.ts
-import { access, copyFile, cp as cp2, mkdir as mkdir9, readdir as readdir6, readFile as readFile31, stat as stat6, writeFile as writeFile9 } from "node:fs/promises";
+import { access, copyFile, cp as cp2, mkdir as mkdir9, readdir as readdir6, readFile as readFile30, stat as stat5, writeFile as writeFile9 } from "node:fs/promises";
 import { constants as FS, existsSync as existsSync14 } from "node:fs";
 import path20 from "node:path";
 
 // src/lib/page-size.ts
 import { existsSync as existsSync13 } from "node:fs";
-import { mkdir as mkdir8, readFile as readFile30, writeFile as writeFile8 } from "node:fs/promises";
+import { mkdir as mkdir8, readFile as readFile29, writeFile as writeFile8 } from "node:fs/promises";
 import path19 from "node:path";
 import postcss5 from "postcss";
 import { Scalar as Scalar2 } from "yaml";
@@ -12603,7 +12452,7 @@ var relDisplay2 = (projectDir, abs) => path19.relative(projectDir, abs).split(pa
 async function findCssSize(projectDir, sheets) {
   let found = null;
   for (const file of sheets) {
-    const size = readPageSizeFromCss(await readFile30(file, "utf8"));
+    const size = readPageSizeFromCss(await readFile29(file, "utf8"));
     if (size)
       found = { file, size };
   }
@@ -12630,7 +12479,7 @@ async function setPageSetup(projectDir, choice) {
   const found = await findCssSize(projectDir, sheets);
   const newSheet = path19.join(projectDir, "styles", "book.css");
   const target = found?.file ?? sheets[sheets.length - 1] ?? newSheet;
-  const before = existsSync13(target) ? await readFile30(target, "utf8") : "";
+  const before = existsSync13(target) ? await readFile29(target, "utf8") : "";
   let after;
   try {
     after = setPageSizeInCss(before, size);
@@ -12839,7 +12688,7 @@ async function adoptFolder(options) {
   }
   let st;
   try {
-    st = await stat6(dir);
+    st = await stat5(dir);
   } catch {
     throw new CreateProjectErrorImpl("scaffold-io", `Folder not found: ${dir}`);
   }
@@ -12920,7 +12769,7 @@ styles:
 async function firstSourceFile(manifestPath) {
   let text;
   try {
-    text = await readFile31(manifestPath, "utf8");
+    text = await readFile30(manifestPath, "utf8");
   } catch {
     return;
   }
@@ -12932,14 +12781,14 @@ async function firstSourceFile(manifestPath) {
   return m ? m[1].trim() : undefined;
 }
 async function fillTemplateFile(filePath, substitutions) {
-  let text = await readFile31(filePath, "utf8");
+  let text = await readFile30(filePath, "utf8");
   for (const [token, value] of Object.entries(substitutions)) {
     text = text.split(token).join(value);
   }
   await writeFile9(filePath, text, "utf8");
 }
 // src/lib/extension-scaffold.ts
-import { access as access2, mkdir as mkdir10, readFile as readFile32, writeFile as writeFile10 } from "node:fs/promises";
+import { access as access2, mkdir as mkdir10, readFile as readFile31, writeFile as writeFile10 } from "node:fs/promises";
 import { constants as FS2 } from "node:fs";
 import path21 from "node:path";
 var EXTENSION_KINDS = ["plugin", "theme"];
@@ -13056,7 +12905,7 @@ async function scaffoldExtension(options) {
       const src = await getAssetPath(`extension-templates/${kind}/${assetName}`);
       const dest = path21.join(extensionDir, relDest);
       await mkdir10(path21.dirname(dest), { recursive: true });
-      const text = await readFile32(src, "utf8");
+      const text = await readFile31(src, "utf8");
       const table = relDest.endsWith(".json") ? jsonSafe : plain;
       await writeFile10(dest, substitute(text, table), "utf8");
       written.push(relDest);
@@ -13082,7 +12931,7 @@ function substitute(text, table) {
   return out;
 }
 // src/lib/project-templates.ts
-import { cp as cp3, mkdir as mkdir11, readFile as readFile33, readdir as readdir7, stat as stat7, writeFile as writeFile11 } from "node:fs/promises";
+import { cp as cp3, mkdir as mkdir11, readFile as readFile32, readdir as readdir7, stat as stat6, writeFile as writeFile11 } from "node:fs/promises";
 import { constants as FS3, existsSync as existsSync15 } from "node:fs";
 import { access as access3 } from "node:fs/promises";
 import path22 from "node:path";
@@ -13094,7 +12943,7 @@ var BUILT_IN_TEMPLATE_IDS = [
 ];
 async function readTemplateChoices(manifestPath) {
   try {
-    const text = await readFile33(manifestPath, "utf8");
+    const text = await readFile32(manifestPath, "utf8");
     const doc = parseDocument2(text);
     const out = {};
     const preset = doc.get("preset");
@@ -13276,7 +13125,7 @@ async function saveProjectAsTemplate(options) {
 async function retokeniseManifest(manifestPath) {
   let text;
   try {
-    text = await readFile33(manifestPath, "utf8");
+    text = await readFile32(manifestPath, "utf8");
   } catch {
     return;
   }
@@ -13297,7 +13146,7 @@ async function listCustomTemplates(templatesRoot) {
     const dir = path22.join(templatesRoot, entry.name);
     let label = prettify(entry.name);
     try {
-      const meta = JSON.parse(await readFile33(path22.join(dir, TEMPLATE_META_FILE), "utf8"));
+      const meta = JSON.parse(await readFile32(path22.join(dir, TEMPLATE_META_FILE), "utf8"));
       if (typeof meta.label === "string" && meta.label)
         label = meta.label;
     } catch {}
@@ -13315,7 +13164,7 @@ async function listCustomTemplates(templatesRoot) {
 }
 async function importTemplateFromFolder(options) {
   const { sourceDir, templatesRoot } = options;
-  const srcStat = await stat7(sourceDir);
+  const srcStat = await stat6(sourceDir);
   if (!srcStat.isDirectory()) {
     throw new Error("The chosen path is not a folder.");
   }
@@ -13323,7 +13172,7 @@ async function importTemplateFromFolder(options) {
   return saveProjectAsTemplate({ projectDir: sourceDir, name, templatesRoot });
 }
 // src/lib/snippets.ts
-import { readdir as readdir8, readFile as readFile34, writeFile as writeFile12, mkdir as mkdir12, rm as rm4 } from "node:fs/promises";
+import { readdir as readdir8, readFile as readFile33, writeFile as writeFile12, mkdir as mkdir12, rm as rm4 } from "node:fs/promises";
 import path23 from "node:path";
 var SNIPPETS_DIR = "snippets";
 var LEVEL_RANK = { project: 0, extension: 1, core: 2 };
@@ -13364,7 +13213,7 @@ async function scanSnippetFiles(dir) {
       continue;
     let body = "";
     try {
-      body = await readFile34(path23.join(dir, fileName), "utf8");
+      body = await readFile33(path23.join(dir, fileName), "utf8");
     } catch {
       continue;
     }
@@ -13453,7 +13302,7 @@ async function collectLibrary(projectDir) {
         listed.component = name;
         continue;
       }
-      const body = await readFile34(path23.join(entry.dir, rel), "utf8").catch(() => null);
+      const body = await readFile33(path23.join(entry.dir, rel), "utf8").catch(() => null);
       if (body === null)
         continue;
       snippets2.push({
@@ -13522,7 +13371,7 @@ async function listLocationVariants(projectDir) {
 }
 // src/lib/extension-import.ts
 import { existsSync as existsSync16 } from "node:fs";
-import { cp as cp4, mkdir as mkdir13, mkdtemp as mkdtemp2, readFile as readFile35, rm as rm5, writeFile as writeFile13 } from "node:fs/promises";
+import { cp as cp4, mkdir as mkdir13, mkdtemp as mkdtemp2, readFile as readFile34, rm as rm5, writeFile as writeFile13 } from "node:fs/promises";
 import { tmpdir as tmpdir2 } from "node:os";
 import path24 from "node:path";
 import { unzipSync } from "fflate";
@@ -13595,7 +13444,7 @@ async function finalizeExtensionImport(projectDir, sourceDir, relPaths, fallback
   if (!existsSync16(cssPath)) {
     throw new Error("A theme must contain a theme.css file.");
   }
-  const css = await readFile35(cssPath, "utf8");
+  const css = await readFile34(cssPath, "utf8");
   const { reject, warnings: printFindings } = classifyThemeCssFindings(checkCss(css, "theme.css"));
   if (reject) {
     throw new Error(`theme.css could not be parsed — ${reject.message}`);
@@ -13623,7 +13472,7 @@ async function finalizeExtensionImport(projectDir, sourceDir, relPaths, fallback
   for (let i = 0;i < extraSheets.length; i++) {
     const rel = extraSheets[i];
     const sheetPath = extraSheetPaths[i];
-    const sheetCss = await readFile35(sheetPath, "utf8");
+    const sheetCss = await readFile34(sheetPath, "utf8");
     const { reject: sheetReject, warnings: sheetFindings } = classifyThemeCssFindings(checkCss(sheetCss, rel));
     if (sheetReject) {
       throw new Error(`${rel} could not be parsed — ${sheetReject.message}`);
@@ -13656,7 +13505,7 @@ async function completeLandedManifest(dest, id, meta, metaExists) {
   let pkg = {};
   if (metaExists) {
     try {
-      const parsed = JSON.parse(await readFile35(file, "utf8"));
+      const parsed = JSON.parse(await readFile34(file, "utf8"));
       if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {
         pkg = parsed;
       }
@@ -13758,11 +13607,11 @@ async function importExtensionFromCssText(projectDir, css, name) {
 async function importExtensionFromFile(projectDir, filePath) {
   const ext = path24.extname(filePath).toLowerCase();
   if (ext === ".zip") {
-    const buf = await readFile35(filePath);
+    const buf = await readFile34(filePath);
     return importExtensionFromZip(projectDir, new Uint8Array(buf.buffer, buf.byteOffset, buf.byteLength));
   }
   if (ext === ".css") {
-    const css = await readFile35(filePath, "utf8");
+    const css = await readFile34(filePath, "utf8");
     return importExtensionFromCssText(projectDir, css, prettify(path24.basename(filePath, ".css")));
   }
   throw new Error("Choose a .zip extension package or a .css stylesheet.");
@@ -16143,7 +15992,7 @@ async function scorchedEarth(options) {
   }
 }
 // src/lib/publish/run-publish.ts
-import { readdir as readdir12, stat as stat12 } from "node:fs/promises";
+import { readdir as readdir12, stat as stat11 } from "node:fs/promises";
 import path33 from "node:path";
 
 // src/lib/publish/command-runner.ts
@@ -16374,7 +16223,7 @@ var drivethrurpgProvider = {
 };
 
 // src/lib/publish/providers/gdrive.ts
-import { mkdtemp as mkdtemp3, readFile as readFile36, readdir as readdir11, rm as rm9, stat as stat9, writeFile as writeFile16 } from "node:fs/promises";
+import { mkdtemp as mkdtemp3, readFile as readFile35, readdir as readdir11, rm as rm9, stat as stat8, writeFile as writeFile16 } from "node:fs/promises";
 import { tmpdir as tmpdir3 } from "node:os";
 import path30 from "node:path";
 import { Zip, ZipDeflate } from "fflate";
@@ -16766,12 +16615,12 @@ async function collectZipEntries(root, dir, out, onWarn) {
       await collectZipEntries(root, full, out, onWarn);
     } else if (entry.isFile()) {
       const rel = path30.relative(root, full).split(path30.sep).join("/");
-      out[rel] = await readFile36(full);
+      out[rel] = await readFile35(full);
     } else if (entry.isSymbolicLink()) {
-      const resolved = await stat9(full).catch(() => null);
+      const resolved = await stat8(full).catch(() => null);
       if (resolved?.isFile()) {
         const rel = path30.relative(root, full).split(path30.sep).join("/");
-        out[rel] = await readFile36(full);
+        out[rel] = await readFile35(full);
       } else if (resolved?.isDirectory()) {
         await collectZipEntries(root, full, out, onWarn);
       } else {
@@ -16841,7 +16690,7 @@ var gdriveProvider = {
       cleanup: async () => {}
     };
     try {
-      const artifactStat = await stat9(source.filePath);
+      const artifactStat = await stat8(source.filePath);
       const about = await driveAbout(fetchImpl, accessToken);
       if (about.quota.limitBytes != null && about.quota.freeBytes != null) {
         if (artifactStat.size > about.quota.freeBytes) {
@@ -16886,7 +16735,7 @@ var gdriveProvider = {
 };
 
 // src/lib/publish/butler.ts
-import { chmod as chmod2, mkdir as mkdir19, stat as stat10, writeFile as writeFile17 } from "node:fs/promises";
+import { chmod as chmod2, mkdir as mkdir19, stat as stat9, writeFile as writeFile17 } from "node:fs/promises";
 import path31 from "node:path";
 import { unzipSync as unzipSync2 } from "fflate";
 var BUTLER_DOWNLOAD_TIMEOUT_MS = 300000;
@@ -16907,7 +16756,7 @@ function butlerBinaryName(platform2 = process.platform) {
 }
 async function fileExists2(p) {
   try {
-    return (await stat10(p)).isFile();
+    return (await stat9(p)).isFile();
   } catch {
     return false;
   }
@@ -17150,7 +16999,7 @@ var kdpProvider = {
 };
 
 // src/lib/publish/providers/local-folder.ts
-import { cp as cp7, mkdir as mkdir20, stat as stat11 } from "node:fs/promises";
+import { cp as cp7, mkdir as mkdir20, stat as stat10 } from "node:fs/promises";
 import path32 from "node:path";
 var LOCAL_PUBLISH_DEFAULT_DIR = "dist";
 var info8 = {
@@ -17177,7 +17026,7 @@ var localFolderProvider = {
   async preflight(req) {
     const dir = localPublishDir(req);
     try {
-      const s = await stat11(dir);
+      const s = await stat10(dir);
       if (!s.isDirectory()) {
         return [
           { severity: "error", id: "local/not-a-folder", message: `${dir} exists but is not a folder.` }
@@ -17472,7 +17321,7 @@ var PDF_HINT = "Build the PDF first (gutterpress build, or export it from the ap
 var HTML_HINT = "Build the website export first (gutterpress build --format html).";
 async function artifactIssues(artifact) {
   try {
-    const s = await stat12(artifact.path);
+    const s = await stat11(artifact.path);
     if (artifact.format === "pdf" && !s.isFile()) {
       return [
         {
@@ -17518,7 +17367,7 @@ async function artifactIssues(artifact) {
 var BUILD_FINGERPRINT_FILENAME = "build-fingerprint.json";
 async function htmlDirIssues(dir) {
   const issues = [];
-  const isThere = async (rel) => stat12(path33.join(dir, rel)).then(() => true, () => false);
+  const isThere = async (rel) => stat11(path33.join(dir, rel)).then(() => true, () => false);
   if (!await isThere(BOOK_HTML)) {
     issues.push({
       severity: "error",
@@ -17637,7 +17486,7 @@ async function disconnectPublishCredential(key, deps, options = {}) {
   }
 }
 // src/lib/publish/selections.ts
-import { chmod as chmod3, mkdir as mkdir21, readFile as readFile37, writeFile as writeFile18 } from "node:fs/promises";
+import { chmod as chmod3, mkdir as mkdir21, readFile as readFile36, writeFile as writeFile18 } from "node:fs/promises";
 import path34 from "node:path";
 class PublishSelectionsStore {
   filePath;
@@ -17647,7 +17496,7 @@ class PublishSelectionsStore {
   }
   async read() {
     try {
-      const raw = await readFile37(this.filePath, "utf8");
+      const raw = await readFile36(this.filePath, "utf8");
       const parsed = JSON.parse(raw);
       if (parsed && typeof parsed === "object") {
         return {