gutterpress 0.11.17 → 0.11.18-alpha.1

package/dist/api/index.js

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

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

@@ -1,19 +1,19 @@
 import {
   runBuild,
   splitOutPath
-} from "./cli-a4qtctrw.js";
+} from "./cli-1msxnhzy.js";
 import {
   log
-} from "./cli-zfgvssqz.js";
+} from "./cli-gv97c2a6.js";
 import {
   UsageError,
   parseFormat,
   parsePdfxFlavor,
   rejectExtraPositionals,
   rejectUnknownFlags
-} from "./cli-8nw6d915.js";
+} from "./cli-bzz33hjz.js";
 import"./cli-ht1bcqdd.js";
-import"./cli-ycbg7mxk.js";
+import"./cli-th1ve2cx.js";
 import {
   BuildError
 } from "./cli-46ycxe6r.js";

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

@@ -13,12 +13,12 @@ import {
   stampCreator,
   stripAnnotations,
   warn
-} from "./cli-zfgvssqz.js";
+} from "./cli-gv97c2a6.js";
 import {
   DEBOUNCE,
   UsageError,
   resolvePort
-} from "./cli-8nw6d915.js";
+} from "./cli-bzz33hjz.js";
 import {
   blackTextToGray
 } from "./cli-ht1bcqdd.js";
@@ -27,7 +27,7 @@ import {
   getAssetPath,
   getAssetsDir,
   lastPageMode
-} from "./cli-ycbg7mxk.js";
+} from "./cli-th1ve2cx.js";
 import {
   BuildError,
   EXIT_CODES
@@ -9723,7 +9723,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-0g9t43gx.js");
       const engineDiagnostics = await buildNativePdf(htmlFile, rawPdf, {
         title: config.title,
         author: config.authors.length > 0 ? config.authors.join(", ") : undefined,

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

@@ -4,7 +4,7 @@ import {
 // package.json
 var package_default = {
   name: "gutterpress",
-  version: "0.11.17",
+  version: "0.11.18-alpha.1",
   description: "Markdown-to-PDF converter for professional print layout using a native Chromium print engine and Ghostscript.",
   author: "itlackey",
   license: "MPL-2.0",

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

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

package/dist/{cli-ycbg7mxk.js → cli-th1ve2cx.js}

@@ -1119,19 +1119,19 @@ var favicon_default = "./favicon-272ga6y0.ico";
 var manifest_schema_default = "./manifest.schema-gh0jjve9.json";
 
 // src/assets/preview/scripts/preview-interface.js
-var preview_interface_default = "./preview-interface-c44qk17f.js";
+var preview_interface_default = "./preview-interface-dm6wbdq6.js";
 
 // src/assets/preview/scripts/preview-bridge.js
-var preview_bridge_default = "./preview-bridge-8jhd1wpb.js";
+var preview_bridge_default = "./preview-bridge-ga409pgz.js";
 
 // src/assets/preview/scripts/preview-shell.js
-var preview_shell_default = "./preview-shell-xwn84kqr.js";
+var preview_shell_default = "./preview-shell-c909krk2.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-p50c4f08.js";
 
 // src/assets/engine/gutterpress-agent.js
 var gutterpress_agent_default = "./gutterpress-agent-cazqstr1.js";

package/dist/cli.js

@@ -6,7 +6,7 @@ import {
   UsageError,
   package_default,
   rejectUnknownFlags
-} from "./cli-8nw6d915.js";
+} from "./cli-bzz33hjz.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-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)
 };
 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-d010czw1.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-jgcp1xsr.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-keedd40p.js");
       if (!EXT_SUBCOMMANDS.includes(subcommand)) {
         throw new UsageError(`gutterpress ext: unknown command "${subcommand}"`);
       }

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

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

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

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

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

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

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

@@ -12,17 +12,17 @@ import {
   searchNpmExtensions,
   setExtensionEnabled,
   updateExtensions
-} from "./cli-a4qtctrw.js";
-import"./cli-zfgvssqz.js";
+} from "./cli-1msxnhzy.js";
+import"./cli-gv97c2a6.js";
 import {
   UsageError,
   exitForUsage,
   rejectExtraPositionals,
   rejectUnknownFlags,
   resolveProjectDir
-} from "./cli-8nw6d915.js";
+} from "./cli-bzz33hjz.js";
 import"./cli-ht1bcqdd.js";
-import"./cli-ycbg7mxk.js";
+import"./cli-th1ve2cx.js";
 import {
   EXIT_CODES
 } from "./cli-46ycxe6r.js";

package/dist/{gutterpress-viewer-ez7k4ha7.js → gutterpress-viewer-p50c4f08.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,77 @@
 .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) -------------------------------- */
+/* 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;
+  --gp-ov-margin: #2f80ed;
+  --gp-ov-bleed: 229 72 77;
+  --gp-ov-warn: #f59e0b;
+  --gp-ov-error: #e5484d;
+  --gp-ov-intent: #8b5cf6;
+}
+
+.gp-ov-page {
+  position: absolute;
+}
+
+/* margin box: thin dashed outline of the content area */
+.gp-ov-margin {
+  position: absolute;
+  box-sizing: border-box;
+  border: 1px dashed var(--gp-ov-margin);
+}
+
+/* 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: 1px dotted var(--gp-ov-margin);
+  opacity: 0.55;
+}
+
+/* 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: rgb(var(--gp-ov-bleed) / 0.3);
+}
+
+/* trim: where the sheet will be cut, drawn only when there is bleed */
+.gp-ov-trim {
+  position: absolute;
+  inset: 0;
+  outline: 1px solid rgb(var(--gp-ov-bleed) / 0.9);
+}
+
+/* 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: 2px solid var(--gp-ov-warn);
+  background: rgb(245 158 11 / 0.14);
+}
+.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);
+}
+/* placed on purpose (.gp-bleed, .gp-pin, …): present, not a problem */
+.gp-ov-flag[data-kind="intended"] {
+  outline: 1px dotted var(--gp-ov-intent);
+}
+
 /* designer mode ------------------------------------------------------- */
 .gp-guide-trim,
 .gp-guide-safe,
@@ -310,6 +383,7 @@
     transform: none;
   }
   .gp-layer,
+  .gp-ov,
   .gp-warning,
   .gp-guide-trim,
   .gp-guide-safe,
@@ -2067,6 +2141,174 @@
     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 {
+      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
+    };
+  }
+  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_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);
+  }
+  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 clearOverlay() {
+    for (const layer of Array.from(document.querySelectorAll(".gp-ov")))
+      layer.remove();
+  }
+  function paintOverlay(pages, strips, bleedPt) {
+    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 = pageBoxes(p.geometry, p.margin, bleedPt, PX_PER_PT);
+      const host = div("gp-ov-page", boxes.trim);
+      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`;
+        host.appendChild(band);
+        host.appendChild(div("gp-ov-trim"));
+      }
+      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 { on: true, issues, intended, bleedPt };
+  }
+
   // src/engine/viewer/decorate.ts
   var px = (v) => `${v * PX_PER_PT}px`;
   function elementForHref(href) {
@@ -2095,6 +2337,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));
+      window.dispatchEvent(new CustomEvent("gp:overlay", { detail: overlaySummary }));
+    };
     const api = {
       redraw: () => draw(),
       sheetFor: (p) => sheets.get(p),
@@ -2104,7 +2353,20 @@
       warnings,
       setDesigner(on) {
         document.body.dataset.designer = on ? "on" : "off";
-      }
+      },
+      setOverlay(on) {
+        overlayOn = on;
+        document.body.dataset.overlay = on ? "on" : "off";
+        if (on)
+          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 +2524,7 @@
       warnings.length = 0;
       blankPages = new Set(layout.blankPageIndices);
       paddedPages = new Set(layout.paddedPageIndices);
+      overlayPages = [];
       buildMaps();
       fillXrefs();
       let prevPageH = 0;
@@ -2300,6 +2563,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 +2581,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-3pnmf25p.js}

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

package/dist/{index-vmcfahe2.js → index-jg1r9t4w.js}

@@ -151,19 +151,19 @@ var favicon_default = "./favicon-272ga6y0.ico";
 var manifest_schema_default = "./manifest.schema-gh0jjve9.json";
 
 // src/assets/preview/scripts/preview-interface.js
-var preview_interface_default = "./preview-interface-c44qk17f.js";
+var preview_interface_default = "./preview-interface-dm6wbdq6.js";
 
 // src/assets/preview/scripts/preview-bridge.js
-var preview_bridge_default = "./preview-bridge-8jhd1wpb.js";
+var preview_bridge_default = "./preview-bridge-ga409pgz.js";
 
 // src/assets/preview/scripts/preview-shell.js
-var preview_shell_default = "./preview-shell-xwn84kqr.js";
+var preview_shell_default = "./preview-shell-c909krk2.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-p50c4f08.js";
 
 // src/assets/engine/gutterpress-agent.js
 var gutterpress_agent_default = "./gutterpress-agent-cazqstr1.js";

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

@@ -9,7 +9,7 @@ import {
   getAssetsDir,
   lastPageMode,
   parseSize
-} from "./index-vmcfahe2.js";
+} from "./index-jg1r9t4w.js";
 import {
   INSTALL_HINTS,
   execCapture,
@@ -5747,7 +5747,7 @@ import git from "isomorphic-git";
 // package.json
 var package_default = {
   name: "gutterpress",
-  version: "0.11.17",
+  version: "0.11.18-alpha.1",
   description: "Markdown-to-PDF converter for professional print layout using a native Chromium print engine and Ghostscript.",
   author: "itlackey",
   license: "MPL-2.0",
@@ -10303,7 +10303,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-s2caze6b.js");
       const engineDiagnostics = await buildNativePdf(htmlFile, rawPdf, {
         title: config.title,
         author: config.authors.length > 0 ? config.authors.join(", ") : undefined,

package/dist/index.js

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

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

@@ -7,17 +7,17 @@ import {
   TARGET_IDS,
   scaffoldExtension,
   scaffoldProject
-} from "./cli-a4qtctrw.js";
+} from "./cli-1msxnhzy.js";
 import {
   resolveGhostscript
-} from "./cli-zfgvssqz.js";
+} from "./cli-gv97c2a6.js";
 import {
   UsageError,
   rejectExtraPositionals,
   rejectUnknownFlags
-} from "./cli-8nw6d915.js";
+} from "./cli-bzz33hjz.js";
 import"./cli-ht1bcqdd.js";
-import"./cli-ycbg7mxk.js";
+import"./cli-th1ve2cx.js";
 import {
   EXIT_CODES
 } from "./cli-46ycxe6r.js";

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

@@ -2,17 +2,17 @@ import {
   executeValidation,
   publishTargetFor,
   reportMissingTools
-} from "./cli-a4qtctrw.js";
+} from "./cli-1msxnhzy.js";
 import {
   log
-} from "./cli-zfgvssqz.js";
+} from "./cli-gv97c2a6.js";
 import {
   UsageError,
   rejectExtraPositionals,
   rejectUnknownFlags
-} from "./cli-8nw6d915.js";
+} from "./cli-bzz33hjz.js";
 import"./cli-ht1bcqdd.js";
-import"./cli-ycbg7mxk.js";
+import"./cli-th1ve2cx.js";
 import {
   BuildError,
   EXIT_CODES

package/dist/{preview-bridge-8jhd1wpb.js → preview-bridge-ga409pgz.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. 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-dm6wbdq6.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,28 @@
     // 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.
+    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) {
+      var d = window.Gutterpress && window.Gutterpress.decoration;
+      return d && typeof d.setOverlay === 'function' ? d.setOverlay(!!on) : 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 +1623,47 @@
   // 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.bleedPt) parts.push('no @page bleed set');
+    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-7z8tt0b4.js → preview-m3afbq53.js}

@@ -7,10 +7,10 @@ import {
   runBuild,
   splitOutPath,
   startPreviewServer
-} from "./cli-a4qtctrw.js";
+} from "./cli-1msxnhzy.js";
 import {
   log
-} from "./cli-zfgvssqz.js";
+} from "./cli-gv97c2a6.js";
 import {
   UsageError,
   parseFormat,
@@ -18,9 +18,9 @@ import {
   rejectExtraPositionals,
   rejectUnknownFlags,
   resolvePort
-} from "./cli-8nw6d915.js";
+} from "./cli-bzz33hjz.js";
 import"./cli-ht1bcqdd.js";
-import"./cli-ycbg7mxk.js";
+import"./cli-th1ve2cx.js";
 import {
   BuildError
 } from "./cli-46ycxe6r.js";

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

@@ -106,6 +106,9 @@
       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.
+      if (sourceBody.dataset.overlay === 'on' && api.setMarginOverlay) api.setMarginOverlay(true);
     }
     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-69x46m3f.js}

@@ -11,18 +11,18 @@ import {
   publishProviderFor,
   resolvePublishFormat,
   runPublish
-} from "./cli-a4qtctrw.js";
+} from "./cli-1msxnhzy.js";
 import {
   FileTokenStore,
   log
-} from "./cli-zfgvssqz.js";
+} from "./cli-gv97c2a6.js";
 import {
   UsageError,
   rejectExtraPositionals,
   rejectUnknownFlags
-} from "./cli-8nw6d915.js";
+} from "./cli-bzz33hjz.js";
 import"./cli-ht1bcqdd.js";
-import"./cli-ycbg7mxk.js";
+import"./cli-th1ve2cx.js";
 import {
   EXIT_CODES
 } from "./cli-46ycxe6r.js";

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

@@ -1,16 +1,16 @@
 import {
   executeAndReport
-} from "./cli-a4qtctrw.js";
+} from "./cli-1msxnhzy.js";
 import {
   log
-} from "./cli-zfgvssqz.js";
+} from "./cli-gv97c2a6.js";
 import {
   UsageError,
   rejectExtraPositionals,
   rejectUnknownFlags
-} from "./cli-8nw6d915.js";
+} from "./cli-bzz33hjz.js";
 import"./cli-ht1bcqdd.js";
-import"./cli-ycbg7mxk.js";
+import"./cli-th1ve2cx.js";
 import {
   BuildError,
   EXIT_CODES

package/package.json

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