gutterpress 0.11.23-beta.1 → 0.11.23-beta.2

package/dist/cli.js

@@ -8,7 +8,7 @@ import {
 } from "./cli-d8xjns66.js";
 import {
   package_default
-} from "./cli-s1zt779w.js";
+} from "./cli-x7gcdg6w.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-jtk028rf.js").then((m) => m.default),
-  preview: () => import("./preview-d1j1g4qf.js").then((m) => m.default),
-  build: () => import("./build-dg8a566j.js").then((m) => m.default),
-  publish: () => import("./publish-7yw4jyrt.js").then((m) => m.default),
-  validate: () => import("./validate-rkcdnzhw.js").then((m) => m.default),
-  preflight: () => import("./preflight-cs6mj1d6.js").then((m) => m.default),
-  doctor: () => import("./doctor-g4a42tcz.js").then((m) => m.default),
-  ext: () => import("./ext-w9d5ftcg.js").then((m) => m.default)
+  new: () => import("./new-d61n5cn0.js").then((m) => m.default),
+  preview: () => import("./preview-h815jrfb.js").then((m) => m.default),
+  build: () => import("./build-3e18wnqj.js").then((m) => m.default),
+  publish: () => import("./publish-ft39zgma.js").then((m) => m.default),
+  validate: () => import("./validate-b201dbrb.js").then((m) => m.default),
+  preflight: () => import("./preflight-fjayhjr5.js").then((m) => m.default),
+  doctor: () => import("./doctor-2f4s9dyn.js").then((m) => m.default),
+  ext: () => import("./ext-70gv86v5.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-jtk028rf.js");
+      const { newArgs } = await import("./new-d61n5cn0.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-cs6mj1d6.js");
+      const { preflightArgs } = await import("./preflight-fjayhjr5.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-w9d5ftcg.js");
+      const { EXT_SUBCOMMANDS, extAddArgs, extRemoveArgs, extEnableArgs, extDisableArgs } = await import("./ext-70gv86v5.js");
       if (!EXT_SUBCOMMANDS.includes(subcommand)) {
         throw new UsageError(`gutterpress ext: unknown command "${subcommand}"`);
       }

package/dist/{doctor-g4a42tcz.js → doctor-2f4s9dyn.js}

@@ -1,17 +1,17 @@
 import {
   getSystemDiagnostics
-} from "./cli-vhav8g82.js";
+} from "./cli-0ep11b0q.js";
 import"./cli-5crpmz42.js";
 import"./cli-asap4t1z.js";
 import {
   log
-} from "./cli-1fy1pm9d.js";
+} from "./cli-9n9kg58f.js";
 import {
   UsageError,
   rejectExtraPositionals,
   rejectUnknownFlags
 } from "./cli-d8xjns66.js";
-import"./cli-s1zt779w.js";
+import"./cli-x7gcdg6w.js";
 import"./cli-46ycxe6r.js";
 import"./cli-37x76zdn.js";
 

package/dist/engine/compiler/postprocess.d.ts

@@ -27,5 +27,8 @@ export interface PostprocessResult {
         bleed: number[];
         trim: number[];
     };
+    /** The scale Chromium printed at, read before anything here draws:
+     * `printScale` in shared/pdf-inspect.ts (1 = not shrunk). */
+    scale: number | null;
 }
 export declare function postprocess(input: Uint8Array, opts: PostprocessOptions): Promise<PostprocessResult>;

package/dist/engine/shared/pdf-inspect.d.ts

@@ -1,3 +1,16 @@
+/**
+ * Read-side PDF utilities (pdf-lib, pure JS).
+ *
+ * Three jobs:
+ *  1. Verification: page count, page boxes, embedded fonts — the evidence the
+ *     tests assert on.
+ *  2. Tier 3 measurement channel (§8): harvest Chromium's own link annotations
+ *     and document outline to learn "which page is element X on", with no text
+ *     heuristics.
+ *  3. The print scale: whether Chromium's shrink-to-fit scaled the page area
+ *     ({@link printScale}).
+ */
+import { PDFDocument } from "pdf-lib";
 export interface PageBoxes {
     media: number[];
     crop?: number[];
@@ -18,3 +31,23 @@ export interface PdfFacts {
     }>;
 }
 export declare function inspectPdf(bytes: Uint8Array): Promise<PdfFacts>;
+/**
+ * The scale Chromium printed the page area at: 1 when it laid the document
+ * out at the page content box's own width, below 1 when print shrink-to-fit
+ * scaled the whole document down because something reached past that box
+ * (ENGINE.md §9). `null` when no page shows the transform — a reader that
+ * cannot find it makes no claim. Pass Chromium's own print, before anything
+ * redraws its pages.
+ *
+ * Read off the content streams rather than predicted from element widths.
+ * Each page draws its page box (background, margin boxes) under an unscaled
+ * `3.125 0 0 3.125 0 0 cm` — CSS px to 300-per-inch device units — then clips
+ * to the page area, its largest clip, and draws the page area's content
+ * under `s 0 0 s x y cm`, where x is the clip's own left edge and s is 3.125
+ * times the shrink. An element with a CSS transform or its own clip draws
+ * under other matrices, so one page can read wrong; Chromium applies one
+ * factor to the whole document, so the first reading three pages agree on
+ * (or the most common, in a shorter document) is the answer. The prologue
+ * fixes the device resolution: the scale is s × prologue × 96/72.
+ */
+export declare function printScale(doc: PDFDocument): number | null;

package/dist/{engine-jvkcahr1.js → engine-c4pxz79g.js}

@@ -1,6 +1,6 @@
 import {
   build
-} from "./cli-k087gj0p.js";
+} from "./cli-pd2cje5b.js";
 import"./cli-eyyggect.js";
 import"./cli-asap4t1z.js";
 import"./cli-65gy8ask.js";

package/dist/{engine-wgkaqjsc.js → engine-cs5g2ez0.js}

@@ -1,7 +1,7 @@
 import {
   build
-} from "./index-fk2kpf2t.js";
-import"./index-798jt0qc.js";
+} from "./index-2t1gdma7.js";
+import"./index-swfdgn2n.js";
 import {
   BuildError
 } from "./index-tayzfr9c.js";

package/dist/{ext-w9d5ftcg.js → ext-70gv86v5.js}

@@ -2,14 +2,14 @@ import {
   importExtensionFromFile,
   importExtensionFromUrl,
   searchNpmExtensions
-} from "./cli-989eg8jz.js";
-import"./cli-vhav8g82.js";
+} from "./cli-pnrararp.js";
+import"./cli-0ep11b0q.js";
 import"./cli-ht1bcqdd.js";
-import"./cli-k087gj0p.js";
+import"./cli-pd2cje5b.js";
 import"./cli-5crpmz42.js";
 import"./cli-eyyggect.js";
 import"./cli-asap4t1z.js";
-import"./cli-31anr0r9.js";
+import"./cli-v0evdpdf.js";
 import"./cli-v5mp7a6q.js";
 import {
   addExtension,
@@ -18,12 +18,12 @@ import {
   removeExtension,
   setExtensionEnabled,
   updateExtensions
-} from "./cli-e31jshz6.js";
+} from "./cli-88arpdke.js";
 import {
   isPathSpecifier,
   parseExtensionSpecifier
-} from "./cli-ttj95aex.js";
-import"./cli-1fy1pm9d.js";
+} from "./cli-tgnyvra3.js";
+import"./cli-9n9kg58f.js";
 import {
   UsageError,
   exitForUsage,
@@ -31,7 +31,7 @@ import {
   rejectUnknownFlags,
   resolveProjectDir
 } from "./cli-d8xjns66.js";
-import"./cli-s1zt779w.js";
+import"./cli-x7gcdg6w.js";
 import"./cli-65gy8ask.js";
 import {
   EXIT_CODES

package/dist/{extension-restore-5x4mj79d.js → extension-restore-chj5nx3t.js}

@@ -3,8 +3,8 @@ import {
   restoreForCommand,
   restoreOfflineMessage,
   restorePinnedExtensions
-} from "./index-rj5vrhz6.js";
-import"./index-a4j3xcfp.js";
+} from "./index-ytjkvwy5.js";
+import"./index-80vg3ed6.js";
 import"./index-tayzfr9c.js";
 import"./index-5x42amh8.js";
 import"./index-37x76zdn.js";

package/dist/{extension-restore-as0g38p1.js → extension-restore-pd87p8r2.js}

@@ -3,11 +3,11 @@ import {
   restoreForCommand,
   restoreOfflineMessage,
   restorePinnedExtensions
-} from "./cli-e31jshz6.js";
-import"./cli-ttj95aex.js";
-import"./cli-1fy1pm9d.js";
+} from "./cli-88arpdke.js";
+import"./cli-tgnyvra3.js";
+import"./cli-9n9kg58f.js";
 import"./cli-d8xjns66.js";
-import"./cli-s1zt779w.js";
+import"./cli-x7gcdg6w.js";
 import"./cli-65gy8ask.js";
 import"./cli-46ycxe6r.js";
 import"./cli-y28j019d.js";

package/dist/{gutterpress-agent-d29ry3ak.js → gutterpress-agent-wyryqehx.js}

@@ -59,6 +59,7 @@
   });
 
   // src/engine/shared/synthesis.ts
+  var RECTO_VERSO_VALUES = /^(right|recto|left|verso)$/;
   var WHICH_VALUES = new Set(["first", "start", "last", "first-except"]);
   var LEADER_RE = /\uE000([^\uE001]*)\uE001/;
   function leaderFillCount(gapPx, gluePx) {
@@ -422,7 +423,8 @@
     return out;
   }
   function forcedBreakSites(decls) {
-    const out = [];
+    const found = [];
+    const seen = new Set;
     for (const d of decls) {
       let els = [];
       try {
@@ -430,10 +432,17 @@
       } catch {
         continue;
       }
-      for (const el of els)
-        out.push({ id: ensureAnchor(el), prop: d.prop, value: d.value, selector: d.selector });
+      for (const el of els) {
+        const id = ensureAnchor(el);
+        const value = getComputedStyle(el).breakBefore;
+        if (seen.has(el) || !RECTO_VERSO_VALUES.test(value))
+          continue;
+        seen.add(el);
+        found.push({ el, id, prop: d.prop, value, selector: d.selector });
+      }
     }
-    return out;
+    found.sort((a, b) => a.el.compareDocumentPosition(b.el) & Node.DOCUMENT_POSITION_FOLLOWING ? -1 : 1);
+    return found.map(({ el: _el, ...site }) => site);
   }
   function counterResetSites(resets) {
     const out = [];

package/dist/{gutterpress-viewer-ze691rrd.js → gutterpress-viewer-ywkf49q5.js}

@@ -40,7 +40,6 @@
     fragmentDocument: () => fragmentDocument,
     cssZoomOf: () => cssZoomOf,
     contentEdgeRect: () => contentEdgeRect,
-    compensateRepeatedHeaders: () => compensateRepeatedHeaders,
     compensateRectoBreaks: () => compensateRectoBreaks,
     columnReserve: () => columnReserve,
     collectCssText: () => collectCssText,
@@ -193,6 +192,29 @@
    no extractable body text; \`rabbit-walking.png\` (1379x2530, unique) sits on
    PDF p134 vs viewer folio 135. */
 
+/* Repeated table headers and footers. Print draws a table's header group
+   (\`thead\`) at the top of every page the table spans, and its footer group
+   (\`tfoot\`) at the foot of each, and never leaves a header alone at the foot
+   of a page. Chromium does the same in a multicol column, through the same
+   table fragmentation, when the group is unbreakable; print media treats
+   every header and footer group so, the screen only one that is
+   \`break-inside: avoid\` (measured: on screen, a plain \`thead\` printed once and
+   a \`break-inside: avoid\` one on every column, exactly as print media does).
+   Setting it here makes the columns repeat the groups print repeats, where
+   print repeats them, and break around them as print does. A group the author
+   set to another \`display\` is not a header group and repeats in neither.
+
+   The viewer used to imitate this in script, cloning the header into each
+   continuation column and forcing a break before a table whose header would
+   be left alone. It moved a lead-in paragraph whole where print splits it,
+   left a clone at a column's foot, drew a second header wherever Chromium
+   already drew one, and shifted pages after the forced-break spacers had been
+   placed, losing a chapter's break (the gp-dimm-city design guide's reference
+   tables: #454). docs/fixtures/repeated-table-header pins it. */
+.gp-strip :is(thead, tfoot) {
+  break-inside: avoid;
+}
+
 /* View mode (\`applySpreadMode\` in fragment.ts): wraps this run's multicol
    columns into \`--gp-wrap-cols\` ROWS instead of one long row — 2 for
    two-up/spread, 1 for single (a plain vertical stack of pages), using
@@ -1482,10 +1504,13 @@
   function clearLeadingForcedBreaks(strip) {
     for (let el = strip.firstElementChild;el; el = el.firstElementChild) {
       const cs = getComputedStyle(el);
-      if (FORCED_BREAK.test(cs.breakBefore))
-        el.style.breakBefore = "auto";
+      if (!FORCED_BREAK.test(cs.breakBefore))
+        continue;
+      clearedLeadingBreaks.set(el, cs.breakBefore);
+      el.style.breakBefore = "auto";
     }
   }
+  var clearedLeadingBreaks = new WeakMap;
   function stabilizeFullHeightPageRoots(model, strips) {
     let stabilized = 0;
     for (const strip of strips) {
@@ -1688,148 +1713,6 @@
       clearLeadingForcedBreaks(s.el);
     return strips;
   }
-  var AVOID_BREAK = /^avoid(-page|-column)?$/;
-  function keepChainHead(el) {
-    let head = el;
-    for (let prev = head.previousElementSibling;prev instanceof HTMLElement; prev = head.previousElementSibling) {
-      const linked = AVOID_BREAK.test(getComputedStyle(prev).breakAfter) || AVOID_BREAK.test(getComputedStyle(head).breakBefore);
-      if (!linked)
-        break;
-      head = prev;
-    }
-    return head;
-  }
-  var pushTargets = new WeakMap;
-  function repeatingHead(table) {
-    const head = table.tHead;
-    return head && getComputedStyle(head).display === "table-header-group" ? head : null;
-  }
-  function repeatingFoot(table) {
-    const foot = table.tFoot;
-    return foot && getComputedStyle(foot).display === "table-footer-group" ? foot : null;
-  }
-  function compensateRepeatedHeaders(strips, maxPasses = 24) {
-    const warnings = [];
-    let passes = 0;
-    let touched = 0;
-    for (const strip of strips) {
-      const tables = Array.from(strip.el.querySelectorAll("table")).filter((t) => repeatingHead(t) || repeatingFoot(t));
-      if (!tables.length)
-        continue;
-      for (const table of tables) {
-        for (const shim of Array.from(table.querySelectorAll("tr.gp-thead-shim, tr.gp-tfoot-shim")))
-          shim.remove();
-        table.style.breakBefore = "";
-        const target = pushTargets.get(table);
-        if (target)
-          target.style.breakBefore = "";
-        pushTargets.delete(table);
-      }
-      const pushed = new Set;
-      const footClaims = new Map;
-      let previous = "";
-      for (let pass = 0;pass < maxPasses; pass++) {
-        passes = Math.max(passes, pass + 1);
-        const { stride, height: colBottom } = stripMetrics(strip.el);
-        const stripLeft = strip.el.getBoundingClientRect().left - strip.el.scrollLeft;
-        const zoom = cssZoomOf(strip.el);
-        const colOf = (r) => Math.floor(((r.left - stripLeft) / zoom + 1) / stride);
-        const stripTop = strip.el.getBoundingClientRect().top;
-        const plans = [];
-        for (const table of tables) {
-          const head = repeatingHead(table);
-          const headRect = head?.getClientRects()[0];
-          const footHeight = (repeatingFoot(table)?.getBoundingClientRect().height ?? 0) / zoom;
-          const rows = Array.from(table.querySelectorAll("tbody > tr")).filter((r) => !r.classList.contains("gp-thead-shim") && !r.classList.contains("gp-tfoot-shim"));
-          if (!rows.length)
-            continue;
-          const rects = rows.map((r) => r.getClientRects()[0] ?? r.getBoundingClientRect());
-          const cols = rects.map(colOf);
-          const claims = footClaims.get(table) ?? new Map;
-          footClaims.set(table, claims);
-          let newClaim;
-          if (footHeight > 0) {
-            const lastCol = cols[cols.length - 1];
-            for (let i = 0;i < rows.length; i++) {
-              const row = rows[i];
-              if (cols[i] === lastCol || claims.has(row))
-                continue;
-              const bottom = (rects[i].bottom - stripTop) / zoom;
-              if (bottom > colBottom - footHeight + 0.5) {
-                newClaim = row;
-                claims.set(row, colBottom - (rects[i].top - stripTop) / zoom);
-                break;
-              }
-            }
-          }
-          plans.push({
-            table,
-            push: headRect ? colOf(headRect) < cols[0] : false,
-            headHeight: (headRect?.height ?? 0) / zoom,
-            footHeight,
-            breakRows: headRect ? rows.filter((_, i) => i > 0 && cols[i] > cols[i - 1]) : [],
-            footRows: [...claims.entries()],
-            grew: newClaim !== undefined,
-            cells: Math.max(1, ...rows.map((r) => r.cells.length))
-          });
-        }
-        const signature = plans.map((p) => `${p.push || pushed.has(p.table) ? "P" : ""}${p.breakRows.map((r) => r.rowIndex).join(".")}~${p.footRows.map(([r]) => r.rowIndex).join(".")}`).join("|");
-        const anyGrowth = plans.some((p) => p.grew);
-        if (!anyGrowth && signature === previous)
-          break;
-        previous = signature;
-        for (const plan of plans) {
-          for (const shim of Array.from(plan.table.querySelectorAll("tr.gp-thead-shim, tr.gp-tfoot-shim")))
-            shim.remove();
-          if (plan.push && !pushed.has(plan.table)) {
-            pushed.add(plan.table);
-            const target = keepChainHead(plan.table);
-            target.style.breakBefore = "column";
-            pushTargets.set(plan.table, target);
-            touched++;
-            continue;
-          }
-          for (const row of plan.breakRows) {
-            row.before(headerShim(plan.table.tHead, plan.headHeight, plan.cells));
-            touched++;
-          }
-          for (const [row, height] of plan.footRows) {
-            row.before(sectionShim(plan.table.tFoot, height, plan.cells, "gp-tfoot-shim"));
-            touched++;
-          }
-        }
-      }
-    }
-    return { tables: touched, passes, warnings };
-  }
-  function headerShim(head, height, cells) {
-    return sectionShim(head, height, cells, "gp-thead-shim");
-  }
-  function sectionShim(section, height, cells, className) {
-    const shim = document.createElement("tr");
-    shim.className = className;
-    shim.setAttribute("aria-hidden", "true");
-    shim.style.height = `${height}px`;
-    if (className === "gp-tfoot-shim")
-      shim.style.verticalAlign = "bottom";
-    const source = section.rows[0];
-    if (source) {
-      for (const cell of Array.from(source.cells)) {
-        const td = document.createElement("td");
-        td.colSpan = cell.colSpan;
-        td.innerHTML = cell.innerHTML;
-        const cs = getComputedStyle(cell);
-        td.style.cssText = `font:${cs.font};color:${cs.color};letter-spacing:${cs.letterSpacing};text-transform:${cs.textTransform};vertical-align:${cs.verticalAlign};text-align:${cs.textAlign};padding:${cs.padding};border:${cs.border};background:${cs.backgroundColor};`;
-        shim.appendChild(td);
-      }
-    } else {
-      const td = document.createElement("td");
-      td.colSpan = cells;
-      td.style.cssText = `height:${height}px;padding:0;border:0;`;
-      shim.appendChild(td);
-    }
-    return shim;
-  }
   function compensateRectoBreaks(model, strips) {
     const decls2 = model.breaks.filter(isRectoVersoBreak);
     for (const spacer of Array.from(document.querySelectorAll(".gp-recto-spacer")))
@@ -1837,6 +1720,7 @@
     if (!decls2.length)
       return 0;
     const sites = [];
+    const seen = new Set;
     for (const d of decls2) {
       let els = [];
       try {
@@ -1844,8 +1728,13 @@
       } catch {
         continue;
       }
-      for (const el of els)
-        sites.push({ el, wantsRecto: wantsRecto(d.value) });
+      for (const el of els) {
+        const value = clearedLeadingBreaks.get(el) ?? getComputedStyle(el).breakBefore;
+        if (seen.has(el) || !RECTO_VERSO_VALUES.test(value))
+          continue;
+        seen.add(el);
+        sites.push({ el, wantsRecto: wantsRecto(value) });
+      }
     }
     sites.sort((a, b) => a.el.compareDocumentPosition(b.el) & Node.DOCUMENT_POSITION_FOLLOWING ? -1 : 1);
     const plan = planRectoBlanks(sites.map((site) => ({ page: pageOf(site.el, strips) + 1, wantsRecto: site.wantsRecto })));
@@ -2043,7 +1932,6 @@
     const blanks = compensateRectoBreaks(model, strips);
     if (blanks)
       measure(strips);
-    const headers = opts.compensateHeaders === false ? { tables: 0, passes: 0, warnings: [] } : compensateRepeatedHeaders(strips);
     const contentPages = measure(strips).totalPages;
     const totalPages = padToSignature(strips, contentPages);
     fitVersoPinRoots(model, strips);
@@ -2051,7 +1939,7 @@
       model,
       strips,
       totalPages,
-      warnings: [...new Set([...authoring, ...headers.warnings])],
+      warnings: [...new Set(authoring)],
       blankPages: blanks,
       blankPageIndices: blankPageIndices(strips),
       paddedPageIndices: pagesAfter(contentPages, totalPages),
@@ -2072,10 +1960,7 @@
         synthesizeColumnBreaks(model);
         measure(strips);
         api.blankPages = compensateRectoBreaks(model, strips);
-        if (opts.compensateHeaders !== false)
-          api.warnings = [
-            ...new Set([...authoring, ...compensateRepeatedHeaders(strips).warnings])
-          ];
+        api.warnings = [...new Set(authoring)];
         const content = measure(strips).totalPages;
         padToSignature(strips, content);
         const r = measure(strips);