gutterpress 0.10.0-alpha.3 → 0.10.0-beta.1

package/dist/{index-s416qpdv.js → index-052x5fef.js}

@@ -2,6 +2,7 @@ import {
   BuildError,
   EXIT_CODES,
   INSTALL_HINTS,
+  MARGIN_BOX_IGNORED_PROPERTIES,
   RENDER_TIMEOUT_MS,
   REQUIRED_MILESTONE,
   closeBrowser,
@@ -16,7 +17,7 @@ import {
   resolveChromiumExecutable,
   run,
   spawnCapture
-} from "./index-mvehxh0e.js";
+} from "./index-c2b6gyeg.js";
 import {
   gitDirFor,
   gitScopeFor,
@@ -731,6 +732,9 @@ function warn(env, line, type, message, marker) {
     env.layoutWarnings = [];
   env.layoutWarnings.push({ line, type, message, marker });
 }
+function proseEscapeHint(kind) {
+  return ` If this line is prose that happens to begin with "@${kind}" — a wrapped sentence, for` + ` instance — escape it as \\@${kind} or write it as \`@${kind}\` in backticks, and it stays text.`;
+}
 function addClasses(token, baseClass, extraClass) {
   const cls = [];
   if (baseClass)
@@ -792,14 +796,14 @@ function plugin(md, pluginOptions = {}) {
       const unknown = parsed.__unknownTokens;
       delete parsed.__unknownTokens;
       for (const t of unknown) {
-        warn(state.env, startLine + 1, "unrecognized_marker_token", `@${parsed.kind}: "${t}" is not something a marker understands, so it was kept verbatim as a class name. Write a class as .my-class (or {.my-class}), an id as #my-id, and anything else as key=value.`, parsed);
+        warn(state.env, startLine + 1, "unrecognized_marker_token", `@${parsed.kind}: "${t}" is not something a marker understands, so it was kept verbatim as a class name. Write a class as .my-class (or {.my-class}), an id as #my-id, and anything else as key=value.` + proseEscapeHint(parsed.kind), parsed);
       }
     }
     if (parsed.__extraBareTokens) {
       const { tokens, named } = parsed.__extraBareTokens;
       delete parsed.__extraBareTokens;
       const list = tokens.map((t) => `"${t}"`).join(", ");
-      warn(state.env, startLine + 1, "extra_bare_marker_token", named ? `@${parsed.kind}: only the first plain word (${list.split(", ")[0]}) is used as the name; the rest (${tokens.slice(1).map((t) => `"${t}"`).join(", ")}) became class names instead. Quote a name that contains spaces ("${tokens.join(" ")}"), or write classes as .${tokens.slice(1).join(" .")}.` : `@${parsed.kind}: ${list} are several plain words, but a marker has only one name slot — so NONE of them was used as the name and they all became class names instead. Quote a name that contains spaces ("${tokens.join(" ")}"), or write classes as .${tokens.join(" .")}.`, parsed);
+      warn(state.env, startLine + 1, "extra_bare_marker_token", named ? `@${parsed.kind}: only the first plain word (${list.split(", ")[0]}) is used as the name; the rest (${tokens.slice(1).map((t) => `"${t}"`).join(", ")}) became class names instead. Quote a name that contains spaces ("${tokens.join(" ")}"), or write classes as .${tokens.slice(1).join(" .")}.` : `@${parsed.kind}: ${list} are several plain words, but a marker has only one name slot — so NONE of them was used as the name and they all became class names instead. Quote a name that contains spaces ("${tokens.join(" ")}"), or write classes as .${tokens.join(" .")}.` + proseEscapeHint(parsed.kind), parsed);
     }
     state.line = startLine + 1;
     return true;
@@ -891,7 +895,12 @@ function plugin(md, pluginOptions = {}) {
       t.meta = { line: meta.__line };
       addClasses(t, "spread", meta.attrs && meta.attrs.class ? meta.attrs.class : "");
       attachDataAttrs(t, "spread", meta.name, meta.attrs || {});
-      stack.open({ kind: "spread", noPagesYet: true, sawAnyPage: false }, t);
+      stack.open({
+        kind: "spread",
+        classes: meta.attrs && meta.attrs.class || "",
+        noPagesYet: true,
+        sawAnyPage: false
+      }, t);
     }
     function openPage(meta) {
       const chapter = stack.get("chapter");
@@ -906,7 +915,7 @@ function plugin(md, pluginOptions = {}) {
       const label = chapter ? chapter.label : "";
       if (label)
         t.attrSet("data-chapter-label", label);
-      stack.open({ kind: "page" }, t);
+      stack.open({ kind: "page", classes: explicit }, t);
       if (label && !chapter.openerEmitted) {
         const opener = new state.Token("html_block", "", 0);
         opener.content = `<div class="chapter-opener" data-chapter-label="${escapeAttr(label)}">${escapeHtml(label)}</div>
@@ -929,13 +938,51 @@ function plugin(md, pluginOptions = {}) {
       t.meta = { hasColumnBreak: false, line: meta.__line };
       stack.open({
         kind: "section",
+        classes: meta.attrs && meta.attrs.class || "",
+        sawContent: false,
         meta: { name: meta.name || null, attrs: { ...meta.attrs || {} } },
         openToken: t
       }, t);
     }
+    function breakHost() {
+      return stack.get("section") || stack.get("page") || stack.get("spread");
+    }
+    function gridClassOf(frame) {
+      if (!frame || !frame.classes)
+        return null;
+      return frame.classes.split(/\s+/).find((c) => c.startsWith("gp-grid-")) || null;
+    }
+    function warnBreakInsideGrid(kind, line, meta) {
+      const host = breakHost();
+      const gridClass = gridClassOf(host);
+      if (!gridClass)
+        return;
+      warn(state.env, line, "break_inside_grid", `@${kind} inside a grid container: the enclosing @${host.kind} carries .${gridClass}, so this break's <div> becomes a grid ITEM — it takes a cell of its own, corrupts the grid's placement, and print and the live preview then disagree about which page the content after it lands on. Move the break outside the grid @${host.kind}, or remove it — grid rows already flow and fragment across pages on their own.`, meta);
+    }
+    function warnIfEmptyDecoratedSection(closingKind, closingLine) {
+      const sec = stack.get("section");
+      if (!sec || sec.sawContent)
+        return;
+      const attrs = sec.meta && sec.meta.attrs || {};
+      const decorations = [];
+      for (const c of (attrs.class || "").split(/\s+/).filter(Boolean))
+        decorations.push(`.${c}`);
+      for (const [k, v] of Object.entries(attrs)) {
+        if (k === "class")
+          continue;
+        decorations.push(k === "id" ? `#${v}` : `${k}=${v}`);
+      }
+      if (!decorations.length)
+        return;
+      const openLine = sec.openToken && sec.openToken.meta && Number.isFinite(sec.openToken.meta.line) ? sec.openToken.meta.line : closingLine;
+      warn(state.env, openLine, "empty_section", `This @section (${decorations.join(" ")}) was closed by the @${closingKind} on line ${closingLine} with no content between the two markers, so its styling applies to an empty element and nothing prints the layout it asked for. Delete one of the two markers, or move the content that belongs inside the section between them.`, null);
+    }
     for (let i = 0;i < state.tokens.length; i++) {
       const tok = state.tokens[i];
       if (tok.type !== "layout_marker") {
+        const openSectionFrame = stack.get("section");
+        if (openSectionFrame)
+          openSectionFrame.sawContent = true;
         out.push(tok);
         continue;
       }
@@ -961,6 +1008,7 @@ function plugin(md, pluginOptions = {}) {
         continue;
       }
       if (kind === "section") {
+        warnIfEmptyDecoratedSection("section", line);
         stack.close("section");
         const spread = stack.get("spread");
         if (spread && spread.noPagesYet) {
@@ -989,6 +1037,7 @@ function plugin(md, pluginOptions = {}) {
         continue;
       }
       if (kind === "page-break") {
+        warnBreakInsideGrid("page-break", line, meta);
         const t = new state.Token("layout_page_break", "div", 0);
         t.meta = { line };
         t.attrSet("class", "gp-page-break");
@@ -997,6 +1046,7 @@ function plugin(md, pluginOptions = {}) {
         continue;
       }
       if (kind === "column-break") {
+        warnBreakInsideGrid("column-break", line, meta);
         const openSectionFrame = stack.get("section");
         if (openSectionFrame && openSectionFrame.openToken && !openSectionFrame.openToken.meta.hasColumnBreak) {
           const sectionCls = openSectionFrame.openToken.attrGet("class") || "";
@@ -1012,6 +1062,7 @@ function plugin(md, pluginOptions = {}) {
         continue;
       }
       if (kind === "end-section") {
+        warnIfEmptyDecoratedSection("end-section", line);
         stack.close("section");
         continue;
       }
@@ -1099,7 +1150,7 @@ body { margin: 0; }
 .gp-page-break { break-before: page; }
 .page { break-before: page; }
 .spread { break-before: page; }
-:where(.page, .spread) { position: relative; }
+:where(.page, .spread) { position: relative; display: flow-root; box-sizing: border-box; min-height: calc(var(--gp-content-h, 1px) - 1px); }
 .gp-column-break { break-after: column; height: 0; font-size: 0; line-height: 0; visibility: hidden; }
 
 :where(h1,h2,h3,h4,h5,h6) { break-after: avoid; }
@@ -1183,6 +1234,26 @@ var GUTTERPRESS_CSS = `
 .gp-columns-2 { columns: 2; column-gap: var(--gp-column-gap, 1.5em); }
 .gp-columns-3 { columns: 3; column-gap: var(--gp-column-gap, 1.5em); }
 
+/* grid runs — the SLOTTED counterpart to the column runs above. Grid places
+   each child into the next cell, across then down (deterministic slots: card
+   layouts, stat blocks, image-plus-caption pairs); columns FLOW one text run
+   down then across. Same neutral-primitive rationale as .gp-columns-*, and
+   permanent vocabulary for the same reason: standard CSS Grid verbatim, no
+   spec gap to remove later. MEASURED (Chromium 151, gp-grid evidence pack):
+   grid rows fragment across sheets with EXACT print/viewer parity — 2- and
+   3-col, unequal item heights, mid-row cuts, multi-sheet overflow,
+   break-inside:avoid, gap geometry — so a grid taller than the page is safe,
+   no fit-one-page constraint. Two things to know, not fix:
+     - on a min-height page root (MARKER_CSS), default align-content
+       stretches rows apart to fill the page — identically in both engines.
+       Authors wanting packed rows set align-content: start.
+     - a @page-break / @column-break marker DIRECTLY inside a grid container
+       becomes a grid item and corrupts placement (the one measured parity
+       break); markers.js diagnoses it (break_inside_grid).
+   --gp-grid-gap is author-settable. */
+.gp-grid-2 { display: grid; grid-template-columns: repeat(2, 1fr); gap: var(--gp-grid-gap, 1.5em); }
+.gp-grid-3 { display: grid; grid-template-columns: repeat(3, 1fr); gap: var(--gp-grid-gap, 1.5em); }
+
 /* shape wrap — text follows the image's alpha silhouette instead of its
    rectangular box. shape-outside only applies to floats, so this is inert
    without .gp-left/.gp-right (and under .gp-pin, which un-floats). The
@@ -1245,8 +1316,14 @@ img.gp-shape {
        opacity, filter, transform on it traps the negative layer inside).
        Core keeps .page/.spread at 'position: relative; z-index: auto'
        precisely so they are not stacking contexts.
-     - a clipping ancestor (overflow other than visible), the same mechanism
-       that clips a .gp-bleed plate back to the wrapper's width.
+     - a clipping ancestor (overflow other than visible) — but only where
+       the art actually overhangs that ancestor's clip box on a clipped
+       axis: the overhang is cut off, the same mechanism that clips a
+       .gp-bleed plate back to the wrapper's width. Clipping never reorders
+       layers — within-bounds art under a clipping .page prints whole and
+       still behind (measured; see the build audit's comment in
+       engine/compiler/build.ts), and a static wrapper's overflow never
+       binds an abspos .gp-pin at all.
    The build-time engine.layer.trapped audit reports both against the live
    ancestor chain. printsafe/page-containment is only an early source hint for
    declarations written directly on .page/.spread. */
@@ -3873,7 +3950,7 @@ import git from "isomorphic-git";
 // package.json
 var package_default = {
   name: "gutterpress",
-  version: "0.10.0-alpha.3",
+  version: "0.10.0-beta.1",
   description: "Markdown-to-PDF converter for professional print layout using a native Chromium print engine and Ghostscript.",
   author: "itlackey",
   license: "MPL-2.0",
@@ -4325,17 +4402,6 @@ import { readFile as readFile8 } from "node:fs/promises";
 
 // src/lib/printsafe.ts
 import postcss2 from "postcss";
-
-// src/engine/shared/margin-box-support.ts
-var MARGIN_BOX_IGNORED_PROPERTIES = new Set([
-  "transform",
-  "rotate",
-  "translate",
-  "scale",
-  "box-shadow"
-]);
-
-// src/lib/printsafe.ts
 var ruleRemoteUrls = "printsafe/no-remote-urls";
 var ruleRiskyProps = "printsafe/no-risky-print-effects";
 var ruleSyntax = "printsafe/syntax-error";
@@ -7827,11 +7893,12 @@ class PdfOutput {
       const rawPdf = pdfxMode ? path7.join(stage, "raw.pdf") : path7.resolve(pdfFile);
       await fsp2.mkdir(path7.dirname(path7.resolve(pdfFile)), { recursive: true });
       log.info("Rendering HTML to PDF via the Gutterpress engine (native Chromium pagination)");
-      const { buildNativePdf } = await import("./engine-q5skhgms.js");
+      const { buildNativePdf } = await import("./engine-nbfdy0pp.js");
       const engineDiagnostics = await buildNativePdf(htmlFile, rawPdf, {
         title: config.title,
         author: config.authors.length > 0 ? config.authors.join(", ") : undefined,
-        signature: config.print.signature
+        signature: config.print.signature,
+        allowShrink: opts.allowShrink
       }, opts.engineBrowser);
       for (const d of engineDiagnostics)
         log.warn(d.message);

package/dist/{index-mvehxh0e.js → index-c2b6gyeg.js}

@@ -596,7 +596,7 @@ var favicon_default = "./favicon-wkbm9cjn.ico";
 var manifest_schema_default = "./manifest.schema-zxgxnbg7.json";
 
 // src/assets/preview/scripts/preview-interface.js
-var preview_interface_default = "./preview-interface-fnqb2y4v.js";
+var preview_interface_default = "./preview-interface-hg5eqv88.js";
 
 // src/assets/preview/scripts/preview-bridge.js
 var preview_bridge_default = "./preview-bridge-fz7vpk8m.js";
@@ -608,10 +608,10 @@ var preview_shell_default = "./preview-shell-c5mfa3q0.js";
 var CGATS21_CRPC1_default = "./CGATS21_CRPC1-g0e3k7kr.icc";
 
 // src/assets/engine/gutterpress-viewer.js
-var gutterpress_viewer_default = "./gutterpress-viewer-cem7dmr5.js";
+var gutterpress_viewer_default = "./gutterpress-viewer-fb6fhwsy.js";
 
 // src/assets/engine/gutterpress-agent.js
-var gutterpress_agent_default = "./gutterpress-agent-1ctgfz92.js";
+var gutterpress_agent_default = "./gutterpress-agent-cazqstr1.js";
 
 // src/assets/templates/book/manifest.yaml
 var manifest_default = "./manifest-n1gh3qw5.yaml";
@@ -705,4 +705,47 @@ async function getAssetPath(relPath) {
   return join3(root, relPath);
 }
 
-export { EXIT_CODES, BuildError, run, spawnCapture, execCapture, isToolAvailable, findTool, INSTALL_HINTS, fullInstallHint, resolveChromiumExecutable, requireChromiumExecutable, RENDER_TIMEOUT_MS, prewarmBrowser, getBrowser, closeBrowser, getAssetPath, REQUIRED_MILESTONE, assertMilestone, readyProbeExpr, DEFAULT_PRINT_OPTS, launchChromium, connectChromium };
+// src/engine/shared/margin-box-support.ts
+var MARGIN_BOX_IGNORED_PROPERTIES = new Set([
+  "transform",
+  "rotate",
+  "translate",
+  "scale",
+  "box-shadow"
+]);
+function isIgnoredMarginBoxProperty(property) {
+  return MARGIN_BOX_IGNORED_PROPERTIES.has(property.toLowerCase());
+}
+function marginBoxRectPt(name, g) {
+  const { top, right, bottom, left } = g.margin;
+  const cw = g.width - left - right;
+  const ch = g.height - top - bottom;
+  const third = (n) => n / 3;
+  const T = {
+    "top-left-corner": [0, 0, left, top],
+    "top-left": [left, 0, third(cw), top],
+    "top-center": [left + third(cw), 0, third(cw), top],
+    "top-right": [left + 2 * third(cw), 0, third(cw), top],
+    "top-right-corner": [g.width - right, 0, right, top],
+    "bottom-left-corner": [0, g.height - bottom, left, bottom],
+    "bottom-left": [left, g.height - bottom, third(cw), bottom],
+    "bottom-center": [left + third(cw), g.height - bottom, third(cw), bottom],
+    "bottom-right": [left + 2 * third(cw), g.height - bottom, third(cw), bottom],
+    "bottom-right-corner": [g.width - right, g.height - bottom, right, bottom],
+    "left-top": [0, top, left, third(ch)],
+    "left-middle": [0, top + third(ch), left, third(ch)],
+    "left-bottom": [0, top + 2 * third(ch), left, third(ch)],
+    "right-top": [g.width - right, top, right, third(ch)],
+    "right-middle": [g.width - right, top + third(ch), right, third(ch)],
+    "right-bottom": [g.width - right, top + 2 * third(ch), right, third(ch)]
+  };
+  const [x, y, w, h] = T[name] ?? [0, 0, 0, 0];
+  return { x, y, w, h };
+}
+function marginBoxAlign(name) {
+  if (name.includes("center") || name.includes("middle"))
+    return "center";
+  return /right/.test(name) ? "end" : "start";
+}
+
+export { EXIT_CODES, BuildError, run, spawnCapture, execCapture, isToolAvailable, findTool, INSTALL_HINTS, fullInstallHint, resolveChromiumExecutable, requireChromiumExecutable, RENDER_TIMEOUT_MS, prewarmBrowser, getBrowser, closeBrowser, getAssetPath, MARGIN_BOX_IGNORED_PROPERTIES, isIgnoredMarginBoxProperty, marginBoxRectPt, marginBoxAlign, REQUIRED_MILESTONE, assertMilestone, readyProbeExpr, DEFAULT_PRINT_OPTS, launchChromium, connectChromium };