gutterpress 0.10.0-alpha.4 → 0.10.0

package/README.md

@@ -190,6 +190,7 @@ gutterpress preview [input-dir] [options]
   --skip-lint             Skip CSS linting                              (pdf|pdfx only)
   --skip-pre-validate     Skip pre-build validation                     (pdf|pdfx only)
   --skip-post-validate    Skip post-build PDF/X validation              (pdfx only)
+  --allow-shrink          Build anyway when content is wider than the page content box (pdf|pdfx only)
   --engine <name>         native (default) | paged (deprecated)   [overrides the manifest's engine: field; applies to the live preview AND --format pdf|pdfx]
 ```
 
@@ -210,6 +211,7 @@ gutterpress build [input-dir] [options]
   --skip-lint             Skip the CSS print-safety pass (default: lint runs for pdf/pdfx)
   --skip-pre-validate     Skip pre-build validation
   --skip-post-validate    Skip post-build PDF/X validation
+  --allow-shrink          Build anyway when content is wider than the page content box. Chromium then scales the WHOLE book down to fit it — the build reports that whole-document scale (e.g. "about 0.72x its declared size") plus every offender, as warnings.
   --engine <name>         native (default) | paged (deprecated)   [overrides the manifest's engine: field; native = the Gutterpress engine, native Chromium pagination]
 ```
 

package/dist/api/index.js

@@ -122,12 +122,12 @@ import {
   validateProjectPlugins,
   verifyRepoReadable,
   writeAppHeartbeat
-} from "../index-05y3dnxq.js";
+} from "../index-ge7q9xj3.js";
 import {
   BuildError,
   DEFAULT_PRINT_OPTS,
   readyProbeExpr
-} from "../index-9tyq9kks.js";
+} from "../index-ycpvr0am.js";
 import {
   AUTO_SNAPSHOT_MESSAGE,
   HISTORY_PAGE_LIMIT,

package/dist/{audit-k1vnfwvc.js → audit-cvarpa72.js}

@@ -1,15 +1,15 @@
 import {
   executeAndReport
-} from "./cli-n25qycwz.js";
+} from "./cli-eq5naw4m.js";
 import {
   log
-} from "./cli-ra0ed2xt.js";
+} from "./cli-cqtggsng.js";
 import {
   UsageError,
   rejectExtraPositionals,
   rejectUnknownFlags
-} from "./cli-0r0tq16s.js";
-import"./cli-hp9r2pzt.js";
+} from "./cli-149edp6b.js";
+import"./cli-zfcryxg8.js";
 import"./cli-c41yr7he.js";
 import {
   EXIT_CODES

package/dist/{build-hqmwgvdw.js → build-6r502chw.js}

@@ -1,10 +1,10 @@
 import {
   runBuild,
   splitOutPath
-} from "./cli-n25qycwz.js";
+} from "./cli-eq5naw4m.js";
 import {
   log
-} from "./cli-ra0ed2xt.js";
+} from "./cli-cqtggsng.js";
 import {
   UsageError,
   parseEngine,
@@ -12,8 +12,8 @@ import {
   parsePdfxFlavor,
   rejectExtraPositionals,
   rejectUnknownFlags
-} from "./cli-0r0tq16s.js";
-import"./cli-hp9r2pzt.js";
+} from "./cli-149edp6b.js";
+import"./cli-zfcryxg8.js";
 import"./cli-c41yr7he.js";
 import {
   BuildError
@@ -37,6 +37,7 @@ var commandArgs = {
   "skip-lint": { type: "boolean", description: "Skip CSS linting (default: lint runs for pdf/pdfx)" },
   "skip-pre-validate": { type: "boolean", description: "Skip pre-build validation" },
   "skip-post-validate": { type: "boolean", description: "Skip post-build PDF/X validation" },
+  "allow-shrink": { type: "boolean", description: "Build anyway when content is wider than the page content box, instead of failing. Chromium then scales the WHOLE book down to fit; each offender is reported as a warning." },
   engine: { type: "string", description: "Pagination engine. Paged.js has been removed; native is the only engine. This flag is accepted but ignored (a warning fires for --engine paged)." }
 };
 var build_default = defineCommand({
@@ -66,6 +67,7 @@ var build_default = defineCommand({
         skipLint: !!args["skip-lint"],
         skipPreValidate: !!args["skip-pre-validate"],
         skipPostValidate: !!args["skip-post-validate"],
+        allowShrink: !!args["allow-shrink"],
         engine: parseEngine(args.engine),
         rawArgs: args
       });

package/dist/{cli-0r0tq16s.js → cli-149edp6b.js}

@@ -4,7 +4,7 @@ import {
 // 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",

package/dist/{cli-ra0ed2xt.js → cli-cqtggsng.js}

@@ -1,6 +1,6 @@
 import {
   package_default
-} from "./cli-0r0tq16s.js";
+} from "./cli-149edp6b.js";
 import {
   execCapture,
   findTool,

package/dist/{cli-n25qycwz.js → cli-eq5naw4m.js}

@@ -15,20 +15,21 @@ import {
   stampCreator,
   stripAnnotations,
   warn
-} from "./cli-ra0ed2xt.js";
+} from "./cli-cqtggsng.js";
 import {
   DEBOUNCE,
   UsageError,
   resolvePort
-} from "./cli-0r0tq16s.js";
+} from "./cli-149edp6b.js";
 import {
+  MARGIN_BOX_IGNORED_PROPERTIES,
   RENDER_TIMEOUT_MS,
   REQUIRED_MILESTONE,
   closeBrowser,
   getAssetPath,
   getBrowser,
   prewarmBrowser
-} from "./cli-hp9r2pzt.js";
+} from "./cli-zfcryxg8.js";
 import {
   INSTALL_HINTS,
   execCapture,
@@ -1089,17 +1090,6 @@ import { readFile as readFile3 } from "node:fs/promises";
 
 // src/lib/printsafe.ts
 import postcss 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";
@@ -3291,6 +3281,9 @@ function warn2(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)
@@ -3352,14 +3345,14 @@ function plugin(md, pluginOptions = {}) {
       const unknown = parsed.__unknownTokens;
       delete parsed.__unknownTokens;
       for (const t of unknown) {
-        warn2(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);
+        warn2(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(", ");
-      warn2(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);
+      warn2(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;
@@ -3451,7 +3444,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");
@@ -3466,7 +3464,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>
@@ -3489,13 +3487,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;
+      warn2(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;
+      warn2(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;
       }
@@ -3521,6 +3557,7 @@ function plugin(md, pluginOptions = {}) {
         continue;
       }
       if (kind === "section") {
+        warnIfEmptyDecoratedSection("section", line);
         stack.close("section");
         const spread = stack.get("spread");
         if (spread && spread.noPagesYet) {
@@ -3549,6 +3586,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");
@@ -3557,6 +3595,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") || "";
@@ -3572,6 +3611,7 @@ function plugin(md, pluginOptions = {}) {
         continue;
       }
       if (kind === "end-section") {
+        warnIfEmptyDecoratedSection("end-section", line);
         stack.close("section");
         continue;
       }
@@ -3659,7 +3699,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; }
@@ -6006,6 +6046,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
@@ -6068,8 +6128,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. */
@@ -6839,6 +6905,76 @@ async function writeBuildFingerprint(input) {
   return outPath;
 }
 
+// src/lib/build-preflight.ts
+var INSTALL_HINTS2 = {
+  gs: INSTALL_HINTS.gs.body,
+  qpdf: INSTALL_HINTS.qpdf.body
+};
+function rendersInPooledChromium(format, opts) {
+  return format !== "html" && !opts.engineBrowser;
+}
+async function preflightBuildTools(format, opts, config) {
+  const missing = [];
+  if (rendersInPooledChromium(format, opts) && !await resolveChromiumExecutable()) {
+    await requireChromiumExecutable();
+  }
+  if (format === "pdfx" && !await resolveGhostscript()) {
+    missing.push({ name: "gs (Ghostscript)", installHint: INSTALL_HINTS2.gs });
+  }
+  if (format === "pdfx") {
+    const stripAnnotations2 = opts.stripAnnotations ?? config.pdfx.stripAnnotations;
+    if (stripAnnotations2 && !await isToolAvailable("qpdf")) {
+      missing.push({ name: "qpdf", installHint: INSTALL_HINTS2.qpdf });
+    }
+  }
+  if (missing.length === 0)
+    return;
+  const list = missing.map((m) => `  • ${m.name}
+${m.installHint}`).join(`
+
+`);
+  throw new BuildError(`Required system tools not found:
+
+${list}
+
+Install the missing tools and re-run, or set GHOSTSCRIPT_PATH, CHROMIUM_PATH, or system PATH so gutterpress can find them. See the User Guide Chapter 7 (System Setup) at examples/gutterpress-user-guide/07-system-setup.md for the full per-feature matrix.`, 2);
+}
+async function verifyNativeChromiumMilestone() {
+  let version;
+  try {
+    const browser = await getBrowser(RENDER_TIMEOUT_MS);
+    version = await browser.version();
+  } catch (err) {
+    throw new BuildError(`Could not launch a Chromium browser for --engine native: ` + `${err instanceof Error ? err.message : String(err)}`, 2);
+  }
+  const milestone = Number(/Chrome\/(\d+)/.exec(version)?.[1] ?? 0);
+  if (milestone < REQUIRED_MILESTONE) {
+    await closeBrowser();
+    throw new BuildError(`The Gutterpress native engine requires Chromium ${REQUIRED_MILESTONE}+; found ${version}.
+
+` + `Install a newer Chrome, Chromium, or Edge, or point CHROMIUM_PATH ` + `(or PUPPETEER_EXECUTABLE_PATH) at a ${REQUIRED_MILESTONE}+ binary.
+
+` + `Note: this applies to the CLI's own Chromium only — the desktop app ` + `renders --engine native with its own bundled browser and needs no ` + `separate install.`, 2);
+  }
+}
+function computeGates(format, opts, config) {
+  if (format === "html") {
+    if (opts.skipLint || opts.skipPreValidate || opts.skipPostValidate) {
+      log.info("Validation/lint flags ignored for --format html (no validation phases apply)");
+    }
+    return { lint: false, preValidate: false, postValidate: false };
+  }
+  const lint2 = !opts.skipLint && config.lint.enabled !== false;
+  const preValidate = !opts.skipPreValidate && config.validate.enabled !== false;
+  const postValidate = format === "pdfx" && !opts.skipPostValidate && config.validate.enabled !== false;
+  return { lint: lint2, preValidate, postValidate };
+}
+
+// src/lib/build-staging.ts
+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";
@@ -7016,75 +7152,7 @@ function placeholderPng(width = 640, height = 480, cell = 32) {
   return png;
 }
 
-// src/lib/build-preflight.ts
-var INSTALL_HINTS2 = {
-  gs: INSTALL_HINTS.gs.body,
-  qpdf: INSTALL_HINTS.qpdf.body
-};
-function rendersInPooledChromium(format, opts) {
-  return format !== "html" && !opts.engineBrowser;
-}
-async function preflightBuildTools(format, opts, config) {
-  const missing = [];
-  if (rendersInPooledChromium(format, opts) && !await resolveChromiumExecutable()) {
-    await requireChromiumExecutable();
-  }
-  if (format === "pdfx" && !await resolveGhostscript()) {
-    missing.push({ name: "gs (Ghostscript)", installHint: INSTALL_HINTS2.gs });
-  }
-  if (format === "pdfx") {
-    const stripAnnotations2 = opts.stripAnnotations ?? config.pdfx.stripAnnotations;
-    if (stripAnnotations2 && !await isToolAvailable("qpdf")) {
-      missing.push({ name: "qpdf", installHint: INSTALL_HINTS2.qpdf });
-    }
-  }
-  if (missing.length === 0)
-    return;
-  const list = missing.map((m) => `  • ${m.name}
-${m.installHint}`).join(`
-
-`);
-  throw new BuildError(`Required system tools not found:
-
-${list}
-
-Install the missing tools and re-run, or set GHOSTSCRIPT_PATH, CHROMIUM_PATH, or system PATH so gutterpress can find them. See the User Guide Chapter 7 (System Setup) at examples/gutterpress-user-guide/07-system-setup.md for the full per-feature matrix.`, 2);
-}
-async function verifyNativeChromiumMilestone() {
-  let version;
-  try {
-    const browser = await getBrowser(RENDER_TIMEOUT_MS);
-    version = await browser.version();
-  } catch (err) {
-    throw new BuildError(`Could not launch a Chromium browser for --engine native: ` + `${err instanceof Error ? err.message : String(err)}`, 2);
-  }
-  const milestone = Number(/Chrome\/(\d+)/.exec(version)?.[1] ?? 0);
-  if (milestone < REQUIRED_MILESTONE) {
-    await closeBrowser();
-    throw new BuildError(`The Gutterpress native engine requires Chromium ${REQUIRED_MILESTONE}+; found ${version}.
-
-` + `Install a newer Chrome, Chromium, or Edge, or point CHROMIUM_PATH ` + `(or PUPPETEER_EXECUTABLE_PATH) at a ${REQUIRED_MILESTONE}+ binary.
-
-` + `Note: this applies to the CLI's own Chromium only — the desktop app ` + `renders --engine native with its own bundled browser and needs no ` + `separate install.`, 2);
-  }
-}
-function computeGates(format, opts, config) {
-  if (format === "html") {
-    if (opts.skipLint || opts.skipPreValidate || opts.skipPostValidate) {
-      log.info("Validation/lint flags ignored for --format html (no validation phases apply)");
-    }
-    return { lint: false, preValidate: false, postValidate: false };
-  }
-  const lint2 = !opts.skipLint && config.lint.enabled !== false;
-  const preValidate = !opts.skipPreValidate && config.validate.enabled !== false;
-  const postValidate = format === "pdfx" && !opts.skipPostValidate && config.validate.enabled !== false;
-  return { lint: lint2, preValidate, postValidate };
-}
-
 // src/lib/build-staging.ts
-import path6 from "node:path";
-import os from "node:os";
-import fsp from "node:fs/promises";
 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"));
@@ -7093,6 +7161,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-"));
 }
@@ -7205,67 +7317,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)];
@@ -7363,11 +7443,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-wa7y9av9.js");
+      const { buildNativePdf } = await import("./engine-ft4cr3ep.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);

package/dist/{cli-revgt4pr.js → cli-yzf38679.js}

@@ -21,6 +21,7 @@ var previewArgs = {
   "skip-lint": { type: "boolean", description: "Skip CSS linting (pdf|pdfx only)" },
   "skip-pre-validate": { type: "boolean", description: "Skip pre-build validation (pdf|pdfx only)" },
   "skip-post-validate": { type: "boolean", description: "Skip post-build PDF/X validation (pdfx only)" },
+  "allow-shrink": { type: "boolean", description: "Build anyway when content is wider than the page content box, instead of failing. Chromium then scales the WHOLE book down to fit; the scale and each offender are reported as warnings. (pdf|pdfx only)" },
   engine: { type: "string", description: "Pagination engine. Paged.js has been removed; native is the only engine. This flag is accepted but ignored (a warning fires for --engine paged)." }
 };