gutterpress 0.11.19 → 0.11.20-alpha.1

package/dist/{index-g7vszjqf.js → index-1y885h1j.js}

@@ -9,7 +9,7 @@ import {
   getAssetsDir,
   lastPageMode,
   parseSize
-} from "./index-jt552wtf.js";
+} from "./index-pnvzgftg.js";
 import {
   INSTALL_HINTS,
   enhancedPath,
@@ -151,13 +151,15 @@ var DTRPG_PRESET = {
     flavor: "x1a",
     icc: "profiles/CGATS21_CRPC1.icc",
     stripAnnotations: true,
-    blackText: "k-only"
+    blackText: "k-only",
+    rasterDpi: undefined
   },
   page: {
     width: 621,
     height: 810,
     tolerance: 0.5,
-    bleed: 9
+    bleed: 9,
+    safe: 18
   },
   ink: {
     maxTac: 240,
@@ -228,13 +230,15 @@ var BOOK_PRESET = {
     flavor: "x1a",
     icc: "profiles/CGATS21_CRPC1.icc",
     stripAnnotations: true,
-    blackText: "icc"
+    blackText: "icc",
+    rasterDpi: undefined
   },
   page: {
     width: 432,
     height: 648,
     tolerance: 0.5,
-    bleed: undefined
+    bleed: undefined,
+    safe: 18
   },
   ink: {
     maxTac: 400,
@@ -588,7 +592,8 @@ function resolveCustomPage(c, m) {
     width,
     height,
     tolerance: c.page?.tolerance ?? m.page?.tolerance ?? 0.5,
-    bleed: c.page?.bleed ?? m.page?.bleed
+    bleed: c.page?.bleed ?? m.page?.bleed,
+    safe: c.page?.safe ?? m.page?.safe
   };
 }
 function resolveWithPreset(cliOverrides, manifest, preset) {
@@ -621,6 +626,10 @@ function resolveWithPreset(cliOverrides, manifest, preset) {
   if (lastPage !== undefined && lastPage !== "blank" && lastPage !== "short-by-one") {
     throw new UsageError(`Manifest field \`print.lastPage\` must be "blank" or "short-by-one", got ${JSON.stringify(lastPage)}.`);
   }
+  const rasterDpi = c.pdfx?.rasterDpi ?? m.pdfx?.rasterDpi;
+  if (rasterDpi !== undefined && !(Number.isInteger(rasterDpi) && rasterDpi >= 72 && rasterDpi <= 1200)) {
+    throw new UsageError(`Manifest field \`pdfx.rasterDpi\` must be a whole number from 72 to 1200, got ${JSON.stringify(rasterDpi)}.`);
+  }
   const rawExtensions = c.extensions ?? m.extensions ?? [];
   if (!Array.isArray(rawExtensions)) {
     throw new UsageError("Manifest field `extensions` must be a list of specifiers.");
@@ -5935,6 +5944,7 @@ async function convertToPdfxCmyk(inputPdf, outPdf, config) {
     "-dDownsampleColorImages=false",
     "-dDownsampleGrayImages=false",
     "-dDownsampleMonoImages=false",
+    ...config.rasterDpi ? [`-r${config.rasterDpi}`] : [],
     "-sProcessColorModel=DeviceCMYK",
     "-sColorConversionStrategy=CMYK",
     "-dOverrideICC=true",
@@ -5984,7 +5994,7 @@ import git from "isomorphic-git";
 // package.json
 var package_default = {
   name: "gutterpress",
-  version: "0.11.19",
+  version: "0.11.20-alpha.1",
   description: "Markdown-to-PDF converter for professional print layout using a native Chromium print engine and Ghostscript.",
   author: "itlackey",
   license: "MPL-2.0",
@@ -10903,7 +10913,7 @@ class PdfOutput {
       const rawPdf = pdfxMode ? path13.join(stage, "raw.pdf") : path13.resolve(pdfFile);
       await fsp2.mkdir(path13.dirname(path13.resolve(pdfFile)), { recursive: true });
       log.info("Rendering HTML to PDF via the Gutterpress engine (native Chromium pagination)");
-      const { buildNativePdf } = await import("./engine-zehw6tkv.js");
+      const { buildNativePdf } = await import("./engine-adxptzf0.js");
       const engineDiagnostics = await buildNativePdf(htmlFile, rawPdf, {
         title: config.title,
         author: config.authors.length > 0 ? config.authors.join(", ") : undefined,
@@ -10926,7 +10936,7 @@ class PdfOutput {
         const icc = opts.iccPath ?? config.pdfx.icc;
         effectiveIccPath = await resolveIccProfile(icc, manifestDir, opts.iccPath);
         if (await hasLiveTransparency(await fsp2.readFile(rawPdf))) {
-          log.warn("This book uses transparency — an image with an alpha channel, or a CSS " + `rule like \`opacity\` or \`mix-blend-mode\`. PDF/${pdfxMode === "x1a" ? "X-1a" : "X-3"} has no way to represent that (both are based on PDF 1.3, which predates PDF transparency), so Ghostscript will flatten every page that uses it into a single raster ` + "image — that page loses its embedded fonts and searchable text in the " + "PDF/X output. To keep vector text, remove the `opacity`/blend rule and flatten any alpha-channel image against its intended background before including it (export it with no alpha channel), or build --format pdf instead of pdfx if this book doesn't need print-ready CMYK.");
+          log.warn("This book uses transparency — an image with an alpha channel, or a CSS " + `rule like \`opacity\` or \`mix-blend-mode\`. PDF/${pdfxMode === "x1a" ? "X-1a" : "X-3"} has no way to represent that (both are based on PDF 1.3, which predates PDF transparency), so Ghostscript will flatten every page that uses it into a single raster ` + "image — that page loses its embedded fonts and searchable text in the " + "PDF/X output. To keep vector text, remove the `opacity`/blend rule and flatten any alpha-channel image against its intended background before including it (export it with no alpha channel), or build --format pdf instead of pdfx if this book doesn't need print-ready CMYK. `pdfx.rasterDpi` sets the resolution of those page images (default 720).");
         }
         const blankGradientPages = await findPostScriptShadingPages(await fsp2.readFile(rawPdf));
         if (blankGradientPages.length > 0) {
@@ -10948,7 +10958,8 @@ class PdfOutput {
           pdfx: pdfxMode,
           title: config.title,
           maxTac: config.ink.maxTac,
-          stagingDir: stage
+          stagingDir: stage,
+          rasterDpi: config.pdfx.rasterDpi
         });
       }
       if (gates.postValidate) {
@@ -11130,8 +11141,9 @@ async function renderPreviewBook(inputPath, config, opts) {
     }
   });
 }
-function injectPreviewScripts(html, insetBleedPt = 0) {
-  const meta = insetBleedPt > 0 ? `  <meta name="gp-inset-bleed" content="${insetBleedPt}">
+function injectPreviewScripts(html, page) {
+  const area = page ? JSON.stringify({ width: page.width, height: page.height, bleed: page.bleed ?? 0, safe: page.safe ?? 0 }) : "";
+  const meta = area ? `  <meta name="gp-print-area" content='${area}'>
 ` : "";
   const scripts = meta + `  <script src="/engine/gutterpress-viewer.js"></script>
   ` + `<script src="/preview/scripts/preview-interface.js"></script>
@@ -11167,7 +11179,7 @@ async function generateAndWriteHtml(inputPath, tempDir, config, cssAssets, image
     for (const ref of nextImageRefs)
       imageRefs.add(ref);
   }
-  await fsp3.writeFile(path15.join(tempDir, BOOK_HTML_FILENAME), injectPreviewScripts(html, config.page?.bleed), "utf-8");
+  await fsp3.writeFile(path15.join(tempDir, BOOK_HTML_FILENAME), injectPreviewScripts(html, config.page), "utf-8");
 }
 function isDotPathUnderRoot(candidatePath, root) {
   const normalizedRoot = root.replace(/\\/g, "/").replace(/\/+$/, "");

package/dist/{index-b866g2ph.js → index-cngw658w.js}

@@ -19,7 +19,7 @@ import {
   stringValueAt,
   toFolioPage,
   wantsRecto
-} from "./index-jt552wtf.js";
+} from "./index-pnvzgftg.js";
 import {
   launchChromium
 } from "./index-bt0qws5c.js";

package/dist/{index-jt552wtf.js → index-pnvzgftg.js}

@@ -148,22 +148,22 @@ import { fileURLToPath } from "node:url";
 var favicon_default = "./favicon-272ga6y0.ico";
 
 // src/assets/manifest.schema.json
-var manifest_schema_default = "./manifest.schema-5pzhscqh.json";
+var manifest_schema_default = "./manifest.schema-nrykd2c6.json";
 
 // src/assets/preview/scripts/preview-interface.js
-var preview_interface_default = "./preview-interface-2n1d9pbf.js";
+var preview_interface_default = "./preview-interface-k2mj5kvq.js";
 
 // src/assets/preview/scripts/preview-bridge.js
 var preview_bridge_default = "./preview-bridge-evecsh4w.js";
 
 // src/assets/preview/scripts/preview-shell.js
-var preview_shell_default = "./preview-shell-hyp7g158.js";
+var preview_shell_default = "./preview-shell-7jfe6vsc.js";
 
 // profiles/CGATS21_CRPC1.icc
 var CGATS21_CRPC1_default = "./CGATS21_CRPC1-g0e3k7kr.icc";
 
 // src/assets/engine/gutterpress-viewer.js
-var gutterpress_viewer_default = "./gutterpress-viewer-k4mpqjh0.js";
+var gutterpress_viewer_default = "./gutterpress-viewer-0r4rt4de.js";
 
 // src/assets/engine/gutterpress-agent.js
 var gutterpress_agent_default = "./gutterpress-agent-cazqstr1.js";

package/dist/index.js

@@ -154,14 +154,14 @@ import {
   testRemoteAccess,
   updateExtensions,
   validateProjectExtensions
-} from "./index-g7vszjqf.js";
+} from "./index-1y885h1j.js";
 import"./index-ht1bcqdd.js";
 import {
   BUILD_DIAGNOSTIC_CODES
-} from "./index-b866g2ph.js";
+} from "./index-cngw658w.js";
 import {
   BuildError
-} from "./index-jt552wtf.js";
+} from "./index-pnvzgftg.js";
 import {
   DEFAULT_PRINT_OPTS,
   assertMilestone,

package/dist/lib/ghostscript.d.ts

@@ -100,5 +100,12 @@ export declare function convertToPdfxCmyk(inputPdf: string, outPdf: string, conf
     title?: string;
     maxTac?: number;
     stagingDir: string;
+    /**
+     * Resolution of the picture Ghostscript makes of a page it flattens
+     * (`pdfx.rasterDpi`). Unset keeps Ghostscript's own default (720 DPI).
+     * pdfwrite uses it only for rendering it must do, such as transparency
+     * flattening: vector content is unaffected.
+     */
+    rasterDpi?: number;
 }): Promise<void>;
 export {};

package/dist/{manifest.schema-5pzhscqh.json → manifest.schema-nrykd2c6.json}

@@ -154,6 +154,13 @@
           "description": "How near-black text is separated. `icc` converts it through the ICC profile (rich, four-colour black). `k-only` prints it on the black plate alone (100% K), which print vendors such as DriveThruRPG require for small text. Non-text black (rules, panels) is unaffected. Preset defaults: dtrpg `k-only`, book `icc`.",
           "enum": ["icc", "k-only"],
           "default": "icc"
+        },
+        "rasterDpi": {
+          "type": "integer",
+          "description": "Resolution (DPI) of the picture Ghostscript makes of a page it flattens in a PDF/X build because the page uses transparency (PDF/X-1a and X-3 cannot hold it). Lower is smaller and softer; vector content on other pages and the book's own images are not resampled. Unset: Ghostscript's default, 720.",
+          "minimum": 72,
+          "maximum": 1200,
+          "examples": [300]
         }
       }
     },
@@ -203,9 +210,15 @@
         },
         "bleed": {
           "type": "number",
-          "description": "A bleed, in points, that the page width x height ALREADY CONTAINS on the top, bottom and OUTER edges (none on the binding edge) — how DriveThruRPG's interior file is cut (8.625 x 11.25in for an 8.5 x 11in book). Preview overlay only: it tells the margin & bleed overlay where the trim is and changes nothing in the PDF. CSS `@page { bleed }` wins when the stylesheet declares one. Preset default: dtrpg 9 (0.125in); book and custom none.",
+          "description": "A bleed, in points, that the page width x height ALREADY CONTAINS on the top, bottom and OUTER edges (none on the binding edge) — how DriveThruRPG's interior file is cut (8.625 x 11.25in for an 8.5 x 11in book). Preview overlay only: it tells the safe area & bleed overlay where the trim is and changes nothing in the PDF. Preset default: dtrpg 9 (0.125in); book and custom none.",
           "minimum": 0,
           "examples": [9]
+        },
+        "safe": {
+          "type": "number",
+          "description": "The safe area's inset, in points, from the trim on every edge: the preview's overlay outlines it and flags content outside it. Preview overlay only: it changes nothing in the PDF, and no book CSS moves it. Preset default: dtrpg and book 18 (0.25in); custom none.",
+          "minimum": 0,
+          "examples": [18, 36]
         }
       }
     },

package/dist/{new-ckpas1ya.js → new-y4a2xz3g.js}

@@ -7,17 +7,17 @@ import {
   TARGET_IDS,
   scaffoldExtension,
   scaffoldProject
-} from "./cli-aw614ztv.js";
+} from "./cli-x1nfhaf1.js";
 import {
   resolveGhostscript
-} from "./cli-dzw28t3s.js";
+} from "./cli-mmm22cza.js";
 import {
   UsageError,
   rejectExtraPositionals,
   rejectUnknownFlags
-} from "./cli-cgbzdrwz.js";
+} from "./cli-7shp2kmj.js";
 import"./cli-ht1bcqdd.js";
-import"./cli-xx94a1k6.js";
+import"./cli-rtpm04dv.js";
 import {
   EXIT_CODES
 } from "./cli-46ycxe6r.js";

package/dist/{preflight-yh57q9nn.js → preflight-kt7wfgbd.js}

@@ -2,17 +2,17 @@ import {
   executeValidation,
   publishTargetFor,
   reportMissingTools
-} from "./cli-aw614ztv.js";
+} from "./cli-x1nfhaf1.js";
 import {
   log
-} from "./cli-dzw28t3s.js";
+} from "./cli-mmm22cza.js";
 import {
   UsageError,
   rejectExtraPositionals,
   rejectUnknownFlags
-} from "./cli-cgbzdrwz.js";
+} from "./cli-7shp2kmj.js";
 import"./cli-ht1bcqdd.js";
-import"./cli-xx94a1k6.js";
+import"./cli-rtpm04dv.js";
 import {
   BuildError,
   EXIT_CODES

package/dist/preview/file-watcher.d.ts

@@ -22,7 +22,12 @@ import type { PrintPadding } from '../engine/shared/synthesis.ts';
  * no per-source wrappers or forced breaks are added, so preview pagination
  * never diverges from the PDF where a source file begins mid-page.
  */
-export declare function injectPreviewScripts(html: string, insetBleedPt?: number): string;
+export declare function injectPreviewScripts(html: string, page?: {
+    width: number;
+    height: number;
+    bleed?: number;
+    safe?: number;
+}): string;
 /**
  * Generate HTML from markdown and write book.html to the temp directory.
  * The desktop's iframe loads `book.html` via a relative URL — same name in
@@ -46,7 +51,10 @@ export declare function generateAndWriteHtml(inputPath: string, tempDir: string,
     extensions?: ResolvedExtensionConfig[];
     print?: PrintPadding;
     page?: {
+        width: number;
+        height: number;
         bleed?: number;
+        safe?: number;
     };
 }, cssAssets: Map<string, string>, imageRefs?: Set<string>): Promise<void>;
 /**

package/dist/{preview-a4x2ezjp.js → preview-5ze728kp.js}

@@ -6,10 +6,10 @@ import {
   runBuild,
   splitOutPath,
   startPreviewServer
-} from "./cli-aw614ztv.js";
+} from "./cli-x1nfhaf1.js";
 import {
   log
-} from "./cli-dzw28t3s.js";
+} from "./cli-mmm22cza.js";
 import {
   UsageError,
   parseFormat,
@@ -17,9 +17,9 @@ import {
   rejectExtraPositionals,
   rejectUnknownFlags,
   resolvePort
-} from "./cli-cgbzdrwz.js";
+} from "./cli-7shp2kmj.js";
 import"./cli-ht1bcqdd.js";
-import"./cli-xx94a1k6.js";
+import"./cli-rtpm04dv.js";
 import {
   BuildError
 } from "./cli-46ycxe6r.js";

package/dist/{preview-interface-2n1d9pbf.js → preview-interface-k2mj5kvq.js}

@@ -1105,13 +1105,13 @@
     // second argument — the look, below — is part of v9, not a bump.)
     getProtocolVersion: function () { return 9; },
 
-    // Margin & bleed overlay. Viewer chrome only — it adds no box to the book
-    // and no attribute to its elements, so pagination is identical on or off.
-    // Returns the summary {on, issues, intended, bleedPt}, or null when the
-    // viewer predates it. `style` ({color: '#rrggbb', strength: 'subtle' |
-    // 'normal' | 'strong'}) is optional: it only sets the viewer's own
-    // `--gp-ov-*` tokens, and a call that carries it while the overlay is
-    // already on restyles without repainting.
+    // Safe area & bleed overlay. Viewer chrome only — it adds no box to the
+    // book and no attribute to its elements, so pagination is identical on or
+    // off. Returns the summary {on, issues, intended, bleedPt, safePt}, or null
+    // when the viewer predates it. `style` ({color: '#rrggbb', strength:
+    // 'subtle' | 'normal' | 'strong'}) is optional: it only sets the overlay's
+    // own tokens, and a call that carries it while the overlay is already on
+    // restyles without repainting.
     setMarginOverlay: function (on, style) {
       var d = window.Gutterpress && window.Gutterpress.decoration;
       return d && typeof d.setOverlay === 'function' ? d.setOverlay(!!on, style) : null;
@@ -1629,7 +1629,7 @@
   // completes (engine/viewer/index.ts's mount()).
   window.addEventListener('gp:layout', onRenderingComplete);
 
-  // Margin & bleed overlay: relay the viewer's result as 'overlayChanged' (the
+  // Safe area & bleed overlay: relay the viewer's result as 'overlayChanged' (the
   // bridge posts it to a host toolbar) and, where no host toolbar exists, give
   // the standalone CLI preview its own switch: Alt+M, plus a small status pill.
   // "Standalone" = the shell is top level (the CLI); under the desktop app the
@@ -1652,11 +1652,11 @@
         'padding:4px 10px;border-radius:999px;box-shadow:0 1px 6px rgba(0,0,0,.4)';
       document.documentElement.appendChild(badge);
     }
-    var parts = ['Margins & bleed'];
-    parts.push(summary.issues ? summary.issues + ' overflowing' : 'nothing overflows');
+    var parts = ['Safe area & bleed'];
+    parts.push(summary.issues ? summary.issues + ' outside the safe area' : 'everything inside the safe area');
     if (summary.intended) parts.push(summary.intended + ' placed on purpose');
-    if (summary.bleedInSheet) parts.push('bleed inside the page (print preset)');
-    if (!summary.bleedPt) parts.push('no bleed set \u2014 add @page { bleed: 0.125in } to see the bleed edge');
+    if (!summary.safePt) parts.push('no safe area set (page.safe in manifest.yaml)');
+    if (!summary.bleedPt) parts.push('no bleed set (page.bleed in manifest.yaml)');
     badge.textContent = parts.join(' \u00b7 ') + '  (Alt+M hides)';
   }
 

package/dist/{preview-shell-hyp7g158.js → preview-shell-7jfe6vsc.js}

@@ -106,12 +106,12 @@
       else if (sourceBody.classList.contains('view-spread')) api.setViewMode('spread', true);
       else if (sourceBody.classList.contains('view-two-column')) api.setViewMode('two-column', true);
       if (sourceBody.classList.contains('debug')) api.toggleDebugMode();
-      // The margin & bleed overlay is a review aid the author switched on: a
-      // hot reload must not drop it.
+      // The safe area & bleed overlay is a review aid the author switched on:
+      // a hot reload must not drop it.
       // Its look (colour, strength) travels with it.
       if (sourceBody.dataset.overlay === 'on' && api.setMarginOverlay) {
         api.setMarginOverlay(true, {
-          color: sourceBody.style.getPropertyValue('--gp-ov-color').trim(),
+          color: sourceBody.dataset.overlayColor,
           strength: sourceBody.dataset.overlayStrength
         });
       }

package/dist/{publish-sfn5hmnx.js → publish-5tpcyysh.js}

@@ -11,18 +11,18 @@ import {
   publishProviderFor,
   resolvePublishFormat,
   runPublish
-} from "./cli-aw614ztv.js";
+} from "./cli-x1nfhaf1.js";
 import {
   FileTokenStore,
   log
-} from "./cli-dzw28t3s.js";
+} from "./cli-mmm22cza.js";
 import {
   UsageError,
   rejectExtraPositionals,
   rejectUnknownFlags
-} from "./cli-cgbzdrwz.js";
+} from "./cli-7shp2kmj.js";
 import"./cli-ht1bcqdd.js";
-import"./cli-xx94a1k6.js";
+import"./cli-rtpm04dv.js";
 import {
   EXIT_CODES
 } from "./cli-46ycxe6r.js";

package/dist/schema/manifest.types.d.ts

@@ -118,6 +118,11 @@ export interface GutterpressManifest {
         stripAnnotations?: boolean;
         /** `k-only` prints near-black text on the black plate alone (#331). */
         blackText?: "icc" | "k-only";
+        /**
+         * Resolution (DPI) of the picture Ghostscript makes of a page it flattens
+         * because the page uses transparency. Unset: Ghostscript's default (720).
+         */
+        rasterDpi?: number;
     };
     /**
      * Native-engine print-production options with no other manifest home
@@ -150,11 +155,17 @@ export interface GutterpressManifest {
          * A bleed (pt) the page `width` x `height` ALREADY CONTAINS, on the top,
          * bottom and OUTER edges only (the binding edge has none) — how
          * DriveThruRPG's interior file is cut (8.625 x 11.25in for an 8.5 x 11in
-         * book). It changes nothing in the PDF: it only tells the preview's margin
-         * & bleed overlay where the trim is. CSS `@page { bleed }` (symmetric,
-         * grows the page) wins when the stylesheet declares one.
+         * book). It changes nothing in the PDF: it only tells the preview's safe
+         * area & bleed overlay where the trim is.
          */
         bleed?: number;
+        /**
+         * The safe area's inset (pt) from the trim on every edge: what the
+         * preview's overlay outlines as the area content must stay inside. Like
+         * `bleed`, overlay-only: it changes nothing in the PDF, and nothing in a
+         * book's CSS moves it.
+         */
+        safe?: number;
     };
     ink?: {
         maxTac?: number;
@@ -260,6 +271,7 @@ export interface ResolvedConfig {
         icc: string;
         stripAnnotations: boolean;
         blackText: "icc" | "k-only";
+        rasterDpi?: number;
     };
     print: {
         signature: number;
@@ -272,6 +284,8 @@ export interface ResolvedConfig {
         tolerance: number;
         /** In-sheet bleed in pt (top, bottom, outer edge; see the manifest field); absent = none. */
         bleed?: number;
+        /** Safe-area inset from the trim in pt (see the manifest field); absent = none. */
+        safe?: number;
     };
     ink: {
         maxTac: number;

package/dist/{validate-281rsdsv.js → validate-p0hkqkfe.js}

@@ -1,16 +1,16 @@
 import {
   executeAndReport
-} from "./cli-aw614ztv.js";
+} from "./cli-x1nfhaf1.js";
 import {
   log
-} from "./cli-dzw28t3s.js";
+} from "./cli-mmm22cza.js";
 import {
   UsageError,
   rejectExtraPositionals,
   rejectUnknownFlags
-} from "./cli-cgbzdrwz.js";
+} from "./cli-7shp2kmj.js";
 import"./cli-ht1bcqdd.js";
-import"./cli-xx94a1k6.js";
+import"./cli-rtpm04dv.js";
 import {
   BuildError,
   EXIT_CODES

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gutterpress",
-  "version": "0.11.19",
+  "version": "0.11.20-alpha.1",
   "description": "Markdown-to-PDF converter for professional print layout using a native Chromium print engine and Ghostscript.",
   "author": "itlackey",
   "license": "MPL-2.0",