gutterpress 0.11.19 → 0.11.20-alpha.2

package/dist/index.js

@@ -154,14 +154,14 @@ import {
   testRemoteAccess,
   updateExtensions,
   validateProjectExtensions
-} from "./index-g7vszjqf.js";
+} from "./index-razpty47.js";
 import"./index-ht1bcqdd.js";
 import {
   BUILD_DIAGNOSTIC_CODES
-} from "./index-b866g2ph.js";
+} from "./index-6xwtb7cw.js";
 import {
   BuildError
-} from "./index-jt552wtf.js";
+} from "./index-3nr5rzzp.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/lib/presets.d.ts

@@ -8,7 +8,9 @@ import type { ResolvedConfig } from "../schema/manifest.types";
  * Every preset value is overridable from the manifest, leaf by leaf
  * (resolveConfig's mergeShape; precedence cli > manifest > target > preset).
  */
-export interface VendorPreset extends Omit<ResolvedConfig, "title" | "authors" | "targets" | "page"> {
+export interface VendorPreset extends Omit<ResolvedConfig, "title" | "authors" | "preset" | "targets" | "page"> {
+    /** This preset's id: what the manifest's `preset:` names and a resolved config reports. */
+    id: PresetId;
     /**
      * Base page geometry in points, or `null` for `custom` — the one preset
      * with no built-in trim, which therefore REQUIRES the manifest to supply

package/dist/{manifest.schema-5pzhscqh.json → manifest.schema-74s1ykyv.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,21 @@
         },
         "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). It tells the preview's safe area & bleed overlay and the `pdf.print.safe-margins` check 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 TEXT rule, in points: how far inside the trim glyphs must stay, on every edge. For DriveThruRPG it is the \"text at least 0.5in inside the trim\" rule. The preview's overlay outlines it (dashed) and flags text outside it, and the `pdf.print.safe-margins` check fails a PDF whose text is closer. It changes nothing in the PDF, and no book CSS moves it. Preset default: dtrpg 36 (0.5in), book 18 (0.25in); custom none.",
+          "minimum": 0,
+          "examples": [18, 36]
+        },
+        "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 `safe`. 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. Preview overlay only: it changes nothing in the PDF. Absent = the same as `safe`. Preset default: dtrpg 18 (0.25in); book and custom none.",
+          "minimum": 0,
+          "examples": [18]
         }
       }
     },

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

@@ -7,17 +7,17 @@ import {
   TARGET_IDS,
   scaffoldExtension,
   scaffoldProject
-} from "./cli-aw614ztv.js";
+} from "./cli-zacevwcy.js";
 import {
   resolveGhostscript
-} from "./cli-dzw28t3s.js";
+} from "./cli-gh0ym80r.js";
 import {
   UsageError,
   rejectExtraPositionals,
   rejectUnknownFlags
-} from "./cli-cgbzdrwz.js";
+} from "./cli-7z29z4wz.js";
 import"./cli-ht1bcqdd.js";
-import"./cli-xx94a1k6.js";
+import"./cli-j802s31j.js";
 import {
   EXIT_CODES
 } from "./cli-46ycxe6r.js";

package/dist/{preflight-yh57q9nn.js → preflight-8sqarcsr.js}

@@ -2,17 +2,17 @@ import {
   executeValidation,
   publishTargetFor,
   reportMissingTools
-} from "./cli-aw614ztv.js";
+} from "./cli-zacevwcy.js";
 import {
   log
-} from "./cli-dzw28t3s.js";
+} from "./cli-gh0ym80r.js";
 import {
   UsageError,
   rejectExtraPositionals,
   rejectUnknownFlags
-} from "./cli-cgbzdrwz.js";
+} from "./cli-7z29z4wz.js";
 import"./cli-ht1bcqdd.js";
-import"./cli-xx94a1k6.js";
+import"./cli-j802s31j.js";
 import {
   BuildError,
   EXIT_CODES

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

@@ -6,7 +6,7 @@
  */
 import { type FSWatcher } from 'chokidar';
 import type { ServerState } from './server-context';
-import type { ResolvedExtensionConfig } from '../schema/manifest.types';
+import type { PrintSpec, ResolvedExtensionConfig } from '../schema/manifest.types';
 import type { PrintPadding } from '../engine/shared/synthesis.ts';
 /**
  * Rewrite rendered book HTML for the live preview: inject the Gutterpress
@@ -22,7 +22,15 @@ 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;
+    artSafe?: number;
+    preset?: string;
+    spec?: PrintSpec;
+}): 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,8 +54,14 @@ export declare function generateAndWriteHtml(inputPath: string, tempDir: string,
     extensions?: ResolvedExtensionConfig[];
     print?: PrintPadding;
     page?: {
+        width: number;
+        height: number;
         bleed?: number;
+        safe?: number;
+        artSafe?: number;
     };
+    preset?: string;
+    spec?: PrintSpec;
 }, cssAssets: Map<string, string>, imageRefs?: Set<string>): Promise<void>;
 /**
  * Chokidar 5's `ignored` matcher (regex or function) is tested against the

package/dist/{preview-bridge-evecsh4w.js → preview-bridge-8wjcjec3.js}

@@ -14,7 +14,7 @@
 //
 // Commands map 1:1 to previewAPI methods: getTotalPages, getCurrentPage,
 // goToPage, firstPage, prevPage, nextPage, lastPage, setViewMode, setZoom,
-// toggleDebugMode, setMarginOverlay(on, {color, strength}). Plus a synthetic 'print' command that calls window.print().
+// toggleDebugMode, setMarginOverlay(state, {strength, colors}). Plus a synthetic 'print' command that calls window.print().
 //
 // Additional messages:
 //   parent -> iframe: { type: 'gutterpress:inject-styles', id: <attr-name>, css: <string> }
@@ -82,7 +82,8 @@
   window.addEventListener('contextMenuRequested', function (e) {
     post({ type: 'gutterpress:event', name: 'contextMenuRequested', detail: e.detail });
   });
-  // Margin & bleed overlay result (protocol v9): {on, issues, intended, bleedPt}.
+  // Margin & bleed overlay result (protocol v9): {on, issues, intended, bleedPt,
+  // safePt, artSafePt, counts}.
   window.addEventListener('overlayChanged', function (e) {
     post({ type: 'gutterpress:event', name: 'overlayChanged', detail: e.detail });
   });

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

@@ -1098,27 +1098,43 @@
     // "Edit this block" action and nothing else; a v8 SPA feature-detects on
     // the version before offering it.
     // v9: ADDED setMarginOverlay()/toggleMarginOverlay()/getMarginOverlay() and
-    // the overlayChanged event (margin & bleed overlay, engine/viewer/
-    // overlay.ts). A v9 lib with a pre-v9 SPA simply never turns it on; a v9
-    // SPA feature-detects on the version before offering the toggle.
+    // the overlayChanged event (print overlays, engine/viewer/overlay.ts). A
+    // v9 lib with a pre-v9 SPA simply never turns it on; a v9 SPA
+    // feature-detects on the version before offering the toggle.
     // (v9 is unreleased as of this writing, so setMarginOverlay's optional
-    // second argument — the look, below — is part of v9, not a bump.)
+    // second argument — the look, below — and its layer object are part of
+    // v9, not a bump: a plain boolean still works and means all four layers.)
     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.
-    setMarginOverlay: function (on, style) {
+    // Print overlays: four layers (bleed, safe = the text safe area, art = the
+    // art safe area, margins), each independent. Viewer chrome only — it adds
+    // no box to the book and no attribute to its elements, so pagination is
+    // identical on or off. `state` is a boolean (all four layers) or {bleed,
+    // safe, art, margins} naming the layers that are on (one it leaves out is
+    // off). Returns the summary {on, layers: {bleed, safe, art, margins},
+    // issues, intended, bleedPt, safePt, artSafePt, counts: {text, art, bleed,
+    // offPage, intended}}, or null when the viewer predates it. `style`
+    // ({strength: 'subtle' | 'normal' | 'strong', colors: {bleed, safe, art,
+    // margins} as '#rrggbb', color: an alias of colors.safe}) is optional: it
+    // only sets the overlay's own tokens, and a call that carries it while the
+    // same layers are already on restyles without repainting.
+    setMarginOverlay: function (state, style) {
       var d = window.Gutterpress && window.Gutterpress.decoration;
-      return d && typeof d.setOverlay === 'function' ? d.setOverlay(!!on, style) : null;
+      return d && typeof d.setOverlay === 'function' ? d.setOverlay(state, style) : null;
     },
+    // Hide the overlay, or bring back the layers it was last showing (the
+    // viewer's record on <body>; all four the first time).
     toggleMarginOverlay: function () {
       var d = window.Gutterpress && window.Gutterpress.decoration;
-      return d && typeof d.setOverlay === 'function' ? d.setOverlay(document.body.dataset.overlay !== 'on') : null;
+      if (!d || typeof d.setOverlay !== 'function') return null;
+      if (document.body.dataset.overlay === 'on') return d.setOverlay(false);
+      var last = (document.body.dataset.overlayLayers || 'bleed,safe,art,margins').split(',');
+      return d.setOverlay({
+        bleed: last.indexOf('bleed') >= 0,
+        safe: last.indexOf('safe') >= 0,
+        art: last.indexOf('art') >= 0,
+        margins: last.indexOf('margins') >= 0
+      });
     },
     getMarginOverlay: function () {
       var d = window.Gutterpress && window.Gutterpress.decoration;
@@ -1629,43 +1645,23 @@
   // completes (engine/viewer/index.ts's mount()).
   window.addEventListener('gp:layout', onRenderingComplete);
 
-  // Margin & 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.
+  // Print overlays: 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. The viewer's legend carries
+  // the rest — what each layer is, what was found — so there is no badge here.
   // "Standalone" = the shell is top level (the CLI); under the desktop app the
   // shell's parent is the app, which owns the toggle and the count.
   var standalone = false;
   try { standalone = window.parent === window || window.parent.parent === window.parent; } catch (_e) {}
 
-  function updateOverlayBadge(summary) {
-    var badge = document.getElementById('gp-ov-badge');
-    if (!standalone || !summary || !summary.on) {
-      if (badge) badge.remove();
-      return;
-    }
-    if (!badge) {
-      badge = document.createElement('div');
-      badge.id = 'gp-ov-badge';
-      badge.setAttribute('role', 'status');
-      badge.style.cssText = 'position:fixed;top:8px;right:8px;z-index:2147483000;pointer-events:none;' +
-        'background:rgba(20,20,24,.88);color:#fff;font:600 11px/1.4 ui-sans-serif,system-ui,sans-serif;' +
-        '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');
-    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');
-    badge.textContent = parts.join(' \u00b7 ') + '  (Alt+M hides)';
-  }
-
   window.addEventListener('gp:overlay', function (e) {
-    updateOverlayBadge(e.detail);
     window.dispatchEvent(new CustomEvent('overlayChanged', { detail: e.detail }));
   });
 
   if (standalone) {
+    // The legend ends "Alt+M hides" only where this key is bound: the viewer
+    // reads the key from here.
+    document.documentElement.dataset.overlayKey = 'Alt+M';
     document.addEventListener('keydown', function (e) {
       if (e.code !== 'KeyM' || !e.altKey || e.ctrlKey || e.metaKey || e.defaultPrevented) return;
       e.preventDefault();

package/dist/{preview-a4x2ezjp.js → preview-q76xn95h.js}

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

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

@@ -106,13 +106,25 @@
       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.
-      // Its look (colour, strength) travels with it.
+      // The print overlays are a review aid the author switched on: a hot
+      // reload must not drop them. The layers that were showing and their look
+      // (a colour per layer, strength) travel with them, as the viewer
+      // recorded them on <body>.
       if (sourceBody.dataset.overlay === 'on' && api.setMarginOverlay) {
-        api.setMarginOverlay(true, {
-          color: sourceBody.style.getPropertyValue('--gp-ov-color').trim(),
-          strength: sourceBody.dataset.overlayStrength
+        var shown = (sourceBody.dataset.overlayLayers || '').split(',');
+        api.setMarginOverlay({
+          bleed: shown.indexOf('bleed') >= 0,
+          safe: shown.indexOf('safe') >= 0,
+          art: shown.indexOf('art') >= 0,
+          margins: shown.indexOf('margins') >= 0
+        }, {
+          strength: sourceBody.dataset.overlayStrength,
+          colors: {
+            bleed: sourceBody.dataset.overlayBleedColor,
+            safe: sourceBody.dataset.overlayColor,
+            art: sourceBody.dataset.overlayArtColor,
+            margins: sourceBody.dataset.overlayMarginsColor
+          }
         });
       }
     }

package/dist/{publish-sfn5hmnx.js → publish-7gdy6gbf.js}

@@ -11,18 +11,18 @@ import {
   publishProviderFor,
   resolvePublishFormat,
   runPublish
-} from "./cli-aw614ztv.js";
+} from "./cli-zacevwcy.js";
 import {
   FileTokenStore,
   log
-} from "./cli-dzw28t3s.js";
+} from "./cli-gh0ym80r.js";
 import {
   UsageError,
   rejectExtraPositionals,
   rejectUnknownFlags
-} from "./cli-cgbzdrwz.js";
+} from "./cli-7z29z4wz.js";
 import"./cli-ht1bcqdd.js";
-import"./cli-xx94a1k6.js";
+import"./cli-j802s31j.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,27 @@ 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 and `pdf.print.safe-margins` where the trim is.
          */
         bleed?: number;
+        /**
+         * The TEXT rule (pt): glyphs stay at least this far inside the trim on
+         * EVERY edge — DriveThruRPG's "keep text 0.5in inside the trim" (`dtrpg`
+         * sets 36). The preview's overlay outlines it and flags text outside it,
+         * and `pdf.print.safe-margins` fails a built PDF whose text is closer. Like
+         * `bleed`, it changes nothing in the PDF, and nothing in a book's CSS moves
+         * it.
+         */
+        safe?: number;
+        /**
+         * The ART rule (pt): art that does not bleed — images, backgrounds,
+         * borders, rules — stays at least this far inside the trim on the top,
+         * bottom and OUTER edge; at the binding edge it uses `safe`. DriveThruRPG's
+         * "keep non-bleeding art 0.25in from the outside edges" (`dtrpg` sets 18).
+         * Absent = the same as `safe`.
+         */
+        artSafe?: number;
     };
     ink?: {
         maxTac?: number;
@@ -236,6 +257,11 @@ export interface ResolvedExtensionConfig {
     export?: string;
     options: Record<string, unknown>;
 }
+/** The printer's published specification that a preset's numbers come from. */
+export interface PrintSpec {
+    label: string;
+    url: string;
+}
 /**
  * Fully-resolved config. Every field is a concrete default with one
  * deliberate exception: `styles`. There is no preset
@@ -247,6 +273,10 @@ export interface ResolvedExtensionConfig {
 export interface ResolvedConfig {
     title: string;
     authors: string[];
+    /** The id of the preset this book resolved against (`dtrpg`, `book`, `custom`). */
+    preset: string;
+    /** The printer spec that preset follows, when it follows one: how a host credits the numbers it draws. */
+    spec?: PrintSpec;
     /** Validated publish-target ids for this book (may be empty). */
     targets: string[];
     styles?: string[];
@@ -260,6 +290,7 @@ export interface ResolvedConfig {
         icc: string;
         stripAnnotations: boolean;
         blackText: "icc" | "k-only";
+        rasterDpi?: number;
     };
     print: {
         signature: number;
@@ -272,6 +303,10 @@ export interface ResolvedConfig {
         tolerance: number;
         /** In-sheet bleed in pt (top, bottom, outer edge; see the manifest field); absent = none. */
         bleed?: number;
+        /** The text rule's inset from the trim in pt, every edge (see the manifest field); absent = none. */
+        safe?: number;
+        /** The art rule's inset from the trim in pt, top/bottom/outer edge (see the manifest field); absent = same as `safe`. */
+        artSafe?: number;
     };
     ink: {
         maxTac: number;

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

@@ -1,16 +1,16 @@
 import {
   executeAndReport
-} from "./cli-aw614ztv.js";
+} from "./cli-zacevwcy.js";
 import {
   log
-} from "./cli-dzw28t3s.js";
+} from "./cli-gh0ym80r.js";
 import {
   UsageError,
   rejectExtraPositionals,
   rejectUnknownFlags
-} from "./cli-cgbzdrwz.js";
+} from "./cli-7z29z4wz.js";
 import"./cli-ht1bcqdd.js";
-import"./cli-xx94a1k6.js";
+import"./cli-j802s31j.js";
 import {
   BuildError,
   EXIT_CODES

package/package.json

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