gutterpress 0.11.17 → 0.11.18-alpha.2

package/dist/api/index.js

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

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

@@ -1,19 +1,19 @@
 import {
   runBuild,
   splitOutPath
-} from "./cli-a4qtctrw.js";
+} from "./cli-0w3961p5.js";
 import {
   log
-} from "./cli-zfgvssqz.js";
+} from "./cli-qp6dtsh3.js";
 import {
   UsageError,
   parseFormat,
   parsePdfxFlavor,
   rejectExtraPositionals,
   rejectUnknownFlags
-} from "./cli-8nw6d915.js";
+} from "./cli-yqpnksaa.js";
 import"./cli-ht1bcqdd.js";
-import"./cli-ycbg7mxk.js";
+import"./cli-161z4n0s.js";
 import {
   BuildError
 } from "./cli-46ycxe6r.js";

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

@@ -13,12 +13,12 @@ import {
   stampCreator,
   stripAnnotations,
   warn
-} from "./cli-zfgvssqz.js";
+} from "./cli-qp6dtsh3.js";
 import {
   DEBOUNCE,
   UsageError,
   resolvePort
-} from "./cli-8nw6d915.js";
+} from "./cli-yqpnksaa.js";
 import {
   blackTextToGray
 } from "./cli-ht1bcqdd.js";
@@ -27,7 +27,7 @@ import {
   getAssetPath,
   getAssetsDir,
   lastPageMode
-} from "./cli-ycbg7mxk.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-yf2w9hj7.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-ycbg7mxk.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-c44qk17f.js";
+var preview_interface_default = "./preview-interface-2n1d9pbf.js";
 
 // src/assets/preview/scripts/preview-bridge.js
-var preview_bridge_default = "./preview-bridge-8jhd1wpb.js";
+var preview_bridge_default = "./preview-bridge-evecsh4w.js";
 
 // src/assets/preview/scripts/preview-shell.js
-var preview_shell_default = "./preview-shell-xwn84kqr.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-ez7k4ha7.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-zfgvssqz.js → cli-qp6dtsh3.js}

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

package/dist/{cli-8nw6d915.js → cli-yqpnksaa.js}

@@ -4,7 +4,7 @@ import {
 // package.json
 var package_default = {
   name: "gutterpress",
-  version: "0.11.17",
+  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-8nw6d915.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-a9m2jwyy.js").then((m) => m.default),
-  preview: () => import("./preview-7z8tt0b4.js").then((m) => m.default),
-  build: () => import("./build-gxy185pv.js").then((m) => m.default),
-  publish: () => import("./publish-bbftdxh2.js").then((m) => m.default),
-  validate: () => import("./validate-x1ha1gqj.js").then((m) => m.default),
-  preflight: () => import("./preflight-w3tnbtb8.js").then((m) => m.default),
-  doctor: () => import("./doctor-fygmzevd.js").then((m) => m.default),
-  ext: () => import("./ext-c48s56jm.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-a9m2jwyy.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-w3tnbtb8.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-c48s56jm.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-fygmzevd.js → doctor-tkbdx8c1.js}

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

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

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

package/dist/{engine-yf2w9hj7.js → engine-jkf4pxz9.js}

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

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

@@ -12,17 +12,17 @@ import {
   searchNpmExtensions,
   setExtensionEnabled,
   updateExtensions
-} from "./cli-a4qtctrw.js";
-import"./cli-zfgvssqz.js";
+} from "./cli-0w3961p5.js";
+import"./cli-qp6dtsh3.js";
 import {
   UsageError,
   exitForUsage,
   rejectExtraPositionals,
   rejectUnknownFlags,
   resolveProjectDir
-} from "./cli-8nw6d915.js";
+} from "./cli-yqpnksaa.js";
 import"./cli-ht1bcqdd.js";
-import"./cli-ycbg7mxk.js";
+import"./cli-161z4n0s.js";
 import {
   EXIT_CODES
 } from "./cli-46ycxe6r.js";

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

@@ -34,7 +34,9 @@
     loadStyleSources: () => loadStyleSources,
     injectViewerCss: () => injectViewerCss,
     injectBreakMapping: () => injectBreakMapping,
+    indexInStrip: () => indexInStrip,
     fragmentDocument: () => fragmentDocument,
+    cssZoomOf: () => cssZoomOf,
     contentEdgeRect: () => contentEdgeRect,
     compensateRepeatedHeaders: () => compensateRepeatedHeaders,
     compensateRectoBreaks: () => compensateRectoBreaks,
@@ -267,6 +269,116 @@
 .gp-marginbox[data-align="center"] > .gp-marginbox-content { justify-content: center; }
 .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
+   only while the overlay is on. */
+.gp-ov {
+  position: absolute;
+  inset: 0;
+  z-index: 5;
+  pointer-events: none;
+  /* 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;
+}
+
+/* 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: 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
+   preview lays the text (mirrored :left/:right, .gp-flush): fainter, dotted */
+.gp-ov-print {
+  position: absolute;
+  box-sizing: border-box;
+  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) */
+.gp-ov-bleed {
+  position: absolute;
+  box-sizing: border-box;
+  border-style: solid;
+  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 — 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;
+  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 */
+.gp-ov-flag {
+  position: absolute;
+  box-sizing: border-box;
+}
+.gp-ov-flag[data-kind="margin"] {
+  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: 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: var(--gp-ov-flag-w) dotted var(--gp-ov-intent);
+}
+
 /* designer mode ------------------------------------------------------- */
 .gp-guide-trim,
 .gp-guide-safe,
@@ -310,6 +422,7 @@
     transform: none;
   }
   .gp-layer,
+  .gp-ov,
   .gp-warning,
   .gp-guide-trim,
   .gp-guide-safe,
@@ -2067,6 +2180,217 @@
     return /right/.test(name) ? "end" : "start";
   }
 
+  // src/engine/compiler/tier2.ts
+  var DEFAULT_SLUG_PT = 18;
+  function pageGeometry(model, opts) {
+    const base = resolvePage(model);
+    const trim = { width: base.geometry.width, height: base.geometry.height };
+    const bleed = opts.bleedPt ?? base.geometry.bleed;
+    const wantsMarks = base.geometry.marks.length > 0 || opts.marks === true;
+    const slug = wantsMarks ? opts.slugPt ?? DEFAULT_SLUG_PT : 0;
+    return {
+      trim,
+      bleed,
+      slug,
+      marks: base.geometry.marks.length ? base.geometry.marks : wantsMarks ? ["crop"] : [],
+      media: {
+        width: trim.width + 2 * (bleed + slug),
+        height: trim.height + 2 * (bleed + slug)
+      }
+    };
+  }
+
+  // src/engine/viewer/overlay.ts
+  function documentBleedPt(model) {
+    return pageGeometry(model, { model }).bleed;
+  }
+  function pageBoxes(g, margin, bleed, scale = 1) {
+    const w = g.width * scale;
+    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,
+        y: margin.top * scale,
+        w: w - (margin.left + margin.right) * scale,
+        h: h - (margin.top + margin.bottom) * scale
+      },
+      bleedBox: { x: -b, y: -b, w: w + 2 * b, h: h + 2 * b },
+      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) {
+    if (within(r, boxes.content, tol))
+      return "inside";
+    if (within(r, boxes.trim, tol))
+      return "margin";
+    if (boxes.bleed > 0 && within(r, boxes.bleedBox, tol))
+      return "bleed";
+    return "off-page";
+  }
+  function worstKind(kinds) {
+    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) {
+    const el = document.createElement("div");
+    el.className = cls;
+    if (box)
+      place(el, box);
+    return el;
+  }
+  function place(el, r) {
+    el.style.left = `${r.x}px`;
+    el.style.top = `${r.y}px`;
+    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, insetBleedPt = 0) {
+    const inSheet = bleedPt <= 0 && insetBleedPt > 0;
+    clearOverlay();
+    const layers = new Map;
+    const painted = new Map;
+    for (const p of pages) {
+      const run = p.sheet.closest(".gp-run");
+      if (!run)
+        continue;
+      let layer = layers.get(run);
+      if (!layer) {
+        layer = div("gp-ov");
+        run.appendChild(layer);
+        layers.set(run, layer);
+      }
+      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 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", 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));
+      }
+      layer.appendChild(host);
+      painted.set(p.index, { host, boxes, sheet: p.sheet });
+    }
+    const flags = [];
+    let issues = 0;
+    let intended = 0;
+    for (const strip of strips) {
+      const zoom = cssZoomOf(strip.el);
+      const colW = (parseFloat(strip.el.style.getPropertyValue("--gp-content-w")) || 0) * zoom;
+      const colH = (parseFloat(strip.el.style.getPropertyValue("--gp-content-h")) || 0) * zoom;
+      const visit = (el) => {
+        if (SKIP.has(el.tagName) || el.classList.contains("gp-wrap-spacer"))
+          return;
+        const kinds = [];
+        const found = [];
+        for (const r of Array.from(el.getClientRects())) {
+          if (r.width <= 0 && r.height <= 0)
+            continue;
+          const ax = r.left + Math.min(r.width, colW || r.width) / 2;
+          const ay = r.top + Math.min(r.height, colH || r.height) / 2;
+          const target = painted.get(strip.offset + indexInStrip(ax, ay, strip));
+          if (!target)
+            continue;
+          target.rect ??= target.sheet.getBoundingClientRect();
+          const local = {
+            x: (r.left - target.rect.left) / zoom,
+            y: (r.top - target.rect.top) / zoom,
+            w: r.width / zoom,
+            h: r.height / zoom
+          };
+          const kind = classifyRect(local, target.boxes, TOL_PX);
+          kinds.push(kind);
+          if (kind !== "inside")
+            found.push({ host: target.host, kind, box: local });
+        }
+        const worst = worstKind(kinds);
+        if (worst !== "inside") {
+          const isIntended = el.closest(INTENT_SELECTOR) !== null;
+          if (isIntended)
+            intended++;
+          else
+            issues++;
+          for (const f of found)
+            flags.push(isIntended ? { ...f, kind: "intended" } : f);
+          return;
+        }
+        for (const child of Array.from(el.children))
+          visit(child);
+      };
+      for (const child of Array.from(strip.el.children))
+        visit(child);
+    }
+    for (const f of flags) {
+      const el = div(`gp-ov-flag`, f.box);
+      el.dataset.kind = f.kind;
+      f.host.appendChild(el);
+    }
+    return inSheet ? { on: true, issues, intended, bleedPt: insetBleedPt, bleedInSheet: true } : { on: true, issues, intended, bleedPt };
+  }
+
   // src/engine/viewer/decorate.ts
   var px = (v) => `${v * PX_PER_PT}px`;
   function elementForHref(href) {
@@ -2095,6 +2419,13 @@
     let blankPages = new Set;
     let paddedPages = new Set;
     const warnings = [];
+    let overlayOn = false;
+    let overlayPages = [];
+    let overlaySummary = OVERLAY_OFF;
+    const paintOverlayNow = () => {
+      overlaySummary = paintOverlay(overlayPages, layout.strips, documentBleedPt(model), configInsetBleedPt());
+      window.dispatchEvent(new CustomEvent("gp:overlay", { detail: overlaySummary }));
+    };
     const api = {
       redraw: () => draw(),
       sheetFor: (p) => sheets.get(p),
@@ -2104,7 +2435,29 @@
       warnings,
       setDesigner(on) {
         document.body.dataset.designer = on ? "on" : "off";
-      }
+      },
+      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) {
+          if (!(wasOn && style))
+            paintOverlayNow();
+        } else {
+          clearOverlay();
+          overlaySummary = OVERLAY_OFF;
+          window.dispatchEvent(new CustomEvent("gp:overlay", { detail: overlaySummary }));
+        }
+        return overlaySummary;
+      },
+      overlay: () => overlaySummary
     };
     const canvasBg = captureCanvasBackground();
     document.body.classList.add("gp-stage");
@@ -2262,6 +2615,7 @@
       warnings.length = 0;
       blankPages = new Set(layout.blankPageIndices);
       paddedPages = new Set(layout.paddedPageIndices);
+      overlayPages = [];
       buildMaps();
       fillXrefs();
       let prevPageH = 0;
@@ -2300,6 +2654,14 @@
           drawMarginBoxes(sheet, ctx, layout.totalPages - paddedPages.size);
           drawGuides(sheet, ctx);
           drawCropMarks(sheet, ctx);
+          overlayPages.push({
+            index: bookIndex,
+            sheet,
+            strip,
+            geometry: ctx.geometry,
+            printMargin: ctx.geometry.margin,
+            margin: ctx.padded || blankPages.has(bookIndex) ? ctx.geometry.margin : strip.flushEdges?.length ? flushMargins(g.margin, strip.flushEdges) : g.margin
+          });
         }
         const rows = Math.max(1, Math.ceil((strip.pages + shift) / perRow));
         run.style.height = `${rowStride * (rows - 1) + PX_PER_PT * g.height}px`;
@@ -2310,6 +2672,8 @@
         if (opts.designer)
           checkOverflow(strip, warnings);
       }
+      if (overlayOn)
+        paintOverlayNow();
     }
     function drawMarginBoxes(sheet, ctx, totalPages) {
       const g = ctx.geometry;

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

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

package/dist/{index-3k3fyrec.js → index-bb2d1ev8.js}

@@ -9,7 +9,7 @@ import {
   getAssetsDir,
   lastPageMode,
   parseSize
-} from "./index-vmcfahe2.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.17",
+  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-5d1rpxxq.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-vmcfahe2.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-c44qk17f.js";
+var preview_interface_default = "./preview-interface-2n1d9pbf.js";
 
 // src/assets/preview/scripts/preview-bridge.js
-var preview_bridge_default = "./preview-bridge-8jhd1wpb.js";
+var preview_bridge_default = "./preview-bridge-evecsh4w.js";
 
 // src/assets/preview/scripts/preview-shell.js
-var preview_shell_default = "./preview-shell-xwn84kqr.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-ez7k4ha7.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-3k3fyrec.js";
+} from "./index-bb2d1ev8.js";
 import"./index-ht1bcqdd.js";
 import {
   BUILD_DIAGNOSTIC_CODES
-} from "./index-09h3n36d.js";
+} from "./index-3x23by5j.js";
 import {
   BuildError
-} from "./index-vmcfahe2.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-a9m2jwyy.js → new-w7q0n21v.js}

@@ -7,17 +7,17 @@ import {
   TARGET_IDS,
   scaffoldExtension,
   scaffoldProject
-} from "./cli-a4qtctrw.js";
+} from "./cli-0w3961p5.js";
 import {
   resolveGhostscript
-} from "./cli-zfgvssqz.js";
+} from "./cli-qp6dtsh3.js";
 import {
   UsageError,
   rejectExtraPositionals,
   rejectUnknownFlags
-} from "./cli-8nw6d915.js";
+} from "./cli-yqpnksaa.js";
 import"./cli-ht1bcqdd.js";
-import"./cli-ycbg7mxk.js";
+import"./cli-161z4n0s.js";
 import {
   EXIT_CODES
 } from "./cli-46ycxe6r.js";

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

@@ -2,17 +2,17 @@ import {
   executeValidation,
   publishTargetFor,
   reportMissingTools
-} from "./cli-a4qtctrw.js";
+} from "./cli-0w3961p5.js";
 import {
   log
-} from "./cli-zfgvssqz.js";
+} from "./cli-qp6dtsh3.js";
 import {
   UsageError,
   rejectExtraPositionals,
   rejectUnknownFlags
-} from "./cli-8nw6d915.js";
+} from "./cli-yqpnksaa.js";
 import"./cli-ht1bcqdd.js";
-import"./cli-ycbg7mxk.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-7z8tt0b4.js → preview-bg3wxqxc.js}

@@ -7,10 +7,10 @@ import {
   runBuild,
   splitOutPath,
   startPreviewServer
-} from "./cli-a4qtctrw.js";
+} from "./cli-0w3961p5.js";
 import {
   log
-} from "./cli-zfgvssqz.js";
+} from "./cli-qp6dtsh3.js";
 import {
   UsageError,
   parseFormat,
@@ -18,9 +18,9 @@ import {
   rejectExtraPositionals,
   rejectUnknownFlags,
   resolvePort
-} from "./cli-8nw6d915.js";
+} from "./cli-yqpnksaa.js";
 import"./cli-ht1bcqdd.js";
-import"./cli-ycbg7mxk.js";
+import"./cli-161z4n0s.js";
 import {
   BuildError
 } from "./cli-46ycxe6r.js";

package/dist/{preview-bridge-8jhd1wpb.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. 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> }
@@ -82,6 +82,10 @@
   window.addEventListener('contextMenuRequested', function (e) {
     post({ type: 'gutterpress:event', name: 'contextMenuRequested', detail: e.detail });
   });
+  // Margin & bleed overlay result (protocol v9): {on, issues, intended, bleedPt}.
+  window.addEventListener('overlayChanged', function (e) {
+    post({ type: 'gutterpress:event', name: 'overlayChanged', detail: e.detail });
+  });
   // In-flow block editing (protocol v8). `Requested` is the double-click entry
   // point — the SPA answers it with a beginBlockEdit command. `Finished`
   // carries the edited text back for an end the AUTHOR initiated inside the

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

@@ -1070,6 +1070,12 @@
       refreshPages();
       currentPage = detectVisiblePage();
       recordVisibleSource();
+      // A hot-reload swap makes this frame the active one AFTER its overlay was
+      // switched on (while hidden, where nothing is relayed): say so now.
+      var overlay = api.getMarginOverlay();
+      if (overlay && overlay.on) {
+        window.dispatchEvent(new CustomEvent('overlayChanged', { detail: overlay }));
+      }
       return api.notifyPageChange();
     },
 
@@ -1091,7 +1097,33 @@
     // floating edit panel this replaces. A v8 lib with a pre-v8 SPA loses the
     // "Edit this block" action and nothing else; a v8 SPA feature-detects on
     // the version before offering it.
-    getProtocolVersion: function () { return 8; },
+    // 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.
+    // (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. `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, style) : null;
+    },
+    toggleMarginOverlay: function () {
+      var d = window.Gutterpress && window.Gutterpress.decoration;
+      return d && typeof d.setOverlay === 'function' ? d.setOverlay(document.body.dataset.overlay !== 'on') : null;
+    },
+    getMarginOverlay: function () {
+      var d = window.Gutterpress && window.Gutterpress.decoration;
+      return d && typeof d.overlay === 'function' ? d.overlay() : null;
+    },
 
     // Resolve the annotated element/selection at a viewport point (protocol
     // v4). Pure read; see buildContextTarget() above for the full contract.
@@ -1596,4 +1628,48 @@
   // The Gutterpress engine viewer dispatches this when its pagination
   // 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.
+  // "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) {
+    document.addEventListener('keydown', function (e) {
+      if (e.code !== 'KeyM' || !e.altKey || e.ctrlKey || e.metaKey || e.defaultPrevented) return;
+      e.preventDefault();
+      api.toggleMarginOverlay();
+    });
+  }
 })();

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

@@ -106,6 +106,15 @@
       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.
+      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-bbftdxh2.js → publish-waps63wf.js}

@@ -11,18 +11,18 @@ import {
   publishProviderFor,
   resolvePublishFormat,
   runPublish
-} from "./cli-a4qtctrw.js";
+} from "./cli-0w3961p5.js";
 import {
   FileTokenStore,
   log
-} from "./cli-zfgvssqz.js";
+} from "./cli-qp6dtsh3.js";
 import {
   UsageError,
   rejectExtraPositionals,
   rejectUnknownFlags
-} from "./cli-8nw6d915.js";
+} from "./cli-yqpnksaa.js";
 import"./cli-ht1bcqdd.js";
-import"./cli-ycbg7mxk.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-x1ha1gqj.js → validate-c9d8d656.js}

@@ -1,16 +1,16 @@
 import {
   executeAndReport
-} from "./cli-a4qtctrw.js";
+} from "./cli-0w3961p5.js";
 import {
   log
-} from "./cli-zfgvssqz.js";
+} from "./cli-qp6dtsh3.js";
 import {
   UsageError,
   rejectExtraPositionals,
   rejectUnknownFlags
-} from "./cli-8nw6d915.js";
+} from "./cli-yqpnksaa.js";
 import"./cli-ht1bcqdd.js";
-import"./cli-ycbg7mxk.js";
+import"./cli-161z4n0s.js";
 import {
   BuildError,
   EXIT_CODES

package/package.json

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