gutterpress 0.10.0-alpha.4 → 0.10.0

package/dist/{index-05y3dnxq.js → index-ge7q9xj3.js}

@@ -2,6 +2,7 @@ import {
   BuildError,
   EXIT_CODES,
   INSTALL_HINTS,
+  MARGIN_BOX_IGNORED_PROPERTIES,
   RENDER_TIMEOUT_MS,
   REQUIRED_MILESTONE,
   closeBrowser,
@@ -16,7 +17,7 @@ import {
   resolveChromiumExecutable,
   run,
   spawnCapture
-} from "./index-9tyq9kks.js";
+} from "./index-ycpvr0am.js";
 import {
   gitDirFor,
   gitScopeFor,
@@ -731,6 +732,9 @@ function warn(env, line, type, message, marker) {
     env.layoutWarnings = [];
   env.layoutWarnings.push({ line, type, message, marker });
 }
+function proseEscapeHint(kind) {
+  return ` If this line is prose that happens to begin with "@${kind}" — a wrapped sentence, for` + ` instance — escape it as \\@${kind} or write it as \`@${kind}\` in backticks, and it stays text.`;
+}
 function addClasses(token, baseClass, extraClass) {
   const cls = [];
   if (baseClass)
@@ -792,14 +796,14 @@ function plugin(md, pluginOptions = {}) {
       const unknown = parsed.__unknownTokens;
       delete parsed.__unknownTokens;
       for (const t of unknown) {
-        warn(state.env, startLine + 1, "unrecognized_marker_token", `@${parsed.kind}: "${t}" is not something a marker understands, so it was kept verbatim as a class name. Write a class as .my-class (or {.my-class}), an id as #my-id, and anything else as key=value.`, parsed);
+        warn(state.env, startLine + 1, "unrecognized_marker_token", `@${parsed.kind}: "${t}" is not something a marker understands, so it was kept verbatim as a class name. Write a class as .my-class (or {.my-class}), an id as #my-id, and anything else as key=value.` + proseEscapeHint(parsed.kind), parsed);
       }
     }
     if (parsed.__extraBareTokens) {
       const { tokens, named } = parsed.__extraBareTokens;
       delete parsed.__extraBareTokens;
       const list = tokens.map((t) => `"${t}"`).join(", ");
-      warn(state.env, startLine + 1, "extra_bare_marker_token", named ? `@${parsed.kind}: only the first plain word (${list.split(", ")[0]}) is used as the name; the rest (${tokens.slice(1).map((t) => `"${t}"`).join(", ")}) became class names instead. Quote a name that contains spaces ("${tokens.join(" ")}"), or write classes as .${tokens.slice(1).join(" .")}.` : `@${parsed.kind}: ${list} are several plain words, but a marker has only one name slot — so NONE of them was used as the name and they all became class names instead. Quote a name that contains spaces ("${tokens.join(" ")}"), or write classes as .${tokens.join(" .")}.`, parsed);
+      warn(state.env, startLine + 1, "extra_bare_marker_token", named ? `@${parsed.kind}: only the first plain word (${list.split(", ")[0]}) is used as the name; the rest (${tokens.slice(1).map((t) => `"${t}"`).join(", ")}) became class names instead. Quote a name that contains spaces ("${tokens.join(" ")}"), or write classes as .${tokens.slice(1).join(" .")}.` : `@${parsed.kind}: ${list} are several plain words, but a marker has only one name slot — so NONE of them was used as the name and they all became class names instead. Quote a name that contains spaces ("${tokens.join(" ")}"), or write classes as .${tokens.join(" .")}.` + proseEscapeHint(parsed.kind), parsed);
     }
     state.line = startLine + 1;
     return true;
@@ -891,7 +895,12 @@ function plugin(md, pluginOptions = {}) {
       t.meta = { line: meta.__line };
       addClasses(t, "spread", meta.attrs && meta.attrs.class ? meta.attrs.class : "");
       attachDataAttrs(t, "spread", meta.name, meta.attrs || {});
-      stack.open({ kind: "spread", noPagesYet: true, sawAnyPage: false }, t);
+      stack.open({
+        kind: "spread",
+        classes: meta.attrs && meta.attrs.class || "",
+        noPagesYet: true,
+        sawAnyPage: false
+      }, t);
     }
     function openPage(meta) {
       const chapter = stack.get("chapter");
@@ -906,7 +915,7 @@ function plugin(md, pluginOptions = {}) {
       const label = chapter ? chapter.label : "";
       if (label)
         t.attrSet("data-chapter-label", label);
-      stack.open({ kind: "page" }, t);
+      stack.open({ kind: "page", classes: explicit }, t);
       if (label && !chapter.openerEmitted) {
         const opener = new state.Token("html_block", "", 0);
         opener.content = `<div class="chapter-opener" data-chapter-label="${escapeAttr(label)}">${escapeHtml(label)}</div>
@@ -929,13 +938,51 @@ function plugin(md, pluginOptions = {}) {
       t.meta = { hasColumnBreak: false, line: meta.__line };
       stack.open({
         kind: "section",
+        classes: meta.attrs && meta.attrs.class || "",
+        sawContent: false,
         meta: { name: meta.name || null, attrs: { ...meta.attrs || {} } },
         openToken: t
       }, t);
     }
+    function breakHost() {
+      return stack.get("section") || stack.get("page") || stack.get("spread");
+    }
+    function gridClassOf(frame) {
+      if (!frame || !frame.classes)
+        return null;
+      return frame.classes.split(/\s+/).find((c) => c.startsWith("gp-grid-")) || null;
+    }
+    function warnBreakInsideGrid(kind, line, meta) {
+      const host = breakHost();
+      const gridClass = gridClassOf(host);
+      if (!gridClass)
+        return;
+      warn(state.env, line, "break_inside_grid", `@${kind} inside a grid container: the enclosing @${host.kind} carries .${gridClass}, so this break's <div> becomes a grid ITEM — it takes a cell of its own, corrupts the grid's placement, and print and the live preview then disagree about which page the content after it lands on. Move the break outside the grid @${host.kind}, or remove it — grid rows already flow and fragment across pages on their own.`, meta);
+    }
+    function warnIfEmptyDecoratedSection(closingKind, closingLine) {
+      const sec = stack.get("section");
+      if (!sec || sec.sawContent)
+        return;
+      const attrs = sec.meta && sec.meta.attrs || {};
+      const decorations = [];
+      for (const c of (attrs.class || "").split(/\s+/).filter(Boolean))
+        decorations.push(`.${c}`);
+      for (const [k, v] of Object.entries(attrs)) {
+        if (k === "class")
+          continue;
+        decorations.push(k === "id" ? `#${v}` : `${k}=${v}`);
+      }
+      if (!decorations.length)
+        return;
+      const openLine = sec.openToken && sec.openToken.meta && Number.isFinite(sec.openToken.meta.line) ? sec.openToken.meta.line : closingLine;
+      warn(state.env, openLine, "empty_section", `This @section (${decorations.join(" ")}) was closed by the @${closingKind} on line ${closingLine} with no content between the two markers, so its styling applies to an empty element and nothing prints the layout it asked for. Delete one of the two markers, or move the content that belongs inside the section between them.`, null);
+    }
     for (let i = 0;i < state.tokens.length; i++) {
       const tok = state.tokens[i];
       if (tok.type !== "layout_marker") {
+        const openSectionFrame = stack.get("section");
+        if (openSectionFrame)
+          openSectionFrame.sawContent = true;
         out.push(tok);
         continue;
       }
@@ -961,6 +1008,7 @@ function plugin(md, pluginOptions = {}) {
         continue;
       }
       if (kind === "section") {
+        warnIfEmptyDecoratedSection("section", line);
         stack.close("section");
         const spread = stack.get("spread");
         if (spread && spread.noPagesYet) {
@@ -989,6 +1037,7 @@ function plugin(md, pluginOptions = {}) {
         continue;
       }
       if (kind === "page-break") {
+        warnBreakInsideGrid("page-break", line, meta);
         const t = new state.Token("layout_page_break", "div", 0);
         t.meta = { line };
         t.attrSet("class", "gp-page-break");
@@ -997,6 +1046,7 @@ function plugin(md, pluginOptions = {}) {
         continue;
       }
       if (kind === "column-break") {
+        warnBreakInsideGrid("column-break", line, meta);
         const openSectionFrame = stack.get("section");
         if (openSectionFrame && openSectionFrame.openToken && !openSectionFrame.openToken.meta.hasColumnBreak) {
           const sectionCls = openSectionFrame.openToken.attrGet("class") || "";
@@ -1012,6 +1062,7 @@ function plugin(md, pluginOptions = {}) {
         continue;
       }
       if (kind === "end-section") {
+        warnIfEmptyDecoratedSection("end-section", line);
         stack.close("section");
         continue;
       }
@@ -1099,7 +1150,7 @@ body { margin: 0; }
 .gp-page-break { break-before: page; }
 .page { break-before: page; }
 .spread { break-before: page; }
-:where(.page, .spread) { position: relative; }
+:where(.page, .spread) { position: relative; display: flow-root; box-sizing: border-box; min-height: calc(var(--gp-content-h, 1px) - 1px); }
 .gp-column-break { break-after: column; height: 0; font-size: 0; line-height: 0; visibility: hidden; }
 
 :where(h1,h2,h3,h4,h5,h6) { break-after: avoid; }
@@ -1183,6 +1234,26 @@ var GUTTERPRESS_CSS = `
 .gp-columns-2 { columns: 2; column-gap: var(--gp-column-gap, 1.5em); }
 .gp-columns-3 { columns: 3; column-gap: var(--gp-column-gap, 1.5em); }
 
+/* grid runs — the SLOTTED counterpart to the column runs above. Grid places
+   each child into the next cell, across then down (deterministic slots: card
+   layouts, stat blocks, image-plus-caption pairs); columns FLOW one text run
+   down then across. Same neutral-primitive rationale as .gp-columns-*, and
+   permanent vocabulary for the same reason: standard CSS Grid verbatim, no
+   spec gap to remove later. MEASURED (Chromium 151, gp-grid evidence pack):
+   grid rows fragment across sheets with EXACT print/viewer parity — 2- and
+   3-col, unequal item heights, mid-row cuts, multi-sheet overflow,
+   break-inside:avoid, gap geometry — so a grid taller than the page is safe,
+   no fit-one-page constraint. Two things to know, not fix:
+     - on a min-height page root (MARKER_CSS), default align-content
+       stretches rows apart to fill the page — identically in both engines.
+       Authors wanting packed rows set align-content: start.
+     - a @page-break / @column-break marker DIRECTLY inside a grid container
+       becomes a grid item and corrupts placement (the one measured parity
+       break); markers.js diagnoses it (break_inside_grid).
+   --gp-grid-gap is author-settable. */
+.gp-grid-2 { display: grid; grid-template-columns: repeat(2, 1fr); gap: var(--gp-grid-gap, 1.5em); }
+.gp-grid-3 { display: grid; grid-template-columns: repeat(3, 1fr); gap: var(--gp-grid-gap, 1.5em); }
+
 /* shape wrap — text follows the image's alpha silhouette instead of its
    rectangular box. shape-outside only applies to floats, so this is inert
    without .gp-left/.gp-right (and under .gp-pin, which un-floats). The
@@ -1245,8 +1316,14 @@ img.gp-shape {
        opacity, filter, transform on it traps the negative layer inside).
        Core keeps .page/.spread at 'position: relative; z-index: auto'
        precisely so they are not stacking contexts.
-     - a clipping ancestor (overflow other than visible), the same mechanism
-       that clips a .gp-bleed plate back to the wrapper's width.
+     - a clipping ancestor (overflow other than visible) — but only where
+       the art actually overhangs that ancestor's clip box on a clipped
+       axis: the overhang is cut off, the same mechanism that clips a
+       .gp-bleed plate back to the wrapper's width. Clipping never reorders
+       layers — within-bounds art under a clipping .page prints whole and
+       still behind (measured; see the build audit's comment in
+       engine/compiler/build.ts), and a static wrapper's overflow never
+       binds an abspos .gp-pin at all.
    The build-time engine.layer.trapped audit reports both against the live
    ancestor chain. printsafe/page-containment is only an early source hint for
    declarations written directly on .page/.spread. */
@@ -3873,7 +3950,7 @@ import git from "isomorphic-git";
 // package.json
 var package_default = {
   name: "gutterpress",
-  version: "0.10.0-alpha.4",
+  version: "0.10.0",
   description: "Markdown-to-PDF converter for professional print layout using a native Chromium print engine and Ghostscript.",
   author: "itlackey",
   license: "MPL-2.0",
@@ -4142,200 +4219,12 @@ async function writeBuildFingerprint(input) {
   return outPath;
 }
 
-// src/lib/missing-asset-placeholder.ts
-import { createHash as createHash5 } from "node:crypto";
-import { deflateSync } from "node:zlib";
-function placeholderOutputPath(missingOutputPath) {
-  const hash = createHash5("sha256").update(missingOutputPath).digest("hex").slice(0, 16);
-  return `assets/gutterpress-missing/${hash}.png`;
-}
-function decodeHtmlAttribute(value) {
-  return value.replace(/&quot;/g, '"').replace(/&#39;|&apos;/g, "'").replace(/&lt;/g, "<").replace(/&gt;/g, ">").replace(/&amp;/g, "&");
-}
-function rewriteMissingImageReferences(html, replacements) {
-  if (replacements.size === 0)
-    return html;
-  const replacementFor = (raw) => replacements.get(raw) ?? replacements.get(decodeHtmlAttribute(raw));
-  const cssUrl = /url\(\s*(?:"([^"]*)"|'([^']*)'|&quot;((?:(?!&quot;).)*)&quot;|([^'"()\s]*))\s*\)/giy;
-  const rewriteCssUrls = (css) => {
-    let out2 = "";
-    let copiedThrough = 0;
-    let index = 0;
-    while (index < css.length) {
-      if (css.startsWith("/*", index)) {
-        const end = css.indexOf("*/", index + 2);
-        index = end < 0 ? css.length : end + 2;
-        continue;
-      }
-      const char = css[index];
-      if (char === '"' || char === "'") {
-        const quote = char;
-        index++;
-        while (index < css.length) {
-          if (css[index] === "\\") {
-            index += 2;
-            continue;
-          }
-          const current = css[index++];
-          if (current === quote)
-            break;
-        }
-        continue;
-      }
-      const previous = index > 0 ? css[index - 1] : "";
-      if (!/[a-z0-9_-]/i.test(previous) && css.slice(index, index + 3).toLowerCase() === "url") {
-        cssUrl.lastIndex = index;
-        const match = cssUrl.exec(css);
-        if (match) {
-          const raw = match[1] ?? match[2] ?? match[3] ?? match[4] ?? "";
-          const replacement = replacementFor(raw);
-          if (replacement) {
-            out2 += css.slice(copiedThrough, index);
-            out2 += match[3] !== undefined ? `url(&quot;${replacement}&quot;)` : `url("${replacement}")`;
-            index = cssUrl.lastIndex;
-            copiedThrough = index;
-            continue;
-          }
-        }
-      }
-      index++;
-    }
-    return copiedThrough === 0 ? css : out2 + css.slice(copiedThrough);
-  };
-  const rewriteTag = (tag) => {
-    let out2 = tag;
-    if (/^<img\b/i.test(tag)) {
-      out2 = out2.replace(/(\s+src\s*=\s*)(?:"([^"]*)"|'([^']*)'|([^\s>]+))/gi, (whole, prefix, double, single, bare) => {
-        const raw = double ?? single ?? bare ?? "";
-        const replacement = replacementFor(raw);
-        if (!replacement)
-          return whole;
-        if (double !== undefined)
-          return `${prefix}"${replacement}"`;
-        if (single !== undefined)
-          return `${prefix}'${replacement}'`;
-        return `${prefix}${replacement}`;
-      });
-    }
-    if (/^<(?:img|source)\b/i.test(tag)) {
-      out2 = out2.replace(/(\s+srcset\s*=\s*)(?:"([^"]*)"|'([^']*)'|([^\s>]+))/gi, (whole, prefix, double, single, bare) => {
-        const value = double ?? single ?? bare ?? "";
-        let rewritten = "";
-        let copiedThrough = 0;
-        let changed = false;
-        for (const candidate of parseSrcsetUrlCandidates(value)) {
-          const replacement = replacementFor(candidate.url);
-          if (!replacement)
-            continue;
-          rewritten += value.slice(copiedThrough, candidate.start) + replacement;
-          copiedThrough = candidate.end;
-          changed = true;
-        }
-        if (!changed)
-          return whole;
-        rewritten += value.slice(copiedThrough);
-        if (double !== undefined)
-          return `${prefix}"${rewritten}"`;
-        if (single !== undefined)
-          return `${prefix}'${rewritten}'`;
-        return `${prefix}${rewritten}`;
-      });
-    }
-    out2 = out2.replace(/(\s+style\s*=\s*)(["'])(.*?)\2/gi, (whole, prefix, quote, value) => {
-      const rewritten = rewriteCssUrls(value);
-      return rewritten === value ? whole : `${prefix}${quote}${rewritten}${quote}`;
-    });
-    return out2;
-  };
-  const rewriteActiveHtml = (active) => active.replace(/<(?:"[^"]*"|'[^']*'|[^'">])*>/g, (tag) => rewriteTag(tag));
-  const protectedRegion = /<!--[\s\S]*?-->|<(script|style|pre|code|textarea)\b[^>]*>[\s\S]*?<\/\1\s*>/gi;
-  let out = "";
-  let last = 0;
-  for (const match of html.matchAll(protectedRegion)) {
-    out += rewriteActiveHtml(html.slice(last, match.index));
-    if (match[1]?.toLowerCase() === "style") {
-      const style = /^(<style\b[^>]*>)([\s\S]*)(<\/style\s*>)$/i.exec(match[0]);
-      out += style ? `${rewriteTag(style[1])}${rewriteCssUrls(style[2])}${style[3]}` : match[0];
-    } else {
-      out += match[0];
-    }
-    last = (match.index ?? 0) + match[0].length;
-  }
-  out += rewriteActiveHtml(html.slice(last));
-  return out;
-}
-function crc32(buf) {
-  let c = ~0;
-  for (let i = 0;i < buf.length; i++) {
-    c ^= buf[i];
-    for (let k = 0;k < 8; k++)
-      c = c >>> 1 ^ 3988292384 & -(c & 1);
-  }
-  return ~c >>> 0;
-}
-function chunk(type, data) {
-  const out = new Uint8Array(data.length + 12);
-  const view = new DataView(out.buffer);
-  view.setUint32(0, data.length);
-  for (let i = 0;i < 4; i++)
-    out[4 + i] = type.charCodeAt(i);
-  out.set(data, 8);
-  view.setUint32(data.length + 8, crc32(out.subarray(4, data.length + 8)));
-  return out;
-}
-function placeholderPng(width = 640, height = 480, cell = 32) {
-  const A = [217, 70, 239];
-  const B = [26, 26, 26];
-  const raw = new Uint8Array(height * (1 + width * 3));
-  let p = 0;
-  for (let y = 0;y < height; y++) {
-    raw[p++] = 0;
-    for (let x = 0;x < width; x++) {
-      const c = ((x / cell | 0) + (y / cell | 0)) % 2 === 0 ? A : B;
-      raw[p++] = c[0];
-      raw[p++] = c[1];
-      raw[p++] = c[2];
-    }
-  }
-  const ihdr = new Uint8Array(13);
-  const hv = new DataView(ihdr.buffer);
-  hv.setUint32(0, width);
-  hv.setUint32(4, height);
-  ihdr[8] = 8;
-  ihdr[9] = 2;
-  const parts = [
-    new Uint8Array([137, 80, 78, 71, 13, 10, 26, 10]),
-    chunk("IHDR", ihdr),
-    chunk("IDAT", new Uint8Array(deflateSync(raw))),
-    chunk("IEND", new Uint8Array(0))
-  ];
-  const total = parts.reduce((n, x) => n + x.length, 0);
-  const png = new Uint8Array(total);
-  let o = 0;
-  for (const part of parts) {
-    png.set(part, o);
-    o += part.length;
-  }
-  return png;
-}
-
 // src/lib/lint-runner.ts
 import { resolve as resolve4 } from "node:path";
 import { readFile as readFile8 } from "node:fs/promises";
 
 // src/lib/printsafe.ts
 import postcss2 from "postcss";
-
-// src/engine/shared/margin-box-support.ts
-var MARGIN_BOX_IGNORED_PROPERTIES = new Set([
-  "transform",
-  "rotate",
-  "translate",
-  "scale",
-  "box-shadow"
-]);
-
-// src/lib/printsafe.ts
 var ruleRemoteUrls = "printsafe/no-remote-urls";
 var ruleRiskyProps = "printsafe/no-risky-print-effects";
 var ruleSyntax = "printsafe/syntax-error";
@@ -7549,6 +7438,185 @@ function computeGates(format, opts, config) {
 import path6 from "node:path";
 import os from "node:os";
 import fsp from "node:fs/promises";
+
+// src/lib/missing-asset-placeholder.ts
+import { createHash as createHash5 } from "node:crypto";
+import { deflateSync } from "node:zlib";
+function placeholderOutputPath(missingOutputPath) {
+  const hash = createHash5("sha256").update(missingOutputPath).digest("hex").slice(0, 16);
+  return `assets/gutterpress-missing/${hash}.png`;
+}
+function decodeHtmlAttribute(value) {
+  return value.replace(/&quot;/g, '"').replace(/&#39;|&apos;/g, "'").replace(/&lt;/g, "<").replace(/&gt;/g, ">").replace(/&amp;/g, "&");
+}
+function rewriteMissingImageReferences(html, replacements) {
+  if (replacements.size === 0)
+    return html;
+  const replacementFor = (raw) => replacements.get(raw) ?? replacements.get(decodeHtmlAttribute(raw));
+  const cssUrl = /url\(\s*(?:"([^"]*)"|'([^']*)'|&quot;((?:(?!&quot;).)*)&quot;|([^'"()\s]*))\s*\)/giy;
+  const rewriteCssUrls = (css) => {
+    let out2 = "";
+    let copiedThrough = 0;
+    let index = 0;
+    while (index < css.length) {
+      if (css.startsWith("/*", index)) {
+        const end = css.indexOf("*/", index + 2);
+        index = end < 0 ? css.length : end + 2;
+        continue;
+      }
+      const char = css[index];
+      if (char === '"' || char === "'") {
+        const quote = char;
+        index++;
+        while (index < css.length) {
+          if (css[index] === "\\") {
+            index += 2;
+            continue;
+          }
+          const current = css[index++];
+          if (current === quote)
+            break;
+        }
+        continue;
+      }
+      const previous = index > 0 ? css[index - 1] : "";
+      if (!/[a-z0-9_-]/i.test(previous) && css.slice(index, index + 3).toLowerCase() === "url") {
+        cssUrl.lastIndex = index;
+        const match = cssUrl.exec(css);
+        if (match) {
+          const raw = match[1] ?? match[2] ?? match[3] ?? match[4] ?? "";
+          const replacement = replacementFor(raw);
+          if (replacement) {
+            out2 += css.slice(copiedThrough, index);
+            out2 += match[3] !== undefined ? `url(&quot;${replacement}&quot;)` : `url("${replacement}")`;
+            index = cssUrl.lastIndex;
+            copiedThrough = index;
+            continue;
+          }
+        }
+      }
+      index++;
+    }
+    return copiedThrough === 0 ? css : out2 + css.slice(copiedThrough);
+  };
+  const rewriteTag = (tag) => {
+    let out2 = tag;
+    if (/^<img\b/i.test(tag)) {
+      out2 = out2.replace(/(\s+src\s*=\s*)(?:"([^"]*)"|'([^']*)'|([^\s>]+))/gi, (whole, prefix, double, single, bare) => {
+        const raw = double ?? single ?? bare ?? "";
+        const replacement = replacementFor(raw);
+        if (!replacement)
+          return whole;
+        if (double !== undefined)
+          return `${prefix}"${replacement}"`;
+        if (single !== undefined)
+          return `${prefix}'${replacement}'`;
+        return `${prefix}${replacement}`;
+      });
+    }
+    if (/^<(?:img|source)\b/i.test(tag)) {
+      out2 = out2.replace(/(\s+srcset\s*=\s*)(?:"([^"]*)"|'([^']*)'|([^\s>]+))/gi, (whole, prefix, double, single, bare) => {
+        const value = double ?? single ?? bare ?? "";
+        let rewritten = "";
+        let copiedThrough = 0;
+        let changed = false;
+        for (const candidate of parseSrcsetUrlCandidates(value)) {
+          const replacement = replacementFor(candidate.url);
+          if (!replacement)
+            continue;
+          rewritten += value.slice(copiedThrough, candidate.start) + replacement;
+          copiedThrough = candidate.end;
+          changed = true;
+        }
+        if (!changed)
+          return whole;
+        rewritten += value.slice(copiedThrough);
+        if (double !== undefined)
+          return `${prefix}"${rewritten}"`;
+        if (single !== undefined)
+          return `${prefix}'${rewritten}'`;
+        return `${prefix}${rewritten}`;
+      });
+    }
+    out2 = out2.replace(/(\s+style\s*=\s*)(["'])(.*?)\2/gi, (whole, prefix, quote, value) => {
+      const rewritten = rewriteCssUrls(value);
+      return rewritten === value ? whole : `${prefix}${quote}${rewritten}${quote}`;
+    });
+    return out2;
+  };
+  const rewriteActiveHtml = (active) => active.replace(/<(?:"[^"]*"|'[^']*'|[^'">])*>/g, (tag) => rewriteTag(tag));
+  const protectedRegion = /<!--[\s\S]*?-->|<(script|style|pre|code|textarea)\b[^>]*>[\s\S]*?<\/\1\s*>/gi;
+  let out = "";
+  let last = 0;
+  for (const match of html.matchAll(protectedRegion)) {
+    out += rewriteActiveHtml(html.slice(last, match.index));
+    if (match[1]?.toLowerCase() === "style") {
+      const style = /^(<style\b[^>]*>)([\s\S]*)(<\/style\s*>)$/i.exec(match[0]);
+      out += style ? `${rewriteTag(style[1])}${rewriteCssUrls(style[2])}${style[3]}` : match[0];
+    } else {
+      out += match[0];
+    }
+    last = (match.index ?? 0) + match[0].length;
+  }
+  out += rewriteActiveHtml(html.slice(last));
+  return out;
+}
+function crc32(buf) {
+  let c = ~0;
+  for (let i = 0;i < buf.length; i++) {
+    c ^= buf[i];
+    for (let k = 0;k < 8; k++)
+      c = c >>> 1 ^ 3988292384 & -(c & 1);
+  }
+  return ~c >>> 0;
+}
+function chunk(type, data) {
+  const out = new Uint8Array(data.length + 12);
+  const view = new DataView(out.buffer);
+  view.setUint32(0, data.length);
+  for (let i = 0;i < 4; i++)
+    out[4 + i] = type.charCodeAt(i);
+  out.set(data, 8);
+  view.setUint32(data.length + 8, crc32(out.subarray(4, data.length + 8)));
+  return out;
+}
+function placeholderPng(width = 640, height = 480, cell = 32) {
+  const A = [217, 70, 239];
+  const B = [26, 26, 26];
+  const raw = new Uint8Array(height * (1 + width * 3));
+  let p = 0;
+  for (let y = 0;y < height; y++) {
+    raw[p++] = 0;
+    for (let x = 0;x < width; x++) {
+      const c = ((x / cell | 0) + (y / cell | 0)) % 2 === 0 ? A : B;
+      raw[p++] = c[0];
+      raw[p++] = c[1];
+      raw[p++] = c[2];
+    }
+  }
+  const ihdr = new Uint8Array(13);
+  const hv = new DataView(ihdr.buffer);
+  hv.setUint32(0, width);
+  hv.setUint32(4, height);
+  ihdr[8] = 8;
+  ihdr[9] = 2;
+  const parts = [
+    new Uint8Array([137, 80, 78, 71, 13, 10, 26, 10]),
+    chunk("IHDR", ihdr),
+    chunk("IDAT", new Uint8Array(deflateSync(raw))),
+    chunk("IEND", new Uint8Array(0))
+  ];
+  const total = parts.reduce((n, x) => n + x.length, 0);
+  const png = new Uint8Array(total);
+  let o = 0;
+  for (const part of parts) {
+    png.set(part, o);
+    o += part.length;
+  }
+  return png;
+}
+
+// src/lib/build-staging.ts
 async function shipViewerHtml(htmlFile, outDir) {
   await fsp.mkdir(path6.join(outDir, "engine"), { recursive: true });
   await fsp.copyFile(await getAssetPath("engine/gutterpress-viewer.js"), path6.join(outDir, "engine/gutterpress-viewer.js"));
@@ -7557,6 +7625,50 @@ async function shipViewerHtml(htmlFile, outDir) {
   const html = await fsp.readFile(htmlFile, "utf-8");
   await fsp.writeFile(htmlFile, /<\/head>/i.test(html) ? html.replace(/<\/head>/i, tag + "</head>") : tag + html, "utf-8");
 }
+async function stageBookAssets(options) {
+  const { renderDir, outDir, htmlFile, imageRefs, cssAssets, onPlan } = options;
+  const { copies: imageCopies, errors, destinations } = await planImageCopies(renderDir, imageRefs);
+  const copies = [...cssAssets, ...imageCopies];
+  onPlan?.({ unresolved: errors, copyCount: copies.length });
+  const missingPlaceholders = copies.length ? await copyReferencedAssets(copies, outDir) : new Map;
+  let staged = await fsp.readFile(htmlFile, "utf8");
+  if (missingPlaceholders.size > 0) {
+    const rewrites = new Map(missingPlaceholders);
+    for (const [ref, dest] of destinations) {
+      const placeholder = missingPlaceholders.get(dest);
+      if (placeholder)
+        rewrites.set(ref, placeholder);
+    }
+    staged = rewriteMissingImageReferences(staged, rewrites);
+    await fsp.writeFile(htmlFile, staged, "utf8");
+  }
+  if (staged.includes("--gp-shape:")) {
+    await fsp.writeFile(htmlFile, await inlineShapeUrls(staged, outDir), "utf8");
+  }
+  return { missing: [...missingPlaceholders.keys()].sort() };
+}
+async function copyReferencedAssets(copies, outDir) {
+  const dirs = new Set(copies.map((c) => path6.dirname(path6.resolve(outDir, c.to))));
+  await Promise.all([...dirs].map((d) => fsp.mkdir(d, { recursive: true })));
+  const missing = new Map;
+  await Promise.all(copies.map(async (c) => {
+    const dest = path6.resolve(outDir, c.to);
+    try {
+      await fsp.copyFile(c.from, dest);
+    } catch (err) {
+      if (err?.code === "ENOENT") {
+        const placeholder = placeholderOutputPath(c.to);
+        const placeholderDest = path6.resolve(outDir, placeholder);
+        await fsp.mkdir(path6.dirname(placeholderDest), { recursive: true });
+        await fsp.writeFile(placeholderDest, placeholderPng());
+        missing.set(c.to, placeholder);
+        return;
+      }
+      throw new BuildError(`Could not copy asset ${c.from} → ${c.to}: ` + (err instanceof Error ? err.message : String(err)), 1);
+    }
+  }));
+  return missing;
+}
 async function createStageRoot() {
   return fsp.mkdtemp(path6.join(os.tmpdir(), "gutterpress-stage-"));
 }
@@ -7669,67 +7781,35 @@ async function renderBook(ctx) {
       }
     },
     onImageRefs: (refs) => imageRefs.push(...refs),
-    onCssAssets: (copies2) => cssAssets.push(...copies2),
+    onCssAssets: (copies) => cssAssets.push(...copies),
     onStyleWarnings: (warnings) => {
       for (const w of warnings)
         log.warn(`  ${w}`);
     }
   });
   log.success(`Wrote ${htmlFile}`);
-  const { copies: imageCopies, errors, destinations } = await planImageCopies(renderDir, imageRefs);
-  if (errors.length > 0) {
-    throw new BuildError(`Cannot resolve ${errors.length} image reference(s):
-` + errors.map((e) => `  - ${e}`).join(`
+  const { missing } = await stageBookAssets({
+    renderDir,
+    outDir: workDir,
+    htmlFile,
+    imageRefs,
+    cssAssets,
+    onPlan: ({ unresolved, copyCount }) => {
+      if (unresolved.length > 0) {
+        throw new BuildError(`Cannot resolve ${unresolved.length} image reference(s):
+` + unresolved.map((e) => `  - ${e}`).join(`
 `), 1);
-  }
-  const copies = [...cssAssets, ...imageCopies];
-  let missingPlaceholders = new Map;
-  if (copies.length > 0) {
-    log.info(`Copying ${copies.length} referenced asset(s)`);
-    missingPlaceholders = await copyReferencedAssets(copies, workDir);
-  }
-  let staged = await fsp2.readFile(htmlFile, "utf8");
-  if (missingPlaceholders.size > 0) {
-    const rewrites = new Map(missingPlaceholders);
-    for (const [ref, dest] of destinations) {
-      const placeholder = missingPlaceholders.get(dest);
-      if (placeholder)
-        rewrites.set(ref, placeholder);
-    }
-    staged = rewriteMissingImageReferences(staged, rewrites);
-    await fsp2.writeFile(htmlFile, staged, "utf8");
-  }
-  if (staged.includes("--gp-shape:")) {
-    await fsp2.writeFile(htmlFile, await inlineShapeUrls(staged, workDir), "utf8");
-  }
-  return htmlFile;
-}
-async function copyReferencedAssets(copies, outDir) {
-  const dirs = new Set(copies.map((c) => path7.dirname(path7.resolve(outDir, c.to))));
-  await Promise.all([...dirs].map((d) => fsp2.mkdir(d, { recursive: true })));
-  const missing = new Map;
-  await Promise.all(copies.map(async (c) => {
-    const dest = path7.resolve(outDir, c.to);
-    try {
-      await fsp2.copyFile(c.from, dest);
-    } catch (err) {
-      if (err?.code === "ENOENT") {
-        const placeholder = placeholderOutputPath(c.to);
-        const placeholderDest = path7.resolve(outDir, placeholder);
-        await fsp2.mkdir(path7.dirname(placeholderDest), { recursive: true });
-        await fsp2.writeFile(placeholderDest, placeholderPng());
-        missing.set(c.to, placeholder);
-        return;
       }
-      throw new BuildError(`Could not copy asset ${c.from} → ${c.to}: ` + (err instanceof Error ? err.message : String(err)), 1);
+      if (copyCount > 0)
+        log.info(`Copying ${copyCount} referenced asset(s)`);
     }
-  }));
-  if (missing.size > 0) {
-    log.warn(`${missing.size} referenced image(s) do not exist — a magenta placeholder ` + `was substituted so the build could finish. Each one is a visible hole ` + `in the PDF:`);
-    for (const m of [...missing.keys()].sort())
+  });
+  if (missing.length > 0) {
+    log.warn(`${missing.length} referenced image(s) do not exist — a magenta placeholder ` + `was substituted so the build could finish. Each one is a visible hole ` + `in the PDF:`);
+    for (const m of missing)
       log.warn(`  missing: ${m}`);
   }
-  return missing;
+  return htmlFile;
 }
 async function resolveIccProfile(icc, manifestDir, explicitIccPath) {
   const iccCandidates = path7.isAbsolute(icc) ? [icc] : [path7.resolve(manifestDir, icc), path7.resolve(icc)];
@@ -7827,11 +7907,12 @@ class PdfOutput {
       const rawPdf = pdfxMode ? path7.join(stage, "raw.pdf") : path7.resolve(pdfFile);
       await fsp2.mkdir(path7.dirname(path7.resolve(pdfFile)), { recursive: true });
       log.info("Rendering HTML to PDF via the Gutterpress engine (native Chromium pagination)");
-      const { buildNativePdf } = await import("./engine-z4p9sr4h.js");
+      const { buildNativePdf } = await import("./engine-b159tbns.js");
       const engineDiagnostics = await buildNativePdf(htmlFile, rawPdf, {
         title: config.title,
         author: config.authors.length > 0 ? config.authors.join(", ") : undefined,
-        signature: config.print.signature
+        signature: config.print.signature,
+        allowShrink: opts.allowShrink
       }, opts.engineBrowser);
       for (const d of engineDiagnostics)
         log.warn(d.message);