gutterpress 0.11.20-alpha.3 → 0.11.20-alpha.4

package/dist/{gutterpress-viewer-1yse8cx3.js → gutterpress-viewer-jr30yw8t.js}

@@ -1038,10 +1038,12 @@
 `);
   }
 
-  // src/engine/shared/flush.ts
-  var FLUSH_EDGES = ["top", "right", "bottom", "left"];
-  function flushEdgesIn(root) {
-    return FLUSH_EDGES.filter((edge) => root.querySelector(`.gp-pin.gp-flush.gp-${edge}`));
+  // src/engine/shared/pin-edges.ts
+  var PIN_EDGES = ["top", "right", "bottom", "left"];
+  var EDGE_PIN_SELECTOR = PIN_EDGES.map((edge) => `.gp-pin.gp-${edge}`).join(", ");
+  function pinEdgesIn(root) {
+    const pins = Array.from(root.querySelectorAll(EDGE_PIN_SELECTOR)).filter((pin) => pin.offsetParent === root);
+    return PIN_EDGES.filter((edge) => pins.some((pin) => pin.classList.contains(`gp-${edge}`)));
   }
   function flushMargins(margin, edges) {
     return {
@@ -1051,6 +1053,57 @@
       left: edges.includes("left") ? 0 : margin.left
     };
   }
+  function pinInsets(area, side, edges) {
+    const binding = side === "recto" ? "left" : "right";
+    const inset = (edge) => !area || !edges.includes(edge) ? 0 : edge === binding ? area.safe : area.bleed + area.artSafe;
+    return { top: inset("top"), right: inset("right"), bottom: inset("bottom"), left: inset("left") };
+  }
+  var NO_PADDING = { top: 0, right: 0, bottom: 0, left: 0 };
+  function pinRootStyle(margin, area, side, edges, padding = NO_PADDING) {
+    const px = (pt) => pt * 96 / 72;
+    const inset = pinInsets(area, side, edges);
+    const style = { "box-decoration-break": "clone" };
+    for (const edge of PIN_EDGES)
+      if (edges.includes(edge))
+        style[`padding-${edge}`] = `${px(margin[edge]) + padding[edge]}px`;
+    for (const edge of PIN_EDGES)
+      style[`--gp-pin-${edge}`] = `${px(inset[edge])}px`;
+    return style;
+  }
+  function paddingOf(cs) {
+    return {
+      top: parseFloat(cs.paddingTop) || 0,
+      right: parseFloat(cs.paddingRight) || 0,
+      bottom: parseFloat(cs.paddingBottom) || 0,
+      left: parseFloat(cs.paddingLeft) || 0
+    };
+  }
+
+  // src/engine/shared/print-area.ts
+  function printAreaFromMeta(doc) {
+    const raw = doc.querySelector('meta[name="gp-print-area"]')?.getAttribute("content");
+    if (!raw)
+      return null;
+    try {
+      const v = JSON.parse(raw);
+      const n = (x) => typeof x === "number" && Number.isFinite(x) && x > 0 ? x : 0;
+      if (!n(v.width) || !n(v.height))
+        return null;
+      const safe = n(v.safe);
+      const spec = v.spec && typeof v.spec.label === "string" && typeof v.spec.url === "string" && /^https?:\/\//i.test(v.spec.url) ? v.spec : undefined;
+      return {
+        width: n(v.width),
+        height: n(v.height),
+        bleed: n(v.bleed),
+        safe,
+        artSafe: typeof v.artSafe === "number" ? n(v.artSafe) : safe,
+        preset: typeof v.preset === "string" ? v.preset : undefined,
+        spec
+      };
+    } catch {
+      return null;
+    }
+  }
 
   // src/engine/viewer/fragment.ts
   var PX_PER_PT = 96 / 72;
@@ -1210,13 +1263,29 @@
     }
     return false;
   }
-  function pushRun(runs, page, nodes, flushEdges) {
-    const key = (r) => `${r.page ?? ""}\x00${(r.flushEdges ?? []).join(",")}`;
+  function pushRun(runs, page, nodes, pin) {
+    const key = (r) => `${r.page ?? ""}\x00${(r.pin?.edges ?? []).join(",")}`;
     const last = runs[runs.length - 1];
-    if (last && key(last) === key({ page, flushEdges }))
+    if (last && key(last) === key({ page, pin })) {
       last.nodes.push(...nodes);
-    else
-      runs.push({ page, nodes, flushEdges: flushEdges?.length ? flushEdges : undefined });
+      if (pin)
+        last.pin.roots.push(...pin.roots);
+    } else
+      runs.push({ page, nodes, pin: pin && { edges: pin.edges, roots: [...pin.roots] } });
+  }
+  var PAGE_ROOT = ".page, .spread";
+  var ownPadding = new WeakMap;
+  function pinRunOf(el) {
+    if (!el.matches(PAGE_ROOT))
+      return;
+    const edges = pinEdgesIn(el);
+    return edges.length ? { edges, roots: [el] } : undefined;
+  }
+  function holdsPinRoot(el) {
+    return Array.from(el.querySelectorAll(EDGE_PIN_SELECTOR)).some((pin) => {
+      const root = pin.offsetParent;
+      return !!root && root !== el && el.contains(root) && root.matches(PAGE_ROOT);
+    });
   }
   function explodeChildren(container, model) {
     const runs = [];
@@ -1228,7 +1297,7 @@
       pending = [];
       const last = runs[runs.length - 1];
       if (last) {
-        pushRun(runs, last.page, held, last.flushEdges);
+        pushRun(runs, last.page, held, last.pin && { edges: last.pin.edges, roots: [] });
         return [];
       }
       if (held.some((n) => (n.textContent ?? "").trim() !== "")) {
@@ -1245,19 +1314,19 @@
       const kid = node;
       if (kid.classList.contains("gp-layer"))
         continue;
-      const flush = flushEdgesIn(kid);
+      const pin = pinRunOf(kid);
       const own = directPageName(kid, model);
       if (own !== undefined) {
-        pushRun(runs, own, [...carry(), kid], flush);
+        pushRun(runs, own, [...carry(), kid], pin);
         continue;
       }
-      if (!hasDescendantPageAssignment(kid, model)) {
-        pushRun(runs, undefined, [...carry(), kid], flush);
+      if (!hasDescendantPageAssignment(kid, model) && !holdsPinRoot(kid)) {
+        pushRun(runs, undefined, [...carry(), kid], pin);
         continue;
       }
       const inner = explodeChildren(kid, model);
       if (inner.length <= 1) {
-        pushRun(runs, inner[0]?.page, [...carry(), kid]);
+        pushRun(runs, inner[0]?.page, [...carry(), kid], pin ?? inner[0]?.pin);
         continue;
       }
       let lead = carry();
@@ -1266,7 +1335,7 @@
         for (const n of r.nodes)
           shell.appendChild(n);
         kid.before(shell);
-        pushRun(runs, r.page, [...lead, shell], flushEdgesIn(shell));
+        pushRun(runs, r.page, [...lead, shell], pin ? pinRunOf(shell) : r.pin);
         lead = [];
       }
       kid.remove();
@@ -1323,6 +1392,42 @@
       delete el.dataset.gpLeadingPageRootDisplayPriority;
     }
   }
+  function fitVersoPinRoots(model, strips) {
+    const area = printAreaFromMeta(document);
+    const versos = [];
+    for (const strip of strips) {
+      if (!strip.pinEdges || !strip.pinRoots?.length)
+        continue;
+      const edges = strip.pinEdges;
+      const { left, agree } = pageSides(model, strip.page);
+      const verso = agree ? left.margin : strip.geometry.margin;
+      const margin = { ...strip.geometry.margin, left: verso.left, right: verso.right };
+      const shift = pt(strip.versoShift);
+      for (const root of strip.pinRoots) {
+        if (pageOf(root, strips) % 2 !== 1)
+          continue;
+        const style = pinRootStyle(margin, area, "verso", edges, ownPadding.get(root));
+        if (shift && edges.includes("left"))
+          style["margin-left"] = `${shift}px`;
+        if (shift && edges.includes("right"))
+          style["margin-right"] = `${-shift}px`;
+        versos.push({ root, style });
+      }
+    }
+    for (const { root, style } of versos)
+      for (const [prop, value] of Object.entries(style))
+        root.style.setProperty(prop, value);
+  }
+  function restorePinRoots(doc = document) {
+    for (const el of Array.from(doc.querySelectorAll("[data-gp-pin-style]"))) {
+      const style = el.dataset.gpPinStyle;
+      if (style)
+        el.setAttribute("style", style);
+      else
+        el.removeAttribute("style");
+      delete el.dataset.gpPinStyle;
+    }
+  }
   var SCROLLABLE = /^(auto|scroll|hidden)$/;
   function makeOverflowFragmentable(strips) {
     const todo = [];
@@ -1388,21 +1493,16 @@
       agree: Math.abs(r.w - l.w) < 0.01 && Math.abs(r.h - l.h) < 0.01
     };
   }
-  function versoShiftPt(model, name, flushEdges = []) {
+  function versoShiftPt(model, name) {
     const { right, left, agree } = pageSides(model, name);
-    if (!agree)
-      return 0;
-    const r = flushMargins(right.margin, flushEdges);
-    const l = flushMargins(left.margin, flushEdges);
-    if (Math.abs(r.left + r.right - (l.left + l.right)) >= 0.01)
-      return 0;
-    return r.left - l.left;
+    return agree ? right.margin.left - left.margin.left : 0;
   }
   function buildStrips(model, opts = {}, warnings = []) {
     const doc = document;
     const root = opts.root ?? doc.querySelector("main") ?? doc.body;
     const gap = opts.sheetGap ?? 24;
     const runs = explodeChildren(root, model);
+    const area = printAreaFromMeta(doc);
     const strips = [];
     for (const run of runs) {
       const geometry = runPageBox(model, run.page, warnings);
@@ -1410,7 +1510,18 @@
       strip.className = "gp-strip";
       if (run.page)
         strip.dataset.page = run.page;
-      const margin = run.flushEdges?.length ? flushMargins(geometry.margin, run.flushEdges) : geometry.margin;
+      const margin = run.pin ? flushMargins(geometry.margin, run.pin.edges) : geometry.margin;
+      if (run.pin) {
+        const { edges, roots } = run.pin;
+        for (const pinRoot of roots)
+          ownPadding.set(pinRoot, paddingOf(getComputedStyle(pinRoot)));
+        for (const pinRoot of roots) {
+          pinRoot.dataset.gpPinStyle ??= pinRoot.getAttribute("style") ?? "";
+          const recto = pinRootStyle(geometry.margin, area, "recto", edges, ownPadding.get(pinRoot));
+          for (const [prop, value] of Object.entries(recto))
+            pinRoot.style.setProperty(prop, value);
+        }
+      }
       const w = pt(geometry.width - margin.left - margin.right);
       const h = pt(geometry.height - margin.top - margin.bottom);
       strip.style.setProperty("--gp-content-w", `${w}px`);
@@ -1422,7 +1533,7 @@
       strip.style.setProperty("--gp-margin-right", `${pt(margin.right)}px`);
       strip.style.setProperty("--gp-margin-bottom", `${pt(margin.bottom)}px`);
       strip.style.setProperty("--gp-margin-left", `${pt(margin.left)}px`);
-      const rawShift = versoShiftPt(model, run.page, run.flushEdges);
+      const rawShift = versoShiftPt(model, run.page);
       const versoShift = Math.abs(rawShift) >= 0.01 ? rawShift : 0;
       if (versoShift)
         strip.style.setProperty("--gp-verso-shift", `${pt(versoShift)}px`);
@@ -1433,7 +1544,8 @@
         el: strip,
         page: run.page,
         geometry,
-        flushEdges: run.flushEdges,
+        pinEdges: run.pin?.edges,
+        pinRoots: run.pin?.roots,
         versoShift,
         pages: 0,
         offset: 0
@@ -1805,6 +1917,7 @@
     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);
     const api = {
       model,
       strips,
@@ -1818,6 +1931,7 @@
       relayout: () => {
         restoreFullHeightPageRoots();
         restoreScrollContainers();
+        restorePinRoots();
         unwrapStrips(strips);
         for (const spacer of Array.from(document.querySelectorAll(".gp-recto-spacer, .gp-pad-spacer")))
           spacer.remove();
@@ -1836,6 +1950,7 @@
         const content = measure(strips).totalPages;
         padToSignature(strips, content);
         const r = measure(strips);
+        fitVersoPinRoots(model, strips);
         api.totalPages = r.totalPages;
         api.blankPageIndices = blankPageIndices(strips);
         api.paddedPageIndices = pagesAfter(content, r.totalPages);
@@ -2182,30 +2297,6 @@
     artSafePt: 0,
     counts: { text: 0, art: 0, bleed: 0, offPage: 0, intended: 0 }
   };
-  function printAreaFromMeta() {
-    const raw = document.querySelector('meta[name="gp-print-area"]')?.getAttribute("content");
-    if (!raw)
-      return null;
-    try {
-      const v = JSON.parse(raw);
-      const n = (x) => typeof x === "number" && Number.isFinite(x) && x > 0 ? x : 0;
-      if (!n(v.width) || !n(v.height))
-        return null;
-      const safe = n(v.safe);
-      const spec = v.spec && typeof v.spec.label === "string" && typeof v.spec.url === "string" && /^https?:\/\//i.test(v.spec.url) ? v.spec : undefined;
-      return {
-        width: n(v.width),
-        height: n(v.height),
-        bleed: n(v.bleed),
-        safe,
-        artSafe: typeof v.artSafe === "number" ? n(v.artSafe) : safe,
-        preset: typeof v.preset === "string" ? v.preset : undefined,
-        spec
-      };
-    } catch {
-      return null;
-    }
-  }
   function sheetArea(sheet) {
     const px = (name) => parseFloat(sheet.style.getPropertyValue(name)) || 0;
     return { width: px("--gp-page-w") / PX_PER_PT, height: px("--gp-page-h") / PX_PER_PT, bleed: 0, safe: 0, artSafe: 0 };
@@ -2689,7 +2780,7 @@
     let overlayPages = [];
     let overlaySummary = OVERLAY_OFF;
     const paintOverlayNow = () => {
-      overlaySummary = paintOverlay(overlayPages, layout.strips, printAreaFromMeta(), overlayLayers);
+      overlaySummary = paintOverlay(overlayPages, layout.strips, printAreaFromMeta(document), overlayLayers);
       window.dispatchEvent(new CustomEvent("gp:overlay", { detail: overlaySummary }));
     };
     const api = {

package/dist/{index-r87y7wzw.js → index-ad95fws8.js}

@@ -19,7 +19,7 @@ import {
   stringValueAt,
   toFolioPage,
   wantsRecto
-} from "./index-zagagnwq.js";
+} from "./index-gm5xbx5w.js";
 import {
   launchChromium
 } from "./index-bt0qws5c.js";
@@ -29,14 +29,15 @@ import { readFile } from "node:fs/promises";
 import { resolve } from "node:path";
 import { pathToFileURL } from "node:url";
 
-// src/engine/shared/flush.ts
-var FLUSH_EDGES = ["top", "right", "bottom", "left"];
-function flushKey(edges) {
-  return FLUSH_EDGES.filter((e) => edges.includes(e)).map((e) => e[0]).join("");
+// src/engine/shared/pin-edges.ts
+var PIN_EDGES = ["top", "right", "bottom", "left"];
+var EDGE_PIN_SELECTOR = PIN_EDGES.map((edge) => `.gp-pin.gp-${edge}`).join(", ");
+function pinKey(edges) {
+  return PIN_EDGES.filter((e) => edges.includes(e)).map((e) => e[0]).join("");
 }
-function flushPageName(authorPage, edges) {
+function pinPageName(authorPage, edges) {
   const safe = authorPage ? authorPage.replace(/[^A-Za-z0-9_-]/g, "_") : "";
-  return `gp--flush${safe ? `-${safe}` : ""}-${flushKey(edges)}`;
+  return `gp--pin${safe ? `-${safe}` : ""}-${pinKey(edges)}`;
 }
 function flushMargins(margin, edges) {
   return {
@@ -46,6 +47,23 @@ function flushMargins(margin, edges) {
     left: edges.includes("left") ? 0 : margin.left
   };
 }
+function pinInsets(area, side, edges) {
+  const binding = side === "recto" ? "left" : "right";
+  const inset = (edge) => !area || !edges.includes(edge) ? 0 : edge === binding ? area.safe : area.bleed + area.artSafe;
+  return { top: inset("top"), right: inset("right"), bottom: inset("bottom"), left: inset("left") };
+}
+var NO_PADDING = { top: 0, right: 0, bottom: 0, left: 0 };
+function pinRootStyle(margin, area, side, edges, padding = NO_PADDING) {
+  const px = (pt) => pt * 96 / 72;
+  const inset = pinInsets(area, side, edges);
+  const style = { "box-decoration-break": "clone" };
+  for (const edge of PIN_EDGES)
+    if (edges.includes(edge))
+      style[`padding-${edge}`] = `${px(margin[edge]) + padding[edge]}px`;
+  for (const edge of PIN_EDGES)
+    style[`--gp-pin-${edge}`] = `${px(inset[edge])}px`;
+  return style;
+}
 function marginBoxesOnEdges(edges) {
   const owners = {
     "top-left-corner": ["top", "left"],
@@ -723,7 +741,7 @@ var BUILD_DIAGNOSTIC_CODES = [
   "engine.multicol.dead-column",
   "engine.content.overheight",
   "engine.image.low-dpi",
-  "engine.flush.margin-box",
+  "engine.pin.margin-box",
   "engine.page-background.unreferenced",
   "engine.hyphenation.unsupported"
 ];
@@ -756,25 +774,31 @@ async function build(opts) {
     await page.send("Emulation.setDeviceMetricsOverride", sheetViewport);
     await page.send("Emulation.setEmulatedMedia", { media: "print" });
     log(`print media emulated for audits and measurement`);
-    const flushRoots = await page.evaluate(`window.__gp.flushRoots()`);
-    const flushGroups = new Map;
-    for (const root of flushRoots) {
-      if (flushGroups.has(root.key))
+    const pinRoots = await page.evaluate(`window.__gp.pinRoots()`);
+    const pinGroups = new Map;
+    for (const root of pinRoots) {
+      if (pinGroups.has(root.key))
         continue;
       const authorPage = root.page === "auto" ? undefined : root.page;
-      flushGroups.set(root.key, {
+      pinGroups.set(root.key, {
         authorPage,
         edges: root.edges,
-        genName: flushPageName(authorPage, root.edges),
+        padding: root.padding,
+        genName: pinPageName(authorPage, root.edges),
         key: root.key
       });
     }
-    if (flushGroups.size) {
+    const printArea = pinRoots.length ? await page.evaluate(`window.__gp.printArea()`) : null;
+    const pinStyle = (group, pseudos) => pinRootStyle(resolvePage(model, { name: group.authorPage, pseudos }).geometry.margin, printArea, pseudos.includes("left") ? "verso" : "recto", group.edges, group.padding);
+    if (pinGroups.size) {
       const lines = [];
-      for (const group of flushGroups.values()) {
+      const aliased = new Set;
+      for (const group of pinGroups.values()) {
+        const alias = !aliased.has(group.genName);
+        aliased.add(group.genName);
         const relocated = new Set(marginBoxesOnEdges(group.edges));
         const pseudoSets = [[]];
-        if (group.authorPage) {
+        if (alias && group.authorPage) {
           for (const rule of model.pageRules) {
             if (rule.name !== group.authorPage)
               continue;
@@ -798,7 +822,7 @@ ${body.join(`
 }`);
           }
         }
-        for (const pseudos of pseudoSets) {
+        for (const pseudos of alias ? pseudoSets : []) {
           const pseudo = pseudos.length ? `:${pseudos.join(":")}` : "";
           const body = [];
           for (const edge of group.edges)
@@ -810,14 +834,15 @@ ${body.join(`
 `)}
 }`);
         }
-        lines.push(`:where(.page, .spread)[data-gp-flush="${group.key}"][data-gp-flush][data-gp-flush][data-gp-flush] { page: ${group.genName}; }`);
+        const recto = Object.entries(pinStyle(group, ["right"])).map(([prop, value]) => ` ${prop}: ${value};`).join("");
+        lines.push(`:where(.page, .spread)[data-gp-pin="${group.key}"][data-gp-pin][data-gp-pin][data-gp-pin] { page: ${group.genName};${recto} }`);
       }
-      const flushCss = lines.join(`
+      const pinCss = lines.join(`
 `);
-      await page.evaluate(`window.__gp.addCss("gp-flush-css", ${JSON.stringify(flushCss)})`);
+      await page.evaluate(`window.__gp.addCss("gp-pin-css", ${JSON.stringify(pinCss)})`);
       model = extract(`${cssText}
-${flushCss}`);
-      log(`.gp-flush: ${flushRoots.length} pinned root(s) -> ${flushGroups.size} generated page context(s)`);
+${pinCss}`);
+      log(`pinned art: ${pinRoots.length} page root(s) -> ${pinGroups.size} generated page context(s)`);
     }
     const { tier3Reasons } = classify(model);
     const pseudoContexts = pagePseudoContexts(model);
@@ -842,11 +867,16 @@ ${flushCss}`);
         return !!c && c !== "none" && c !== "normal";
       });
     };
-    const furnitureRoots = flushRoots.filter((root) => {
-      const group = flushGroups.get(root.key);
+    const furnitureRoots = pinRoots.filter((root) => {
+      const group = pinGroups.get(root.key);
       return pseudoContexts.some((pseudos) => relocationBoxes(group, pseudos).length > 0);
     });
-    const flushDiagnosed = new Set;
+    const relocationDiagnosed = new Set;
+    const sideRoots = pinRoots.filter((root) => {
+      const group = pinGroups.get(root.key);
+      const recto = JSON.stringify(pinStyle(group, ["right"]));
+      return [["left"], ["right", "first"]].some((pseudos) => JSON.stringify(pinStyle(group, pseudos)) !== recto);
+    });
     const tier2 = synthesize({
       model,
       marks: opts.marks,
@@ -890,7 +920,7 @@ ${describe(widthOffenders.intrinsics)}`;
       log(`WARNING: ${msg}`);
     }
     const rectoDecls = model.breaks.filter(isRectoVersoBreak);
-    const needsMeasure = tier3Reasons.length > 0 || consumedStrings(model).size > 0 || rectoDecls.length > 0 || model.counterResets.length > 0 || furnitureRoots.length > 0;
+    const needsMeasure = tier3Reasons.length > 0 || consumedStrings(model).size > 0 || rectoDecls.length > 0 || model.counterResets.length > 0 || furnitureRoots.length > 0 || sideRoots.length > 0;
     let tier = tier2.geometry.bleed > 0 || tier2.geometry.slug > 0 ? 2 : 1;
     let passes = 1;
     let pageMap = {};
@@ -918,7 +948,7 @@ ${describe(widthOffenders.intrinsics)}`;
         targets.add(s.id);
       for (const s of resetSites)
         targets.add(s.id);
-      for (const r of furnitureRoots)
+      for (const r of [...furnitureRoots, ...sideRoots])
         targets.add(r.id);
       await page.evaluate(`window.__gp.instrument(${JSON.stringify([...targets])})`);
       const targetText = await page.evaluate(`window.__gp.targetTexts(${JSON.stringify([...targets])})`);
@@ -1004,8 +1034,12 @@ ${describe(widthOffenders.intrinsics)}`;
 /* Tier 3 */
 ${mapCss}`;
         }
+        const pageAt = (id) => map[id] ?? predictedForResult?.pageMap[id];
+        const pseudosAt = (physical) => [
+          physical % 2 === 1 ? "right" : "left",
+          ...physical === 1 ? ["first"] : []
+        ];
         if (furnitureRoots.length) {
-          const pageAt = (id) => map[id] ?? predictedForResult?.pageMap[id];
           const byName = new Map;
           for (const s of sources) {
             const p = pageAt(s.id);
@@ -1023,10 +1057,8 @@ ${mapCss}`;
             const physical = pageAt(root.id);
             if (!physical)
               continue;
-            const group = flushGroups.get(root.key);
-            const pseudos = [physical % 2 === 1 ? "right" : "left"];
-            if (physical === 1)
-              pseudos.push("first");
+            const group = pinGroups.get(root.key);
+            const pseudos = pseudosAt(physical);
             const ctx = resolvePage(model, { name: group.authorPage, pseudos });
             const g = ctx.geometry;
             const eff = flushMargins(g.margin, group.edges);
@@ -1042,9 +1074,9 @@ ${mapCss}`;
                 }
               });
               if (!text) {
-                if (!flushDiagnosed.has(name)) {
-                  flushDiagnosed.add(name);
-                  diagnose("engine.flush.margin-box", `@${name} sits on an edge a .gp-flush pin frees, and its content could not be ` + `re-homed into the page (unsupported content value: ${decls.content}). It will ` + `not print on that page — simplify the box's content, or drop .gp-flush there.`);
+                if (!relocationDiagnosed.has(name)) {
+                  relocationDiagnosed.add(name);
+                  diagnose("engine.pin.margin-box", `@${name} sits on an edge a pinned image frees, and its content could not be ` + `re-homed into the page (unsupported content value: ${decls.content}). It will ` + `not print on that page — simplify the box's content, or pin the image to another edge.`);
                 }
                 continue;
               }
@@ -1069,7 +1101,17 @@ ${mapCss}`;
             items.push({ id: root.id, boxes });
           }
           if (items.length)
-            await page.evaluate(`window.__gp.setFlushFurniture(${JSON.stringify(items)})`);
+            await page.evaluate(`window.__gp.setPinFurniture(${JSON.stringify(items)})`);
+        }
+        if (sideRoots.length) {
+          const items = sideRoots.flatMap((root) => {
+            const physical = pageAt(root.id);
+            if (!physical)
+              return [];
+            return [{ id: root.id, style: pinStyle(pinGroups.get(root.key), pseudosAt(physical)) }];
+          });
+          if (items.length)
+            await page.evaluate(`window.__gp.setPinGeometry(${JSON.stringify(items)})`);
         }
       };
       const predicted = await predictPageMap(browser, url, AGENT, VIEWER, {
@@ -1432,12 +1474,12 @@ function shrinkScale(boxes, limitPx) {
 async function findWidthOffenders(page, model, bleedSlugExtensionPt, restoreViewport) {
   const contexts = [
     resolvePage(model),
-    ...model.pageNames.filter((n) => !n.startsWith("gp-") || n.startsWith("gp--flush-")).map((n) => resolvePage(model, { name: n }))
+    ...model.pageNames.filter((n) => !n.startsWith("gp-") || n.startsWith("gp--pin-")).map((n) => resolvePage(model, { name: n }))
   ];
   const contentPxOf = (c) => (c.geometry.width - c.geometry.margin.left - c.geometry.margin.right + bleedSlugExtensionPt) * 96 / 72;
   const defaultLimitPx = contentPxOf(contexts[0]);
   const namedLimits = {};
-  model.pageNames.filter((n) => !n.startsWith("gp-") || n.startsWith("gp--flush-")).forEach((n) => {
+  model.pageNames.filter((n) => !n.startsWith("gp-") || n.startsWith("gp--pin-")).forEach((n) => {
     namedLimits[n] = contentPxOf(resolvePage(model, { name: n }));
   });
   const widths = [...new Set([defaultLimitPx, ...Object.values(namedLimits)])].sort((a, b) => a - b);
@@ -1624,7 +1666,7 @@ async function predictPageMap(browser, url, agentScript, viewerScript, args, she
     await page.waitForReady();
     await page.evaluate(`window.__GP_MANUAL__ = true;`);
     await page.evaluate(viewerScript);
-    await page.evaluate(`window.__gp.flushRoots()`);
+    await page.evaluate(`window.__gp.pinRoots()`);
     await page.evaluate(`window.__gp.stringSources(${JSON.stringify(args.stringSets)})`);
     if (args.rectoDecls.length)
       await page.evaluate(`window.__gp.forcedBreakSites(${JSON.stringify(args.rectoDecls)})`);

package/dist/{index-zagagnwq.js → index-gm5xbx5w.js}

@@ -148,7 +148,7 @@ import { fileURLToPath } from "node:url";
 var favicon_default = "./favicon-272ga6y0.ico";
 
 // src/assets/manifest.schema.json
-var manifest_schema_default = "./manifest.schema-c9x8912a.json";
+var manifest_schema_default = "./manifest.schema-13dfax80.json";
 
 // src/assets/preview/scripts/preview-interface.js
 var preview_interface_default = "./preview-interface-nnmrxyqm.js";
@@ -163,10 +163,10 @@ var preview_shell_default = "./preview-shell-wk9k3gcd.js";
 var CGATS21_CRPC1_default = "./CGATS21_CRPC1-g0e3k7kr.icc";
 
 // src/assets/engine/gutterpress-viewer.js
-var gutterpress_viewer_default = "./gutterpress-viewer-1yse8cx3.js";
+var gutterpress_viewer_default = "./gutterpress-viewer-jr30yw8t.js";
 
 // src/assets/engine/gutterpress-agent.js
-var gutterpress_agent_default = "./gutterpress-agent-cazqstr1.js";
+var gutterpress_agent_default = "./gutterpress-agent-mrdnwktc.js";
 
 // src/assets/templates/book/manifest.yaml
 var manifest_default = "./manifest-n1gh3qw5.yaml";