gutterpress 0.11.23-beta.1 → 0.11.23-beta.3

package/dist/{cli-k087gj0p.js → cli-fsjre61x.js}

@@ -1032,12 +1032,14 @@ function needsMeasurement(value) {
 
 // src/engine/shared/pdf-inspect.ts
 import {
+  decodePDFRawStream,
   PDFArray,
   PDFDict,
   PDFDocument,
   PDFHexString,
   PDFName,
   PDFNumber,
+  PDFRawStream,
   PDFRef,
   PDFString
 } from "pdf-lib";
@@ -1158,6 +1160,52 @@ async function inspectPdf(bytes) {
   walkOutline(outlines);
   return { pageCount: pages.length, boxes, linkTargets, namedDests, outline };
 }
+var PROLOGUE = /^\s*(\d*\.?\d+) 0 0 -\d*\.?\d+ -?\d*\.?\d+ -?\d*\.?\d+ cm/;
+var CLIP = /(-?\d*\.?\d+) (-?\d*\.?\d+) (\d*\.?\d+) (\d*\.?\d+) re\s+W\*? n\b/g;
+var UNIFORM = /\bq\s+(\d*\.?\d+) 0 0 \1 (-?\d*\.?\d+) -?\d*\.?\d+ cm/g;
+var UNSCALED_EPSILON = 0.000001;
+function printScale(doc) {
+  const readings = new Map;
+  for (const page of doc.getPages()) {
+    const contents = page.node.Contents();
+    const streams = contents instanceof PDFArray ? contents.asArray().map((ref) => doc.context.lookup(ref)) : [contents];
+    let text = "";
+    for (const stream of streams) {
+      if (!(stream instanceof PDFRawStream))
+        continue;
+      try {
+        text += Buffer.from(decodePDFRawStream(stream).decode()).toString("latin1") + `
+`;
+      } catch {}
+    }
+    const prologue = PROLOGUE.exec(text);
+    if (!prologue)
+      continue;
+    let area;
+    for (const m of text.matchAll(CLIP)) {
+      const size = Number(m[3]) * Number(m[4]);
+      if (!area || size > area.size)
+        area = { x: Number(m[1]), size, end: m.index + m[0].length };
+    }
+    if (!area)
+      continue;
+    UNIFORM.lastIndex = area.end;
+    for (let m;m = UNIFORM.exec(text); ) {
+      if (Math.abs(Number(m[2]) - area.x) > 0.5)
+        continue;
+      const scale = Number(m[1]) * Number(prologue[1]) * 96 / 72;
+      readings.set(scale, (readings.get(scale) ?? 0) + 1);
+      break;
+    }
+    if ([...readings.values()].some((n) => n >= 3))
+      break;
+  }
+  let best = null;
+  for (const [scale, n] of readings)
+    if (best === null || n > readings.get(best))
+      best = scale;
+  return best === null ? null : Math.abs(1 - best) < UNSCALED_EPSILON ? 1 : best;
+}
 
 // src/lib/embedded-assets.ts
 import { existsSync } from "node:fs";
@@ -1170,7 +1218,7 @@ import { fileURLToPath } from "node:url";
 var favicon_default = "./favicon-272ga6y0.ico";
 
 // src/assets/manifest.schema.json
-var manifest_schema_default = "./manifest.schema-0jgj0jt1.json";
+var manifest_schema_default = "./manifest.schema-5cm13vr3.json";
 
 // src/assets/preview/scripts/preview-interface.js
 var preview_interface_default = "./preview-interface-0xdh0r5b.js";
@@ -1185,10 +1233,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-ze691rrd.js";
+var gutterpress_viewer_default = "./gutterpress-viewer-ywkf49q5.js";
 
 // src/assets/engine/gutterpress-agent.js
-var gutterpress_agent_default = "./gutterpress-agent-d29ry3ak.js";
+var gutterpress_agent_default = "./gutterpress-agent-wyryqehx.js";
 
 // src/assets/templates/book/manifest.yaml
 var manifest_default = "./manifest-mffah3hr.yaml";
@@ -1483,6 +1531,7 @@ function round(n) {
 import { PDFDocument as PDFDocument2, PDFName as PDFName2, PDFNumber as PDFNumber2, rgb } from "pdf-lib";
 async function postprocess(input, opts) {
   const doc = await PDFDocument2.load(input, { updateMetadata: false });
+  const scale = printScale(doc);
   const g = opts.geometry;
   const inset = g.bleed + g.slug;
   const media = [0, 0, g.media.width, g.media.height];
@@ -1529,7 +1578,8 @@ async function postprocess(input, opts) {
     bytes,
     pageCount: doc.getPageCount(),
     padded,
-    boxes: { media, bleed: bleedBox, trim: trimBox }
+    boxes: { media, bleed: bleedBox, trim: trimBox },
+    scale
   };
 }
 function drawCropMarks(page, g) {
@@ -1820,8 +1870,6 @@ ${pinCss}`);
       const msg = `${headline}:
 ${describe(widthOffenders.boxes)}`;
       if (opts.allowShrink) {
-        if (scale !== null)
-          diagnose("engine.width.overflow", `${headline}.`);
         for (const o of widthOffenders.boxes)
           diagnose("engine.width.overflow", `${o.desc} is ${Math.round(o.px)}px wide, past the ${Math.round(widthOffenders.limitPx)}px page content box. ${o.left < -1 ? "Keep it inside the page content box." : "Give it an explicit width that fits."}`);
         log(`WARNING: ${msg}`);
@@ -1837,6 +1885,54 @@ ${describe(widthOffenders.intrinsics)}`;
         diagnose("engine.width.intrinsic", `${o.desc} has no width set and is naturally wider than the page — if the printed output comes out smaller than your CSS says, give it an explicit width (e.g. width: 100%).`);
       log(`WARNING: ${msg}`);
     }
+    let unclipped = null;
+    if (!widthOffenders.boxes.length) {
+      const g = tier2.geometry;
+      const ext = g.bleed + g.slug;
+      const contentPx = (name, pseudos) => {
+        const { width, margin } = resolvePage(model, { name: name || undefined, pseudos }).geometry;
+        return (width + 2 * ext - bleedMargin(margin.left, g) - bleedMargin(margin.right, g)) * 96 / 72;
+      };
+      const pages = await page.evaluate(`(() => {
+        const body = document.body;
+        const named = (el) => { const p = getComputedStyle(el).page; return p && p !== "auto" ? p : ""; };
+        if (!body) return { first: "", used: [], reason: "there is no body" };
+        const bs = getComputedStyle(body);
+        const r = body.getBoundingClientRect();
+        if (
+          Math.abs(r.left + parseFloat(bs.borderLeftWidth)) > 0.01 ||
+          Math.abs(r.right - parseFloat(bs.borderRightWidth) - window.innerWidth) > 0.01
+        ) return { first: "", used: [], reason: "the body does not span the page content box" };
+        // The first page's name: the root's, overridden down the chain of
+        // first in-flow children (CSS Paged Media's start page value).
+        let first = named(document.documentElement) || named(body);
+        for (let el = body; el; ) {
+          el = [...el.children].find((c) => {
+            const cs = getComputedStyle(c);
+            return cs.display !== "none" && cs.position !== "absolute" && cs.position !== "fixed";
+          });
+          if (el && named(el)) first = named(el);
+        }
+        const used = new Set([""]);
+        for (const el of document.querySelectorAll("*")) used.add(named(el));
+        return { first, used: [...used], reason: "" };
+      })()`);
+      const firstPx = contentPx(pages.first, ["first", "right", "recto"]);
+      const wider = pages.used.find((name) => pseudoContexts.some((pseudos) => contentPx(name, pseudos) > firstPx + 0.01));
+      unclipped = pages.reason || (wider !== undefined ? `${wider ? `the page "${wider}"` : "the unnamed page"} is wider than the first page` : await page.evaluate(`(() => {
+              const hs = getComputedStyle(document.documentElement);
+              const bs = getComputedStyle(document.body);
+              let css;
+              if (hs.overflowX === "visible" && hs.overflowY === "visible")
+                css = "html { overflow-x: clip !important; } " +
+                  "body { overflow-x: clip !important; overflow-y: visible !important; }";
+              else if (bs.overflowX === "visible") css = "body { overflow-x: clip !important; }";
+              else return "the body clips its own overflow";
+              window.__gp.addCss("gp-root-clip", css);
+              return "";
+            })()`)) || null;
+      log(`body overflow ${unclipped ? `left as authored: ${unclipped}` : "held to the page content box"}`);
+    }
     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 || sideRoots.length > 0;
     let tier = tier2.geometry.bleed > 0 || tier2.geometry.slug > 0 ? 2 : 1;
@@ -2358,6 +2454,20 @@ ${mapCss}`;
       author: opts.author
     });
     log(`postprocess: ${post.pageCount} pages` + (post.padded ? ` (+${post.padded} blank${opts.lastPage ? `; last page: ${opts.lastPage}` : ""})` : ""));
+    {
+      const scale = post.scale;
+      if (scale !== null && scale < 1) {
+        const pct = (scale * 100).toPrecision(6);
+        const overPx = widthOffenders.defaultLimitPx * (1 / scale - 1);
+        diagnose("engine.width.overflow", `This book printed at ${pct}% of its declared size: content reaches about ` + `${overPx < 0.1 ? overPx.toFixed(3) : overPx.toFixed(2)}px past the ` + `${Math.round(widthOffenders.defaultLimitPx)}px page content box, and Chromium shrinks ` + `the WHOLE print to fit it. The preview is not shrunk, so its lines and page ` + `breaks can differ from the PDF's.` + (unclipped ? ` Gutterpress could not hold it at the page content box: ${unclipped}.` : ""));
+        if (!widthOffenders.boxes.length) {
+          const named = await findWidthOffenders(page, model, 2 * (tier2.geometry.bleed + tier2.geometry.slug), sheetViewport, 0);
+          for (const o of named.boxes)
+            diagnose("engine.width.overflow", `${o.desc} reaches ${Math.max(o.px + Math.min(0, o.left) - (o.limit ?? named.limitPx), -o.left).toFixed(2)}px ` + `past the ${Math.round(o.limit ?? named.limitPx)}px page content box. Keep it ` + `inside the page content box.`);
+        }
+        log(`audit: printed at ${pct}% (shrink-to-fit)`);
+      }
+    }
     return {
       bytes: post.bytes,
       tier,
@@ -2392,7 +2502,7 @@ function shrinkScale(boxes, limitPx) {
     return null;
   return Math.max(1 / MAX_SHRINK, limitPx / maxRight);
 }
-async function findWidthOffenders(page, model, bleedSlugExtensionPt, restoreViewport) {
+async function findWidthOffenders(page, model, bleedSlugExtensionPt, restoreViewport, tolerancePx = 1) {
   const contexts = [
     resolvePage(model),
     ...model.pageNames.filter((n) => !n.startsWith("gp-") || n.startsWith("gp--pin-")).map((n) => resolvePage(model, { name: n }))
@@ -2418,7 +2528,8 @@ async function findWidthOffenders(page, model, bleedSlugExtensionPt, restoreView
         mobile: false
       });
       boxes.push(...JSON.parse(await page.evaluate(`(() => {
-        const LIMIT = ${widthPx} + 1;
+        const TOL = ${tolerancePx};
+        const LIMIT = Math.max(${widthPx} + TOL, ${Math.ceil(widthPx)});
         const NAMED = ${JSON.stringify(namedLimits)};
         const DEFAULT_LIMIT = ${defaultLimitPx};
         // The page an element lands on: the nearest ancestor with a non-auto
@@ -2458,10 +2569,10 @@ async function findWidthOffenders(page, model, bleedSlugExtensionPt, restoreView
           // pulls) AND left-edge protrusion (negative left with an ordinary
           // width) — both trigger the same whole-document shrink-to-fit,
           // measured: a left bleed alone cost 16%.
-          if (right <= LIMIT && r.width <= LIMIT && r.left >= -1) continue;
+          if (right <= LIMIT && r.width <= LIMIT && r.left >= -TOL) continue;
           // ...but only where it actually escapes its clipping ancestors.
           const clip = clipEdges(el).edges;
-          if (Math.min(right, clip.right) <= LIMIT && Math.max(r.left, clip.left) >= -1) continue;
+          if (Math.min(right, clip.right) <= LIMIT && Math.max(r.left, clip.left) >= -TOL) continue;
           let deepest = true;
           for (const c of el.children) {
             if (c.getBoundingClientRect().width >= r.width - 1) { deepest = false; break; }
@@ -2498,7 +2609,7 @@ async function findWidthOffenders(page, model, bleedSlugExtensionPt, restoreView
           const over = el.scrollWidth - el.clientWidth;
           // clientWidth is 0 on inline/replaced boxes, where scrollWidth
           // carries no overflow information -- skip rather than guess.
-          if (el.clientWidth <= 0 || over <= 1) continue;
+          if (el.clientWidth <= 0 || over <= TOL) continue;
           // A descendant assigned to a DIFFERENT page is not overflowing this
           // element's page -- it is laid out against its own, wider one. The
           // full-bleed art plate is the standard case: it is legitimately
@@ -2552,7 +2663,7 @@ async function findWidthOffenders(page, model, bleedSlugExtensionPt, restoreView
         }
         return JSON.stringify(out);
       })()`));
-    return { limitPx, boxes, intrinsics: replaced };
+    return { limitPx, defaultLimitPx, boxes, intrinsics: replaced };
   } finally {
     await page.send("Emulation.setDeviceMetricsOverride", restoreViewport);
   }

package/dist/{cli-s1zt779w.js → cli-q7t04gjt.js}

@@ -1,7 +1,7 @@
 // package.json
 var package_default = {
   name: "gutterpress",
-  version: "0.11.23-beta.1",
+  version: "0.11.23-beta.3",
   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-vhav8g82.js → cli-rybz2dfs.js}

@@ -14,7 +14,7 @@ import {
 import {
   PACKAGE_VERSION,
   log
-} from "./cli-1fy1pm9d.js";
+} from "./cli-fh685nqs.js";
 import {
   __require
 } from "./cli-37x76zdn.js";

package/dist/cli.js

@@ -8,7 +8,7 @@ import {
 } from "./cli-d8xjns66.js";
 import {
   package_default
-} from "./cli-s1zt779w.js";
+} from "./cli-q7t04gjt.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-rmfyb7va.js").then((m) => m.default),
+  preview: () => import("./preview-ke03fk5d.js").then((m) => m.default),
+  build: () => import("./build-fq3mexhy.js").then((m) => m.default),
+  publish: () => import("./publish-wpnz0qng.js").then((m) => m.default),
+  validate: () => import("./validate-zcwykb43.js").then((m) => m.default),
+  preflight: () => import("./preflight-bjyeeq0d.js").then((m) => m.default),
+  doctor: () => import("./doctor-tg9ht1n3.js").then((m) => m.default),
+  ext: () => import("./ext-esz03jz4.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-rmfyb7va.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-bjyeeq0d.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-esz03jz4.js");
       if (!EXT_SUBCOMMANDS.includes(subcommand)) {
         throw new UsageError(`gutterpress ext: unknown command "${subcommand}"`);
       }

package/dist/{doctor-g4a42tcz.js → doctor-tg9ht1n3.js}

@@ -1,17 +1,17 @@
 import {
   getSystemDiagnostics
-} from "./cli-vhav8g82.js";
+} from "./cli-rybz2dfs.js";
 import"./cli-5crpmz42.js";
 import"./cli-asap4t1z.js";
 import {
   log
-} from "./cli-1fy1pm9d.js";
+} from "./cli-fh685nqs.js";
 import {
   UsageError,
   rejectExtraPositionals,
   rejectUnknownFlags
 } from "./cli-d8xjns66.js";
-import"./cli-s1zt779w.js";
+import"./cli-q7t04gjt.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-17v87vq5.js}

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

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

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

package/dist/{ext-w9d5ftcg.js → ext-esz03jz4.js}

@@ -2,28 +2,30 @@ import {
   importExtensionFromFile,
   importExtensionFromUrl,
   searchNpmExtensions
-} from "./cli-989eg8jz.js";
-import"./cli-vhav8g82.js";
+} from "./cli-ah93yyzb.js";
+import"./cli-rybz2dfs.js";
 import"./cli-ht1bcqdd.js";
-import"./cli-k087gj0p.js";
+import"./cli-fsjre61x.js";
 import"./cli-5crpmz42.js";
 import"./cli-eyyggect.js";
 import"./cli-asap4t1z.js";
-import"./cli-31anr0r9.js";
+import"./cli-eymdsefg.js";
 import"./cli-v5mp7a6q.js";
 import {
+  BUILT_IN_LOOKS,
+  addBuiltInStyleSet,
   addExtension,
   checkExtensionUpdates,
   listProjectExtensions,
   removeExtension,
   setExtensionEnabled,
   updateExtensions
-} from "./cli-e31jshz6.js";
+} from "./cli-5zbdb6mt.js";
 import {
   isPathSpecifier,
   parseExtensionSpecifier
-} from "./cli-ttj95aex.js";
-import"./cli-1fy1pm9d.js";
+} from "./cli-7mt0dftw.js";
+import"./cli-fh685nqs.js";
 import {
   UsageError,
   exitForUsage,
@@ -31,12 +33,12 @@ import {
   rejectUnknownFlags,
   resolveProjectDir
 } from "./cli-d8xjns66.js";
-import"./cli-s1zt779w.js";
+import"./cli-q7t04gjt.js";
 import"./cli-65gy8ask.js";
 import {
   EXIT_CODES
 } from "./cli-46ycxe6r.js";
-import"./cli-y28j019d.js";
+import"./cli-1dha1nxk.js";
 import"./cli-37x76zdn.js";
 
 // src/commands/ext.ts
@@ -65,6 +67,11 @@ var extAddArgs = {
     type: "string",
     description: "Named module export to use as the plugin function (npm and path extensions only)",
     required: false
+  },
+  look: {
+    type: "boolean",
+    description: "Treat SOURCE as a built-in look (clean-book, zine, technical-doc, academic): copy it into extensions/ as your own files and list the copy",
+    required: false
   }
 };
 var extRemoveArgs = { specifier: specifierArg, dir: dirArg };
@@ -202,7 +209,13 @@ var add = defineCommand({
       if (typeof args.export === "string" && !exportName) {
         throw new UsageError("gutterpress ext add: --export requires a non-empty name");
       }
-      if (!isUrl && !existing) {
+      if (args.look && !BUILT_IN_LOOKS.includes(source)) {
+        throw new UsageError(`gutterpress ext add --look: unknown built-in look "${source}" (one of: ${BUILT_IN_LOOKS.join(", ")})`);
+      }
+      if (args.look && exportName) {
+        throw new UsageError("gutterpress ext add --look: a look takes no --export");
+      }
+      if (!args.look && !isUrl && !existing) {
         try {
           if (path.isAbsolute(source) || isPathSpecifier(source)) {
             throw new Error(`source not found: ${candidate}`);
@@ -216,6 +229,10 @@ var add = defineCommand({
       exitForUsage(error);
     }
     try {
+      if (args.look) {
+        printAdded(await addBuiltInStyleSet(projectDir, source), projectDir);
+        return;
+      }
       if (isUrl) {
         const { entry: entry2, warnings } = await importExtensionFromUrl(projectDir, source);
         printAdded(entry2, projectDir, warnings.map((w) => w.message));

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

@@ -3,10 +3,10 @@ import {
   restoreForCommand,
   restoreOfflineMessage,
   restorePinnedExtensions
-} from "./index-rj5vrhz6.js";
-import"./index-a4j3xcfp.js";
+} from "./index-fntpr44x.js";
+import"./index-67g8f7r4.js";
 import"./index-tayzfr9c.js";
-import"./index-5x42amh8.js";
+import"./index-g3te5ey1.js";
 import"./index-37x76zdn.js";
 export {
   restorePinnedExtensions,

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

@@ -3,14 +3,14 @@ import {
   restoreForCommand,
   restoreOfflineMessage,
   restorePinnedExtensions
-} from "./cli-e31jshz6.js";
-import"./cli-ttj95aex.js";
-import"./cli-1fy1pm9d.js";
+} from "./cli-5zbdb6mt.js";
+import"./cli-7mt0dftw.js";
+import"./cli-fh685nqs.js";
 import"./cli-d8xjns66.js";
-import"./cli-s1zt779w.js";
+import"./cli-q7t04gjt.js";
 import"./cli-65gy8ask.js";
 import"./cli-46ycxe6r.js";
-import"./cli-y28j019d.js";
+import"./cli-1dha1nxk.js";
 import"./cli-37x76zdn.js";
 export {
   restorePinnedExtensions,

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 = [];