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

package/dist/api/index.js

@@ -137,11 +137,11 @@ import {
   testRemoteAccess,
   updateExtensions,
   validateProjectExtensions
-} from "../index-tjvrchxj.js";
+} from "../index-t13p8y08.js";
 import"../index-ht1bcqdd.js";
 import {
   BuildError
-} from "../index-zagagnwq.js";
+} from "../index-gm5xbx5w.js";
 import"../index-sth219v1.js";
 import {
   DEFAULT_PRINT_OPTS,

package/dist/{build-a8ycsg80.js → build-epdcrm2c.js}

@@ -1,19 +1,19 @@
 import {
   runBuild,
   splitOutPath
-} from "./cli-9k2tb493.js";
+} from "./cli-0ey902sx.js";
 import {
   log
-} from "./cli-y9bcya7r.js";
+} from "./cli-h4tfmpg3.js";
 import {
   UsageError,
   parseFormat,
   parsePdfxFlavor,
   rejectExtraPositionals,
   rejectUnknownFlags
-} from "./cli-hn9pk0hp.js";
+} from "./cli-fmksazej.js";
 import"./cli-ht1bcqdd.js";
-import"./cli-x4p99w8d.js";
+import"./cli-61vd4ews.js";
 import {
   BuildError
 } from "./cli-46ycxe6r.js";

package/dist/{cli-9k2tb493.js → cli-0ey902sx.js}

@@ -16,12 +16,12 @@ import {
   stripAnnotations,
   transparentPages,
   warn
-} from "./cli-y9bcya7r.js";
+} from "./cli-h4tfmpg3.js";
 import {
   DEBOUNCE,
   UsageError,
   resolvePort
-} from "./cli-hn9pk0hp.js";
+} from "./cli-fmksazej.js";
 import {
   blackTextToGray
 } from "./cli-ht1bcqdd.js";
@@ -30,7 +30,7 @@ import {
   getAssetPath,
   getAssetsDir,
   lastPageMode
-} from "./cli-x4p99w8d.js";
+} from "./cli-61vd4ews.js";
 import {
   BuildError,
   EXIT_CODES
@@ -701,6 +701,7 @@ function resolveDeclaredStyles(rawStyles, baseDir, subject) {
 // src/lib/extension-manifest.ts
 import { readFile as readFile2 } from "node:fs/promises";
 import path from "node:path";
+import { satisfies, validRange } from "semver";
 var EXTENSION_MANIFEST_FILENAME = "package.json";
 var GUTTERPRESS_KEY = "gutterpress";
 function object(value) {
@@ -724,6 +725,7 @@ function metaFromPackageJson(raw) {
     ...str(pkg.description) ? { description: str(pkg.description) } : {},
     ...keywords ? { keywords } : {},
     ...str(pkg.main) ? { main: str(pkg.main) } : {},
+    ...str(object(pkg.engines)?.gutterpress) ? { gutterpressRange: str(object(pkg.engines)?.gutterpress) } : {},
     ..."preview" in gp ? { preview: str(gp.preview) ?? null } : {},
     ...Array.isArray(gp.styles) ? { styles: declaredList(gp.styles) } : {},
     ...str(gp.tokensFile) ? { tokensFile: str(gp.tokensFile) } : {},
@@ -760,6 +762,17 @@ function extensionCarries(meta) {
 function pathEscapesFolder(rel) {
   return path.isAbsolute(rel) || rel.split(/[\\/]/).includes("..");
 }
+function assertSupportsThisGutterpress(meta, ref) {
+  const range = meta.gutterpressRange;
+  if (range === undefined)
+    return;
+  if (!validRange(range)) {
+    throw new Error(`Extension "${ref}" has an invalid engines.gutterpress range "${range}".`);
+  }
+  if (!satisfies(PACKAGE_VERSION, range, { includePrerelease: true })) {
+    throw new Error(`Extension "${ref}" needs Gutterpress ${range} (its package.json engines.gutterpress); ` + `this is Gutterpress ${PACKAGE_VERSION}. Update Gutterpress, or pin an older version of the extension.`);
+  }
+}
 function assertExtensionContained(meta) {
   if (meta.engineStyles !== undefined) {
     throw new Error("The extension's metadata declares `engineStyles`, which was removed — " + "move its entries to the end of `styles`.");
@@ -2031,7 +2044,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
@@ -2089,10 +2104,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;
@@ -2107,6 +2128,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) */
@@ -2216,6 +2247,8 @@ var GP_CLASSES = new Set([
   "gp-small",
   "gp-medium",
   "gp-large",
+  "gp-xl",
+  "gp-xxl",
   "gp-tight",
   "gp-loose",
   "gp-columns",
@@ -2232,6 +2265,7 @@ var GP_CLASSES = new Set([
   "gp-pin",
   "gp-top",
   "gp-bottom",
+  "gp-flush",
   "gp-behind",
   "gp-base",
   "gp-raised",
@@ -2245,8 +2279,7 @@ var GP_CLASSES = new Set([
   "gp-alert-caution",
   "gp-page-break",
   "gp-column-break",
-  "gp-continued",
-  "gp-flush"
+  "gp-continued"
 ]);
 
 // src/lib/markdown/gp-pin-scope.js
@@ -2283,6 +2316,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;
+  warn3(env, line, "flush_art", FLUSH_ART_MSG);
+}
 function elementNameFor(token) {
   switch (token.type) {
     case "layout_chapter_open":
@@ -2342,6 +2390,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);
         }
       }
     }
@@ -3369,6 +3418,7 @@ This folder still has a ${stale}. Gutterpress no longer reads it — ` + `descri
 async function loadExtensionFromDir(extensionDir, config, pluginRef) {
   const meta = await readExtensionMeta(extensionDir);
   assertExtensionContained(meta);
+  assertSupportsThisGutterpress(meta, pluginRef);
   const resolved = resolveExtension(extensionDir, meta, `Plugin "${pluginRef}"`);
   const extensionStyles = resolved.styles ?? [];
   const name = config.name ?? meta.name ?? pluginRef;
@@ -3443,6 +3493,7 @@ async function loadPlugin(config, baseDir) {
       if (loaded.packageDir) {
         const meta = await readExtensionMeta(loaded.packageDir);
         assertExtensionContained(meta);
+        assertSupportsThisGutterpress(meta, pluginRef);
         const resolved = resolveExtension(loaded.packageDir, { ...meta, main: undefined }, `Plugin "${pluginRef}"`);
         if (resolved.markdown && loaded.entryPath && resolve3(resolved.markdown) !== resolve3(loaded.entryPath)) {
           throw new Error(`its package.json declares gutterpress.markdown "${meta.markdown}" but the package entry is "${relative(loaded.packageDir, loaded.entryPath)}" — an npm extension's ` + "markdown-it plugin is its package entry, so declare that file or drop the field.");
@@ -3566,7 +3617,7 @@ import path3 from "node:path";
 import { Transform } from "node:stream";
 import { pipeline } from "node:stream/promises";
 import { createGunzip } from "node:zlib";
-import { maxSatisfying, satisfies, validRange } from "semver";
+import { maxSatisfying, satisfies as satisfies2, validRange as validRange2 } from "semver";
 
 // src/lib/fetch-timeout.ts
 class FetchPassthroughError extends Error {
@@ -3807,7 +3858,7 @@ async function selectPackage(ctx, name, selector) {
     version = selector;
   } else if (typeof tags[selector] === "string") {
     version = tags[selector];
-  } else if (validRange(selector)) {
+  } else if (validRange2(selector)) {
     version = maxSatisfying(Object.keys(versions), selector) ?? undefined;
   }
   if (!version || !isExactNpmVersion(version)) {
@@ -4025,7 +4076,7 @@ async function installPackage(ctx, name, selector, parentPackagePath, ancestors,
     }
     throw error2;
   }
-  const ancestor = ancestors.find((candidate) => candidate.name === name && (candidate.version === selected.version || (selector ? satisfies(candidate.version, selector) : false)));
+  const ancestor = ancestors.find((candidate) => candidate.name === name && (candidate.version === selected.version || (selector ? satisfies2(candidate.version, selector) : false)));
   if (ancestor)
     return { path: ancestor.path };
   if (ctx.records.length >= ctx.limits.totalPackages) {
@@ -8885,6 +8936,20 @@ function canonicalChapterId(p) {
   return s;
 }
 
+// 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";
@@ -8950,7 +9015,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}
@@ -9010,6 +9076,7 @@ ${css.trim()}
     preloadImages: cssAssetCopies.map((c) => c.to),
     title: opts.title,
     print: opts.print,
+    printArea: opts.printArea,
     plugins: opts.plugins,
     pluginCss,
     annotateSourceChapters: opts.annotateSourceChapters,
@@ -9022,6 +9089,7 @@ async function renderChaptersToFile(inputDir, outDir, opts = {}) {
   const html = await renderChapters(inputDir, {
     title: opts.title,
     print: opts.print,
+    printArea: opts.printArea,
     styles: opts.styles,
     files: opts.files,
     plugins: opts.plugins,
@@ -9899,6 +9967,7 @@ async function renderBook(ctx) {
   const htmlFile = await renderChaptersToFile(renderDir, workDir, {
     title: config.title,
     print: config.print,
+    printArea: { ...config.page, preset: config.preset, spec: config.spec },
     styles: config.styles,
     files: config.source.files,
     plugins,
@@ -10051,7 +10120,7 @@ class PdfOutput {
       const rawPdf = pdfxMode ? path13.join(stage, "raw.pdf") : path13.resolve(pdfFile);
       await fsp2.mkdir(path13.dirname(path13.resolve(pdfFile)), { recursive: true });
       log.info("Rendering HTML to PDF via the Gutterpress engine (native Chromium pagination)");
-      const { buildNativePdf } = await import("./engine-yxnnp3hx.js");
+      const { buildNativePdf } = await import("./engine-67f68bxs.js");
       const engineDiagnostics = await buildNativePdf(htmlFile, rawPdf, {
         title: config.title,
         author: config.authors.length > 0 ? config.authors.join(", ") : undefined,
@@ -10354,6 +10423,7 @@ async function renderPreviewBook(inputPath, config, opts) {
   return renderChapters(inputPath, {
     title: config.title ?? "Document",
     print: config.print,
+    printArea: config.printArea,
     styles: config.styles,
     files: opts.files,
     plugins,
@@ -10368,19 +10438,8 @@ async function renderPreviewBook(inputPath, config, opts) {
     }
   });
 }
-function injectPreviewScripts(html, page) {
-  const area = page ? 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
-  }) : "";
-  const meta = area ? `  <meta name="gp-print-area" content='${area.replace(/&/g, "&amp;").replace(/'/g, "&#39;")}'>
-` : "";
-  const scripts = meta + `  <script src="/engine/gutterpress-viewer.js"></script>
+function injectPreviewScripts(html) {
+  const scripts = `  <script src="/engine/gutterpress-viewer.js"></script>
   ` + `<script src="/preview/scripts/preview-interface.js"></script>
   ` + `<script src="/preview/scripts/preview-bridge.js"></script>
 `;
@@ -10395,7 +10454,10 @@ async function generateAndWriteHtml(inputPath, tempDir, config, cssAssets, image
   }
   const nextAssets = new Map;
   const nextImageRefs = new Set;
-  const html = await renderPreviewBook(inputPath, config, {
+  const html = await renderPreviewBook(inputPath, {
+    ...config,
+    printArea: config.page && { ...config.page, preset: config.preset, spec: config.spec }
+  }, {
     files: config.source?.files ?? null,
     onCssAssets: (copies) => {
       for (const copy of copies)
@@ -10414,7 +10476,7 @@ async function generateAndWriteHtml(inputPath, tempDir, config, cssAssets, image
     for (const ref of nextImageRefs)
       imageRefs.add(ref);
   }
-  await fsp3.writeFile(path15.join(tempDir, BOOK_HTML_FILENAME), injectPreviewScripts(html, config.page && { ...config.page, preset: config.preset, spec: config.spec }), "utf-8");
+  await fsp3.writeFile(path15.join(tempDir, BOOK_HTML_FILENAME), injectPreviewScripts(html), "utf-8");
 }
 function isDotPathUnderRoot(candidatePath, root) {
   const normalizedRoot = root.replace(/\\/g, "/").replace(/\/+$/, "");

package/dist/{cli-x4p99w8d.js → cli-61vd4ews.js}

@@ -567,14 +567,15 @@ function specificity(r) {
   return (r.name ? 2 : 0) + r.pseudos.length;
 }
 
-// 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 {
@@ -584,6 +585,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"],
@@ -1116,7 +1134,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";
@@ -1131,10 +1149,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";
@@ -1652,25 +1670,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;
@@ -1694,7 +1718,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)
@@ -1706,14 +1730,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);
@@ -1738,11 +1763,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,
@@ -1786,7 +1816,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 = {};
@@ -1814,7 +1844,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])})`);
@@ -1900,8 +1930,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);
@@ -1919,10 +1953,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);
@@ -1938,9 +1970,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;
               }
@@ -1965,7 +1997,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, {
@@ -2328,12 +2370,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);
@@ -2520,7 +2562,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/{cli-hn9pk0hp.js → cli-fmksazej.js}

@@ -4,7 +4,7 @@ import {
 // package.json
 var package_default = {
   name: "gutterpress",
-  version: "0.11.20-alpha.3",
+  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/{cli-y9bcya7r.js → cli-h4tfmpg3.js}

@@ -1,6 +1,6 @@
 import {
   package_default
-} from "./cli-hn9pk0hp.js";
+} from "./cli-fmksazej.js";
 import {
   enhancedPath,
   execCapture,
@@ -685,4 +685,4 @@ async function getSystemDiagnostics() {
   };
 }
 
-export { setLogLevel, debug, info, warn, error, log, resolveGhostscript, transparentPages, findPostScriptShadingPages, stripAnnotations, planTransparentPages, flattenTransparentPages, stampCreator, convertToPdfxCmyk, PACKAGE_META, PACKAGE_VERSION, defaultConfigDir, FileTokenStore, getSystemDiagnostics };
+export { setLogLevel, debug, info, warn, error, log, PACKAGE_META, PACKAGE_VERSION, resolveGhostscript, transparentPages, findPostScriptShadingPages, stripAnnotations, planTransparentPages, flattenTransparentPages, stampCreator, convertToPdfxCmyk, defaultConfigDir, FileTokenStore, getSystemDiagnostics };