gutterpress 0.11.18-alpha.1 → 0.11.18-alpha.2

package/dist/api/index.js

@@ -136,11 +136,11 @@ import {
   testRemoteAccess,
   updateExtensions,
   validateProjectExtensions
-} from "../index-pdanxwn1.js";
+} from "../index-bb2d1ev8.js";
 import"../index-ht1bcqdd.js";
 import {
   BuildError
-} from "../index-jg1r9t4w.js";
+} from "../index-t3zxy69d.js";
 import {
   DEFAULT_PRINT_OPTS,
   assertMilestone,

package/dist/{build-fpd3qp17.js → build-se062swz.js}

@@ -1,19 +1,19 @@
 import {
   runBuild,
   splitOutPath
-} from "./cli-1msxnhzy.js";
+} from "./cli-0w3961p5.js";
 import {
   log
-} from "./cli-gv97c2a6.js";
+} from "./cli-qp6dtsh3.js";
 import {
   UsageError,
   parseFormat,
   parsePdfxFlavor,
   rejectExtraPositionals,
   rejectUnknownFlags
-} from "./cli-bzz33hjz.js";
+} from "./cli-yqpnksaa.js";
 import"./cli-ht1bcqdd.js";
-import"./cli-th1ve2cx.js";
+import"./cli-161z4n0s.js";
 import {
   BuildError
 } from "./cli-46ycxe6r.js";

package/dist/{cli-1msxnhzy.js → cli-0w3961p5.js}

@@ -13,12 +13,12 @@ import {
   stampCreator,
   stripAnnotations,
   warn
-} from "./cli-gv97c2a6.js";
+} from "./cli-qp6dtsh3.js";
 import {
   DEBOUNCE,
   UsageError,
   resolvePort
-} from "./cli-bzz33hjz.js";
+} from "./cli-yqpnksaa.js";
 import {
   blackTextToGray
 } from "./cli-ht1bcqdd.js";
@@ -27,7 +27,7 @@ import {
   getAssetPath,
   getAssetsDir,
   lastPageMode
-} from "./cli-th1ve2cx.js";
+} from "./cli-161z4n0s.js";
 import {
   BuildError,
   EXIT_CODES
@@ -120,7 +120,8 @@ var DTRPG_PRESET = {
   page: {
     width: 621,
     height: 810,
-    tolerance: 0.5
+    tolerance: 0.5,
+    bleed: 9
   },
   ink: {
     maxTac: 240,
@@ -196,7 +197,8 @@ var BOOK_PRESET = {
   page: {
     width: 432,
     height: 648,
-    tolerance: 0.5
+    tolerance: 0.5,
+    bleed: undefined
   },
   ink: {
     maxTac: 400,
@@ -543,7 +545,8 @@ function resolveCustomPage(c, m) {
   return {
     width,
     height,
-    tolerance: c.page?.tolerance ?? m.page?.tolerance ?? 0.5
+    tolerance: c.page?.tolerance ?? m.page?.tolerance ?? 0.5,
+    bleed: c.page?.bleed ?? m.page?.bleed
   };
 }
 function resolveWithPreset(cliOverrides, manifest, preset) {
@@ -9723,7 +9726,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-0g9t43gx.js");
+      const { buildNativePdf } = await import("./engine-jkf4pxz9.js");
       const engineDiagnostics = await buildNativePdf(htmlFile, rawPdf, {
         title: config.title,
         author: config.authors.length > 0 ? config.authors.join(", ") : undefined,
@@ -9974,8 +9977,10 @@ async function renderPreviewBook(inputPath, config, opts) {
     }
   });
 }
-function injectPreviewScripts(html) {
-  const scripts = `  <script src="/engine/gutterpress-viewer.js"></script>
+function injectPreviewScripts(html, insetBleedPt = 0) {
+  const meta = insetBleedPt > 0 ? `  <meta name="gp-inset-bleed" content="${insetBleedPt}">
+` : "";
+  const scripts = meta + `  <script src="/engine/gutterpress-viewer.js"></script>
   ` + `<script src="/preview/scripts/preview-interface.js"></script>
   ` + `<script src="/preview/scripts/preview-bridge.js"></script>
 `;
@@ -10009,7 +10014,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), "utf-8");
+  await fsp3.writeFile(path15.join(tempDir, BOOK_HTML_FILENAME), injectPreviewScripts(html, config.page?.bleed), "utf-8");
 }
 function isDotPathUnderRoot(candidatePath, root) {
   const normalizedRoot = root.replace(/\\/g, "/").replace(/\/+$/, "");

package/dist/{cli-th1ve2cx.js → cli-161z4n0s.js}

@@ -1116,22 +1116,22 @@ import { fileURLToPath } from "node:url";
 var favicon_default = "./favicon-272ga6y0.ico";
 
 // src/assets/manifest.schema.json
-var manifest_schema_default = "./manifest.schema-gh0jjve9.json";
+var manifest_schema_default = "./manifest.schema-8m82f37q.json";
 
 // src/assets/preview/scripts/preview-interface.js
-var preview_interface_default = "./preview-interface-dm6wbdq6.js";
+var preview_interface_default = "./preview-interface-2n1d9pbf.js";
 
 // src/assets/preview/scripts/preview-bridge.js
-var preview_bridge_default = "./preview-bridge-ga409pgz.js";
+var preview_bridge_default = "./preview-bridge-evecsh4w.js";
 
 // src/assets/preview/scripts/preview-shell.js
-var preview_shell_default = "./preview-shell-c909krk2.js";
+var preview_shell_default = "./preview-shell-hyp7g158.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-p50c4f08.js";
+var gutterpress_viewer_default = "./gutterpress-viewer-spq1ge52.js";
 
 // src/assets/engine/gutterpress-agent.js
 var gutterpress_agent_default = "./gutterpress-agent-cazqstr1.js";

package/dist/{cli-gv97c2a6.js → cli-qp6dtsh3.js}

@@ -1,6 +1,6 @@
 import {
   package_default
-} from "./cli-bzz33hjz.js";
+} from "./cli-yqpnksaa.js";
 import {
   execCapture,
   findTool,

package/dist/{cli-bzz33hjz.js → cli-yqpnksaa.js}

@@ -4,7 +4,7 @@ import {
 // package.json
 var package_default = {
   name: "gutterpress",
-  version: "0.11.18-alpha.1",
+  version: "0.11.18-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",

package/dist/cli.js

@@ -6,7 +6,7 @@ import {
   UsageError,
   package_default,
   rejectUnknownFlags
-} from "./cli-bzz33hjz.js";
+} from "./cli-yqpnksaa.js";
 import {
   EXIT_CODES
 } from "./cli-46ycxe6r.js";
@@ -18,14 +18,14 @@ import {
 import { defineCommand, parseArgs, runMain } from "citty";
 import { statSync } from "node:fs";
 var SUBCOMMANDS = {
-  new: () => import("./new-d010czw1.js").then((m) => m.default),
-  preview: () => import("./preview-m3afbq53.js").then((m) => m.default),
-  build: () => import("./build-fpd3qp17.js").then((m) => m.default),
-  publish: () => import("./publish-69x46m3f.js").then((m) => m.default),
-  validate: () => import("./validate-vc6cp1cs.js").then((m) => m.default),
-  preflight: () => import("./preflight-jgcp1xsr.js").then((m) => m.default),
-  doctor: () => import("./doctor-cg0kb8h6.js").then((m) => m.default),
-  ext: () => import("./ext-keedd40p.js").then((m) => m.default)
+  new: () => import("./new-w7q0n21v.js").then((m) => m.default),
+  preview: () => import("./preview-bg3wxqxc.js").then((m) => m.default),
+  build: () => import("./build-se062swz.js").then((m) => m.default),
+  publish: () => import("./publish-waps63wf.js").then((m) => m.default),
+  validate: () => import("./validate-c9d8d656.js").then((m) => m.default),
+  preflight: () => import("./preflight-m54qsjs7.js").then((m) => m.default),
+  doctor: () => import("./doctor-tkbdx8c1.js").then((m) => m.default),
+  ext: () => import("./ext-kg8m8vda.js").then((m) => m.default)
 };
 var VERSION = package_default.version;
 var main = defineCommand({
@@ -50,7 +50,7 @@ async function preflightRequiredInvocations(rawArgs) {
   const [command, ...commandArgs] = rawArgs;
   try {
     if (command === "new") {
-      const { newArgs } = await import("./new-d010czw1.js");
+      const { newArgs } = await import("./new-w7q0n21v.js");
       rejectUnknownFlags(commandArgs, newArgs, "new");
       const parsed = parseArgs(commandArgs, {
         ...newArgs,
@@ -62,7 +62,7 @@ async function preflightRequiredInvocations(rawArgs) {
       return;
     }
     if (command === "preflight") {
-      const { preflightArgs } = await import("./preflight-jgcp1xsr.js");
+      const { preflightArgs } = await import("./preflight-m54qsjs7.js");
       rejectUnknownFlags(commandArgs, preflightArgs, "preflight");
       const parsed = parseArgs(commandArgs, {
         ...preflightArgs,
@@ -82,7 +82,7 @@ async function preflightRequiredInvocations(rawArgs) {
       }
       if (subcommand.startsWith("-"))
         return;
-      const { EXT_SUBCOMMANDS, extAddArgs, extRemoveArgs, extEnableArgs, extDisableArgs } = await import("./ext-keedd40p.js");
+      const { EXT_SUBCOMMANDS, extAddArgs, extRemoveArgs, extEnableArgs, extDisableArgs } = await import("./ext-kg8m8vda.js");
       if (!EXT_SUBCOMMANDS.includes(subcommand)) {
         throw new UsageError(`gutterpress ext: unknown command "${subcommand}"`);
       }

package/dist/{doctor-cg0kb8h6.js → doctor-tkbdx8c1.js}

@@ -1,12 +1,12 @@
 import {
   getSystemDiagnostics,
   log
-} from "./cli-gv97c2a6.js";
+} from "./cli-qp6dtsh3.js";
 import {
   UsageError,
   rejectExtraPositionals,
   rejectUnknownFlags
-} from "./cli-bzz33hjz.js";
+} from "./cli-yqpnksaa.js";
 import"./cli-46ycxe6r.js";
 import"./cli-7fkhgtfn.js";
 import"./cli-37x76zdn.js";

package/dist/{engine-s2caze6b.js → engine-7gfr16t8.js}

@@ -1,9 +1,9 @@
 import {
   build
-} from "./index-3pnmf25p.js";
+} from "./index-3x23by5j.js";
 import {
   BuildError
-} from "./index-jg1r9t4w.js";
+} from "./index-t3zxy69d.js";
 import"./index-rzm1phg0.js";
 import"./index-37x76zdn.js";
 

package/dist/{engine-0g9t43gx.js → engine-jkf4pxz9.js}

@@ -1,6 +1,6 @@
 import {
   build
-} from "./cli-th1ve2cx.js";
+} from "./cli-161z4n0s.js";
 import {
   BuildError
 } from "./cli-46ycxe6r.js";

package/dist/{ext-keedd40p.js → ext-kg8m8vda.js}

@@ -12,17 +12,17 @@ import {
   searchNpmExtensions,
   setExtensionEnabled,
   updateExtensions
-} from "./cli-1msxnhzy.js";
-import"./cli-gv97c2a6.js";
+} from "./cli-0w3961p5.js";
+import"./cli-qp6dtsh3.js";
 import {
   UsageError,
   exitForUsage,
   rejectExtraPositionals,
   rejectUnknownFlags,
   resolveProjectDir
-} from "./cli-bzz33hjz.js";
+} from "./cli-yqpnksaa.js";
 import"./cli-ht1bcqdd.js";
-import"./cli-th1ve2cx.js";
+import"./cli-161z4n0s.js";
 import {
   EXIT_CODES
 } from "./cli-46ycxe6r.js";

package/dist/{gutterpress-viewer-p50c4f08.js → gutterpress-viewer-spq1ge52.js}

@@ -270,6 +270,35 @@
 .gp-marginbox[data-align="end"] > .gp-marginbox-content { justify-content: flex-end; }
 
 /* margin & bleed overlay (overlay.ts) -------------------------------- */
+/* THE LOOK LIVES HERE, in these tokens, and nowhere else: colours, line
+   width, line style, tint strength. The desktop app's settings change the
+   colour (an inline \`--gp-ov-color\` on <body>) and pick a strength preset
+   (\`data-overlay-strength\`); nothing in a book's CSS is involved or needed. */
+.gp-stage {
+  --gp-ov-color: #2f80ed;       /* margin box line + the tint over the margins */
+  --gp-ov-width: 2px;           /* line width as seen on screen, at any zoom */
+  --gp-ov-style: dashed;        /* margin box line style */
+  --gp-ov-tint: 0.1;            /* opacity of the tint over the margin area */
+  --gp-ov-bleed-color: #e5484d; /* bleed band + trim line */
+  --gp-ov-bleed-alpha: 0.45;    /* opacity of the bleed band */
+  --gp-ov-trim-color: #8a0b18;  /* the trim line: darker than the band so it reads as an edge */
+  --gp-ov-flag-width: 2px;      /* overflow flag outline */
+  --gp-ov-warn: #f59e0b;        /* reaches into the margin */
+  --gp-ov-error: #e5484d;       /* crosses the trim / leaves the page */
+  --gp-ov-intent: #8b5cf6;      /* placed on purpose */
+}
+.gp-stage[data-overlay-strength="subtle"] {
+  --gp-ov-width: 1px;
+  --gp-ov-tint: 0.05;
+  --gp-ov-bleed-alpha: 0.3;
+}
+.gp-stage[data-overlay-strength="strong"] {
+  --gp-ov-width: 3px;
+  --gp-ov-tint: 0.2;
+  --gp-ov-bleed-alpha: 0.65;
+  --gp-ov-flag-width: 3px;
+}
+
 /* One sibling layer per run, ABOVE the strip so the lines stay visible over
    author backgrounds and art. Absolutely positioned and pointer-transparent:
    it takes no flow space and no hits, so it cannot move a page break. Exists
@@ -279,22 +308,30 @@
   inset: 0;
   z-index: 5;
   pointer-events: none;
-  --gp-ov-margin: #2f80ed;
-  --gp-ov-bleed: 229 72 77;
-  --gp-ov-warn: #f59e0b;
-  --gp-ov-error: #e5484d;
-  --gp-ov-intent: #8b5cf6;
+  /* The stage is a paint transform, so a 2px line would shrink with the zoom
+     and vanish at fit-to-width. Lines are sized in layout px divided by the
+     zoom, which makes them the same width on screen at every zoom. */
+  --gp-ov-w: calc(var(--gp-ov-width) / var(--gp-zoom, 1));
+  --gp-ov-flag-w: calc(var(--gp-ov-flag-width) / var(--gp-zoom, 1));
 }
 
 .gp-ov-page {
   position: absolute;
 }
 
-/* margin box: thin dashed outline of the content area */
+/* the margins as a region: the trim minus the content box (clip-path, set in
+   overlay.ts), so a margin reads as an area, not a hairline */
+.gp-ov-tint {
+  position: absolute;
+  inset: 0;
+  background: color-mix(in srgb, var(--gp-ov-color) calc(var(--gp-ov-tint) * 100%), transparent);
+}
+
+/* margin box: the content area's outline */
 .gp-ov-margin {
   position: absolute;
   box-sizing: border-box;
-  border: 1px dashed var(--gp-ov-margin);
+  border: var(--gp-ov-w) var(--gp-ov-style) var(--gp-ov-color);
 }
 
 /* the PDF's own margins for this page, where they differ from where the
@@ -302,8 +339,8 @@
 .gp-ov-print {
   position: absolute;
   box-sizing: border-box;
-  border: 1px dotted var(--gp-ov-margin);
-  opacity: 0.55;
+  border: var(--gp-ov-w) dotted var(--gp-ov-color);
+  opacity: 0.6;
 }
 
 /* bleed: a translucent band OUTSIDE the trim (its width is the border) */
@@ -311,14 +348,16 @@
   position: absolute;
   box-sizing: border-box;
   border-style: solid;
-  border-color: rgb(var(--gp-ov-bleed) / 0.3);
+  border-color: color-mix(in srgb, var(--gp-ov-bleed-color) calc(var(--gp-ov-bleed-alpha) * 100%), transparent);
 }
 
-/* trim: where the sheet will be cut, drawn only when there is bleed */
+/* trim: where the sheet will be cut, drawn only when there is bleed — solid,
+   just inside the edge so it never paints over the band (overlay.ts sizes and
+   places it: the whole sheet, or the sheet less an in-sheet bleed) */
 .gp-ov-trim {
   position: absolute;
-  inset: 0;
-  outline: 1px solid rgb(var(--gp-ov-bleed) / 0.9);
+  outline: var(--gp-ov-w) solid var(--gp-ov-trim-color);
+  outline-offset: calc(-1 * var(--gp-ov-w));
 }
 
 /* overflow flags — outline + faint tint, never a box change */
@@ -327,17 +366,17 @@
   box-sizing: border-box;
 }
 .gp-ov-flag[data-kind="margin"] {
-  outline: 2px solid var(--gp-ov-warn);
-  background: rgb(245 158 11 / 0.14);
+  outline: var(--gp-ov-flag-w) solid var(--gp-ov-warn);
+  background: color-mix(in srgb, var(--gp-ov-warn) 16%, transparent);
 }
 .gp-ov-flag[data-kind="bleed"],
 .gp-ov-flag[data-kind="off-page"] {
-  outline: 2px solid var(--gp-ov-error);
-  background: rgb(229 72 77 / 0.16);
+  outline: var(--gp-ov-flag-w) solid var(--gp-ov-error);
+  background: color-mix(in srgb, var(--gp-ov-error) 18%, transparent);
 }
 /* placed on purpose (.gp-bleed, .gp-pin, …): present, not a problem */
 .gp-ov-flag[data-kind="intended"] {
-  outline: 1px dotted var(--gp-ov-intent);
+  outline: var(--gp-ov-flag-w) dotted var(--gp-ov-intent);
 }
 
 /* designer mode ------------------------------------------------------- */
@@ -2170,6 +2209,7 @@
     const h = g.height * scale;
     const b = Math.max(0, bleed) * scale;
     return {
+      host: { x: 0, y: 0, w, h },
       trim: { x: 0, y: 0, w, h },
       content: {
         x: margin.left * scale,
@@ -2181,6 +2221,17 @@
       bleed: b
     };
   }
+  function insetPageBoxes(g, margin, bleed, side, scale = 1) {
+    const sheet = pageBoxes(g, margin, 0, scale);
+    const b = Math.max(0, bleed) * scale;
+    return {
+      host: sheet.host,
+      trim: { x: side === "verso" ? b : 0, y: b, w: sheet.host.w - b, h: sheet.host.h - 2 * b },
+      content: sheet.content,
+      bleedBox: sheet.host,
+      bleed: b
+    };
+  }
   var SEVERITY = { inside: 0, margin: 1, bleed: 2, "off-page": 3 };
   var within = (r, outer, tol) => r.x >= outer.x - tol && r.y >= outer.y - tol && r.x + r.w <= outer.x + outer.w + tol && r.y + r.h <= outer.y + outer.h + tol;
   function classifyRect(r, boxes, tol = 0) {
@@ -2196,10 +2247,25 @@
     return kinds.reduce((worst, k) => SEVERITY[k] > SEVERITY[worst] ? k : worst, "inside");
   }
   var INTENT_SELECTOR = ".gp-bleed, .gp-pin, .gp-flush, .gp-behind, .gp-page-full-bleed";
+  var OVERLAY_STRENGTHS = ["subtle", "normal", "strong"];
+  var HEX_COLOR = /^#(?:[0-9a-f]{3}|[0-9a-f]{6})$/i;
+  function sanitizeOverlayStyle(style) {
+    const s = style && typeof style === "object" ? style : {};
+    const out = {};
+    if (typeof s.color === "string" && HEX_COLOR.test(s.color.trim()))
+      out.color = s.color.trim();
+    if (OVERLAY_STRENGTHS.includes(s.strength))
+      out.strength = s.strength;
+    return out;
+  }
   var OVERLAY_OFF = { on: false, issues: 0, intended: 0, bleedPt: 0 };
   function marginsDiffer(a, b) {
     return ["top", "right", "bottom", "left"].some((k) => Math.abs(a[k] - b[k]) > 0.5);
   }
+  function configInsetBleedPt() {
+    const v = parseFloat(document.querySelector('meta[name="gp-inset-bleed"]')?.getAttribute("content") ?? "");
+    return Number.isFinite(v) && v > 0 ? v : 0;
+  }
   var SKIP = new Set(["SCRIPT", "STYLE", "LINK", "TEMPLATE", "BR", "WBR", "SOURCE", "TRACK", "META"]);
   var TOL_PX = 1;
   function div(cls, box) {
@@ -2215,11 +2281,25 @@
     el.style.width = `${r.w}px`;
     el.style.height = `${r.h}px`;
   }
+  function marginTint(b) {
+    const el = div("gp-ov-tint");
+    const t = b.trim;
+    const clamp = (v, lo, hi) => Math.min(hi, Math.max(lo, v));
+    const l = clamp(b.content.x, t.x, t.x + t.w);
+    const r = clamp(b.content.x + b.content.w, t.x, t.x + t.w);
+    const top = clamp(b.content.y, t.y, t.y + t.h);
+    const bot = clamp(b.content.y + b.content.h, t.y, t.y + t.h);
+    const x2 = t.x + t.w;
+    const y2 = t.y + t.h;
+    el.style.clipPath = `polygon(evenodd, ${t.x}px ${t.y}px, ${x2}px ${t.y}px, ${x2}px ${y2}px, ${t.x}px ${y2}px, ${t.x}px ${t.y}px, ` + `${l}px ${top}px, ${l}px ${bot}px, ${r}px ${bot}px, ${r}px ${top}px, ${l}px ${top}px)`;
+    return el;
+  }
   function clearOverlay() {
     for (const layer of Array.from(document.querySelectorAll(".gp-ov")))
       layer.remove();
   }
-  function paintOverlay(pages, strips, bleedPt) {
+  function paintOverlay(pages, strips, bleedPt, insetBleedPt = 0) {
+    const inSheet = bleedPt <= 0 && insetBleedPt > 0;
     clearOverlay();
     const layers = new Map;
     const painted = new Map;
@@ -2233,18 +2313,20 @@
         run.appendChild(layer);
         layers.set(run, layer);
       }
-      const boxes = pageBoxes(p.geometry, p.margin, bleedPt, PX_PER_PT);
-      const host = div("gp-ov-page", boxes.trim);
+      const boxes = inSheet ? insetPageBoxes(p.geometry, p.margin, insetBleedPt, p.sheet.dataset.side === "verso" ? "verso" : "recto", PX_PER_PT) : pageBoxes(p.geometry, p.margin, bleedPt, PX_PER_PT);
+      const host = div("gp-ov-page", boxes.host);
       host.style.left = p.sheet.style.left;
       host.style.top = p.sheet.style.top;
       host.dataset.page = String(p.index + 1);
       if (boxes.bleed > 0) {
-        const band = div("gp-ov-bleed");
-        band.style.inset = `${-boxes.bleed}px`;
-        band.style.borderWidth = `${boxes.bleed}px`;
+        const bb = boxes.bleedBox;
+        const t = boxes.trim;
+        const band = div("gp-ov-bleed", bb);
+        band.style.borderWidth = `${t.y - bb.y}px ${bb.x + bb.w - (t.x + t.w)}px ${bb.y + bb.h - (t.y + t.h)}px ${t.x - bb.x}px`;
         host.appendChild(band);
-        host.appendChild(div("gp-ov-trim"));
+        host.appendChild(div("gp-ov-trim", t));
       }
+      host.appendChild(marginTint(boxes));
       host.appendChild(div("gp-ov-margin", boxes.content));
       if (marginsDiffer(p.printMargin, p.margin)) {
         host.appendChild(div("gp-ov-print", pageBoxes(p.geometry, p.printMargin, 0, PX_PER_PT).content));
@@ -2306,7 +2388,7 @@
       el.dataset.kind = f.kind;
       f.host.appendChild(el);
     }
-    return { on: true, issues, intended, bleedPt };
+    return inSheet ? { on: true, issues, intended, bleedPt: insetBleedPt, bleedInSheet: true } : { on: true, issues, intended, bleedPt };
   }
 
   // src/engine/viewer/decorate.ts
@@ -2341,7 +2423,7 @@
     let overlayPages = [];
     let overlaySummary = OVERLAY_OFF;
     const paintOverlayNow = () => {
-      overlaySummary = paintOverlay(overlayPages, layout.strips, documentBleedPt(model));
+      overlaySummary = paintOverlay(overlayPages, layout.strips, documentBleedPt(model), configInsetBleedPt());
       window.dispatchEvent(new CustomEvent("gp:overlay", { detail: overlaySummary }));
     };
     const api = {
@@ -2354,12 +2436,21 @@
       setDesigner(on) {
         document.body.dataset.designer = on ? "on" : "off";
       },
-      setOverlay(on) {
+      setOverlay(on, style) {
+        if (style) {
+          const { color, strength } = sanitizeOverlayStyle(style);
+          if (strength)
+            document.body.dataset.overlayStrength = strength;
+          if (color)
+            document.body.style.setProperty("--gp-ov-color", color);
+        }
+        const wasOn = overlayOn;
         overlayOn = on;
         document.body.dataset.overlay = on ? "on" : "off";
-        if (on)
-          paintOverlayNow();
-        else {
+        if (on) {
+          if (!(wasOn && style))
+            paintOverlayNow();
+        } else {
           clearOverlay();
           overlaySummary = OVERLAY_OFF;
           window.dispatchEvent(new CustomEvent("gp:overlay", { detail: overlaySummary }));

package/dist/{index-3pnmf25p.js → index-3x23by5j.js}

@@ -19,7 +19,7 @@ import {
   stringValueAt,
   toFolioPage,
   wantsRecto
-} from "./index-jg1r9t4w.js";
+} from "./index-t3zxy69d.js";
 import {
   launchChromium
 } from "./index-rzm1phg0.js";

package/dist/{index-pdanxwn1.js → index-bb2d1ev8.js}

@@ -9,7 +9,7 @@ import {
   getAssetsDir,
   lastPageMode,
   parseSize
-} from "./index-jg1r9t4w.js";
+} from "./index-t3zxy69d.js";
 import {
   INSTALL_HINTS,
   execCapture,
@@ -155,7 +155,8 @@ var DTRPG_PRESET = {
   page: {
     width: 621,
     height: 810,
-    tolerance: 0.5
+    tolerance: 0.5,
+    bleed: 9
   },
   ink: {
     maxTac: 240,
@@ -231,7 +232,8 @@ var BOOK_PRESET = {
   page: {
     width: 432,
     height: 648,
-    tolerance: 0.5
+    tolerance: 0.5,
+    bleed: undefined
   },
   ink: {
     maxTac: 400,
@@ -584,7 +586,8 @@ function resolveCustomPage(c, m) {
   return {
     width,
     height,
-    tolerance: c.page?.tolerance ?? m.page?.tolerance ?? 0.5
+    tolerance: c.page?.tolerance ?? m.page?.tolerance ?? 0.5,
+    bleed: c.page?.bleed ?? m.page?.bleed
   };
 }
 function resolveWithPreset(cliOverrides, manifest, preset) {
@@ -5747,7 +5750,7 @@ import git from "isomorphic-git";
 // package.json
 var package_default = {
   name: "gutterpress",
-  version: "0.11.18-alpha.1",
+  version: "0.11.18-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",
@@ -10303,7 +10306,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-s2caze6b.js");
+      const { buildNativePdf } = await import("./engine-7gfr16t8.js");
       const engineDiagnostics = await buildNativePdf(htmlFile, rawPdf, {
         title: config.title,
         author: config.authors.length > 0 ? config.authors.join(", ") : undefined,
@@ -10525,8 +10528,10 @@ async function renderPreviewBook(inputPath, config, opts) {
     }
   });
 }
-function injectPreviewScripts(html) {
-  const scripts = `  <script src="/engine/gutterpress-viewer.js"></script>
+function injectPreviewScripts(html, insetBleedPt = 0) {
+  const meta = insetBleedPt > 0 ? `  <meta name="gp-inset-bleed" content="${insetBleedPt}">
+` : "";
+  const scripts = meta + `  <script src="/engine/gutterpress-viewer.js"></script>
   ` + `<script src="/preview/scripts/preview-interface.js"></script>
   ` + `<script src="/preview/scripts/preview-bridge.js"></script>
 `;
@@ -10560,7 +10565,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), "utf-8");
+  await fsp3.writeFile(path15.join(tempDir, BOOK_HTML_FILENAME), injectPreviewScripts(html, config.page?.bleed), "utf-8");
 }
 function isDotPathUnderRoot(candidatePath, root) {
   const normalizedRoot = root.replace(/\\/g, "/").replace(/\/+$/, "");

package/dist/{index-jg1r9t4w.js → index-t3zxy69d.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-gh0jjve9.json";
+var manifest_schema_default = "./manifest.schema-8m82f37q.json";
 
 // src/assets/preview/scripts/preview-interface.js
-var preview_interface_default = "./preview-interface-dm6wbdq6.js";
+var preview_interface_default = "./preview-interface-2n1d9pbf.js";
 
 // src/assets/preview/scripts/preview-bridge.js
-var preview_bridge_default = "./preview-bridge-ga409pgz.js";
+var preview_bridge_default = "./preview-bridge-evecsh4w.js";
 
 // src/assets/preview/scripts/preview-shell.js
-var preview_shell_default = "./preview-shell-c909krk2.js";
+var preview_shell_default = "./preview-shell-hyp7g158.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-p50c4f08.js";
+var gutterpress_viewer_default = "./gutterpress-viewer-spq1ge52.js";
 
 // src/assets/engine/gutterpress-agent.js
 var gutterpress_agent_default = "./gutterpress-agent-cazqstr1.js";

package/dist/index.js

@@ -153,14 +153,14 @@ import {
   testRemoteAccess,
   updateExtensions,
   validateProjectExtensions
-} from "./index-pdanxwn1.js";
+} from "./index-bb2d1ev8.js";
 import"./index-ht1bcqdd.js";
 import {
   BUILD_DIAGNOSTIC_CODES
-} from "./index-3pnmf25p.js";
+} from "./index-3x23by5j.js";
 import {
   BuildError
-} from "./index-jg1r9t4w.js";
+} from "./index-t3zxy69d.js";
 import {
   DEFAULT_PRINT_OPTS,
   assertMilestone,

package/dist/lib/presets.d.ts

@@ -21,6 +21,17 @@ export interface VendorPreset extends Omit<ResolvedConfig, "title" | "authors" |
 /** The built-in preset ids, in the order pickers should offer them. */
 export declare const PRESET_IDS: readonly ["dtrpg", "book", "custom"];
 export type PresetId = (typeof PRESET_IDS)[number];
+/**
+ * DriveThruRPG print-on-demand interior. Where each value comes from:
+ *
+ *  SPEC = DriveThru Partners, "Quick Specifications for Print Books"
+ *         (help.drivethrupartners.com/hc/en-us/articles/12780800178583)
+ *  GUIDE = third-party DriveThruRPG layout guides (consistent with SPEC's
+ *         bleed rule; not stated by DriveThru itself)
+ *  CONVENTION = Gutterpress's own choice or a value DERIVED from a spec
+ *         requirement (e.g. PDF/X-1a forbids transparency) — NOT a DriveThru
+ *         requirement in its own right.
+ */
 export declare const DTRPG_PRESET: VendorPreset;
 /**
  * A neutral, vendor-agnostic default for authors who aren't targeting a

package/dist/{manifest.schema-gh0jjve9.json → manifest.schema-8m82f37q.json}

@@ -200,6 +200,12 @@
           "description": "Allowed deviation, in points, between the expected and the actual page size.",
           "default": 0.5,
           "minimum": 0
+        },
+        "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.",
+          "minimum": 0,
+          "examples": [9]
         }
       }
     },

package/dist/{new-d010czw1.js → new-w7q0n21v.js}

@@ -7,17 +7,17 @@ import {
   TARGET_IDS,
   scaffoldExtension,
   scaffoldProject
-} from "./cli-1msxnhzy.js";
+} from "./cli-0w3961p5.js";
 import {
   resolveGhostscript
-} from "./cli-gv97c2a6.js";
+} from "./cli-qp6dtsh3.js";
 import {
   UsageError,
   rejectExtraPositionals,
   rejectUnknownFlags
-} from "./cli-bzz33hjz.js";
+} from "./cli-yqpnksaa.js";
 import"./cli-ht1bcqdd.js";
-import"./cli-th1ve2cx.js";
+import"./cli-161z4n0s.js";
 import {
   EXIT_CODES
 } from "./cli-46ycxe6r.js";

package/dist/{preflight-jgcp1xsr.js → preflight-m54qsjs7.js}

@@ -2,17 +2,17 @@ import {
   executeValidation,
   publishTargetFor,
   reportMissingTools
-} from "./cli-1msxnhzy.js";
+} from "./cli-0w3961p5.js";
 import {
   log
-} from "./cli-gv97c2a6.js";
+} from "./cli-qp6dtsh3.js";
 import {
   UsageError,
   rejectExtraPositionals,
   rejectUnknownFlags
-} from "./cli-bzz33hjz.js";
+} from "./cli-yqpnksaa.js";
 import"./cli-ht1bcqdd.js";
-import"./cli-th1ve2cx.js";
+import"./cli-161z4n0s.js";
 import {
   BuildError,
   EXIT_CODES

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

@@ -22,7 +22,7 @@ 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): string;
+export declare function injectPreviewScripts(html: string, insetBleedPt?: 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
@@ -45,6 +45,9 @@ export declare function generateAndWriteHtml(inputPath: string, tempDir: string,
     };
     extensions?: ResolvedExtensionConfig[];
     print?: PrintPadding;
+    page?: {
+        bleed?: number;
+    };
 }, cssAssets: Map<string, string>, imageRefs?: Set<string>): Promise<void>;
 /**
  * Chokidar 5's `ignored` matcher (regex or function) is tested against the

package/dist/{preview-m3afbq53.js → preview-bg3wxqxc.js}

@@ -7,10 +7,10 @@ import {
   runBuild,
   splitOutPath,
   startPreviewServer
-} from "./cli-1msxnhzy.js";
+} from "./cli-0w3961p5.js";
 import {
   log
-} from "./cli-gv97c2a6.js";
+} from "./cli-qp6dtsh3.js";
 import {
   UsageError,
   parseFormat,
@@ -18,9 +18,9 @@ import {
   rejectExtraPositionals,
   rejectUnknownFlags,
   resolvePort
-} from "./cli-bzz33hjz.js";
+} from "./cli-yqpnksaa.js";
 import"./cli-ht1bcqdd.js";
-import"./cli-th1ve2cx.js";
+import"./cli-161z4n0s.js";
 import {
   BuildError
 } from "./cli-46ycxe6r.js";

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

@@ -14,7 +14,7 @@
 //
 // Commands map 1:1 to previewAPI methods: getTotalPages, getCurrentPage,
 // goToPage, firstPage, prevPage, nextPage, lastPage, setViewMode, setZoom,
-// toggleDebugMode, setMarginOverlay. Plus a synthetic 'print' command that calls window.print().
+// toggleDebugMode, setMarginOverlay(on, {color, strength}). Plus a synthetic 'print' command that calls window.print().
 //
 // Additional messages:
 //   parent -> iframe: { type: 'gutterpress:inject-styles', id: <attr-name>, css: <string> }

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

@@ -1101,15 +1101,20 @@
     // 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.
+    // (v9 is unreleased as of this writing, so setMarginOverlay's optional
+    // 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.
-    setMarginOverlay: function (on) {
+    // 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) {
       var d = window.Gutterpress && window.Gutterpress.decoration;
-      return d && typeof d.setOverlay === 'function' ? d.setOverlay(!!on) : null;
+      return d && typeof d.setOverlay === 'function' ? d.setOverlay(!!on, style) : null;
     },
     toggleMarginOverlay: function () {
       var d = window.Gutterpress && window.Gutterpress.decoration;
@@ -1650,7 +1655,8 @@
     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.bleedPt) parts.push('no @page bleed set');
+    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)';
   }
 

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

@@ -108,7 +108,13 @@
       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.
-      if (sourceBody.dataset.overlay === 'on' && api.setMarginOverlay) api.setMarginOverlay(true);
+      // 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(),
+          strength: sourceBody.dataset.overlayStrength
+        });
+      }
     }
     var zoom = source.documentElement.style.getPropertyValue('--gutterpress-zoom');
     // Carry the fit flag too (setZoom's third argument clips sideways overflow).

package/dist/{publish-69x46m3f.js → publish-waps63wf.js}

@@ -11,18 +11,18 @@ import {
   publishProviderFor,
   resolvePublishFormat,
   runPublish
-} from "./cli-1msxnhzy.js";
+} from "./cli-0w3961p5.js";
 import {
   FileTokenStore,
   log
-} from "./cli-gv97c2a6.js";
+} from "./cli-qp6dtsh3.js";
 import {
   UsageError,
   rejectExtraPositionals,
   rejectUnknownFlags
-} from "./cli-bzz33hjz.js";
+} from "./cli-yqpnksaa.js";
 import"./cli-ht1bcqdd.js";
-import"./cli-th1ve2cx.js";
+import"./cli-161z4n0s.js";
 import {
   EXIT_CODES
 } from "./cli-46ycxe6r.js";

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

@@ -146,6 +146,15 @@ export interface GutterpressManifest {
         width?: number;
         height?: number;
         tolerance?: number;
+        /**
+         * 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.
+         */
+        bleed?: number;
     };
     ink?: {
         maxTac?: number;
@@ -261,6 +270,8 @@ export interface ResolvedConfig {
         width: number;
         height: number;
         tolerance: number;
+        /** In-sheet bleed in pt (top, bottom, outer edge; see the manifest field); absent = none. */
+        bleed?: number;
     };
     ink: {
         maxTac: number;

package/dist/{validate-vc6cp1cs.js → validate-c9d8d656.js}

@@ -1,16 +1,16 @@
 import {
   executeAndReport
-} from "./cli-1msxnhzy.js";
+} from "./cli-0w3961p5.js";
 import {
   log
-} from "./cli-gv97c2a6.js";
+} from "./cli-qp6dtsh3.js";
 import {
   UsageError,
   rejectExtraPositionals,
   rejectUnknownFlags
-} from "./cli-bzz33hjz.js";
+} from "./cli-yqpnksaa.js";
 import"./cli-ht1bcqdd.js";
-import"./cli-th1ve2cx.js";
+import"./cli-161z4n0s.js";
 import {
   BuildError,
   EXIT_CODES

package/package.json

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