gutterpress 0.11.20-alpha.2 → 0.11.20-alpha.4

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

@@ -20,17 +20,11 @@ import type { PrintPadding } from '../engine/shared/synthesis.ts';
  *
  * The book always paginates as ONE document, exactly as the print path does:
  * no per-source wrappers or forced breaks are added, so preview pagination
- * never diverges from the PDF where a source file begins mid-page.
+ * never diverges from the PDF where a source file begins mid-page. The
+ * project's print area is not added here: the markdown assembly writes it
+ * into every book, the preview's included (`AssembleBookHtmlOptions.printArea`).
  */
-export declare function injectPreviewScripts(html: string, page?: {
-    width: number;
-    height: number;
-    bleed?: number;
-    safe?: number;
-    artSafe?: number;
-    preset?: string;
-    spec?: PrintSpec;
-}): string;
+export declare function injectPreviewScripts(html: string): 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

package/dist/{preview-q76xn95h.js → preview-j91sxadd.js}

@@ -6,10 +6,10 @@ import {
   runBuild,
   splitOutPath,
   startPreviewServer
-} from "./cli-zacevwcy.js";
+} from "./cli-0ey902sx.js";
 import {
   log
-} from "./cli-gh0ym80r.js";
+} from "./cli-h4tfmpg3.js";
 import {
   UsageError,
   parseFormat,
@@ -17,12 +17,13 @@ import {
   rejectExtraPositionals,
   rejectUnknownFlags,
   resolvePort
-} from "./cli-7z29z4wz.js";
+} from "./cli-fmksazej.js";
 import"./cli-ht1bcqdd.js";
-import"./cli-j802s31j.js";
+import"./cli-61vd4ews.js";
 import {
   BuildError
 } from "./cli-46ycxe6r.js";
+import"./cli-sth219v1.js";
 import"./cli-eyyggect.js";
 import"./cli-asap4t1z.js";
 import"./cli-5qr3z0qa.js";

package/dist/{publish-7gdy6gbf.js → publish-f12xaenm.js}

@@ -11,21 +11,22 @@ import {
   publishProviderFor,
   resolvePublishFormat,
   runPublish
-} from "./cli-zacevwcy.js";
+} from "./cli-0ey902sx.js";
 import {
   FileTokenStore,
   log
-} from "./cli-gh0ym80r.js";
+} from "./cli-h4tfmpg3.js";
 import {
   UsageError,
   rejectExtraPositionals,
   rejectUnknownFlags
-} from "./cli-7z29z4wz.js";
+} from "./cli-fmksazej.js";
 import"./cli-ht1bcqdd.js";
-import"./cli-j802s31j.js";
+import"./cli-61vd4ews.js";
 import {
   EXIT_CODES
 } from "./cli-46ycxe6r.js";
+import"./cli-sth219v1.js";
 import"./cli-eyyggect.js";
 import"./cli-asap4t1z.js";
 import"./cli-5qr3z0qa.js";

package/dist/render.js

@@ -1231,7 +1231,9 @@ var GUTTERPRESS_CSS = `
    cap at equal specificity */
 .gp-small { width: 25%; max-width: 100%; }
 .gp-medium { width: 50%; max-width: 100%; }
-.gp-large { width: 75%; max-width: 100%; }
+.gp-large { width: 60%; max-width: 100%; }
+.gp-xl { width: 80%; max-width: 100%; }
+.gp-xxl { width: 90%; max-width: 100%; }
 
 /* float clearance presets — consumed by var(--gp-gap) in the float rules
    above and by .gp-shape's shape-margin below; --gp-gap itself is
@@ -1289,10 +1291,16 @@ img.gp-shape {
 }
 
 /* pin — within the nearest positioned ancestor (.page/.spread, rule above).
-   inset:0 and the explicit centers are load-bearing; see doctrine comment. */
+   The four insets are the pin box: 0 (the text block's edge) unless an
+   engine set --gp-pin-<edge> on the page root for an edge a pin uses (the
+   art-safe line). Non-auto insets and the explicit centers are
+   load-bearing; see doctrine comment. */
 .gp-pin {
   position: absolute;
-  inset: 0;
+  top: var(--gp-pin-top, 0px);
+  right: var(--gp-pin-right, 0px);
+  bottom: var(--gp-pin-bottom, 0px);
+  left: var(--gp-pin-left, 0px);
   align-self: center;
   justify-self: center;
   margin: 0;
@@ -1307,6 +1315,16 @@ img.gp-shape {
 .gp-left { justify-self: start; }
 .gp-right { justify-self: end; }
 
+/* the escape hatch — the paper's edge, past the printer's safe area: the
+   pin box loses its art-safe insets. Set on the pin itself, so it beats the
+   values the page root hands down. */
+.gp-pin.gp-flush {
+  --gp-pin-top: 0px;
+  --gp-pin-right: 0px;
+  --gp-pin-bottom: 0px;
+  --gp-pin-left: 0px;
+}
+
 /* wrapper-margin neutralization (same pattern and rationale as the
    .gp-bleed paragraph-margin note in the doctrine comment; for pin, the
    emptied paragraph would otherwise leave a phantom margin gap in flow) */
@@ -1416,6 +1434,8 @@ var GP_CLASSES = new Set([
   "gp-small",
   "gp-medium",
   "gp-large",
+  "gp-xl",
+  "gp-xxl",
   "gp-tight",
   "gp-loose",
   "gp-columns",
@@ -1432,6 +1452,7 @@ var GP_CLASSES = new Set([
   "gp-pin",
   "gp-top",
   "gp-bottom",
+  "gp-flush",
   "gp-behind",
   "gp-base",
   "gp-raised",
@@ -1445,8 +1466,7 @@ var GP_CLASSES = new Set([
   "gp-alert-caution",
   "gp-page-break",
   "gp-column-break",
-  "gp-continued",
-  "gp-flush"
+  "gp-continued"
 ]);
 
 // src/lib/markdown/table-align.ts
@@ -1550,6 +1570,21 @@ function hasPinClass(token) {
   const cls = token.attrGet && token.attrGet("class");
   return typeof cls === "string" && cls.split(/\s+/).includes("gp-pin");
 }
+var PIN_EDGES = ["gp-top", "gp-right", "gp-bottom", "gp-left"];
+var FLUSH_ART_MSG = "`.gp-flush` puts this image on the paper's edge, past the printer's safe area. Printers trim up to 0.125in there, so keep it for art that is meant to bleed off the page.";
+function checkFlushArt(token, env, line) {
+  if (token.type !== "image")
+    return;
+  const cls = token.attrGet && token.attrGet("class");
+  if (typeof cls !== "string")
+    return;
+  const classes = cls.split(/\s+/);
+  if (!classes.includes("gp-pin") || !classes.includes("gp-flush"))
+    return;
+  if (!classes.some((c) => PIN_EDGES.includes(c)))
+    return;
+  warn2(env, line, "flush_art", FLUSH_ART_MSG);
+}
 function elementNameFor(token) {
   switch (token.type) {
     case "layout_chapter_open":
@@ -1609,6 +1644,7 @@ function gpPinScope(md) {
       if (token.type === "inline" && token.children) {
         for (const child of token.children) {
           checkUnknownGpClasses(child, state.env, line);
+          checkFlushArt(child, state.env, line);
         }
       }
     }
@@ -2343,6 +2379,20 @@ function lastPageMode(print) {
 }
 var WHICH_VALUES = new Set(["first", "start", "last", "first-except"]);
 
+// src/engine/shared/print-area.ts
+function printAreaMeta(page) {
+  const area = JSON.stringify({
+    width: page.width,
+    height: page.height,
+    bleed: page.bleed ?? 0,
+    safe: page.safe ?? 0,
+    artSafe: page.artSafe,
+    preset: page.preset,
+    spec: page.spec
+  });
+  return `<meta name="gp-print-area" content='${area.replace(/&/g, "&amp;").replace(/'/g, "&#39;")}'>`;
+}
+
 // src/lib/markdown/assemble.ts
 async function assembleBookHtml(opts) {
   const title = opts.title ?? "Document";
@@ -2408,7 +2458,8 @@ ${projectCss.trim()}` : null
 <html lang="en"${printAttrs}>
 <head>
   <meta charset="UTF-8">
-  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">${opts.printArea ? `
+  ${printAreaMeta(opts.printArea)}` : ""}
   <title>${title}</title>${preloadTags}
   <style data-project-css>
 ${inlineCss}

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

@@ -119,8 +119,24 @@ export interface GutterpressManifest {
         /** `k-only` prints near-black text on the black plate alone (#331). */
         blackText?: "icc" | "k-only";
         /**
-         * Resolution (DPI) of the picture Ghostscript makes of a page it flattens
-         * because the page uses transparency. Unset: Ghostscript's default (720).
+         * A page that uses transparency, which PDF/X cannot hold (#385).
+         * `flatten-page` (default): Ghostscript rasterizes the whole page, text
+         * included. `preserve-text`: flatten the artwork only and keep the text
+         * live on top; a page whose text cannot be split (translucent or blended,
+         * Type 3, pattern-filled or a clip) or that has a repeating or conic
+         * gradient falls back to the whole-page flattening.
+         */
+        transparency?: "flatten-page" | "preserve-text";
+        /**
+         * `preserve-text` only: pages (1-based, as the build reports them) left to
+         * Ghostscript's whole-page flattening, e.g. a page whose look depends on a
+         * cover or tint painted over its text.
+         */
+        flattenPages?: number[];
+        /**
+         * Resolution (DPI) of every picture made from a transparent page: the
+         * whole page Ghostscript flattens, and the `preserve-text` artwork.
+         * Unset: Ghostscript's default (720) and 300 for `preserve-text` artwork.
          */
         rasterDpi?: number;
     };
@@ -155,17 +171,18 @@ export interface GutterpressManifest {
          * 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 safe
-         * area & bleed overlay and `pdf.print.safe-margins` where the trim is.
+         * book). By itself it changes nothing in the PDF: it tells the preview's
+         * safe area & bleed overlay, `pdf.print.safe-margins` and pinned art
+         * (`.gp-pin` on an edge sits on the art-safe line) where the trim is.
          */
         bleed?: number;
         /**
          * The TEXT rule (pt): glyphs stay at least this far inside the trim on
          * EVERY edge — DriveThruRPG's "keep text 0.5in inside the trim" (`dtrpg`
          * sets 36). The preview's overlay outlines it and flags text outside it,
-         * and `pdf.print.safe-margins` fails a built PDF whose text is closer. Like
-         * `bleed`, it changes nothing in the PDF, and nothing in a book's CSS moves
-         * it.
+         * and `pdf.print.safe-margins` fails a built PDF whose text is closer. An
+         * image pinned to the binding edge sits on it (and to any edge, where
+         * `artSafe` is not set); nothing in a book's CSS moves it.
          */
         safe?: number;
         /**
@@ -173,7 +190,8 @@ export interface GutterpressManifest {
          * borders, rules — stays at least this far inside the trim on the top,
          * bottom and OUTER edge; at the binding edge it uses `safe`. DriveThruRPG's
          * "keep non-bleeding art 0.25in from the outside edges" (`dtrpg` sets 18).
-         * Absent = the same as `safe`.
+         * An image pinned to the top, bottom or outer edge (`.gp-pin`) sits on this
+         * line unless it carries `.gp-flush`. Absent = the same as `safe`.
          */
         artSafe?: number;
     };
@@ -290,6 +308,8 @@ export interface ResolvedConfig {
         icc: string;
         stripAnnotations: boolean;
         blackText: "icc" | "k-only";
+        transparency: "flatten-page" | "preserve-text";
+        flattenPages: number[];
         rasterDpi?: number;
     };
     print: {

package/dist/test-helpers/testkit.d.ts

@@ -106,8 +106,8 @@ export interface GrayRaster {
 }
 /** Ghostscript's path, or `null`. Callers self-skip, as the PDF/X suites do. */
 export declare function resolveRasterizer(): Promise<string | null>;
-/** Page 1 of `pdfPath` as an 8-bit grayscale raster at 100 dpi. */
-export declare function rasterizePdfPage(gsBin: string, pdfPath: string, outDir: string, tag: string): GrayRaster;
+/** Page `page` (default 1) of `pdfPath` as an 8-bit grayscale raster at 100 dpi. */
+export declare function rasterizePdfPage(gsBin: string, pdfPath: string, outDir: string, tag: string, page?: number): GrayRaster;
 /**
  * Mean absolute per-pixel difference. `0` means the two prints are identical —
  * i.e. the declaration under test changed nothing at all.

package/dist/{validate-e3ryegce.js → validate-pb5gysvr.js}

@@ -1,20 +1,21 @@
 import {
   executeAndReport
-} from "./cli-zacevwcy.js";
+} from "./cli-0ey902sx.js";
 import {
   log
-} from "./cli-gh0ym80r.js";
+} from "./cli-h4tfmpg3.js";
 import {
   UsageError,
   rejectExtraPositionals,
   rejectUnknownFlags
-} from "./cli-7z29z4wz.js";
+} from "./cli-fmksazej.js";
 import"./cli-ht1bcqdd.js";
-import"./cli-j802s31j.js";
+import"./cli-61vd4ews.js";
 import {
   BuildError,
   EXIT_CODES
 } from "./cli-46ycxe6r.js";
+import"./cli-sth219v1.js";
 import"./cli-eyyggect.js";
 import"./cli-asap4t1z.js";
 import"./cli-5qr3z0qa.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gutterpress",
-  "version": "0.11.20-alpha.2",
+  "version": "0.11.20-alpha.4",
   "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/engine/shared/flush.d.ts

@@ -1,59 +0,0 @@
-/**
- * `.gp-flush` policy — shared by the compiler and the viewer, like every rule
- * that DECIDES something (see synthesis.ts's header).
- *
- * A pinned image reaches the paper only if the page's own margin is removed
- * on that edge: Chromium's printable area IS the page area — MEASURED, a
- * pinned box pulled into the margin with negative insets fragments onto the
- * NEXT sheet, one moved there with a transform is clipped away entirely, and
- * a margin box in a ~zero margin (1px, with padding/height compensation)
- * simply does not render. So flush is implemented as page GEOMETRY, per page:
- *
- *  - The COMPILER aliases the flush root's own page context under a
- *    generated name (verbatim rule copies — never a resolved flatten, which
- *    is the "re-implement the @page cascade" trap tier2's history records),
- *    zeroes the flushed margins on the alias, and assigns the root to it.
- *  - The VIEWER keeps the author's page context and adjusts the strip
- *    geometry in JS from these same functions.
- *
- * Margin boxes live IN the margin, so the flushed edge's furniture (folio,
- * running head) cannot render natively there — MEASURED, no compensation
- * trick survives. Both renderers therefore keep painting that furniture
- * themselves at its ORIGINAL coordinates: the viewer already synthesizes all
- * furniture as DOM; the compiler injects the flushed edge's boxes into the
- * page root as positioned elements with engine-resolved text. Nothing the
- * author declared is lost — that is the contract this module's box map
- * exists to keep.
- */
-import type { PageGeometry } from "./gcpm-extract.ts";
-export declare const FLUSH_EDGES: readonly ["top", "right", "bottom", "left"];
-export type FlushEdge = (typeof FLUSH_EDGES)[number];
-/** Minimal DOM shape needed by `flushEdgesIn` — keeps this module node-safe. */
-interface QueryRoot {
-    querySelector(sel: string): unknown;
-}
-/**
- * Which edges the flush pins inside `root` ask for, in canonical t/r/b/l
- * order. A `.gp-flush` without `.gp-pin` or without an edge word is inert by
- * construction — every selector here requires all three.
- */
-export declare function flushEdgesIn(root: QueryRoot): FlushEdge[];
-/** Canonical short key for an edge set: "b", "rb", "trbl"… (t/r/b/l order). */
-export declare function flushKey(edges: readonly FlushEdge[]): string;
-/**
- * Generated page name for (author page context, edge set). The `gp--` double
- * dash marks an engine-generated page (the `gp--blank` convention); these
- * exist only in builds that actually contain a flush pin, which is why the
- * width check may treat them as real author contexts.
- */
-export declare function flushPageName(authorPage: string | undefined, edges: readonly FlushEdge[]): string;
-/** The page's margins with the flushed edges freed. */
-export declare function flushMargins(margin: PageGeometry["margin"], edges: readonly FlushEdge[]): PageGeometry["margin"];
-/**
- * Margin boxes that live (wholly or partly) in a flushed edge's margin area —
- * the set both renderers must keep painting themselves. A corner box belongs
- * to BOTH of its edges: `bottom-left-corner` dies when either the bottom or
- * the left margin is freed.
- */
-export declare function marginBoxesOnEdges(edges: readonly FlushEdge[]): string[];
-export {};