gutterpress 0.11.20-alpha.2 → 0.11.20-alpha.4

package/dist/{cli-zacevwcy.js → cli-0ey902sx.js}

@@ -6,20 +6,22 @@ import {
   defaultConfigDir,
   error,
   findPostScriptShadingPages,
-  hasLiveTransparency,
+  flattenTransparentPages,
   info,
   log,
+  planTransparentPages,
   resolveGhostscript,
   setLogLevel,
   stampCreator,
   stripAnnotations,
+  transparentPages,
   warn
-} from "./cli-gh0ym80r.js";
+} from "./cli-h4tfmpg3.js";
 import {
   DEBOUNCE,
   UsageError,
   resolvePort
-} from "./cli-7z29z4wz.js";
+} from "./cli-fmksazej.js";
 import {
   blackTextToGray
 } from "./cli-ht1bcqdd.js";
@@ -28,11 +30,24 @@ import {
   getAssetPath,
   getAssetsDir,
   lastPageMode
-} from "./cli-j802s31j.js";
+} from "./cli-61vd4ews.js";
 import {
   BuildError,
   EXIT_CODES
 } from "./cli-46ycxe6r.js";
+import {
+  countLinkAnnotations,
+  getImageResolutions,
+  getOpPass,
+  getOutlineCount,
+  getPageLabels,
+  getPageSize,
+  getTextPass,
+  isLoadable,
+  loadPdf,
+  pageHasMarks,
+  retainPdfCache
+} from "./cli-sth219v1.js";
 import {
   INSTALL_HINTS,
   execCapture,
@@ -122,6 +137,8 @@ var DTRPG_PRESET = {
     icc: "profiles/CGATS21_CRPC1.icc",
     stripAnnotations: true,
     blackText: "k-only",
+    transparency: "flatten-page",
+    flattenPages: [],
     rasterDpi: undefined
   },
   page: {
@@ -207,6 +224,8 @@ var BOOK_PRESET = {
     icc: "profiles/CGATS21_CRPC1.icc",
     stripAnnotations: true,
     blackText: "icc",
+    transparency: "flatten-page",
+    flattenPages: [],
     rasterDpi: undefined
   },
   page: {
@@ -606,6 +625,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)}.`);
@@ -674,6 +701,7 @@ function resolveDeclaredStyles(rawStyles, baseDir, subject) {
 // src/lib/extension-manifest.ts
 import { readFile as readFile2 } from "node:fs/promises";
 import path from "node:path";
+import { satisfies, validRange } from "semver";
 var EXTENSION_MANIFEST_FILENAME = "package.json";
 var GUTTERPRESS_KEY = "gutterpress";
 function object(value) {
@@ -697,6 +725,7 @@ function metaFromPackageJson(raw) {
     ...str(pkg.description) ? { description: str(pkg.description) } : {},
     ...keywords ? { keywords } : {},
     ...str(pkg.main) ? { main: str(pkg.main) } : {},
+    ...str(object(pkg.engines)?.gutterpress) ? { gutterpressRange: str(object(pkg.engines)?.gutterpress) } : {},
     ..."preview" in gp ? { preview: str(gp.preview) ?? null } : {},
     ...Array.isArray(gp.styles) ? { styles: declaredList(gp.styles) } : {},
     ...str(gp.tokensFile) ? { tokensFile: str(gp.tokensFile) } : {},
@@ -733,6 +762,17 @@ function extensionCarries(meta) {
 function pathEscapesFolder(rel) {
   return path.isAbsolute(rel) || rel.split(/[\\/]/).includes("..");
 }
+function assertSupportsThisGutterpress(meta, ref) {
+  const range = meta.gutterpressRange;
+  if (range === undefined)
+    return;
+  if (!validRange(range)) {
+    throw new Error(`Extension "${ref}" has an invalid engines.gutterpress range "${range}".`);
+  }
+  if (!satisfies(PACKAGE_VERSION, range, { includePrerelease: true })) {
+    throw new Error(`Extension "${ref}" needs Gutterpress ${range} (its package.json engines.gutterpress); ` + `this is Gutterpress ${PACKAGE_VERSION}. Update Gutterpress, or pin an older version of the extension.`);
+  }
+}
 function assertExtensionContained(meta) {
   if (meta.engineStyles !== undefined) {
     throw new Error("The extension's metadata declares `engineStyles`, which was removed — " + "move its entries to the end of `styles`.");
@@ -2004,7 +2044,9 @@ var GUTTERPRESS_CSS = `
    cap at equal specificity */
 .gp-small { width: 25%; max-width: 100%; }
 .gp-medium { width: 50%; max-width: 100%; }
-.gp-large { width: 75%; max-width: 100%; }
+.gp-large { width: 60%; max-width: 100%; }
+.gp-xl { width: 80%; max-width: 100%; }
+.gp-xxl { width: 90%; max-width: 100%; }
 
 /* float clearance presets — consumed by var(--gp-gap) in the float rules
    above and by .gp-shape's shape-margin below; --gp-gap itself is
@@ -2062,10 +2104,16 @@ img.gp-shape {
 }
 
 /* pin — within the nearest positioned ancestor (.page/.spread, rule above).
-   inset:0 and the explicit centers are load-bearing; see doctrine comment. */
+   The four insets are the pin box: 0 (the text block's edge) unless an
+   engine set --gp-pin-<edge> on the page root for an edge a pin uses (the
+   art-safe line). Non-auto insets and the explicit centers are
+   load-bearing; see doctrine comment. */
 .gp-pin {
   position: absolute;
-  inset: 0;
+  top: var(--gp-pin-top, 0px);
+  right: var(--gp-pin-right, 0px);
+  bottom: var(--gp-pin-bottom, 0px);
+  left: var(--gp-pin-left, 0px);
   align-self: center;
   justify-self: center;
   margin: 0;
@@ -2080,6 +2128,16 @@ img.gp-shape {
 .gp-left { justify-self: start; }
 .gp-right { justify-self: end; }
 
+/* the escape hatch — the paper's edge, past the printer's safe area: the
+   pin box loses its art-safe insets. Set on the pin itself, so it beats the
+   values the page root hands down. */
+.gp-pin.gp-flush {
+  --gp-pin-top: 0px;
+  --gp-pin-right: 0px;
+  --gp-pin-bottom: 0px;
+  --gp-pin-left: 0px;
+}
+
 /* wrapper-margin neutralization (same pattern and rationale as the
    .gp-bleed paragraph-margin note in the doctrine comment; for pin, the
    emptied paragraph would otherwise leave a phantom margin gap in flow) */
@@ -2189,6 +2247,8 @@ var GP_CLASSES = new Set([
   "gp-small",
   "gp-medium",
   "gp-large",
+  "gp-xl",
+  "gp-xxl",
   "gp-tight",
   "gp-loose",
   "gp-columns",
@@ -2205,6 +2265,7 @@ var GP_CLASSES = new Set([
   "gp-pin",
   "gp-top",
   "gp-bottom",
+  "gp-flush",
   "gp-behind",
   "gp-base",
   "gp-raised",
@@ -2218,8 +2279,7 @@ var GP_CLASSES = new Set([
   "gp-alert-caution",
   "gp-page-break",
   "gp-column-break",
-  "gp-continued",
-  "gp-flush"
+  "gp-continued"
 ]);
 
 // src/lib/markdown/gp-pin-scope.js
@@ -2256,6 +2316,21 @@ function hasPinClass(token) {
   const cls = token.attrGet && token.attrGet("class");
   return typeof cls === "string" && cls.split(/\s+/).includes("gp-pin");
 }
+var PIN_EDGES = ["gp-top", "gp-right", "gp-bottom", "gp-left"];
+var FLUSH_ART_MSG = "`.gp-flush` puts this image on the paper's edge, past the printer's safe area. Printers trim up to 0.125in there, so keep it for art that is meant to bleed off the page.";
+function checkFlushArt(token, env, line) {
+  if (token.type !== "image")
+    return;
+  const cls = token.attrGet && token.attrGet("class");
+  if (typeof cls !== "string")
+    return;
+  const classes = cls.split(/\s+/);
+  if (!classes.includes("gp-pin") || !classes.includes("gp-flush"))
+    return;
+  if (!classes.some((c) => PIN_EDGES.includes(c)))
+    return;
+  warn3(env, line, "flush_art", FLUSH_ART_MSG);
+}
 function elementNameFor(token) {
   switch (token.type) {
     case "layout_chapter_open":
@@ -2315,6 +2390,7 @@ function gpPinScope(md) {
       if (token.type === "inline" && token.children) {
         for (const child of token.children) {
           checkUnknownGpClasses(child, state.env, line);
+          checkFlushArt(child, state.env, line);
         }
       }
     }
@@ -3342,6 +3418,7 @@ This folder still has a ${stale}. Gutterpress no longer reads it — ` + `descri
 async function loadExtensionFromDir(extensionDir, config, pluginRef) {
   const meta = await readExtensionMeta(extensionDir);
   assertExtensionContained(meta);
+  assertSupportsThisGutterpress(meta, pluginRef);
   const resolved = resolveExtension(extensionDir, meta, `Plugin "${pluginRef}"`);
   const extensionStyles = resolved.styles ?? [];
   const name = config.name ?? meta.name ?? pluginRef;
@@ -3416,6 +3493,7 @@ async function loadPlugin(config, baseDir) {
       if (loaded.packageDir) {
         const meta = await readExtensionMeta(loaded.packageDir);
         assertExtensionContained(meta);
+        assertSupportsThisGutterpress(meta, pluginRef);
         const resolved = resolveExtension(loaded.packageDir, { ...meta, main: undefined }, `Plugin "${pluginRef}"`);
         if (resolved.markdown && loaded.entryPath && resolve3(resolved.markdown) !== resolve3(loaded.entryPath)) {
           throw new Error(`its package.json declares gutterpress.markdown "${meta.markdown}" but the package entry is "${relative(loaded.packageDir, loaded.entryPath)}" — an npm extension's ` + "markdown-it plugin is its package entry, so declare that file or drop the field.");
@@ -3539,7 +3617,7 @@ import path3 from "node:path";
 import { Transform } from "node:stream";
 import { pipeline } from "node:stream/promises";
 import { createGunzip } from "node:zlib";
-import { maxSatisfying, satisfies, validRange } from "semver";
+import { maxSatisfying, satisfies as satisfies2, validRange as validRange2 } from "semver";
 
 // src/lib/fetch-timeout.ts
 class FetchPassthroughError extends Error {
@@ -3780,7 +3858,7 @@ async function selectPackage(ctx, name, selector) {
     version = selector;
   } else if (typeof tags[selector] === "string") {
     version = tags[selector];
-  } else if (validRange(selector)) {
+  } else if (validRange2(selector)) {
     version = maxSatisfying(Object.keys(versions), selector) ?? undefined;
   }
   if (!version || !isExactNpmVersion(version)) {
@@ -3998,7 +4076,7 @@ async function installPackage(ctx, name, selector, parentPackagePath, ancestors,
     }
     throw error2;
   }
-  const ancestor = ancestors.find((candidate) => candidate.name === name && (candidate.version === selected.version || (selector ? satisfies(candidate.version, selector) : false)));
+  const ancestor = ancestors.find((candidate) => candidate.name === name && (candidate.version === selected.version || (selector ? satisfies2(candidate.version, selector) : false)));
   if (ancestor)
     return { path: ancestor.path };
   if (ctx.records.length >= ctx.limits.totalPackages) {
@@ -4899,346 +4977,6 @@ function inspectionFailed(checkId, message, extra = {}) {
   };
 }
 
-// src/lib/pdf-inspect.ts
-import { stat as stat2, readFile as readFile7 } 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(path6) {
-  let st;
-  try {
-    st = await stat2(path6);
-  } catch {
-    return null;
-  }
-  const hit = docCache.get(path6);
-  if (hit && hit.mtimeMs === st.mtimeMs && hit.size === st.size) {
-    docCache.delete(path6);
-    docCache.set(path6, hit);
-    try {
-      return await hit.doc;
-    } catch {
-      return null;
-    }
-  }
-  if (hit)
-    destroyEntry(hit);
-  const docPromise = readFile7(path6).then((buf) => getDocumentProxy(new Uint8Array(buf)));
-  docCache.delete(path6);
-  docCache.set(path6, { mtimeMs: st.mtimeMs, size: st.size, doc: docPromise });
-  evictLru();
-  try {
-    return await docPromise;
-  } catch {
-    if (docCache.get(path6)?.doc === docPromise)
-      docCache.delete(path6);
-    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((resolve4) => {
-    let done = false;
-    const finish = (v) => {
-      if (!done) {
-        done = true;
-        resolve4(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 check = {
   id: "pdf.structure.qpdf",
@@ -5513,9 +5251,9 @@ var check4 = {
 registerCheck(check4);
 
 // src/lib/pdf-parse.ts
-import { readFile as readFile8 } from "node:fs/promises";
+import { readFile as readFile7 } from "node:fs/promises";
 async function readPdfBytes(pdfPath) {
-  return readFile8(pdfPath, "latin1");
+  return readFile7(pdfPath, "latin1");
 }
 function parseInkCov(out) {
   const lines = out.split(/\r?\n/).filter((l) => l.includes("CMYK"));
@@ -5776,7 +5514,7 @@ var check8 = {
 registerCheck(check8);
 
 // src/checks/pdf/black-text.ts
-import { readFile as readFile9 } from "node:fs/promises";
+import { readFile as readFile8 } from "node:fs/promises";
 var check9 = {
   id: "pdf.print.black-text",
   name: "Black Text",
@@ -5789,7 +5527,7 @@ var check9 = {
       return [];
     try {
       const { findRichBlackText, LARGE_TEXT_PT } = await import("./black-text-gray-7dz61456.js");
-      const found = await findRichBlackText(await readFile9(ctx.pdfPath));
+      const found = await findRichBlackText(await readFile8(ctx.pdfPath));
       if (found.runs === 0)
         return [];
       return [
@@ -6178,7 +5916,7 @@ var check18 = {
 registerCheck(check18);
 
 // src/checks/source/markdownlint.ts
-import { readFile as readFile10 } from "node:fs/promises";
+import { readFile as readFile9 } from "node:fs/promises";
 import { lint } from "markdownlint/sync";
 import { parse as parseYaml2 } from "yaml";
 
@@ -6211,7 +5949,7 @@ function stripJsonComments(s) {
   return s.replace(/\/\*[\s\S]*?\*\//g, "").replace(/(^|[^:])\/\/.*$/gm, "$1");
 }
 async function loadConfig(configPath) {
-  const raw = await readFile10(configPath, "utf8");
+  const raw = await readFile9(configPath, "utf8");
   let parsed;
   if (configPath.endsWith(".json")) {
     parsed = JSON.parse(raw);
@@ -6272,7 +6010,7 @@ registerCheck(check19);
 
 // src/checks/source/htmlhint.ts
 import { existsSync as existsSync7 } from "node:fs";
-import { readFile as readFile11 } from "node:fs/promises";
+import { readFile as readFile10 } from "node:fs/promises";
 import htmlhint from "htmlhint";
 var { HTMLHint } = htmlhint;
 var CONFIG_NAMES2 = [".htmlhintrc"];
@@ -6292,8 +6030,8 @@ var check20 = {
     const resolvedConfig = findConfigFile(ctx.inputDir, CONFIG_NAMES2, configPath);
     if (!resolvedConfig && !configPath)
       return [];
-    const ruleset = resolvedConfig ? JSON.parse(await readFile11(resolvedConfig, "utf8")) : HTMLHint.defaultRuleset;
-    const html = await readFile11(ctx.htmlPath, "utf8");
+    const ruleset = resolvedConfig ? JSON.parse(await readFile10(resolvedConfig, "utf8")) : HTMLHint.defaultRuleset;
+    const html = await readFile10(ctx.htmlPath, "utf8");
     const messages = HTMLHint.verify(html, ruleset);
     return messages.map((m) => ({
       checkId: check20.id,
@@ -6308,7 +6046,7 @@ var check20 = {
 registerCheck(check20);
 
 // src/checks/source/stylelint.ts
-import { readFile as readFile12 } from "node:fs/promises";
+import { readFile as readFile11 } from "node:fs/promises";
 
 // src/lib/printsafe.ts
 import postcss from "postcss";
@@ -6650,7 +6388,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)) {
@@ -6715,7 +6453,7 @@ var check21 = {
     for (const file of files) {
       let css;
       try {
-        css = await readFile12(file, "utf8");
+        css = await readFile11(file, "utf8");
       } catch (err) {
         results.push({
           checkId: check21.id,
@@ -6742,7 +6480,7 @@ var check21 = {
 registerCheck(check21);
 
 // src/checks/source/css-ownership.ts
-import { readFile as readFile13 } from "node:fs/promises";
+import { readFile as readFile12 } from "node:fs/promises";
 
 // src/lib/style-resolver.ts
 import { existsSync as existsSync8 } from "node:fs";
@@ -6810,7 +6548,7 @@ import postcss2 from "postcss";
 import { parse as parseYaml3 } from "yaml";
 var CONFIG_NAMES3 = [".gutterpress/css-contract.yaml", ".gutterpress/css-contract.yml"];
 async function loadContract(configPath) {
-  const raw = await readFile13(configPath, "utf8");
+  const raw = await readFile12(configPath, "utf8");
   const parsed = parseYaml3(raw);
   if (parsed && typeof parsed === "object")
     return parsed;
@@ -6961,7 +6699,7 @@ var check22 = {
         continue;
       let css;
       try {
-        css = await readFile13(absFile, "utf8");
+        css = await readFile12(absFile, "utf8");
       } catch {
         continue;
       }
@@ -7008,7 +6746,7 @@ import { dirname as dirname3, resolve as resolve5 } from "node:path";
 
 // src/lib/asset-inline.ts
 import { createHash as createHash2 } from "node:crypto";
-import { readFile as readFile14 } from "node:fs/promises";
+import { readFile as readFile13 } from "node:fs/promises";
 import path7 from "node:path";
 import postcss3 from "postcss";
 var FONT_EXTS = new Set([".woff2", ".woff", ".ttf", ".otf"]);
@@ -7073,7 +6811,7 @@ function mimeFor(ext) {
 }
 async function readOrThrow(absPath, kind, referencedFrom) {
   try {
-    return await readFile14(absPath);
+    return await readFile13(absPath);
   } catch {
     throw new BuildError(`Missing ${kind}: ${absPath}
   referenced from ${referencedFrom}
@@ -7216,7 +6954,7 @@ async function collectStyleDependencies(projectDir, stylePaths) {
     found.add(abs);
     let source;
     try {
-      source = await readFile14(abs, "utf-8");
+      source = await readFile13(abs, "utf-8");
     } catch {
       return;
     }
@@ -7293,7 +7031,7 @@ async function inlineShapeUrls(html, baseDir) {
       continue;
     let bytes;
     try {
-      bytes = await readFile14(abs);
+      bytes = await readFile13(abs);
     } catch {
       continue;
     }
@@ -7311,7 +7049,7 @@ async function inlineShapeUrls(html, baseDir) {
 }
 
 // src/checks/source/local-ref-parser.ts
-import { readFile as readFile15 } from "node:fs/promises";
+import { readFile as readFile14 } from "node:fs/promises";
 function newlineOffsets(content) {
   const offsets = [];
   for (let i = 0;i < content.length; i++)
@@ -7380,7 +7118,7 @@ async function* renderedLocalRefs(ctx, checkId, results) {
   for (const file of files) {
     let refs;
     try {
-      refs = collectRenderedLocalRefs(await readFile15(file, "utf8"));
+      refs = collectRenderedLocalRefs(await readFile14(file, "utf8"));
     } catch {
       results.push(inspectionFailed(checkId, `Could not read source file: ${file}`, { file }));
       continue;
@@ -7731,7 +7469,7 @@ var check24 = {
 registerCheck(check24);
 
 // src/checks/source/accessibility-alt-text.ts
-import { readFile as readFile16 } from "node:fs/promises";
+import { readFile as readFile15 } from "node:fs/promises";
 var check25 = {
   id: "source.accessibility.alt-text",
   name: "Image Alt Text",
@@ -7745,7 +7483,7 @@ var check25 = {
     const results = [];
     for (const file of files) {
       try {
-        const content = await readFile16(file, "utf8");
+        const content = await readFile15(file, "utf8");
         const lines = content.split(`
 `);
         let inFence = false;
@@ -7789,7 +7527,7 @@ function extractImageAlts(line) {
 registerCheck(check25);
 
 // src/checks/source/accessibility-heading-order.ts
-import { readFile as readFile17 } from "node:fs/promises";
+import { readFile as readFile16 } from "node:fs/promises";
 var check26 = {
   id: "source.accessibility.heading-order",
   name: "Heading Order",
@@ -7803,7 +7541,7 @@ var check26 = {
     const results = [];
     for (const file of files) {
       try {
-        const content = await readFile17(file, "utf8");
+        const content = await readFile16(file, "utf8");
         const lines = content.split(`
 `);
         let inFence = false;
@@ -7845,7 +7583,7 @@ var check26 = {
 registerCheck(check26);
 
 // src/checks/source/layout-markers.ts
-import { readFile as readFile18 } from "node:fs/promises";
+import { readFile as readFile17 } from "node:fs/promises";
 
 // src/lib/unknown-classes.ts
 import postcss4 from "postcss";
@@ -7948,7 +7686,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 readFile18(sheet, "utf8"), names);
+      addCssClasses(await readFile17(sheet, "utf8"), names);
     } catch {}
   }
   return names;
@@ -7972,7 +7710,7 @@ var check27 = {
     const knownClasses = () => known ??= collectKnownClasses(ctx, plugins);
     for (const file of files) {
       try {
-        const content = await readFile18(file, "utf8");
+        const content = await readFile17(file, "utf8");
         const env = {};
         const tokens = md.parse(content, env);
         md.renderer.render(tokens, md.options, env);
@@ -8012,7 +7750,7 @@ var check27 = {
 registerCheck(check27);
 
 // src/checks/source/merge-markers.ts
-import { readFile as readFile19 } from "node:fs/promises";
+import { readFile as readFile18 } from "node:fs/promises";
 import path9 from "node:path";
 
 // src/checks/asset/extensions.ts
@@ -8054,7 +7792,7 @@ var check28 = {
     for (const file of textFiles) {
       let content;
       try {
-        content = await readFile19(file, "utf8");
+        content = await readFile18(file, "utf8");
       } catch {
         results.push(inspectionFailed(check28.id, `Could not read source file: ${file}`, { file }));
         continue;
@@ -8114,7 +7852,7 @@ var check28 = {
 registerCheck(check28);
 
 // src/checks/source/characters.ts
-import { readFile as readFile20 } from "node:fs/promises";
+import { readFile as readFile19 } 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");
@@ -8237,7 +7975,7 @@ var check29 = {
     for (const file of (ctx.markdownFiles ?? []).slice().sort()) {
       let content;
       try {
-        content = await readFile20(file, "utf8");
+        content = await readFile19(file, "utf8");
       } catch {
         results.push(inspectionFailed(check29.id, `Could not read source file: ${file}`, { file }));
         continue;
@@ -8277,16 +8015,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 readFile21 } from "node:fs/promises";
+import { stat as stat2, readFile as readFile20 } from "node:fs/promises";
 var DEFAULT_DPI = 72;
 var cache = new Map;
 async function inspectImage(path10) {
   let st;
   try {
-    st = await stat3(path10);
+    st = await stat2(path10);
   } catch {
     return null;
   }
@@ -8295,7 +8033,7 @@ async function inspectImage(path10) {
     return hit.info;
   let info3 = null;
   try {
-    const buf = await readFile21(path10);
+    const buf = await readFile20(path10);
     info3 = parseImage(buf);
   } catch {
     info3 = null;
@@ -8517,7 +8255,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);
@@ -8855,7 +8593,7 @@ var check37 = {
 registerCheck(check37);
 
 // src/checks/heuristic/section-density.ts
-import { readFile as readFile22 } from "node:fs/promises";
+import { readFile as readFile21 } from "node:fs/promises";
 var check38 = {
   id: "heuristic.chunking.section-density",
   name: "Section Density",
@@ -8872,7 +8610,7 @@ var check38 = {
     const results = [];
     for (const file of files) {
       try {
-        const content = await readFile22(file, "utf8");
+        const content = await readFile21(file, "utf8");
         const lines = content.split(`
 `);
         let currentSectionStart = 0;
@@ -9176,7 +8914,7 @@ async function restoreForCommand(dir, options) {
 }
 
 // src/lib/markdown/index.ts
-import { readdir as readdir3, readFile as readFile23, writeFile as writeFile2, mkdir as mkdir4 } from "node:fs/promises";
+import { readdir as readdir3, readFile as readFile22, writeFile as writeFile2, mkdir as mkdir4 } from "node:fs/promises";
 
 // src/lib/remote-auth/sync-messages.ts
 function isOnlineSibling(filepath) {
@@ -9198,6 +8936,20 @@ function canonicalChapterId(p) {
   return s;
 }
 
+// src/engine/shared/print-area.ts
+function printAreaMeta(page) {
+  const area = JSON.stringify({
+    width: page.width,
+    height: page.height,
+    bleed: page.bleed ?? 0,
+    safe: page.safe ?? 0,
+    artSafe: page.artSafe,
+    preset: page.preset,
+    spec: page.spec
+  });
+  return `<meta name="gp-print-area" content='${area.replace(/&/g, "&amp;").replace(/'/g, "&#39;")}'>`;
+}
+
 // src/lib/markdown/assemble.ts
 async function assembleBookHtml(opts) {
   const title = opts.title ?? "Document";
@@ -9263,7 +9015,8 @@ ${projectCss.trim()}` : null
 <html lang="en"${printAttrs}>
 <head>
   <meta charset="UTF-8">
-  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">${opts.printArea ? `
+  ${printAreaMeta(opts.printArea)}` : ""}
   <title>${title}</title>${preloadTags}
   <style data-project-css>
 ${inlineCss}
@@ -9318,11 +9071,12 @@ ${css.trim()}
   }
   return assembleBookHtml({
     files,
-    readText: (relPath) => readFile23(join2(inputDir, canonicalChapterId(relPath)), "utf-8"),
+    readText: (relPath) => readFile22(join2(inputDir, canonicalChapterId(relPath)), "utf-8"),
     projectCss: inlined.css,
     preloadImages: cssAssetCopies.map((c) => c.to),
     title: opts.title,
     print: opts.print,
+    printArea: opts.printArea,
     plugins: opts.plugins,
     pluginCss,
     annotateSourceChapters: opts.annotateSourceChapters,
@@ -9335,6 +9089,7 @@ async function renderChaptersToFile(inputDir, outDir, opts = {}) {
   const html = await renderChapters(inputDir, {
     title: opts.title,
     print: opts.print,
+    printArea: opts.printArea,
     styles: opts.styles,
     files: opts.files,
     plugins: opts.plugins,
@@ -9350,7 +9105,7 @@ async function renderChaptersToFile(inputDir, outDir, opts = {}) {
 }
 
 // src/lib/markdownlint-fix.ts
-import { readFile as readFile24, writeFile as writeFile3 } from "node:fs/promises";
+import { readFile as readFile23, writeFile as writeFile3 } from "node:fs/promises";
 import { applyFixes } from "markdownlint";
 import { lint as lint2 } from "markdownlint/sync";
 async function uncommittedAmong(inputDir, files) {
@@ -9390,7 +9145,7 @@ async function applyMarkdownlintFixes(ctx) {
   for (const [file, violations] of Object.entries(results)) {
     if (!Array.isArray(violations) || violations.length === 0)
       continue;
-    const before = await readFile24(file, "utf8");
+    const before = await readFile23(file, "utf8");
     const after = applyFixes(before, violations);
     if (after !== before)
       pending.push({ file, content: after });
@@ -9903,7 +9658,7 @@ import { randomBytes } from "node:crypto";
 
 // src/lib/build-fingerprint.ts
 import * as fs from "node:fs";
-import { mkdir as mkdir5, readFile as readFile25, writeFile as writeFile4 } from "node:fs/promises";
+import { mkdir as mkdir5, readFile as readFile24, writeFile as writeFile4 } from "node:fs/promises";
 import { createHash as createHash4 } from "node:crypto";
 import path12 from "node:path";
 import git from "isomorphic-git";
@@ -9990,8 +9745,8 @@ async function getEngineBundleHash() {
       getAssetPath("engine/gutterpress-agent.js")
     ]);
     const [viewerBytes, agentBytes] = await Promise.all([
-      readFile25(viewerPath),
-      readFile25(agentPath)
+      readFile24(viewerPath),
+      readFile24(agentPath)
     ]);
     const hash = createHash4("sha256");
     hash.update(viewerBytes);
@@ -10054,7 +9809,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 ? path12.resolve(input.recordedOutputDir) : outputDir
     },
@@ -10209,6 +9967,7 @@ async function renderBook(ctx) {
   const htmlFile = await renderChaptersToFile(renderDir, workDir, {
     title: config.title,
     print: config.print,
+    printArea: { ...config.page, preset: config.preset, spec: config.spec },
     styles: config.styles,
     files: config.source.files,
     plugins,
@@ -10361,7 +10120,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-9xb1ky8d.js");
+      const { buildNativePdf } = await import("./engine-67f68bxs.js");
       const engineDiagnostics = await buildNativePdf(htmlFile, rawPdf, {
         title: config.title,
         author: config.authors.length > 0 ? config.authors.join(", ") : undefined,
@@ -10383,12 +10142,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}`);
+        }
+        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 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.");
+        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;
@@ -10431,7 +10218,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 {
@@ -10468,6 +10258,35 @@ 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/lib/open-path.ts
 import { spawn } from "node:child_process";
@@ -10501,7 +10320,7 @@ function openPath(filePath) {
 import path16 from "path";
 import { tmpdir } from "os";
 import { randomBytes as randomBytes2 } from "crypto";
-import { readdir as readdir4, readFile as readFile26, writeFile as writeFile5 } from "node:fs/promises";
+import { readdir as readdir4, readFile as readFile25, writeFile as writeFile5 } from "node:fs/promises";
 
 // src/utils/file-utils.ts
 import { promises as fs3 } from "fs";
@@ -10604,6 +10423,7 @@ async function renderPreviewBook(inputPath, config, opts) {
   return renderChapters(inputPath, {
     title: config.title ?? "Document",
     print: config.print,
+    printArea: config.printArea,
     styles: config.styles,
     files: opts.files,
     plugins,
@@ -10618,19 +10438,8 @@ async function renderPreviewBook(inputPath, config, opts) {
     }
   });
 }
-function injectPreviewScripts(html, page) {
-  const area = page ? JSON.stringify({
-    width: page.width,
-    height: page.height,
-    bleed: page.bleed ?? 0,
-    safe: page.safe ?? 0,
-    artSafe: page.artSafe,
-    preset: page.preset,
-    spec: page.spec
-  }) : "";
-  const meta = area ? `  <meta name="gp-print-area" content='${area.replace(/&/g, "&amp;").replace(/'/g, "&#39;")}'>
-` : "";
-  const scripts = meta + `  <script src="/engine/gutterpress-viewer.js"></script>
+function injectPreviewScripts(html) {
+  const scripts = `  <script src="/engine/gutterpress-viewer.js"></script>
   ` + `<script src="/preview/scripts/preview-interface.js"></script>
   ` + `<script src="/preview/scripts/preview-bridge.js"></script>
 `;
@@ -10645,7 +10454,10 @@ async function generateAndWriteHtml(inputPath, tempDir, config, cssAssets, image
   }
   const nextAssets = new Map;
   const nextImageRefs = new Set;
-  const html = await renderPreviewBook(inputPath, config, {
+  const html = await renderPreviewBook(inputPath, {
+    ...config,
+    printArea: config.page && { ...config.page, preset: config.preset, spec: config.spec }
+  }, {
     files: config.source?.files ?? null,
     onCssAssets: (copies) => {
       for (const copy of copies)
@@ -10664,7 +10476,7 @@ async function generateAndWriteHtml(inputPath, tempDir, config, cssAssets, image
     for (const ref of nextImageRefs)
       imageRefs.add(ref);
   }
-  await fsp3.writeFile(path15.join(tempDir, BOOK_HTML_FILENAME), injectPreviewScripts(html, config.page && { ...config.page, preset: config.preset, spec: config.spec }), "utf-8");
+  await fsp3.writeFile(path15.join(tempDir, BOOK_HTML_FILENAME), injectPreviewScripts(html), "utf-8");
 }
 function isDotPathUnderRoot(candidatePath, root) {
   const normalizedRoot = root.replace(/\\/g, "/").replace(/\/+$/, "");
@@ -11062,7 +10874,7 @@ async function cleanupOrphanTempDirs() {
     const dir = path16.join(TEMP_DIR_BASE, entry);
     const pidFile = path16.join(dir, PID_FILE_NAME);
     try {
-      const raw = await readFile26(pidFile, "utf8");
+      const raw = await readFile25(pidFile, "utf8");
       const pid = parseInt(raw.trim(), 10);
       if (!isProcessAlive(pid)) {
         debug(`Removing orphan temp dir ${dir} (pid ${pid} not alive)`);
@@ -11169,7 +10981,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 readFile27, stat as stat5 } from "node:fs/promises";
+import { readFile as readFile26, stat as stat4 } from "node:fs/promises";
 import path17 from "path";
 import { WebSocket, WebSocketServer } from "ws";
 var HMR_PATH = "/__gutterpress-hmr";
@@ -11228,7 +11040,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 {
@@ -11238,7 +11050,7 @@ async function serveStatic(absPath, res, cacheControl = "no-store", extraHeaders
   }
   let data;
   try {
-    data = await readFile27(filePath);
+    data = await readFile26(filePath);
   } catch {
     res.writeHead(404);
     res.end("Not Found");
@@ -11267,7 +11079,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;
@@ -11287,7 +11099,7 @@ async function serveRevalidatedStatic(req, absPath, res, validators) {
   let data;
   if (!validator || validator.stamp !== stamp) {
     try {
-      data = await readFile27(absPath);
+      data = await readFile26(absPath);
     } catch {
       await serveStatic(absPath, res);
       return;
@@ -11315,7 +11127,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";
@@ -11597,7 +11409,7 @@ async function startPreviewServer(options) {
 }
 
 // src/lib/project-scaffold.ts
-import { access, copyFile, cp as cp2, mkdir as mkdir7, readdir as readdir5, readFile as readFile28, stat as stat6, writeFile as writeFile6 } from "node:fs/promises";
+import { access, copyFile, cp as cp2, mkdir as mkdir7, readdir as readdir5, readFile as readFile27, stat as stat5, writeFile as writeFile6 } from "node:fs/promises";
 import { constants as FS, existsSync as existsSync12 } from "node:fs";
 import path18 from "node:path";
 
@@ -11796,7 +11608,7 @@ async function scaffoldProject(options) {
 async function firstSourceFile(manifestPath) {
   let text;
   try {
-    text = await readFile28(manifestPath, "utf8");
+    text = await readFile27(manifestPath, "utf8");
   } catch {
     return;
   }
@@ -11808,7 +11620,7 @@ async function firstSourceFile(manifestPath) {
   return m ? m[1].trim() : undefined;
 }
 async function fillTemplateFile(filePath, substitutions) {
-  let text = await readFile28(filePath, "utf8");
+  let text = await readFile27(filePath, "utf8");
   for (const [token, value] of Object.entries(substitutions)) {
     text = text.split(token).join(value);
   }
@@ -11816,7 +11628,7 @@ async function fillTemplateFile(filePath, substitutions) {
 }
 
 // src/lib/extension-scaffold.ts
-import { access as access2, mkdir as mkdir8, readFile as readFile29, writeFile as writeFile7 } from "node:fs/promises";
+import { access as access2, mkdir as mkdir8, readFile as readFile28, writeFile as writeFile7 } from "node:fs/promises";
 import { constants as FS2 } from "node:fs";
 import path19 from "node:path";
 var EXTENSION_KINDS = ["plugin", "theme"];
@@ -11933,7 +11745,7 @@ async function scaffoldExtension(options) {
       const src = await getAssetPath(`extension-templates/${kind}/${assetName}`);
       const dest = path19.join(extensionDir, relDest);
       await mkdir8(path19.dirname(dest), { recursive: true });
-      const text = await readFile29(src, "utf8");
+      const text = await readFile28(src, "utf8");
       const table = relDest.endsWith(".json") ? jsonSafe : plain;
       await writeFile7(dest, substitute(text, table), "utf8");
       written.push(relDest);
@@ -11978,7 +11790,7 @@ var SKIP_ENTRIES = new Set([
 
 // src/lib/extension-import.ts
 import { existsSync as existsSync13 } from "node:fs";
-import { cp as cp3, mkdir as mkdir9, mkdtemp as mkdtemp2, readFile as readFile30, rm as rm4, writeFile as writeFile8 } from "node:fs/promises";
+import { cp as cp3, mkdir as mkdir9, mkdtemp as mkdtemp2, readFile as readFile29, rm as rm4, writeFile as writeFile8 } from "node:fs/promises";
 import { tmpdir as tmpdir2 } from "node:os";
 import path20 from "node:path";
 import { unzipSync } from "fflate";
@@ -12051,7 +11863,7 @@ async function finalizeExtensionImport(projectDir, sourceDir, relPaths, fallback
   if (!existsSync13(cssPath)) {
     throw new Error("A theme must contain a theme.css file.");
   }
-  const css = await readFile30(cssPath, "utf8");
+  const css = await readFile29(cssPath, "utf8");
   const { reject, warnings: printFindings } = classifyThemeCssFindings(checkCss(css, "theme.css"));
   if (reject) {
     throw new Error(`theme.css could not be parsed — ${reject.message}`);
@@ -12079,7 +11891,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 readFile30(sheetPath, "utf8");
+    const sheetCss = await readFile29(sheetPath, "utf8");
     const { reject: sheetReject, warnings: sheetFindings } = classifyThemeCssFindings(checkCss(sheetCss, rel));
     if (sheetReject) {
       throw new Error(`${rel} could not be parsed — ${sheetReject.message}`);
@@ -12112,7 +11924,7 @@ async function completeLandedManifest(dest, id, meta, metaExists) {
   let pkg = {};
   if (metaExists) {
     try {
-      const parsed = JSON.parse(await readFile30(file, "utf8"));
+      const parsed = JSON.parse(await readFile29(file, "utf8"));
       if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {
         pkg = parsed;
       }
@@ -12214,11 +12026,11 @@ async function importExtensionFromCssText(projectDir, css, name) {
 async function importExtensionFromFile(projectDir, filePath) {
   const ext = path20.extname(filePath).toLowerCase();
   if (ext === ".zip") {
-    const buf = await readFile30(filePath);
+    const buf = await readFile29(filePath);
     return importExtensionFromZip(projectDir, new Uint8Array(buf.buffer, buf.byteOffset, buf.byteLength));
   }
   if (ext === ".css") {
-    const css = await readFile30(filePath, "utf8");
+    const css = await readFile29(filePath, "utf8");
     return importExtensionFromCssText(projectDir, css, prettify(path20.basename(filePath, ".css")));
   }
   throw new Error("Choose a .zip extension package or a .css stylesheet.");
@@ -13002,7 +12814,7 @@ var drivethrurpgProvider = {
 };
 
 // src/lib/publish/providers/gdrive.ts
-import { mkdtemp as mkdtemp3, readFile as readFile31, readdir as readdir6, rm as rm5, stat as stat7, writeFile as writeFile10 } from "node:fs/promises";
+import { mkdtemp as mkdtemp3, readFile as readFile30, readdir as readdir6, rm as rm5, stat as stat6, writeFile as writeFile10 } from "node:fs/promises";
 import { tmpdir as tmpdir3 } from "node:os";
 import path22 from "node:path";
 import { Zip, ZipDeflate } from "fflate";
@@ -13394,12 +13206,12 @@ async function collectZipEntries(root, dir, out, onWarn) {
       await collectZipEntries(root, full, out, onWarn);
     } else if (entry.isFile()) {
       const rel = path22.relative(root, full).split(path22.sep).join("/");
-      out[rel] = await readFile31(full);
+      out[rel] = await readFile30(full);
     } else if (entry.isSymbolicLink()) {
-      const resolved = await stat7(full).catch(() => null);
+      const resolved = await stat6(full).catch(() => null);
       if (resolved?.isFile()) {
         const rel = path22.relative(root, full).split(path22.sep).join("/");
-        out[rel] = await readFile31(full);
+        out[rel] = await readFile30(full);
       } else if (resolved?.isDirectory()) {
         await collectZipEntries(root, full, out, onWarn);
       } else {
@@ -13469,7 +13281,7 @@ var gdriveProvider = {
       cleanup: async () => {}
     };
     try {
-      const artifactStat = await stat7(source.filePath);
+      const artifactStat = await stat6(source.filePath);
       const about = await driveAbout(fetchImpl, accessToken);
       if (about.quota.limitBytes != null && about.quota.freeBytes != null) {
         if (artifactStat.size > about.quota.freeBytes) {
@@ -13514,7 +13326,7 @@ var gdriveProvider = {
 };
 
 // src/lib/publish/butler.ts
-import { chmod, mkdir as mkdir11, stat as stat8, writeFile as writeFile11 } from "node:fs/promises";
+import { chmod, mkdir as mkdir11, stat as stat7, writeFile as writeFile11 } from "node:fs/promises";
 import path23 from "node:path";
 import { unzipSync as unzipSync2 } from "fflate";
 var BUTLER_DOWNLOAD_TIMEOUT_MS = 300000;
@@ -13535,7 +13347,7 @@ function butlerBinaryName(platform = process.platform) {
 }
 async function fileExists2(p) {
   try {
-    return (await stat8(p)).isFile();
+    return (await stat7(p)).isFile();
   } catch {
     return false;
   }
@@ -13778,7 +13590,7 @@ var kdpProvider = {
 };
 
 // src/lib/publish/providers/local-folder.ts
-import { cp as cp4, mkdir as mkdir12, stat as stat9 } from "node:fs/promises";
+import { cp as cp4, mkdir as mkdir12, stat as stat8 } from "node:fs/promises";
 import path24 from "node:path";
 var LOCAL_PUBLISH_DEFAULT_DIR = "dist";
 var info8 = {
@@ -13805,7 +13617,7 @@ var localFolderProvider = {
   async preflight(req) {
     const dir = localPublishDir(req);
     try {
-      const s = await stat9(dir);
+      const s = await stat8(dir);
       if (!s.isDirectory()) {
         return [
           { severity: "error", id: "local/not-a-folder", message: `${dir} exists but is not a folder.` }
@@ -14060,7 +13872,7 @@ function publishProviderFor(id) {
 }
 
 // src/lib/publish/run-publish.ts
-import { readdir as readdir7, stat as stat10 } from "node:fs/promises";
+import { readdir as readdir7, stat as stat9 } from "node:fs/promises";
 import path25 from "node:path";
 function resolvePublishFormat(info10, providerConfig) {
   if (info10.formats && info10.formats.length > 0) {
@@ -14102,7 +13914,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 stat10(artifact.path);
+    const s = await stat9(artifact.path);
     if (artifact.format === "pdf" && !s.isFile()) {
       return [
         {
@@ -14148,7 +13960,7 @@ async function artifactIssues(artifact) {
 var BUILD_FINGERPRINT_FILENAME = "build-fingerprint.json";
 async function htmlDirIssues(dir) {
   const issues = [];
-  const isThere = async (rel) => stat10(path25.join(dir, rel)).then(() => true, () => false);
+  const isThere = async (rel) => stat9(path25.join(dir, rel)).then(() => true, () => false);
   if (!await isThere(BOOK_HTML)) {
     issues.push({
       severity: "error",
@@ -14386,7 +14198,7 @@ import git8 from "isomorphic-git";
 // src/lib/remote-auth/scorched-earth.ts
 import git9 from "isomorphic-git";
 // src/lib/publish/selections.ts
-import { chmod as chmod2, mkdir as mkdir13, readFile as readFile32, writeFile as writeFile12 } from "node:fs/promises";
+import { chmod as chmod2, mkdir as mkdir13, readFile as readFile31, writeFile as writeFile12 } from "node:fs/promises";
 import path26 from "node:path";
 class PublishSelectionsStore {
   filePath;
@@ -14396,7 +14208,7 @@ class PublishSelectionsStore {
   }
   async read() {
     try {
-      const raw = await readFile32(this.filePath, "utf8");
+      const raw = await readFile31(this.filePath, "utf8");
       const parsed = JSON.parse(raw);
       if (parsed && typeof parsed === "object") {
         return {