gutterpress 0.11.22-alpha.1 → 0.11.22-alpha.3

package/dist/{index-tkjvs1gf.js → index-p1a596m0.js}

@@ -29,7 +29,7 @@ import {
   uniqueExtensionId,
   withFetchTimeout,
   writeManifestDoc
-} from "./index-dm7hx46j.js";
+} from "./index-xe83m9mc.js";
 import {
   EXTENSION_MANIFEST_FILENAME,
   GUTTERPRESS_CSS,
@@ -64,19 +64,21 @@ import {
   setLogLevel,
   slugify,
   warn
-} from "./index-38e18a7j.js";
+} from "./index-thmwa4f5.js";
 import {
   blackTextToGray
 } from "./index-ht1bcqdd.js";
 import {
   MARGIN_BOX_IGNORED_PROPERTIES,
+  extract,
   lastPageMode,
-  parseSize
-} from "./index-5h9a38jn.js";
+  parseSize,
+  resolvePage
+} from "./index-apc8w9w8.js";
 import {
   BuildError,
   getAssetPath
-} from "./index-dhknsvfz.js";
+} from "./index-jsz0s3dy.js";
 import {
   countLinkAnnotations,
   getImageResolutions,
@@ -89,7 +91,7 @@ import {
   loadPdf,
   pageHasMarks,
   retainPdfCache
-} from "./index-sth219v1.js";
+} from "./index-2ppw6q9v.js";
 import {
   INSTALL_HINTS,
   enhancedPath,
@@ -184,6 +186,17 @@ function canonicalChapterId(p) {
 }
 
 // src/engine/shared/print-area.ts
+function isPositivePoints(value) {
+  return typeof value === "number" && Number.isFinite(value) && value > 0;
+}
+var round3 = (n) => Math.round(n * 1000) / 1000;
+function cssLength(pt) {
+  const inches = round3(pt / 72);
+  return Math.abs(inches * 72 - pt) < 0.000001 ? `${inches}in` : `${round3(pt)}pt`;
+}
+function formatPageSize(page) {
+  return `${cssLength(page.width)} ${cssLength(page.height)}`;
+}
 function printAreaMeta(page) {
   const area = JSON.stringify({
     width: page.width,
@@ -197,8 +210,71 @@ function printAreaMeta(page) {
   });
   return `<meta name="gp-print-area" content='${area.replace(/&/g, "&amp;").replace(/'/g, "&#39;")}'>`;
 }
+function pageBoxes(area, side, scale = 1) {
+  const w = area.width * scale;
+  const h = area.height * scale;
+  const b = Math.max(0, area.bleed) * scale;
+  const s = Math.max(0, area.safe) * scale;
+  const a = Math.max(0, area.artSafe) * scale;
+  const g = Math.max(0, area.gutter) * scale;
+  const [textLeft, textRight] = side === "verso" ? [s, g] : [g, s];
+  const [artLeft, artRight] = side === "verso" ? [a, g] : [g, a];
+  const trim = { x: side === "verso" ? b : 0, y: b, w: Math.max(0, w - b), h: Math.max(0, h - 2 * b) };
+  return {
+    sheet: { x: 0, y: 0, w, h },
+    trim,
+    safe: {
+      x: trim.x + textLeft,
+      y: trim.y + s,
+      w: Math.max(0, trim.w - textLeft - textRight),
+      h: Math.max(0, trim.h - 2 * s)
+    },
+    safeArt: {
+      x: trim.x + artLeft,
+      y: trim.y + a,
+      w: Math.max(0, trim.w - artLeft - artRight),
+      h: Math.max(0, trim.h - 2 * a)
+    },
+    bleed: b
+  };
+}
+var SEVERITY = { inside: 0, unsafe: 1, bleed: 2, "off-page": 3 };
+function judgeRect(r, boxes, rule, tol = 0) {
+  const { sheet, trim } = boxes;
+  const safe = rule === "art" ? boxes.safeArt : boxes.safe;
+  const sides = [
+    ["left", -r.x, -safe.x, -trim.x, -sheet.x],
+    ["right", r.x + r.w, safe.x + safe.w, trim.x + trim.w, sheet.x + sheet.w],
+    ["top", -r.y, -safe.y, -trim.y, -sheet.y],
+    ["bottom", r.y + r.h, safe.y + safe.h, trim.y + trim.h, sheet.y + sheet.h]
+  ];
+  let worst = { kind: "inside", gap: 0, need: 0, edge: null };
+  let beyond = 0;
+  for (const [edge, ink, limit, trimEdge, sheetEdge] of sides) {
+    const past = ink - limit;
+    if (past <= tol || rule === "art" && ink >= sheetEdge - tol)
+      continue;
+    const kind = ink > sheetEdge + tol ? "off-page" : ink > trimEdge + tol ? "bleed" : "unsafe";
+    if (SEVERITY[kind] > SEVERITY[worst.kind] || kind === worst.kind && past > beyond) {
+      worst = { kind, gap: trimEdge - ink, need: trimEdge - limit, edge };
+      beyond = past;
+    }
+  }
+  return worst;
+}
 
 // src/lib/markdown/assemble.ts
+function defaultPageSizeCss(css, page) {
+  if (!page || !isPositivePoints(page.width) || !isPositivePoints(page.height))
+    return null;
+  try {
+    if (resolvePage(extract(css)).decls.size !== undefined)
+      return null;
+  } catch {
+    return null;
+  }
+  return `@page { size: ${formatPageSize(page)}; }`;
+}
 async function assembleBookHtml(opts) {
   const title = opts.title ?? "Document";
   const projectCss = opts.projectCss ?? "";
@@ -236,6 +312,8 @@ async function assembleBookHtml(opts) {
       imageRefs.add(ref);
     opts.onImageRefs([...imageRefs]);
   }
+  const pageSize = defaultPageSizeCss(`${pluginCss}
+${projectCss}`, opts.printArea);
   const inlineCss = [
     "@layer gp.marker, gp.vocab;",
     `/* gutterpress markers */
@@ -247,6 +325,8 @@ ${TWO_VERSIONS_CSS.trim()}
 @layer gp.vocab {
 ${GUTTERPRESS_CSS.trim()}
 }`,
+    pageSize ? `/* page size (manifest) */
+${pageSize}` : null,
     pluginCss ? `/* extension css */
 ${pluginCss.trim()}` : null,
     `/* column alignment */
@@ -1827,31 +1907,39 @@ var TOLERANCE_PT = 0.5;
 var ABOVE_BASELINE = 0.8;
 var BELOW_BASELINE = 0.2;
 var inches = (pt) => `${+(pt / 72).toFixed(2)}in`;
+var size = (r) => `${(r.w / 72).toFixed(1)} x ${(r.h / 72).toFixed(1)}in`;
+var fromPdf = (x, y, w, h, sheetHeight) => ({
+  x,
+  y: sheetHeight - y - h,
+  w,
+  h
+});
 var check4 = {
   id: "pdf.print.safe-margins",
   name: "Safe margins",
-  description: "Fails when text sits closer to the trim than `page.safe` (DriveThruRPG: 0.5in on every edge), or than `page.gutter` at the binding edge where one is set. Text only: art is judged in the preview's safe-area overlay, not here. Skipped when `page.safe` is not set",
+  description: "Fails when text sits closer to the trim than `page.safe` (DriveThruRPG: 0.5in on every edge) or an image that does not bleed closer than `page.artSafe` (DriveThruRPG: 0.25in on the top, bottom and outside edges), both held to `page.gutter` at the binding edge where one is set; and when an image crosses the trim without reaching the sheet's edge (it ends in the bleed band). Text and images: filled backgrounds and borders are judged in the preview's safe-area overlay, not here. Skipped when `page.safe` is not set",
   category: "pdf",
   phase: "post-build",
   async run(ctx) {
-    const { width, height, bleed = 0, safe = 0, gutter = safe } = ctx.config.page;
+    const { width, height, bleed = 0, safe = 0, artSafe = safe, gutter = safe } = ctx.config.page;
     if (!ctx.pdfPath || !safe)
       return [];
     const doc = await loadPdf(ctx.pdfPath);
     if (!doc) {
-      return [inspectionFailed(check4.id, "Could not parse the PDF's text positions.", { file: ctx.pdfPath })];
+      return [inspectionFailed(check4.id, "Could not parse the PDF's text and image positions.", { file: ctx.pdfPath })];
     }
+    const area = { width, height, bleed, safe, artSafe, gutter };
     const rule = ctx.config.spec?.label ?? "page.safe";
+    const textRule = gutter === safe ? `${rule}: text must stay at least ${inches(safe)} inside the trim on every edge.` : `${rule}: text must stay at least ${inches(safe)} inside the trim, ${inches(gutter)} at the binding.`;
+    const artRule = gutter === artSafe ? `${rule}: art that does not bleed must stay at least ${inches(artSafe)} inside the trim on every edge.` : `${rule}: art that does not bleed must stay at least ${inches(artSafe)} inside the trim, ${inches(gutter)} at the binding.`;
     const results = [];
     try {
+      const { imagesByPage } = await getOpPass(doc);
       for (let pageNum = 1;pageNum <= doc.numPages; pageNum++) {
-        const recto = pageNum % 2 === 1;
-        const trim = {
-          left: recto ? 0 : bleed,
-          right: width - (recto ? bleed : 0),
-          bottom: bleed,
-          top: height - bleed
-        };
+        const side = pageNum % 2 === 1 ? "recto" : "verso";
+        const boxes = pageBoxes(area, side);
+        const binding = side === "recto" ? "left" : "right";
+        const edgeName = (edge) => edge === "top" || edge === "bottom" ? edge : edge === binding ? "binding" : "outside";
         const { items } = await (await doc.getPage(pageNum)).getTextContent();
         for (const item of items) {
           if (!("str" in item) || !item.str.trim())
@@ -1866,28 +1954,55 @@ var check4 = {
               ys.push(f + s * along * b + u * d);
             }
           }
-          const gaps = [
-            [recto ? "binding" : "outside", Math.min(...xs) - trim.left],
-            [recto ? "outside" : "binding", trim.right - Math.max(...xs)],
-            ["bottom", Math.min(...ys) - trim.bottom],
-            ["top", trim.top - Math.max(...ys)]
-          ];
-          const [edge, shortfall] = gaps.map(([name, gap]) => [name, (name === "binding" ? gutter : safe) - gap]).reduce((worst, g) => g[1] > worst[1] ? g : worst);
-          if (shortfall <= TOLERANCE_PT)
+          const x0 = Math.min(...xs);
+          const y0 = Math.min(...ys);
+          const box = fromPdf(x0, y0, Math.max(...xs) - x0, Math.max(...ys) - y0, height);
+          const { kind, edge, gap, need } = judgeRect(box, boxes, "text", TOLERANCE_PT);
+          if (kind === "inside")
             continue;
+          const shortfall = need - gap;
           const text = item.str.trim();
           results.push(finding(check4.id, {
             severity: "error",
-            message: `Page ${pageNum}: "${text.slice(0, 40)}${text.length > 40 ? "…" : ""}" is ${inches(shortfall)} too close to the ${edge} edge.`,
+            message: `Page ${pageNum}: "${text.slice(0, 40)}${text.length > 40 ? "…" : ""}" is ${inches(shortfall)} too close to the ${edgeName(edge)} edge.`,
             file: ctx.pdfPath,
-            detail: gutter === safe ? `${rule}: text must stay at least ${inches(safe)} inside the trim on every edge.` : `${rule}: text must stay at least ${inches(safe)} inside the trim, ${inches(gutter)} at the binding.`,
+            detail: textRule,
             code: "text-outside-safe-margin",
-            data: { page: pageNum, edge, shortfallPt: +shortfall.toFixed(2) }
+            data: { page: pageNum, edge: edgeName(edge), shortfallPt: +shortfall.toFixed(2) }
+          }));
+        }
+        for (const image of imagesByPage.get(pageNum) ?? []) {
+          const { x, y, w, h } = image.bounds;
+          const box = fromPdf(x, y, w, h, height);
+          const { kind, edge, gap, need } = judgeRect(box, boxes, "art", TOLERANCE_PT);
+          if (kind === "inside")
+            continue;
+          const name = edgeName(edge);
+          if (kind === "bleed") {
+            const short = boxes.bleed + gap;
+            results.push(finding(check4.id, {
+              severity: "error",
+              message: `Page ${pageNum}: a ${size(box)} image ends in the bleed band on the ${name} edge, ${inches(short)} short of the sheet's edge.`,
+              file: ctx.pdfPath,
+              detail: `${rule}: art either stays ${inches(artSafe)} inside the trim or bleeds, running past it to the sheet's edge; art that stops between the two can leave a white sliver when the page is cut.`,
+              code: "art-ends-in-bleed-band",
+              data: { page: pageNum, edge: name, shortfallPt: +short.toFixed(2) }
+            }));
+            continue;
+          }
+          const shortfall = need - gap;
+          results.push(finding(check4.id, {
+            severity: "error",
+            message: `Page ${pageNum}: a ${size(box)} image is ${inches(shortfall)} too close to the ${name} edge.`,
+            file: ctx.pdfPath,
+            detail: artRule,
+            code: "art-outside-safe-margin",
+            data: { page: pageNum, edge: name, shortfallPt: +shortfall.toFixed(2) }
           }));
         }
       }
     } catch {
-      return [inspectionFailed(check4.id, "Could not read the PDF's text positions.", { file: ctx.pdfPath })];
+      return [inspectionFailed(check4.id, "Could not read the PDF's text and image positions.", { file: ctx.pdfPath })];
     }
     return results;
   }
@@ -2300,16 +2415,16 @@ var check10 = {
     if (!doc) {
       return [inspectionFailed(check10.id, "Could not parse the PDF's page count.", { file: ctx.pdfPath })];
     }
-    const size = ctx.config.print.signature;
+    const size2 = ctx.config.print.signature;
     const pages = doc.numPages;
-    if ((pages + 1) % size === 0)
+    if ((pages + 1) % size2 === 0)
       return [];
-    const data = { pages, signature: size };
-    if (pages % size !== 0) {
+    const data = { pages, signature: size2 };
+    if (pages % size2 !== 0) {
       return [
         finding(check10.id, {
           severity: "error",
-          message: `Page count ${pages} does not fit a signature of ${size}: it must be a multiple of ${size}, or one short of one.`,
+          message: `Page count ${pages} does not fit a signature of ${size2}: it must be a multiple of ${size2}, or one short of one.`,
           file: ctx.pdfPath,
           detail: "Set `print.signature` in the manifest and rebuild; the build pads the interior for you.",
           code: "signature-page-count",
@@ -2330,7 +2445,7 @@ var check10 = {
         severity: "error",
         message: `The last page (${pages}) has content, but the printer needs it blank for its own information.`,
         file: ctx.pdfPath,
-        detail: "The build adds that page for you (`print.lastPage: blank`, or `short-by-one` to stop a page short of a multiple " + `of ${size} and let the printer add it). Check that the interior was built with this manifest, and that nothing in it ` + "forces content onto the final page.",
+        detail: "The build adds that page for you (`print.lastPage: blank`, or `short-by-one` to stop a page short of a multiple " + `of ${size2} and let the printer add it). Check that the interior was built with this manifest, and that nothing in it ` + "forces content onto the final page.",
         code: "signature-last-page",
         data
       })
@@ -5553,7 +5668,7 @@ 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-qwkyhrej.js");
+      const { buildNativePdf } = await import("./engine-9710cd7x.js");
       const engineDiagnostics = await buildNativePdf(htmlFile, rawPdf, {
         title: config.title,
         author: config.authors.length > 0 ? config.authors.join(", ") : undefined,
@@ -5590,7 +5705,7 @@ class PdfOutput {
         }
         const flattenPages = config.pdfx.flattenPages;
         if (transparent.length > 0 && config.pdfx.transparency === "preserve-text") {
-          const { unsplittableTextReasons } = await import("./pdf-inspect-zdmy7qca.js");
+          const { unsplittableTextReasons } = await import("./pdf-inspect-wnw4za71.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;
@@ -7099,9 +7214,6 @@ import { mkdir as mkdir5, readFile as readFile24, writeFile as writeFile7 } from
 import path13 from "node:path";
 import postcss5 from "postcss";
 import { isMap, Scalar } from "yaml";
-function isPositivePoints(value) {
-  return typeof value === "number" && Number.isFinite(value) && value > 0;
-}
 function writePageBounds(doc, page) {
   const tolerance = page.tolerance ?? numberAt(doc, ["page", "tolerance"]);
   if (!isMap(doc.get("page", true)))
@@ -7140,14 +7252,6 @@ function pageSizeForChoice(choice) {
   const base = PRESETS[choice.preset].page;
   return { width: base.width, height: base.height };
 }
-var round3 = (n) => Math.round(n * 1000) / 1000;
-function cssLength(pt) {
-  const inches2 = round3(pt / 72);
-  return Math.abs(inches2 * 72 - pt) < 0.000001 ? `${inches2}in` : `${round3(pt)}pt`;
-}
-function formatPageSize(page) {
-  return `${cssLength(page.width)} ${cssLength(page.height)}`;
-}
 var SAME_SIZE_PT = 0.5;
 function sameSize(a, b) {
   return Math.abs(a.width - b.width) < SAME_SIZE_PT && Math.abs(a.height - b.height) < SAME_SIZE_PT;
@@ -7213,9 +7317,9 @@ var relDisplay2 = (projectDir, abs) => path13.relative(projectDir, abs).split(pa
 async function findCssSize(projectDir, sheets) {
   let found = null;
   for (const file of sheets) {
-    const size = readPageSizeFromCss(await readFile24(file, "utf8"));
-    if (size)
-      found = { file, size };
+    const size2 = readPageSizeFromCss(await readFile24(file, "utf8"));
+    if (size2)
+      found = { file, size: size2 };
   }
   return found;
 }
@@ -7235,7 +7339,7 @@ async function readPageSetup(projectDir) {
   };
 }
 async function setPageSetup(projectDir, choice) {
-  const size = pageSizeForChoice(choice);
+  const size2 = pageSizeForChoice(choice);
   const sheets = await ownStylesheets(projectDir);
   const found = await findCssSize(projectDir, sheets);
   const newSheet = path13.join(projectDir, "styles", "book.css");
@@ -7243,14 +7347,14 @@ async function setPageSetup(projectDir, choice) {
   const before = existsSync8(target) ? await readFile24(target, "utf8") : "";
   let after;
   try {
-    after = setPageSizeInCss(before, size);
+    after = setPageSizeInCss(before, size2);
   } catch (e) {
     throw new UsageError(`Could not update the page size: ${relDisplay2(projectDir, target)} has a CSS error ` + `(${e instanceof Error ? e.message : String(e)}). Fix it, then try again.`);
   }
   const { doc, file } = await loadManifestDoc(projectDir);
   doc.set("preset", choice.preset);
   if (choice.preset === "custom")
-    writePageBounds(doc, size);
+    writePageBounds(doc, size2);
   else
     deletePageBounds(doc);
   if (target === newSheet && !sheets.includes(newSheet)) {
@@ -8875,10 +8979,10 @@ function isSmallBody(body) {
     return false;
   let total = 0;
   for (const c of body) {
-    const size = c?.byteLength;
-    if (typeof size !== "number")
+    const size2 = c?.byteLength;
+    if (typeof size2 !== "number")
       return false;
-    total += size;
+    total += size2;
   }
   return total <= SMALL_BODY_MAX_BYTES;
 }
@@ -12520,7 +12624,7 @@ async function resolvePublishProvider(id, book) {
   const ext = await bookExtensions(book);
   const npmEntry = ext.extensions.some((c) => !c.path && c.name === id);
   if (npmEntry) {
-    const { restoreForCommand: restoreForCommand2 } = await import("./extension-restore-926mv2qk.js");
+    const { restoreForCommand: restoreForCommand2 } = await import("./extension-restore-3gsj0qxp.js");
     await restoreForCommand2(book.projectDir, { manifestPath: book.manifestPath, failFast: true });
   }
   const publishers = await discover(ext);
@@ -12558,7 +12662,7 @@ function infoFor(p) {
 }
 function pluginProvider(p) {
   let loading;
-  const load = () => loading ??= import("./plugins-yeh4shd7.js").then((m) => m.loadPublishFunction(p));
+  const load = () => loading ??= import("./plugins-8x9rsf21.js").then((m) => m.loadPublishFunction(p));
   return {
     info: infoFor(p),
     async authenticate() {

package/dist/{index-38e18a7j.js → index-thmwa4f5.js}

@@ -37,7 +37,7 @@ import { satisfies, validRange } from "semver";
 // package.json
 var package_default = {
   name: "gutterpress",
-  version: "0.11.22-alpha.1",
+  version: "0.11.22-alpha.3",
   description: "Markdown-to-PDF converter for professional print layout using a native Chromium print engine and Ghostscript.",
   author: "itlackey",
   license: "MPL-2.0",

package/dist/{index-dm7hx46j.js → index-xe83m9mc.js}

@@ -9,12 +9,12 @@ import {
   readExtensionMeta,
   resolveExtension,
   slugify
-} from "./index-38e18a7j.js";
+} from "./index-thmwa4f5.js";
 import {
   BuildError,
   EXIT_CODES,
   getAssetsDir
-} from "./index-dhknsvfz.js";
+} from "./index-jsz0s3dy.js";
 import {
   PLUGINS_DIR,
   VENDORED_NPM_DIR,
@@ -183,7 +183,7 @@ var DTRPG_PRESET = {
     bleed: 9,
     safe: 36,
     artSafe: 18,
-    gutter: undefined
+    gutter: 36
   },
   ink: {
     maxTac: 240,

package/dist/index.js

@@ -116,7 +116,7 @@ import {
   substituteVariables,
   syncProject,
   testRemoteAccess
-} from "./index-tkjvs1gf.js";
+} from "./index-p1a596m0.js";
 import {
   BUILT_IN_STYLE_SET_IDS,
   BUNDLED_EXTENSIONS,
@@ -154,7 +154,7 @@ import {
   setExtensionEnabled,
   updateExtensions,
   validateProjectExtensions
-} from "./index-dm7hx46j.js";
+} from "./index-xe83m9mc.js";
 import {
   EXTENSION_MANIFEST_FILENAME,
   assertExtensionContained,
@@ -165,16 +165,16 @@ import {
   pathEscapesFolder,
   readExtensionMeta,
   resolveExtension
-} from "./index-38e18a7j.js";
+} from "./index-thmwa4f5.js";
 import"./index-ht1bcqdd.js";
 import {
   BUILD_DIAGNOSTIC_CODES
-} from "./index-gmfh6n05.js";
-import"./index-5h9a38jn.js";
+} from "./index-2d8j0enc.js";
+import"./index-apc8w9w8.js";
 import {
   BuildError
-} from "./index-dhknsvfz.js";
-import"./index-sth219v1.js";
+} from "./index-jsz0s3dy.js";
+import"./index-2ppw6q9v.js";
 import {
   DEFAULT_PRINT_OPTS,
   assertMilestone,

package/dist/lib/markdown/assemble.d.ts

@@ -132,8 +132,9 @@ export interface AssembleBookHtmlOptions {
      * preset id and printer spec — written as `<meta name="gp-print-area">`
      * (engine/shared/print-area.ts) into EVERY assembled book, preview, build
      * and publish alike: the preview's print overlays judge the ink against it,
-     * and both engines place pinned art on its art-safe line. Metadata only:
-     * nothing renders from it but what reads it.
+     * and both engines place pinned art on its art-safe line. Metadata only,
+     * with one exception: its `width` x `height` is also the page size the book
+     * prints at when no stylesheet sets one — see {@link defaultPageSizeCss}.
      */
     printArea?: PrintAreaSource;
     plugins?: LoadedPlugin[];

package/dist/lib/page-size.d.ts

@@ -1,5 +1,7 @@
 import type { Document } from "yaml";
 import { type PresetId } from "./presets.ts";
+import { formatPageSize, isPositivePoints } from "../engine/shared/print-area.ts";
+export { formatPageSize, isPositivePoints };
 /** Page bounds written to the manifest's `page:` block (points; 72pt = 1in). */
 export interface CustomPageOptions {
     /** Trim width in points (72pt = 1in). */
@@ -28,12 +30,11 @@ export interface PageSetup {
     bounds: (PageSizePoints & {
         tolerance: number;
     }) | null;
-    /** What the book's stylesheets print at, or null when no plain `@page` sets a size. */
+    /** What the book's stylesheets print at, or null when no plain `@page` sets a size (the book then prints at `bounds`). */
     css: (PageSizePoints & {
         file: string;
     }) | null;
 }
-export declare function isPositivePoints(value: unknown): value is number;
 /**
  * Write the manifest's `page:` bounds. `tolerance` defaults to whatever the
  * block already carries, so re-sizing a book never silently resets a
@@ -43,8 +44,6 @@ export declare function isPositivePoints(value: unknown): value is number;
 export declare function writePageBounds(doc: Document, page: CustomPageOptions): void;
 /** The size (points) a choice means: `custom` brings its own, the others are the preset's. */
 export declare function pageSizeForChoice(choice: PageSizeChoice): PageSizePoints;
-/** The `size` value written for a page: `8.5in 11in`, `595pt 842pt`. */
-export declare function formatPageSize(page: PageSizePoints): string;
 /** The size the LAST plain `@page { size }` in the stylesheet sets (cascade: last wins), or null. */
 export declare function readPageSizeFromCss(css: string): PageSizePoints | null;
 /**

package/dist/lib/pdf-inspect.d.ts

@@ -122,6 +122,18 @@ export interface ImageRef {
      */
     x: number;
     y: number;
+    /**
+     * The drawn rect in points, y up from the sheet's bottom: the unit square
+     * under the CTM as its axis-aligned bounds, so it holds for an image drawn
+     * flipped or rotated where `x`/`y`/`placedW`/`placedH` do not. The
+     * `pdf.print.safe-margins` check judges it against the art rule.
+     */
+    bounds: {
+        x: number;
+        y: number;
+        w: number;
+        h: number;
+    };
     /** 1-based page number. */
     page: number;
 }

package/dist/lib/project-scaffold.d.ts

@@ -64,9 +64,9 @@ export interface CreateProjectOptions {
     /**
      * Page geometry written into the generated manifest (points; 72pt = 1in).
      * REQUIRED when `preset` is `"custom"` (it has no built-in trim); allowed
-     * with any preset to override its trim. These are the validation bounds
-     * the built PDF is checked against — the actual trim comes from the
-     * stylesheet's `@page` rule, and the two should match.
+     * with any preset to override its trim. This is the size the book prints
+     * at, unless a stylesheet sets its own plain `@page { size }` (#415), and
+     * the size the built PDF is checked against — so the two should match.
      */
     customPage?: CustomPageOptions;
     /** Version-history mode for the new project. Defaults to `"local-git"`. */

package/dist/{manifest.schema-n292sb77.json → manifest.schema-nvawq0xv.json}

@@ -234,13 +234,13 @@
         },
         "artSafe": {
           "type": "number",
-          "description": "The ART rule, in points: how far inside the trim art that does not bleed (images, backgrounds, borders, rules) must stay on the top, bottom and OUTER edge; at the binding edge art uses `gutter`. For DriveThruRPG it is the \"non-bleeding art at least 0.25in from the outside edges (0.5in at the binding)\" rule. Art that runs out to the page's edge is a bleed and is not judged on that edge. The preview's overlay outlines it (dotted) and flags art outside it, and an image pinned to the top, bottom or outer edge (`.gp-pin`) sits on it unless it carries `.gp-flush`. Absent = the same as `safe`. Preset default: dtrpg 18 (0.25in); book and custom none.",
+          "description": "The ART rule, in points: how far inside the trim art that does not bleed (images, backgrounds, borders, rules) must stay on the top, bottom and OUTER edge; at the binding edge art uses `gutter`. For DriveThruRPG it is the \"non-bleeding art at least 0.25in from the outside edges (0.5in at the binding)\" rule. Art that runs out to the page's edge is a bleed and is not judged on that edge. The preview's overlay outlines it (dotted) and flags art outside it, the `pdf.print.safe-margins` check fails a PDF with an image closer (or one that stops in the bleed band), and an image pinned to the top, bottom or outer edge (`.gp-pin`) sits on it unless it carries `.gp-flush`. Absent = the same as `safe`. Preset default: dtrpg 18 (0.25in); book and custom none.",
           "minimum": 0,
           "examples": [18]
         },
         "gutter": {
           "type": "number",
-          "description": "The binding allowance, in points: how far content stays from the spine, measured from the trim at the binding edge (the left edge of a right-hand page, the right edge of a left-hand one). It stands in for `safe` there, for text and for art alike: the preview's overlay draws and judges that edge against it, the `pdf.print.safe-margins` check fails text closer to the spine than it, and an image pinned to the binding edge (`.gp-pin`) sits on it. The other edges keep `safe` and `artSafe`. Use it when your book keeps its text further from the spine than the printer's minimum: the Field Guide keeps 0.75in (54) where DriveThruRPG asks for 0.5in. Absent = the same as `safe`. Presets leave it unset.",
+          "description": "The binding allowance, in points: how far content stays from the spine, measured from the trim at the binding edge (the left edge of a right-hand page, the right edge of a left-hand one). It stands in for `safe` there, for text and for art alike: the preview's overlay draws and judges that edge against it, the `pdf.print.safe-margins` check fails text or an image closer to the spine than it, and an image pinned to the binding edge (`.gp-pin`) sits on it. The other edges keep `safe` and `artSafe`. Use it when your book keeps its text further from the spine than the printer's minimum: the Field Guide keeps 0.75in (54) where DriveThruRPG asks for 0.5in. Absent = the same as `safe`. Preset default: dtrpg 36 (0.5in, DriveThruRPG's rule for text and non-bleeding art at the binding — the same as its `safe`, declared so a book inherits it visibly); book and custom none.",
           "minimum": 0,
           "examples": [54]
         }

package/dist/{new-nadp2hvb.js → new-w3wdd615.js}

@@ -3,13 +3,13 @@ import {
   EXTENSION_KINDS,
   scaffoldExtension,
   scaffoldProject
-} from "./cli-fbwqv7p4.js";
+} from "./cli-17g57c61.js";
 import {
   resolveGhostscript
-} from "./cli-yejbb9f8.js";
+} from "./cli-d0x3aq49.js";
 import"./cli-ht1bcqdd.js";
-import"./cli-8hccw62p.js";
-import"./cli-sth219v1.js";
+import"./cli-9pk65fqf.js";
+import"./cli-2ppw6q9v.js";
 import"./cli-eyyggect.js";
 import {
   isToolAvailable
@@ -21,16 +21,16 @@ import {
   PRESET_IDS,
   TARGETS,
   TARGET_IDS
-} from "./cli-9vy4b6ec.js";
-import"./cli-pfrg1r9x.js";
-import"./cli-5553w972.js";
+} from "./cli-sge5cp21.js";
+import"./cli-0s8sy5n9.js";
+import"./cli-3p7jejyd.js";
 import {
   UsageError,
   rejectExtraPositionals,
   rejectUnknownFlags
 } from "./cli-d8xjns66.js";
-import"./cli-gc9av5hs.js";
-import"./cli-gmm3bdeq.js";
+import"./cli-nqvrp9wk.js";
+import"./cli-hndkg7bn.js";
 import {
   EXIT_CODES
 } from "./cli-46ycxe6r.js";

package/dist/{pdf-inspect-zdmy7qca.js → pdf-inspect-wnw4za71.js}

@@ -14,7 +14,7 @@ import {
   pendingGraceDestroyCount,
   retainPdfCache,
   unsplittableTextReasons
-} from "./cli-sth219v1.js";
+} from "./cli-2ppw6q9v.js";
 import"./cli-37x76zdn.js";
 export {
   unsplittableTextReasons,

package/dist/{plugins-yeh4shd7.js → plugins-8x9rsf21.js}

@@ -8,7 +8,7 @@ import {
   loadPlugins,
   loadPluginsWithCss,
   loadPublishFunction
-} from "./index-38e18a7j.js";
+} from "./index-thmwa4f5.js";
 import"./index-r7jcsk6h.js";
 import"./index-37x76zdn.js";
 export {

package/dist/{plugins-gy4q9vaa.js → plugins-cx4qwn7g.js}

@@ -8,9 +8,9 @@ import {
   loadPlugins,
   loadPluginsWithCss,
   loadPublishFunction
-} from "./cli-pfrg1r9x.js";
-import"./cli-5553w972.js";
-import"./cli-gc9av5hs.js";
+} from "./cli-0s8sy5n9.js";
+import"./cli-3p7jejyd.js";
+import"./cli-nqvrp9wk.js";
 import"./cli-h3phdstf.js";
 import"./cli-37x76zdn.js";
 export {