gutterpress 0.11.22-alpha.1 → 0.11.22-alpha.2

package/dist/cli.js

@@ -8,7 +8,7 @@ import {
 } from "./cli-d8xjns66.js";
 import {
   package_default
-} from "./cli-gc9av5hs.js";
+} from "./cli-3twpesca.js";
 import {
   EXIT_CODES
 } from "./cli-46ycxe6r.js";
@@ -20,14 +20,14 @@ import {
 import { defineCommand, parseArgs, runMain } from "citty";
 import { statSync } from "node:fs";
 var SUBCOMMANDS = {
-  new: () => import("./new-nadp2hvb.js").then((m) => m.default),
-  preview: () => import("./preview-y8chv4cb.js").then((m) => m.default),
-  build: () => import("./build-se85j9ec.js").then((m) => m.default),
-  publish: () => import("./publish-3qwvxsxa.js").then((m) => m.default),
-  validate: () => import("./validate-w108kk87.js").then((m) => m.default),
-  preflight: () => import("./preflight-c6q25xqa.js").then((m) => m.default),
-  doctor: () => import("./doctor-bv2t82zd.js").then((m) => m.default),
-  ext: () => import("./ext-a8ndp142.js").then((m) => m.default)
+  new: () => import("./new-fqtt022k.js").then((m) => m.default),
+  preview: () => import("./preview-52w9pdps.js").then((m) => m.default),
+  build: () => import("./build-84retk4k.js").then((m) => m.default),
+  publish: () => import("./publish-esmcyhpb.js").then((m) => m.default),
+  validate: () => import("./validate-vt1d7h6k.js").then((m) => m.default),
+  preflight: () => import("./preflight-gr9mscjw.js").then((m) => m.default),
+  doctor: () => import("./doctor-fmzpg7ag.js").then((m) => m.default),
+  ext: () => import("./ext-hsdnad5c.js").then((m) => m.default)
 };
 var VERSION = package_default.version;
 var main = defineCommand({
@@ -52,7 +52,7 @@ async function preflightRequiredInvocations(rawArgs) {
   const [command, ...commandArgs] = rawArgs;
   try {
     if (command === "new") {
-      const { newArgs } = await import("./new-nadp2hvb.js");
+      const { newArgs } = await import("./new-fqtt022k.js");
       rejectUnknownFlags(commandArgs, newArgs, "new");
       const parsed = parseArgs(commandArgs, {
         ...newArgs,
@@ -64,7 +64,7 @@ async function preflightRequiredInvocations(rawArgs) {
       return;
     }
     if (command === "preflight") {
-      const { preflightArgs } = await import("./preflight-c6q25xqa.js");
+      const { preflightArgs } = await import("./preflight-gr9mscjw.js");
       rejectUnknownFlags(commandArgs, preflightArgs, "preflight");
       const parsed = parseArgs(commandArgs, {
         ...preflightArgs,
@@ -84,7 +84,7 @@ async function preflightRequiredInvocations(rawArgs) {
       }
       if (subcommand.startsWith("-"))
         return;
-      const { EXT_SUBCOMMANDS, extAddArgs, extRemoveArgs, extEnableArgs, extDisableArgs } = await import("./ext-a8ndp142.js");
+      const { EXT_SUBCOMMANDS, extAddArgs, extRemoveArgs, extEnableArgs, extDisableArgs } = await import("./ext-hsdnad5c.js");
       if (!EXT_SUBCOMMANDS.includes(subcommand)) {
         throw new UsageError(`gutterpress ext: unknown command "${subcommand}"`);
       }

package/dist/{doctor-bv2t82zd.js → doctor-fmzpg7ag.js}

@@ -1,16 +1,16 @@
 import {
   getSystemDiagnostics
-} from "./cli-yejbb9f8.js";
+} from "./cli-5qhjwne5.js";
 import"./cli-asap4t1z.js";
 import {
   log
-} from "./cli-5553w972.js";
+} from "./cli-80t93x2r.js";
 import {
   UsageError,
   rejectExtraPositionals,
   rejectUnknownFlags
 } from "./cli-d8xjns66.js";
-import"./cli-gc9av5hs.js";
+import"./cli-3twpesca.js";
 import"./cli-46ycxe6r.js";
 import"./cli-37x76zdn.js";
 

package/dist/engine/shared/print-area.d.ts

@@ -4,7 +4,12 @@
  * `<meta name="gp-print-area">` by the markdown assembly
  * (lib/markdown/assemble.ts) and read back here by everything that needs it:
  * the preview's print overlays (viewer/overlay.ts) and both engines' pinned
- * art (pin-edges.ts — a pin sits on the printer's art-safe line).
+ * art (pin-edges.ts — a pin sits on the printer's art-safe line). The boxes
+ * those numbers draw on a page (`pageBoxes`) and the judge of a piece of ink
+ * against them (`judgeRect` / `classifyRect`) live here too, so the overlay
+ * and the `pdf.print.safe-margins` check (checks/pdf/safe-margins.ts) read
+ * one definition of "safe" — not in a module of their own, because the four
+ * numbers mean nothing but those boxes.
  *
  * Only the manifest feeds it — `page.width` x `page.height` (the sheet),
  * `page.bleed` (a bleed the sheet already contains on the top, bottom and
@@ -56,6 +61,18 @@ export interface PrintAreaSource {
         url: string;
     };
 }
+/** A usable point value: finite and positive (a page dimension, an inset). */
+export declare function isPositivePoints(value: unknown): value is number;
+/**
+ * The `size` value written for a page — `8.5in 11in`, `595pt 842pt` — by
+ * everything that writes one: Book settings (lib/page-size.ts) into the
+ * book's stylesheet, and the assembly's manifest default
+ * (lib/markdown/assemble.ts), so one size has one spelling.
+ */
+export declare function formatPageSize(page: {
+    width: number;
+    height: number;
+}): string;
 /**
  * The `<meta>` tag for one book. An unset bleed or text rule is written as 0,
  * never left out; an unset art rule or gutter stays out (the reader takes each
@@ -71,3 +88,62 @@ export interface MetaDocument {
 }
 /** The book's print area from its `<meta name="gp-print-area">`; `null` without one. */
 export declare function printAreaFromMeta(doc: MetaDocument): PrintArea | null;
+export interface Rect {
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+}
+/** The nested boxes of one page, in one unit, origin at the sheet's top-left. */
+export interface PageBoxes {
+    /** the whole sheet (the bleed box when the sheet contains a bleed) */
+    sheet: Rect;
+    /** the cut page */
+    trim: Rect;
+    /** where TEXT is safe from the cut: the trim inset by `safe`, and by `gutter` at the binding */
+    safe: Rect;
+    /** where ART is safe from the cut: the trim inset by `artSafe`, and by `gutter` at the binding */
+    safeArt: Rect;
+    bleed: number;
+}
+/**
+ * Boxes for one page. The trim is the sheet pulled in by `bleed` on the top,
+ * bottom and OUTER edge — the right edge of a recto, the left edge of a verso;
+ * the binding edge has no bleed. The text box is the trim pulled in by `safe`
+ * on the top, bottom and outer edge and by `gutter` on the binding edge (left
+ * of a recto, right of a verso); the art box is pulled in by `artSafe` on the
+ * top, bottom and outer edge and by `gutter` on the binding edge.
+ */
+export declare function pageBoxes(area: PrintArea, side: PageSide, scale?: number): PageBoxes;
+/**
+ * Where a piece of ink sits relative to its page, worst first:
+ *  - `inside`   within the box its rule allows
+ *  - `unsafe`   leaves that box but stays on the trimmed page
+ *  - `bleed`    crosses the trim but stays on the sheet (in the bleed band)
+ *  - `off-page` crosses the sheet's edge: that part is not printed at all
+ */
+export type OverflowKind = "inside" | "unsafe" | "bleed" | "off-page";
+/** The rule a piece of ink is judged by: text against `page.safe`, art against `page.artSafe`. */
+export type OverflowRule = "text" | "art";
+/** One edge of a page as drawn: `left` and `right` are the page's own, so the binding is a recto's left and a verso's right. */
+export type PageEdge = "left" | "right" | "top" | "bottom";
+/** The verdict on a piece of ink: see `judgeRect`. */
+export interface Overflow {
+    kind: OverflowKind;
+    gap: number;
+    need: number;
+}
+/**
+ * Judge one rect of ink, edge by edge, against the box its rule allows (text:
+ * `boxes.safe`; art: `boxes.safeArt`). `kind` is the worst edge's and `edge`
+ * names it (`null` when the ink is inside). `gap` is how far that edge sits
+ * inside the trim (negative = past it) and `need` how far inside the rule
+ * wants it, in the boxes' unit. Art that runs out to the sheet's edge is
+ * bleeding there, as it should, so that edge passes. `tol` absorbs sub-pixel
+ * layout (LayoutUnit is 1/64 px) and PDF rounding so an exact fit is not flagged.
+ */
+export declare function judgeRect(r: Rect, boxes: PageBoxes, rule: OverflowRule, tol?: number): Overflow & {
+    edge: PageEdge | null;
+};
+/** `judgeRect` without the edge: the verdict the overlay paints. */
+export declare function classifyRect(r: Rect, boxes: PageBoxes, rule: OverflowRule, tol?: number): Overflow;

package/dist/{engine-h4ehmrvf.js → engine-5p8tn9b4.js}

@@ -1,9 +1,9 @@
 import {
   build
-} from "./cli-8hccw62p.js";
+} from "./cli-9pk65fqf.js";
 import"./cli-eyyggect.js";
 import"./cli-asap4t1z.js";
-import"./cli-gmm3bdeq.js";
+import"./cli-hndkg7bn.js";
 import {
   BuildError
 } from "./cli-46ycxe6r.js";

package/dist/{engine-qwkyhrej.js → engine-9710cd7x.js}

@@ -1,10 +1,10 @@
 import {
   build
-} from "./index-gmfh6n05.js";
-import"./index-5h9a38jn.js";
+} from "./index-2d8j0enc.js";
+import"./index-apc8w9w8.js";
 import {
   BuildError
-} from "./index-dhknsvfz.js";
+} from "./index-jsz0s3dy.js";
 import"./index-bt0qws5c.js";
 import"./index-37x76zdn.js";
 

package/dist/{ext-a8ndp142.js → ext-hsdnad5c.js}

@@ -2,11 +2,11 @@ import {
   importExtensionFromFile,
   importExtensionFromUrl,
   searchNpmExtensions
-} from "./cli-fbwqv7p4.js";
-import"./cli-yejbb9f8.js";
+} from "./cli-885pcze8.js";
+import"./cli-5qhjwne5.js";
 import"./cli-ht1bcqdd.js";
-import"./cli-8hccw62p.js";
-import"./cli-sth219v1.js";
+import"./cli-9pk65fqf.js";
+import"./cli-2ppw6q9v.js";
 import"./cli-eyyggect.js";
 import"./cli-asap4t1z.js";
 import"./cli-habkc5ng.js";
@@ -22,9 +22,9 @@ import {
   removeExtension,
   setExtensionEnabled,
   updateExtensions
-} from "./cli-9vy4b6ec.js";
-import"./cli-pfrg1r9x.js";
-import"./cli-5553w972.js";
+} from "./cli-5et23z83.js";
+import"./cli-pn3z0y9p.js";
+import"./cli-80t93x2r.js";
 import {
   UsageError,
   exitForUsage,
@@ -32,8 +32,8 @@ import {
   rejectUnknownFlags,
   resolveProjectDir
 } from "./cli-d8xjns66.js";
-import"./cli-gc9av5hs.js";
-import"./cli-gmm3bdeq.js";
+import"./cli-3twpesca.js";
+import"./cli-hndkg7bn.js";
 import {
   EXIT_CODES
 } from "./cli-46ycxe6r.js";

package/dist/{extension-restore-926mv2qk.js → extension-restore-05pae3cp.js}

@@ -3,9 +3,9 @@ import {
   restoreForCommand,
   restoreOfflineMessage,
   restorePinnedExtensions
-} from "./index-dm7hx46j.js";
-import"./index-38e18a7j.js";
-import"./index-dhknsvfz.js";
+} from "./index-ew7cyk7c.js";
+import"./index-kx03e4m4.js";
+import"./index-jsz0s3dy.js";
 import"./index-r7jcsk6h.js";
 import"./index-37x76zdn.js";
 export {

package/dist/{extension-restore-q1f7njec.js → extension-restore-3r7phztr.js}

@@ -3,12 +3,12 @@ import {
   restoreForCommand,
   restoreOfflineMessage,
   restorePinnedExtensions
-} from "./cli-9vy4b6ec.js";
-import"./cli-pfrg1r9x.js";
-import"./cli-5553w972.js";
+} from "./cli-5et23z83.js";
+import"./cli-pn3z0y9p.js";
+import"./cli-80t93x2r.js";
 import"./cli-d8xjns66.js";
-import"./cli-gc9av5hs.js";
-import"./cli-gmm3bdeq.js";
+import"./cli-3twpesca.js";
+import"./cli-hndkg7bn.js";
 import"./cli-46ycxe6r.js";
 import"./cli-h3phdstf.js";
 import"./cli-37x76zdn.js";

package/dist/{gutterpress-viewer-w7njnkj7.js → gutterpress-viewer-w9jzx6sb.js}

@@ -1136,6 +1136,62 @@
       return null;
     }
   }
+  function pageBoxes(area, side, scale = 1) {
+    const w = area.width * scale;
+    const h = area.height * scale;
+    const b = Math.max(0, area.bleed) * scale;
+    const s = Math.max(0, area.safe) * scale;
+    const a = Math.max(0, area.artSafe) * scale;
+    const g = Math.max(0, area.gutter) * scale;
+    const [textLeft, textRight] = side === "verso" ? [s, g] : [g, s];
+    const [artLeft, artRight] = side === "verso" ? [a, g] : [g, a];
+    const trim = { x: side === "verso" ? b : 0, y: b, w: Math.max(0, w - b), h: Math.max(0, h - 2 * b) };
+    return {
+      sheet: { x: 0, y: 0, w, h },
+      trim,
+      safe: {
+        x: trim.x + textLeft,
+        y: trim.y + s,
+        w: Math.max(0, trim.w - textLeft - textRight),
+        h: Math.max(0, trim.h - 2 * s)
+      },
+      safeArt: {
+        x: trim.x + artLeft,
+        y: trim.y + a,
+        w: Math.max(0, trim.w - artLeft - artRight),
+        h: Math.max(0, trim.h - 2 * a)
+      },
+      bleed: b
+    };
+  }
+  var SEVERITY = { inside: 0, unsafe: 1, bleed: 2, "off-page": 3 };
+  function judgeRect(r, boxes, rule, tol = 0) {
+    const { sheet, trim } = boxes;
+    const safe = rule === "art" ? boxes.safeArt : boxes.safe;
+    const sides = [
+      ["left", -r.x, -safe.x, -trim.x, -sheet.x],
+      ["right", r.x + r.w, safe.x + safe.w, trim.x + trim.w, sheet.x + sheet.w],
+      ["top", -r.y, -safe.y, -trim.y, -sheet.y],
+      ["bottom", r.y + r.h, safe.y + safe.h, trim.y + trim.h, sheet.y + sheet.h]
+    ];
+    let worst = { kind: "inside", gap: 0, need: 0, edge: null };
+    let beyond = 0;
+    for (const [edge, ink, limit, trimEdge, sheetEdge] of sides) {
+      const past = ink - limit;
+      if (past <= tol || rule === "art" && ink >= sheetEdge - tol)
+        continue;
+      const kind = ink > sheetEdge + tol ? "off-page" : ink > trimEdge + tol ? "bleed" : "unsafe";
+      if (SEVERITY[kind] > SEVERITY[worst.kind] || kind === worst.kind && past > beyond) {
+        worst = { kind, gap: trimEdge - ink, need: trimEdge - limit, edge };
+        beyond = past;
+      }
+    }
+    return worst;
+  }
+  function classifyRect(r, boxes, rule, tol = 0) {
+    const { kind, gap, need } = judgeRect(r, boxes, rule, tol);
+    return { kind, gap, need };
+  }
 
   // src/engine/viewer/fragment.ts
   var PX_PER_PT = 96 / 72;
@@ -2250,58 +2306,6 @@
   }
 
   // src/engine/viewer/overlay.ts
-  function pageBoxes(area, side, scale = 1) {
-    const w = area.width * scale;
-    const h = area.height * scale;
-    const b = Math.max(0, area.bleed) * scale;
-    const s = Math.max(0, area.safe) * scale;
-    const a = Math.max(0, area.artSafe) * scale;
-    const g = Math.max(0, area.gutter) * scale;
-    const [textLeft, textRight] = side === "verso" ? [s, g] : [g, s];
-    const [artLeft, artRight] = side === "verso" ? [a, g] : [g, a];
-    const trim = { x: side === "verso" ? b : 0, y: b, w: Math.max(0, w - b), h: Math.max(0, h - 2 * b) };
-    return {
-      sheet: { x: 0, y: 0, w, h },
-      trim,
-      safe: {
-        x: trim.x + textLeft,
-        y: trim.y + s,
-        w: Math.max(0, trim.w - textLeft - textRight),
-        h: Math.max(0, trim.h - 2 * s)
-      },
-      safeArt: {
-        x: trim.x + artLeft,
-        y: trim.y + a,
-        w: Math.max(0, trim.w - artLeft - artRight),
-        h: Math.max(0, trim.h - 2 * a)
-      },
-      bleed: b
-    };
-  }
-  var SEVERITY = { inside: 0, unsafe: 1, bleed: 2, "off-page": 3 };
-  function classifyRect(r, boxes, rule, tol = 0) {
-    const { sheet, trim } = boxes;
-    const safe = rule === "art" ? boxes.safeArt : boxes.safe;
-    const sides = [
-      [-r.x, -safe.x, -trim.x, -sheet.x],
-      [r.x + r.w, safe.x + safe.w, trim.x + trim.w, sheet.x + sheet.w],
-      [-r.y, -safe.y, -trim.y, -sheet.y],
-      [r.y + r.h, safe.y + safe.h, trim.y + trim.h, sheet.y + sheet.h]
-    ];
-    let worst = { kind: "inside", gap: 0, need: 0 };
-    let beyond = 0;
-    for (const [ink, limit, edge, sheetEdge] of sides) {
-      const past = ink - limit;
-      if (past <= tol || rule === "art" && ink >= sheetEdge - tol)
-        continue;
-      const kind = ink > sheetEdge + tol ? "off-page" : ink > edge + tol ? "bleed" : "unsafe";
-      if (SEVERITY[kind] > SEVERITY[worst.kind] || kind === worst.kind && past > beyond) {
-        worst = { kind, gap: edge - ink, need: edge - limit };
-        beyond = past;
-      }
-    }
-    return worst;
-  }
   var INTENT_SELECTOR = ".gp-bleed, .gp-pin, .gp-flush, .gp-behind, .gp-page-full-bleed";
   var OVERLAY_LAYERS = ["bleed", "safe", "art", "margins"];
   function layersFrom(state) {

package/dist/{index-gmfh6n05.js → index-2d8j0enc.js}

@@ -18,10 +18,10 @@ import {
   stringValueAt,
   toFolioPage,
   wantsRecto
-} from "./index-5h9a38jn.js";
+} from "./index-apc8w9w8.js";
 import {
   getAssetPath
-} from "./index-dhknsvfz.js";
+} from "./index-jsz0s3dy.js";
 import {
   launchChromium
 } from "./index-bt0qws5c.js";

package/dist/{index-sth219v1.js → index-2ppw6q9v.js}

@@ -168,6 +168,14 @@ function getTextPass(doc) {
   return p;
 }
 var opCache = new WeakMap;
+var opSet = (names) => new Set(names.map((name) => OPS[name]).filter((op) => op !== undefined));
+var IMAGE_OPS = opSet([
+  "paintImageXObject",
+  "paintImageXObjectRepeat",
+  "paintInlineImageXObject",
+  "paintImageMaskXObject",
+  "paintJpegXObject"
+]);
 function multiply(m1, m2) {
   return [
     m1[0] * m2[0] + m1[2] * m2[1],
@@ -219,14 +227,27 @@ function getOpPass(doc) {
             ctm = stack.pop() ?? ctm;
           } else if (fn === OPS.transform) {
             ctm = multiply(ctm, args);
-          } else if (fn === OPS.paintImageXObject || fn === OPS.paintImageXObjectRepeat || fn === OPS.paintInlineImageXObject) {
+          } else if (fn === OPS.paintFormXObjectBegin) {
+            stack.push(ctm.slice());
+            const matrix = args[0];
+            if (Array.isArray(matrix))
+              ctm = multiply(ctm, matrix);
+          } else if (fn === OPS.paintFormXObjectEnd) {
+            ctm = stack.pop() ?? ctm;
+          } else if (IMAGE_OPS.has(fn)) {
             const name = typeof args[0] === "string" ? args[0] : "(inline)";
+            const [a, b, c, d, e, f] = ctm;
+            const xs = [e, a + e, c + e, a + c + e];
+            const ys = [f, b + f, d + f, b + d + f];
+            const x0 = Math.min(...xs);
+            const y0 = Math.min(...ys);
             pageImages.push({
               name,
-              placedW: Math.hypot(ctm[0], ctm[1]),
-              placedH: Math.hypot(ctm[2], ctm[3]),
-              x: ctm[4],
-              y: ctm[5],
+              placedW: Math.hypot(a, b),
+              placedH: Math.hypot(c, d),
+              x: e,
+              y: f,
+              bounds: { x: x0, y: y0, w: Math.max(...xs) - x0, h: Math.max(...ys) - y0 },
               page: i
             });
           } else if (fn === OPS.setFont) {
@@ -254,7 +275,6 @@ function getOpPass(doc) {
   }
   return p;
 }
-var opSet = (names) => new Set(names.map((name) => OPS[name]).filter((op) => op !== undefined));
 var FILL_COLOR_OPS = opSet(["setFillGray", "setFillRGBColor", "setFillCMYKColor", "setFillColor"]);
 var STROKE_COLOR_OPS = opSet(["setStrokeGray", "setStrokeRGBColor", "setStrokeCMYKColor", "setStrokeColor"]);
 var SHOW_TEXT_OPS = opSet(["showText", "showSpacedText", "nextLineShowText", "nextLineSetSpacingShowText"]);