gutterpress 0.11.20-alpha.1 → 0.11.20-alpha.2

package/dist/index.js

@@ -154,14 +154,14 @@ import {
   testRemoteAccess,
   updateExtensions,
   validateProjectExtensions
-} from "./index-1y885h1j.js";
+} from "./index-razpty47.js";
 import"./index-ht1bcqdd.js";
 import {
   BUILD_DIAGNOSTIC_CODES
-} from "./index-cngw658w.js";
+} from "./index-6xwtb7cw.js";
 import {
   BuildError
-} from "./index-pnvzgftg.js";
+} from "./index-3nr5rzzp.js";
 import {
   DEFAULT_PRINT_OPTS,
   assertMilestone,

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-nrykd2c6.json → manifest.schema-74s1ykyv.json}

@@ -210,15 +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 safe area & bleed overlay where the trim is and changes nothing in the PDF. 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 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.",
+          "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-y4a2xz3g.js → new-ftd4fec4.js}

@@ -7,17 +7,17 @@ import {
   TARGET_IDS,
   scaffoldExtension,
   scaffoldProject
-} from "./cli-x1nfhaf1.js";
+} from "./cli-zacevwcy.js";
 import {
   resolveGhostscript
-} from "./cli-mmm22cza.js";
+} from "./cli-gh0ym80r.js";
 import {
   UsageError,
   rejectExtraPositionals,
   rejectUnknownFlags
-} from "./cli-7shp2kmj.js";
+} from "./cli-7z29z4wz.js";
 import"./cli-ht1bcqdd.js";
-import"./cli-rtpm04dv.js";
+import"./cli-j802s31j.js";
 import {
   EXIT_CODES
 } from "./cli-46ycxe6r.js";

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

@@ -2,17 +2,17 @@ import {
   executeValidation,
   publishTargetFor,
   reportMissingTools
-} from "./cli-x1nfhaf1.js";
+} from "./cli-zacevwcy.js";
 import {
   log
-} from "./cli-mmm22cza.js";
+} from "./cli-gh0ym80r.js";
 import {
   UsageError,
   rejectExtraPositionals,
   rejectUnknownFlags
-} from "./cli-7shp2kmj.js";
+} from "./cli-7z29z4wz.js";
 import"./cli-ht1bcqdd.js";
-import"./cli-rtpm04dv.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
@@ -27,6 +27,9 @@ export declare function injectPreviewScripts(html: string, page?: {
     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.
@@ -55,7 +58,10 @@ export declare function generateAndWriteHtml(inputPath: string, tempDir: string,
         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-k2mj5kvq.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; },
 
-    // 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) {
+    // 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);
 
-  // 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.
+  // 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 = ['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.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)';
-  }
-
   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-5ze728kp.js → preview-q76xn95h.js}

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

package/dist/{preview-shell-7jfe6vsc.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 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.
+      // 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.dataset.overlayColor,
-          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-5tpcyysh.js → publish-7gdy6gbf.js}

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

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

@@ -156,16 +156,26 @@ export interface GutterpressManifest {
          * 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 safe
-         * area & bleed overlay where the trim is.
+         * area & bleed overlay and `pdf.print.safe-margins` 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.
+         * 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;
@@ -247,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
@@ -258,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[];
@@ -284,8 +303,10 @@ 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. */
+        /** 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-p0hkqkfe.js → validate-e3ryegce.js}

@@ -1,16 +1,16 @@
 import {
   executeAndReport
-} from "./cli-x1nfhaf1.js";
+} from "./cli-zacevwcy.js";
 import {
   log
-} from "./cli-mmm22cza.js";
+} from "./cli-gh0ym80r.js";
 import {
   UsageError,
   rejectExtraPositionals,
   rejectUnknownFlags
-} from "./cli-7shp2kmj.js";
+} from "./cli-7z29z4wz.js";
 import"./cli-ht1bcqdd.js";
-import"./cli-rtpm04dv.js";
+import"./cli-j802s31j.js";
 import {
   BuildError,
   EXIT_CODES

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gutterpress",
-  "version": "0.11.20-alpha.1",
+  "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",